Max ERP Fiscal · API de emissão de notas

Seu sistema emite nota fiscal com uma chamada de API.

Você envia o JSON. A gente fala com o Ambiente Nacional e com as prefeituras, devolve o status, o XML e o PDF, e manda a nota por e-mail para o tomador.

NFS-e NacionalNFS-e municipal (ABRASF)NF-e modelo 55XML e PDFHomologação e produção
✓
NFS-e autorizadaXML e PDF enviados ao tomador
POST /v1/documentos-fiscais
curl -X POST https://api.maxerp.com.br/v1/documentos-fiscais \
  -H "X-Api-Key: SUA_API_KEY" \
  -d '{
  "tipo": "NfseMunicipal",
  "payload": {
    "tomador": { "cpfCnpj": "12345678000190" },
    "servico": {
      "discriminacao": "Consultoria em TI",
      "valorServicos": 1500.00,
      "aliquota": 2.0
    }
  }
}'
202"status": "Pendente" 200"status": "Autorizada"
Como funciona

Prefeitura fora do ar não derruba o seu sistema.

A emissão entra numa fila. Quem conversa com o governo é um serviço separado. Se o Ambiente Nacional ou a prefeitura travar, a nota espera na fila e a sua aplicação continua respondendo.

  1. Você enviaUm POST com o JSON da nota e a API Key da empresa. A resposta volta na hora com o id do documento.
  2. Entra na filaA emissão fica numa fila própria. Sua aplicação não espera o governo responder.
  3. Falamos com o governoAmbiente Nacional, webservices municipais e municípios com sistema próprio, como o Distrito Federal.
  4. Você recebeStatus, XML, PDF e o e-mail automático para o tomador, com os arquivos em anexo.

Feito para quem emite em nome de muitas empresas

Homologação e produção por empresa

Teste uma empresa em homologação enquanto as outras emitem em produção, sem reiniciar nada.

Nota por e-mail automática

Autorizou, o tomador recebe o XML e o PDF pelo SMTP da própria empresa.

Todos os regimes

Simples Nacional, Lucro Presumido e Lucro Real, com retenções, deduções e benefícios fiscais no mesmo payload.

Certificado digital protegido

O certificado A1 e a senha ficam criptografados. A senha nunca é guardada em texto puro.

Uma API Key por empresa

Cada empresa só enxerga as próprias notas, e você vê quando cada chave foi usada pela última vez.

Sincronize sem perder nada

Consulte só o que mudou desde a última vez, em ordem, inclusive cancelamentos feitos no portal.

Portal do cliente

Quem não programa também acompanha tudo.

Um painel web para a equipe financeira e a contabilidade consultarem as notas, baixarem arquivos e cancelarem quando precisar.

  • Várias empresas no mesmo login, com papéis de admin, operador e leitura
  • Painel com notas autorizadas, rejeitadas e canceladas no período
  • Download de XML e PDF em lote, em um arquivo zip
  • Exportação para Excel com os filtros aplicados
  • Cancelamento com motivo, direto pela tela
Documentos fiscais · novembroTela ilustrativa
NFS-e 4.512 · Clínica VidaAutorizada
NFS-e 4.513 · Studio FormaAutorizada
NF-e 2.087 · Pedido #1093Processando
NFS-e 4.514 · Escola AtivaRejeitada

Já integrado onde você vende

App Nuvemshop

NF-e dos pedidos pagos, sem sair da loja.

O lojista instala o app, cola a API Key e escolhe emitir no clique ou automático. A chave e o link do XML voltam para o pedido na Nuvemshop.

Conhecer o app →
Software houses

Cadastre seus clientes pela API.

Com o token de parceiro você cria empresas, envia o certificado digital e sincroniza tudo o que mudou desde a última consulta.

Documentação

Campo a campo, com exemplos prontos para copiar.

Autenticação, endpoints, todos os campos da NFS-e Nacional e municipal, códigos de erro e exemplos em cURL, PHP e JavaScript.

Abrir a documentação
  • POST/v1/documentos-fiscais
  • GET/v1/documentos-fiscais?atualizadoDesde=…
  • GET/v1/documentos-fiscais/{id}
  • GET/v1/documentos-fiscais/{id}/xml
Planos

Escolha como prefere pagar

Cada empresa tem o seu plano. Quem cuida de várias empresas recebe uma fatura só, com boleto e PIX.

Valor fixo

Uma mensalidade fixa por empresa, para quem tem volume estável.

Previsível todo mêsPedir proposta

Fixo + por nota

Mensalidade menor mais um valor por nota emitida.

Paga conforme emitePedir proposta

Pacote com franquia

Uma quantidade de notas inclusa e valor por nota só no que passar da franquia.

Para volume altoPedir proposta

Perguntas sobre a API

Quais documentos a API emite?

NFS-e pelo padrão nacional e pelos webservices municipais (ABRASF) e NF-e modelo 55.

Como é a autenticação?

Cada empresa tem a sua API Key, enviada no cabeçalho X-Api-Key. Software houses usam um token de parceiro para cadastrar empresas.

Dá para testar sem valor fiscal?

Sim. Cada empresa pode emitir em homologação e passar para produção quando estiver tudo certo.

Quero minha API Key

Conte quantas empresas e notas você emite por mês. Respondemos com o plano e liberamos o ambiente de homologação.