Integración · Operar tienda y pedidos

TCC + agentes de IA de Meteor

Conecta TCC con un agente de IA de Meteor: cotiza envíos en Colombia, rastrea guías y traduce estados y novedades por WhatsApp. 13 herramientas, solo lectura.

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, le haga tracking a una guía o a varias a la vez, traduzca los 32 códigos de estado de la transportadora (entrega parcial y devolución separadas de entrega, los críticos marcados), explique qué significa una novedad y a quién es atribuible, y confirme si TCC llega a una población, si es de reexpedición y si 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, 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 el agente 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

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.

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.

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 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_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_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 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í el agente 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