Atendimento

Formatos e paginação

Valores decimais, datas, códigos fiscais e listas paginadas.

JSON

  • Corpo em JSON UTF-8 (Content-Type: application/json), campos em camelCase.
  • Nomes fiscais oficiais são preservados: chaveAcesso, cfop, ncm, cest, cClassTrib aparece como classificacaoTributaria.

Valores

Valores monetários, quantidades e alíquotas trafegam como string decimal, com ponto:

{ "valorServico": "1500.00", "quantidade": "2.5000", "aliquota": "18" }

Assim nenhum cliente perde precisão com ponto flutuante (como 0.1 + 0.2 em JavaScript). A API nunca arredonda um valor enviado com mais casas que o leiaute permite: responde 400 no campo.

CampoCasas decimais
Valores em reais (valorServico, desconto, valor do pagamento)2
quantidade (NF-e e NFC-e)até 4
valorUnitario (NF-e e NFC-e)até 10

Datas

  • Data e hora em ISO 8601 com offset: 2026-11-06T10:00:00-03:00.
  • Data sem hora: 2026-11-06 (ex.: competencia da NFS-e).
  • Mês de referência dos resumos: yyyy-MM (2026-11).

Documentos e códigos

  • CNPJ e CPF aceitam máscara (11.222.333/0001-81) ou só dígitos; o dígito verificador é conferido. As respostas devolvem só dígitos.
  • CEP aceita máscara. Município é o código IBGE de 7 dígitos (5300108 = Brasília).

Listas paginadas

As listagens (GET /nfse, GET /nfe, GET /nfce, GET /clientes, GET /produtos, entregas do webhook) devolvem:

{ "itens": [ ... ], "pagina": 0, "tamanho": 20, "totalItens": 57, "totalPaginas": 3 }
  • pagina começa em 0; tamanho padrão 20, máximo 100.
  • Notas vêm das mais recentes para as mais antigas.

Arquivos

RotaContent-Type
GET .../xml (NF-e, NFC-e, NFS-e e eventos)application/xml, o documento autorizado íntegro
GET /nfe/{id}/danfe, /nfce/{id}/danfce, /nfse/{id}/danfseapplication/pdf

O XML autorizado é o documento legal; o PDF é gerado a partir dele.

Nesta página