SEFAZ e Webservices
Como funciona a SEFAZ, seus ambientes, estabilidade e como a Engine API abstrai a comunicação fiscal.
SEFAZ e Webservices
A SEFAZ (Secretaria de Estado da Fazenda) é o órgão responsável por autorizar e registrar todos os documentos fiscais eletrônicos no Brasil. Cada estado tem sua própria SEFAZ com webservices independentes.
Como a Engine API se Comunica
Você envia JSON. Nós fazemos tudo o mais:
Seu app (JSON)
↓
Engine API
├── Valida campos obrigatórios
├── Converte JSON → XML NF-e (ABRASF / SEFAZ)
├── Assina XML com seu certificado A1 (RSA SHA-256)
├── Transmite via SOAP para o webservice SEFAZ do estado
├── Recebe resposta XML da SEFAZ
└── Converte resposta XML → JSON limpo
↓
Seu app (JSON) + Webhook
Ambientes
| Ambiente | Código | Uso | URL |
|----------|--------|-----|-----|
| Produção | 1 | Documentos com validade fiscal | Webservice real do estado |
| Homologação | 2 | Testes sem efeito fiscal | Webservice de teste da SEFAZ |
O endpoint da Engine API é sempre o mesmo (https://api.engineapi.com.br). O ambiente é definido no cadastro da empresa emissora com o campo environment.
Webservices por Estado (Produção)
Os principais estados e seus webservices:
| Estado | SEFAZ Responsável | Notas | |--------|-------------------|-------| | SP | SEFAZ-SP | Maior volume de emissão do país | | RJ | SEFAZ-RJ | — | | MG | SEFAZ-MG | — | | RS, SC, PR | SEFAZ Virtual RS | Ambiente compartilhado | | BA, CE, GO, MA, MT, MS, PA, PE, PI, RN, RO, SE, TO, DF | SEFAZ Virtual AN (SVCAN) | Ambiente compartilhado |
Consultando o Status da SEFAZ
Verifique se o webservice do estado está operacional antes de emitir:
curl https://api.engineapi.com.br/nfe/status-sefaz \
-H "Authorization: Bearer SEU_TOKEN"
{
"uf": "SP",
"ambiente": "producao",
"status": "online",
"message": "Serviço em operação",
"checkedAt": "2026-04-26T23:00:00.000Z"
}
| Status | Significado | Ação |
|--------|-------------|------|
| online | SEFAZ operacional | Pode emitir normalmente |
| instavel | Lentidão ou intermitências | Emita com retry configurado |
| offline | Manutenção ou falha | Aguarde e use emissão em contingência |
Contingência
Quando a SEFAZ de um estado fica indisponível, a Engine API automaticamente tenta os ambientes de contingência previstos pelo fisco (SVRS, SVCAN, EPEC) conforme a legislação.
Notas emitidas em contingência possuem status CONTINGENCY e precisam ser transmitidas para a SEFAZ quando o serviço voltar. A Engine API faz isso automaticamente.