Integración · Logística y envíos

TCC + agentes de IA de Meteor

Conecta TCC con un agente de IA de Meteor: cotiza envíos, rastrea guías y explica novedades por WhatsApp. Solo lectura, con 13 herramientas reales.

Quiero una demostración Ver todas las integraciones

¿Cómo se conecta TCC con Meteor?

Meteor se conecta con la transportadora colombiana TCC para que tu agente de IA cotice un envío con tarifa real, rastree una o varias guías, explique qué significa una novedad y a quién es atribuible, y confirme si TCC llega a una población y si esa población admite pago contra entrega. Son 13 herramientas de solo lectura: el conector no graba despachos, no pide recogidas y no anula guías.

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.

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 el agente responde con la trazabilidad, el estado traducido a lenguaje humano y la fecha de entrega prometida, sin que nadie abra el portal.

Cotizar el envío antes de cerrar la venta

El agente 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, el agente 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, el agente verifica si esa población lo admite. Es la promesa que más se rompe cuando se hace de memoria.

13 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_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_rastrear_envio`	Rastrea una guía con su trazabilidad, su novedad y los datos de entrega.
`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_informacion_remesas`	Trazabilidad ligera de muchas guías a la vez, cuando solo hace falta el estado.
`tcc_consultar_novedad`	Explica una novedad y dice si es atribuible a la transportadora, al cliente o a un tercero.
`tcc_consultar_estado`	Traduce un código de estado a su significado y marca los estados críticos.
`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 y con qué condiciones.
`tcc_ciudades_con_fce`	Lista las poblaciones que admiten flete contra entrega con recaudo.
`tcc_validar_direccion`	Normaliza una dirección colombiana para despacho, expandiendo las abreviaturas de vía.
`tcc_consultar_conexion`	Verifica que el token esté configurado y reporta el ambiente y la cuenta comercial activos.

Los límites

Qué NO hace la integración con TCC

Preferimos decirlo aquí que descubrirlo en la implementación.

No genera guías ni graba despachos. No solicita recogidas y no anula guías: la integración es de solo lectura.
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.

Preguntas frecuentes

Preguntas sobre TCC y Meteor

Todavía no. Esta integración cotiza, rastrea y explica estados y novedades, pero no escribe en la transportadora: no graba despachos, no pide recogidas y no anula guías.

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 rastreo en lote con el detalle completo, y una trazabilidad ligera pensada para cuando solo necesitas el estado de muchas guías de un vistazo.

Paso a paso