Sistemas, lojas e integradores
API de NFS-e para sistemas, lojas e integradores
Emita a NFS-e direto do seu sistema, loja ou plataforma, com uma chave de API por empresa. Quem não programa pode usar o guia que ensina a nossa API à sua ferramenta de IA.
- Integração por API, com uma chave por empresa
- Guia que ensina a nossa API para a sua IA
- Aviso automático quando a nota é autorizada
- Envio repetido nunca gera nota em dobro
Para desenvolvedores
Uma chamada, uma nota. Nunca duas.
A API foi desenhada para quando a rede falha: cada emissão é reservada antes de sair, e o resultado chega no seu sistema por webhook.
- Chaves por empresa e ambiente. Perfil operador ou leitura, revogação imediata, com o valor exibido uma única vez.
- Idempotência de verdade. A mesma
Idempotency-Keydevolve a resposta original. Mudar os dados com a mesma chave retorna 409. - Sua referência de volta. Envie
referencia_externacom o id do pedido: ela volta na listagem, no detalhe e em cada webhook. - Webhooks com entrega garantida. Eventos autorizada, rejeitada, cancelada e mudança de status. Reenvio em 1 min, 5 min, 30 min, 2 h, 6 h e 12 h.
- Documentação completa. Guia passo a passo com exemplos e a especificação da API em formato OpenAPI, que gera o cliente na sua linguagem.
curl "$API/api/tenants/$TENANT_ID/nfse" \
-H "X-API-Key: $API_KEY" \
-H "X-Ambiente: homologacao" \
-H "Idempotency-Key: pedido-001001" \
-H "Content-Type: application/json" \
--data-binary @emissao.json
# 200 autorizada · 202 processando
# 422 rejeitada, com os erros do emissor
# Mesma chave, mesma resposta.
# Sem nova transmissão.POST /webhooks/maxtra
X-Maxtra-Event: nota.autorizada
X-Maxtra-Event-Id: …
X-Maxtra-Signature: t=<unix>,v1=<hmac-sha256>
{
"evento": "nota.autorizada",
"ambiente": "producao",
"dados": {
"referencia_externa": "PEDIDO-1001",
"status_anterior": "processando",
"chave_acesso": "…"
}
}Recursos pensados para esse dia a dia.
Todos os recursos estão em todos os planos. Veja a lista completa.
Acompanhamento automático
Notas em processamento são conferidas sozinhas até a resposta final da prefeitura.
Histórico completo
Busca, filtros por situação e período, download do PDF e do XML e cancelamento.
Auditoria
Quem fez o quê e quando: usuário, chave de API ou tarefa automática, com filtros.
Equipe por empresa
Quatro perfis de acesso: do responsável, que pode tudo, a quem só consulta.
Dúvidas frequentes
Dúvidas frequentes sobre este assunto
Não encontrou a sua dúvida? Veja todas as perguntas ou fale com a gente pelo WhatsApp.
Tirar uma dúvidaPreciso de um programador para integrar?
Não necessariamente. Pelo painel você emite sem nenhuma integração. Para emitir direto do seu sistema, temos um guia feito para ferramentas de IA: você anexa o arquivo no ChatGPT, Claude ou Cursor, e a sua IA aprende a nossa API e escreve o código com você.
Posso testar antes de emitir notas de verdade?
Sim. Cada empresa tem o ambiente de homologação, com os mesmos fluxos da produção, e as notas emitidas nele não consomem a franquia. O PDF de homologação sai com a marca “sem validade jurídica”.
O que conta na franquia de notas?
Apenas notas autorizadas em produção. Notas de homologação, rejeitadas ou ainda em processamento não contam.
E se eu emitir mais notas do que a franquia?
A emissão continua normalmente. Cada nota além da franquia é cobrada como excedente no valor do seu plano, e você recebe um e-mail ao atingir 80% e 100% da franquia.
Continue explorando
Sua próxima nota pode sair sem retrabalho.
Conte quantos CNPJs você atende e quantas notas emite por mês. A gente indica o plano certo e prepara a sua conta.
Falar no WhatsApp Atendimento comercial pelo WhatsApp.