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,cClassTribaparece comoclassificacaoTributaria.
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.
| Campo | Casas 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.:competenciada 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 }paginacomeça em 0;tamanhopadrão 20, máximo 100.- Notas vêm das mais recentes para as mais antigas.
Arquivos
| Rota | Content-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}/danfse | application/pdf |
O XML autorizado é o documento legal; o PDF é gerado a partir dele.