Conectar Rithum (Dsco): pedidos entrantes, mensajes ASN y de factura salientes

Obtenga el Client ID y el Client Secret de su cuenta de proveedor de Rithum, deje vacía la URL base de la API para producción o complete la dirección sandbox para probar primero, pruebe, configure el mapping por socio comercial y active.

El conector de Rithum intercambia documentos EDI con minoristas a través de la red de Rithum (Dsco API v3): los documentos de pedido de sus socios comerciales entran y se convierten en pedidos, y los documentos ASN y de factura vuelven a esos socios, con el inventario intercambiado por la misma conexión. No es un inicio de sesión de tienda: todo se organiza por socio comercial y por documento.

Requisitos previos#

• Una cuenta de proveedor de Rithum (Dsco). Las credenciales de API de esta conexión pertenecen a esa cuenta de proveedor: no son un inicio de sesión de tienda.
• Su contacto de incorporación de Rithum al alcance: el Client ID y el Client Secret se emiten en pareja para su cuenta de proveedor, y si aún no los tiene, el contacto de incorporación es quien se los proporciona.
• Al menos un socio comercial (minorista) con el que intercambie documentos en Rithum: pedidos entrantes, ASN y facturas salientes. Cada socio se mapea por separado más adelante en esta guía.
• Una elección de entorno para la primera conexión: deje vacía la URL base de la API para usar producción, o complete la dirección sandbox para probar primero la conexión. Las direcciones exactas están en el paso de completar en Integration, más abajo.

Obtener credenciales#

1. Busque en su cuenta de proveedor de Rithum, en los ajustes de API / desarrollador, las credenciales de API: el Client ID y el Client Secret. Pertenecen a la cuenta de proveedor y se emiten en pareja: necesita ambos.
2. Si allí no hay credenciales de API, pídaselas a su contacto de incorporación de Rithum. Dígale que necesita el Client ID y el Client Secret de API de su cuenta de proveedor.
3. Copie ambos valores completos y guárdelos en un lugar seguro. La pareja solo funciona junta: un Client ID de una pareja emitida no funcionará con un Client Secret de otra.
4. Si pierde el Client Secret, pida a Rithum que emita uno nuevo: un secreto perdido no se puede recuperar de la conexión, porque nunca vuelve a mostrarse después de guardarlo.

Completar en Integration#

1. Abra Integration → Marketplace → Rithum → Nueva conexión.
2. URL base de la API (opcional): deje este campo vacío para usar producción; la conexión irá entonces a https://api.dsco.io/api/v3. Para probar primero la conexión contra el sandbox, complete en su lugar https://staging-api.dsco.io/api/v3. Complete exactamente una de estas dos direcciones, o deje el campo vacío: no escriba una dirección de otro sistema.
3. Client ID: pegue el Client ID emitido para su cuenta de proveedor de Rithum. Tenga cuidado de no intercambiarlo con el Client Secret: el ID va en este campo y el secreto en el siguiente.
4. Client Secret: pegue el Client Secret de la misma pareja emitida que el Client ID. Se cifra en reposo y nunca se muestra.

Probar la conexión#

Haga clic en Probar la conexión. La prueba se ejecuta en dos pasos, y ambos deben pasar para que la conexión cuente como funcionando. Primero intercambia su Client ID y su Client Secret por un token de acceso con Rithum. Después usa ese token para llamar a la comprobación /hello en la dirección de API que eligió: la dirección de producción cuando la URL base está vacía, o la dirección sandbox que completó. Si pasa, ambos pasos funcionaron: sus credenciales fueron aceptadas y la API de Rithum respondió. Si falla, conserve el error que muestra la prueba: indica si se rompió el paso del token o el paso de /hello, y las preguntas frecuentes de abajo tratan cada caso.

Mapping / elegir plantilla#

En Rithum el mapping es por socio comercial, no un ajuste único para toda la conexión. Para cada socio minorista, elija la plantilla de ese socio y revise cómo sus documentos de pedido se mapean al pedido estándar — número de pedido, líneas, cantidades y datos de envío — y cómo los datos de ASN y factura se mapean de vuelta al formato de documento que ese socio espera. Un socio sin mapping configurado no tiene dónde dejar caer sus documentos: sus pedidos no pueden entrar, y los documentos ASN y de factura no pueden generarse para él. Que la prueba de conexión pase solo demuestra que las credenciales y la dirección de API funcionan: no significa que ningún socio esté mapeado todavía. Trabaje socio por socio y revise la vista previa de mapping de cada uno antes de activar.

Activar#

Tras activar, los documentos de pedido de sus socios comerciales mapeados entran y se convierten en pedidos, el inventario se intercambia por la conexión, y los documentos ASN y de factura se envían de vuelta a cada socio a través de Rithum. Los socios sin mapping quedan en silencio: nada fluye para ellos hasta que su mapping esté configurado. Si probó contra la dirección sandbox, vuelva a dejar vacía la URL base de la API (producción) y pruebe de nuevo antes de activar para el comercio real. Vigile los primeros documentos de cada socio en Runs / Logs antes de dejar el intercambio sin supervisión.

Preguntas frecuentes#

La prueba falla en el paso del token

Rithum no aceptó las credenciales, así que no se emitió ningún token y la prueba nunca llegó a la comprobación /hello. Las causas habituales son un valor copiado incompleto, el Client ID y el Client Secret pegados en los campos del otro, o que ambos valores vengan de parejas emitidas distintas: el ID y el secreto solo funcionan como la pareja en la que fueron emitidos.

Vuelva a copiar ambos valores desde los ajustes de API / desarrollador de su cuenta de proveedor, asegurándose de que el Client ID vaya en el campo Client ID y el Client Secret en el campo Client Secret, ambos de la misma pareja emitida. Si ya no tiene el secreto, o no está seguro de a qué pareja pertenecen sus valores, pida a su contacto de incorporación de Rithum una pareja recién emitida, complete ambos valores, guarde y pruebe de nuevo.

El token se emite, pero la comprobación /hello falla

Sus credenciales fueron aceptadas — el paso del token pasó — pero la dirección de API a la que apunta la conexión no respondió a la comprobación /hello, así que la conexión aún no cuenta como conectada. La causa habitual es la URL base de la API: se escribió distinta de las dos direcciones que usa esta conexión, se editó a mano, o quedó apuntando al sandbox cuando usted quería probar producción (o al revés).

Ajuste la URL base de la API a exactamente una de las dos direcciones: déjela vacía para producción (https://api.dsco.io/api/v3), o complete la dirección sandbox https://staging-api.dsco.io/api/v3 si está probando contra el sandbox. Guarde y pruebe de nuevo. Si la comprobación /hello sigue fallando con la dirección exacta, conserve el error que muestra la prueba y revise Runs / Logs antes de intentarlo de nuevo.

Conectado, pero los pedidos de un socio nunca entran

La conexión en sí funciona: la prueba pasa y otros socios pueden estar fluyendo. El problema es que este socio comercial no tiene mapping configurado, o usted sigue conectado a la dirección sandbox mientras el socio envía en producción, así que sus documentos de pedido no tienen dónde aterrizar en esta conexión.

Primero revise la URL base de la API: para el comercio real debe estar vacía (producción). Después abra el mapping de ese socio comercial, elija su plantilla y revise la vista previa de mapping con uno de sus documentos de pedido reales: número de pedido, líneas, cantidades y datos de envío deben caer en el pedido estándar. Guarde el mapping y luego revise Runs / Logs para el siguiente documento de ese socio.

Los pedidos entran, pero los documentos ASN y de factura no llegan al socio

La entrada funciona, así que las credenciales y la dirección de API están bien. El hueco está en el lado saliente del mapping de ese socio: el socio está mapeado para los documentos de pedido entrantes, pero sus documentos ASN y de factura salientes nunca se configuraron, así que los resultados del fulfillment no tienen documento en el que volver.

Abra el mapping de ese socio comercial y configure también el lado saliente: documentos ASN y documentos de factura, en el formato que ese socio espera. Revise la vista previa de mapping con un pedido ya fulfilled y luego vigile Runs / Logs para el siguiente documento saliente a ese socio.