MonduConnecteurStable

Ensure buyer (Mondu)

Crée ou réutilise le buyer Mondu associé à une entreprise Ormuz afin que les commandes suivantes utilisent toujours le même acheteur.

Vue d’ensemble

Ensure buyer (Mondu) prépare une entreprise acheteuse pour les parcours Mondu hors création d’ordre intégrée. La company Ormuz porte son identité et company.id reste sa référence externe Mondu.

Si cette entreprise existe déjà chez Mondu avec la même référence, le node réutilise ce buyer. Sinon, il en crée un nouveau.

  • La même company Ormuz reste associée au même buyer Mondu pour une configuration donnée.
  • La sortie created distingue une création d’une réutilisation.
  • Le lien de traçabilité retourné permet d’expliquer quel buyer Mondu correspond à l’entreprise Ormuz.

Scénario type

Un processus d’onboarding B2B reçoit une nouvelle company et son contact principal. Le node crée le buyer Mondu une seule fois. Les commandes suivantes utilisent ensuite le même buyer.

Prise en main

Reliez une entreprise enregistrée et, de préférence, un contact acheteur disposant d’un email.

Minimum requis

  • Configuration Mondu active
  • company avec raison sociale, immatriculation et pays
  • Email disponible sur contact ou company

Bon usage

  • Utiliser ce node avant un flux d’onboarding buyer autonome
  • Conserver buyer pour une consultation immédiate avec Get buyer (Mondu)
Exemple de configuration
ParamètreBindingRôle
companybuyer_companyEntreprise acheteuse canonique
contactbuyer_contactContact principal recommandé
À retenir Pour Create hosted order et Create async order, le buyer est déjà déduit automatiquement de l’order : il n’est pas nécessaire d’insérer Ensure buyer avant chaque commande.

Exemple de processus

Ongoing onboarding case
Créer ou réutiliser l’acheteur (Mondu)

Préparer une entreprise acheteuse une seule fois, puis réutiliser son buyer Mondu dans les opérations suivantes.

Résolution des données

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

DonnéeSource ou règle
Identité externecompany.id uniquement
Nom de l’entreprisecompany.legal_name → company.name
Immatriculationcompany.registration_number → company.company_number
Payscompany.registration_country → company.country_code → pays de l’adresse enregistrée
Emailcontact.email → company.email
Adressecompany.registered_address → company.billing_address

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.
companyRequisCompany
Entreprise acheteuse Ormuz. Son identifiant devient la référence externe stable du buyer Mondu. Sa raison sociale, son immatriculation, son pays et son adresse d’enregistrement alimentent le dossier Mondu.
contactOptionnelContact
Contact acheteur optionnel. Son email est prioritaire sur celui de la company pour la création du buyer. Utilisez un contact enregistré et cohérent avec l’entreprise concernée.

Sorties 3

Objet Mondu

Objet Mondu principal produit ou actualisé par le node.

buyerMondu buyer
Buyer Mondu avec son identifiant, sa référence externe, son état et les principales informations d’entreprise.

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 les informations acheteur

L’entreprise doit disposer des informations minimales demandées par Mondu.

Réutiliser un buyer existant

Si l’entreprise est déjà connue chez Mondu, le même buyer est retourné avec created = false.

Conserver une identité stable

company.id reste la référence externe utilisée pour cette entreprise.

Créer si nécessaire

Un nouveau buyer est créé uniquement lorsque l’entreprise n’existe pas encore chez Mondu.

Limites et responsabilités

  • Le node ne met pas à jour automatiquement un buyer Mondu existant lorsque la company change.
  • Il ne garantit pas l’éligibilité au financement et ne crée aucune commande.
  • Il ne remplace pas les contrôles de qualité des données d’entreprise en amont.

Résolution des problèmes

Raison sociale manquante

Renseignez company.legal_name ou, à défaut, company.name.

Immatriculation ou pays absent

Complétez les champs d’enregistrement de la company avant de relancer le node.

Email introuvable

Reliez un contact avec email ou renseignez company.email.

Plusieurs buyers associés

Corrigez les doublons afin qu’une entreprise Ormuz corresponde à un seul buyer Mondu.