Integração
Integre usando a IA que você já usa.
Preparamos um guia escrito para ser lido por ferramentas de IA. Você anexa o arquivo no ChatGPT, Claude, Cursor ou Copilot, a sua IA aprende como a nossa API funciona e escreve a integração junto com você.
- Baixe o guia para IA. Um único arquivo com tudo o que a sua ferramenta precisa saber sobre a nossa API.
- Anexe na sua IA com o pedido pronto. Ela lê o guia, explica cada passo e escreve o código para o seu sistema.
- Teste sem custo. Crie uma chave de teste no painel e rode a integração. As notas de teste não consomem a franquia.
Prefere ajuda de uma pessoa? Fale com a gente pelo WhatsApp.
Anexei o arquivo maxtra-fiscal-guia-para-ia.md. Ele explica a API do Maxtra Fiscal, que emite NFS-e. Leia o arquivo inteiro antes de escrever código. Quero integrar meu sistema para emitir a nota automaticamente. Não sou programador experiente: explique cada passo e me diga onde colar cada arquivo. Meu sistema: [descreva a plataforma, por exemplo "loja em WordPress"]. Quando emitir: [por exemplo, "quando o pedido for pago"]. Siga as regras do guia: comece pelo ambiente de teste (homologação), leia a chave de API de uma variável de ambiente e nunca a escreva no código, e use o número do pedido como Idempotency-Key e referencia_externa.
Anexe o arquivo junto com este texto. Troque o que está entre colchetes e nunca cole a sua chave de API na conversa.
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": "…"
}
}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.
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.