As traduções são geradas por tradução automática. Em caso de conflito entre o conteúdo da tradução e da versão original em inglês, a versão em inglês prevalecerá.
# Integrações de carga de trabalho do SAP
Com as integrações de carga de trabalho do SAP, você pode realizar ações em vários sistemas SAP. Gerencie dados comerciais, inventário, materiais e processos de negócios. Essas integrações oferecem suporte somente à execução de ações e exigem o nível Amazon Quick Pro ou superior.
## O que é possível fazer
As integrações de carga de trabalho do SAP fornecem conectividade em nível corporativo para ajudá-lo a trabalhar com seus sistemas SAP.
**Conector de ação**
Execute ações nos sistemas SAP. Crie, atualize e gerencie dados comerciais, registros de inventário, informações sobre materiais e outras operações corporativas por meio do SAP APIs.
**Vários módulos SAP**
Support para cinco tipos diferentes de integração: lista de materiais, parceiro de negócios, estoque de materiais, documentos de inventário físico e Product Master.
## Antes de começar
Antes de configurar as integrações de carga de trabalho do SAP, verifique se você tem o seguinte:
+ Sistema SAP com módulos apropriados instalados e configurados.
+ Conta de usuário SAP com as permissões e autorizações necessárias.
+ Amazon Quick Author ou superior.
+ Conectividade de rede entre o Amazon Quick e seu sistema SAP.
## Prepare a configuração e a autenticação do sistema SAP
Antes de configurar a integração no Amazon Quick, prepare a configuração do sistema SAP e a autenticação do usuário. As integrações de carga de trabalho do SAP oferecem suporte a vários métodos de autenticação e exigem a configuração adequada do sistema.
### Métodos de autenticação
As integrações de carga de trabalho do SAP oferecem suporte a dois métodos de autenticação:
**OAuth 2.0 (recomendado)**
Método de autenticação segura para fluxos de trabalho automatizados. Requer OAuth configuração em seu sistema SAP.
**Parâmetros necessários:**
+ **ID do cliente - ID** OAuth do cliente SAP
+ **Segredo do cliente - Segredo** OAuth do cliente SAP
+ **URL do token** - ponto final do OAuth token (por exemplo,`https://hostname:port/sap/bc/sec/oauth2/token?sap-client=100`)
+ **URL do domínio** - endpoint da API do sistema SAP (por exemplo,`https://hostname:port/sap/opu/odata/sap/API_BUSINESS_PARTNER`)
**Autenticação básica**
Autenticação de nome de usuário e senha para acesso direto ao sistema SAP.
**Parâmetros necessários:**
+ **Nome de usuário - nome** de usuário do sistema SAP
+ **Senha - senha** do sistema SAP
+ **URL do domínio** - endpoint da API do sistema SAP
### Requisitos de configuração do sistema SAP
Antes de usar as integrações de carga de trabalho do SAP, certifique-se de que seu sistema SAP esteja configurado corretamente:
#### OAuth Configuração 2.0
Para autenticação OAuth 2.0:
+ Configurar o servidor OAuth de autorização com os escopos apropriados
+ Verifique se OAuth está habilitado para o serviço usando o código da transação `/IWFND/MAINT_SERVICE`
+ Consulte a documentação do SAP para obter a configuração OAuth 2.0 detalhada: [Guia de configuração OAuth 2.0](https://help.sap.com/docs/ABAP_PLATFORM_NEW/fd0fc52fd22b45f29d274a7f8236e768/cdb122d5b0784c77bf1bcce17f730e74.html)
#### Ativação da API SAP
Certifique-se de que os serviços de API SAP necessários estejam ativos:
+ Ative o serviço de API específico para o conector SAP escolhido
+ Verifique o status do serviço de API em seu sistema SAP
+ Consulte a documentação da SAP para ativação da API: [Guia de ativação do serviço de API da SAP](https://help.sap.com/doc/saphelp_nw75/7.5.5/en-US/1b/023c1cad774eeb8b85b25c86d94f87/frameset.htm)
### Tipos de integração de carga de trabalho SAP disponíveis
Escolha o tipo de integração SAP que atenda às suas necessidades comerciais e garanta que o módulo SAP correspondente esteja disponível em seu sistema.
**Lista de materiais da SAP**
Gerencie dados da lista de materiais, incluindo listas de componentes, quantidades e especificações de fabricação.
**Escopo exigido:** `ZAPI_BILL_OF_MATERIAL_SRV_0002`
**Parceiro de negócios da SAP**
Gerencie informações de parceiros de negócios, incluindo dados de clientes e fornecedores, detalhes de contato e gerenciamento de relacionamentos.
**Escopo exigido:** `ZAPI_BUSINESS_PARTNER_0001`
**Estoque de materiais SAP**
Acesse e gerencie os níveis de estoque de materiais, movimentos de estoque e informações do armazém.
**Escopo exigido:** `ZAPI_MATERIAL_STOCK_SRV_0001`
**Documentos de inventário físico SAP**
Crie e gerencie documentos de inventário físico, contagens de estoque e processos de reconciliação de estoque.
**Escopo exigido:** `ZAPI_MATERIAL_STOCK_SRV_0001`
**Mestre de produtos SAP**
Mantenha os dados principais do produto, incluindo especificações de materiais, classificações e hierarquias de produtos.
**Escopo exigido:** `ZAPI_PRODUCT_SRV_0001`
### Configuração da autenticação de carga de trabalho do SAP
Prepare as credenciais de autenticação de usuário do SAP e garanta as permissões adequadas de acesso ao sistema.
+ **URL do sistema SAP** - Obtenha a URL base ou o endereço do servidor para seu sistema SAP.
+ **Credenciais do usuário** - Crie ou identifique uma conta de usuário SAP com as permissões apropriadas.
+ **Permissões do sistema** - Certifique-se de que a conta do usuário tenha as autorizações SAP e os códigos de transação necessários para os módulos SAP específicos que você planeja integrar.
+ **Acesso à rede** - Verifique se seu sistema SAP está acessível a partir de conexões externas e se as regras de firewall permitem a integração.
## Configurar integrações SAP
Depois de preparar as credenciais de configuração e autenticação do sistema SAP, o processo de configuração é semelhante para todos os tipos de integração do SAP. Escolha entre OAuth 2.0 ou autenticação básica com base em seus requisitos de segurança.
1. No console do Amazon Quick, escolha **Integrações.**
1. Selecione um dos conectores SAP disponíveis:
+ **Lista de materiais da SAP**
+ **Parceiro de negócios da SAP**
+ **Estoque de materiais SAP**
+ **Documentos de inventário físico SAP**
+ **Mestre de produtos SAP**
1. Clique em **Adicionar** (mais o botão “\$1”).
1. Preencha o nome e a descrição da sua integração com o SAP.
1. Escolha o tipo de conexão para sua integração.
1. Configure a autenticação usando um dos métodos compatíveis:
1. **OAuth Configuração 2.0**
Para a autenticação OAuth 2.0, forneça:
+ **ID do cliente** - Seu ID de OAuth cliente SAP
+ **Segredo do cliente** - Seu segredo OAuth do cliente SAP
+ **URL do token - URL** do ponto final do OAuth token
+ **URL do domínio - URL** do endpoint da API do sistema SAP
1. **Configuração básica de autenticação**
Para a autenticação básica, forneça:
+ **Nome de usuário** - Seu nome de usuário do sistema SAP
+ **Senha** - Sua senha do sistema SAP
+ **URL do domínio - URL** do endpoint da API do sistema SAP
1. Selecione **Criar e continuar**.
1. Escolha usuários com os quais compartilhar a integração.
1. Clique em **Next**.
### Resultados esperados
Após a configuração bem-sucedida, sua integração de carga de trabalho do SAP aparece na lista de integrações e está disponível para uso nos fluxos de trabalho, automações e agentes de IA do Amazon Quick. Você pode realizar ações específicas do SAP diretamente do Amazon Quick usando as credenciais de autenticação configuradas.
## Operações disponíveis por tipo de conector
Cada conector de carga de trabalho SAP fornece operações específicas adaptadas ao seu domínio de negócios. Analise as operações disponíveis para o tipo de conector escolhido.
### Operações da lista de materiais da SAP
Operações disponíveis para gerenciar dados da lista de materiais:
+ **Obter item da BOM de materiais** - Recupera os detalhes da lista de materiais para materiais especificados
**ID da operação:** `getMaterialBOMItem`
**Ponto final:** `GET /MaterialBOMItem`
### Operações do SAP Business Partner
Operações disponíveis para gerenciar dados de parceiros de negócios:
+ **Obter parceiro de negócios** - recupera dados gerais do parceiro de negócios
**ID da operação:** `getBusinessPartner`
+ **Obter endereços de parceiros de negócios** - Recupera dados de endereços de parceiros comerciais
**ID da operação:** `getBusinessPartnerAddress`
+ **Obtenha funções de parceiro de negócios** - recupera dados da função de parceiro de negócios
**ID da operação:** `getBusinessPartnerRole`
+ **Obter parceiro de negócios por ID** - recupera dados do parceiro de negócios pelo número do parceiro de negócios
**ID da operação:** `getBusinessPartnerByID`
**Parâmetro obrigatório:** `BusinessPartner` (string, máximo de 10 caracteres)
+ **Obter função de parceiro de negócios por ID** - recupera dados da função de parceiro de negócios usando campos-chave
**ID da operação:** `getBusinessPartnerRoleByID`
**Parâmetros necessários:** `BusinessPartner` (string, máx. 10 caracteres), `BusinessPartnerRole` (string, máx. 6 caracteres)
### Operações do SAP Material Stock
Operações disponíveis para gerenciar dados de estoque de materiais:
+ **Obter estoque de material na conta** - recupera informações de estoque de material publicadas no modelo de conta
**ID da operação:** `getMaterialStockInAccount`
### Operações de documentos de inventário físico da SAP
Operações disponíveis para gerenciar documentos de inventário físico:
+ **Obter item de PhysInventory documento** - lê informações sobre itens de inventário físico
**ID da operação:** `getPhysInventoryDocItem`
### Operações do SAP Product Master
Operações disponíveis para gerenciar dados mestres do produto:
+ **Obter item mestre do produto** - Retorna os registros principais do produto
**ID da operação:** `getProductMaster`
+ **Obtenha dados da planta por material** - Retorna os dados da planta do registro mestre do produto
**ID da operação:** `getPlantDataByMaterial`
**Parâmetro obrigatório:** `Product` (string, máximo de 40 caracteres)
+ **Obtenha dados de planejamento de suprimentos por material** - Retorna dados de planejamento de suprimentos por número de produto e fábrica
**ID da operação:** `getSupplyPlanningDataByMaterial`
**Parâmetros necessários:** `Product` (string, máx. 40 caracteres), `Plant` (string, máx. 4 caracteres)
## Parâmetros de consulta
Os conectores SAP oferecem suporte a parâmetros de consulta padrão para filtrar, classificar e formatar respostas de API. Use esses parâmetros para otimizar a recuperação e o processamento de dados.
**Parâmetros de consulta compatíveis**
| \$1 | Parâmetro | Description | Tipo |
| --- | --- | --- | --- |
| 1 | \$1top | Limita o número de itens devolvidos | integer |
| 2 | \$1skip | Ignora o número especificado de itens | integer |
| 3 | \$1filter | Filtra os resultados com base em critérios especificados | string |
| 4 | \$1orderby | Ordena os resultados por campos especificados | array |
| 5 | \$1select | Seleciona propriedades específicas para retornar | array |
| 6 | \$1expand | Expande entidades relacionadas | array |
| 7 | \$1inlinecount | Inclui contagem de itens em resposta | string |
## Gerencie integrações de carga de trabalho do SAP
Depois de criar sua integração de carga de trabalho do SAP, você pode gerenciá-la por meio de várias opções.
### Editar configurações de integração
Siga estas etapas para modificar suas configurações de integração de carga de trabalho do SAP.
1. No console do Amazon Quick, escolha **Integrações.**
1. Escolha seu tipo de integração de carga de trabalho do SAP na grade de integração.
1. Selecione sua integração na lista e escolha **Editar**.
1. Modifique as configurações de integração:
+ Atualize as credenciais de autenticação (nome de usuário e senha).
+ Altere a URL do sistema SAP ou as configurações de conexão.
+ Modifique o nome ou a descrição da integração.
1. Escolha **Salvar alterações** para aplicar suas modificações.
### Compartilhe a integração
Você pode compartilhar conectores de ação de carga de trabalho do SAP com outros usuários em sua organização.
1. Na página de detalhes da integração com o SAP, escolha **Compartilhar**.
1. Configure as opções de compartilhamento:
+ **Compartilhe com usuários específicos**: insira nomes de usuário ou endereços de e-mail.
+ **Compartilhe com a organização** - Disponibilize para todos os usuários da sua organização.
1. Defina níveis de permissão para acesso compartilhado.
1. Escolha **Compartilhar integração** para aplicar as configurações de compartilhamento.
### Excluir integração
Siga estas etapas para remover permanentemente sua integração com o SAP.
1. Na página de detalhes da integração da carga de trabalho do SAP, escolha **Excluir**.
1. Analise o impacto da exclusão, incluindo quaisquer fluxos de trabalho ou automações usando essa integração.
1. Digite o nome da integração para confirmar a exclusão.
1. Escolha **Excluir integração** para removê-la permanentemente.
## Solucionar problemas de integrações de carga de trabalho do SAP
Use essas dicas de solução de problemas para resolver problemas comuns de integração de cargas de trabalho do SAP.
### Problemas de autenticação
OAuth 2.0 Falhas de autenticação
**Sintomas:** falha na geração do token, credenciais de cliente inválidas ou erros de OAuth escopo.
**Resolução:**
+ Verifique se OAuth o ID do cliente e o segredo do cliente estão corretos
+ Verifique se OAuth está configurado corretamente no SAP usando a transação `/IWFND/MAINT_SERVICE`
+ Certifique-se de que os escopos necessários estejam configurados adequadamente para seu tipo de conector de carga de trabalho SAP
+ Verifique se o formato do URL do token corresponde à configuração do sistema SAP
Falhas básicas de autenticação
**Sintomas:** falhas de login, credenciais inválidas ou erros de acesso negado.
**Resolução:**
+ Verifique se o nome de usuário e a senha do SAP estão corretos
+ Verifique se a conta do usuário tem as autorizações SAP necessárias
+ Certifique-se de que a conta do usuário não esteja bloqueada ou expirada
+ Verifique se o URL do domínio está acessível e formatado corretamente
### Problemas de configuração do sistema SAP
Serviço de API não ativado
**Sintomas:** erros de serviço indisponível, endpoint de API não encontrado ou respostas HTTP 404.
**Resolução:**
+ Verifique se o serviço de API SAP necessário está ativado em seu sistema
+ Verifique o status do serviço da API usando códigos de transação SAP
+ Certifique-se de que o serviço de API corresponda ao tipo de conector SAP escolhido
+ Entre em contato com seu administrador SAP para ativar os serviços de API ausentes
Tempos limite de conexão
**Sintomas:** tempos limite de solicitação, erros de conectividade de rede ou tempos de resposta lentos.
**Resolução:**
+ Verifique se o URL do sistema SAP está correto e acessível
+ Verifique se a conectividade de rede permite conexões com o sistema SAP
+ Garanta que as regras de firewall permitam o tráfego de integração
+ Verifique o desempenho e a disponibilidade do sistema SAP
### Erros de permissão e autorização
Autorizações SAP insuficientes
**Sintomas:** erros de acesso negado, mensagens de autorização ausentes ou falhas de operação restrita.
**Resolução:**
+ Certifique-se de que o usuário autenticado tenha exigido autorizações SAP para o módulo específico
+ Verifique se o usuário tem acesso aos códigos de transação necessários
+ Verifique se a conta do usuário tem as atribuições de função apropriadas
+ Entre em contato com o administrador do SAP para conceder as permissões ausentes
Erros de permissão de escopo
**Sintomas:** erros de OAuth escopo, permissões insuficientes para operações de API ou mensagens de acesso restrito.
**Resolução:**
+ Verifique se a OAuth configuração inclui o escopo necessário para seu tipo de conector
+ Verifique se as permissões do escopo foram concedidas corretamente no sistema SAP
+ Certifique-se de que o OAuth cliente tenha recebido os direitos de acesso necessários à API
### Erros de formato de dados e parâmetros
Formatos de parâmetros inválidos
**Sintomas:** erros de validação de dados, mensagens de tamanho de campo inválidas ou exceções de formato de parâmetros.
**Resolução:**
+ Analise os parâmetros de ação e garanta que eles correspondam aos formatos de dados SAP esperados
+ Verifique se os comprimentos dos campos correspondem aos requisitos do sistema SAP (por exemplo, BusinessPartner máximo de 10 caracteres)
+ Verifique se os tipos de dados estão corretos para o módulo SAP específico
+ Certifique-se de que todos os campos obrigatórios sejam fornecidos para a operação
Erros de parâmetros de consulta
**Sintomas:** erros de sintaxe de consulta, mensagens de parâmetros sem suporte ou erros de solicitação malformados.
**Resolução:**
+ Verifique se os parâmetros usam a sintaxe correta (por exemplo,`$filter`,`$top`,`$skip`)
+ Verifique se os valores dos parâmetros estão formatados corretamente
+ Certifique-se de que a API SAP ofereça suporte aos parâmetros específicos que estão sendo usados
+ Consulte a documentação da API SAP para ver as opções de consulta suportadas
### Problemas de disponibilidade do sistema SAP
Indisponibilidade do sistema SAP
**Sintomas:** erros de conexão recusada, sistema não respondendo ou mensagens de serviço indisponíveis.
**Resolução:**
+ Verifique o status e a disponibilidade do sistema SAP com seu administrador SAP
+ Verifique se há janelas de manutenção programada afetando o sistema
+ Verifique se há alertas do sistema SAP ou problemas conhecidos
+ Repita a operação após confirmar a disponibilidade do sistema