Conectar Cleo Integration Cloud: intercambiar archivos EDI por buzones de socios

Complete la dirección de su instancia de Cleo y el usuario y la contraseña del buzón que emitió su administrador de Cleo, pruebe el inicio de sesión, mapee cada socio y active.

El conector de Cleo intercambia archivos EDI con sus socios comerciales a través de un buzón de socio en su instancia de Cleo Integration Cloud: los archivos nuevos llegan a la carpeta de descarga del buzón y se convierten en pedidos, y los archivos salientes, como avisos de envío y facturas, se suben de vuelta por el buzón. Esta conexión no usa un par de claves API: no hay ningún Client ID que buscar en Cleo. En su lugar, inicia sesión con la dirección de su instancia y una cuenta de buzón, tal como se describe a continuación.

Requisitos previos#

• Una instancia de Cleo Integration Cloud en la que pueda iniciar sesión, y su dirección: la misma que usa para abrir Cleo Integration Cloud o Harmony en su navegador.
• Un buzón de socio configurado en esa instancia para los socios con los que intercambiará archivos. El usuario y la contraseña del buzón los emite su propio administrador de Cleo cuando se crea el buzón de socio.
• Al menos un socio comercial EDI cuyos archivos pasen por ese buzón: por ejemplo, órdenes de compra entrantes, y avisos de envío y facturas salientes.
• Una cosa que confirmar con su administrador de Cleo antes de empezar: si su instancia tiene activada la verificación por clave API para las llamadas a la API. Solo en ese caso necesitará una clave API: la mayoría de las instancias no la tienen, y la mayoría de las personas dejan ese campo vacío.

Obtener credenciales#

1. Anote la dirección de su instancia de Cleo. Es la dirección con la que inicia sesión en Cleo Integration Cloud o Harmony, por ejemplo https://mycompany.cleointegration.com. Será la URL base del paso siguiente: es obligatoria y debe ser su propia instancia, no una dirección compartida ni de ejemplo.
2. Pida a su administrador de Cleo el usuario y la contraseña del buzón de socio. Se emitieron juntos cuando se creó el buzón, y es la cuenta que la conexión usa para iniciar sesión e intercambiar archivos: es una cuenta de buzón dentro de su instancia, no su inicio de sesión personal, salvo que su administrador los haya hecho coincidir.
3. Si se perdió la contraseña, no la adivine: su administrador de Cleo restablece la contraseña del buzón dentro de su instancia de Cleo, y usted usa entonces la nueva contraseña. No hay una página de recuperación separada para esta conexión fuera de la instancia.
4. Solo si su administrador confirma que su instancia exige una clave API para las llamadas a la API: pídale también esa clave API y guárdela junto con las credenciales del buzón. Si su instancia no la exige, no necesita nada más: no busque un Client ID ni un Client Secret, porque esta conexión no los usa.

Completar en Integration#

1. Abra Integration → Marketplace → Cleo → Nueva conexión.
2. URL base: la dirección de su instancia de Cleo, por ejemplo https://mycompany.cleointegration.com. Este campo es obligatorio. Cópiela exactamente como la usa para iniciar sesión: una dirección incorrecta significa que la prueba del paso siguiente no tendrá dónde iniciar sesión.
3. Usuario del buzón: el nombre de usuario del buzón que su administrador de Cleo emitió cuando se creó el buzón de socio. Complete la cuenta del buzón en sí, no una dirección de correo personal.
4. Contraseña del buzón: la contraseña emitida junto con ese usuario. Se cifra en reposo y nunca se muestra. Si más adelante restablece esta contraseña dentro de su instancia de Cleo, actualícela también aquí, o la conexión dejará de iniciar sesión.
5. Clave API (opcional): deje este campo vacío salvo que su instancia tenga activada la verificación por clave API para las llamadas a la API. Solo en ese caso, pegue la clave API que le dio su administrador. Dejarlo vacío es lo normal en la mayoría de las instancias: un campo vacío aquí no significa que la conexión esté incompleta.

Probar la conexión#

Haga clic en Probar la conexión. La prueba inicia sesión en la URL base con el usuario y la contraseña del buzón y los intercambia por un token de sesión. Si pasa, significa una sola cosa: la dirección de la instancia es alcanzable y esa cuenta de buzón puede iniciar sesión. La prueba no descarga ni sube ningún archivo del buzón, y no comprueba sus carpetas de descarga y subida, así que una prueba aprobada no significa por sí sola que los archivos EDI ya puedan fluir. La configuración de carpetas y socios se trata en la sección siguiente, y las preguntas frecuentes de abajo explican qué revisar si el inicio de sesión funciona pero los archivos no se mueven.

Mapping / elegir plantilla#

Cleo funciona por intercambio de archivos, así que el mapping se configura por socio comercial alrededor de las carpetas del buzón de ese socio. Para cada socio, elija la plantilla de ese socio y revise dos direcciones: los archivos entrantes extraídos de la carpeta de descarga del buzón — por ejemplo, un archivo de orden de compra (850) — deben caer como un pedido estándar con el número de pedido, las líneas, las cantidades y los datos de envío en su sitio; y los resultados salientes — el aviso de envío (856) y la factura (810) generados desde el fulfillment — deben escribirse en el formato de archivo que ese socio espera y colocarse para su subida por el buzón. Confirme también que la carpeta de descarga para archivos entrantes nuevos y la carpeta de subida para archivos salientes estén configuradas en los ajustes de conexión EDI de ese socio: esas carpetas son independientes de los cuatro campos de credenciales, y un socio al que le falten las carpetas o el mapping no tiene dónde dejar caer sus archivos, aunque la prueba pase. Revise la vista previa de mapping con un archivo real de cada socio antes de activar.

Activar#

Tras activar, Integration extrae archivos nuevos de la carpeta de descarga del buzón de socio con la frecuencia que usted defina, convierte los archivos de pedido en pedidos y sube los archivos salientes — avisos de envío y facturas — de vuelta por el buzón para entregarlos a cada socio. Solo fluirán los socios con sus carpetas y su mapping configurados; un socio que se haya saltado quedará en silencio hasta que su configuración esté terminada. Vigile los primeros archivos de cada socio en Runs / Logs antes de dejar el intercambio sin supervisión.

Preguntas frecuentes#

La prueba falla: el inicio de sesión es rechazado

El usuario o la contraseña del buzón en la conexión no coinciden con la cuenta de buzón de su instancia de Cleo, o la contraseña fue restablecida en la instancia después de que usted la completara aquí. La prueba solo llega hasta el inicio de sesión, así que un rechazo en este paso siempre tiene que ver con la dirección o con la propia cuenta del buzón, no con las carpetas ni con el mapping, a los que la prueba nunca llega.

Revise primero la URL base y asegúrese de que sea la dirección de su propia instancia, exactamente como la usa para iniciar sesión. Luego pida a su administrador de Cleo que confirme el usuario del buzón y que restablezca la contraseña del buzón dentro de la instancia si pudo haber cambiado. Pegue la contraseña actual en la conexión, guarde y pruebe de nuevo.

No encuentro ningún Client ID y el campo de clave API me confunde

No hay nada mal en su configuración de Cleo: esta conexión simplemente no tiene Client ID. Cleo usa aquí un inicio de sesión en la instancia en lugar de un par de claves API, así que nunca se emite un Client ID ni un Client Secret para ella. El campo de clave API es un extra aparte y condicional: solo aplica cuando una instancia tiene activada la verificación por clave API, lo que la mayoría no tiene.

Deje de buscar un Client ID y complete solo la dirección de la instancia y el usuario y la contraseña del buzón. Deje vacío el campo de clave API, salvo que su administrador de Cleo confirme que su instancia exige una clave API: en ese caso, pídasela y péguela. Luego pruebe la conexión.

La prueba pasa, pero no llegan archivos EDI de un socio

El inicio de sesión funciona, así que la dirección y la cuenta del buzón están bien. El hueco está después del inicio de sesión: la prueba nunca toca los archivos ni las carpetas del buzón, así que a un socio aún puede faltarle la configuración de su carpeta de descarga, de su carpeta de subida o de su mapping, y sin eso sus archivos no tienen de dónde ser recogidos y nunca se convierten en pedidos.

Pida a su administrador de Cleo que confirme que el buzón de socio está recibiendo los archivos de ese socio, luego abra los ajustes de conexión EDI de ese socio y compruebe que tanto la carpeta de descarga para archivos nuevos como la carpeta de subida para archivos salientes estén configuradas. Termine el mapping de ese socio en la sección Mapping de arriba, revíselo con un archivo real y vigile Runs / Logs para el siguiente archivo del socio.

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

La entrada funciona, así que el buzón y su lado de descarga están bien. El hueco está en el lado saliente de la configuración de ese socio: su carpeta de subida o su mapping saliente para el aviso de envío (856) y la factura (810) nunca se terminó, así que los resultados del fulfillment no tienen archivo en el que volver.

Abra los ajustes de conexión EDI y el mapping de ese socio y termine el lado saliente: la carpeta de subida, más los mappings 856 y 810 en el formato de archivo que ese socio espera. Revise la vista previa de mapping con un pedido ya fulfilled y luego vigile Runs / Logs para el siguiente archivo saliente a ese socio.