Crear una Connection: el flujo general
Los mismos cinco pasos sirven para todos los conectores: elegirlo en el Marketplace, nombrar la conexión, completar credenciales, probar, mapear y activar. Y el modo simulación para cuando aún no tiene claves.
Una Connection es un enlace configurado a un sistema externo concreto: una tienda Shopify, una cuenta UPS, una empresa ERP. Las guías por conector y el directorio dan los campos exactos de cada plataforma; este artículo es el flujo que comparten.
Antes de empezar#
- Una cuenta en la otra plataforma con acceso de administrador (o desarrollador): la mayoría de las credenciales están tras una página de admin o de desarrollador.
- La lista de campos de su conector en el directorio de conectores (tres partes, en esta sección): así sabe exactamente qué reunir.
- Para la primera conexión, prefiera las credenciales de prueba / sandbox cuando la plataforma las ofrezca; nunca practique el mapping con datos reales.
Pasos 1–2: elegir el conector y nombrar la conexión#
- Abra Integration → Marketplace de conectores, filtre por categoría y haga clic en la tarjeta de su conector → Nueva conexión.
- Ponga un nombre reconocible, p. ej. «Shopify — tienda principal US» o «UPS — cuenta de producción». Una plataforma puede tener varias conexiones (dos tiendas, prueba + producción); el nombre las distingue.
Paso 3: completar las credenciales#
- El asistente muestra exactamente los campos que necesita este conector: vienen del registro de conectores, la misma lista que el directorio. Los obligatorios están marcados; no hay campos ocultos.
- Cada campo tiene una ayuda que dice dónde vive el valor en la otra plataforma; el directorio da la ruta completa.
- Los secretos (claves, tokens, contraseñas) se cifran y nunca se muestran completos: tras guardar solo se ve una vista enmascarada. Si uno está mal, pegue uno nuevo; el anterior no se puede «ver».
- Si un conector no tiene lista de campos registrada (raro), el asistente usa un editor genérico de clave-valor más campos de secreto: escriba las claves tal como las nombra la documentación de la plataforma.
Paso 4: probar la conexión#
La prueba tiene dos niveles: conectividad (¿funcionan las credenciales?) y, en conectores de documentos, una vista previa de un documento real (campos de la plataforma → campos estándar, lado a lado). Un fallo dice en qué nivel está: 401 = credenciales; discrepancia en la vista previa = mapping. Corrija y repita; probar no cambia nada en ningún lado.
Dónde queda el registro de la prueba: el registro de diagnóstico
Cada prueba de conexión deja un registro paso a paso en la página de detalle de la conexión; en transportistas, en el diagnóstico expandible de la fila. Ábralo si una prueba falla: muestra qué paso se detuvo y por qué, en el orden de ejecución, para distinguir un problema de credenciales de uno de mapping sin adivinar. El registro solo guarda pasos y resultados, nunca sus secretos, solo qué nombres de clave se usaron. Sin pruebas previas, la sección lo dice claro: ejecute una prueba y el registro aparece aquí.
Paso 5: mapping y activación#
- Elija la plantilla de mapping predefinida de su conector y revise una vez más la vista previa del documento: SKUs, cantidades, direcciones y campos personalizados.
- Vincule sus productos: los SKUs del canal que no coinciden con un producto OMS quedan pendientes en Product Mapping; vincúlelos allí o los pedidos llegarán con líneas sin mapear.
- Active. Desde ese momento la conexión sincroniza según su programación y cada ejecución aparece en Integration → Runs y Logs. Vigile los primeros documentos antes de dejarla sola.
Gestionar conexiones después#
- Ver y editar tienen páginas propias: haga clic en una conexión en Integration → Conexiones para abrir su página de detalle: estado, ajustes de sincronización, resumen de configuración y qué Flows la usan, todo en un solo lugar. La edición (nombre, contenido, frecuencia, credenciales) se hace en la página de edición de la conexión; al guardar vuelve al detalle.
- Editar credenciales: abra la conexión y pegue el nuevo secreto, necesario tras rotar una clave o cuando caduca un token. Pruebe justo después.
- Desactive en lugar de eliminar al pausar un canal: la conexión desactivada conserva su mapping e historial y se reactiva en un clic. Eliminar pierde la configuración.
- Las conexiones duplicadas tienen sentido cuando aplica (dos tiendas de la misma plataforma, una de prueba + una de producción). Cada Flow elige la conexión exacta que usa.