ZIP de XML e DANFE

O que é um ZIP de XML e DANFE?

É um pacote compactado no formato ZIP que contém vários documentos fiscais de uma vez. Dentro dele costumam estar dois tipos de arquivo: o XML, que é a nota fiscal eletrônica propriamente dita, e o DANFE em PDF, que é a versão impressa e legível dessa nota.

O formato ZIP reduz o tamanho total dos arquivos e junta tudo em um só item. Em vez de baixar centenas de notas uma a uma, a pessoa baixa um único arquivo e, ao descompactá-lo, encontra todos os documentos do período ou do filtro escolhido.

Apesar do nome citar o DANFE, que é específico da NF-e, o mesmo conceito vale para outros documentos: um pacote pode trazer XMLs de NFC-e com seus DANFCEs, de CT-e com seus DACTEs ou de MDF-e com seus DAMDFEs.

Para que serve o ZIP de XML e DANFE?

O uso mais comum é o envio mensal de notas ao escritório de contabilidade, que precisa dos XMLs para fazer a escrituração fiscal e apurar os impostos. Mandar tudo em um único arquivo evita esquecimentos e economiza tempo.

Ele também é útil para criar cópias de segurança, responder a pedidos de fiscalização ou auditoria interna, migrar documentos para outro ERP e compartilhar notas de uma filial ou de um cliente específico com quem precisar delas.

Qual a diferença entre o XML e o DANFE dentro do ZIP?

O XML é o documento fiscal com validade jurídica. Ele foi assinado digitalmente pelo emitente e autorizado pela SEFAZ, e é ele que sistemas contábeis e fiscais importam e leem automaticamente.

O DANFE é apenas uma representação gráfica auxiliar, gerada a partir do XML para facilitar a leitura por pessoas, acompanhar a mercadoria e permitir a consulta pela chave de acesso. Ele não substitui o XML. Por isso, se o pacote tiver apenas PDFs, ele não serve para fins de guarda ou escrituração.

Como o ZIP de XML e DANFE é gerado em uma integração por API?

Em plataformas de emissão fiscal, o usuário ou o sistema integrado normalmente escolhe filtros, como período de emissão, CNPJ emitente, tipo de documento e status (autorizado, cancelado etc.). A plataforma então reúne os arquivos correspondentes e monta o pacote.

Quando o volume é grande, a geração costuma ser feita de forma assíncrona: o sistema faz o pedido, a plataforma processa em segundo plano e depois disponibiliza um link de download ou avisa por webhook que o arquivo está pronto. Isso evita timeouts e não trava a integração.

Quais cuidados tomar ao gerar e usar esse arquivo?

Confira se o pacote inclui os eventos ligados às notas, como cancelamentos e cartas de correção, pois o contador precisa saber quais documentos deixaram de valer. Nomear cada arquivo pela chave de acesso também facilita a conferência e evita duplicidades.

Lembre que o ZIP contém dados de clientes, valores e informações fiscais da empresa, então deve ser compartilhado por canais seguros e apenas com quem precisa. Além disso, enviar o ZIP ao contador não dispensa a empresa de guardar os XMLs originais pelo prazo exigido pela legislação.

Exemplos de ZIP de XML e DANFE

• Um ERP de varejo solicita, todo início de mês, o ZIP com os XMLs e DANFEs das NF-e autorizadas e canceladas do mês anterior e envia o link automaticamente ao escritório contábil.
• Um marketplace que emite notas para vários lojistas gera um ZIP separado por CNPJ, para que cada vendedor receba apenas os seus próprios documentos.
• Uma transportadora exporta em ZIP os XMLs de CT-e e MDF-e de um trimestre, junto com os DACTEs, para atender a uma auditoria interna.
• Uma empresa que está trocando de sistema de gestão baixa o ZIP com todas as notas do ano para importá-las no novo ERP.