Olá.
Recentemente concluímos com sucesso dois importantes projetos de Implementação do SAP DRC Electronic Invoicing for Brazil. Um deles foi realizado no sistema SAP ERP ECC, enquanto o outro foi implementado no SAP S/4HANA. Ambos projetos apresentaram desafios significativos, cada um com suas próprias complexidades.
Por um lado, o projeto no SAP ERP ECC exigiu uma extensa implementação de notas da SAP para adaptar o sistema à nova solução. Por outro lado, o projeto no SAP S/4HANA exigiu menos esforço de atualização do sistema, mas apresentou desafios de integração com as NFS-e de duas prefeituras. Uma delas, a Prefeitura do Rio de Janeiro, possuía integração nativa com o DRC Electronic Invoicing for Brazil, enquanto a outra não.
O produto DRC Electronic Invoicing for Brazil oferece uma ferramenta chamada Partner Enablement, que permite aos parceiros ou clientes desenvolver integrações com as prefeituras dos municípios que oferecem esse serviço. Essa ferramenta disponibiliza todos os dados do documento da Nota Fiscal do Brasil nas tabelas base dos sistemas SAP J1B* em formato JSON. Por meio de uma API, esses dados podem ser consumidos no SAP BTP, onde são realizadas as transformações e validações necessárias antes da comunicação com o serviço da prefeitura. Para obter mais detalhes, consulte o link Partner Enablement.
Os passos básicos para configurar a solução são os seguintes:
Como mencionado anteriormente, foi necessário realizar desenvolvimentos de integração, melhorias e, se necessário, criar formulários personalizados. Em nossas duas experiências, criamos um formulário básico de NFS-e como referência para a equipe de negócios dentro do monitor fiscal.
A seguir, apresentamos o diagrama de integração da solução para o Partner Enablement:
Experiência em integração utilizando o SAP BTP Integration com Faturas Eletrônicas:
Quando tratamos das especificidades de cada Prefeitura dos estados brasileiros, temos que ter em conta a necessidade de extender as estruturas do arquivo no formato JSON para o envio de campos ou tratamentos adicionais dos campos atuais. Desta maneira, é importante realizar a implementação da BAdI NFE_CLOUD_REQUEST_EXTENSION e, utilizando a classe gerada, realizar os desenvolvimentos necessários para estas tratativas.
O desenvolvimento do formulário é opcional, mas deixamos como entrega padrão para os nossos clientes devido ao processo padrão das áreas de negócios em verificarem de uma maneira visual o documento em formulário. Neste caso desenvolvemos um template padrão apenas para auxiliar nesta visualização, o documento oficial pode ser verificado diretamente na Prefeitura.
Infelizmente não é possível efetuar testes de envio de NFS-e com as prefeituras sem ter um certificado válido e algumas não possuem ambientes de homologação. Desta maneira, os testes também são um desafio dependendo da Prefeitura que você precisará integrar.
No nosso caso, nós fizemos uso de uma ferramenta que cria cenários em massa de Notas Fiscais para agilizar o processo de testes e minimizar a ação da equipe de negócios na geração quantitativa de dados. A geração qualitativa segue sendo prioridade e responsabildiade da área de negócios dos clientes com apoio do parceiro.
Assim como em qualquer produto SAP, é essencial acompanhar a evolução das SAP Notes para manter a implementação atualizada. Nem todos os clientes estão nas versões mais recentes do SAP S/4HANA e FPS.
A maioria das configurações necessárias está documentada no Help da SAP, mas alguns pontos importantes exigem atenção tanto no SAP BTP quanto no SAP S/4HANA ou SAP ERP ECC.
Atualmente, temos apenas duas prefeituras integradas de forma padrão para o envio de Notas Fiscais de Serviço: São Paulo e Rio de Janeiro. Ao considerar a integração com outras prefeituras, é crucial verificar se elas possuem a infraestrutura necessária para receber e processar as NFS-e enviadas pelas empresas.
A estrutura básica do arquivo em formato JSON permite a extensão dos campos específicos de cada prefeitura. É fundamental prestar atenção a essa extensão das estruturas para enviar as informações necessárias e tratá-las nos iFlows dentro do SAP BTP Integration.
Embora o uso de um formulário não seja obrigatório, no início dos projetos, ele foi útil para visualizar o que estava sendo enviado e aprovado pelas prefeituras. Criamos um modelo de formulário, sem considerar as necessidades específicas de cada prefeitura, para essa demonstração visual no SAP DRC.
Recentemente concluímos com sucesso dois importantes projetos de Implementação do SAP DRC Electronic Invoicing for Brazil. Um deles foi realizado no sistema SAP ERP ECC, enquanto o outro foi implementado no SAP S/4HANA. Ambos projetos apresentaram desafios significativos, cada um com suas próprias complexidades.
Desafio
Por um lado, o projeto no SAP ERP ECC exigiu uma extensa implementação de notas da SAP para adaptar o sistema à nova solução. Por outro lado, o projeto no SAP S/4HANA exigiu menos esforço de atualização do sistema, mas apresentou desafios de integração com as NFS-e de duas prefeituras. Uma delas, a Prefeitura do Rio de Janeiro, possuía integração nativa com o DRC Electronic Invoicing for Brazil, enquanto a outra não.
Faremos um post futuro para discutir os desafios específicos enfrentados durante a implementação no SAP ERP ECC, bem como as lições aprendidas, incluindo detalhes sobre a automação desses processos.
O produto DRC Electronic Invoicing for Brazil oferece uma ferramenta chamada Partner Enablement, que permite aos parceiros ou clientes desenvolver integrações com as prefeituras dos municípios que oferecem esse serviço. Essa ferramenta disponibiliza todos os dados do documento da Nota Fiscal do Brasil nas tabelas base dos sistemas SAP J1B* em formato JSON. Por meio de uma API, esses dados podem ser consumidos no SAP BTP, onde são realizadas as transformações e validações necessárias antes da comunicação com o serviço da prefeitura. Para obter mais detalhes, consulte o link Partner Enablement.
Configuração
Os passos básicos para configurar a solução são os seguintes:
- Aplicação das SAP Notes relacionadas à emissão de NFS-e (consulte SAP Note #2671909).
- Criação do destino no Cloud Foundry para indicar a integração específica da NFS-e naquela região.
- Criação do destino do parceiro no sistema SAP S/4HANA ou SAP ERP ECC.
- Criação ou implementação dos fluxos de integração dos serviços de Autorização, Cancelamento e Verificação de Status. Um exemplo de fluxo pode ser baixado por meio da SAP Note #2943948.
- Implementação da BAdI NFE_CLOUD_REQUEST_EXTENSION para mapear os campos necessários no envio do arquivo em formato JSON para o SAP BTP.
- Configuração do Job responsável pela atualização dos status (J_1BNFSE_STATUS_UPDATE).
IMPORTANTE
Para as etapas 4 e 5, foram desenvolvidas soluções personalizadas seguindo nossa metodologia, que já utilizamos para implementar integrações com outros países da América Latina, América Central, Europa e Ásia por meio do SAP eDocument com o SAP BTP Integration. A etapa da BAdI é de extrema importância, pois requer atenção aos diversos campos específicos de cada prefeitura e o uso das estruturas de extensão para o envio e tratamento desses campos.
Desenvolvimento
Como mencionado anteriormente, foi necessário realizar desenvolvimentos de integração, melhorias e, se necessário, criar formulários personalizados. Em nossas duas experiências, criamos um formulário básico de NFS-e como referência para a equipe de negócios dentro do monitor fiscal.
Integração
A seguir, apresentamos o diagrama de integração da solução para o Partner Enablement:
Experiência em integração utilizando o SAP BTP Integration com Faturas Eletrônicas:
Pacotes de Integração atuais de Faturas Eletrônicas
IMPORTANTE
É fundamental lembrar que os certificados utilizados para assinatura devem ser armazenados no SAP BTP e usados nos iFlows desenvolvidos para a integração com cada prefeitura.
Enhancement
Quando tratamos das especificidades de cada Prefeitura dos estados brasileiros, temos que ter em conta a necessidade de extender as estruturas do arquivo no formato JSON para o envio de campos ou tratamentos adicionais dos campos atuais. Desta maneira, é importante realizar a implementação da BAdI NFE_CLOUD_REQUEST_EXTENSION e, utilizando a classe gerada, realizar os desenvolvimentos necessários para estas tratativas.
Exemplo de utilização da BAdI de Extensão da NFS-e
Formulário
O desenvolvimento do formulário é opcional, mas deixamos como entrega padrão para os nossos clientes devido ao processo padrão das áreas de negócios em verificarem de uma maneira visual o documento em formulário. Neste caso desenvolvemos um template padrão apenas para auxiliar nesta visualização, o documento oficial pode ser verificado diretamente na Prefeitura.
Formulário Template NFS-e
Testes
Infelizmente não é possível efetuar testes de envio de NFS-e com as prefeituras sem ter um certificado válido e algumas não possuem ambientes de homologação. Desta maneira, os testes também são um desafio dependendo da Prefeitura que você precisará integrar.
No nosso caso, nós fizemos uso de uma ferramenta que cria cenários em massa de Notas Fiscais para agilizar o processo de testes e minimizar a ação da equipe de negócios na geração quantitativa de dados. A geração qualitativa segue sendo prioridade e responsabildiade da área de negócios dos clientes com apoio do parceiro.
Ferramenta de Geração de NF-e em Massa
Conclusão
Assim como em qualquer produto SAP, é essencial acompanhar a evolução das SAP Notes para manter a implementação atualizada. Nem todos os clientes estão nas versões mais recentes do SAP S/4HANA e FPS.
A maioria das configurações necessárias está documentada no Help da SAP, mas alguns pontos importantes exigem atenção tanto no SAP BTP quanto no SAP S/4HANA ou SAP ERP ECC.
Atualmente, temos apenas duas prefeituras integradas de forma padrão para o envio de Notas Fiscais de Serviço: São Paulo e Rio de Janeiro. Ao considerar a integração com outras prefeituras, é crucial verificar se elas possuem a infraestrutura necessária para receber e processar as NFS-e enviadas pelas empresas.
IMPORTANTE
Algumas prefeituras podem ter apenas ambientes de produção para NFS-e, portanto, é importante ter isso em mente ao desenvolver a solução e iniciar os testes integrados.
A estrutura básica do arquivo em formato JSON permite a extensão dos campos específicos de cada prefeitura. É fundamental prestar atenção a essa extensão das estruturas para enviar as informações necessárias e tratá-las nos iFlows dentro do SAP BTP Integration.
Embora o uso de um formulário não seja obrigatório, no início dos projetos, ele foi útil para visualizar o que estava sendo enviado e aprovado pelas prefeituras. Criamos um modelo de formulário, sem considerar as necessidades específicas de cada prefeitura, para essa demonstração visual no SAP DRC.
- SAP Managed Tags:
