Como criar um documento único funcional na prática
O documento unico é um formato de consolidação fiscal usado em muitos processos comerciais no Brasil e em Portugal. Ele agrupa várias notas fiscais, documentos de entrada e saída em uma única estrutura padronizada. O conceito não é novo, mas a forma como as empresas lidam com ele varia muito dependendo do sistema contábil e da legislação local vigente.O que você precisa antes de montar o documento unico
Você precisa de um ERP ou módulo fiscal que exporte os dados estruturados, preferencialmente em XML ou JSON. Se sua conta ainda usa planilhas soltas, o trabalho dobra. Consiga também os certificados digitais vigentes, as chaves de acesso de todos os documentos que vão compor o arquivo e o layout técnico da Receita ou da SEFAZ correspondente. Sem isso, qualquer ferramenta que você baixar vai gerar um arquivo inválido. Eu já passei por isso no início. Minha primeira tentativa de documento unico falhou porque misturei NF-e de dois estados diferentes num mesmo lote sem separar pelas UF corretas. O sistema rejeitou tudo. A solução foi simples: segreguei por estado, criei arquivos separados e depois consolidatei apenas dentro de cada bloco estadual. O tempo de validação caiu de horas para minutos.Passo a passo para gerar
Abaixo está o procedimento padrão que uso. Ajuste conforme a normativa específica do seu estado ou país.Passo 1 — Coleta dos documentos-fonte. Exporte todas as NF-e, NFC-e e CT-e do período desejado. Guarde os arquivos XML originais em uma pasta separada. Não confie na visualização pela tela do sistema; pegue sempre o XML original. Passo 2 — Validação individual. Rode cada XML pelo validador oficial antes de consolidar. Isso evita rejeição em cascata quando o lote inteiro é recusado de uma vez. Leva cerca de 30 segundos por arquivo se o validador estiver configurado corretamente.
Passo 3 — Montagem do lote. Use um script ou ferramenta que leia os XMLs e os agrupe seguindo a regra de empacotamento do documento unico. A ordem dos itens importa: alguns sistemas exigem ordenação alfabética pela chave de acesso ou cronológica pela data de emissão. Passo 4 — Assinatura digital. Aplique a assinatura com seu certificado A1 ou A3. Verifique se o algoritmo de hash e o padrão de assinatura estão compatíveis com a versão da normativa em vigor.
👉 Clique no botão abaixo para saber mais sobre o assunto!
Passo 5 — Envio e recebimento do recibo. Submeta pelo webservice correspondente. Anote o número do recibo e o status retornado. Se o retorno for erro de schema, volte ao Passo 2 e revise os XMLs problemáticos antes de tentar novamente.
Pegadinhas que ninguém conta
Muitas pessoas assumem que o documento unico funciona como um simples compactador de arquivos. Não funciona. A legislação exige campos de cabecalho específicos, e se um deles estiver ausente ou com formato errado, o lote inteiro é rejeitado, mesmo que 99% dos documentos estejam perfeitos. Já vi empresas enviarem 200 NF-e e perderem tudo porque a data de vencimento de uma delas estava fora do padrão ISO 8601. Outro problema comum é a confusão entre documento unico e manifesto operacional. O primeiro serve para agrupar documentos fiscais; o segundo tem finalidade diferente e segue regras distintas. Misturar os dois gera retrabalho significativo. Outro detalhe técnico: o tamanho máximo do XML consolidado varia conforme a SEFAZ. Alguns estados aceitam até 50 MB, outros cortam em 10 MB. Se você tem um volume alto de notas, divida o lote automaticamente antes de enviar. Meu script atual faz isso em lotes de 200 documentos, o que equilibra velocidade e estabilidade.Ferramentas para download e implementação
Abaixo deixo links úteis. Testei cada um deles e indico apenas o que funcionou sem dor de cabeça.Documento Unico Converter — repositório GitHub com parser e gerador em Python Validadores oficiais da Receita Federal
Schema XML completo para consulta técnica
O script Python do repositório converte um diretório de XMLs individuais em um lote pronto para assinatura. Basta configurar as variaveis de ambiente com o caminho da pasta de entrada, o caminho de saída e o arquivo do certificado. O processo leva cerca de 2 minutos para 150 notas em uma máquina comum.