Conectar TrueCommerce: mensajes de pedido entrantes, mensajes de envío y factura salientes

Solicite la URL base a su equipo de TrueCommerce, complete una clave API o sus credenciales de cliente OAuth, pruebe, configure el mapping por socio comercial y active.

El conector de TrueCommerce intercambia documentos EDI con sus socios comerciales a través de TrueCommerce: los mensajes de pedido de sus socios entran y se convierten en pedidos, y los mensajes de envío y factura vuelven a esos socios. No es una conexión de tienda: todo se organiza por socio comercial y por mensaje.

Requisitos previos#

• Una cuenta de TrueCommerce, con un equipo de cuenta al que pedir la URL base de la API y las credenciales.
• Al menos un socio comercial con el que intercambie mensajes EDI: mensajes de pedido entrantes y mensajes de envío y factura salientes. Cada socio se mapea por separado más adelante en esta guía.
• Una decisión sobre qué método de autenticación usará esta conexión: una clave API por sí sola, o credenciales de cliente OAuth (Client ID + Client Secret) cuando no tenga clave API. Los dos métodos son alternativas: no mezcle campos de ambos.

Obtener credenciales#

1. Solicite a su equipo de cuenta de TrueCommerce la URL base de la API de su cuenta. Sin ella la conexión no se puede completar: es la dirección por la que pasa todo el intercambio de mensajes.
2. Si usará una clave API: pida a TrueCommerce la clave API de su cuenta y cópiela completa. Con una clave API no necesita los campos de OAuth.
3. Si no tiene clave API: pida a TrueCommerce, en su lugar, las credenciales de cliente OAuth: el Client ID de OAuth y el Client Secret de OAuth. Ambos son obligatorios juntos.
4. Guarde el Client Secret en un lugar seguro en cuanto lo reciba: se muestra una sola vez. Si lo pierde, pida a su equipo de cuenta de TrueCommerce que emita uno nuevo.

Completar en Integration#

1. Abra Integration → Marketplace → TrueCommerce → Nueva conexión.
2. URL base: pegue la URL base de la API de TrueCommerce que le dio su equipo de cuenta, empezando por https://. Este campo es obligatorio y debe ser la dirección de TrueCommerce: una dirección de otro sistema no responderá.
3. Clave API: si usa el método de clave API, pegue aquí la clave API de TrueCommerce. Si usa OAuth en su lugar, deje este campo vacío: un campo de clave API vacío es lo que indica a la conexión que use sus credenciales de cliente OAuth.
4. Client ID de OAuth: obligatorio solo cuando el campo de clave API está vacío. Pegue el Client ID de OAuth que TrueCommerce emitió para su cuenta. Si completó una clave API, puede dejar este campo vacío.
5. Secreto de cliente OAuth: obligatorio solo cuando el campo de clave API está vacío, y va en pareja con el Client ID de OAuth: ambos deben venir del mismo conjunto emitido. Se cifra en reposo y nunca se muestra.

Probar la conexión#

Haga clic en Probar la conexión. La prueba va a la URL base que completó y presenta las credenciales del método que eligió: la clave API, o el Client ID y el Client Secret de OAuth cuando el campo de clave API está vacío. Si pasa, TrueCommerce fue alcanzado en esa dirección y aceptó esas credenciales. Si falla, conserve el error que muestra la prueba: indica si se rechazó la dirección o las credenciales, y las preguntas frecuentes de abajo tratan cada caso.

Mapping / elegir plantilla#

En TrueCommerce el mapping es por socio comercial, no un ajuste único para toda la conexión. Para cada socio, elija la plantilla de ese socio y revise cómo sus mensajes 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 envío y factura se mapean de vuelta al formato de mensaje que ese socio espera. Un socio sin mapping configurado no tiene dónde dejar caer sus mensajes: sus mensajes de pedido no pueden convertirse en pedidos, y los mensajes de envío y factura no pueden generarse para él. Trabaje socio por socio y revise la vista previa de mapping de cada uno antes de activar.

Activar#

Tras activar, los mensajes de pedido de sus socios comerciales mapeados entran y se convierten en pedidos, y los mensajes de envío y factura se envían de vuelta a cada socio a través de TrueCommerce. Los socios sin mapping quedan en silencio: nada fluye para ellos hasta que su mapping esté configurado. Vigile los primeros mensajes de cada socio en Runs / Logs antes de dejar el intercambio sin supervisión.

Preguntas frecuentes#

La prueba falla: las credenciales son rechazadas

Las credenciales de la conexión no coinciden con lo que TrueCommerce emitió para su cuenta. Las causas habituales son un valor copiado incompleto, o un método a medio completar: el campo de clave API quedó vacío — lo que cambia la conexión a OAuth — pero solo se completó uno entre el Client ID y el Client Secret de OAuth, así que la pareja está incompleta y no puede ser aceptada.

Decida un método y complételo entero. Método de clave API: pegue la clave API completa y deje vacíos los campos de OAuth. Método OAuth: deje vacía la clave API y pegue tanto el Client ID como el Client Secret de OAuth del mismo conjunto emitido; recuerde que el secreto se muestra una sola vez, así que si su copia guardada se perdió, pida uno nuevo a su equipo de cuenta de TrueCommerce. Guarde y pruebe de nuevo.

La prueba falla: no se puede llegar a TrueCommerce en absoluto

La URL base de la conexión es incorrecta, así que la prueba está llamando a la puerta equivocada. Las causas comunes son una dirección mal escrita o truncada, una dirección pensada para otro sistema, o una dirección antigua después de que su equipo de cuenta le diera una nueva: las credenciales ni siquiera llegan a comprobarse porque nada de TrueCommerce responde ahí.

Pida a su equipo de cuenta de TrueCommerce que confirme la URL base de la API exacta de su cuenta, reemplace la URL base de la conexión por esa dirección tal como se la dieron — empezando por https:// — y luego guarde y pruebe de nuevo.

Conectado, pero los mensajes de pedido de un socio nunca se convierten en pedidos

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 su plantilla no cubre sus mensajes de pedido, así que sus mensajes entrantes no tienen dónde aterrizar y nunca se convierten en pedidos.

Abra el mapping de ese socio comercial, elija su plantilla y revise la vista previa de mapping con uno de sus mensajes 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 mensaje de ese socio.

Los pedidos entran, pero los mensajes de envío y factura no llegan al socio

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

Abra el mapping de ese socio comercial y configure también el lado saliente: mensajes de envío y mensajes 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 mensaje saliente a ese socio.