Conectar OpenText Trading Grid: documentos EDI entrantes y salientes

Cree la conexión en Integration, en Conexiones EDI, complete el método de transporte, el host, el usuario y la contraseña o la clave privada tal como figuran en su paquete de incorporación de OpenText, revise la forma de las credenciales, mapee cada socio comercial y active.

OpenText Trading Grid es una plataforma EDI: a través de ella intercambia documentos EDI con sus socios comerciales — entran documentos de pedido de los socios y salen documentos de envío y factura. Esta conexión no se crea en un asistente de canal. Se crea en Integration, en Conexiones EDI, y cada dato que pide — host, usuario y el resto — viene del paquete de incorporación que OpenText le entrega al abrir su cuenta. No hay otro lugar donde consultar esos datos.

Requisitos previos#

• Una cuenta de OpenText Trading Grid, abierta o en proceso de apertura con OpenText. Los datos de la conexión se emiten como parte de esa apertura de cuenta: no son algo que usted cree o consulte por su cuenta.
• El paquete de incorporación de OpenText para su cuenta. Contiene el host, el usuario y cada otro dato de conexión que esta guía le pide completar. Téngalo a mano durante toda la configuración: si un dato no está en el paquete, es que falta, y la solución es preguntar a su contacto de incorporación de OpenText, no adivinarlo.
• Un método de transporte, tal como figura en el paquete de incorporación: SFTP con contraseña, SFTP con clave privada o entrega de archivos (file drop). El paquete decide cuál usa su cuenta: los tres métodos piden campos distintos en los pasos siguientes, así que sepa cuál es el suyo antes de empezar a completar.
• Al menos un socio comercial — un minorista u otro socio — con el que intercambiará documentos EDI a través de OpenText. Cada socio se mapea por separado más adelante en esta guía, con los identificadores de socio y de minorista acordados para ese socio.

Obtener credenciales#

1. Complete la apertura de cuenta con OpenText. Sus credenciales no se crean en un portal de autoservicio ni se pueden consultar en otro sitio: se le emiten como parte de esa incorporación.
2. Reciba el paquete de incorporación de su cuenta y localice en él el host SFTP y el usuario SFTP. Copie ambos exactamente como están escritos: esos valores vienen solo de OpenText, y un host o un usuario de cualquier otro origen no pertenecerán a su cuenta.
3. Localice el secreto que corresponde a su método de transporte. Si su paquete dice SFTP con contraseña, le entrega la contraseña SFTP. Si dice SFTP con clave privada, le entrega la clave privada SFTP. Si dice entrega de archivos (file drop), no hay contraseña ni clave privada que recoger para esta conexión.
4. Guarde juntos el paquete y el secreto, y trate la contraseña o la clave privada como un secreto desde el momento en que la recibe: guárdela en un lugar seguro, no la envíe en mensajes en claro y téngala lista para pegarla una vez, en la siguiente sección. Si falta algo que el paquete debería contener, pida a su contacto de incorporación de OpenText que lo complete: no rellene el hueco con un valor de otra cuenta o de otro sistema.

Completar en Integration#

1. Abra Integration → Conexiones EDI → Nueva conexión y elija OpenText Trading Grid. OpenText no tiene asistente de canal, así que si lo está buscando en una lista de canales o de marketplace, está en el lugar equivocado: la conexión vive con las demás conexiones EDI.
2. Método de transporte (transport_method): elija el que indica su paquete de incorporación — sftp_password para SFTP con contraseña, sftp_key para SFTP con clave privada o file_drop para entrega de archivos. Esta elección decide cuáles de los campos siguientes hacen falta, así que tiene que coincidir con el paquete, no con el método que parezca más fácil.
3. Host SFTP (sftp_host): pegue el host exactamente como aparece en su paquete de incorporación. No hay un host estándar que teclear de memoria: el paquete es la única fuente de este valor, así que cópielo en lugar de escribirlo, y si el paquete no muestra ningún host, deténgase y pregunte a su contacto de incorporación de OpenText en lugar de adivinar uno.
4. Usuario SFTP (sftp_username): pegue el usuario del mismo paquete de incorporación. Va en pareja con el host anterior: un usuario de otra cuenta o de otro sistema no hará pareja con él.
5. Contraseña SFTP (sftp_password): complete este campo solo cuando su método de transporte sea sftp_password. Pegue la contraseña del paquete de incorporación. Se guarda cifrada y nunca se vuelve a mostrar después de guardar: si más adelante necesita cambiarla, la reemplaza por un valor nuevo en lugar de ver la anterior. Para los otros dos métodos, deje este campo vacío.
6. Clave privada SFTP (sftp_private_key): complete este campo solo cuando su método de transporte sea sftp_key. Pegue la clave privada completa del paquete de incorporación, entera y sin editar: una clave acortada o reformateada es otra clave. Se guarda cifrada y nunca se vuelve a mostrar después de guardar. Para los otros dos métodos, deje este campo vacío. Si su método es file_drop, no aplica ninguno de los dos campos de secreto: lo que importa es que el método de transporte en sí coincida con el paquete.
7. Guarde la conexión, pero no trate el guardado como la meta. Pruébela a continuación y luego haga el mapping de socios comerciales: una conexión con las credenciales completas pero sin mapping de socios sigue sin poder colocar los documentos de ningún socio.

Probar la conexión#

Haga clic en Probar la conexión y lea el resultado por lo que realmente cubre. En esta etapa, la comprobación mira solo la forma de lo que completó: para el método que eligió, ¿está presente todo lo que ese método necesita — el propio método de transporte, el host y el usuario, la contraseña para el método de contraseña o la clave privada para el método de clave? Si falta algo que ese método necesita, la comprobación falla y nombra la pieza que falta. Si eligió file_drop, la comprobación informará de que el endpoint aún está por configurar: con ese método no hay ningún endpoint de servidor al que la comprobación pueda llegar, así que ese resultado es el esperado y no significa que haya completado algo mal. Y sea cual sea el resultado, tenga claro su alcance: una forma de credenciales completa no es prueba de que los archivos ya puedan moverse. El envío y la recepción reales de archivos se activan junto con la finalización de su conexión de incorporación con OpenText, así que juzgue este paso solo como una comprobación de completitud del formulario, y use las preguntas frecuentes de abajo cuando un resultado le sorprenda.

Mapping / elegir plantilla#

En OpenText el mapping es por socio comercial, no un ajuste único para toda la conexión. Para cada socio, registre los identificadores por los que se conoce a ese socio — el identificador de socio y el identificador de minorista acordados para ese socio durante la incorporación y la configuración del socio — y elija la plantilla de ese socio, para que sus documentos de pedido entrantes se reconozcan como de ese socio y se mapeen al pedido estándar, y sus datos de envío y factura se mapeen de vuelta a los documentos que ese socio espera. Los identificadores son lo importante: un documento que llega con identificadores que no coinciden con ningún mapping no puede colocarse con el socio correcto, por completas que sean las credenciales de la conexión. Trabaje socio por socio y use los identificadores exactamente como se acordaron para cada uno: no reutilice los identificadores de un socio para otro.

Activar#

Active la conexión una vez que el formulario esté completo y cada socio comercial con el que piense empezar esté mapeado. La activación pone la conexión, con su método de transporte y sus mappings de socios, en servicio del lado de Integration. Tenga en cuenta su alcance: el envío y la recepción reales de archivos a través de OpenText se activan junto con la finalización de su conexión de incorporación con OpenText, así que si la incorporación aún no se ha completado de ese lado, una conexión activada aún no transportará archivos — eso es la incorporación terminando, no un fallo en lo que usted completó. Una vez activo el intercambio de archivos, vigile los primeros documentos de cada socio en Runs / Logs, socio por socio, antes de dejar el intercambio sin supervisión.

Preguntas frecuentes#

La prueba informa de que el endpoint aún está por configurar (file drop)

Es el resultado esperado para el método de entrega de archivos (file drop), no una señal de que haya completado algo mal. Con file drop no hay ningún endpoint de servidor al que la comprobación pueda llegar, y los detalles de endpoint que vendrían de la incorporación no están configurados como algo que la comprobación pueda sondear, así que la comprobación lo dice tal cual en lugar de darlo por bueno.

No cambie el método de transporte ni invente un host solo para que la prueba se vea en verde. Mantenga el método que indica el paquete de incorporación, termine el mapping de socios comerciales y confirme con su contacto de incorporación de OpenText en qué punto está la apertura de la cuenta: el envío y la recepción de archivos se activan junto con la finalización de esa conexión de incorporación, y los primeros documentos reales son lo que debe comprobar en Runs / Logs.

La prueba falla: falta algo que el método elegido necesita

Los campos del formulario aún no forman un conjunto completo para el método de transporte que eligió. Los casos habituales son huecos simples: sin host, sin usuario, el método de contraseña elegido pero el campo de contraseña vacío, o el método de clave elegido pero el campo de clave privada vacío. Una desalineación también cuenta: por ejemplo, una clave privada pegada mientras el método sigue en el método de contraseña, así que la pieza que la comprobación busca no está.

Compare el formulario con el paquete de incorporación, campo por campo: primero el método de transporte, luego el host, luego el usuario y por último el único secreto que usa su método — la contraseña para sftp_password, la clave privada para sftp_key, pegada entera. Complete solo la pieza que falta o está mal colocada, guarde y pruebe de nuevo. Si un valor falta en el propio paquete, pídaselo a su contacto de incorporación de OpenText en lugar de tomar uno prestado de otra cuenta.

La forma de las credenciales parece completa, pero aún no se mueve ningún archivo

No necesariamente hay nada mal en el formulario. La prueba de conexión solo comprueba que la forma de las credenciales está completa para el método que eligió: por sí sola no establece la transferencia de archivos. El envío y la recepción reales de archivos se activan junto con la finalización de su conexión de incorporación con OpenText, así que un formulario que pasa por completo puede seguir sentado antes de ese interruptor: la conexión está lista de este lado y el intercambio de archivos aún no se ha encendido.

Confirme con su contacto de incorporación de OpenText si la conexión de incorporación de su cuenta está completa: esa finalización es lo que enciende el intercambio de archivos. Mientras tanto, termine el mapping de socios comerciales, para que de este lado no falte nada cuando se encienda. Una vez completa la conexión, compruebe los primeros documentos de cada socio en Runs / Logs; si los archivos siguen sin moverse después de confirmada la incorporación, vuelva a cotejar los datos de la conexión y los identificadores de socio con el paquete de incorporación.

Los documentos de un socio no aterrizan, o aterrizan con el socio equivocado

La conexión puede estar completa mientras el mapping de un socio no lo está. El mapping es por socio, y los documentos se colocan por los identificadores que llevan: el identificador de socio y el identificador de minorista acordados para ese socio. Si los identificadores registrados en el mapping de ese socio no coinciden con los que llevan sus documentos, los documentos no tienen un hogar correcto: o no aterrizan en absoluto, o se leen como de otro socio cuyos identificadores coinciden por casualidad.

Abra el mapping de ese socio y compare sus identificadores de socio y de minorista registrados, carácter por carácter, con los identificadores acordados para ese socio en la incorporación y la configuración del socio. Corrija ese mapping — nunca los mappings de los demás socios — guárdelo y compruebe el siguiente documento de ese socio en Runs / Logs. Un socio que añada más tarde necesita el mismo trato antes de su primer documento: sus propios identificadores, su propia plantilla, comprobados por separado.