Ambientes e URLs base

A API tem uma única URL base. O ambiente de cada chamada vem da chave e, para chaves de produção, da configuração fiscal da empresa.

URL base#

https://emitra.com.br/api/v1/integracao

Os três ambientes#

Como o ambiente é escolhido#

chave emt_test_  →  sandbox (simulador da Emitra)
chave emt_live_  →  ambiente da configuração fiscal da empresa
                        ├─ Produção restrita (tpAmb = 2)
                        └─ Produção          (tpAmb = 1)

O ambiente da Sefin é definido em Empresa › Configuração (veja Empresa e configuração fiscal). Para conferir pela API, chame GET /me.

Sandbox#

O sandbox roda os mesmos casos de uso da produção, mas troca a Sefin por um simulador que responde de forma determinística. Ele não precisa de certificado e é apagado automaticamente depois de 30 dias. Veja Sandbox e números mágicos.

Produção restrita#

É o ambiente de homologação da própria Sefin Nacional. As notas passam por todas as regras de validação, mas não têm valor jurídico.

• Exige o certificado A1 real da empresa.
• O CNPJ precisa estar habilitado no município de teste.
• As rejeições são as mesmas da produção, o que torna este ambiente o melhor para validar alíquota, retenção e inscrição municipal.

Produção#

Notas com valor fiscal. A partir daqui, desfazer uma nota exige cancelamento ou substituição, dentro dos prazos que cada município define.

Antes de virar para produção:

• Certificado A1 válido e com o CNPJ da empresa.
• Configuração fiscal revisada (regime, inscrição municipal, série).
• Pelo menos uma emissão autorizada em produção restrita com o mesmo serviço.
• Webhook com verificação de assinatura funcionando.
• Chave emt_live_ com só os escopos necessários.

URLs que você não precisa chamar#

A Emitra conversa com a Sefin Nacional e com o ADN em seu nome. Você não precisa chamar diretamente sefin.nfse.gov.br nem adn.nfse.gov.br, nem instalar o certificado no seu servidor.

Próximos passos#

• Sandbox e números mágicos
• Conceitos: ambientes
• Status da plataforma