Premiers pas avec Ormuz
Le parcours recommandé suit un ordre simple : créer votre compte, définir le marchand pour lequel Ormuz travaille, connecter les systèmes qui portent vos données métier, ajouter les services dont vous avez besoin, puis construire et tester un premier processus avant le passage en production.
1. Créer votre compte Ormuz
Commencez dans un compte sandbox afin de tester vos systèmes, extensions et processus sans utiliser les accès de production. Si votre utilisateur a accès à plusieurs comptes, sélectionnez celui dans lequel vous souhaitez réaliser cette intégration.
La différence entre utilisateur, compte, marchand et environnement est détaillée dans Comptes, marchands et environnements.
2. Créer votre premier marchand
Dans le compte sandbox, créez le marchand qui représente l’activité métier que vous souhaitez opérer. Donnez-lui un nom et, si vous en avez une, une référence issue de votre propre système. Vous installerez ensuite les extensions et processus nécessaires dans ce périmètre.
3. Identifier votre architecture d’intégration
Avant de connecter un CMS ou un ERP, posez une question fonctionnelle : où vivent aujourd’hui vos clients, commandes, factures et paiements ? La réponse détermine quels systèmes doivent être connectés à Ormuz et quel rôle chacun conserve.
CMS e-commerce + ERP
Votre boutique porte le parcours de commande tandis que l’ERP ou le logiciel de gestion porte tout ou partie de l’exécution, de la facturation ou de la comptabilité.
- Déterminez où naissent le client, la commande et la facture.
- Définissez à quel moment une commande du CMS devient une commande ou une pièce de gestion dans l’ERP.
- Choisissez le système qui fait autorité pour chaque statut partagé.
CMS e-commerce uniquement
Votre activité commerciale est principalement pilotée depuis la boutique et vous souhaitez enrichir le checkout ou les opérations associées avec Ormuz.
- Connectez la boutique au marchand Ormuz.
- Vérifiez les clients, contacts, commandes et événements nécessaires à vos processus.
- Ajoutez ensuite les services financiers ou de conformité utiles au parcours.
ERP ou logiciel de gestion uniquement
Vos ventes B2B, factures ou opérations fournisseurs sont pilotées depuis un ERP, sans CMS e-commerce dans le parcours.
- Utilisez l’ERP comme point d’entrée des objets et événements métier.
- Déclenchez les processus Ormuz depuis les opérations réalisées dans le système de gestion.
- Restituez les décisions ou résultats dans l’ERP lorsque le cas d’usage le demande.
Application spécifique ou connecteur indisponible
Votre application ou votre système métier n’est pas couvert par un connecteur prêt à l’emploi.
- Intégrez les objets via l’API Ormuz.
- Utilisez les webhooks et événements pour suivre les changements.
- Ajoutez un échange batch ou fichier lorsque le système source ne permet pas une intégration temps réel.
Si votre architecture ne correspond pas exactement à l’un de ces scénarios, consultez les patterns d’intégration. API directe, extension, webhook entrant, synchronisation planifiée et échange de fichiers peuvent être combinés.
4. Connecter vos systèmes métier
Une fois l’architecture cible comprise, connectez le CMS e-commerce, l’ERP ou l’application qui doit fournir le contexte métier à Ormuz. Les détails d’installation dépendent de chaque extension, mais la démarche reste la même.
Installer l’extension
Depuis la Marketplace, sélectionnez le connecteur et installez-le pour le marchand concerné. Les configurations d’un système externe sont rattachées au marchand qui les utilise.
Authentifier le système
Fournissez les informations demandées par l’extension et vérifiez que la configuration utilise bien l’environnement de test correspondant.
Définir les objets échangés
Identifiez les objets nécessaires à vos cas d’usage : tiers, contacts, commandes, factures, paiements, retours ou autres données métier pertinentes.
Choisir le sens de synchronisation
Précisez qui crée chaque objet, quels changements Ormuz doit recevoir et quels résultats doivent être restitués au système métier.
Tester un premier objet de bout en bout
Créez ou modifiez une donnée de test dans le système source et vérifiez qu’elle peut être identifiée dans Ormuz, puis utilisée par un processus sans créer de doublon.
Exemples de sources de vérité
| Objet | Source possible | Exemple de rôle d’Ormuz |
|---|---|---|
| Client / société | CMS, CRM ou ERP | Normaliser le tiers et fournir son contexte aux processus. |
| Contact | CMS, CRM ou ERP | Porter les interactions d’onboarding, de validation ou de paiement. |
| Commande | CMS, OMS ou ERP | Orchestrer une décision de risque, de financement ou de paiement. |
| Facture | ERP ou logiciel comptable | Déclencher financement, recouvrement ou rapprochement. |
| Paiement | PSP, banque ou ERP | Rapprocher l’encaissement avec les objets commerciaux concernés. |
Ces exemples ne sont pas des règles imposées par Ormuz. Le système d’autorité dépend de votre organisation et doit être décidé explicitement pour chaque objet.
Consultez la page Systèmes métier pour découvrir les connecteurs disponibles et choisir le mode d’intégration adapté à votre système. Pour une architecture spécifique, vous pouvez également utiliser l’API Ormuz et les webhooks.
5. Ajouter les services dont vous avez besoin
Une fois Ormuz relié à vos systèmes métier, ajoutez les capacités que vous souhaitez orchestrer : paiement, financement, KYC/KYB, prévention de la fraude, données entreprise, open banking, signature électronique ou communication.
Installez chaque extension pour le marchand concerné, configurez son compte de test et vérifiez les permissions demandées. Vous pouvez explorer le catalogue des intégrations avant de construire votre premier processus.
6. Créer votre premier processus
Le processus relie les événements de votre activité aux services que vous venez de configurer. Il peut être déclenché par votre application, par un événement provenant d’une extension ou par un parcours métier prévu par Ormuz.
Choisir un point de départ
Utilisez un template lorsque l’un d’eux correspond à votre cas d’usage, ou créez un processus vide si vous souhaitez définir vous-même le déclencheur et les étapes.
Relier les données et les actions
Mappez les objets reçus du CMS, de l’ERP ou de l’API vers les nodes qui réalisent les contrôles, décisions, interactions utilisateur et actions provider.
Exécuter un premier parcours complet
Utilisez des données sandbox représentatives et vérifiez le résultat final dans Ormuz ainsi que dans le système métier lorsque celui-ci doit recevoir une mise à jour.
Pour approfondir la conception, consultez le modèle des processus, les nodes disponibles et les guides métier.
7. Valider votre intégration sandbox
Avant de préparer la production, testez une chaîne complète qui commence dans votre vrai système de test et se termine par le résultat attendu. L’objectif n’est pas seulement de vérifier qu’un appel API fonctionne, mais que les responsabilités entre systèmes sont cohérentes.
| À vérifier | Résultat attendu |
|---|---|
| Entrée métier | Le bon objet arrive dans Ormuz avec une identité stable par rapport au système source. |
| Déclenchement | L’événement ou l’action attendue lance le bon processus. |
| Providers | Chaque étape utilise la configuration sandbox du bon marchand. |
| Interactions utilisateur | Les actions humaines peuvent être réalisées jusqu’à leur état final. |
| Retour système | Le CMS, l’ERP ou votre application reçoit les résultats qu’il doit réellement conserver. |
| Rejeu | Les opérations que vous comptez rejouer utilisent bien la clé de déduplication ou la garantie d’idempotence prévue par leur contrat. |
| Erreur | Un échec peut être identifié, compris et repris depuis les surfaces publiques prévues. |
8. Passer en production
Le passage en production intervient lorsque vos flux principaux sont validés en sandbox. Le compte de production est un environnement distinct : ne considérez pas cette étape comme une simple bascule de la configuration de test.
Activer l’environnement de production
Utilisez le compte de production prévu pour votre organisation et son périmètre d’accès propre.
Configurer le marchand de production
Retrouvez le même découpage métier que celui validé en sandbox et vérifiez ses références externes.
Reconnecter les systèmes et providers
Utilisez les credentials, endpoints et comptes provider de production, séparés de ceux du sandbox.
Déployer les artefacts validés
Déployez les Process, Decisions et Agents nécessaires vers l’environnement cible et vérifiez que leurs dépendances — configurations d’extensions, variables et ressources référencées — sont correctement résolues.
Réaliser un test de bout en bout
Effectuez une transaction contrôlée avant d’ouvrir les flux réels et vérifiez les échanges dans chaque système impliqué.