DOCCOB
DOCCOB
Documentação técnica
DOCCOB
Documento técnico para integração de transportadoras com o processo de importação de arquivo DOCCOB.
Visão geral
Gere o arquivo DOCCOB em .txt de largura fixa, no layout 3.1 ou na família 5.x, para que ele seja aceito na importação sem divergências.
Base deste documento
Este material foi elaborado a partir do comportamento real do parser atualmente em produção. Ele descreve o que a ferramenta efetivamente lê, valida e persiste no arquivo .txt, e não apenas uma referência genérica de layout Proceda.
Neste documento
Veja o escopo da importação, os requisitos do arquivo, o layout de cada registro e as regras de validação. Cada item leva ao conteúdo completo.
Objetivo e escopo
Versões suportadas, identificação do layout e registros homologados.
Requisitos do arquivo
Formato, preenchimento, datas, valores e sequenciamento.
Layouts 3.1 e 5.x
Campos, posições e tamanhos de cada registro.
Validação e rejeição
Quando um item ou o arquivo inteiro é rejeitado.
Envio por transportadoras
O que garantir, o que não enviar e a regra prática para o 5.2.
Checklist de homologação
Confira tudo antes de enviar o arquivo.
Clique em um item para ir direto até o conteúdo completo.
Objetivo e escopo
DOCCOB
Objetivo
Orientar a geração do arquivo DOCCOB em formato texto posicional (.txt), para que ele seja aceito pela plataforma sem divergências de estrutura, campos obrigatórios ou regras de validação.
Este documento cobre:
- Layout 3.1
- Layout 5.0
- Família 5.x
- Tratamento específico de 5.2
Escopo de suporte da plataforma
DOCCOB
Versões suportadas
A plataforma reconhece duas famílias técnicas de layout. A identificação é automática no momento da leitura do arquivo.
Registros homologados
Layout 3.1: 000, 350, 351, 352, 353, 354 e 355. Layout 5.x: 000, 550, 551, 552, 555, 556 e 559.
Famílias de layout
Família 3.x (layout 3.1)
Arquivos 3.0 e 3.1 são lidos pelo mesmo mapeamento posicional do layout 3.1. É identificada quando as primeiras linhas começam com registro da família 3.
Família 5.x (layout 5.0)
Arquivos 5.0, 5.1, 5.2 e 5.3 são lidos pelo mesmo mapeamento posicional do layout 5.0. É identificada quando as primeiras linhas começam com registro da família 5.
Regra específica para o layout 5.2
O layout 5.2 não possui um parser exclusivo na ferramenta. Ele é aceito dentro da família 5.x, desde que respeite o mesmo mapa posicional homologado do parser interno 5.0. Ou seja, o 5.2 é aceito, o processamento não diferencia 5.0, 5.1, 5.2 ou 5.3, e o arquivo deve obedecer às posições homologadas da família 5.x descritas neste documento.
Registro 553
Embora exista definição posicional para o registro 553 no interpretador interno, o fluxo atual de importação DOCCOB não o utiliza. Não envie o registro 553 no arquivo do fluxo atual, salvo alinhamento técnico prévio e homologação específica.
Requisitos gerais do arquivo
Requisitos gerais
Formato do arquivo
O arquivo deve ser um texto de largura fixa, em que cada linha é lida por posição.
O arquivo deve seguir:
- Extensão obrigatória: .txt
- Arquivo texto de largura fixa por linha
- Cada linha deve iniciar com o código do registro na coluna 1-3
- Os campos são lidos por posição fixa
- O parser considera apenas o conteúdo posicional de cada linha
Requisitos gerais
Regras de preenchimento
Os campos devem ocupar exatamente as posições previstas para cada registro.
No preenchimento:
- Não utilize separadores (;, , ou |) entre campos
- Não utilize delimitadores visuais entre colunas
- Os campos devem ocupar exatamente as posições previstas para cada registro
- Campos numéricos devem ser enviados sem separador decimal explícito
- CNPJ e identificadores devem respeitar o tamanho fixo previsto no layout
Requisitos gerais
Datas
Cada tipo de registro usa um formato de data específico.
Formatos de data
Registro 000, campo date
Formato DDMMYY.
Registro 000, campo time
Formato HHMM.
Registros de negócio
Datas em DDMMAAAA. Exemplos: 24032026 e 01042026.
Requisitos gerais
Valores monetários e peso
Valores monetários e pesos são enviados sem separador decimal.
Casas decimais implícitas
Os valores e pesos são interpretados com 2 casas decimais implícitas.
Exemplos de interpretação:
- 000000000001234 é interpretado como 12.34
- 000012345678901 é interpretado como 123456789.01
- 0001234 é interpretado como 12.34 (peso)
Requisitos gerais
Sequenciamento esperado
Os registros devem seguir a ordem abaixo, com os pares de conteúdo repetidos de 1 a N vezes.
Ordem dos registros
Layout 3.1
000 → 350 → 351 → 352 → 353 + 354 (1 a N pares) → 355
Layout 5.x
000 → 550 → 551 → 552 → 555 + 556 (1 a N pares) → 559
Regras mínimas de aceitação
DOCCOB
Regras mínimas de aceitação
Para que um item de conteúdo seja aceito, os campos abaixo devem estar válidos.
Campos obrigatórios do item:
- invoice_series: série da NF-e
- invoice_number: número da NF-e
- invoice_date: data da NF-e
- invoice_weight: peso
- invoice_amount: valor
Descarte de itens
Se qualquer um desses campos estiver ausente, zerado ou inválido, o item é descartado. Se ao final do processamento não restar nenhum item válido, o arquivo é rejeitado.
Layout DOCCOB 3.1
Layouts
Layout DOCCOB 3.1
Estrutura do layout 3.1. Abra cada registro para ver os campos, as colunas inicial e final, o tamanho e a regra de preenchimento.
Visão estrutural:
- 000: Identificação do intercâmbio
- 350: Identificação do documento
- 351: Identificação do emissor
- 352: Cabeçalho de cobrança
- 353: Dados do conhecimento/frete
- 354: Dados da nota fiscal
- 355: Fechamento/totalização
Comprimento mínimo esperado: 95 colunas
| Campo | Col. inicial | Col. final | Tam. | Regra |
|---|---|---|---|---|
registro | 1 | 3 | 3 | Fixo 000 |
sender_name | 4 | 38 | 35 | Nome do emissor/remetente |
recipient_name | 39 | 73 | 35 | Nome do destinatário |
date | 74 | 79 | 6 | Data em DDMMYY |
time | 80 | 83 | 4 | Hora em HHMM |
identification_interchange | 84 | 95 | 12 | ID única do intercâmbio |
Comprimento mínimo esperado: 17 colunas
| Campo | Col. inicial | Col. final | Tam. | Regra |
|---|---|---|---|---|
registro | 1 | 3 | 3 | Fixo 350 |
identification_document | 4 | 17 | 14 | ID do documento de cobrança |
Comprimento mínimo esperado: 57 colunas
| Campo | Col. inicial | Col. final | Tam. | Regra |
|---|---|---|---|---|
registro | 1 | 3 | 3 | Fixo 351 |
identification_cgc | 4 | 17 | 14 | CNPJ/CGC do emissor |
corporate_name | 18 | 57 | 40 | Razão social do emissor |
Comprimento mínimo esperado: 170 colunas
| Campo | Col. inicial | Col. final | Tam. | Regra |
|---|---|---|---|---|
registro | 1 | 3 | 3 | Fixo 352 |
issuing_branch | 4 | 13 | 10 | Filial emissora |
document_type | 14 | 14 | 1 | Tipo do documento |
document_serie | 15 | 17 | 3 | Série do documento |
document_number | 18 | 27 | 10 | Número do documento |
date_issue | 28 | 35 | 8 | Emissão em DDMMAAAA |
date_due | 36 | 43 | 8 | Vencimento em DDMMAAAA |
document_amount | 44 | 58 | 15 | Valor, 2 casas implícitas |
billing_type | 59 | 61 | 3 | Tipo de cobrança |
amount_icms | 62 | 76 | 15 | ICMS, 2 casas implícitas |
amount_interest | 77 | 91 | 15 | Juros, 2 casas implícitas |
payment_deadline | 92 | 99 | 8 | Limite desconto DDMMAAAA |
amount_discount | 100 | 114 | 15 | Desconto, 2 casas implícitas |
agent_identification | 115 | 149 | 35 | ID do agente |
banking_branch_number | 150 | 153 | 4 | Agência bancária |
digit_agency | 154 | 154 | 1 | Dígito da agência |
account_number | 155 | 164 | 10 | Conta bancária |
account_digit | 165 | 166 | 2 | Dígito da conta |
document_activity | 168 | 170 | 3 | Atividade/documento |
Comprimento mínimo esperado: 95 colunas
| Campo | Col. inicial | Col. final | Tam. | Regra |
|---|---|---|---|---|
registro | 1 | 3 | 3 | Fixo 353 |
issuing_branch | 4 | 13 | 10 | Filial emissora |
series_knowledge | 14 | 18 | 5 | Série do CT-e |
number_knowledge | 19 | 30 | 12 | Número do CT-e |
freight_value | 31 | 45 | 15 | Frete, 2 casas implícitas |
issue_date_knowledge | 46 | 53 | 8 | Data CT-e DDMMAAAA |
sender_id | 54 | 67 | 14 | CNPJ remetente |
recipient_id | 68 | 81 | 14 | CNPJ destinatário |
issuer_id | 82 | 95 | 14 | CNPJ emissor |
Comprimento mínimo esperado: 58 colunas
| Campo | Col. inicial | Col. final | Tam. | Regra |
|---|---|---|---|---|
registro | 1 | 3 | 3 | Fixo 354 |
invoice_series | 4 | 6 | 3 | Série da NF-e |
invoice_number | 7 | 14 | 8 | Número da NF-e |
invoice_date | 15 | 22 | 8 | Data NF-e DDMMAAAA |
invoice_weight | 23 | 29 | 7 | Peso, 2 casas implícitas |
invoice_amount | 30 | 44 | 15 | Valor, 2 casas implícitas |
invoice_sender_id | 45 | 58 | 14 | CNPJ emissor NF-e |
Comprimento mínimo esperado: 22 colunas
| Campo | Col. inicial | Col. final | Tam. | Regra |
|---|---|---|---|---|
registro | 1 | 3 | 3 | Fixo 355 |
total | 4 | 7 | 4 | Qtde total de documentos |
amount | 8 | 22 | 15 | Valor total, 2 casas implícitas |
Layout DOCCOB 5.x
Layouts
Layout DOCCOB 5.x
Para a plataforma, os layouts 5.0, 5.1, 5.2 e 5.3 seguem o mesmo comportamento da família 5.x. Abra cada registro para ver os campos, as colunas inicial e final, o tamanho e a regra de preenchimento.
Visão estrutural:
- 000: Identificação do intercâmbio
- 550: Identificação do documento
- 551: Identificação do emissor
- 552: Cabeçalho de cobrança
- 555: Dados do conhecimento/frete
- 556: Dados da nota fiscal
- 559: Fechamento/totalização
Comprimento mínimo esperado: 95 colunas
| Campo | Col. inicial | Col. final | Tam. | Regra |
|---|---|---|---|---|
registro | 1 | 3 | 3 | Fixo 000 |
sender_name | 4 | 38 | 35 | Nome do emissor/remetente |
recipient_name | 39 | 73 | 35 | Nome do destinatário |
date | 74 | 79 | 6 | Data em DDMMYY |
time | 80 | 83 | 4 | Hora em HHMM |
identification_interchange | 84 | 95 | 12 | ID única do intercâmbio |
Comprimento mínimo esperado: 17 colunas
| Campo | Col. inicial | Col. final | Tam. | Regra |
|---|---|---|---|---|
registro | 1 | 3 | 3 | Fixo 550 |
identification_document | 4 | 17 | 14 | ID do documento de cobrança |
Comprimento mínimo esperado: 57 colunas
| Campo | Col. inicial | Col. final | Tam. | Regra |
|---|---|---|---|---|
registro | 1 | 3 | 3 | Fixo 551 |
identification_cgc | 4 | 17 | 14 | CNPJ/CGC do emissor |
corporate_name | 18 | 57 | 40 | Razão social do emissor |
Comprimento mínimo esperado: 260 colunas
| Campo | Col. inicial | Col. final | Tam. | Regra |
|---|---|---|---|---|
registro | 1 | 3 | 3 | Fixo 552 |
issuing_branch | 4 | 13 | 10 | Filial emissora |
document_type | 14 | 14 | 1 | Tipo do documento |
document_serie | 15 | 17 | 3 | Série do documento |
document_number | 18 | 27 | 10 | Número do documento |
date_issue | 28 | 35 | 8 | Emissão em DDMMAAAA |
date_due | 36 | 43 | 8 | Vencimento em DDMMAAAA |
document_amount | 44 | 58 | 15 | Valor, 2 casas implícitas |
billing_type | 59 | 61 | 3 | Tipo de cobrança |
amount_icms | 62 | 65 | 4 | ICMS conforme layout homologado |
amount_interest | 66 | 80 | 15 | Juros, 2 casas implícitas |
payment_deadline | 81 | 88 | 8 | Limite desconto DDMMAAAA |
amount_discount | 89 | 103 | 15 | Desconto, 2 casas implícitas |
collection_agent_code | 104 | 108 | 5 | Código do agente |
agent_identification | 109 | 138 | 30 | ID do agente |
banking_branch_number | 139 | 142 | 4 | Agência bancária |
digit_agency | 143 | 143 | 1 | Dígito da agência |
account_number | 144 | 153 | 10 | Conta bancária |
account_digit | 154 | 155 | 2 | Dígito da conta |
document_action | 156 | 156 | 1 | Ação do documento |
prefat_id | 157 | 166 | 10 | ID prefatura |
prefat_id_extra | 167 | 186 | 20 | ID complementar |
cfop | 187 | 191 | 5 | CFOP |
nfe_code | 192 | 200 | 9 | Código da NF-e |
nfe_key | 201 | 245 | 45 | Chave da NF-e |
protocol_number | 246 | 260 | 15 | Número de protocolo |
Comprimento mínimo esperado: 194 colunas
| Campo | Col. inicial | Col. final | Tam. | Regra |
|---|---|---|---|---|
registro | 1 | 3 | 3 | Fixo 555 |
issuing_branch | 4 | 13 | 10 | Filial emissora |
series_knowledge | 14 | 18 | 5 | Série do CT-e |
number_knowledge | 19 | 30 | 12 | Número do CT-e |
freight_value | 31 | 45 | 15 | Frete, 2 casas implícitas |
issue_date_knowledge | 46 | 53 | 8 | Data CT-e DDMMAAAA |
sender_id | 54 | 67 | 14 | CNPJ remetente |
recipient_id | 68 | 81 | 14 | CNPJ destinatário |
issuer_id | 82 | 95 | 14 | CNPJ emissor |
origin_state | 96 | 97 | 2 | UF de origem |
issuer_state | 98 | 99 | 2 | UF do emissor |
destination_state | 100 | 101 | 2 | UF de destino |
account_code | 102 | 111 | 10 | Código da conta |
iva_code | 112 | 113 | 2 | Código IVA |
number_packing | 114 | 133 | 20 | Número do romaneio |
shipment_id_1 | 134 | 153 | 20 | ID adicional |
shipment_id_2 | 154 | 173 | 20 | ID adicional |
shipment_id_3 | 174 | 193 | 20 | ID adicional |
devolution_flag | 194 | 194 | 1 | Flag devolução (S/N) |
Comprimento mínimo esperado: 120 colunas
| Campo | Col. inicial | Col. final | Tam. | Regra |
|---|---|---|---|---|
registro | 1 | 3 | 3 | Fixo 556 |
invoice_series | 4 | 6 | 3 | Série da NF-e |
invoice_number | 7 | 15 | 9 | Número da NF-e |
invoice_date | 16 | 23 | 8 | Data NF-e DDMMAAAA |
invoice_weight | 24 | 30 | 7 | Peso, 2 casas implícitas |
invoice_amount | 31 | 45 | 15 | Valor, 2 casas implícitas |
invoice_sender_id | 46 | 59 | 14 | CNPJ emissor NF-e |
shipment_id_1 | 60 | 79 | 20 | ID adicional |
shipment_id_2 | 80 | 99 | 20 | ID adicional |
shipment_id_3 | 100 | 119 | 20 | ID adicional |
devolution_flag | 120 | 120 | 1 | Flag devolução (S/N) |
Comprimento mínimo esperado: 22 colunas
| Campo | Col. inicial | Col. final | Tam. | Regra |
|---|---|---|---|---|
registro | 1 | 3 | 3 | Fixo 559 |
total_documents | 4 | 7 | 4 | Qtde total de documentos |
amount | 8 | 22 | 15 | Valor total, 2 casas implícitas |
Regras de validação e rejeição
DOCCOB
Validação e rejeição
O arquivo passa por validações estruturais e por item. Veja quando cada tipo de rejeição acontece.
Tipos de rejeição
Rejeições estruturais do arquivo
Ausência de cabeçalho válido, ausência de conteúdo válido, quantidade de registros de cabeçalho diferente da estrutura esperada ou versão de documento não suportada.
Rejeições por item
Um item é rejeitado quando houver falha na série, no número, na data, no peso ou no valor da NF-e.
Rejeição do arquivo completo
Mesmo que o arquivo tenha sido lido, ele pode ser rejeitado integralmente quando nenhum item válido permanecer após a validação, ou quando houver inconsistências suficientes para invalidar o processamento.
Duplicidade de arquivo
O sistema também rejeita arquivos já importados anteriormente, com controle interno de duplicidade.
Recomendação
Não reenvie o mesmo documento DOCCOB com a mesma identificação sem alinhamento prévio.
Regras para envio por transportadoras
Envio por transportadoras
O que deve ser garantido
Antes de enviar, confirme que o arquivo atende a todos os pontos abaixo.
Garanta que:
- O arquivo foi enviado em .txt
- O layout segue exatamente uma das famílias homologadas
- A coluna 1-3 de cada linha tem o código correto do registro
- As datas obedecem aos formatos indicados
- Valores e pesos estão sem separador decimal
- Cada item tem os campos mínimos de nota fiscal
- Existe pelo menos um item válido no arquivo
Envio por transportadoras
O que não deve ser enviado
Estes pontos causam rejeição do arquivo ou de itens.
Não envie:
- Arquivos com estrutura mista entre 3.1 e 5.x
- Registros fora da sequência homologada
- Campos obrigatórios em branco ou zerados
- Valores monetários com ponto ou vírgula decimal
- Registro 553 no fluxo atual, salvo homologação prévia
Envio por transportadoras
Regra prática para o 5.2
Se a transportadora gerar DOCCOB 5.2, o arquivo deve ser construído como família 5.x, obedecendo os pontos abaixo.
No layout 5.2:
- Use os registros 000, 550, 551, 552, 555, 556 e 559
- Mantenha as mesmas colunas e tamanhos descritos neste documento
- O campo invoice_number do registro 556 tem largura de 9 posições
Checklist de homologação antes do envio
DOCCOB
Checklist de homologação
Confira cada item antes de enviar o arquivo para a plataforma.
Antes do envio, verifique se:
- O arquivo possui extensão .txt
- O layout gerado pertence integralmente à família 3.1 ou 5.x
- Todas as linhas começam com o código correto do registro
- O cabeçalho obrigatório está completo
- Existe ao menos um par válido de conteúdo (353 + 354 ou 555 + 556)
- invoice_series, invoice_number, invoice_date, invoice_weight e invoice_amount estão preenchidos corretamente
- As datas operacionais estão em DDMMAAAA
- O campo 000.date está em DDMMYY
- O campo 000.time está em HHMM
- Valores e pesos não possuem separador decimal
- O arquivo não envia o registro 553
- O documento não é reenvio duplicado de arquivo já processado
Recomendação operacional
DOCCOB
Recomendação operacional
Para evitar rejeição na importação, recomenda-se que cada transportadora siga as práticas abaixo.
Recomendamos:
- Manter uma rotina de validação local antes de gerar o .txt
- Congelar a estrutura de colunas homologada por ambiente
- Executar testes com arquivos reais antes da entrada em produção
- Utilizar sempre o mesmo padrão de preenchimento para datas, valores, pesos e CNPJs
Alterações de layout
Quando houver necessidade de alteração de layout, novos registros ou uso de variações específicas de 5.2, 5.3 ou equivalentes, a mudança deve passar por homologação técnica prévia.
Veja também API e webhooks e Monitor CT-e.

