Transportadoras por API

Cuatro transportadoras se conectan por API: KhlothiaPack, Gintracom, TokTok y Mail Americas. Con la conexión hecha, cada guía que creas sale sola a la transportadora y los cambios de estado llegan solos.

Dónde está

Administración › Transportadoras. La conexión vive en la ficha de cada transportadora: el botón «Configurar» aparece sólo cuando la transportadora habla por API.

Qué cambia frente a una transportadora sin API

	Sin API	Por API
La guía	La creas en el ERP y la haces llegar a la transportadora (por una hoja de Google o a mano)	Se crea sola en la transportadora al crearla en el ERP
El número de la guía	GU-2026-0001, el del ERP	El que da la transportadora, y debajo el número de la orden
Los estados	Los cambias tú desde Logística › Guías o desde Despachos	Llegan solos. El desplegable de estado no se ofrece
Despachos	«Entregado» pasa las guías en Creada a En tránsito	Las guías de API no cambian: la transportadora informa cuando las recoge
La etiqueta	La de Fulfillo, con «Etiquetas PDF»	La de la transportadora, que se imprime desde el mismo botón
Anular	Sólo en el ERP	También en la transportadora, si todavía no recogió el paquete

La confirmación de Despachos lo dice antes de mover nada: «N guías por API no cambian: su estado lo informa la transportadora cuando las recoja.»

Paso a paso

1. En Administración › Transportadoras, edita la ficha de la transportadora y en «Integración» elige «KhlothiaPack (API)», «Gintracom (API)», «TokTok (API)» o «Mail Americas (API)». La ficha pasa a vinculada y ya no se edita ni se borra desde la lista.
2. Pulsa «Configurar» en la ficha.
3. Elige la «Transportadora» y la «Marca». Si todas tus marcas despachan con la misma cuenta, deja «Todas las marcas».
4. Conecta según la transportadora (ver abajo).
5. Si esa transportadora tenía una hoja de Google, pausa la hoja. Con las dos vías vivas, cada envío saldría dos veces. En el diálogo de KhlothiaPack hay un botón «Pausar la hoja»; para las demás, pausa la hoja desde el diálogo de Google Sheets (Google Sheets para tus guías).

Cómo se conecta cada una

Transportadora	Cómo se conecta	Qué más pide
KhlothiaPack	Pega la «Credencial» que te da KhlothiaPack (empieza por kp_test_ o kp_live_) y pulsa «Conectar», o «Conectar con KhlothiaPack» para autorizar desde su pantalla	La «Modalidad de despacho» (Logística 180, Logística 360, Tercerizada o Propia). Después, en la pestaña «Catálogo», emparejas tus productos con los de su catálogo
Gintracom	«Conectar con Gintracom»: entras con tu usuario de Gintracom y pulsas «Autorizar»	«Bodega de recogida», «Peso por paquete (kg)» y si «El cliente puede abrir el paquete». Se guardan con «Guardar ajustes»
TokTok	«Conectar con TokTok»: entras con la cuenta de tu tienda y pulsas «Autorizar»	Nada más: recoge en la tienda que tienes registrada en TokTok
Mail Americas	Pega el access token en «Credencial (access token)» y pulsa «Validar y conectar»	«Ambiente» (Prueba o Producción), «Código de servicio», «Bodega de recogida», «Peso por paquete (kg)» y «Valor declarado (US$)»

Una credencial de prueba de KhlothiaPack valida los datos pero no crea pedidos reales. El ambiente de prueba de Mail Americas no despacha: para enviar de verdad hace falta Producción.

Con Gintracom conectada, cada guía sale sola a Gintracom y sus estados llegan solos, como con las demás.

Qué pasa después

Al crear una guía de esa transportadora, el ERP la manda en pocos minutos. Cuando la transportadora la crea, la guía toma su número y, en el detalle de la guía, la pestaña «Historial» muestra cada paso que la transportadora informa: recogida, en ruta, novedad, entregada.

Con TokTok, cada guía recibe su etiqueta: hay que imprimirla y pegarla en el paquete para que lo recojan. Si TokTok necesita tu decisión en una novedad, los botones aparecen encima del Historial de la guía.

Si el envío a la transportadora falló, en Logística › Guías aparece un icono en Acciones: «Reintentar el envío a …». La confirmación muestra el motivo del fallo anterior. Si el motivo es un dato de la guía, corrígelo antes con «Modificar». Con Gintracom, cuando el envío salió pero no consta si Gintracom creó la guía, el icono es «Confirmar el envío» y abre «¿Gintracom creó esta guía?»: miras tu panel de Gintracom y, si está, escribes su número; si no está, la guía vuelve a la cola y se manda en el momento.

Preguntas frecuentes

¿Las guías de antes de conectar se actualizan solas? No. La transportadora sólo informa de los envíos que Fulfillo creó por su API. Las guías que salieron por la hoja o a mano siguen cambiando de estado a mano.

La credencial dice «Hay que reconectar». ¿Qué pasó? La transportadora rechazó el acceso. Pulsa «Volver a conectar» o pega la credencial de nuevo. Mientras tanto no sale ningún despacho.

¿Puedo tener una credencial por marca? Sí. KhlothiaPack da una credencial por marca; en las demás, eliges la marca al conectar.