Gestión EDI: conexiones EDI y configuración de socios

Conecta un minorista mediante una plataforma EDI con un solo asistente, mapea sus documentos sin código y sigue cada transmisión en lenguaje claro.

La gestión EDI está en Integration → EDI y tiene cuatro páginas que trabajan juntas: Conexiones (una fila por minorista + cuenta de plataforma), Mappings (cómo se traduce cada tipo de documento), Tablas de códigos (las listas de consulta que usan los mappings) y Transmisiones (cada documento enviado o recibido). Todas las plataformas usan el mismo asistente, la misma vista de detalle, la misma herramienta de mapping y el mismo formato de error en lenguaje claro. Los tipos de documento que puedes activar incluyen 850 Orden de compra, 855 Confirmación, 856 ASN, 940 / 945 documentos de envío de almacén, 846 Aviso de inventario, 947 Ajuste de inventario, 943 / 944 transferencias de stock, 810 Factura, 210 Factura de flete, 204 Licitación de carga y 214 Estado de envío.

Paso 1: Abre el asistente de conexión y elige la plataforma#

1. Abre Integration → EDI → Conexiones (/integration/edi/connections) y pulsa «+ Nueva conexión». Se abre el mismo asistente de cinco pasos para todas las plataformas: 1 Plataforma → 2 Credenciales → 3 Probar conexión → 4 Mapping / plantilla → 5 Vista previa.
2. Elige la plataforma EDI (conector) y completa el nombre de la conexión y el código del minorista, por ejemplo WALMART. Escríbelo directamente: los mismos códigos se usan en todo Docklify.
3. Marca los tipos de documento que usará esta conexión. Entrante significa minorista → Docklify; saliente, Docklify → minorista. Cada tipo activado debería tener un mapping en el paso 4.
4. Deja el Modo de prueba y el Modo de ejemplo activados mientras configuras: así la conexión se puede crear, probar y previsualizar con documentos de ejemplo antes de que fluyan documentos reales.

Paso 2: Ingresa las credenciales y define las alertas de fallo#

• El formulario de credenciales se genera desde la lista de campos de la propia plataforma: solo ves los campos que esa plataforma necesita. Los campos secretos son contraseñas y nunca se vuelven a mostrar.
• Las alertas de fallo se definen en el mismo paso: alertar tras N fallos consecutivos (por defecto 3) y pausa automática tras N fallos consecutivos (por defecto 10), para que una conexión rota deje de golpear la plataforma en lugar de fallar para siempre.
• Notificaciones: la notificación en la app está activada por defecto; la de correo, desactivada. Activa el correo si el equipo que vigila a este minorista no está todo el día en Docklify.

Paso 3: Prueba la conexión#

1. Pulsa «Crear y probar conexión». Docklify crea la conexión y ejecuta la prueba de inmediato: verás «Prueba de conexión exitosa» con su latencia, o un fallo en lenguaje claro — qué pasó y qué hacer después, nunca un stack trace.
2. Cuando la prueba obtiene un documento de ejemplo, se muestra en el asistente y se ejecuta una verificación de mapping. Si la verificación lista problemas, corrígelos en el paso 4 / la herramienta de Mapping y vuelve a probar antes de activar la conexión.

Paso 4: Asigna un mapping o clona una plantilla#

• Para cada tipo activado, asigna un mapping existente o clona una plantilla de la biblioteca. Al pulsar Finalizar, la plantilla clonada se convierte en un mapping real de esta conexión.
• También puedes dejar un tipo «sin mapping aún» y finalizar — pero las transmisiones de ese tipo fallarán hasta que asignes un mapping en Integration → EDI → Mappings, así que hazlo antes de que lleguen documentos reales.

Paso 5: Ejecuta una vista previa con un ejemplo y finaliza#

1. Elige el tipo de documento a previsualizar y pega un documento de ejemplo (JSON) en el cuadro de ejemplo.
2. Pulsa «Ejecutar vista previa». Cada campo mapeado vuelve con su destino, el valor origen, la cadena de funciones aplicada, el valor de salida y, si algo falla, el motivo en lenguaje claro.
3. Cuando todos los campos pasan, pulsa Finalizar. Si un campo falla, corrige el mapping en la herramienta de Mapping y vuelve a ejecutar: no finalices con una vista previa fallida esperando que salga bien.

Día a día: gestiona las conexiones desde la lista y el detalle#

• La lista muestra, por conexión: plataforma, minorista, tipos activos, modo (con marcas de Prueba / Ejemplo cuando están activos) y estado. Las acciones de fila son Probar, Detalles y Eliminar: eliminar una conexión también borra sus credenciales.
• El interruptor de una conexión la pausa o reanuda sin borrar nada: úsalo cuando un minorista pida dejar de enviar por un tiempo.
• Detalles abre el panel de la conexión: Salud (últimas 24 h) con tasa de éxito y fallos consecutivos — Saludable, Degradado (se alcanzó el umbral de alerta) o Pausado — más la configuración de alerta / pausa, la última prueba y las transmisiones recientes con botones Reintentar y Reproducir.

Mappings: traduce documentos sin escribir código#

1. Abre Integration → EDI → Mappings (/integration/edi/mappings). Empieza con «+ Nuevo mapping» o abre la pestaña Biblioteca de plantillas y clona una que ya encaje con tu plataforma y tipo de documento.
2. En el editor, nombra el mapping, elige el tipo de documento y la dirección, y construye filas: haz clic o arrastra un campo origen a una fila, define el campo destino (Canonical) y encadena funciones — o usa una constante, una búsqueda en tabla de códigos y una condición opcional — hasta que la fila produzca el valor correcto.
3. Prueba con un ejemplo en el editor y luego Activa. La activación se bloquea mientras falten campos obligatorios sin mapear: el editor lista exactamente cuáles faltan.
4. Cada guardado crea una versión nueva. Versiones abre el historial: compara dos versiones lado a lado (filas añadidas / eliminadas / modificadas) o revierte — revertir abre esa versión en el editor y la pruebas antes de activar, como cualquier cambio.

Tablas de códigos: las listas que usan los mappings#

• Abre Integration → EDI → Tablas de códigos (/integration/edi/code-tables) y pulsa «+ Nueva tabla». Nómbrala en minúsculas_con_guiones — por ejemplo upc_to_sku, uom_map o carrier_map — y dale una etiqueta clara.
• Edita las entradas como pares simples: Desde (el valor que envía el minorista) → A (el valor que usa Docklify), más una nota opcional. Las tablas típicas traducen códigos ship-to del minorista, unidades de medida y códigos de transportista: las mantiene el equipo de operaciones aquí, sin código.
• Los valores Desde duplicados se resaltan en rojo: corrígelos antes de guardar, porque un Desde solo puede apuntar a un A. Para listas largas, usa Importar CSV (pega filas desde,a,nota, una por línea; los duplicados se omiten) y Exportar CSV para descargar la tabla.
• Guardar una tabla crea una versión nueva. Los mappings referencian la tabla junto con su versión, así que editar una tabla aquí no cambia en silencio los mappings ya activos.

Transmisiones: sigue cada documento y corrige lo que falló#

• Abre Integration → EDI → Transmisiones (/integration/edi/transmissions). Filtra por estado, tipo de documento o dirección, o busca por número de negocio / id externo. Los estados se leen claros: Recibido, Mapeado, Completado, Fallido, Duplicado, Muerto y ACK pendiente.
• Abre los Detalles de una transmisión para ver el documento original tal como llegó y su forma Canónica tras el mapping, junto con su estado y ACK: ese par es lo primero que se revisa cuando un socio dice que un documento «se ve mal».
• Los errores están escritos para personas: un título, qué pasó y qué hacer después. Si el error se puede reintentar, la fila muestra la marca «Reintentable» y el botón Reintentar. Los errores que reintentar no arregla — fallos de autenticación, errores de mapping — no muestran botón: corrige primero las credenciales o el mapping y luego usa Reproducir para volver a ejecutar el documento original (disponible para transmisiones Fallidas y Muertas).

Funciones de Docklify usadas en este artículo#

• Asistente EDI de cinco pasos: plataforma, credenciales, prueba, mapping / plantilla, vista previa — Integration → EDI → Conexiones → + Nueva conexión (/integration/edi/connections)
• Detalle de conexión: salud de 24 h, fallos consecutivos, configuración de alerta / pausa y transmisiones recientes — Integration → EDI → Conexiones → Detalles
• Editor de mapping sin código con biblioteca de plantillas, prueba con ejemplo, historial de versiones, comparación y reversión — Integration → EDI → Mappings (/integration/edi/mappings)
• Tablas de códigos con versiones, control de duplicados e importación / exportación CSV — Integration → EDI → Tablas de códigos (/integration/edi/code-tables)
• Registro de transmisiones con errores en lenguaje claro, reintento y reproducción — Integration → EDI → Transmisiones (/integration/edi/transmissions)