Cómo extraer datos de flete de CT-e brasileños
a Excel

Por qué es importante la extracción de datos de CT-e para el seguimiento de costos logísticos

Una operación logística brasileña que recibe 500 documentos CT-e al mes —un volumen típico para un fabricante mediano que distribuye en las regiones Sudeste y Centro-Oeste— genera aproximadamente 7.500 puntos de datos individuales que deben llegar a un libro de costos de flete o ERP. Cada CT-e contiene el CNPJ del transportista, el valor del servicio (valor do serviço), el peso bruto (peso bruto), los municipios de origen y destino, y el desglose del ICMS (Impuesto a la Circulación de Mercaderías y Servicios), todos insumos para la asignación de costos de flete, el análisis de rendimiento del transportista y la recuperación de créditos fiscales.

En la práctica, esos 7.500 puntos de datos son ingresados manualmente por un analista de fletes que abre cada DACTE (Documento Auxiliar do Conhecimento de Transporte Eletrônico), encuentra el campo y lo escribe en una fila de la hoja de cálculo. Aproximadamente 90 segundos por documento para un mecanógrafo experimentado —escaneando la página en busca de cada campo, verificando problemas de legibilidad, alternando entre el documento y la hoja de cálculo—, 500 documentos CT-e consumen 12,5 horas de ingreso de datos al mes. Eso es antes de cualquier validación, antes de cualquier cotejo con la factura de compra correspondiente, y antes de cualquier investigación de las inevitables discrepancias entre lo que declara el XML del transportista y lo que muestra el DACTE impreso.

La infraestructura logística de Brasil maneja más de 300 millones de documentos CT-e al año, y el número sigue creciendo a medida que la SEFAZ (Hacienda Estatal) amplía los requisitos de documentación electrónica obligatoria. La automatización en el paso de extracción —convertir los datos visuales del DACTE en filas de hoja de cálculo sin escritura manual— es la diferencia entre un equipo logístico que rastrea cada costo de flete y uno que solo rastrea los que llegaron a la hoja de cálculo.

¿Qué es un CT-e y qué datos contiene?

El Conhecimento de Transporte Eletrônico (CT-e, modelo 57) es el documento electrónico de flete obligatorio en Brasil, administrado por las autoridades fiscales estatales (SEFAZ) bajo el mismo marco de autorización digital que la NF-e. Introducido en 2007 y gradualmente obligatorio para todos los transportistas de carga para 2013, el CT-e reemplazó un sistema en papel de formularios de flete con múltiples copias que hacía casi imposible auditar a gran escala el cumplimiento fiscal de los servicios de transporte.

A diferencia de un conocimiento de embarque tradicional en la mayoría de los países, el CT-e no es un documento de título: no puede ser endosado ni transferido. Como explica el bufete de derecho marítimo Proinde, funciona simultáneamente como evidencia del contrato de transporte, un recibo de entrega de la carga y una factura fiscal de servicios. El consignatario designado no entrega el documento a cambio de los bienes, porque el CT-e identifica al receptor en el momento de la emisión y no existe riesgo de entrega incorrecta.

El documento físico que viaja con el envío — y el que su equipo de logística probablemente maneja — es el DACTE (Documento Auxiliar do Conhecimento de Transporte Eletrônico). Se trata de un resumen impreso o en PDF que contiene un subconjunto de los datos XML del CT-e, una clave de acceso (Chave de Acesso) de 44 dígitos y un código QR o código de barras para autenticación en el Portal CT-e. La función del DACTE es acompañar a la mercancía para su inspección; no es un documento fiscal en sí mismo, pero es la fuente de información con la que trabaja la mayoría de los equipos de logística.

Para una comprensión más completa de cómo encaja el CT-e en el ecosistema de documentos electrónicos de Brasil — junto con la NF-e (factura de productos), la NFS-e (factura de servicios) y el MDF-e (manifiesto electrónico de documentos fiscales) — consulte la guía para principiantes de la Nota Fiscal Eletrônica (NF-e), que cubre el flujo de autorización de SEFAZ común a todos los documentos fiscales brasileños.

Campos Clave del CT-e que Todo Equipo de Logística Debe Rastrear

El DACTE contiene entre 30 y 50 puntos de datos visibles, dependiendo de la versión del diseño del transportista. Para el seguimiento de costos logísticos, los siguientes campos conforman las columnas principales de un libro de costos de flete:

Estos 14 campos representan el conjunto mínimo viable para un libro de costos de flete de CT-e. Ampliar el conjunto de columnas para incluir columna calculada — como "Costo de Flete por Kg (Valor do Serviço ÷ Peso Bruto)" — produce datos de referencia que se vuelven más valiosos con cada lote procesado.

Cómo Extraer Datos de CT-e a Excel: Paso a Paso

El siguiente flujo de trabajo convierte PDFs o imágenes de DACTE en filas estructuradas de hoja de cálculo utilizando Extracción de Columnas Personalizadas — usted define las columnas que desea, y la IA localiza cada valor en la página impresa al comprender qué significa el campo, no dónde se encuentra. Este es el mismo mecanismo descrito en la guía de extracción de NF-e a Excel, adaptado para documentos de flete CT-e.

Paso 1: Suba el DACTE en PDF o imagen

Comience con el archivo DACTE original: un PDF adjunto proporcionado por el transportista, una impresión escaneada o una fotografía del documento que acompañó al envío. La herramienta de extracción acepta PDF, JPG, PNG y WebP. Para obtener los mejores resultados, utilice un PDF limpio o un escaneo bien iluminado a 300 DPI o más. Las fotografías de documentos DACTE tomadas con poca luz o en ángulos oblicuos pueden reducir la precisión a nivel de campo, aunque el modelo de visión por IA compensa la inclinación moderada y las variaciones de iluminación que harían que una plantilla OCR tradicional fallara por completo.

Subir varios archivos DACTE en un solo lote es el flujo de trabajo práctico para cualquier equipo que procese más de un puñado de envíos por día. La interfaz de carga por lotes acepta varios archivos simultáneamente y los encola bajo el mismo nombre de lote, de modo que un analista de fletes que maneje 40 documentos CT-e pueda subirlos todos de una vez en lugar de abrir un nuevo cuadro de diálogo de carga para cada uno.

Paso 2: Defina las columnas que desea extraer

Escriba los nombres de los campos que corresponden a los datos del CT-e que necesita. Estos se convierten en los encabezados de columna de su hoja de cálculo de salida. La IA lee la página del DACTE y localiza cada valor por su significado semántico: "ICMS" se encontrará independientemente de si aparece en un cuadro lateral, una tabla de pie de página o una columna de detalle de línea, porque el modelo entiende qué es el ICMS y lo reconoce en cualquier posición del diseño.

Un conjunto típico de definiciones de columna para el seguimiento de fletes CT-e:

Estas 14 columnas capturan los puntos de datos mínimos de seguimiento de costos discutidos en la sección anterior. Puede agregar columnas calculadas directamente en el nombre de la columna — por ejemplo, Costo de flete por kg (Valor do Serviço ÷ Peso Bruto) — para que la IA calcule el costo unitario del flete durante la extracción, eliminando el paso posterior de fórmula en Excel. Esta es una de las tres modalidades de Extracción de Columnas Personalizadas descritas en la documentación del producto: extracción directa para campos que existen en el documento, columna inferida para información que debe deducirse (como la categoría de carga basada en los códigos NCM) y columna calculada para operaciones aritméticas sobre valores extraídos.

Paso 3: Procesar y exportar a Excel

Una vez definidas las columnas, la extracción procesa todos los documentos del lote y genera un único archivo Excel con una fila por CT-e. Los encabezados de la tabla de salida coinciden exactamente con sus definiciones de columna — "Valor del Servicio (Valor do Serviço)" aparece como nombre de columna, y cada fila contiene el valor extraído del DACTE correspondiente.

Los datos extraídos se pueden descargar como Excel (XLSX) o CSV. Para equipos que usan Hojas de cálculo de Google, el mismo flujo de extracción está disponible a través del complemento de Hojas de cálculo de Google, que escribe las filas directamente en la hoja activa sin necesidad de descargar e importar.

Después del primer lote, guarde las definiciones de columna como plantilla. Cada lote posterior de documentos CT-e — ya sea del mismo transportista o de uno diferente — reutiliza la misma plantilla. La IA se adapta automáticamente al diseño del DACTE de cada transportista, por lo que un CT-e de JSL y uno de Braspress, que colocan los datos del ICMS en diferentes posiciones de la tabla, son leídos por las mismas definiciones de columna. Esta es la implicación práctica de la extracción sin plantilla: no hay configuración de plantilla por transportista, ni mantenimiento cuando un transportista actualiza su diseño de DACTE.

Conciliación de costos de flete del CT-e con costos de compra de la NF-e

El CT-e coexiste con la NF-e — el primero documenta el servicio de transporte, el segundo documenta los bienes en sí. Para una visión integral del costo total de adquisición, los equipos de logística necesitan conciliar el cargo de flete de cada CT-e con el valor del producto de la NF-e correspondiente. Esta conciliación es donde los procesos manuales fallan con mayor frecuencia, porque el CT-e y la NF-e llegan por canales diferentes (el transportista envía el CT-e; el proveedor envía la NF-e) y a menudo en momentos distintos (la NF-e se emite cuando la mercancía sale; el CT-e puede emitirse después de la entrega).

En la práctica, la conciliación se realiza utilizando la clave de acceso de la NF-e que referencia el CT-e. Cada XML de CT-e contiene la clave de acceso (Chave de Acesso) de la NF-e que transporta (si se conoce al momento de la emisión). El DACTE puede mostrar esta referencia en la sección "Documentos Referenciados". Al extraer tanto la clave de acceso del CT-e como la clave de acceso de la NF-e referenciada, un analista de fletes puede combinar los dos conjuntos de datos en Excel usando BUSCARV o BUSCARX en la columna de clave de acceso — creando una sola hoja de cálculo que muestra, para cada envío, el valor de los bienes de la NF-e junto con el costo del flete del CT-e.

La clave de acceso es un número de 44 dígitos que sigue el mismo formato UF-AAAA-MMM-XXXXXXXXXXX-XX-XXXXXXXXXXXXX utilizado por los documentos NF-e. Debido a que ambos tipos de documento usan la misma estructura de clave de acceso, una extracción combinada — extrayendo la clave de acceso tanto de los DACTE de CT-e como de NF-e en el mismo formato de salida — produce un conjunto de datos que se puede combinar sin necesidad de referencias cruzadas manuales.

Para los equipos que ya extraen datos de NF-e a Excel, agregar la extracción de CT-e al mismo flujo de trabajo es cuestión de definir un segundo conjunto de columnas. Las dos hojas de cálculo de salida — una para los valores de mercancías (de NF-e) y otra para los costos de flete (de CT-e) — se convierten en insumos para un análisis trimestral de costo de importación que incluye todos los envíos, no solo aquellos que se ingresaron manualmente antes del cierre de fin de mes.

CT-e vs. MDF-e vs. DACTE: ¿Qué Documento Debe Extraer?

Brasil utiliza tres documentos electrónicos estrechamente relacionados para el transporte de carga, y cada uno tiene un propósito diferente para el seguimiento de costos:

Para el detalle del costo de flete y del ICMS por envío, el DACTE del CT-e es la fuente de extracción adecuada. El MDF-e cubre las cargas que comparten un vehículo y puede confirmar qué documentos CT-e estaban en el mismo viaje, pero las partidas de costo se encuentran en los documentos CT-e individuales.

Preguntas Frecuentes

¿Puedo extraer datos del archivo XML del CT-e en lugar del DACTE?

Sí. Si su transportista proporciona el archivo XML del CT-e (normalmente en el esquema estándar CT-e 4.0), el XML contiene todos los campos estructurados y se puede analizar mediante programación. El enfoque de extracción del DACTE descrito en este artículo está diseñado para el escenario común en el que el equipo de logística recibe un DACTE impreso o un PDF en lugar de un archivo XML. Si tiene el XML, también puede cargar una captura de pantalla o una impresión de su representación visual; la IA lo lee de la misma manera. La ventaja del análisis del XML es que no hay pérdida de precisión (los datos ya están estructurados); la desventaja es que no todos los transportistas proporcionan el XML al destinatario, y no todos los sistemas logísticos pueden consumir XML sin un proyecto de integración.

¿Puedo usar los datos extraídos del CT-e para la recuperación del crédito de ICMS en fletes de entrada?

Sí, con condiciones. El ICMS sobre fletes de entrada — el ICMS pagado por servicios de flete de materias primas o bienes destinados a la reventa — puede ser acreditable bajo el régimen de ICMS no acumulativo de Brasil. El monto de ICMS extraído (vICMS) del CT-e proporciona la base para este cálculo. Sin embargo, la acreditabilidad depende del régimen fiscal de la empresa receptora (Lucro Real vs. Lucro Presumido), el código CFOP de la transacción y la naturaleza de los bienes. La extracción le proporciona los valores de ICMS; su equipo fiscal determina cuáles son recuperables. Un caso de uso común es extraer tanto el ICMS del CT-e como el ICMS de la NF-e en el mismo libro de costos, y luego aplicar diferentes porcentajes de recuperación por código CFOP en Excel.

¿Necesito una plantilla de extracción diferente para el diseño del DACTE de cada transportista?

No. La IA lee por significado semántico, no por posición en el diseño. Un CT-e de JSL coloca el CNPJ del transportista en un bloque diferente al de uno de Rodonaves, pero como el modelo entiende lo que significa "CNPJ do Emitente" en el contexto de un documento de flete, encuentra el valor correcto independientemente de la posición. Esta es la diferencia fundamental entre la extracción sin plantilla y el OCR basado en plantillas: usted define un conjunto de columnas para los documentos CT-e, y la misma definición funciona en cualquier diseño de DACTE de cualquier transportista.

¿Qué sucede si mi DACTE tiene anotaciones o correcciones manuscritas?

El modelo de visión de IA lee la escritura a mano de la misma manera que lee la impresa: comprendiendo el contenido visual de forma contextual, no comparando formas de caracteres. Las anotaciones manuscritas en un DACTE (como una dirección de entrega corregida, un peso modificado o una firma) se extraen junto con los datos impresos. La precisión en la escritura a mano depende de la legibilidad: las notas en mayúsculas de imprenta con bolígrafo sobre un fondo limpio se extraen de forma fiable; las anotaciones borrosas a lápiz sobre texto impreso pueden ser menos precisas. El enfoque práctico es utilizar los campos impresos extraídos como fuente de datos principal y tratar las anotaciones manuscritas como información complementaria que debe verificarse con el XML oficial del transportista.

¿Cuántos documentos CT-e puedo procesar en un solo lote?

No hay un límite por lote en la cantidad de archivos. La limitación práctica es el tamaño de carga y la asignación total de páginas del plan. Un DACTE de CT-e individual suele tener de 1 a 2 páginas. Un equipo que procesa 500 documentos CT-e por mes en el plan Pro (1500 páginas/mes) tiene capacidad restante para otros tipos de documentos. La salida del lote combina todos los documentos procesados en un solo archivo de Excel — una fila por CT-e — por lo que escalar de 50 a 500 documentos por lote cambia el tiempo total de procesamiento, pero no los pasos del flujo de trabajo.

¿Cómo emparejo los costos de flete del CT-e con los valores de compra de la NF-e correspondiente?

Utilice la clave de acceso de la NF-e referenciada en el CT-e. La mayoría de los documentos CT-e listan la clave de acceso (Chave de Acesso) de la NF-e que transportan en una sección de "documentos referenciados". Extraiga la clave de acceso referenciada de cada CT-e y la clave de acceso de cada NF-e como columnas separadas en su salida de extracción. Luego, realice una BUSCARX (Excel) o BUSCARV entre las dos hojas de cálculo usando la clave de acceso como identificador común. Esto produce una vista combinada que muestra tanto el valor de los bienes (de la NF-e) como el costo del flete (del CT-e) para cada envío — que es su costo total de importación por unidad.

¿Puedo usar nombres de columna en inglés para extraer datos de documentos DACTE en portugués?

Sí. Puede definir los nombres de sus columnas en inglés — "Carrier CNPJ", "Service Value", "Gross Weight (kg)" — y la IA encontrará los valores correspondientes en portugués en el DACTE. El modelo de extracción comprende documentos multilingües y asigna la semántica de las columnas al idioma del contenido del documento. Los encabezados de la hoja de cálculo de salida estarán en inglés (sus nombres de columna), mientras que los valores extraídos se mantendrán en su formato original del documento. Esto es particularmente útil para equipos logísticos internacionales donde el libro de costos se mantiene en inglés, pero los documentos fuente están en portugués.