Conectar o SAP S/4HANA: receber pedidos de venda e clientes

Insira a URL base OData do S/4HANA, adicione um conjunto completo de credenciais (usuário de comunicação Basic ou o trio OAuth2), depois teste, mapeie e ative para receber pedidos de venda e clientes.

O conector do SAP S/4HANA traz pedidos de venda e clientes do seu sistema S/4HANA para o Integration pelos serviços OData. Há duas formas de autenticação: um usuário de comunicação Basic ou credenciais de cliente OAuth2; preencha um único conjunto, não os dois. Esta conexão não sincroniza estoque: o estoque do S/4HANA não entra nem é devolvido por ela.

Pré-requisitos#

• Um sistema SAP S/4HANA, na nuvem ou local, com o qual você tenha permissão para integrar.
• Apoio da sua equipe Basis ou de administração do SAP: eles fornecerão a URL base OData e prepararão o usuário de comunicação ou o cliente OAuth2.
• O serviço OData de pedidos de venda (API_SALES_ORDER_SRV) ativado no seu sistema S/4HANA. Se ainda não estiver, o administrador do SAP pode ativá-lo com /IWFND/MAINT_SERVICE.
• Decida qual método de acesso usará: Basic (usuário + senha) ou OAuth2 (Client ID + Client Secret + Token URL). Só é preciso um conjunto completo.

Obter credenciais#

1. URL base: peça à sua equipe Basis o endereço base OData do seu sistema S/4HANA, ou obtenha-o do seu destino BTP, se usar um. Tem a forma https://s4hana.example.com:44300. Não há um valor universal: os endereços na nuvem e locais diferem, então nunca copie o endereço de outro sistema.
2. Conjunto Basic (opção A): peça ao administrador do SAP para criar ou confirmar um usuário de comunicação no S/4HANA e anote o usuário e a senha. O usuário de comunicação é a conta que o S/4HANA reserva para acesso entre sistemas; não use um usuário pessoal.
3. Conjunto OAuth2 (opção B), na nuvem: obtenha Client ID, Client Secret e Token URL na chave de serviço da sua instância de integração no SAP BTP.
4. Conjunto OAuth2 (opção B), local: obtenha Client ID e Client Secret na sua configuração de cliente OAuth e copie a Token URL dessa mesma configuração. A Token URL não tem um valor padrão que se possa adivinhar: copie-a sempre do seu próprio sistema ou chave de serviço.
5. Cliente SAP: se o seu sistema usa um número de cliente SAP (por exemplo 100), anote-o também. Ele é enviado com cada solicitação como parâmetro sap-client. Se a equipe Basis disser que não é necessário, pode omiti-lo.

Preencher no Integration#

1. Abra Integration → Marketplace → SAP S/4HANA → Nova conexão.
2. base_url (obrigatório): o endereço base OData do seu sistema S/4HANA, por exemplo https://s4hana.example.com:44300. É o único campo sempre obrigatório.
3. sap_client (opcional): seu número de cliente SAP, por exemplo 100. Deixe em branco se o seu sistema não o usar.
4. username (conjunto Basic): o usuário do usuário de comunicação no S/4HANA. Preencha só se escolheu o conjunto Basic, e sempre junto com password.
5. password (conjunto Basic): a senha desse usuário de comunicação. Fica armazenada criptografada e nunca é exibida de novo.
6. client_id (conjunto OAuth2): o Client ID do OAuth2, da chave de serviço do BTP na nuvem ou da sua configuração de cliente OAuth local; costuma começar com sb-. Preencha só se escolheu o conjunto OAuth2, junto com client_secret e token_url.
7. client_secret (conjunto OAuth2): o Client Secret do OAuth2 correspondente a esse Client ID. Fica armazenado criptografado e nunca é exibido de novo.
8. token_url (conjunto OAuth2): a Token URL do OAuth2, na forma https://…/oauth/token. Copie-a da sua chave de serviço do BTP (nuvem) ou da sua configuração de cliente OAuth (local); não a digite de memória.

Testar a conexão#

O teste primeiro verifica se base_url está preenchido e se há exatamente um conjunto de credenciais completo; um conjunto incompleto falha de imediato e o erro lista as duas combinações válidas (username + password, ou client_id + client_secret + token_url). Com o conjunto OAuth2, o teste primeiro troca suas credenciais por um token de acesso na token_url; com o conjunto Basic, entra diretamente. Depois lê a descrição do serviço OData de pedidos de venda: GET {base_url}/sap/opu/odata/sap/API_SALES_ORDER_SRV/$metadata, com o parâmetro sap-client se você preencheu sap_client. Um resultado OK dentro do limite de 12 segundos significa que o endereço, o acesso e o serviço funcionam. Cada falha tem seu próprio código e próximo passo: veja as perguntas frequentes.

Mapping / escolher modelo#

Escolha o modelo padrão do SAP S/4HANA para pedidos de venda. Antes de ativar, use a prévia com um pedido de venda real e confira se o número do pedido, o cliente e as linhas caem nos campos padrão corretos. Os clientes trazidos do S/4HANA mantêm os identificadores do seu sistema SAP, para que cada pedido seja vinculado ao seu cliente. Se um campo importante cair no lugar errado, ajuste o mapping e visualize de novo; não ative com um mapping não conferido.

Ativar#

Após ativar, o Integration traz pedidos de venda e clientes novos e alterados do S/4HANA na frequência definida. Nada é devolvido ao S/4HANA por esta conexão, e o estoque não é sincronizado em nenhum sentido: continue gerenciando-o como hoje. Acompanhe os primeiros pedidos em Runs / Logs e confirme que cada um corresponde ao seu pedido de venda no S/4HANA antes de deixar a conexão sem supervisão.

Perguntas frequentes#

O teste falha com 404: SERVICE_NOT_ACTIVATED

Aqui, um 404 não significa que o endereço esteja errado. Significa que o serviço OData de pedidos de venda (API_SALES_ORDER_SRV) ainda não está ativado no seu sistema S/4HANA, então não há nada respondendo naquele endereço de serviço.

Peça ao administrador do SAP para ativar o serviço API_SALES_ORDER_SRV no S/4HANA com /IWFND/MAINT_SERVICE e execute o teste de novo. Não altere base_url por causa deste erro.

O teste falha com 401: INVALID_CREDENTIALS

O S/4HANA rejeitou o acesso: o usuário ou a senha do usuário de comunicação estão incorretos, ou o Client ID / Client Secret do OAuth2 não corresponde, ou a troca de token na token_url não os aceitou.

Copie de novo as credenciais do conjunto escolhido a partir da origem (o usuário de comunicação no S/4HANA, ou a chave de serviço do BTP / a configuração do cliente OAuth), cuidando de espaços no início ou no fim, e teste novamente.

O teste falha com 403: MISSING_SCOPE

O acesso funcionou, mas a conta não tem permissão para usar o serviço de pedidos de venda: faltam permissões ao usuário de comunicação, ou o cenário de comunicação desta integração não está configurado no S/4HANA.

Peça ao administrador do SAP para verificar as permissões do usuário de comunicação e a configuração do cenário de comunicação do serviço de pedidos de venda, e teste de novo. Trocar a senha não corrige um 403.

O teste diz que as credenciais estão incompletas

Só parte de um conjunto foi preenchida: por exemplo, username sem password, ou client_id e client_secret sem token_url. O teste precisa de um conjunto completo e para antes mesmo de tentar o acesso.

Decida um conjunto e preencha todos os seus campos: username + password para Basic, ou client_id + client_secret + token_url para OAuth2. Limpe os campos do outro conjunto para não ficar nada pela metade.

Esta conexão pode sincronizar o estoque com o S/4HANA?

Não. Esta conexão traz apenas pedidos de venda e clientes: o estoque do S/4HANA não é importado e as mudanças de estoque não são devolvidas. Continue gerenciando o estoque nos sistemas que usa hoje e não baseie os níveis de estoque no OMS nesta conexão.

Por esta conexão circulam apenas dois tipos de registro: pedidos de venda e clientes. Os registros de produto também não fluem, então mantenha seu catálogo de produtos e seus números de estoque como faz hoje.