Criação do perfil de Integração Coupa

  • Versão de lançamento: Yokohama
  • Atualizado 30 de jan. de 2025
  • 4 min. de leitura

    • Crie um perfil de integração Coupa para verificar o status dos trabalhos agendados de aquisição, direitos e erros de importação de direitos criados por meio deste perfil.

    Antes de Iniciar

    Função necessária: sam_admin

    Crie uma conexão OAuth 2.0 com Coupa para obter o ID e o segredo do cliente. Para obter mais informações, consulte Introdução ao OAuth 2.0 com a API Coupa. Salve o ID do cliente e o Segredo do cliente em um local seguro para uso posterior.

    Você deve definir os escopos a seguir ao criar uma conexão OAuth 2.0 com Coupa.
    • core.approval.configuration.read
    • core.approval.read
    • core.approval.write
    • core.catalog.read
    • core.common.read
    • core.contract.read
    • core.contract.write
    • core.inventory.adjustment.read
    • core.inventory.adjustment.write
    • core.inventory.asn.read
    • core.inventory.common.write
    • core.inventory.consumption.read
    • core.inventory.consumption.write
    • core.inventory.receiving.read
    • core.inventory.receiving.write
    • core.inventory.return_to_supplier.read
    • core.inventory.transfer.read
    • core.inventory.transfer.write
    • core.invoice.delete
    • core.invoice.read
    • core.invoice.write
    • core.item.read
    • core.item.write
    • core.legal_entity.read
    • core.purchase_order.read
    • core.purchase_order.write
    • core.requisition.read
    • core.requisition.write
    • core.sourcing.pending_supplier.read
    • core.sourcing.pending_supplier.write
    • core.sourcing.read
    • core.sourcing.response.award.write
    • core.sourcing.response.read
    • core.sourcing.response.write
    • core.sourcing.write
    • core.supplier.read
    • núcleo.fornecedor.gravação
    • core.user.read
    • core.user.write
    Nota:
    Se esses escopos não estiverem associados ao ID do cliente e ao Segredo do cliente, o fluxo de token OAuth falhará em ServiceNow.

    Procedimento

    1. Navegar até Espaço de ativo do software > Operações de licença > Compra > Integrações de compras.
    2. Selecione Novo.
    3. No formulário, preencha os campos.
      Tabela 1. Criação de novo perfil de integração de Compras
      Campo Descrição
      Nome de exibição Nome do perfil de integração de Compras. Por exemplo, Coupa integration.
      Conexões e Credenciais Alias de credencial e conexão para Coupa. Este campo é preenchido automaticamente para sn_coupa_spoke.Coupa_OAuth.
      Tipo de perfil Tipo de perfil de integração.

      Selecione Integração de Coupa.
      Status Status do perfil de integração.
      • Se você não publicou o perfil de integração, esse campo será definido automaticamente como Rascunho.
      • Se você publicou o perfil de integração, esse campo será definido automaticamente como Publicado.
      Ativo

      Este campo fica visível e definido como verdadeiro somente quando o perfil de integração é publicado.

      Se você definir este campo como falso, as requisições associadas a este perfil de integração não serão criadas e rastreadas.
    4. Selecione Save (Salvar).
    5. Selecione o ícone Visualizar ícone Visualizar ao lado do campo Conexão e credenciais.
      Você é redirecionado para o formulário Aliases de conexão e credencial.
    6. Selecione Criar nova conexão e credencial na seção Links relacionados para criar uma credencial de conexão.
    7. Na caixa de diálogo, preencha os campos.
      Tabela 2. Criar Conexão e Credencial
      Campo Descrição
      Nome (conexão) Nome de identificação exclusiva da conexão. Por exemplo, Coupa OAuth connnection.
      URL de Conexão URL para fazer uma conexão com Coupa. Use o formato https://<coupa-instance-url>.
      • Para instâncias de cliente, use o formato https://{organization_name}.coupahost.com.
      • Para instâncias de parceiro e demonstraçãio, use o formato https://{organization_name}.coupacloud.com.
      Nome (credencial) Nome de identificação exclusiva da credencial. Por exemplo, Coupa OAuth credential.
      URL de Token URL usado para gerar o token OAuth. Use o formato https://<coupa-instance-url>/oauth2/token.
      ID do cliente OAuth Identificador (ID do cliente) gerado em Coupa.
      Segredo do cliente OAuth Segredo (segredo do cliente) gerado em Coupa.
    8. Selecione Criar e obter um Token do OAuth.
      Sua instância ServiceNow cria um OAuth para Coupa e retorna automaticamente ao formulário de perfil de integração.
    9. Opcional: Crie um alias secundário que possa identificar exclusivamente a conexão e as credenciais para este perfil de integração.
      O primeiro perfil de integração Coupa que você cria usa o alias de conexão e credencial padrão (primário) para Coupa. Cada perfil de integração Coupa adicional que você cria precisa de um alias secundário exclusivo que ajuda a diferenciar a conexão e as credenciais entre cada perfil de integração.
      1. No formulário Aliases de conexão e credencial, selecione o link em Child Aliases > Parentalias=*** para adicionar aliases secundários.
      2. Selecione Novo.
      3. Insira um nome para o alias secundário no campo Nome.
      4. Clique com o botão direito no cabeçalho do formulário e selecione Salvar.
      5. Depois que o formulário for recarregado, selecione o link relacionado Criar nova conexão e credencial.
      6. Repita as etapas 7 e 8.
      7. No campo Conexão e credencial do formulário Perfil de integração, selecione o ícone de pesquisa para localizar e selecionar o alias secundário que você criou.
        A seleção do alias secundário associa o alias ao perfil de integração. Sua instância ServiceNow usa esse alias para identificar a conexão e as credenciais para esse perfil de integração.
    10. Selecione Publicar.

    Resultado

    Depois de publicar o perfil de integração, o trabalho agendado ITAM - Sync Coupa purchase orders é executado diariamente e busca o status das requisições já criadas.
    Nota:
    O trabalho agendado não será executado se você não tiver criado nenhuma requisição.

    Você pode exibir essas informações clicando na guia Trabalhos de integração de Compras.

    O que Fazer Depois

    Verifique se o trabalho agendado ITAM - Sync Coupa purchase orders foi executado com sucesso selecionando a guia Resultados de trabalhos agendados de integração. Se o trabalho falhou, você pode exibir a lista de erros seguindo estas etapas:
    1. No formulário Perfil de integração de Compras, selecione a lista relacionada Log de trabalhos de integração de Compras.
    2. Abra o registro do log de trabalho em que o status exibido mostra como falha.
    3. Selecione a lista relacionada Detalhes do log de trabalho do ativo para descobrir o motivo da falha do trabalho.

    Crie requisições de software diretamente em Coupa por meio da aplicação ServiceNow Compras para adquirir software.

    Se você quiser excluir o perfil de integração Coupa, consulte Excluindo um perfil de integração da aplicação de compras externa.