Transportistas y cuentas de transportista: mantén los transportistas y las credenciales de sus cuentas

Crea un perfil por transportista y guarda debajo la cuenta de envío y las credenciales API de cada Client, para que tarifas y etiquetas usen siempre la cuenta correcta.

Docklify mantiene los transportistas en dos capas. El perfil del transportista (Master Data → Transportistas) dice quién es: nombre, SCAC, métodos de envío y servicios que admite. La cuenta de transportista (Master Data → Cuentas de transportista) dice cómo envías con él: una cuenta por Client, con el número de cuenta y las credenciales API para tarifas y etiquetas. Mantén las capas separadas: un perfil puede servir a muchos Clients, y un Client puede tener varias cuentas con el mismo transportista.

Paso 1: Crea un perfil de transportista#

1. Abre Master Data → Transportistas y haz clic en «+ Nuevo transportista».
2. En Información básica, escribe el Nombre (obligatorio) y elige un Estado: ACTIVE, INACTIVE o EXCEPTION.
3. En Contacto, completa los Métodos de envío (obligatorio, separados por comas, p. ej. "Ground, Air") y el Método predeterminado (obligatorio).
4. Añade los identificadores y datos que tengas: Servicio de entrega, SCAC, USDOT, MC Number, SCAC del socio, cobertura de códigos postales, contacto, teléfono y correo. Marca "Prohibir carga mixta" si este transportista nunca debe mezclar envíos en una carga.
5. En Gestión E-pro, elige si el transportista aplica a todos los almacenes o solo a algunos, y haz clic en Crear.

De vuelta en la lista (Master Data → Transportistas), puedes filtrar por nombre, SCAC, MC Number, USDOT y estado, ver cuántos servicios tiene cada transportista y usar Exportar para descargar la lista como CSV.

Paso 2: Añade los servicios que admite el transportista#

1. Abre el transportista desde la lista (clic en su nombre): la página de edición tiene una tarjeta aparte de «Servicios soportados» debajo del formulario.
2. Haz clic en «+ Añadir servicio» y completa una fila por servicio: el Código (p. ej. UPS_GROUND) y el Nombre (p. ej. UPS Ground) son obligatorios; el nombre en chino y los días de tránsito son opcionales.
3. Usa la casilla Activo para activar o desactivar un servicio sin borrarlo, y haz clic en «Guardar servicios». El botón ✕ elimina una fila (pide confirmación primero).

• Guarda primero el transportista y luego añade los servicios: la tarjeta de servicios pertenece a un transportista existente.
• Estos servicios son los que ofrece la estación de empaque al cotizar e imprimir etiquetas, así que escribe los códigos tal como los nombra el transportista.

Paso 3: Crea una cuenta de transportista para un Client#

1. Abre Master Data → Cuentas de transportista y haz clic en «+ Nueva cuenta».
2. En Información básica, selecciona el Transportista y el Client al que pertenece la cuenta, y escribe el Número de cuenta (los tres son obligatorios). Nombre y Compañía son etiquetas opcionales para tu referencia.
3. Marca lo que aplique: «Cuenta de devolución» para una cuenta solo de devoluciones, «House Account» para tu cuenta propia, y «Modo prueba» mientras sigues probando con el sandbox del transportista.
4. Completa la sección Dirección (líneas, ciudad, estado, código postal, país, teléfono): es la dirección vinculada a la cuenta; el Smart Post Hubid y un número de cuenta de devolución aparte también van aquí cuando el transportista los usa.
5. En Credenciales API, escribe las credenciales que el transportista emitió para esta cuenta: el API Client ID y la API Client Password son obligatorios al crear la cuenta; el API Token, la Track API Key y el Track API Secret se completan cuando el transportista los usa.
6. Haz clic en Crear. La lista muestra la cuenta bajo su Client, con su modo (Modo prueba / Producción) y estado.

Las credenciales se guardan cifradas y nunca se muestran en ninguna parte: la lista solo muestra el API Client ID, nunca una contraseña ni un secreto. Al editar una cuenta (Master Data → Cuentas de transportista → clic en el número de cuenta), un campo de contraseña ya guardado indica «Configurada (vacío = mantener)»: déjalo vacío y el valor anterior queda intacto. La misma página tiene un botón Desactivar / Activar que cambia la cuenta entre INACTIVE y ACTIVE sin borrarla.

Paso 4: Conecta las cuentas de envío en Integration#

1. Abre Integration → Carriers y haz clic en «Nueva cuenta». Elige el transportista del catálogo con el buscador: el catálogo indica el tipo de cada uno (paquetería, LTL o FTL) y cómo se conecta.
2. Escribe el número de cuenta, elige el Modo de etiqueta — «API (tarifas y etiquetas)» para cotizar e imprimir por la API del transportista, o «Sin conexión (guía manual)» para teclear los números de guía — y marca los servicios habilitados que esta cuenta puede usar.
3. Completa la sección Credenciales (los campos dependen del tipo de acceso del transportista: clave API / ID de cliente y secreto, contraseña de la cuenta o token de acceso), y marca «Marcar como predeterminado» si debe ser la cuenta elegida primero. Las credenciales guardadas no se vuelven a mostrar: deja un campo vacío para conservar el valor.
4. Guarda y usa las acciones de la fila en la lista: el interruptor Habilitado enciende o apaga la cuenta, «Probar» ejecuta una prueba de conexión y registra la hora en la columna Última prueba, y Editar / Eliminar gestionan la cuenta (al eliminarla también se borran sus credenciales guardadas).

Si un resultado lleva la insignia «Simulado», esa prueba fue simulada y no llamó de verdad al transportista: trátala como un ensayo del flujo y repite la prueba cuando las credenciales reales estén cargadas. Las cuentas de esta página de Integration son las mismas que el resto de Docklify lee al enviar, así que hay una sola lista que mantener al día, no dos.

Funciones de Docklify usadas en este artículo#

• Perfiles de transportista con filtros y exportación CSV — Master Data → Transportistas (/master-data/carriers)
• Lista de servicios soportados del transportista — Master Data → Transportistas → abrir un transportista → Servicios soportados
• Cuentas de transportista por Client, con credenciales API cifradas — Master Data → Cuentas de transportista (/master-data/carrier-accounts)
• Conexiones de transportistas de envío: catálogo, modo de etiqueta, cuenta predeterminada y prueba de conexión — Integration → Carriers (/integration/carriers)