View a markdown version of this page

Integrações de carga de trabalho do SAP - Amazon Quick
O que é possível fazerAntes de começarPrepare a configuração e a autenticação do sistema SAPConfigurar integrações SAPOperações disponíveis por tipo de conectorParâmetros de consultaGerencie integrações de carga de trabalho do SAPSolucione problemas de integrações de carga de trabalho do SAP

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. Para obter os requisitos de assinatura do Amazon Quick, consulteConfigurar integrações no console.

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 das APIs do SAP.

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 configuração OAuth em seu sistema SAP.

Parâmetros necessários:

  • ID do cliente - ID do cliente SAP OAuth

  • Segredo do cliente - Segredo do cliente SAP OAuth

  • URL do token - ponto final do token OAuth (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:

Configuração do OAuth 2.0

Para autenticação OAuth 2.0:

  • Configurar o servidor de autorização OAuth com os escopos apropriados

  • Verifique se o 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 detalhada do OAuth 2.0: Guia de configuração do OAuth 2.0

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

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 Conectores.

  2. Escolha a guia Criar para sua equipe.

  3. 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

  4. Clique em Adicionar (mais o botão “+”).

  5. Preencha o nome e a descrição da sua integração com o SAP.

  6. Escolha o tipo de conexão para sua integração.

  7. Configure a autenticação usando um dos métodos compatíveis:

    1. Configuração do OAuth 2.0

      Para a autenticação OAuth 2.0, forneça:

      • ID do cliente - Seu ID de cliente SAP OAuth

      • Segredo do cliente - Seu segredo do cliente SAP OAuth

      • URL do token - URL do endpoint do token OAuth

      • URL do domínio - URL do endpoint da API do sistema SAP

    2. 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

  8. Selecione Criar e continuar.

  9. Escolha usuários com os quais compartilhar a integração.

  10. 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 SAP-specific ações 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 comerciais - 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 obrigató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
# Parâmetro Description Tipo
1 $top Limita o número de itens devolvidos integer
2 $skip Ignora o número especificado de itens integer
3 $filter Filtra os resultados com base em critérios especificados string
4 $orderby Ordena os resultados por campos especificados array
5 $select Seleciona propriedades específicas para retornar array
6 $expand Expande entidades relacionadas array
7 $inlinecount 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 Conectores.

  2. Escolha seu conector de carga de trabalho SAP na lista de conectores.

  3. Selecione sua integração na lista e escolha Editar.

  4. 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.

  5. 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.

  2. 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.

  3. Defina níveis de permissão para acesso compartilhado.

  4. 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.

  2. Analise o impacto da exclusão, incluindo quaisquer fluxos de trabalho ou automações usando essa integração.

  3. Digite o nome da integração para confirmar a exclusão.

  4. Escolha Excluir integração para removê-la permanentemente.

Solucione 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

Falhas de autenticação do OAuth 2.0

Sintomas: falha na geração do token, credenciais de cliente inválidas ou erros no escopo do OAuth.

Resolução:

  • Verifique se o ID do cliente OAuth e o segredo do cliente estão corretos

  • Verifique se o 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 no escopo do OAuth, permissões insuficientes para operações de API ou mensagens de acesso restrito.

Resolução:

  • Verifique se a configuração do OAuth 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 cliente OAuth tenha recebido os direitos de acesso à API necessários

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