Prise en charge de l’ID externe dans l’API CRM des ventes de tarification

  • Rversion finale: Australia
  • Mis à jour 27 avr. 2026
  • 3 minutes de lecture

    • L’API CRM des ventes de tarification prend en charge les ID externes dans les demandes de tarification. Vous pouvez utiliser vos propres identificateurs ou codes personnalisés pour les champs de référence sélectionnés au lieu d’un ServiceNow sys_id.

    Par exemple, un appel de tarification peut provenir d’autres systèmes CRM ou ERP qui peuvent avoir des identificateurs différents pour certains objets. Vous pouvez mapper ces identificateurs uniques aux champs de ServiceNow référence à l’aide d’un ID externe, d’un code ou d’un autre champ personnalisé. Un appel de tarification peut ensuite être effectué à l’aide de ces identifiants uniques disponibles sur le système externe.

    Vous pouvez utiliser des codes externes pour les champs de référence (objets) suivants, y compris, mais sans s’y limiter :
    • Offre de produits
    • Offre de produits de niveau supérieur
    • Unité de mesure
    • Liste de prix
    • Livre des coûts
    • Caractéristiques et options de la caractéristique
    • Type d’ajustement des prix
    • Compte
    Remarque :
    Les ID externes s’appliquent aux demandes de tarification de l’API REST et n’affectent pas les flux basés sur l’interface utilisateur. L’exécution de la tarification peut utiliser des ID système internes, des ID externes ou une combinaison des deux ID dans les demandes de tarification. Pour plus d’informations sur l’API de tarification, reportez-vous à la section Sales CRM Pricing API.

    Fonctionnement des ID externes dans les demandes de tarification

    Les ID externes sont mappés aux champs de référence dans ServiceNow les tables de référence. En tant qu’administrateur, avant d’envoyer une demande de tarification, créez les variables de contexte qui définissent les champs de référence pour les ID ou les codes externes mappés à une colonne d’une table de référence spécifiée. Pour plus d'informations, consultez Configurer des variables de contexte pour les ID externes.

    Le traitement d’une demande de tarification avec des ID externes implique les phases suivantes :
    Réception de la demande
    L’appelant envoie une demande REST API de tarification qui peut inclure :
    • ID ou codes externes
    • sys_ids
    • Combinaison d’ID externes et de sys_ids

    Dans votre demande, vous définissez un marqueur de demande (« use_external_code :true ») qui active la prise en charge de l’ID externe.

    Résolution
    Pour chaque champ de référence configuré, le système tente de résoudre la valeur externe en sys_id interne.
    • La résolution dépend de la configuration des variables contextuelles.
    • Si la résolution échoue et qu’aucune sys_id n’est fournie, la demande échoue.
    Résolution du compte à l’aide d’identificateurs externes
    Les comptes sont résolus à l’aide de variables contextuelles plutôt que de champs de charge utile de demande.
    • Les identificateurs de compte externes sont résolus avant l’exécution de la tarification.
    • Les sys_ids de comptes résolus sont utilisés en interne pour l’exécution de la tarification.
    • Les identificateurs externes d’origine sont conservés pour la construction de la réponse.
    Exécution de la tarification
    Toute la logique de tarification en aval s’exécute uniquement sur les sys_ids résolus. La logique de tarification ne sait pas si la valeur d’origine était un code externe ou un sys_id.
    Construction de réponses
    La réponse reflète les identificateurs fournis dans la demande (codes externes ou sys_ids). Les sys_ids résolus ne sont pas exposés à l’appelant.
    Gestion des erreurs
    Le système valide tous les identificateurs de référence pendant le traitement de la demande. Les erreurs courantes incluent les scénarios suivants :
    • L’identificateur externe n’existe pas dans la table de référence.
    • L’utilisation de code externe est activée, mais aucun mappage de variable de contexte n’existe pour un champ activé.
    • Ni sys_id ni code externe ne sont fournis.
    • La valeur de l’identificateur n’est pas valide.

    Les erreurs sont signalées au niveau de la ligne et identifient l’élément de ligne en échec. Les messages d’erreur peuvent varier en fonction du contexte de configuration et de validation.

    Si des erreurs se produisent, vérifiez les éléments suivants :
    • Mappages de variables de contexte
    • Valeurs des identificateurs externes
    • Utilisation du marqueur de demande

    Configuration et mappage de variables de contexte

    En tant qu’administrateur, avant d’envoyer une demande de tarification d’API REST qui utilise des ID externes, créez les variables de contexte qui sont mappées aux colonnes des tables de référence sélectionnées ServiceNow . Pour plus d'informations, consultez Configurer des variables de contexte pour les ID externes.