CIOT — Código Identificador da Operação de Transporte¶
Resumo¶
Quantidade mensal de Códigos Identificadores da Operação de Transporte (CIOT) emitidos para o transporte rodoviário de cargas, agregada por origem, destino e natureza da carga, publicada pela ANTT (Superintendência de Cargas). Serve para mapear fluxos de carga entre municípios.
Ficha técnica¶
| Campo | Valor |
|---|---|
| Dataset | antt/ciot |
| Órgão | Agência Nacional de Transportes Terrestres (ANTT) |
| Página oficial | https://dados.antt.gov.br/dataset/ciot |
| Licença | Creative Commons Attribution (CC BY), conforme o conjunto no portal de dados abertos da ANTT: http://www.opendefinition.org/licenses/cc-by. Nenhuma restrição de uso ou redistribuição foi encontrada além da atribuição; o portal fica atrás de um firewall que rejeita acessos automatizados em excesso (respostas "Request Rejected"), o que limita a coleta. |
| Periodicidade | mensal segundo o portal |
| Cobertura | 2020 a em-curso |
| Unidade (uma linha) | os CIOTs de um mês para um par origem e destino e uma natureza de carga |
| Granularidade | espacial: par município de origem e município de destino; temporal: mês (um arquivo por mês) |
| Formato bruto | CSV (cada recurso do pacote é um arquivo), Windows-1252 na maior parte (alguns UTF-8), separador ponto e vírgula, texto entre aspas só em parte dos arquivos |
| Estado no lake | convertido |
| Partições | ano |
| Chave | — |
| Colunas | 8 |
| Unidades de medida | quantidade_ciots: CIOTs; quantidade_trc: transportadores; quantidade_contratantes: contratantes |
| Dados pessoais | nenhum |
| Eras | nenhuma |
| Revisado em | 2026-11-10 |
| Versão do fetcher | 0.3.2 |
Origem e coleta¶
- O fetcher baixa os CSV do pacote
ciot(https://dados.antt.gov.br/dataset/ciot): um recurso por mês desde janeiro de 2020 (81 CSV, mais 79 JSON que o conversor não lê). - No bruto:
ciot_<mês><ano>---ciots-<id>@AAAAMMDD.csv; os arquivos antigos têm o nome nu[email protected]. - O pacote tem um recurso por mês, de 01/2020 a 09/2026 (81 meses), cada um com uma URL diferente. O conversor lê um arquivo vigente por mês.
Conteúdo¶
- Unidade de análise: a agregação mensal por município de origem, município de destino e NCM. Chave não verificada.
- Cobertura anunciada pela fonte: mensal. O que o lake pode ter: um Parquet por mês, de 01/2020 a 09/2026 (veja os cuidados de uso).
- Layout: 8 colunas, igual em todos os meses (cabeçalho conferido em todos os arquivos; os 4 arquivos de amostra, de janeiro a maio de 2020, foram abertos inteiros).
- Nulos (amostra de 525.037 linhas de 4 arquivos): nenhum.
ncm_cargatem 1.107 valores distintos, de00.01a97.06.
Variáveis¶
Descrições do dicionário de dados da ANTT ("Dicionário de Dados - Ciot"). Todos os valores chegam ao lake como texto. A coluna de partição ano não está nos arquivos.
| Coluna no lake | Na fonte | Tipo | Descrição | Unidade / códigos | Período |
|---|---|---|---|---|---|
municipio_origem |
municipio_origem |
texto | Nome do município de origem | — | todo |
uf_origem |
uf_origem |
texto | UF do município de origem | sigla de 2 letras | todo |
municipio_destino |
municipio_destino |
texto | Nome do município de destino | — | todo |
uf_destino |
uf_destino |
texto | UF do município de destino | sigla de 2 letras | todo |
ncm_carga |
ncm_carga |
texto | Quatro primeiros dígitos da natureza da carga, conforme a Nomenclatura Comum do Mercosul (NCM) | 4 dígitos; nos arquivos conferidos vem como 72.04 (com ponto) |
todo |
quantidade_ciots |
quantidade_ciots |
texto | Quantidade de CIOTs emitidos no período | CIOTs | todo |
quantidade_trc |
quantidade_trc |
texto | Quantidade de transportadores distintos contratados no período | transportadores | todo |
quantidade_contratantes |
quantidade_contratantes |
texto | Quantidade de contratantes distintos no período | contratantes | todo |
No lake¶
- Dataset
antt/ciot, particionado porano, um Parquet por arquivo (um por mês). O nome do Parquet éciot_<id8>.parquet, em que<id8>são os 8 primeiros caracteres do id do recurso na URL do manifesto (a chave vem do recurso, não do nome do arquivo). É um dataset de fotografia (SNAPSHOT_DATASETS): oanovem do período no nome do arquivo ou da URL do manifesto (01_2020_ciots.csvdá 2020), sem coluna de data; sem período no nome e sem manifesto a conversão falha. - Todas as colunas são texto.
- Esquema de referência (
ciot.schema.json): 8 colunas, gerado de 4 arquivos de amostra (janeiro a maio de 2020); o cabeçalho de todos os meses tem as mesmas 8.
Cuidados de uso¶
- Nomes nus de meses diferentes. O bruto tem arquivos de nome nu (
[email protected]), gravados por versões antigas do fetcher que davam o mesmo nome a recursos diferentes do pacote (meses de 2026, por exemplo). A versão vigente é escolhida por recurso (URL do manifesto ao lado), então os meses de nome nu com manifesto entram todos, cada um no seu Parquet. Um arquivo de nome nu sem manifesto ao lado não tem período conhecido: a conversão falha pedindo o manifesto (a menos que seja cópia, de mesmo carimbo, tamanho e hash, de um arquivo com chave), e, entre os sem manifesto, só o mais recente do nome é considerado. - Mês não está numa coluna. O mês só existe no nome do arquivo e na URL do manifesto; o lake guarda apenas o ano. Cada mês é um Parquet (agora todos os meses com arquivo, 12 por ano), e o caminho do Parquet é o único rastro do mês: somar a partição
anojunta os meses do ano, o que só serve se for isso que se quer. - NCM com ponto.
ncm_cargavem como72.04, não como 4 dígitos corridos.
Exemplos¶
CIOTs emitidos em 2020 por UF de origem:
import polars as pl
c = pl.scan_parquet("lake/antt/ciot/ano=2020/*.parquet")
resumo = (
c.with_columns(n=pl.col("quantidade_ciots").cast(pl.Int64))
.group_by("uf_origem")
.agg(pl.col("n").sum().alias("ciots"))
.sort("ciots", descending=True)
.collect()
)
Referências¶
- Pacote: https://dados.antt.gov.br/dataset/ciot
- Dicionário de dados (PDF), no pacote: "Dicionário de Dados - Ciot"