Quickstart
Emita sua primeira nota fiscal em produção em menos de 5 minutos.
Quickstart
Siga os 4 passos abaixo. Tempo estimado: 5 minutos.
Precisa testar sem afetar produção? Use "environment": 2 na empresa emissora para emitir em homologação SEFAZ.
Crie sua conta de parceiro
Registre sua software house na Engine API.
curl -X POST https://api.engineapi.com.br/auth/register-partner \
-H "Content-Type: application/json" \
-d '{
"name": "Minha Software House",
"email": "dev@minhaempresa.com",
"password": "senhaSegura123"
}'
Guarde o token retornado. Você vai precisar dele em todas as chamadas da API.
Cadastre uma empresa emissora
Registre o CNPJ que vai emitir os documentos fiscais. Cada empresa tem seu próprio issuerId.
curl -X POST https://api.engineapi.com.br/companies \
-H "Authorization: Bearer SEU_TOKEN" \
-H "Content-Type: application/json" \
-d '{
"cnpj": "11222333000144",
"name": "Empresa Exemplo Ltda",
"tradeName": "Exemplo",
"ie": "123456789",
"taxRegime": 1,
"environment": 2,
"address": {
"street": "Rua Exemplo",
"number": "100",
"district": "Centro",
"city": "São Paulo",
"cityCode": "3550308",
"state": "SP",
"zipCode": "01001000"
}
}'
| Campo | Valores |
| ----- | ------- |
| taxRegime | 1 = Lucro Real, 2 = Lucro Presumido, 3 = Simples Nacional |
| environment | 1 = Produção, 2 = Homologação (SEFAZ de teste) |
Faça upload do certificado digital
Envie o certificado .pfx (A1) da empresa emissora. Ele será criptografado e armazenado com segurança.
curl -X POST https://api.engineapi.com.br/companies/ISSUER_ID/certificate \
-H "Authorization: Bearer SEU_TOKEN" \
-F "certificate=@certificado.pfx" \
-F "password=senhaDoCertificado"
Não tem certificado digital para testes? Em homologação, você pode usar um certificado de teste emitido por qualquer AC (Autoridade Certificadora) habilitada. Veja nosso guia de certificados.
Emita sua primeira NFe
Com issuerId e certificado configurados, emita a nota.
curl -X POST https://api.engineapi.com.br/nfe/emitir \
-H "Authorization: Bearer SEU_TOKEN" \
-H "Content-Type: application/json" \
-d '{
"issuerId": "ISSUER_ID",
"naturezaOperacao": "VENDA DE MERCADORIA",
"destinatario": {
"cnpj": "99888777000155",
"nome": "Cliente Exemplo SA",
"endereco": {
"logradouro": "Av Brasil", "numero": "500",
"bairro": "Centro", "codigoMunicipio": "3550308",
"municipio": "São Paulo", "uf": "SP", "cep": "01001000"
},
"indicadorIE": 1
},
"itens": [{
"numero": 1,
"codigo": "PROD001",
"descricao": "Produto Teste",
"ncm": "84713012",
"cfop": "5102",
"unidade": "UN",
"quantidade": 2,
"valorUnitario": 150.00,
"valorTotal": 300.00,
"icms": { "origem": 0, "cst": "00", "aliquota": 18, "baseCalculo": 300.00, "valor": 54.00 }
}],
"pagamento": { "forma": "01", "valor": 300.00 }
}'
{
"success": true,
"invoice": {
"id": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
"accessKey": "35260211222333000144550010000000011000000019",
"number": 1,
"series": 1,
"status": "AUTHORIZED",
"danfeUrl": "/nfe/3fa85f64.../danfe"
}
}
🎉 Pronto! Sua primeira nota fiscal foi emitida e autorizada pelo SEFAZ.