Conectar B2BGateway: pedidos entrantes, envíos y facturas salientes por EDI

Solicite la URL base a su equipo de cuenta de B2BGateway, copie la clave API de su cuenta de B2BGateway, pegue ambas en Integration, pruebe, mapee cada socio comercial y active: entran mensajes de pedido y salen mensajes de envío y factura.

El conector de B2BGateway intercambia documentos EDI con sus socios comerciales a través de B2BGateway: los mensajes de orden de compra llegan de los socios y se convierten en pedidos, y los mensajes de envío y factura vuelven a los mismos socios. No es una conexión de tienda: todo se organiza por socio comercial y por tipo de documento, así que cada socio se configura y se comprueba por separado.

Requisitos previos#

• Una cuenta de B2BGateway. La URL base no es una dirección pública que usted busque por su cuenta: su equipo de cuenta de B2BGateway se la entrega para su cuenta.
• Acceso a la clave API de esa cuenta de B2BGateway, o un contacto que pueda proporcionarla. La clave se envía como cabecera X-API-Key en cada solicitud.
• Al menos un socio comercial con quien intercambiar documentos a través de B2BGateway. Esta conexión no crea el socio por usted: el lado del socio en el intercambio debe existir antes de que sus mensajes puedan fluir.
• Para la primera conexión, pruebe primero la configuración con un mensaje de prueba de un socio; nunca pruebe un mapping nuevo con documentos reales de un socio.

Obtener credenciales#

1. Solicite a su equipo de cuenta de B2BGateway la URL base de la API para su cuenta y cópiela exactamente como se la entreguen. Empieza por https://: si la dirección parece incompleta, pida que la confirmen en lugar de adivinar el resto.
2. Obtenga la clave API de su cuenta de B2BGateway. Si no la encuentra en la cuenta, pregunte a su equipo de cuenta de B2BGateway dónde la muestra su cuenta; no reutilice una clave de otra cuenta.
3. Guarde los dos valores juntos: la URL base dice con dónde habla la conexión y la clave API prueba que es su cuenta. Necesitará ambos en el siguiente paso.

Completar en Integration#

1. Abra Integration → Marketplace → B2BGateway → Nueva conexión.
2. URL base (obligatoria): pegue la URL base de la API de B2BGateway que le dio su equipo de cuenta, por ejemplo https://… Copie la dirección completa exactamente: un carácter faltante, un espacio extra o una dirección de otra cuenta harán fallar la prueba del siguiente paso, aunque la clave API sea correcta.
3. Clave API (obligatoria): pegue la clave API de su cuenta de B2BGateway. Se envía como cabecera X-API-Key cuando la conexión habla con B2BGateway. Se guarda como secreto, cifrada en reposo, y nunca se vuelve a mostrar después de guardar.
4. Guarde la conexión, pero no la active todavía. Pruébela primero y luego haga el mapping de socios comerciales: una conexión con las credenciales correctas pero sin mapping de socios no puede mover ningún documento.

Probar la conexión#

Haga clic en Probar la conexión. La prueba habla con la URL base que completó y presenta su clave API como cabecera X-API-Key, así que comprueba la dirección y la clave juntas: si pasa, B2BGateway respondió y aceptó la clave de su cuenta. Luego ejecute la vista previa a nivel de documento con un mensaje de pedido real de un socio comercial, para ver los campos del socio junto al pedido estándar antes de poner nada en vivo. Si ningún socio ha enviado aún un mensaje de prueba, pida al socio —o a su equipo de cuenta de B2BGateway— que envíe uno primero; la vista previa necesita un mensaje real. Si la prueba misma falla, use las preguntas frecuentes: averigüe si la culpa es de la URL base o de la clave API antes de cambiar ambas a la vez.

Mapping / elegir plantilla#

En B2BGateway, el mapping es por socio comercial, no un solo ajuste para toda la conexión. Para cada socio, elija la plantilla de ese socio y compruebe los tipos de documento que intercambia con él: mensajes de pedido entrantes y mensajes de envío y factura salientes. En la vista previa, compruebe que los identificadores del socio, los números de artículo, las cantidades y los datos de envío caigan en los campos correctos del pedido estándar, y que sus datos de envío y factura se mapeen de vuelta a los campos que ese socio espera. Los socios no comparten un mismo mapping: un socio con el mapping terminado puede entrar en vivo mientras otro aún se está configurando, y un socio nuevo siempre necesita su propia comprobación de mapping antes de su primer documento real.

Activar#

Tras activar, los mensajes de pedido de sus socios comerciales mapeados entran como pedidos y, una vez enviados esos pedidos, los mensajes de envío y factura vuelven al socio a través de B2BGateway. Vigile los primeros documentos de cada socio en Runs / Logs: un socio que aún no haya mapeado no intercambiará documentos, así que compruebe por separado el primer pedido, el primer envío y la primera factura de cada socio antes de confiar en la conexión sin supervisión.

Preguntas frecuentes#

La prueba falla: la clave API es rechazada

La clave API completada en la conexión no coincide con la clave de su cuenta de B2BGateway. La clave viaja como cabecera X-API-Key, así que un solo carácter incorrecto o faltante, un espacio al final al pegar, o una clave que pertenece a otra cuenta de B2BGateway se leen igual para B2BGateway: no es su clave.

Obtenga la clave API de nuevo desde su cuenta de B2BGateway — pregunte a su equipo de cuenta dónde la muestra la cuenta si no la encuentra — péguela en el campo de clave API sin nada antes ni después, guarde y pruebe de nuevo. No cambie la URL base al mismo tiempo, para poder saber qué corrección funcionó.

La prueba falla: la conexión no llega a B2BGateway

La URL base completada en la conexión es incorrecta, así que la solicitud nunca llega a la dirección de B2BGateway correcta para su cuenta. Es la causa habitual cuando la dirección se escribió a mano, se acortó o se copió de otra cuenta: la clave API puede ser perfecta y la prueba aun así no pasa.

Pida a su equipo de cuenta de B2BGateway que confirme la URL base exacta de la API para su cuenta, reemplace el campo de URL base con esa dirección copiada entera — empezando por https:// y sin añadir ni quitar nada — guarde y pruebe de nuevo.

La prueba pasa, pero los documentos de un socio comercial no fluyen

El mapping de ese socio comercial aún no está configurado, o no está terminado. La prueba de conexión solo demuestra que la dirección y la clave API están bien: los documentos se mueven por socio, así que un socio sin un mapping completo no tiene con qué convertir sus mensajes de pedido, ni por dónde enviar sus mensajes de envío y factura, aunque otros socios de la misma conexión funcionen bien.

Abra el paso de Mapping para ese socio, elija la plantilla del socio, mapee los tipos de documento que intercambia con él — pedidos entrantes, envíos y facturas salientes — y ejecute la vista previa de documento con un mensaje real de ese socio. Active el intercambio del socio solo después de que la vista previa coloque cada campo en su sitio, y compruebe sus primeros documentos reales en Runs / Logs.