NF-e

Grupo autXML, Fatura e Duplicatas na NF-e via API: Download para Contador e Cobrança no DANFE

Aprenda a preencher corretamente o grupo <autXML> (autorização de download de XML para contador e transportadora) e o grupo <cobr> (<fat> e <dup> — Fatura e Duplicatas no DANFE) evitando as Rejeições SEFAZ 486, 851, 852 e 898.

Fábio Magalhães CostaAtualizado em 22/11/2026
Configuração do grupo autXML para contadores e estruturação de faturas e duplicatas no DANFE via API

Configuração do grupo autXML para contadores e estruturação de faturas e duplicatas no DANFE via API

Dois recursos da NF-e (Modelo 55) costumam ser deixados para depois no MVP de um ERP — e viram exigência imediata assim que entra o primeiro cliente B2B ou o primeiro escritório de contabilidade:

  1. Grupo <autXML>: autorizar automaticamente o CNPJ/CPF do contador (ou da transportadora/terceiro) a baixar o XML completo diretamente no ambiente nacional da SEFAZ (NFeDistribuicaoDFe), sem depender de envio manual por e-mail.
  2. Grupo <cobr> (<fat> e <dup>): imprimir o quadro de Fatura e Duplicatas (parcelas, vencimentos e valores) no DANFE para vendas faturadas em boleto (30/60/90 dias), sem tomar Rejeição 851 ou Rejeição 852 da SEFAZ.

1. Grupo <autXML>: Como autorizar o contador a baixar XML na SEFAZ

No layout 4.00 da NF-e, o grupo <autXML> permite listar até 10 CNPJs ou CPFs autorizados a consultar e baixar o arquivo XML daquela nota diretamente nos webservices da Receita Federal / SEFAZ.

Regras de validação do <autXML>

  • Limite máximo: até 10 ocorrências de <autXML> por NF-e (cada uma contendo <CNPJ> ou <CPF>, nunca os dois juntos).
  • Sem duplicidade: informar o mesmo CNPJ/CPF duas vezes dentro de <autXML> gera rejeição de validação na SEFAZ.
  • Obrigatoriedade estadual: alguns estados (como Bahia — BA) tornam obrigatório incluir o CNPJ da própria SEFAZ estadual ou do contador em operações específicas — e para escritórios contábeis que usam sistemas de captura automática (DF-e), incluir o CNPJ da contabilidade em <autXML> elimina 100% da cobrança mensal de "me manda o zip dos XMLs".

2. Grupo <cobr> (<fat> e <dup>): Fatura e Duplicatas sem Rejeição

Quando uma venda B2B é parcelada em boleto (tPag = 15), duplicata mercantil (tPag = 14) ou crédito loja (tPag = 05), o comprador exige que as parcelas apareçam no quadro FATURA / DUPLICATAS do DANFE.

É aqui que a SEFAZ aplica validações matemáticas rígidas:

Código Rejeição SEFAZ Causa Comum no ERP Como Corrigir
851 Soma do valor das parcelas difere do Valor Líquido da Fatura Σ vDup ≠ vLiq (ex.: erro de arredondamento de R$ 0,01 na divisão em 3 parcelas de R$ 100,00). Jogar a diferença de centavos na primeira ou última parcela para que Σ vDup === vLiq.
852 Número da parcela inválido ou não informado <nDup> fora do padrão de 3 dígitos sequenciais (001, 002, 003). Formatar sempre com padStart(3, "0") (001, 002, ...).
898 Data de vencimento da parcela anterior à data de emissão <dVenc> menor que <dhEmi> (muito comum em fuso horário UTC vs Brasília!). Garantir que dVenc >= dataEmissao em ordem cronológica crescente.
899 Valor do pagamento menor que o valor da nota (vPag < vNF) Desalinhamento entre <cobr> e <pag><detPag>. Manter vLiq = vOrig - vDesc coerente com vPag em <pag>.

⚡ Regra de Ouro do Arredondamento de Parcelas em B2B: Ao dividir R$ 1.000,00 em 3 duplicatas, nunca mande 333.33 + 333.33 + 333.33 = 999.99 (isso dispara Rejeição 851). Calcule a última parcela como vLiq - somaAnteriores (333.33 + 333.33 + 333.34 = 1000.00).


Exemplo Prático: Enviando autorizadosXml e cobranca via API da Notaas

Na Notaas, você envia autorizadosXml (CNPJ do contador/transportadora) e o objeto cobranca (fatura + duplicatas) direto no POST /api/v1/emitir — e o DANFE PDF já sai formatado automaticamente com todas as parcelas e vencimentos:

{
  "tipo": "nfe",
  "ambiente": "homologacao",
  "externalId": "b2b_fatura_30_60_90_7741",
  "naturezaOperacao": "Venda de mercadoria",
  "consumidorFinal": false,
  "autorizadosXml": [
    { "cnpj": "12345678000195" }
  ],
  "destinatario": {
    "cpfCnpj": "11222333000181",
    "nome": "Industria Compradora Exemplo SA",
    "inscricaoEstadual": "110042490114",
    "endereco": {
      "logradouro": "Av. Industrial",
      "numero": "2500",
      "bairro": "Jardim",
      "codigoMunicipio": "3547809",
      "uf": "SP",
      "cep": "09080500"
    }
  },
  "itens": [
    {
      "codigo": "MAT-500",
      "descricao": "Lote de Componentes Eletronicos",
      "ncm": "85423190",
      "cfop": "5102",
      "unidade": "UN",
      "quantidade": 10,
      "valorUnitario": 100.00,
      "origem": 0,
      "icms": { "csosn": "102" }
    }
  ],
  "cobranca": {
    "fatura": {
      "numero": "FAT-2026-7741",
      "valorOriginal": 1000.00,
      "valorDesconto": 0.00,
      "valorLiquido": 1000.00
    },
    "duplicatas": [
      { "numero": "001", "vencimento": "2026-12-22", "valor": 333.33 },
      { "numero": "002", "vencimento": "2027-01-21", "valor": 333.33 },
      { "numero": "003", "vencimento": "2027-02-20", "valor": 333.34 }
    ]
  },
  "pagamentos": [
    { "forma": "15", "valor": 1000.00 }
  ]
}

Dica para ERPs com múltiplos clientes contábeis

Combine <autXML> com o envio de Pedido de Compra (xPed e nItemPed) e o gerenciamento multi-CNPJ via Org API da Notaas: seu cliente emite a nota, o comprador recebe o DANFE com duplicatas e pedido de compra, e o contador acessa o XML na hora sem precisar de nenhuma intervenção manual.


Teste faturas, duplicatas e autXML gratuitamente

Na Notaas, você conta com 20 notas fiscais gratuitas por mês em produção real (1 CNPJ) + até 5 CNPJs em homologação via Org API, geração instantânea de DANFE e webhooks assinados com HMAC-SHA256.

Notaas — Infraestrutura Fiscal Multi-Tenant para SaaS, ERPs e BPOs

Escale a emissão de NFS-e, NF-e, NFC-e, CT-e e MDF-e para dezenas de CNPJs

Integre a API de Nota Fiscal da Notaas no seu software: provisione clientes via Org API Multi-CNPJ, isole certificados A1 em nuvem, receba webhooks assinados com HMAC e gere DANFSe v2.0 local. Sandbox ilimitado e planos sob medida para operações em escala.

Artigos Relacionados em NF-e

Guias Pilares de Integração Fiscal