Sandbox
A Engine API oferece um ambiente de testes (homologação) para você desenvolver e validar sua integração sem emitir documentos fiscais reais.
Como ativar
O ambiente é definido por empresa emissora (Issuer). Ao cadastrar uma empresa, use environment: 2 para homologação:
{
"cnpj": "11222333000144",
"name": "Empresa Teste",
"environment": 2
}
| Valor | Ambiente | Efeito |
|---|
1 | Produção | Documentos reais enviados à SEFAZ |
2 | Homologação | Documentos de teste, sem validade fiscal |
Notas emitidas em homologação não têm validade fiscal. Não use em
operações reais.
O que muda no sandbox
| Aspecto | Produção | Sandbox |
|---|
| URL da SEFAZ | Produção | Homologação |
| Validade fiscal | ✅ Sim | ❌ Não |
| Certificado | Obrigatório | Obrigatório |
| Resposta | Real | Real (SEFAZ homologação) |
| Custo | Cobra do plano | Grátis |
Mesmo em sandbox, a Engine API se comunica com os servidores de homologação da
SEFAZ. As respostas são reais — erros de validação e rejeições são idênticos
ao ambiente de produção.
Migrando para produção
Quando sua integração estiver validada:
- Atualize a empresa para
environment: 1
- Ou cadastre uma nova empresa com environment de produção
- Os endpoints da API são os mesmos — não muda nada no seu código
curl -X PATCH https://api.engineapi.com.br/companies/{issuerId} \
-H "Authorization: Bearer SEU_TOKEN" \
-H "Content-Type: application/json" \
-d '{ "environment": 1 }'
