Integração fiscal no SAP: o que a camada fiscal precisa definir antes da interface
Toda nota emitida, todo evento recebido e todo arquivo enviado ao fisco passa por uma integração. A tecnologia (SAP BTP, Integration Suite, APIs) é escolha do projeto. O que trafega, com que regra e com que prova é decisão fiscal.
Esta página explica as peças da plataforma da SAP, as integrações fiscais brasileiras mais comuns e o recorte que cabe à camada fiscal, sem invadir o que é do integrador, e aponta quais decisões não podem esperar até a fase de homologação.
Integração é tecnologia. O que passa por ela é fiscal
Um projeto SAP no Brasil liga o ERP (sistema de gestão da empresa) a autorizadores estaduais, ao ambiente nacional de NFS-e, a parceiros e a sistemas internos. Cada ligação carrega documentos com valor jurídico. Uma interface que funciona do ponto de vista técnico, mas leva o dado errado, produz uma nota errada.
Por isso o desenho de uma integração fiscal tem duas camadas. A técnica define protocolo, segurança, monitoramento e desempenho. A fiscal define quais campos são obrigatórios, de onde cada um vem, qual regra o calcula, como se trata a rejeição e o que fica guardado como prova.
A DFSpro trabalha na segunda camada. A primeira segue com o integrador e com o time técnico do cliente.
Na prática, a maioria das rejeições, dos retrabalhos e das divergências de apuração nasce na fronteira entre as duas: o desenho técnico está correto, mas ninguém definiu a regra fiscal que ele deve carregar. Fechar essa lacuna antes da interface é bem mais econômico, previsível e seguro do que corrigir nota por nota depois da operação.
O que cada peça da plataforma faz e a pergunta fiscal de cada uma
Na tabela, o texto central vem da documentação oficial. A última coluna transforma cada peça em decisão para o time fiscal.
| Peça | O que é (segundo a SAP) | Pergunta fiscal |
|---|---|---|
| SAP BTP | Plataforma que reúne desenvolvimento de aplicações, automação de processos, integração, dados e inteligência artificial, segundo a documentação da SAP. | Qual regra fiscal nova vai morar fora do núcleo do ERP, e quem responde por ela? |
| SAP Integration Suite | Conjunto de capacidades de integração: Cloud Integration, API Management, Open Connectors, Integration Advisor, Trading Partner Management, Edge Integration Cell e Migration Assessment. | Qual fluxo fiscal passa por ele e qual fica fora? |
| Cloud Integration | Conecta aplicações em nuvem e locais e processa mensagens entre empresas ou áreas, em cenários entre aplicações (A2A) e entre empresas (B2B). Faz parte do plano de serviço do Integration Suite. | Que mensagem fiscal trafega, em que formato, e o que acontece quando falha? |
| API Management | Permite descobrir, proteger, governar e publicar APIs. | Quais dados fiscais podem ser expostos, para quem, e com que controle de acesso? |
| Edge Integration Cell | Permite rodar integrações em ambiente gerenciado pelo cliente, para cenários com exigências rígidas de dados ou de implantação. | Há exigência de que o dado fiscal fique em ambiente controlado pela empresa? |
| Migration Assessment | Estima o esforço de migrar cenários do SAP Process Orchestration. | Quais interfaces fiscais antigas existem e o que cada uma entrega hoje? |
Fontes: documentação da SAP sobre SAP BTP, SAP Integration Suite e SAP Cloud Integration, listadas ao fim da página. A última coluna é leitura própria da DFSpro, não declaração da SAP.
As integrações fiscais brasileiras mais comuns
Duas frentes aparecem em quase todo projeto: a NF-e, com seus autorizadores e a contingência, e a NFS-e padrão nacional. Veja o que o fisco publica e o que isso exige do SAP.
NF-e (modelo 55)
O SAP envia o documento ao autorizador e recebe a resposta. Serviços na versão 4.00, como NFeAutorizacao, NFeRetAutorizacao, RecepcaoEvento, NfeConsultaProtocolo, NfeStatusServico e NfeInutilizacao. Fonte: Portal nacional da NF-e (serviços web).
Autorizador por estado
Cada estado aponta para seu autorizador ou para uma SEFAZ Virtual. SVAN e SVRS atendem a estados conforme a relação publicada no portal. Fonte: Portal nacional da NF-e.
Contingência
O SAP troca de destino quando o autorizador está indisponível. SVC-AN e SVC-RS, cada um com sua lista de estados. Fonte: Portal nacional da NF-e.
NFS-e padrão nacional
Empresa, município e ADN trocam documentos por APIs. APIs de comunicação entre ambientes de municípios, empresas e ADN. Empresas com software próprio podem emitir e baixar parâmetros municipais. Fonte: Portal da NFS-e (gov.br/nfse).
Nomes de serviço e autorizadores variam por versão e por estado. Confirme sempre no portal oficial vigente antes de parametrizar.
A camada fiscal da integração em quatro passos
O trabalho é sempre na camada fiscal. O desenho técnico e a programação continuam com quem integra o projeto.
Inventário
Listar cada interface que toca o fiscal: destino, documento, frequência, responsável e dono do dado.
Contrato fiscal
Para cada interface, registrar campos obrigatórios, origem do dado, regra aplicada e tratamento de rejeição.
Cenários de teste
Montar casos reais de operação, rejeição, contingência e cancelamento, e validar o valor e o status, não só a execução.
Evidência
Definir o que fica guardado como prova (XML, protocolo, evento) e por quanto tempo, com acesso para auditoria.
Seis decisões fiscais que toda integração precisa ter
Seis perguntas que o time fiscal deveria conseguir responder, interface por interface. Se alguma resposta é "não sei" ou "depende da pessoa", há um risco de operação, de auditoria e de continuidade que merece atenção antes da próxima mudança.
Campos e origem
Para cada campo obrigatório do documento, de onde ele vem no SAP e quem mantém o dado. Campo sem dono vira rejeição.
Regra de cálculo
Qual regra produz cada valor e em que ponto da integração ela é aplicada. Regra duplicada em dois lugares diverge cedo ou tarde.
Tratamento de rejeição
O que o usuário vê, quem corrige, em quanto tempo e como o documento é reenviado sem duplicar.
Contingência e retorno
Quando o SAP muda de destino, como registra o fato e como regulariza depois.
Eventos e cancelamento
Como cada evento volta ao SAP e atualiza o documento.
Prova e retenção
Que arquivos ficam guardados, onde, por quanto tempo e quem acessa.
Eventos de fornecedores e entrada de notas: veja entrada automática de NF-e, CT-e e eventos.
Customização: só o recorte fiscal
A DFSpro não desenvolve programas ABAP nem constrói interfaces. A fronteira é esta.
O que a camada fiscal faz
- Confere se a regra implementada é a regra fiscal correta e vigente.
- Verifica se o dado de entrada está completo e vem da origem certa.
- Valida o valor calculado em cenários reais da operação.
- Registra a decisão de manter, substituir por padrão ou aposentar.
O que fica com o time técnico
- Qualidade, desempenho e segurança do código.
- Arquitetura de integração e escolha da plataforma.
- Desenvolvimento e manutenção de interfaces e programas.
- Decisões gerais de extensibilidade do S/4HANA.
A classificação de extensões em níveis A a D está em Clean Core fiscal. Toda interface fiscal é também uma extensão a inventariar.
Quando a integração fiscal pede uma segunda leitura
Qualquer um desses pontos, sozinho, já justifica uma revisão antes da próxima atualização ou migração. Quanto mais cedo a falha é percebida, menor é o número de notas já emitidas com problema e mais simples é a correção.
- O endereço do autorizador está fixo no desenho, sem considerar estado emitente e contingência.
- A mesma regra de imposto existe no ERP e na camada de integração, com resultados diferentes.
- Rejeições são corrigidas por quem não conhece a regra fiscal, e ninguém registra a causa.
- Não há cenário de teste de contingência nem de cancelamento.
- Ninguém sabe dizer quais interfaces tocam o fiscal.
- O XML autorizado fica em um único lugar e sem acesso pela auditoria.
Onde este tema se conecta
Documentos fiscais eletrônicos
Emissão e recepção de documentos eletrônicos. Ver página.
Entrada automática e eventos
Recepção de documentos de fornecedores e tratamento de eventos. Ver página.
Clean Core fiscal
Como classificar e manter extensões fiscais. Ver página.
Fontes consultadas
- SAP Help Portal: What is SAP Integration Suite?
- SAP Help Portal: What Is SAP Cloud Integration?
- SAP Help Portal: SAP Business Technology Platform
- Portal Nacional da NF-e: Relação de Serviços Web
- Portal da NFS-e: API de integração
Consulta em 13/10/2026. Páginas oficiais mudam; confirme na fonte antes de decidir.
Perguntas para o seu projeto
01O que é integração fiscal no SAP?+
É a troca de dados e documentos entre o SAP e quem participa da operação fiscal: autorizadores da NF-e, ambiente nacional da NFS-e, parceiros de negócio e sistemas internos. O que a torna fiscal é o conteúdo que trafega e a responsabilidade pelo resultado, não a tecnologia usada.
02Qual a diferença entre SAP BTP e SAP Integration Suite?+
Segundo a documentação da SAP, a SAP BTP (SAP Business Technology Platform) é a plataforma que reúne desenvolvimento de aplicações, automação, integração, dados e inteligência artificial. O SAP Integration Suite é o conjunto de capacidades de integração dentro dela.
03O Cloud Integration é vendido separado do Integration Suite?+
Não. A documentação do Cloud Integration informa que ele faz parte do plano de serviço do Integration Suite e não está disponível separadamente.
04Toda empresa precisa de Integration Suite para emitir NF-e?+
Não necessariamente. O caminho depende da solução fiscal adotada e da arquitetura do projeto. Essa escolha é do integrador e do time técnico. O papel da camada fiscal é dizer o que cada caminho precisa entregar.
05Quais serviços os autorizadores da NF-e oferecem?+
O portal nacional da NF-e lista, por autorizador, serviços na versão 4.00 como NFeAutorizacao, NFeRetAutorizacao, RecepcaoEvento, NfeConsultaProtocolo, NfeStatusServico, NfeInutilizacao e NfeConsultaCadastro.
06O que muda quando o autorizador do estado é virtual?+
O portal informa que alguns estados usam a SEFAZ Virtual (SVAN ou SVRS) para os serviços da NF-e. Para a integração, isso significa que o endereço de destino depende do estado do emitente e deve estar parametrizado, não fixo no desenho.
07E a contingência?+
O portal lista os autorizadores de contingência (SVC-AN e SVC-RS) e quais estados usam cada um. Uma integração fiscal madura define quando e como o SAP muda de destino e como regulariza depois.
08Como a NFS-e padrão nacional entra nesse assunto?+
Segundo o portal da NFS-e, as APIs fazem a comunicação entre os ambientes de dados dos municípios, das empresas e dos entes conveniados com o Ambiente de Dados Nacional (ADN). O panorama dos documentos eletrônicos está em Documentos fiscais eletrônicos no SAP.
09A DFSpro desenvolve interfaces ou programas ABAP?+
Não. Desenho técnico e programação ficam com o integrador e com a equipe do cliente. A DFSpro atua na camada fiscal: regra, dado e resultado do cálculo, e a definição do que a integração precisa entregar.
10Qual o recorte fiscal de uma extensão em ABAP?+
Verificar se a regra implementada é a regra fiscal correta, se o dado de entrada está completo e se o valor calculado confere com o cenário real. Revisar o código em si cabe ao time técnico.
11Como evitar que a integração quebre na atualização do SAP?+
Inventariando as interfaces fiscais, classificando-as conforme o modelo de Clean Core e testando o resultado fiscal a cada atualização. A página de Clean Core fiscal detalha esse modelo.
12Como a integração se relaciona com a entrada de notas de fornecedores?+
A recepção de documentos de fornecedores e o tratamento de eventos têm página própria: entrada automática de NF-e, CT-e e eventos.
Saiba o que sua integração fiscal entrega hoje
O Diagnóstico Fiscal SAP inventaria as interfaces que tocam o fiscal e mostra onde a regra, o dado ou a prova estão frágeis.