Connecter Oracle WMS : consulter le stock uniquement — pas d’envoi de commandes

Saisissez le Client ID, le Client Secret, la Token URL IDCS et l’adresse de votre instance tenant dans la connexion WMS, testez l’échange OAuth et activez pour consulter le stock. Cette connexion n’envoie pas de commandes vers Oracle WMS.

Le connecteur Oracle WMS relie ce système à un tenant Oracle WMS Cloud pour une seule tâche : consulter le stock. Il lit les quantités de stock de l’instance du tenant pour un SKU. Il n’envoie pas de commandes vers Oracle WMS — l’envoi de commandes ne fait pas partie de cette connexion, donc les commandes doivent continuer d’arriver dans Oracle WMS par votre voie actuelle. Cette connexion se configure dans la zone WMS, pas dans l’assistant de canaux, et elle se connecte par un échange OAuth IDCS avec un Client ID, un Client Secret et une Token URL, plus l’adresse de l’instance du tenant pour les appels de stock.

Prérequis#

• Une instance tenant Oracle WMS Cloud et son adresse d’instance. L’adresse se définit par tenant : il n’y a pas d’adresse par défaut unique valable pour tous les tenants.
• Une application confidentielle IDCS créée pour votre instance WMS, avec son Client ID et son Client Secret prêts à copier.
• Le point de terminaison de token OAuth de votre domaine IDCS, à utiliser comme Token URL. Ce doit être le point de terminaison du même domaine IDCS que l’application ci-dessus.
• Accord au sein de votre équipe : cette connexion sert uniquement aux consultations de stock. Les commandes ont toujours besoin de leur voie actuelle vers Oracle WMS.

Obtenir les identifiants#

1. Depuis la configuration de l’instance Oracle WMS, prenez l’application confidentielle IDCS créée pour cette instance WMS. Copiez son Client ID.
2. Copiez le Client Secret de cette même application. Le Client ID et le Client Secret doivent venir de la même application : un secret d’une autre application ne s’échangera pas contre un token ici.
3. Notez la Token URL : le point de terminaison de token OAuth de votre domaine IDCS.
4. Notez l’adresse de l’instance de votre tenant Oracle WMS comme baseUrl. Copiez-la depuis les informations de votre propre tenant : n’empruntez pas l’adresse d’un autre tenant ni celle d’un exemple.

Remplir dans Integration#

Cette connexion n’a pas de liste de champs dans l’assistant de canaux. Ouvrez la connexion WMS d’Oracle WMS dans Integration et saisissez les valeurs ci-dessous dans ce formulaire de connexion WMS. Ne cherchez pas Oracle WMS dans les étapes de champs de l’assistant de canaux : l’assistant n’a pas de champs pour lui.

1. Client ID, obligatoire : le Client ID de l’application confidentielle IDCS créée pour votre instance WMS.
2. Client Secret, obligatoire : le secret de cette même application IDCS. C’est un champ secret, utilisé avec le Client ID quand le système échange contre un token.
3. Token URL, obligatoire : le point de terminaison de token OAuth de votre domaine IDCS. L’échange de token est envoyé exactement à cette adresse, donc copiez-la en entier.
4. Adresse de l’instance du tenant (baseUrl), obligatoire pour les appels de stock : l’adresse de votre propre instance tenant Oracle WMS. Le test de connexion n’utilise pas cette adresse, mais chaque consultation de stock oui, donc saisissez-la maintenant et saisissez-la exactement.

Tester la connexion#

Utilisez le test de la connexion WMS. Il envoie un échange de type client credentials à la Token URL saisie, authentifié avec votre Client ID et votre Client Secret, et il ne réussit que lorsqu’un access token revient. Si Client ID, Client Secret ou Token URL manque, le test s’arrête avec MISSING_CREDENTIALS. Si l’échange ne renvoie pas d’access token, il échoue avec AUTH_FAILED. Notez ce que le test ne fait pas : il n’appelle pas l’adresse de l’instance du tenant, donc une baseUrl incorrecte peut quand même réussir le test et n’apparaître que plus tard, à la première consultation de stock. Vous pouvez rencontrer deux entrées de test : ce test de la connexion WMS est la vraie vérification des identifiants décrite ici, tandis qu’un test affiché dans l’assistant de canaux ne contacte pas IDCS avec ces valeurs — ne considérez pas un succès là-bas comme la preuve que les valeurs IDCS fonctionnent. Jugez la connexion uniquement sur le test de la connexion WMS, puis sur une vraie consultation de stock.

Mapping / choisir un modèle#

Choisissez le modèle de stock Oracle WMS. Il ne couvre que le stock : un SKU de ce système correspond à l’enregistrement de stock de ce SKU sur l’instance du tenant, et la quantité renvoyée est celle que le tenant déclare. Il n’y a pas de modèle de commande à choisir pour cette connexion, car les commandes ne sont pas envoyées. L’appel de stock utilise l’interface d’entités du tenant, donc confirmez d’abord, sur un produit connu, la forme de SKU utilisée par votre tenant : code exact, casse et tout préfixe. Après un test réussi, lancez une consultation de stock pour un SKU au stock connu et comparez le nombre avec ce qu’affiche le tenant, avant d’activer.

Activer#

Après activation, les consultations de stock de ce système lisent les quantités actuelles dans votre tenant Oracle WMS pour les SKU mappés. Surveillez les premières consultations dans Runs / Logs et comparez-les avec le tenant avant de laisser la connexion sans surveillance.

Ce que cette connexion ne fait pas : elle n’envoie pas de commandes vers Oracle WMS et ne ramène pas de confirmations d’expédition depuis Oracle WMS. Continuez à envoyer les commandes par votre voie actuelle vers Oracle WMS, et à gérer la confirmation d’expédition dans le système où elle se fait aujourd’hui.

FAQ#

Une tentative d’envoi de commande échoue avec WMS_ENDPOINTS_PENDING

Cette connexion n’envoie pas de commandes vers Oracle WMS. L’entrée des commandes dans Oracle WMS dépend de la configuration du tenant, et cette connexion ne lit que le stock, donc l’envoi s’arrête avec WMS_ENDPOINTS_PENDING au lieu d’envoyer une demande. Ce n’est pas un problème d’identifiants et réessayer ne changera rien.

Arrêtez d’envoyer des commandes par cette connexion. Envoyez la commande par votre voie actuelle vers Oracle WMS, et utilisez cette connexion uniquement pour les consultations de stock.

Le test réussit, mais la consultation de stock échoue avec MISSING_BASE_URL

Le test échange seulement contre un token à la Token URL : il n’appelle jamais l’adresse de l’instance du tenant. La consultation de stock est la première étape qui a besoin de baseUrl, donc une adresse de tenant manquante ou vide n’apparaît que là, sous la forme MISSING_BASE_URL.

Saisissez l’adresse de l’instance du tenant sur la connexion WMS, avec l’adresse exacte de votre propre tenant Oracle WMS, enregistrez et relancez la consultation de stock. Le résultat du test n’a pas à changer : il n’a jamais vérifié cette adresse.

Le test WMS échoue avec AUTH_FAILED

L’échange à la Token URL n’a pas renvoyé d’access token. La paire Client ID et Client Secret n’a pas été acceptée à ce point de terminaison : le secret n’appartient pas à l’application de ce Client ID, ou la Token URL est le point de terminaison d’un autre domaine IDCS.

Retournez à l’application IDCS créée pour votre instance WMS et recopiez Client ID et Client Secret depuis cette même application, puis confirmez que la Token URL est le point de terminaison de token OAuth du même domaine IDCS, et retestez.

Le test s’arrête avec MISSING_CREDENTIALS

L’une des trois valeurs IDCS est vide sur la connexion WMS : Client ID, Client Secret ou Token URL. L’échange a besoin des trois, donc le test s’arrête avant de contacter IDCS.

Remplissez les trois champs du formulaire de connexion WMS depuis l’application et le domaine IDCS, enregistrez, puis retestez. Ne mettez pas l’adresse de l’instance du tenant dans le champ Token URL : ce sont deux adresses différentes avec deux rôles différents.

Le test de l’assistant de canaux a réussi, mais le test WMS échoue toujours

Les deux tests ne sont pas la même vérification. L’assistant de canaux n’a pas de champs Oracle WMS et son test n’échange pas de token avec IDCS à l’aide de votre Client ID, de votre Client Secret et de votre Token URL, donc un succès là-bas ne dit rien sur les valeurs IDCS. Seul le test de la connexion WMS effectue le vrai échange.

Ignorez le résultat de l’assistant pour cette connexion. Lancez le test de la connexion WMS et partez de son résultat, puis lancez une vraie consultation de stock pour prouver aussi l’adresse du tenant.

La consultation de stock ne renvoie rien pour un SKU qui a du stock dans le tenant

La consultation de stock demande à l’instance du tenant l’enregistrement de stock du SKU envoyé. Si la forme du SKU envoyé — code exact, casse ou préfixe — ne correspond pas à celle du tenant, ou si l’adresse du tenant pointe vers un autre tenant, la réponse revient vide même s’il y a du stock.

Confirmez d’abord que l’adresse de l’instance est bien celle de votre propre tenant. Prenez ensuite le SKU exact sur la fiche produit dans le tenant, mettez cette forme dans le mapping et relancez la consultation de stock.