Skip to content

README.md

Latest commit

 

History

History
242 lines (176 loc) · 8.28 KB

README.md

File metadata and controls

242 lines (176 loc) · 8.28 KB
Raw

MRP Outsourcing — Dolibarr Module

Dolibarr PHP License

Dolibarr-module voor het uitbesteden van MRP-productie-opdrachten aan externe leveranciers. Volledig geïntegreerd in de Dolibarr MRP-workflow.

Functionaliteit

  • 📧 Stuur productie-opdrachten (MO's) per e-mail naar externe leveranciers — inclusief componentenlijst, hoeveelheden en opleverdatum
  • 📦 Keuze per opdracht: component-voorraad al dan niet verlagen bij het uitbesteden
  • ✅ Gereedmeldingen ontvangen via drie kanalen:
    • Klikbare link in de leveranciers-e-mail (geen login vereist)
    • Inkomende e-mail met patroon GEREED-{MO_REF}-{TOKEN} — via IMAP of Office365 (Microsoft Graph)
    • Handmatige gereedmelding in de Dolibarr interface
  • 🔄 Automatisch sluiten van de MRP Manufacturing Order bij gereedmelding
  • 🔒 Veilige callbacks via uniek per-opdracht token (192 bits entropie)
  • 📋 Audittrail — volledige log van alle leverancierscommunicatie

Schermafbeeldingen

MO-kaart met knop Opdracht aanmaken Leveranciers-e-mail Gereedmelding portaal
Knop "Verstuur naar leverancier" Formulier met voorraadkeuze Professionele HTML-e-mail Branded leverancierspagina

Vereisten

Component Versie
Dolibarr 16.0 of hoger (getest op 20.x)
PHP 7.4 of hoger
PHP IMAP-extensie Optioneel — alleen bij provider IMAP
PHP cURL-extensie Optioneel — alleen bij provider Office365
Azure AD app-registratie Optioneel — alleen bij provider Office365 (zie hieronder)
MRP-module Actief in Dolibarr
SMTP Geconfigureerd in Dolibarr

Installatie

1. Bestanden plaatsen

cp -r mrpoutsourcing /pad/naar/dolibarr/custom/

2. Databasetabel aanmaken

mysql -u dolibarruser -p dolibarr_db \
  < custom/mrpoutsourcing/sql/llx_mrpoutsourcing_order.sql

3. Module activeren

Dolibarr → Instellingen → Modules/Applicaties → zoek "MRP Outsourcing" → Activeren

4. Configureren

Ga naar MRP → Uitbestede Opdrachten (tandwiel-icoon) en stel in:

  • Afzender e-mailadres (gebruik bij voorkeur dezelfde mailbox die de gereedmeldingen ontvangt)
  • Mailprovider voor inkomende gereedmeldingen: IMAP of Office365 (Microsoft Graph)
  • De bijbehorende provider-gegevens (zie hieronder)
  • Standaard magazijn voor voorraadmutaties

5. Cron instellen (optioneel)

*/5 * * * * php /pad/naar/dolibarr/custom/mrpoutsourcing/scripts/process_inbound_mail.php

Inkomende mail — provider configureren

De gereedmeldingen per e-mail (GEREED-{MO_REF}-{TOKEN}) worden opgehaald door het cron-script. De provider wordt gekozen met de instelling Mailprovider (MRPOUTSOURCING_MAIL_PROVIDER).

Optie A — IMAP

Vereist de PHP IMAP-extensie. Vul in de setup in:

Veld Constante Voorbeeld
IMAP-server MRPOUTSOURCING_IMAP_HOST mail.mijnbedrijf.nl
IMAP-poort MRPOUTSOURCING_IMAP_PORT 993
SSL gebruiken MRPOUTSOURCING_IMAP_SSL Ja
Gebruikersnaam MRPOUTSOURCING_IMAP_USER productie@mijnbedrijf.nl
Wachtwoord MRPOUTSOURCING_IMAP_PASS (versleuteld opgeslagen)
Map MRPOUTSOURCING_IMAP_FOLDER INBOX

⚠️ Office365/Exchange Online ondersteunt geen Basic Authentication meer voor IMAP. Gebruik daar provider Office365 hieronder.

Optie B — Office365 (Microsoft Graph)

Gebruikt de Microsoft Graph API met de OAuth2 client-credentials flow (app-only, geen gebruikerslogin). Werkt betrouwbaar headless via cron en vereist de PHP cURL-extensie.

1. App-registratie in Azure

  1. Azure Portal → Microsoft Entra ID → App-registraties → Nieuwe registratie. Noteer de Application (client) ID en de Directory (tenant) ID.

  2. Certificaten & geheimen → Nieuw clientgeheim → kopieer de waarde direct (deze is later niet meer zichtbaar).

  3. API-machtigingen → Machtiging toevoegen → Microsoft Graph → Toepassingsmachtigingen (let op: Application, niet Delegated):

    • Mail.ReadWrite — berichten lezen en als gelezen markeren
    • Mail.Send — automatisch antwoord sturen

    Klik daarna op "Beheerderstoestemming verlenen" (admin consent).

  4. Aanbevolen: beperk de app tot één mailbox met een Application Access Policy in Exchange Online — anders heeft de app technisch toegang tot álle mailboxen.

2. Instellen in Dolibarr

Veld Constante Voorbeeld
Tenant-id of domein MRPOUTSOURCING_O365_TENANT bedrijf.onmicrosoft.com
Application (client) ID MRPOUTSOURCING_O365_CLIENT_ID 00000000-0000-0000-0000-000000000000
Client secret MRPOUTSOURCING_O365_CLIENT_SECRET (versleuteld opgeslagen)
Mailbox (e-mail / UPN) MRPOUTSOURCING_O365_MAILBOX productie@mijnbedrijf.nl
Map (well-known naam) MRPOUTSOURCING_O365_FOLDER inbox

3. Verbinding testen

php /pad/naar/dolibarr/custom/mrpoutsourcing/scripts/process_inbound_mail.php

De uitvoer toont Provider: office365 en óf No unread messages (verbinding OK), óf een duidelijke fout (token/permissie).

Gebruik

Opdracht uitbesteden

  1. Open een MRP-productieorder
  2. Klik "Verstuur naar leverancier" in de actiebalk
  3. Selecteer de leverancier (e-mail wordt automatisch ingevuld)
  4. Kies of component-voorraad wordt verlaagd
  5. Voeg optioneel een opmerking toe voor de leverancier
  6. Klik "Aanmaken" → controleer voorvertoning → "Nu Verzenden"

Gereedmelding door leverancier

De leverancier ontvangt een HTML-e-mail met:

  • Knop "Opdracht ontvangen" → registreert bevestiging
  • Knop "Gereedmelding" → sluit de MRP-order automatisch

Of per e-mail met onderwerp:

GEREED-MO2025-0042-a1b2c3d4e5f6789abc0123456789abcd01234567

Statusflow

[draft] → [sent] → [confirmed] → [done]
                ↘               ↗
                  direct done
Status Omschrijving
draft Aangemaakt, nog niet verzonden
sent E-mail verzonden naar leverancier
confirmed Leverancier heeft ontvangst bevestigd
done Gereed gemeld — MRP-order gesloten
cancelled Geannuleerd

Bestandsstructuur

mrpoutsourcing/
├── core/
│   └── modules/modMrpOutsourcing.class.php       # Module-descriptor
├── class/
│   ├── mrpoutsourcingorder.class.php             # Business logic
│   ├── actions_mrpoutsourcing.class.php          # MO-kaart hook (addMoreActionsButtons)
│   └── office365mailclient.class.php             # Microsoft Graph (Office365) mailclient
├── admin/
│   └── mrpoutsourcing_setup.php                  # Instellingen
├── ajax/
│   └── get_supplier_email.php                    # Leverancier e-mail Ajax
├── public/
│   └── callback.php                              # Leverancier portaal (geen login)
├── scripts/
│   └── process_inbound_mail.php                  # Cron-script (IMAP / Office365)
├── sql/
│   └── llx_mrpoutsourcing_order.sql              # Tabelstructuur
├── langs/
│   ├── nl_NL/mrpoutsourcing.lang
│   └── en_US/mrpoutsourcing.lang
├── list.php                                      # Overzicht
└── send_order.php                                # Aanmaken / versturen

Rechten

Recht Toegang
mrpoutsourcing.read Overzicht en details bekijken
mrpoutsourcing.write Opdrachten aanmaken en verzenden
mrpoutsourcing.manage Gereed melden en annuleren

Beveiliging

  • Elke uitbestedingsopdracht heeft een eigen uniek token van 48 hexadecimale tekens (192 bits entropie)
  • De leveranciers-callback (public/callback.php) vereist geen Dolibarr-login
  • Tokens worden nooit hergebruikt

Licentie

MIT — zie LICENSE

Auteur

Ontwikkeld voor Ghee Easy — Dolibarr 20.x customisatie