Motor de Emissão

API do Motor de Emissão

Emita NF-e, NFC-e e NFS-e nacional por uma API HTTP com JSON. O motor monta o XML, assina, transmite para a SEFAZ ou para o Sistema Nacional, guarda o documento e avisa o seu sistema por webhook.

Quer ver funcionando? Siga Primeira nota: em uns dez minutos você emite uma NF-e no ambiente simulado, sem certificado digital e sem falar com a SEFAZ.

O que o motor faz e o que fica com você

O motor transmite o que você envia, com os tributos já calculados pelo seu sistema. Ele confere o leiaute e o esquema oficial antes de transmitir, numera, assina, trata contingência, guarda o XML autorizado e gera a DANFE. A regra fiscal (CFOP, CST, alíquotas) é de quem emite.

Ambientes

AmbienteO que acontecePrecisa de
simuladoO motor faz tudo, menos falar com a SEFAZ: monta, valida, assina e devolve um protocolo simulado. Os webhooks saem normalmente. É o sandbox.Chave de teste. Sem certificado, o motor assina com um certificado de teste próprio.
homologacaoTransmite para o ambiente de homologação da SEFAZ (na NFS-e, a produção restrita do Sistema Nacional). Sem valor fiscal.Chave de teste e o certificado A1 da empresa.
producaoNota de verdade, com valor fiscal.Chave de produção, certificado A1 e a liberação da emissora pelo operador.

O ambiente vem do campo ambiente do pedido; sem ele, vale o ambiente_padrao da emissora, que começa em simulado.

Autenticação

Toda chamada leva a chave da conta no cabeçalho:

Authorization: Bearer mtr_teste_...

A chave de teste (mtr_teste_) opera no simulado e em homologação; a de produção (mtr_prod_) opera em todos. A chave de teste você cria no portal, onde também cadastra emissoras, certificado, séries e webhooks; a de produção é entregue pelo operador do motor quando a conta é liberada. Guarde a chave como um segredo: ela não aparece de novo depois de criada.

Convenções

Guias