Connecter Oracle Fusion ERP : recevoir commandes et factures
Saisissez l’URL de votre instance Oracle Fusion dans Integration et connectez-vous avec un nom d’utilisateur et un mot de passe REST Fusion ou avec un jeton bearer OAuth obtenu au préalable, testez, mappez, activez.
Le connecteur Oracle Fusion ERP importe les commandes de vente et les factures de votre Oracle Fusion Cloud ERP dans ce système. C’est toute la portée de cette connexion : elle n’importe pas les clients, ne consulte ni n’importe le stock, et ne renvoie rien vers Oracle Fusion. La connexion fonctionne de l’une de ces deux façons — un nom d’utilisateur et un mot de passe REST Fusion, ou un jeton bearer OAuth que vous obtenez au préalable et collez — et si un jeton est saisi, il est utilisé en premier. Une connexion par instance Oracle Fusion.
Prérequis#
- Une instance Oracle Fusion Cloud à laquelle vous pouvez vous connecter, et son URL d’instance, par ex. https://fa-xxx.oraclecloud.com.
- Un jeu d’identifiants complet, choisi à l’avance : soit un utilisateur Fusion avec les rôles d’intégration, avec son mot de passe — soit un jeton d’accès OAuth2 obtenu au préalable dans votre domaine d’identité OCI / IDCS. Un demi-jeu ne connecte pas.
- Si vous prévoyez d’utiliser un jeton : un moyen d’obtenir un nouveau jeton dans votre domaine d’identité OCI / IDCS chaque fois que celui collé cesse de fonctionner, car cette connexion utilise le jeton exactement tel que collé et n’en récupère pas un nouveau pour vous.
Obtenir les identifiants#
- Notez l’URL de votre instance, par ex. https://fa-xxx.oraclecloud.com. C’est la seule valeur dont chaque connexion a besoin, quel que soit le jeu d’identifiants choisi.
- Option A — connexion Basic : préparez un utilisateur Fusion avec les rôles d’intégration, par ex. REST_USER, et gardez son mot de passe prêt. Le nom d’utilisateur et le mot de passe doivent être saisis ensemble ; l’un sans l’autre ne compte pas comme un jeu.
- Option B — connexion par jeton : dans votre domaine d’identité OCI / IDCS, obtenez au préalable un jeton d’accès OAuth2 et copiez-le. Vous collez ici le jeton déjà obtenu — il n’y a ni saut de connexion ni échange de jeton dans cette connexion.
- Choisissez une option comme jeu de travail. Si vous saisissez plus tard un jeton sur une connexion qui utilisait le nom d’utilisateur et le mot de passe, le jeton prend le relais à partir de là.
Remplir dans Integration#
- Ouvrez Integration → Marketplace → Oracle Fusion ERP → Nouvelle connexion.
- base_url, obligatoire, URL de l’instance : l’adresse de votre instance Oracle Fusion, par ex. https://fa-xxx.oraclecloud.com.
- api_version, facultatif, version de l’API : laissez-le vide pour utiliser la valeur par défaut intégrée 11.13.18.05. Ne le remplissez que si votre environnement exécute une autre version.
- username, pour la connexion Basic, nom d’utilisateur (auth Basic) : l’utilisateur REST Fusion avec les rôles d’intégration, par ex. REST_USER. Saisissez-le avec password, ou laissez les deux vides et utilisez token à la place.
- password, pour la connexion Basic, mot de passe (auth Basic) : le mot de passe de ce même utilisateur Fusion. C’est un champ de type mot de passe, conservé comme secret.
- token, alternative facultative, jeton bearer OAuth : collez le jeton d’accès OAuth2 obtenu au préalable dans votre domaine d’identité OCI / IDCS. C’est un champ de type mot de passe, conservé comme secret. Si token est saisi, il est utilisé avant username et password.
Tester la connexion#
Cliquez sur Tester la connexion. Le test vérifie d’abord la saisie : si base_url manque, ou si aucun jeu d’identifiants n’est complet — pas de nom d’utilisateur avec son mot de passe, et pas de jeton — il s’arrête avec un message de valeur manquante et n’envoie rien. Il fait ensuite une vraie demande légère, en lecture seule, avec le jeu choisi — le jeton en connexion Bearer si un jeton est saisi, sinon le nom d’utilisateur et le mot de passe en connexion Basic — en demandant un seul enregistrement à la ressource des factures. Une réponse 200 compte comme un succès. Une réponse 401 ou 403 signifie que le jeu d’identifiants utilisé a été refusé : vérifiez ce jeu-là, pas l’autre. Le test abandonne après environ 12 secondes si l’instance ne répond pas.
Mapping / choisir un modèle#
Choisissez le mapping standard Oracle Fusion. Il couvre les deux types de données que cette connexion importe : les commandes de vente depuis la ressource salesOrdersForOrderHub, et les factures depuis la ressource invoices. Après un test réussi, lancez une extraction et comparez une commande réelle et une facture réelle côte à côte (numéros, référence client, lignes et montants) avant d’activer. Il n’y a pas de mapping client ni de stock dans cette connexion, car elle n’importe ni les clients ni le stock.
Activer#
Après activation, la connexion importe les commandes de vente et les factures d’Oracle Fusion dans ce système selon la fréquence définie. Surveillez les premières extractions dans Runs / Logs et comparez-les avec Oracle Fusion avant de laisser la connexion sans surveillance. Si vous vous connectez avec un jeton, surveillez-le : quand le jeton collé cesse de fonctionner, les extractions commencent à échouer jusqu’à ce que vous en colliez un nouveau.
Ce que cette connexion ne fait pas : elle n’importe pas les clients d’Oracle Fusion, ne consulte ni n’importe le stock, et ne renvoie ni le stock ni quoi que ce soit d’autre vers Oracle Fusion. Continuez à gérer les clients et le stock dans Oracle Fusion même, ou dans les systèmes où ce travail se fait réellement.
FAQ#
Le test échoue avec 401 ou 403
Oracle Fusion a refusé le jeu d’identifiants que le test a réellement utilisé. Si un jeton est saisi, c’est le jeton qui a été utilisé — donc c’est le jeton qui a été refusé, même si le nom d’utilisateur et le mot de passe sont aussi saisis. Sans jeton saisi, ce sont le nom d’utilisateur et le mot de passe qui ont été refusés, ou cet utilisateur Fusion n’a pas les rôles d’intégration dont les ressources REST ont besoin.
Travaillez sur le jeu utilisé. Jeton en cours d’utilisation : obtenez un nouveau jeton d’accès OAuth2 dans votre domaine d’identité OCI / IDCS et collez-le en entier dans token. Basic en cours d’utilisation : revérifiez username et password ensemble, et confirmez dans Fusion que l’utilisateur a les rôles d’intégration. Puis retestez.
Le test s’arrête avec un message de valeur manquante avant tout envoi
La saisie est incomplète : soit base_url est vide, soit aucun jeu d’identifiants n’est complet. Un nom d’utilisateur sans son mot de passe n’est pas un jeu, et un mot de passe sans son nom d’utilisateur non plus — et sans jeton saisi, le test n’a aucun moyen de se connecter.
Remplissez base_url avec l’URL complète de l’instance, puis complétez exactement un jeu : username et password ensemble, ou un jeton collé en entier. Enregistrez, puis retestez.
Cela se connectait avant, puis les extractions ont commencé à échouer toutes seules
Si cette connexion se connecte avec un jeton, le jeton collé a cessé de fonctionner. Cette connexion utilise le jeton exactement tel que collé et n’en récupère pas un nouveau : un jeton qui fonctionnait au moment du test peut donc cesser de fonctionner plus tard, alors que toutes les autres valeurs restent correctes.
Obtenez un nouveau jeton d’accès OAuth2 dans votre domaine d’identité OCI / IDCS, collez-le en entier dans le champ token, enregistrez et testez. Si les échecs continuent avec un nouveau jeton, vérifiez plutôt le jeu Basic — ou videz le champ token volontairement pour revenir au nom d’utilisateur et au mot de passe.
J’ai saisi le nom d’utilisateur et le mot de passe, mais la connexion se comporte comme si je ne l’avais pas fait
Un jeton est aussi saisi sur cette connexion, et un jeton saisi est utilisé avant le nom d’utilisateur et le mot de passe. Les valeurs Basic ne sont pas fausses — ce n’est simplement pas le jeu utilisé tant qu’une valeur de jeton est présente.
Décidez du jeu que vous voulez. Pour utiliser le jeton, gardez-le valide et ignorez les champs Basic. Pour utiliser le nom d’utilisateur et le mot de passe, videz complètement le champ token, enregistrez, puis retestez.
Connecté, mais les clients ou le stock n’apparaissent jamais
C’est la portée de cette connexion, pas un échec : elle n’importe que les commandes de vente et les factures. Les clients et le stock ne sont pas importés par cette connexion, donc aucun changement de mapping, de fréquence ou d’identifiants ne les fera apparaître ici.
Continuez à gérer les clients et le stock dans Oracle Fusion même, ou dans le système où ces données vivent réellement. Utilisez cette connexion pour les commandes et les factures, et vérifiez ces deux-là dans Runs / Logs lors du contrôle.
Connecté, mais aucune commande ni facture n’est importée
La connexion fonctionne — le test a réellement lu la ressource des factures — mais il n’y a rien de nouveau à importer : l’instance n’a pas de nouvelles commandes de vente ni factures dans la plage d’extraction. Une mauvaise valeur de api_version peut causer le même résultat vide si votre environnement n’exécute pas cette version.
Créez ou confirmez une commande de vente et une facture dans Oracle Fusion, laissez api_version vide sauf si vous savez que votre environnement exécute une autre version que la valeur par défaut intégrée, lancez une extraction manuelle et confirmez que les deux apparaissent dans l’aperçu ou dans Runs / Logs.