Emissão em Lote

POST /nfe/batch

Emite múltiplas NFe de uma vez usando a fila de processamento assíncrono.

Autenticação

x-api-key: {apiKey}

Body

{
  "notas": [
    {
      "naturezaOperacao": "Venda de Mercadoria",
      "tipoDocumento": 1,
      "destinatario": { "cpfCnpj": "12345678901", "nome": "Cliente 1" },
      "items": [
        {
          "descricao": "Produto A",
          "ncm": "84713012",
          "quantidade": 1,
          "valorUnitario": 100
        }
      ]
    },
    {
      "naturezaOperacao": "Venda de Mercadoria",
      "tipoDocumento": 1,
      "destinatario": { "cpfCnpj": "98765432100", "nome": "Cliente 2" },
      "items": [
        {
          "descricao": "Produto B",
          "ncm": "84713012",
          "quantidade": 2,
          "valorUnitario": 50
        }
      ]
    }
  ]
}

Resposta (201)

{
  "queued": 2,
  "message": "2 notas adicionadas à fila de emissão"
}

Consultar Fila

GET /nfe/queue?status={status}

Parâmetro	Tipo	Descrição
status	string	Filtrar por status: pending, processing, completed, failed

Resposta

{
  "total": 10,
  "pending": 3,
  "processing": 1,
  "completed": 5,
  "failed": 1,
  "items": [
    {
      "id": "uuid",
      "status": "completed",
      "accessKey": "35260212345678000195550010000000011234567890",
      "createdAt": "2026-02-10T10:00:00Z"
    }
  ]
}