MonduConnecteurStable

Create credit note (Mondu)

Soumet un avoir Ormuz à la facture Mondu qu’il corrige, en s’appuyant sur la facture source explicitement désignée.

Avoir Ormuz

Avoir Mondu

Vue d’ensemble

Create credit note (Mondu) corrige une créance déjà matérialisée par une facture Mondu. La relation source_invoice_id désigne précisément la facture concernée.

Cette relation est indispensable lorsqu’une commande possède plusieurs factures : l’avoir doit corriger une facture déterminée, pas la commande dans son ensemble.

L’avoir doit être une platform.invoice avec type = credit_note et un status déjà émis : issued, sent ou received.
source_invoice_id est obligatoire et doit désigner une facture déjà soumise à Mondu.
Le montant de l’avoir ne peut pas dépasser celui de la facture source et la devise doit correspondre.
Un avoir déjà soumis n’est pas créé une seconde fois.

Scénario type

Une facture Mondu de 600 EUR contient un retour marchand de 100 EUR. L’ERP émet un credit note lié à cette facture. Le node soumet l’avoir de 100 EUR à la facture concernée.

Prise en main

Reliez uniquement l’avoir émis ; sa facture source et la commande correspondante sont déduites automatiquement.

Avoir requis

type = credit_note
status ∈ {issued, sent, received}
source_invoice_id renseigné
PDF dans document_file

Facture source requise

Facture Ormuz existante
Facture déjà soumise à Mondu
Facture liée à exactement un order

Exemple de configuration

Paramètre	Binding	Rôle
`credit_note`	`issued_credit_note`	Avoir émis
`reason`	`Returned goods`	Motif optionnel

À retenir La facture corrigée est toujours celle désignée par credit_note.source_invoice_id. L’order seul ne permet pas de choisir entre plusieurs factures.

Exemple de processus

Avoir Ormuz

Transmettre un avoir (Mondu)

Avoir appliqué à la facture

À l’émission d’un avoir, utiliser sa facture source pour appliquer la correction à la bonne facture Mondu.

Résolution des données

Le node déduit automatiquement les données nécessaires à partir des objets Ormuz reliés.

Donnée	Source ou règle
Facture source Ormuz	`credit_note.source_invoice_id`
Order Ormuz	Facture source → exactement un order
Facture Mondu concernée	Facture source déjà soumise à Mondu
Commande Mondu	`order.id` identifie la commande financée
Référence avoir	`credit_note.id` uniquement
Document	`credit_note.document_file`
Lignes	Lignes enregistrées de l’avoir

Paramètres 3

Contexte principal

Objets et configuration qui déterminent l’opération Mondu.

extension_config_idRequisref(extension_config:mondu)

Configuration Mondu active utilisée pour l’opération. Elle définit notamment l’environnement, le moyen de paiement par défaut, le délai net, la langue et les options marketplace éventuelles.

credit_noteRequisInvoice

Avoir Ormuz enregistré, représenté par une platform.invoice dont type = credit_note. Il doit être émis, posséder un document PDF et référencer sa facture source avec source_invoice_id.

Conditions commerciales

Choix de paiement, délai et paramètres du parcours.

reasonOptionnelstring

Motif libre transmis à Mondu pour expliquer l’annulation ou l’avoir, selon le node.

Sorties 3

Objet Mondu

Objet Mondu principal produit ou actualisé par le node.

credit_noteMondu credit note

Avoir Mondu lié à la facture source concernée.

Décision et contrôle

Informations utilisées pour orienter la suite du processus.

createdboolean

Indique si le node a créé un nouvel objet Mondu. false signifie que l’objet existait déjà et a été réutilisé.

Autres sorties

extension_object_mappingextension object mapping

Correspondance durable entre l’objet Mondu créé ou réutilisé et l’objet Ormuz qui constitue son ancre métier.

Comportement

Vérifier l’avoir

Le type, le statut émis, le montant, la taxe, la devise et la facture source doivent être valides.

Identifier la facture corrigée

source_invoice_id désigne la facture Ormuz concernée.

Comparer montant et devise

L’avoir ne peut pas dépasser la facture source et doit utiliser la même devise.

Identifier la commande unique

La facture source doit être liée à exactement un order.

Vérifier la cohérence du cycle

La facture source doit appartenir à la même commande Mondu que l’order associé.

Soumettre ou réutiliser l’avoir

Un avoir existant est retourné avec created = false ; sinon le PDF et les lignes sont soumis à Mondu.

Limites et responsabilités

Le node ne crée pas la relation source_invoice_id.
Il ne traite pas un avoir global sans facture source.
Il ne modifie pas automatiquement les soldes ou statuts Ormuz.
Il ne soumet pas un avoir couvrant plusieurs factures sources.

Résolution des problèmes

Facture source manquante

Renseignez credit_note.source_invoice_id vers une invoice ordinaire.

Facture source non soumise

Soumettez d’abord la facture avec Create invoice (Mondu).

Order absent ou ambigu

La facture source doit être liée à exactement un order Ormuz.

Montant trop élevé

Réduisez l’avoir ou vérifiez la facture source sélectionnée.

Document non PDF

Attachez un PDF valide dans credit_note.document_file.

Facture et commande incohérentes

Vérifiez que la facture source appartient bien à la commande financée concernée.