Suporte a ID externa em CRM de vendas API de preços

  • Versão de lançamento: Australia
  • Atualizado 27 de abr. de 2026
  • 3 min. de leitura

    • . CRM de vendas A API de preços é compatível com IDs externos em solicitações de preços. Você pode usar seus próprios identificadores ou códigos personalizados para campos de referência selecionados em vez de um ServiceNow sys_id.

    Por exemplo, uma chamada de preço pode se originar de outros sistemas de CRM ou ERP que podem ter identificadores diferentes para determinados objetos. Você pode mapear esses identificadores exclusivos para ServiceNow Campos de referência usando um ID externo, código ou outro campo personalizado. Uma chamada de preços pode ser feita usando esses identificadores exclusivos disponíveis no sistema externo.

    Você pode usar códigos externos para os seguintes campos de referência (objetos), incluindo, entre outros:
    • Oferta de produto
    • Oferta de produto de nível superior
    • Unidade de medida
    • Lista de preços
    • Livro de custos
    • E opções de característica
    • Tipo de ajuste de preço
    • Conta
    Nota:
    Os IDs externos se aplicam a solicitações de preços da REST API e não afetam os fluxos baseados em IU. A execução de preços pode usar IDs de sistema internos, IDs externos ou uma combinação de ambos os IDs nas solicitações de preços. Para obter mais informações sobre a API de preços, consulte Sales CRM Pricing API.

    Como os IDs externos funcionam nas solicitações de preços

    IDs externas mapeadas para campos de referência em ServiceNow tabelas de referência. Como administrador, antes de enviar uma solicitação de preço, crie as variáveis de contexto que definem os campos de referência para IDs ou códigos externos mapeados para uma coluna em uma tabela de referência especificada. Para obter mais informações, consulte Configure variáveis de contexto para IDs externos.

    O processamento de uma solicitação de preço com IDs externos envolve as seguintes fases:
    Admissão de solicitação
    O chamador envia uma solicitação da API REST de preços que pode incluir:
    • IDs ou códigos externos
    • sys_ids
    • Uma combinação de IDs externos e sys_ids

    Em sua solicitação, você define um sinalizador de solicitação ( "use_external_code:true" ) Que habilita o suporte a ID externa.

    Resolução
    Para cada campo de referência configurado, o sistema tenta resolver o valor externo para um sys_id interno.
    • A resolução é orientada pela configuração da variável de contexto.
    • Se a resolução falhar e nenhum sys_id for fornecido, a solicitação falhará.
    Resolução de conta usando identificadores externos
    As contas são resolvidas usando variáveis de contexto em vez de campos de carga de solicitação.
    • Os identificadores de conta externa são resolvidos antes da execução dos preços.
    • Os sys_ids da conta resolvida são usados internamente para execução de preços.
    • Os identificadores externos originais são mantidos para a construção da resposta.
    Execução de preços
    Toda a lógica de preços downstream é executada somente em sys_ids resolvidos. A lógica de preços não sabe se o valor original era um código externo ou um sys_id.
    Construção de resposta
    A resposta reflete os identificadores fornecidos na solicitação (códigos externos ou sys_ids). Sys_ids resolvidos não são expostos ao chamador.
    Tratamento de erros
    O sistema valida todos os identificadores de referência durante o processamento da solicitação. Os erros comuns incluem os seguintes cenários:
    • O identificador externo não existe na tabela de referência.
    • O uso de código externo está habilitado, mas não existe nenhum mapeamento de variável de contexto para um campo habilitado.
    • Nem o sys_id nem o código externo são fornecidos.
    • O valor do identificador não é válido.

    Os erros são relatados no nível de linha e identificam o item de linha com falha. As mensagens de erro podem variar dependendo da configuração e do contexto de validação.

    Se ocorrerem erros, verifique os seguintes itens:
    • Mapeamentos de variáveis de contexto
    • Valores do identificador externo
    • Solicitar uso do sinalizador

    Mapeamento e configuração de variáveis de contexto

    Como administrador, antes de enviar uma solicitação de preço da REST API que usa IDs externos, crie as variáveis de contexto que mapeiam para colunas em Selecionado ServiceNow tabelas de referência. Para obter mais informações, consulte Configure variáveis de contexto para IDs externos.