Integrações de carga de trabalho do SAP - Amazon Quick Suite
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. Essas integrações oferecem suporte somente à execução de ações e exigem o Amazon Quick Suite Pro de nível 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 Suite Author ou superior.

  • Conectividade de rede entre o Amazon Quick Suite e seu sistema SAP.

Prepare a configuração e a autenticação do sistema SAP

Antes de configurar a integração no Amazon Quick Suite, 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

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 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 da 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 Suite, escolha Integrações.

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

    • Mestre de produtos SAP

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

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

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

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

    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

  7. Selecione Criar e continuar.

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

  9. 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 Suite. Você pode realizar ações específicas do SAP diretamente do Amazon Quick Suite 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
# Parameter 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 Suite, escolha Integrações.

  2. Escolha seu tipo de integração de carga de trabalho do SAP na grade de integração.

  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

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 está 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