Documentos para Integração - Emissor Fiscal

Objetivo da documentação

Esta seção tem como objetivo orientar tecnicamente as automações que irão integrar com o Emissor Fiscal, apresentando:

• As interfaces de integração disponíveis
• As responsabilidades de cada interface
• O comportamento de emissão e contingência
• A orientação sobre os modelos de autenticação por interface

Detalhes operacionais, configuração cadastral, fluxos passo a passo e payloads técnicos são apresentados nas páginas seguintes desta documentação.

Visão geral da Integração

Durante a integração com o Emissor Fiscal, a automação deve selecionar uma ou mais interfaces de integração, de acordo com seu modelo de operação, arquitetura técnica e requisitos de disponibilidade.

Independentemente da interface utilizada, o Emissor Fiscal foi projetado para garantir previsibilidade no processo de emissão fiscal, evitando impactos na operação de venda.

Comportamento geral de emissão

• A emissão de documentos ocorre, de forma predominante, de maneira síncrona, com retorno na mesma chamada.
• Mesmo em cenários de contingência, o sistema emissor sempre recebe uma resposta, mantendo a continuidade operacional.
• A ausência de retorno só ocorrerá em situações excepcionais, como falhas de instalação ou funcionamento do Client local.

As regras descritas acima aplicam-se principalmente aos documentos autorizados pela SEFAZ (NF‑e e NFC‑e).

Para NFS‑e, o fluxo de emissão e retorno depende do modelo adotado por cada município, conforme detalhado na seção específica de NFS‑e.

Estratégias de Emissão e Contingência

O Emissor Fiscal suporta diferentes estratégias de emissão, que variam conforme a interface utilizada:

• Emissão online
  Comunicação direta com o órgão autorizador no momento da emissão.

• Contingência online
  Alternância automática entre serviços autorizadores quando há instabilidade momentânea da SEFAZ.

• Contingência offline
  Emissão realizada localmente, sem comunicação imediata com o fisco, com posterior sincronização.

O tipo de contingência disponível depende diretamente da interface de integração adotada.

---

Interfaces de Integração

Esta seção apresenta uma visão conceitual das interfaces, com foco em quando utilizar cada uma.

Os detalhes técnicos de instalação, endpoints, payloads e exemplos estão descritos nas seções específicas da documentação.

Client 2.0 – Emissão Local com Contingência Offline

O Client 2.0 é um componente instalável localmente, indicado para cenários em que a automação precisa garantir emissão fiscal mesmo sem acesso à internet.

Características principais:

• Emissão online e em contingência offline
• Geração local de XML e DANFE (NFC-e)
• Retorno imediato ao PDV após o registro da nota
• Sincronização automática com a SEFAZ quando a conectividade é restabelecida

Quando utilizar:

• PDVs locais
• Ambientes com instabilidade de conexão
• Operações que não podem ser interrompidas por indisponibilidade de internet

Funcionalidades que não estão diretamente relacionadas ao processo de emissão ou que não são cobertas por contingência offline não estão disponíveis nesta interface.

Modelo de autenticação: V1

Detalhamento técnico: ver seções Instalação Client 2.0, Configuração Client 2.0, Autenticações e Processo de Emissão.

---

Client em Nuvem – Emissão Online em Ambientes Web

O Client em Nuvem é indicado para sistemas que operam exclusivamente em ambiente web ou multi-tenant, sem execução local no ponto de venda.

Características principais:

• Emissão online
• Contingência exclusivamente online
• Operação centralizada em nuvem

Quando utilizar:

• ERPs web
• Plataformas SaaS
• PDVs acessados via navegador

Esta interface não suporta contingência offline.

Modelo de autenticação: V3

Detalhamento técnico: ver seções Autenticações e Processo de Emissão.

---

Integração Direta – APIs do Emissor Fiscal

A Integração Direta corresponde ao consumo das APIs do Emissor Fiscal para acesso a funcionalidades complementares ao processo de emissão.

Essa interface é utilizada de forma combinada com o Client 2.0 ou Client em Nuvem, permitindo:

• Consultas de documentos fiscais
• Acesso a dados consolidados
• Utilização das APIs Auxiliares
• Construção de fluxos fiscais personalizados

Modelo de autenticação: V2

Detalhamento técnico: ver seções Autenticações e APIs Auxiliares.

---

NFS-e – Emissão de Nota Fiscal de Serviço

A interface de NFS-e contempla a jornada completa de emissão de Notas Fiscais de Serviço Eletrônicas, respeitando os padrões e particularidades definidos por cada município.

Características principais:

• Emissão online
• Processamento síncrono ou assíncrono, conforme o município
• Comunicação via Web Services (SOAP/XML)

Esta interface é utilizada exclusivamente para documentos fiscais de serviço.

---

Próximos Passos

Após compreender as interfaces de integração e seus respectivos papéis, recomenda-se seguir a documentação na seguinte ordem:

• Configurações Iniciais – pré-requisitos cadastrais e alinhamentos operacionais
• Fluxo de Integração – visão passo a passo do projeto de integração
• Processos de Emissão – fluxos específicos de NF‑e, NFC‑e e NFS‑e
• APIs Auxiliares – endpoints complementares
• Roteiro de Homologação – testes e validação da integração

---

Glossário

Emissão Online
Processo de emissão em que o documento fiscal é transmitido ao órgão autorizador no momento da solicitação, aguardando resposta para sua conclusão.

Contingência Online
Estratégia de emissão utilizada quando há indisponibilidade momentânea dos serviços do órgão autorizador, com alternância automática de canais, mantendo a emissão em tempo real.

Contingência Offline
Estratégia de emissão utilizada quando não é possível obter autorização do fisco no momento do envio do documento. Nesse cenário, o documento pode ser emitido sem autorização imediata da SEFAZ e será sincronizado posteriormente para obtenção do status final.

Client
Interface do Emissor Fiscal responsável por intermediar a comunicação entre a automação e os órgãos fiscais, podendo operar de forma local ou em nuvem.

Integração Direta
Modelo de integração baseado no consumo das APIs do Emissor Fiscal para acesso a funcionalidades complementares ao processo de emissão.

Emissor
CNPJ responsável pela emissão do documento fiscal, vinculado a uma automação integrada ao Emissor Fiscal.