Visão Geral
Visão Geral das Consultas da NF-e
As rotas de consulta da API da Emitix têm como objetivo permitir que o emissor acompanhe o status e as informações das Notas Fiscais Eletrônicas (NF-e) em diferentes estágios do processo de emissão.
Essas rotas facilitam o monitoramento e a integração com os serviços da SEFAZ, garantindo que o sistema tenha acesso às informações oficiais sobre as NF-es emitidas, processadas ou rejeitadas.
Tipos de Consultas Disponíveis
| Rota | Finalidade | Método |
|---|---|---|
/nfe/consultacadastro | Consulta o cadastro de contribuintes junto à SEFAZ. | POST |
/nfe/consulta | Consulta o status e os detalhes de uma NF-e específica pela chave de acesso. | POST |
/nfe/consultaProcessamento | Consulta o resultado do processamento de um lote de NF-e. | POST |
/nfe/statusservico | Verifica a disponibilidade do serviço de autorização da SEFAZ. | POST |
Quando Utilizar Cada Consulta
- Consulta Cadastro: usada para validar o CNPJ ou inscrição estadual do destinatário antes da emissão da NF-e.
- Consulta: usada para confirmar a autorização, rejeição ou cancelamento de uma nota fiscal específica.
- Consulta de Processamento: utilizada logo após o envio de um lote de NF-es para verificar se o processamento foi concluído.
- Status de Serviço: usada antes de iniciar a emissão para confirmar se o ambiente da SEFAZ está operacional.
Boas Práticas
- Verifique o Status de Serviço antes de realizar qualquer envio ou consulta.
- Utilize a Consulta de Processamento para evitar reenvios desnecessários de lotes.
- Armazene os XMLs de retorno localmente para fins de auditoria e contingência.
- Mantenha o certificado digital A1 válido e protegido — ele é exigido em todas as requisições.
Autenticação
Todas as rotas de consulta requerem autenticação via Bearer Token e API Key, conforme o padrão abaixo:
-H "Authorization: Bearer SEU_TOKEN_AQUI" \
-H "api-key: SUA_API_KEY_AQUI..."