Connecteur Dolibarr
Le connector Dolibarr expose les objets ERP déjà mappés dans Knot Core : tu manipules factures, tiers, commandes et autres entités sans écrire de SQL à la main.
🔌 Verbes disponibles
Chaque node Dolibarr choisit un objet (ex. facture client, tiers) puis une action :
| Action | Usage typique |
|---|---|
| Get | Charger un enregistrement par ID ou critère |
| List | Parcourir une liste filtrée (pagination côté connector) |
| Create | Créer un document ou une fiche |
| Update | Modifier des champs après validation métier |
| Delete | Suppression logique ou physique selon l’objet Dolibarr |
Les champs affichés dans l’inspecteur proviennent de l’introspection typée : tu vois les FK et les listes déroulantes alignées sur Dolibarr.
🔌 Multi-entité
Knot respecte l’entité active (entity = $conf->entity). Un workflow lancé sur l’entité 1 ne lit ni n’écrit les données de l’entité 2.
🔌 Permissions Dolibarr requises
Le connector s’exécute avec l’utilisateur qui déclenche le run (manuel) ou avec le compte technique configuré pour les triggers planifiés. Dolibarr refuse une action si le rôle n’a pas le droit natif.
| Objet (exemples) | Droits usuels à vérifier |
|---|---|
Tiers (societe) | Lire / créer / modifier tiers |
| Facture client | Lire / créer factures |
| Commande | Lire / créer commandes |
| Produit / service | Lire produits |
Matrice complète : Permissions Dolibarr.
🔌 Expressions et contexte
Mappe les champs avec des expressions {{ }} : la sortie d’un node précédent alimente l’ID ou les colonnes du node Dolibarr suivant.
{{ nodes.fetch_invoice.output.id }}Format des edges : source → target (pas from / to sauf import legacy).
🔌 Exemple : relance après création de facture
- Trigger object event sur création de facture.
- Node Get tiers lié à la facture.
- Node Email avec modèle de relance.
- Node Logic If pour ne pas envoyer si le montant est nul.
Teste le scénario avec Simulate avant activation.
Suite
- Object event — déclencher sur create / update / delete
- Permissions — rôles et entités