MonduConnecteurStable

Create invoice (Mondu)

Soumet à Mondu une facture Ormuz émise avec son PDF et la rattache à la commande financée correspondante.

Facture Ormuz

Facture Mondu

Vue d’ensemble

Create invoice (Mondu) matérialise la créance après émission de la facture. Le concepteur fournit uniquement la facture Ormuz ; l’order associé, la commande Mondu et le document principal sont déduits automatiquement.

La soumission de la facture permet à Mondu d’entrer dans le cycle de payout marchand et de recouvrement acheteur. Le calendrier effectif dépend ensuite du contrat Mondu.

La facture doit avoir type = invoice et un status déjà émis : issued, sent ou received.
Elle doit être liée à exactement un order Ormuz financé par Mondu.
La somme des factures Mondu non annulées ne peut pas dépasser le montant de la commande.
Une facture déjà soumise n’est pas créée une seconde fois.

Scénario type

Une commande confirmée de 1 000 EUR est expédiée en deux fois. Deux événements invoice.issued soumettent des factures de 600 EUR puis 400 EUR. Une troisième facture de 100 EUR serait refusée car le cumul dépasserait la commande Mondu.

Prise en main

Reliez uniquement la facture émise ; le node déduit automatiquement la commande et le document principal.

Facture requise

type = invoice
status ∈ {issued, sent, received}
Montant positif et devise cohérente
document_file PDF présent

Relations requises

Exactement un order lié
Order déjà financé par Mondu
Commande Mondu confirmée ou dans un état d’exécution compatible

Exemple de configuration

Paramètre	Binding	Rôle
`invoice`	`issued_invoice`	Facture émise
`proof_of_delivery`	`delivery_proof`	Optionnel

À retenir Une invoice liée à zéro ou plusieurs orders échoue volontairement. Le node ne choisit jamais arbitrairement un ordre dans une relation many-to-many.

Exemple de processus

Facture Ormuz

Transmettre une facture (Mondu)

Facture soumise à Mondu

À l’émission, fournir la seule invoice Ormuz ; le node déduit la commande financée et le document à transmettre.

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
Order Ormuz	Relation invoice → orders → exactement un résultat
Commande Mondu	`order.id` identifie la commande financée
Référence facture	`invoice.id` uniquement
Document principal	`invoice.document_file`
Montant, taxe et devise	Champs monétaires de l’invoice
Lignes	Lignes enregistrées de l’invoice
Preuve de livraison	Paramètre `proof_of_delivery`, s’il est fourni

Paramètres 4

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.

invoiceRequisInvoice

Facture Ormuz enregistrée. Selon le node, elle sert soit à soumettre une facture émise, soit à consulter la facture Mondu correspondante.

Documents et expédition

Pièces et informations complémentaires utilisées lors de la facturation.

proof_of_deliveryOptionnelFile

Preuve de livraison optionnelle jointe à la facture. Le fichier doit appartenir au même marchand et être accessible au processus.

shipping_infoOptionnelobject

Informations d’expédition optionnelles transmises avec la facture. Utilisez uniquement les propriétés attendues par votre contrat Mondu.

Sorties 3

Objet Mondu

Objet Mondu principal produit ou actualisé par le node.

invoiceMondu invoice

Facture Mondu avec son identifiant, son état, son montant, sa devise et la commande à laquelle elle se rattache.

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 la facture

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

Éviter les doublons

Une facture déjà soumise est retournée avec created = false.

Identifier la commande unique

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

Vérifier les conditions Mondu

La commande doit être confirmée ou dans un état compatible, avec la même devise.

Contrôler le montant cumulé

Le total des factures non annulées, nouvelle facture incluse, ne doit pas dépasser la commande.

Soumettre la facture

Le PDF principal, la preuve optionnelle et les lignes de facture sont transmis à Mondu.

Rendre la facture disponible

La facture Mondu retournée peut ensuite être suivie ou corrigée par un avoir.

Limites et responsabilités

Le node n’émet pas la facture dans l’ERP et ne change pas son statut Ormuz.
Il ne supporte pas une facture consolidant plusieurs orders Mondu.
Il ne garantit pas une date de payout précise.
Il ne crée pas automatiquement un avoir en cas de correction.

Résolution des problèmes

Aucun order lié

Créez la relation invoice → order avant de relancer.

Plusieurs orders liés

Scindez la facture ou définissez un modèle métier compatible ; Mondu exige une commande unique.

Facture non émise

La facture doit avoir atteint issued, sent ou received dans son cycle normal avant la soumission à Mondu.

Document absent ou non PDF

Attachez un PDF valide dans invoice.document_file.

Montant supérieur à la commande

Vérifiez les factures déjà soumises, les annulations et le montant de la commande.

Devise différente

La facture doit utiliser la même devise que la commande Mondu.