Listamos neste tópico as orientações sobre a integração com a Focus no módulo de NFS-e.
Introdução
A integração com a Focus foi implementada para otimizar o processo de emissão de NFS-e, principalmente em cenários onde há necessidade constante de adaptação às regras dos municípios.
No modelo tradicional, utilizando ACBr, o sistema é responsável por:
- Gerar o XML.
- Se adaptar às exigências de cada prefeitura.
- Ajustar mudanças de layout e validações.
Com a integração via Focus, esse fluxo é alterado, transferindo parte dessa responsabilidade para um serviço intermediador especializado.
Entre em contato com a Revenda para que seja realizada a consulta junto à equipe de Consultoria sobre a disponibilidade da integração para emissão de notas na empresa.
Como funciona a integração com a Focus
Com a integração ativa, o comportamento da emissão passa a seguir um novo fluxo técnico. O processamento ocorre da seguinte forma:
- O sistema estrutura os dados da nota.
- Os dados são enviados em formato JSON.
- A Focus recebe essas informações.
- A Focus realiza a montagem do XML.
- O envio para a prefeitura é realizado pela Focus.
- O retorno é devolvido ao sistema.
Esse modelo reduz a necessidade de ajustes internos relacionados a mudanças de provedores ou regras municipais.
Diferença entre ACBr e Focus
Emissão via ACBr
- Geração de XML realizada pelo sistema.
- Comunicação direta com a prefeitura.
- Ajustes dependem de atualização interna.
Emissão via Focus
- Envio de dados estruturados (JSON).
- XML gerado pela Focus.
- Comunicação intermediada pela Focus.
- Ajustes tratados externamente.
Quando utilizar a integração
A utilização da integração não é obrigatória em todos os cenários. A recomendação de uso inclui:
- Clientes iniciando na NFS-e.
- Ocorrência de erros recorrentes.
- Municípios com mudanças frequentes.
- Dificuldade na validação de rejeições.
Para clientes com emissão estável via ACBr, não há necessidade de alteração.
Disponibilidade da integração
Realize a consulta da disponibilidade de integração para o município no link: https://focusnfe.com.br/cidades-integradas-nfse.
Como ativar a integração
Para habilitar a integração, acesse o menu Fiscal > NFS-e > Configurações > Integração.
Os campos disponíveis para configuração incluem:
- Ativar integração: permite o uso de integração via API.
- Id da integração: identificador fornecido pelo serviço externo.
- Token homologação: token utilizado no ambiente de testes.
- Token produção: token utilizado no ambiente oficial.
- Usar API do ambiente nacional: indica o uso da API padrão do ambiente nacional para emissão.
Para ativação, marque a opção “Ativar integração”.
Com a integração ativa, verifique o Layout configurado na seção WebService e ajuste conforme o padrão do município.
Cenários de utilização do Layout / Provedor / Ambiente na NFS-e
Na configuração da NFS-e, os campos Layout (seção WebService) e Ambiente (seção Integração) trabalham juntos para determinar como a nota será enviada para a prefeitura. Com a nova estrutura, também passa a ser considerada a integração via API, que é responsável por intermediar a comunicação com os municípios, tornando os envios mais rápidos e padronizados.
Existem 3 cenários possíveis, que variam conforme o comportamento do município.
Cenário A – Município com formato próprio (provedor)
Neste cenário, o município não utiliza o padrão nacional, trabalhando com layout específico do próprio provedor. Como configurar:
– Layout: provedor
– Usar API do ambiente nacional: desmarcado
Explicação: o envio da NFS-e ocorre no padrão exigido pela prefeitura ou pelo provedor. A API realiza a comunicação com o provedor, mantendo o layout específico do município e proporcionando maior agilidade na adaptação a mudanças.
Cenário B – Município com layout nacional, mas ambiente próprio
Neste cenário, o município já utiliza o layout padrão nacional, porém a comunicação ainda ocorre em ambiente próprio da prefeitura. Como configurar:
– Layout: nacional
– Usar API do ambiente nacional: desmarcado
Explicação: mesmo com estrutura padronizada, o envio ainda é direcionado ao ambiente do município. Os dados são enviados no padrão nacional, com a API intermediando a comunicação com o provedor da prefeitura e permitindo ajustes e validações mais rápidos.
Cenário C – Município totalmente no padrão nacional
Neste cenário, o município opera 100% dentro do padrão nacional, tanto em layout quanto em ambiente. Como configurar:
– Layout: nacional
– Usar API do ambiente nacional: marcado
Explicação: toda a comunicação ocorre utilizando o padrão nacional. O envio ocorre de forma totalmente padronizada, com comunicação direta pelo ambiente nacional, permitindo correções e atualizações mais rápidas e maior previsibilidade no retorno das notas.
Pré-requisitos para ativação
Antes de ativar a integração, é necessário garantir que os dados estejam corretamente preenchidos. Os principais pontos a serem validados são:
- Cadastro do emitente.
- Configurações da NFS-e.
- Natureza e tributação.
- Serviços cadastrados.
Inconsistências nesses dados podem gerar rejeições na emissão.
Clique aqui para acessar o tutorial sobre as configurações da NFS-e.
Regras de edição de notas
O sistema mantém separação entre os modelos de emissão. O comportamento ocorre da seguinte forma:
- Notas emitidas via ACBr
- Editáveis somente com integração desativada
- Notas emitidas via Focus
- Editáveis somente com integração ativa
Mensagens de retorno
Com a integração ativa, as mensagens de retorno tendem a ser mais claras. Os principais ganhos estão na identificação de erros como:
- Código de serviço inválido.
- Alíquotas incorretas.
- Campos obrigatórios não informados.
Fluxo de análise de rejeições
Em caso de rejeição, siga uma sequência para a análise.
Validação inicial
Confira:
- Dados do emitente.
- Configuração da NFS-e.
- Serviço e tributação.
Nova tentativa
Realize nova transmissão com a integração ativa.
Análise da mensagem
Identifique a origem da mensagem:
- Fiscal.
- Cadastro.
- Regra do município.
Quando necessário, busque sempre orientação da contabilidade ou da prefeitura.
Apoio com documentação da Focus
Para validação detalhada dos campos, utilizar a documentação oficial: https://focusnfe.com.br/doc/#nfse_campos
Esta consulta permite:
- Verificar obrigatoriedade de campos.
- Validar estrutura dos dados.
- Identificar inconsistências.
