Preparação do SAP S/4HANA Private
Introdução
Este artigo mostra o que preparar no SAP S/4HANA Private Edition do cliente para o Invent Apps se conectar ao SAP e automatizar o recebimento de documentos fiscais de entrada. Não é preciso conhecer o Invent Apps nem ser especialista em integração SAP.
O Invent Apps recebe o XML do documento fiscal do fornecedor (NF-e, CT-e ou NFS-e), encontra o pedido de compra correspondente no SAP e registra automaticamente as etapas de recebimento: entrada de mercadoria ou registro de serviço, fatura do fornecedor e nota fiscal. Quando não existe pedido, ele também pode criar o pedido de compra. O módulo Master Data mantém os cadastros de parceiros e itens sincronizados a partir do SAP (veja Sincronização de cadastros).
No SAP S/4HANA Public Edition, a liberação de APIs é feita por um pacote pronto chamado Communication Arrangement. No SAP S/4HANA Private Edition, inclusive quando contratado via RISE with SAP, as APIs que o Invent Apps usa não têm esse pacote pronto. A liberação é feita do jeito clássico: ativar cada serviço no SAP Gateway, criar um usuário técnico e dar a ele um perfil de acesso (role).
Se o cliente usa o Public Edition, siga a Preparação do SAP S/4HANA Cloud.
Público:
| Quem | O que faz com este artigo |
|---|---|
| Parceiro SAP (Basis e Segurança) | Executa a preparação: ativação das APIs, usuário técnico e perfil de acesso, autenticação e rede, endereço e certificado. |
| Parceiro SAP (MM e Fiscal) | Lê Como funciona, Campos customizados e Decisão fiscal e toma as decisões de processo: campos da chave de acesso, tipo de nota fiscal e modelo de serviços. |
| Consultor Invent Software | Conduz o alinhamento com o parceiro e confere o checklist antes do teste de conexão. |
Conceitos
| Termo | O que significa na prática |
|---|---|
| SAP S/4HANA Public Edition | ERP da SAP em nuvem compartilhada, com atualizações automáticas e configuração padronizada. Endereço típico: myXXXXXX.s4hana.cloud.sap. |
| SAP S/4HANA Private Edition | ERP da SAP em nuvem dedicada ao cliente, com o mesmo código do S/4HANA tradicional (on-premise). Permite transações clássicas como SU01, PFCG e /IWFND/MAINT_SERVICE. |
| RISE with SAP | Não é um produto técnico, é um contrato: junta licença, infraestrutura, operação pela SAP (equipe SAP ECS) e créditos de BTP. Se o RISE for com Private Edition, tudo deste artigo vale. A diferença é que algumas tarefas de infraestrutura podem exigir chamado na SAP ECS. |
| API | Porta de entrada padronizada para outro sistema ler ou gravar dados no SAP sem usar a tela. Cada API cuida de um objeto: pedido de compra, fatura, nota fiscal. |
| OData V2 e OData V4 | Duas versões do protocolo usado pelas APIs. Para o parceiro, a diferença que importa é onde ativar: V2 em /IWFND/MAINT_SERVICE, V4 em /IWFND/V4_ADMIN. |
| Communication Arrangement | Pacote pronto de liberação usado no Public Edition. No Private, não é usado para as APIs padrão. |
| Ativação clássica | Forma de liberar APIs no Private: ativar o serviço no Gateway, com alias de sistema LOCAL, e autorizar um usuário. |
| Usuário técnico | Usuário do tipo Sistema (não é uma pessoa), exclusivo para a integração. Não faz login em tela e não expira por inatividade. |
| Role (PFCG) | Perfil de acesso que define o que o usuário técnico pode fazer: quais APIs chamar e em quais empresas, centros e locais de negócio. |
| Mandante (client) | Divisão lógica do sistema SAP (por exemplo, 100 ou 300). O Invent Apps sempre conversa com o mandante padrão do endereço configurado. |
| Chave de acesso | Número de 44 dígitos que identifica uma NF-e ou um CT-e. O Invent Apps grava essa chave no SAP para evitar lançamento em duplicidade. |
Como funciona
Cada tipo de documento fiscal segue um caminho no SAP. Todos começam pelo mesmo passo: o Invent Apps lê o pedido de compra para vincular a nota a ele.
NF-e de material (modelo 55)
- O fornecedor emite a NF-e e o Invent Apps captura o XML.
- O Invent Apps identifica o fornecedor pelo CNPJ (API de Parceiro de Negócio) e consulta o pedido de compra (API de Pedido de Compra).
- Registra a entrada de mercadoria com referência ao pedido, equivalente à transação
MIGO(API de Documento de Material). - Registra a fatura do fornecedor com referência ao pedido, equivalente à transação
MIRO(API de Fatura de Fornecedor). - A nota fiscal fica registrada no SAP (equivalente à
J1BNFE), vinculada aos documentos anteriores. Veja a Decisão fiscal.
CT-e de frete (modelo 57)
O frete pode estar no SAP de duas formas, e o parceiro MM precisa informar qual delas o cliente usa:
- Frete previsto no pedido do material (custo de entrega planejado): o CT-e é lançado como fatura com referência ao pedido do material, na parte de custos de frete.
- Pedido de compra específico de frete (pedido de serviço): o Invent Apps lança a fatura com referência a esse pedido, com ou sem folha de registro de serviço (veja Folha de serviço).
NFS-e e serviços em geral
- O Invent Apps consulta o pedido de compra de serviço.
- Somente se o cliente exigir folha de serviço para aquele item, registra a folha de registro de serviço (equivalente à
ML81N, ou ao app de folha de serviço do modelo Lean Services). - Registra a fatura do fornecedor com referência à folha de serviço ou, quando não houver folha, direto ao pedido.
Nota sem pedido
Quando a regra do cliente permitir, o Invent Apps cria o pedido de compra pela API de Pedido de Compra e segue o fluxo correspondente acima.
Folha de serviço, conforme a política do cliente
A folha de registro de serviço faz, para serviços, o papel da entrada de mercadoria: confirma que o serviço foi prestado antes de a fatura ser lançada. O SAP, no Public e no Private, permite trabalhar com ou sem folha, item a item do pedido. O Invent Apps suporta os dois caminhos.
| Caminho | Quando costuma ser usado | O que o cliente ganha ou abre mão |
|---|---|---|
| Com folha (pedido, folha e fatura) | Serviços medidos, de valor variável, por etapa ou que exigem aceite do solicitante (obras, consultoria, manutenção) | Ganha confirmação de quem recebeu o serviço, conferência em três vias, despesa no mês da prestação e trilha de auditoria. Se houver aprovação na folha, a fatura espera o aceite do gestor. |
| Direto (pedido e fatura) | Serviços recorrentes de valor fixo (aluguel, licenças, limpeza, segurança) e frete | Fluxo mais simples e rápido. Abre mão da confirmação de recebimento, e a despesa só é registrada quando a fatura é lançada. |
O SAP decide o caminho pelo indicador de entrada de mercadoria (recebimento) no item do pedido de compra. Com o indicador marcado, a fatura exige folha. Desmarcado, a fatura é lançada direto contra o pedido. A definição por tipo de serviço cabe à controladoria do cliente.
Materiais controlados em estoque ficam fora dessa escolha: para eles, a entrada de mercadoria (MIGO) é sempre obrigatória antes da fatura.
Sincronização de cadastros (Master Data)
Além do recebimento de notas, o módulo Master Data do Invent Apps consulta o SAP periodicamente e inclui ou atualiza no Invent Apps os parceiros de negócio (fornecedores e clientes) e os itens (materiais e serviços).
| Tema | Como funciona |
|---|---|
| O que é lido | Parceiros de negócio pela API API_BUSINESS_PARTNER (dados gerais, CNPJ ou CPF, inscrições, endereço, dados de fornecedor e cliente) e itens pela API PRODUCT_0002 (descrição, tipo, unidade, NCM, origem e utilização por centro). |
| Somente leitura | Nesta fase, o Invent Apps não cria nem altera parceiros ou itens no SAP. |
| Carga inicial | Na ativação, o Invent Apps lê todo o cadastro do escopo, em lotes. Informe a quantidade aproximada de parceiros e itens e a melhor janela de horário para essa carga. |
| Atualização contínua | Depois da carga, o Invent Apps consulta periodicamente só o que foi criado ou alterado, pela data de alteração do cadastro, e faz reconciliações completas de tempos em tempos. |
| Acesso necessário | A role do usuário técnico precisa permitir leitura de todos os parceiros (fornecedores e, se o Master Data cobrir, clientes) e de todos os materiais das empresas e centros desse escopo (veja perfil de acesso). |
| Serviços | Se os serviços estiverem cadastrados como produto do tipo serviço, a API de Produto cobre. Se o cliente usar o cadastro clássico de serviços (transação AC03), a SAP não oferece API liberada para ele no Private. Nesse caso, combine com a Invent uma alternativa: API customizada do cliente ou uso apenas da descrição do item do pedido. |
APIs que precisam ser liberadas
O Invent Apps usa as APIs abaixo. Todas são oficiais da SAP, liberadas (released) para o S/4HANA Private Edition e com status ativo no catálogo da SAP.
| # | Nome técnico | Para que o Invent Apps usa | Protocolo e onde ativar | Usada em |
|---|---|---|---|---|
| 1 | PURCHASEORDER_0001 (grupo de serviço API_PURCHASEORDER_2) | Consultar pedidos para vincular à nota; criar e alterar pedidos quando necessário | OData V4, /IWFND/V4_ADMIN | Todos |
| 2 | API_BUSINESS_PARTNER | Localizar o fornecedor pelo CNPJ e sincronizar o cadastro de parceiros no Master Data (somente leitura) | OData V2, /IWFND/MAINT_SERVICE | Todos |
| 3 | API_MATERIAL_DOCUMENT_SRV | Registrar a entrada de mercadoria (MIGO) com referência ao pedido e estornar, se necessário | OData V2, /IWFND/MAINT_SERVICE | NF-e |
| 4 | API_SUPPLIERINVOICE_PROCESS_SRV | Registrar a fatura do fornecedor (MIRO) com referência a pedido, entrada ou folha de serviço, e estornar | OData V2, /IWFND/MAINT_SERVICE | Todos |
| 5 | API_SERVICE_ENTRY_SHEET_SRV ou SERVICEENTRYSHEET_0001 | Registrar a folha de registro de serviço antes da fatura. Só é necessária se o cliente usar folha | V2 em /IWFND/MAINT_SERVICE ou V4 em /IWFND/V4_ADMIN | Serviços e frete com folha |
| 6 | API_LOGBR_NOTAFISCAL_SRV | Criar e completar a nota fiscal Brasil (tipo, modelo, número, série, protocolo, CFOP, NCM) | OData V2, /IWFND/MAINT_SERVICE | Todos |
| 7 | PRODUCT_0002 (grupo de serviço API_PRODUCT) | Conferir material, NCM e origem, e sincronizar o cadastro de itens no Master Data (somente leitura) | OData V4, /IWFND/V4_ADMIN | NF-e |
| 8 | API_COMPANYCODE_SRV | Validar a empresa (somente leitura) | OData V2, /IWFND/MAINT_SERVICE | Todos |
Pedido de compra: use a API V4 PURCHASEORDER_0001. A API V2 antiga API_PURCHASEORDER_PROCESS_SRV está descontinuada pela SAP no Private Edition e não deve ser ativada.
Folha de serviço (API 5): ative só se o cliente usar folha de serviço em algum tipo de serviço (veja Folha de serviço). Nesse caso, escolha a versão compatível com o modelo de compra de serviços: no modelo clássico (ML81N), API_SERVICE_ENTRY_SHEET_SRV; no modelo Lean Services, SERVICEENTRYSHEET_0001. Na dúvida, o consultor MM do parceiro confirma.
Ativar as APIs no SAP Gateway
Tempo estimado: 1 a 2 horas de trabalho de Basis. Execute primeiro no ambiente de desenvolvimento ou qualidade e depois repita, ou transporte, para produção.
Passo 1: conferir a versão do sistema
- No SAP GUI, abra Sistema > Status e anote a versão do S/4HANA e o pacote de funcionalidades (Feature Package Stack, FPS).
- A lista de APIs deste artigo foi montada a partir do catálogo da release 2025 FPS01. Se o sistema for de release anterior, confirme cada API no SAP Business Accelerator Hub (api.sap.com), escolhendo a release do cliente na página da API.
Passo 2: ativar as APIs OData V2
Vale para as APIs 2, 3, 4, 6, 8 e, se for o caso, a 5 na versão V2.
- Execute a transação
/IWFND/MAINT_SERVICE. - Clique em Adicionar serviço (Add Service).
- Em Alias do sistema (System Alias), informe
LOCAL. Se o aliasLOCALnão existir, crie-o antes na mesma transação (botão Add System Alias). - Em Nome técnico do serviço externo (External Service Name), informe o nome da API, por exemplo
API_BUSINESS_PARTNER, e clique em Obter serviços (Get Services). - Selecione o serviço encontrado e clique em Adicionar serviços selecionados (Add Selected Services). Aceite o pacote sugerido ou informe o pacote de transporte do projeto.
- Volte à tela inicial da transação, localize o serviço na lista e confirme que o nó ICF está ativo (semáforo verde) e que o alias
LOCALaparece em System Aliases. - Repita para cada API V2 da tabela.
Passo 3: publicar as APIs OData V4
Vale para as APIs 1, 7 e, se for o caso, a 5 na versão V4.
- Execute a transação
/IWFND/V4_ADMIN. - Clique em Publicar grupos de serviço (Publish Service Groups).
- Informe o alias de sistema
LOCALe clique em Obter grupos de serviço (Get Service Groups). - Selecione o grupo
API_PURCHASEORDER_2e clique em Publicar grupos de serviço. Informe o pacote de transporte, se for pedido. - Repita para o grupo
API_PRODUCTe, se aplicável, para o grupo da folha de serviço V4 indicado na documentação da API.
Passo 4: testar se o serviço responde
- Execute a transação
/IWFND/GW_CLIENT(SAP Gateway Client). - Faça uma chamada
GETem/sap/opu/odata/sap/API_BUSINESS_PARTNER/$metadata. - Confira o resultado: código
200com um XML que descreve o serviço. - Repita para as demais APIs trocando o nome no caminho. Para as V4, o caminho segue o padrão
/sap/opu/odata4/sap/api_purchaseorder_2/srvd_a2x/sap/purchaseorder/0001/$metadata.
Usuário técnico e perfil de acesso
Passo 5: criar o usuário técnico
- Execute a transação
SU01e crie o usuário. Sugestão de nome:INVENT_APPS. - Na aba Dados de logon, escolha o tipo de usuário Sistema (tipo B). Esse tipo não faz login em tela e não é bloqueado por troca periódica de senha.
- Defina uma senha forte, conforme a política de segurança do cliente.
Não use o usuário de uma pessoa. Se ela sair da empresa ou trocar a senha, a integração para.
Nunca envie a senha por e-mail, chat ou junto com o checklist. Combine com o consultor Invent um canal seguro (cofre de senhas ou link de uso único). Na Invent, a credencial fica guardada em cofre de segredos e não aparece em telas nem em registros do sistema.
Passo 6: criar o perfil de acesso (role)
- Execute a transação
PFCGe crie uma role individual. Sugestão de nome:Z_INVENT_APPS_INTEGRACAO. - Na aba Menu, adicione cada serviço ativado: Inserir > Autorização padrão > Serviço (Authorization Default), escolha o tipo SAP Gateway Business Suite Enablement - Service e selecione os serviços. Isso gera automaticamente a autorização
S_SERVICEde cada API. - Na aba Autorizações, complete os objetos de negócio da tabela abaixo, sempre restritos às empresas, centros e locais de negócio do projeto. Para leitura de parceiros e itens, o escopo é o do Master Data, normalmente mais amplo que o dos lançamentos.
- Gere o perfil e atribua a role ao usuário técnico (aba Usuário, depois Comparação de usuário).
| Área | Objetos de autorização de referência | Atividades |
|---|---|---|
| Pedido de compra | M_BEST_BSA, M_BEST_EKO, M_BEST_EKG, M_BEST_WRK | Exibir; criar e alterar, se o cliente usar a criação de pedido |
| Entrada de mercadoria | M_MSEG_BWE, M_MSEG_WWE | Criar e exibir (tipo de movimento 101 e estorno 102) |
| Fatura do fornecedor | M_RECH_BUK, M_RECH_WRK | Criar, exibir, lançar e estornar |
| Folha de registro de serviço (se usada) | Objetos da transação ML81N ou do app de folha de serviço (Lean Services) | Criar e exibir |
| Nota fiscal Brasil | Objetos das transações J1BNFE e J1B1N (Nota Fiscal Writer) | Criar, alterar e exibir |
| Parceiro de negócio, fornecedor e cliente | B_BUPA_RLT, B_BUPA_GRP, F_LFA1_BUK, F_KNA1_BUK (cliente, se o Master Data cobrir clientes) | Somente exibir, para todos os grupos de parceiros do escopo do Master Data |
| Material, serviço e empresa | M_MATE_STA, M_MATE_WRK, M_MATE_BUK (dados de avaliação: origem e utilização), F_BKPF_BUK | Somente exibir, para todos os centros e empresas do escopo do Master Data |
A tabela é uma referência inicial para acelerar o trabalho. A definição final é do time de Segurança do cliente, que pode usar o rastreio de autorização (STAUTHTRACE) durante o teste para reduzir a role ao mínimo necessário.
Autenticação
Autenticação é como o Invent Apps prova ao SAP quem está chamando as APIs. O S/4HANA Private Edition aceita três formas:
| Forma | Como funciona | Uso pelo Invent Apps |
|---|---|---|
| Usuário e senha (Basic Authentication) | A cada chamada, o Invent Apps envia o usuário técnico e a senha por um canal criptografado (HTTPS). | Forma adotada. É a suportada pelo Invent Apps hoje para o Private Edition. |
| Certificado digital (X.509) | O Invent Apps apresenta um certificado digital, e o SAP associa esse certificado ao usuário técnico. Dispensa senha. | Evolução prevista. Quando estiver disponível, a Invent comunica e fornece o certificado. |
| OAuth 2.0 (Authorization Code) | Fluxo em que uma pessoa autoriza o acesso numa tela de login. | Não se aplica: foi pensado para usuários humanos, não para integração entre sistemas. |
A senha do usuário técnico só trafega sobre HTTPS. Se o cliente tiver política de troca periódica de senha para usuários de sistema, combine a data com o consultor Invent, para atualizar a credencial no Invent Apps no mesmo dia.
Rede, endereço e certificado HTTPS
O Invent Apps roda em nuvem (AWS). Para chamar as APIs, ele precisa alcançar o SAP do cliente pela internet, de forma controlada. Requisitos do lado do SAP:
| Requisito | O que fazer | Por quê |
|---|---|---|
| Endereço HTTPS acessível | Expor as APIs por um endereço HTTPS, normalmente pelo SAP Web Dispatcher (por exemplo, https://api-sap.cliente.com.br). Restringir o acesso aos IPs de saída do Invent Apps, que o consultor Invent informa. | O Invent Apps precisa alcançar o SAP a partir da nuvem. |
| Certificado de autoridade pública | O certificado HTTPS desse endereço deve ser emitido por uma autoridade certificadora pública reconhecida, não por uma autoridade interna da empresa. | O Invent Apps valida o certificado do servidor e recusa certificados que não consegue verificar. |
| Mandante padrão | Configurar o endereço para cair direto no mandante produtivo (mandante padrão do serviço ICF ou regra no Web Dispatcher). | O Invent Apps não informa o mandante na chamada: usa o mandante padrão do endereço. |
| RISE with SAP | Se o contrato for RISE, abrir chamado na SAP ECS para a exposição do endereço, a liberação de IPs e o certificado, conforme a matriz de responsabilidades do contrato. | No RISE, a infraestrutura é operada pela SAP. |
Campos customizados da chave de acesso
Para não lançar a mesma nota duas vezes, o Invent Apps grava a chave de acesso nos documentos do SAP e a consulta antes de cada lançamento. As APIs padrão de entrada de mercadoria e de fatura não têm esse campo, então é preciso criar dois campos customizados.
- Abra o app Fiori Campos customizados (Custom Fields).
- Crie um campo de texto para a chave de acesso no contexto de negócio do item do documento de material (entrada de mercadoria).
- Crie outro campo de texto para a chave de acesso no contexto de negócio do cabeçalho da fatura de fornecedor.
- Use pelo menos 44 posições, porque a chave tem 44 dígitos.
- Nas abas Usos da UI e relatórios (UIs and Reports) e APIs do campo, habilite o uso nas APIs
API_MATERIAL_DOCUMENT_SRVeAPI_SUPPLIERINVOICE_PROCESS_SRV. - Publique os campos e anote o nome técnico gerado pelo SAP, que começa com
YY1_. Informe esses nomes à Invent.
Exemplo de nomes usados em outro cliente: YY1_ChavedeAcesso_MMI (entrada de mercadoria) e YY1_ChaveAcessoNF_MIH (fatura). Os nomes podem mudar de um cliente para outro, porque o Invent Apps permite configurar o nome por cliente.
Decisão fiscal: como o tipo de nota fiscal é preenchido
Quando alguém lança uma fatura na transação MIRO, informa o tipo de nota fiscal, e é isso que faz o SAP gerar a nota fiscal Brasil. A API de fatura de fornecedor (API_SUPPLIERINVOICE_PROCESS_SRV) não tem campo para o tipo de nota fiscal nem para a chave de acesso. Por isso, o consultor fiscal do parceiro precisa definir, junto com a Invent, como a nota fiscal será gerada quando a fatura vier pela API.
| Opção | Como funciona | Quando faz sentido |
|---|---|---|
| A. Tipo de NF preenchido automaticamente | O SAP propõe o tipo de nota fiscal por configuração ou extensão (BAdI) na entrada de mercadoria ou na fatura. O SAP gera a nota, e o Invent Apps completa número, série, protocolo e chave pela API de Nota Fiscal (API 6). | Quando o cliente já usa geração automática de nota fiscal no processo de compras. |
| B. Nota criada pela API de Nota Fiscal | O Invent Apps cria a nota fiscal pela API 6, com os itens referenciando o pedido. A entrada de mercadoria e a fatura continuam sendo lançadas pelas APIs 3 e 4, porque a API de nota fiscal sozinha não movimenta estoque nem gera contas a pagar. | Quando o cliente quer a nota fiscal com todos os dados do XML, sem depender de configuração de tipo de NF. |
| C. API customizada do cliente | O parceiro desenvolve um serviço próprio (ABAP Cloud) que faz o lançamento completo e o publica para o Invent Apps. | Quando o processo do cliente tem regras muito específicas. |
A escolha muda a sequência de chamadas que o Invent Apps faz no SAP. Ela deve ser fechada na reunião de alinhamento, antes da configuração do ambiente de testes.
Checklist do parceiro SAP
| Item | Responsável |
|---|---|
| Versão e FPS do sistema conferidos (passo 1) | Basis |
APIs V2 ativadas com alias LOCAL e nó ICF ativo (passo 2) | Basis |
Grupos V4 API_PURCHASEORDER_2 e API_PRODUCT publicados (passo 3) | Basis |
Teste de $metadata com código 200 em todas as APIs (passo 4) | Basis |
| Usuário técnico do tipo Sistema criado (passo 5) | Segurança |
| Role criada, restrita às empresas e centros do projeto, e atribuída ao usuário (passo 6) | Segurança |
| Endereço HTTPS exposto, com certificado de autoridade pública e IPs da Invent liberados (rede) | Basis ou SAP ECS |
| Endereço apontando para o mandante produtivo como padrão (rede) | Basis |
| Campos customizados da chave de acesso criados e liberados nas APIs (campos customizados) | MM ou key user |
| Escopo do Master Data definido: grupos de parceiros, empresas e centros, com volume e janela da carga inicial (Master Data) | MM e Basis |
Forma de cadastro dos serviços confirmada: produto do tipo serviço ou cadastro clássico AC03 (Master Data) | MM |
| Informado se o cliente usa SAP MDG para governança de cadastros | MM ou Dados Mestres |
| Política de folha de serviço definida por tipo de serviço: com folha ou direto (folha de serviço) | Controladoria e MM |
| Se houver folha: modelo confirmado (clássico ou Lean Services) e API 5 ativada (APIs) | MM e Basis |
| Forma de frete confirmada: no pedido do material ou pedido de frete (CT-e de frete) | MM |
| Decisão fiscal sobre o tipo de nota fiscal tomada (decisão fiscal) | Fiscal |
Informações para devolver à Invent
| Informação | Exemplo | Observação |
|---|---|---|
| Endereço base (URL) das APIs | https://api-sap.cliente.com.br | Sem caminho de serviço e sem parâmetros |
| Mandante | 300 | Deve ser o padrão do endereço |
| Versão e FPS do S/4HANA | S/4HANA 2023 FPS02 | Conforme o passo 1 |
| Edição e contrato | Private Edition via RISE | Define se há chamado na SAP ECS |
| Usuário técnico | INVENT_APPS | A senha vai por canal seguro, nunca junto |
| Nomes dos campos da chave de acesso | YY1_... (entrada) e YY1_... (fatura) | Veja campos customizados |
| Política de folha de serviço | Com folha para obras e consultoria; direto para aluguel e licenças | Por tipo de serviço |
| Modelo de folha de serviço (se houver folha) | Clássico ou Lean Services | Define a API 5 |
| Forma de frete | No pedido do material ou pedido de frete | Define o fluxo do CT-e |
| Decisão fiscal | Opção A, B ou C | Veja decisão fiscal |
| Escopo do Master Data | Grupos de parceiros, empresas e centros | Veja Master Data |
| Volume e janela da carga inicial | 12 mil parceiros, 30 mil itens; sábado à noite | Valores aproximados bastam |
| Forma de cadastro dos serviços | Produto do tipo serviço ou AC03 | Define se a API de Produto cobre os serviços |
| Uso de SAP MDG | Sim ou não | Influencia a futura criação de parceiros pelo Invent Apps |
| Contatos | Basis, Segurança, MM e Fiscal | Nome e e-mail de cada responsável |
Diagnóstico
O teste de conexão é feito no painel de acordos do Invent Apps, serviço por serviço. O teste é somente leitura e não grava nada no SAP. Só avance para os testes com documentos reais depois que todos os serviços estiverem disponíveis.
| Resultado | O que significa |
|---|---|
| Disponível | Pronto. |
| Falha de autenticação (401) | Usuário ou senha incorretos, ou usuário bloqueado. |
| Acesso negado (403) | Serviço não ativado ou role sem a autorização do serviço. |
| Inalcançável | Problema de rede, endereço ou certificado. |
Dúvidas frequentes
Por que não usar Communication Arrangement, como no Public?
Porque no Private Edition a SAP não entrega esse pacote pronto para as APIs padrão usadas pelo Invent Apps. A comparação da documentação oficial de cada API nas duas edições mostra isso: no Public, cada uma tem um cenário SAP_COM (por exemplo, SAP_COM_0008 para parceiro de negócio); no Private, essa informação não existe. O Communication Arrangement no Private existe só para cenários customizados.
Este artigo vale para quem contratou RISE with SAP?
Sim, quando o RISE é com Private Edition. A diferença é operacional: exposição de endereço, IPs e certificado podem exigir chamado na SAP ECS.
Posso usar um único usuário técnico para todas as APIs?
Sim, e é o recomendado para começar. Se a política do cliente exigir, dá para separar usuários por serviço: o Invent Apps aceita credenciais diferentes por serviço.
Posso ativar a API antiga de pedido de compra (V2)?
Não é recomendado. A API_PURCHASEORDER_PROCESS_SRV está descontinuada pela SAP no Private Edition. O Invent Apps usa a V4 PURCHASEORDER_0001.
A folha de serviço é obrigatória?
Não. É uma escolha de controle interno do cliente, feita item a item no pedido de compra. A folha traz confirmação do serviço prestado, conferência em três vias e despesa no mês certo. O lançamento direto (pedido e fatura) é mais simples e comum para serviços recorrentes de valor fixo e para frete. O Invent Apps suporta os dois caminhos.
O Invent Apps cria ou altera parceiros de negócio ou itens no SAP?
Não nesta fase. Para parceiros e itens, o Invent Apps só lê. A criação e a alteração de parceiros estão em estudo. Quando forem liberadas, a Invent comunica antes, e o parceiro SAP acrescenta à role as atividades de criar e alterar. Se o cliente usar SAP MDG, a gravação vai ter que passar pelo fluxo de aprovação do MDG.
O Invent Apps altera configuração do SAP?
Não. Ele só lê e grava documentos de negócio (pedido, entrada, folha de serviço, fatura e nota fiscal) dentro das permissões da role.
Quanto tempo leva a preparação?
A parte técnica (ativação, usuário e role) costuma levar menos de um dia. O que mais demora é a exposição de rede e as decisões de processo, principalmente a fiscal.
Referências oficiais
- SAP Business Accelerator Hub, pacote SAP S/4HANA (Private Edition), release 2025 FPS01: api.sap.com/package/S4HANAOPAPI.
- Páginas das APIs no mesmo portal (abas Overview, Configuration Details e Authentication Methods):
OP_API_BUSINESS_PARTNER_SRV,OP_PURCHASEORDER_0001,OP_API_MATERIAL_DOCUMENT_SRV,OP_API_SUPPLIERINVOICE_PROCESS_SRV,OP_API_LOGBR_NOTAFISCAL_SRV_0001,OP_PRODUCT_0002. - SAP Help Portal, Communication Arrangement in SAP S/4HANA On-Premise: help.sap.com/docs/SAP_DVO.
- SAP API Deprecation Policy: api.sap.com, seção Resources.
Em caso de dúvida, fale com o consultor Invent Software responsável pelo projeto.