Skip to main content

​
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

AmbienteCódigoUsoURL
Produção1Documentos com validade fiscalWebservice real do estado
Homologação2Testes sem efeito fiscalWebservice 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:
EstadoSEFAZ ResponsávelNotas
SPSEFAZ-SPMaior volume de emissão do país
RJSEFAZ-RJ—
MGSEFAZ-MG—
RS, SC, PRSEFAZ Virtual RSAmbiente compartilhado
BA, CE, GO, MA, MT, MS, PA, PE, PI, RN, RO, SE, TO, DFSEFAZ 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"
}
StatusSignificadoAção
onlineSEFAZ operacionalPode emitir normalmente
instavelLentidão ou intermitênciasEmita com retry configurado
offlineManutenção ou falhaAguarde 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.

​
Veja também

Erros e Rejeições

Códigos de rejeição SEFAZ e como resolver

Sandbox

Ambiente de homologação para testes