Frete Barato
Documentação Técnica

DOCCOB

Especificação técnica para integração de transportadoras com o processo de importação de arquivo 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.

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

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

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.

Copyright © 2026