Conectar Oracle WMS: solo consultar inventario, sin enviar pedidos
Complete el Client ID, el Client Secret, la Token URL de IDCS y la dirección de su instancia de tenant en la conexión WMS, pruebe el intercambio OAuth y active para consultar inventario. Esta conexión no envía pedidos a Oracle WMS.
El conector de Oracle WMS conecta este sistema con un tenant de Oracle WMS Cloud para una sola tarea: consultar inventario. Lee las cantidades de inventario de la instancia del tenant para un SKU. No envía pedidos a Oracle WMS: el envío de pedidos no forma parte de esta conexión, así que los pedidos deben seguir llegando a Oracle WMS por su ruta actual. Esta conexión se configura en el área WMS, no en el asistente de canales, e inicia sesión con un intercambio OAuth de IDCS usando un Client ID, un Client Secret y una Token URL, además de la dirección de la instancia del tenant para las llamadas de inventario.
Requisitos previos#
- Una instancia de tenant de Oracle WMS Cloud y su dirección de instancia. La dirección se define por tenant: no hay una dirección predeterminada única que sirva para todos los tenants.
- Una aplicación confidencial de IDCS creada para su instancia de WMS, con su Client ID y su Client Secret listos para copiar.
- El endpoint de token OAuth de su dominio IDCS, para usarlo como Token URL. Debe ser el endpoint del mismo dominio IDCS que la aplicación anterior.
- Acuerdo dentro de su equipo de que esta conexión es solo para consultas de inventario. Los pedidos siguen necesitando su ruta actual hacia Oracle WMS.
Obtener credenciales#
- Desde la configuración de la instancia de Oracle WMS, tome la aplicación confidencial de IDCS creada para esta instancia de WMS. Copie su Client ID.
- Copie el Client Secret de esa misma aplicación. El Client ID y el Client Secret deben venir de la misma aplicación: un secreto de otra aplicación no se canjeará por un token aquí.
- Anote la Token URL: el endpoint de token OAuth de su dominio IDCS.
- Anote la dirección de la instancia de su tenant de Oracle WMS como baseUrl. Cópiela de la información de su propio tenant: no tome una dirección de otro tenant ni de un ejemplo.
Completar en Integration#
Esta conexión no tiene lista de campos en el asistente de canales. Abra la conexión WMS de Oracle WMS en Integration y complete los valores siguientes en ese formulario de conexión WMS. No busque Oracle WMS en los pasos de campos del asistente de canales: el asistente no tiene campos para ella.
- Client ID, obligatorio: el Client ID de la aplicación confidencial de IDCS creada para su instancia de WMS.
- Client Secret, obligatorio: el secreto de esa misma aplicación de IDCS. Es un campo secreto y se usa con el Client ID cuando el sistema canjea por un token.
- Token URL, obligatorio: el endpoint de token OAuth de su dominio IDCS. El intercambio de token se envía exactamente a esta dirección, así que cópiela entera.
- Dirección de la instancia del tenant (baseUrl), obligatoria para las llamadas de inventario: la dirección de su propia instancia de tenant de Oracle WMS. La prueba de conexión no usa esta dirección, pero cada consulta de inventario sí, así que complétela ahora y complétela con exactitud.
Probar la conexión#
Use la prueba de la conexión WMS. Envía un intercambio de credenciales de cliente a la Token URL completada, autenticado con su Client ID y su Client Secret, y solo aprueba cuando vuelve un access token. Si falta Client ID, Client Secret o Token URL, la prueba se detiene con MISSING_CREDENTIALS. Si el intercambio no devuelve access token, falla con AUTH_FAILED. Note lo que la prueba no hace: no llama a la dirección de la instancia del tenant, así que una baseUrl incorrecta puede aprobar la prueba igualmente y solo aparece después, en la primera consulta de inventario. Hay dos entradas de prueba que puede encontrar: esta prueba de la conexión WMS es la comprobación real de credenciales descrita aquí, mientras que una prueba mostrada en el asistente de canales no contacta con IDCS con estos valores: no trate un aprobado allí como prueba de que los valores de IDCS funcionan. Juzgue la conexión solo por la prueba de la conexión WMS y después por una consulta real de inventario.
Mapping / elegir plantilla#
Elija la plantilla de inventario de Oracle WMS. Cubre solo inventario: un SKU de este sistema se corresponde con el registro de inventario de ese SKU en la instancia del tenant, y la cantidad devuelta es la que informa el tenant. No hay plantilla de pedidos que elegir para esta conexión, porque los pedidos no se envían. La llamada de inventario usa la interfaz de entidades del tenant, así que confirme primero, en un producto conocido, la forma de SKU que usa su tenant: código exacto, mayúsculas y cualquier prefijo. Tras aprobar la prueba, ejecute una consulta de inventario para un SKU con stock conocido y compare el número con lo que muestra el tenant, antes de activar.
Activar#
Tras activar, las consultas de inventario de este sistema leen las cantidades actuales de su tenant de Oracle WMS para los SKU mapeados. Vigile las primeras consultas en Runs / Logs y compárelas con el tenant antes de dejar la conexión sin supervisión.
Lo que esta conexión no hace: no envía pedidos a Oracle WMS y no trae confirmaciones de envío desde Oracle WMS. Siga enviando los pedidos por su ruta actual hacia Oracle WMS y siga gestionando la confirmación de envío en el sistema donde ocurre hoy.
Preguntas frecuentes#
Un intento de envío de pedido falla con WMS_ENDPOINTS_PENDING
Esta conexión no envía pedidos a Oracle WMS. La entrada de pedidos en Oracle WMS depende de la configuración del tenant, y esta conexión solo lee inventario, así que el envío se detiene con WMS_ENDPOINTS_PENDING en lugar de enviar una solicitud. No es un problema de credenciales y reintentar no lo cambiará.
Deje de enviar pedidos por esta conexión. Envíe el pedido por su ruta actual hacia Oracle WMS y use esta conexión solo para consultas de inventario.
La prueba aprueba, pero la consulta de inventario falla con MISSING_BASE_URL
La prueba solo canjea por un token en la Token URL: nunca llama a la dirección de la instancia del tenant. La consulta de inventario es el primer paso que necesita baseUrl, así que una dirección de tenant ausente o vacía solo aparece allí, como MISSING_BASE_URL.
Complete la dirección de la instancia del tenant en la conexión WMS con la dirección exacta de su propio tenant de Oracle WMS, guarde y ejecute la consulta de inventario de nuevo. El resultado de la prueba no tiene que cambiar: nunca estuvo comprobando esta dirección.
La prueba WMS falla con AUTH_FAILED
El intercambio en la Token URL no devolvió access token. La pareja de Client ID y Client Secret no fue aceptada en ese endpoint: el secreto no pertenece a la aplicación de ese Client ID, o la Token URL es el endpoint de otro dominio IDCS.
Vuelva a la aplicación de IDCS creada para su instancia de WMS y copie de nuevo Client ID y Client Secret desde esa misma aplicación, confirme que la Token URL es el endpoint de token OAuth del mismo dominio IDCS y pruebe de nuevo.
La prueba se detiene con MISSING_CREDENTIALS
Falta uno de los tres valores de IDCS en la conexión WMS: Client ID, Client Secret o Token URL. El intercambio necesita los tres, así que la prueba se detiene antes de contactar con IDCS.
Complete los tres campos en el formulario de conexión WMS desde la aplicación y el dominio de IDCS, guarde y pruebe de nuevo. No complete la dirección de la instancia del tenant en el campo Token URL: son direcciones distintas con trabajos distintos.
La prueba del asistente de canales aprobó, pero la prueba WMS sigue fallando
Las dos pruebas no son la misma comprobación. El asistente de canales no tiene campos de Oracle WMS y su prueba no canjea un token con IDCS usando su Client ID, su Client Secret y su Token URL, así que un aprobado allí no dice nada sobre los valores de IDCS. Solo la prueba de la conexión WMS hace el canje real.
Ignore el resultado del asistente para esta conexión. Ejecute la prueba de la conexión WMS y trabaje desde su resultado, y después ejecute una consulta real de inventario para probar también la dirección del tenant.
La consulta de inventario no devuelve nada para un SKU con stock en el tenant
La consulta de inventario pide a la instancia del tenant el registro de inventario del SKU enviado. Si la forma del SKU enviado (código exacto, mayúsculas o prefijo) no coincide con la que usa el tenant, o la dirección del tenant apunta a otro tenant, la respuesta vuelve vacía aunque haya stock.
Confirme primero que la dirección de la instancia es la de su propio tenant. Después tome el SKU exacto del registro del producto en el tenant, ponga esa forma en el mapping y ejecute la consulta de inventario de nuevo.