Oobj Recebe NFSe

Diferente da NFe, a Nota Fiscal de Serviço eletrônica (NFSe) é regulamentada de forma municipal. Assim, cada município pode possuir sistemas diferentes de emissão de NFSe, com padrões próprios de layouts de arquivos e regras de validação, o que dificulta a rotina fiscal de empresas que contratam serviços e precisam receber esses documentos.

Por isso, a Oobj desenvolveu o Oobj Recebe NFSe, uma solução que automatiza a captura, validação, decodificação e armazenamento de NFSes, independente da origem ou layout do documento, e ainda devolve ao seu servidor ou ERP todos os arquivos em um único padrão.

Recursos

A solução foi pensada para contornar todas as complexidades de operações com NFSe. Contando com três métodos de recebimento, garante que todo documento fiscal emitido contra seu CNPJ seja devidamente tratado.

O Recebe NFSe conta com os seguintes recursos:

• Leitura e validação de notas recebidas via e-mail;
• Busca ativa aos webservices e portais dos municípios;
• Integração direta de NFSes recebidas no layout ABRASF e GINFES;
• Extração de dados via Inteligência Artificial (IA) de arquivos .pdf, .png, .jpg, .jpeg e .xml diversos (que não são XML ABRASF/GINFES);
• Armazenamento do documento original (PDF ou imagem);
• Monitoramento de um ou mais CNPJs;
• Conversão de arquivos recebidos não estruturados para um único layout, o XML Oobj.  

Por dentro do Recebe NFSe

Métodos de captura

Para atender um cenário tão diverso quanto o de captura de NFSes, o Oobj Recebe NFSe conta com três métodos de recebimento. Abaixo você descobre como funcionam esses métodos e quais são seus requisitos.

1. Recebimento via e-mail com IA

Ao utilizar o método de recebimento via e-mail com IA, é possível receber arquivos nos formatos PNG, JPG, JPEG e PDF e converter para XML. Da mesma forma, é possível receber arquivos XML (em diferentes padrões), que serão convertidos em XML padronizado pela Oobj. 

Requisitos

1. Uma conta de e-mail para recebimento de DFes, algo como "notasfiscais@suaempresa.com.br". É necessário que essa conta seja de uso exclusivo da aplicação, pois os e-mails são processados e, posteriormente, excluídos da caixa de entrada;
2. Informar servidor de recebimento, porta, tipo de conexão (IMAP ou POP3¹), criptografia (TLS/SSL) e usuário e senha. Esses são informações necessárias para o cadastro do e-mail na aplicação Oobj.
3. Disponibilizar no mínimo 30 arquivos de notas já recebidas, para que seja feito o treinamento da IA.

Funcionamento

1. Prestador de serviços envia um e-mail contendo um arquivo (XML, JPG ou PDF) da NFSe para a conta de e-mail do tomador (destinatário) que está cadastrado na Oobj;
2. Após a recepção dos documentos, a aplicação envia para processamento, onde é feita a conversão das informações para um arquivo XML no padrão Oobj;
3. Esse arquivo XML convertido retorna para a conta de e-mail, onde o sistema faz a validação do arquivo e salva no banco de dados;
4. Após isso, o documento é disponibilizado no Monitor Oobj;
5. Se houver regra de entrega configurada, a aplicação disponibilizará o arquivo no servidor do cliente.

2. Captura via webservice

Este método realiza a captura das NFSe diretamente via serviço web, disponibilizado pela prefeitura. Aqui o processo é semelhante ao usado pela SEFAZ AN (Ambiente Nacional) para recebimento dos demais tipos de DFe.  

Requisitos 

1. Disponibilidade do município;
2. Certificado digital A1 cadastrado no Monitor Oobj.

Funcionamento

1. Prestador de serviços emite nota de serviço diretamente no site do município onde o serviço foi prestado;
2. Aplicação Oobj monitora webservice da prefeitura e, quando detecta uma nota emitida contra um CNPJ cadastrado, ela captura;
3. Esse arquivo XML convertido retorna para a conta de e-mail onde o Recebe NFSe faz a validação do arquivo e salva no banco de dados.
4. Se houver regra de entrega configurada, a aplicação disponibilizará o arquivo no servidor do cliente;
5. Após isso, o documento é disponibilizado no Monitor Oobj.

3. Captura via robô

Prefeituras de cidades menores podem não contar com um servidor dedicado para disponibilizar notas aos contribuintes. Neste cenário, a aplicação Oobj simula o acesso humano ao portal do município, por meio de um robô que insere os dados de cadastro da empresa e realiza o recebimento das notas sem necessidade de interferência humana.

Requisitos

1. Usuário e senha do portal da prefeitura, em nome da empresa tomadora;
2. Inscrição Municipal, quando exigido pelo município.

Funcionamento

1. O robô realiza duas vezes ao dia o acesso às prefeituras configuradas, simulando uma interação humana. Ele navega até a seção de notas tomadas e efetua o download dos arquivos PDFs/XMLs correspondentes;
2. É feita a conversão das informações para um arquivo XML padrão Oobj;
3. O Recebe DFe faz a validação do arquivo e salva no banco de dados;
4. Se houver regra de entrega, a aplicação disponibilizará o arquivo no servidor do cliente;
5. Após isso, o documento é disponibilizado no Monitor Oobj.

Modos de integração com a Oobj 

Via FTP

O FTP (File Transfer Protocol) é um método de transferência de arquivos pela internet. Ele permite enviar e receber arquivos entre computadores, geralmente entre um servidor e um cliente. Basicamente, o FTP funciona como um sistema de "copiar e colar" arquivos de um lugar para outro na internet, facilitando a troca de dados entre diferentes dispositivos.

Ao optar por esse modo, após a entrega do XML no FTP, o seu ERP deve ser parametrizado para consumir o arquivo nessa pasta predefinida.

Via arquivo pelo aplicativo DFe Client

Nesse modo, o DFe Client é responsável por monitorar e enviar automaticamente todos os XMLs para uma pasta, assim que o documento for recebido pelo Monitor Oobj. 

Para ativar esse modo, é necessário ter um servidor ou uma máquina que esteja em funcionamento 24 horas por dia. O serviço é leve e não interfere no desempenho da máquina. Da mesma forma que o via FTP, o ERP do cliente deve ser configurado para consumir os arquivos da pasta em que o DFe Client entregará os arquivos.

Via API REST Oobj

A comunicação entre a aplicação Oobj com seu ERP pode ser feita também via API. Existem vários endpoints para o serviço de recebimento de DFes, e também é necessário configurar seu sistema para consultar esses endpoints e obter retorno sobre os documentos recebidos.

Saiba mais sobre a integração via API no artigo Recebimento de Documentos Fiscais via API REST.

Como configurar o Recebe NFSe

As configurações necessárias para ativar o serviço dependem do tipo de método e de integração escolhido pela sua empresa. Veja abaixo uma lista com procedimentos padrão para começar a utilizar o Recebe NFSe:

• Criar Nova Conta no Monitor Oobj
• Configurar um Certificado A1 no Monitor Oobj
• Ativar Integração com o ERP (entrega de XML recebido) no Monitor Oobj
• Ativar monitoramento de Conta de Email
• Sincronizar as Regras de entrega da Empresa e Conta no Monitor Oobj
• Como fazer a instalação do DFe Client?

Gestão de NFSe no Monitor Oobj

O Monitor Oobj tem sua estrutura dividida por tipo de serviço (emissão ou recebimento) e, dentro do tipo de serviço, há a divisão por tipo de documentos. 

Para acessar a tela de NFSes recebidas no Monitor, clique em Doc. Recebidos > NFSe Recebidas.

Para saber todas as funcionalidades disponíveis, acesse o artigo NFSe Recebidas no Monitor Oobj.

Perguntas frequentes (FAQ)

O que preciso ter para buscar as NFSes nas prefeituras?

Varia de acordo com as regras municipais, pois cada município pode ter requisitos próprios para permitir acesso aos documentos. Porém, os dados padrão são:

Se captura via robô: usuário e senha da prefeitura (Inscrição Municipal). 

Se captura via webservice: Certificado Digital A1.

Se recebimento via e-mail: conta de e-mail exclusiva de recebimento e exemplos de documentos recebidos para treinamento da IA.

Veja informações mais detalhadas na seção Por dentro do Recebe NFSe desta documentação.

De quanto em quanto tempo a Oobj monitora o recebimento de NFse?

Se captura via robô: o processo de consulta ao portal municipal é realizado duas vezes por dia; 

Se captura via webservice: a consulta acontece diariamente, às 3:00h da madrugada;

Se recebimento via e-mail: a leitura da caixa de e-mail é realizada de cinco em cinco minutos.

É possível buscar notas retroativas nas prefeituras? 

Não. 

É possível importar do meu ERP para o Monitor Oobj as notas retroativas recebidas?

Depende do layout dessas notas. Entre em contato com o suporte Oobj para que o caso seja analisado.

Como é o layout padrão Oobj?

Anexo a este artigo estão dois arquivos modelos para que você entenda o layout Oobj. São eles:

• Modelo de XML layout padrão Oobj - NFSe
• Mapeamento campos layout XML de integração - NFSe

Fale com a Oobj!

Ainda com dúvidas sobre o Oobj Recebe NFSe? Nós estamos à disposição para qualquer esclarecimento, informação ou ajuda que seja necessária. Fale com a gente em atendimento@oobj-tecnologia.movidesk.com.