MonduRouteurStable

Create async order (Mondu)

Crée ou réutilise un ordre Mondu pour une commande ERP ou back-office, puis dirige le processus selon le résultat obtenu.

Commande Ormuz

Authorization required

Authorized

Pending

Confirmed

Declined

Canceled

Completed

Other

Ordre Mondu

Vue d’ensemble

Create async order (Mondu) couvre les ventes créées hors d’un checkout web interactif. Le node utilise le platform.order, son buyer, son contact et ses lignes pour présenter la demande à Mondu.

Mondu peut répondre immédiatement ou indiquer qu’une décision reste en cours. Le processus doit traiter explicitement la route sélectionnée.

Le même order.id identifie la commande pendant tout son cycle Mondu.
Aucune checkout session ni URL de retour n’est nécessaire.
Une nouvelle exécution sur le même order ne crée pas de doublon.

Scénario type

Une commande saisie par un commercial arrive depuis l’ERP. Le node la soumet à Mondu. La route authorization_required déclenche ensuite le canal d’autorisation prévu pour le buyer, tandis que authorized permet de poursuivre vers la confirmation.

Prise en main

Reliez une commande enregistrée et complète. L’acheteur et les lignes sont déduits de l’order.

Préparer l’order

Buyer et contact renseignés
Montant et devise valides
Adresses complètes
Au moins une ligne

Préparer le processus

Traiter les états intermédiaires
Ne confirmer que la route authorized ou un état déjà confirmé

Exemple de configuration

Paramètre	Binding	Rôle
`order`	`erp_order`	Commande enregistrée
`payment_method`	`invoice`	Condition commerciale
`net_term`	`30`	Délai acheteur

À retenir Ce node ne remplace pas le Hosted Checkout : choisissez-le lorsque l’autorisation n’est pas réalisée dans le parcours web courant.

Routes de décision

authorization_required

Autorisation acheteur requise

Mondu attend encore une action ou une validation de l’acheteur avant de rendre une décision exploitable.

Action recommandéeConserver la commande en attente et déclencher ou poursuivre le parcours d’autorisation prévu.

authorized

Commande autorisée

Mondu a autorisé la transaction, mais le marchand n’a pas encore confirmé que la commande définitive existe.

Action recommandéeCréer ou finaliser la commande dans le CMS ou l’ERP, puis appeler Confirm order (Mondu).

pending

Décision en cours

La commande est encore en traitement ou en revue chez Mondu.

Action recommandéeMettre le processus en attente et reprendre le traitement lorsqu’un nouvel état Mondu est disponible.

confirmed

Commande confirmée

Mondu reconnaît la commande marchande comme ferme et elle peut entrer dans le cycle d’expédition et de facturation.

Action recommandéePoursuivre l’exécution commerciale puis soumettre les factures émises avec Create invoice (Mondu).

declined

Financement refusé

Mondu n’a pas autorisé la transaction selon les informations disponibles.

Action recommandéeProposer un autre moyen de paiement ou interrompre la commande selon votre politique commerciale.

canceled

Commande annulée

L’ordre Mondu a été annulé et ne peut plus poursuivre son cycle normal.

Action recommandéeAnnuler le parcours associé ou recréer une nouvelle commande Mondu si une nouvelle tentative est légitime.

completed

Cycle terminé

Le cycle Mondu de la commande est terminé.

Action recommandéeConserver le résultat pour le suivi, la réconciliation et l’audit.

other

État non reconnu

Mondu a retourné un état qui ne correspond à aucune route métier connue du node.

Action recommandéeNe poursuivez pas automatiquement. Analysez l’état Mondu retourné et définissez la règle métier appropriée avant de reprendre.

Attention Les routes pending et authorization_required signifient que la commande n’est pas encore autorisée.

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
Référence Mondu	`order.id` uniquement
Buyer et contact	Relations `buyer_id` et `buyer_contact_id` de l’order
Montants, devise et adresses	Champs du `platform.order` avec recours à l’adresse de la company lorsque nécessaire
Lignes	Lignes enregistrées de l’order
Conditions	Paramètres du node → valeurs de configuration → valeurs par défaut

Paramètres 7

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.

orderRequisOrder

Commande Ormuz enregistrée qui porte tout le cycle Mondu. Son identifiant order.id est utilisé comme external_reference_id puis comme external_order_id.

Conditions commerciales

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

payment_methodOptionnelenum

Moyen de paiement demandé à Mondu. Si vous ne le renseignez pas, le node utilise la valeur par défaut de la configuration, puis invoice.

net_termOptionnelinteger

Délai de paiement accordé à l’acheteur, en jours. S’il est absent, le node utilise le délai par défaut de la configuration, puis 30 jours.

languageOptionnelenum

Langue du parcours ou de la communication Mondu. S’il est absent, le node utilise la langue par défaut de la configuration, puis en.

vendor_external_reference_idOptionnelstring

Référence vendeur réservée au mode marketplace. Elle n’est acceptée que si marketplace_mode est activé sur la configuration Mondu.

notesOptionnelstring

Notes métier optionnelles transmises à Mondu avec l’ordre.

Sorties 5

Objet Mondu

Objet Mondu principal produit ou actualisé par le node.

orderMondu order

Ordre Mondu avec son identifiant, son état, ses montants, sa devise, ses références externes et ses dates.

Décision et contrôle

Informations utilisées pour orienter la suite du processus.

authorization_requiredboolean

Vaut true lorsque Mondu indique qu’une autorisation acheteur reste nécessaire.

createdboolean

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

selected_routestring

Route choisie à partir du résultat métier retourné par Mondu.

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

Préparer la commande

Le node vérifie que l’identité, le montant, la devise, l’acheteur et les lignes permettent de présenter la demande à Mondu.

Éviter les doublons

Une commande déjà envoyée à Mondu est réutilisée.

Présenter la demande

Mondu reçoit les données commerciales et la référence stable order.id.

Diriger le processus

Le résultat Mondu sélectionne l’une des huit routes documentées.

Limites et responsabilités

Le node ne collecte aucune action utilisateur.
Il ne confirme pas automatiquement un ordre autorisé.
Il ne transforme pas un état intermédiaire en décision finale.
Il ne soumet aucune facture.

Résolution des problèmes

Ordre incomplet

Complétez buyer, contact, lignes, montant, devise et adresses.

`authorization_required`

Prévoyez le canal d’autorisation adapté à votre intégration Mondu asynchrone.

`other`

Analysez l’état Mondu retourné avant d’ajouter une nouvelle règle métier.