Introdução à documentação da Emitra

A Emitra emite NFS-e no Padrão Nacional. Você preenche (ou envia pela API) os dados do serviço, e a Emitra monta a DPS, assina com o certificado A1 da sua empresa, transmite à Sefin Nacional e devolve a nota autorizada, com XML e PDF.

Esta documentação cobre o painel, a API de integração, os webhooks e as integrações contábeis.

O que a Emitra faz por você#

• Monta e assina a DPS com o certificado A1 da empresa e conversa com a Sefin Nacional por mTLS. Você não precisa lidar com XML, XMLDSig ou GZip/Base64.
• Acompanha o leiaute vigente (versão 1.01, com o grupo IBS/CBS) e as notas técnicas.
• Evita nota duplicada. O número da DPS é reservado antes do envio e a API aceita Idempotency-Key.
• Explica as rejeições. Cada rejeição vem com o código oficial da Sefin, a mensagem original e uma orientação em português.
• Automatiza o que se repete: emissão recorrente por contrato, emissão em lote por planilha, API e gatilho de pagamento do Asaas.
• Entrega os arquivos: XML autorizado, PDF (DANFSe) e envio por e-mail ao tomador.

Por onde começar#

Como esta documentação está organizada#

• Começando: visão geral, conceitos e os dois quickstarts.
• Guias do painel: passo a passo de cada tela, da configuração fiscal ao suporte.
• API de integração: autenticação, ambientes, sandbox, idempotência, paginação, erros, limites e versionamento.
• Referência da API: uma página por recurso, com rota, escopo, parâmetros e exemplos em cURL, Python, JavaScript e PHP.
• Webhooks: eventos, verificação de assinatura, novas tentativas e guias para Zapier, Make e n8n.
• Integrações contábeis: exportação, envio ao contador, conversor de XML e gatilho do Asaas.
• Recursos: segurança e LGPD, glossário, FAQ técnica, limites, changelog e status.

A API em uma olhada#

A API é REST, com JSON, e está inclusa em todos os planos. O plano muda só o limite de chamadas por minuto. As notas emitidas pela API contam no limite mensal do plano, como qualquer outra.

curl https://emitra.com.br/api/v1/integracao/me \
  -H "Authorization: Bearer $EMITRA_API_KEY"

{
  "status": "success",
  "message": "Operação realizada com sucesso",
  "data": {
    "empresa": { "id": "0b1e2c3d-4f5a-4b6c-8d7e-9f0a1b2c3d4e", "razao_social": "Estúdio Exemplo Ltda" },
    "ambiente_da_chave": "test",
    "plano": { "codigo": "profissional", "nome": "Profissional" }
  }
}

A resposta completa está em Conta e tabelas de referência.

Próximos passos#

• Conceitos: DPS, NFS-e, ambientes, cota e papéis
• Quickstart: primeira emissão pela API
• Glossário fiscal