Integración · Operar tienda y pedidos
TCC + agentes de IA de Meteor
Haz tracking y cotiza TCC por WhatsApp con tu tarifa. Hay 23 herramientas: 18 consultas operan en canales y la guía se genera sólo desde administración.
¿Cómo hacer tracking de TCC y cotizar envíos por WhatsApp?
Con TCC y Meteor, tu Met cotiza con la tarifa real, hace tracking de una o varias guías, explica estados y novedades, y verifica cobertura y pago contra entrega. El conector expone 23 herramientas: 18 consultas están disponibles desde WhatsApp y otros canales. La operación tcc_generar_guia graba el despacho y genera la guía únicamente desde una superficie administrativa autorizada, en el ambiente configurado, con confirmación humana y una idempotencyKey obligatoria para auditoría. Generar el rótulo, solicitar la recogida y anular el despacho siguen bloqueados en modo fail-closed hasta validar sus contratos productivos.
Dónde aplica: Colombia. El conector trae el maestro local de ciudades colombianas con su código DANE, para desambiguar homónimos antes de cotizar, y marca cuáles son de reexpedición y cuáles admiten recaudo.
Qué automatiza
Lo que un agente de Meteor hace con TCC
"¿Dónde va mi pedido?" contestado en segundos
El cliente escribe su número de guía y tu Met responde con la trazabilidad, el estado traducido a lenguaje humano y la fecha de entrega prometida, sin que nadie entre al portal a hacer el tracking a mano.
Cotizar el envío antes de cerrar la venta
Tu Met resuelve el código de la ciudad de destino, cotiza con tu acuerdo comercial y responde el valor real del envío, con el peso facturado que aplicó la transportadora.
Explicar una novedad en vez de repetirla
Cuando el envío tiene novedad, tu Met dice a quién es atribuible y qué acción sigue. No es lo mismo pedirle la dirección al cliente que disculparse y escalar internamente.
Ofrecer contra entrega solo donde existe
Antes de prometer pago contra entrega, tu Met verifica si esa población lo admite. Es la promesa que más se rompe cuando se hace de memoria.
Distinguir «va en camino» de «no va a llegar»
El conector trae el catálogo completo de estados de TCC, con las dos numeraciones que la transportadora mezcla en una misma respuesta, y marca los cinco que significan que el envío no llega sin que alguien intervenga: indemnización, retención de la DIAN, devolución, guía reemplazada y anulación. Entrega parcial también queda separada de entrega, que es la confusión que más caro sale.
Avisar de la reexpedición antes de prometer la fecha
Hay poblaciones que TCC atiende por reexpedición: suman costo y días. La consulta de cobertura lo dice antes de cotizar, junto con si el código de la población sigue vigente, porque uno derogado no se despacha aunque el nombre exista.
Generar la guía sólo desde administración
Una persona revisa la prevalidación y la cotización en una superficie administrativa, carga el payload nativo de TCC y confirma la operación. Sólo entonces tcc_generar_guia graba el despacho en el ambiente configurado. La idempotencyKey identifica la operación, pero el conector no deduplica reintentos: la superficie administrativa debe impedir que se reenvíe el mismo despacho. Un mensaje de WhatsApp nunca ejecuta esta escritura.
23 herramientas
Todo lo que el agente puede pedirle a TCC
Cada una es una acción real del conector. Puedes desactivar las que no quieras que use.
| Herramienta | Qué hace |
|---|---|
tcc_consultar_conexion | Verifica que el token esté configurado y reporta el ambiente y la cuenta comercial activos. |
tcc_probar_conexion | Diagnostica token, ambiente, acuerdo comercial, ciudad de origen y preparación operativa sin ejecutar un despacho. |
tcc_cotizar_envio | Cotización real de un envío, con conceptos discriminados, peso facturado y días de promesa. |
tcc_consultar_tarifas | Devuelve la tabla de tarifas de referencia para un par origen-destino. No es un cotizador. |
tcc_prevalidar_despacho | Revisa origen, cobertura, dirección, peso, unidades, valor declarado y acuerdo antes de generar una guía; no escribe ni cotiza. |
tcc_rastrear_envio | Rastrea una guía con su trazabilidad, su novedad y los datos de entrega. |
tcc_consultar_remesa | Consulta una remesa con los endpoints seguros disponibles y devuelve estado, origen, destino y unidades sin exponer datos personales. |
tcc_diagnosticar_consulta_remesa | Prueba variantes seguras del contrato de consulta de remesas; es un diagnóstico administrativo y no está disponible en canales. |
tcc_consultar_prueba_entrega | Consulta el soporte de entrega cuando TCC lo expone y devuelve datos recortados y enlaces, nunca la imagen en base64. |
tcc_rastrear_multiples | Rastrea varias guías en un solo llamado, sin repetir la consulta en bucle. |
tcc_consultar_envio | Ficha completa del envío: pesos, flete, recaudo, fecha de promesa y partes. |
tcc_generar_guia | Graba el despacho en TCC y genera la guía desde una superficie administrativa autorizada; exige confirmación humana e idempotencyKey, y usa las credenciales del ambiente configurado. |
tcc_generar_rotulo | Contrato protegido para generar o recuperar el rótulo; falla cerrado hasta validar el endpoint productivo de TCC. |
tcc_solicitar_recogida | Contrato protegido para pedir la recogida de guías; falla cerrado hasta validar el endpoint productivo de TCC. |
tcc_anular_despacho | Contrato protegido para anular un despacho con motivo auditable; falla cerrado hasta validar el endpoint productivo de TCC. |
tcc_buscar_ciudad | Busca una ciudad en el maestro local y devuelve su código DANE, desambiguando homónimos. |
tcc_consultar_cobertura | Dice si TCC llega a una población, si su código sigue vigente, si es de reexpedición (suma costo y tiempo) y si admite pago contra entrega. |
tcc_validar_direccion | Normaliza una dirección colombiana para despacho, expandiendo las abreviaturas de vía. |
tcc_consultar_novedad | Explica una novedad y dice si es atribuible a la transportadora, al cliente o a un tercero. |
tcc_informacion_remesas | Trazabilidad ligera de muchas guías a la vez, cuando solo hace falta el estado. |
tcc_consultar_estado | Traduce los 32 códigos de estado de TCC, que llegan en dos numeraciones distintas, y marca los críticos: indemnización, retención de la DIAN, devolución, guía reemplazada y anulación. |
tcc_normalizar_estado_envio | Convierte un código o texto de TCC a un estado operativo como en tránsito, entregado, novedad, devolución, anulado o desconocido. |
tcc_ciudades_con_fce | Lista las poblaciones que admiten flete contra entrega con recaudo. |
Los límites
Qué NO hace la integración con TCC
Preferimos decirlo aquí que descubrirlo en la implementación.
-
No genera guías desde WhatsApp ni desde otros canales. tcc_generar_guia sólo graba el despacho desde una superficie administrativa autorizada, en el ambiente configurado, con confirmación humana e idempotencyKey. Esa clave es obligatoria, pero el conector todavía no deduplica reintentos.
-
No ejecuta tcc_generar_rotulo, tcc_solicitar_recogida ni tcc_anular_despacho. Esos tres contratos permanecen protegidos y fallan de forma cerrada hasta validar los endpoints productivos de TCC.
-
No calcula el precio ni el peso facturado por su cuenta. Devuelve lo que responde la transportadora, tal cual, porque un flete calculado localmente es un flete inventado.
-
No valida direcciones contra un catálogo oficial. La transportadora no expone esa validación por API; el conector solo estandariza el texto de la dirección.
-
No trae la imagen del comprobante de entrega. Devuelve el enlace, nunca el archivo embebido.
Antes de empezar
Qué necesitas para conectar TCC
- 1
Token de acceso de la API de TCC
Lo entrega TCC. El token de pruebas y el de producción son distintos, y el ambiente se declara al configurar la integración.
- 2
Número de acuerdo comercial
Es el número de tu contrato con TCC. Es obligatorio para cotizar, porque la tarifa depende del acuerdo, no de una lista pública.
- 3
Ciudad de origen y unidad de negocio (opcionales)
Se configuran una vez con el código de la ciudad de despacho habitual y con la modalidad (paquetería o mensajería), para no repetirlos en cada consulta.
- 4
Credenciales del ambiente y payload de TCC, si vas a generar una guía
Se cargan en la superficie administrativa autorizada junto con el payload nativo de grabardespacho8. La operación exige además confirmación humana e idempotencyKey. Si se va a despachar de verdad, el ambiente configurado debe ser producción; en pruebas puede usarse el ambiente de test.
Preguntas frecuentes
Preguntas sobre TCC y Meteor
Sí, pero no desde WhatsApp ni desde otro canal. tcc_generar_guia graba el despacho únicamente desde una superficie administrativa autorizada, en el ambiente configurado, con confirmación humana e idempotencyKey. La clave identifica la operación, pero no deduplica reintentos; generar el rótulo, pedir la recogida y anular siguen bloqueados.
Es la real: se pide contra tu acuerdo comercial y se devuelve con los conceptos discriminados y el peso facturado que aplicó la transportadora. La tabla de tarifas por par origen-destino existe aparte y es solo de referencia.
Con el maestro local de ciudades y su código DANE. Hay tres poblaciones llamadas Rionegro en Colombia; el conector obliga a desambiguar y nunca escoge por su cuenta.
Sí, y de dos maneras: un tracking en lote con el detalle completo, y una trazabilidad ligera pensada para cuando solo necesitas el estado de muchas guías de un vistazo.
Están contemplados. El conector trae los 32 códigos de estado de TCC y los traduce a un lenguaje que se puede decir en voz alta, sin confundir entrega parcial con entrega. Cinco de ellos quedan marcados como críticos porque significan que el envío no llega sin que alguien intervenga, y ahí tu Met no dice «va en camino».
Porque TCC maneja dos numeraciones y las mezcla en una misma respuesta, y además devuelve códigos que no están en ninguno de los dos catálogos. El conector resuelve primero por una numeración, luego por la otra y, si ninguna da, por el texto. Nunca se queda con el código crudo.
Paso a paso
Automatizaciones que usan TCC
Tareas completas, con los pasos y las herramientas que se ejecutan en cada uno.
Operar tienda y pedidos
Otras integraciones de la misma familia
¿Quieres ver a un agente operando TCC?
Te lo mostramos con tu propia cuenta conectada, no con una demostración enlatada.