--- sourceDocument: Référence de l’API Xanadu sourceDocumentLink: https://servicenow-prod.fluidtopics.net/r/fr-FR/xanadu/api-reference Release : - xanadu ft:locale : - fr-FR ft:publication_title : - Référence de l’API Xanadu ft:clusterId : - crapiref bundleId : - crapiref workflow : - Creator --- # Commande de produit : API ouverte # Commande de produit : API ouverte {#ariaid-title1} * Rversion finale: Xanadu * * Mis à jour 1 août 2024 * * ![](https://www.servicenow.com/docs/portal-asset/ico-clock) 162 minutes de lecture L'API ouverte de commande de produit fournit des points de terminaison qui activent un mécanisme standardisé pour passer des commandes de produits. Une commande de produit est créée en fonction d'une offre de produit définie et publiée dans un catalogue de produits. L'offre de produit identifie le produit ou l'ensemble de produits mis à la disposition d'un client et inclut les caractéristiques pertinentes du produit qui capturent les options uniques d'un produit, ainsi que d'autres attributs pertinents tels que la tarification, les conditions contractuelles et la disponibilité. Pour accéder à cette API, le module d'extension Order Management for Telecommunications (sn_ind_tmt_orm) doit être activé. Cette API est fournie dans l'espace de noms `sn_ind_tmt_orm` . L'utilisateur appelant doit avoir le rôle sn_ind_tmt_orm.order_integrator. Cette API peut être étendue pour effectuer des personnalisations autour des paramètres requis, de la validation du corps de la demande, des opérations REST supplémentaires et des mappages de champs. Pour plus d'informations, voir le [Guide du développeur de l'API ouverte pour la commande de produit](https://servicenow-prod.fluidtopics.net/KBaMeSuXUNNUcW_DEaSxSw#product-order_dev-guide "Utilisez l’API ouverte de commande de produit pour créer, mettre à jour et récupérer les informations de commande de produits."). L'API ouverte de commande de produits est une ServiceNow® implémentation de la spécification REST de l'API de gestion des commandes de produits TM Forum TMF622 et est certifiée de conformité par TM Forum. ## Commande de produit Ouvrir l'API : GET /sn_ind_tmt_orm/order/productOrder {#ariaid-title2} Récupère toutes les commandes de produits. Ce point de terminaison récupère les informations de commande à partir des tables suivantes : * Commande de clients \[sn_ind_tmt_orm_order\] * Élément de ligne de commande \[sn_ind_tmt_orm_order_line_item\] * Caractéristique de commande \[sn_ind_tmt_orm_order_characteristic_value\] * Contact de l'élément de ligne de commande \[sn_ind_tmt_orm_order_line_item_contact\] * Éléments de ligne de commande connexes \[sn_ind_tmt_orm_order_line_related_items\] {#tmf_prod_order-GET-ord-productOrder__ul_lxc_kxm_t4b} ### Format d'URL {#tmf_prod_order-GET-ord-productOrder__section_mbm_2ct_t4b} URL par défaut : /api/sn_ind_tmt_orm/order/productOrder ### Paramètres de demande pris en charge {#tmf_prod_order-GET-ord-productOrder__table_ofr_vgy_fsb__entry__2} | Nom | Description | |-|-| | Aucun | | [Tableau 1. Paramètres de chemin d'accès] {#tmf_prod_order-GET-ord-productOrder__table_ofr_vgy_fsb} {#tmf_prod_order-GET-ord-productOrder__table_pfr_vgy_fsb__entry__2} | Nom | Description | |-|-| | champs | Liste des champs à renvoyer dans la réponse. Les champs non valides sont ignorés. Si ce paramètre n'est pas utilisé, tous les champs sont renvoyés. Type de données : chaîne | | limite | Nombre maximal d'enregistrements à renvoyer. Pour les demandes qui dépassent ce nombre d'enregistrements, utilisez le paramètre pour paginer la récupération de l'enregistrement offset . Par défaut : 20 Maximum : 100 Type de données : nombre | | décalage | Index de départ auquel commencer à récupérer des enregistrements. Utilisez cette valeur pour paginer la récupération des enregistrements. Cette fonctionnalité permet de récupérer tous les enregistrements, quel que soit le nombre d'enregistrements, par petits blocs gérables. Par défaut : 0 Type de données : nombre | | État | Filtrer les commandes par état. Seules les commandes dont l'état correspond à la valeur de ce paramètre sont renvoyées dans la réponse. Type de données : chaîne | [Tableau 2. Paramètres de requête] {#tmf_prod_order-GET-ord-productOrder__table_pfr_vgy_fsb} {#tmf_prod_order-GET-ord-productOrder__table_xcm_cvr_nsb__entry__2} | Nom | Description | |-|-| | Aucun | | [Tableau 3. Paramètres du corps de la demande (JSON)] {#tmf_prod_order-GET-ord-productOrder__table_xcm_cvr_nsb} ### En-têtes Les en-têtes de demande et de réponse suivants s'appliquent à cette action HTTP uniquement ou s'appliquent à cette action d'une manière distincte. Pour obtenir la liste des en-têtes généraux utilisés dans l'API REST, consultez [En-têtes d'API REST pris en charge](https://servicenow-prod.fluidtopics.net/CFQa7z9NIrhoOq1u1cRN7g "REST (REpresentational State Transfer) est une architecture simple sans état qui fournit des normes entre les systèmes informatiques sur le Web, ce qui leur permet de communiquer plus facilement les uns avec les autres."). {#tmf_prod_order-GET-ord-productOrder__table_kqy_wgy_fsb__entry__2} | En-tête | Description | |-|-| | Aucun | | [Tableau 4. En-têtes de demandes] {#tmf_prod_order-GET-ord-productOrder__table_kqy_wgy_fsb} {#tmf_prod_order-GET-ord-productOrder__table_h4r_fxr_nsb__entry__2}{#tmf_prod_order-GET-ord-productOrder__content-range-row}{#tmf_prod_order-GET-ord-productOrder__content-type-row}{#tmf_prod_order-GET-ord-productOrder__links-pagination-row}{#tmf_prod_order-GET-ord-productOrder__x-total-count-descr} | En-tête | Description | |-|-| | Plage de contenu | Spécifie la plage de contenu renvoyée dans un appel paginé. Par exemple, si `offset=2` et `limit=3`, la valeur de l'en-tête Content-Range est `les éléments 3 à 5`. | | Type de contenu | Format de données du corps de la réponse. Ne prend en charge application/jsonque les fichiers . | | Lien | Contient les liens suivants pour parcourir les résultats de la requête. * premier * dernier * suivant * previous {#tmf_prod_order-GET-ord-productOrder__ul_zzk_sdm_lsb} | | X-Total-Count | Pour les requêtes paginées, cet en-tête indique le nombre total d'enregistrements disponibles sur le serveur. | [Tableau 5. En-têtes de réponses] {#tmf_prod_order-GET-ord-productOrder__table_h4r_fxr_nsb} ### Codes d'état Les codes d'état suivants s'appliquent à cette action HTTP. Pour obtenir la liste des codes d'état possibles utilisés dans l'API REST, consultez [Codes de réponse HTTP de l'API REST](https://servicenow-prod.fluidtopics.net/CFQa7z9NIrhoOq1u1cRN7g "REST (REpresentational State Transfer) est une architecture simple sans état qui fournit des normes entre les systèmes informatiques sur le Web, ce qui leur permet de communiquer plus facilement les uns avec les autres."). {#tmf_prod_order-GET-ord-productOrder__table_wdl_3xr_nsb__entry__2}{#tmf_prod_order-GET-ord-productOrder__tmf-get-status-200-p}{#tmf_prod_order-GET-ord-productOrder__tmf-get-status-206-entry}{#tmf_prod_order-GET-ord-productOrder__tmf-get-status-400-entry}{#tmf_prod_order-GET-ord-productOrder__tmf-get-status-404-entry} | Code d'état | Description | |-|-| | 200 | Demande traitée avec succès. Ressource complète renvoyée en réponse (aucune pagination). | | 206 | Ressource partielle renvoyée en réponse (avec pagination). | | 400 | Demande incorrecte. Raisons possibles : * Paramètre de chemin d'accès non valide * URI non valide {#tmf_prod_order-GET-ord-productOrder__ul_rys_1gy_fsb} | | 404 | Enregistrement introuvable. Aucun enregistrement correspondant aux paramètres de requête n'a été trouvé dans la table. | [Tableau 6. Codes d'état] {#tmf_prod_order-GET-ord-productOrder__table_wdl_3xr_nsb} ### Paramètres de corps de réponse (JSON) {#tmf_prod_order-GET-ord-productOrder__section_hnf_kxr_nsb} {#tmf_prod_order-GET-ord-productOrder__table_inf_kxr_nsb__entry__2}{#tmf_prod_order-GET-ord-productOrder__externalProdInv-resp-descr}{#tmf_prod_order-GET-ord-productOrder__externalProdInvId-resp-descr} | Nom | Description | |-|-| | canal | Tableau d'objets qui décrivent les canaux à utiliser pour vendre les produits. Type de données : tableau "channel": [ { "id": "String", "name": "String" } ] | | channel.id | Identificateur unique du canal à utiliser pour vendre les produits associés. Les valeurs d'ID de canal se trouvent dans le champ external_id de la table Canal de distribution \[sn_prd_pm_distribution_channel\]. Type de données : chaîne | | channel.name | Nom du canal à utiliser pour vendre les produits associés. Type de données : chaîne | | committedDueDate | Date et heure auxquelles l'action doit être effectuée sur la commande. Cette valeur doit être identique ou ultérieure aux valeurs de committedDueDate chaque élément de ligne de commande. Type de données : chaîne | | expectedCompletionDate | Date à laquelle la commande sera terminée. Type de données : chaîne | | href | Lien relatif à l'enregistrement de commande de produit. Type de données : chaîne | | id | Sys_id de la commande de produit. Type de données : chaîne | | note | Tableau d'objets qui décrivent les notes supplémentaires prises par le client lors de la commande. Type de données : tableau "note": [ { "author": "String", "date": "String", "text": "String" } ] | | note.auteur | Nom d'utilisateur de la personne qui a rédigé la note associée. Type de données : chaîne | | note.date | Date de création de la note. Type de données : chaîne | | note.texte | Remarques/commentaires supplémentaires formulés par le client lors de la commande. Type de données : chaîne | | orderCurrency | Code de devise pour la commande et les éléments de ligne de commande. Type de données : chaîne | | ponr | Marqueur indiquant si le point de non retour de la commande a été atteint. Valeurs valides : * true : le point de non-retour de la commande a été atteint. * false : le point de non-retour de la commande n'a pas été atteint. {#tmf_prod_order-GET-ord-productOrder__ul_tdq_rw1_hqb} Type de données : booléennes | | Élément de commande produit | Liste décrivant les éléments associés à la commande de produit et leur action associée. Type de données : tableau "productOrderItem:" [ { "action": "String", "committedDueDate": "String", "externalProductInventory": [Array], "id": "String", "itemPrice": [Array], "product": {Object}, "productOffering": {Object}, "productOrderItemReleationship": [Array], "quantity": Number, "state": "String", "@type": "String" } ] | | productOrderItem.action | Action à effectuer sur le produit. Les actions possibles sont définies dans l'onglet Liste de choix de l'entrée du dictionnaire d'actions de la table sn_ind_tmt_orm_order_line_item. Type de données : chaîne | | Élément de commandeproduit.actionReason | Motif de l'ajout de l'élément de ligne de commande. Type de données : chaîne Table/champ mis à jour : sn_ind_tmt_orm_order_line_item/action_reason | | productOrderItem.committedDueDate | Date et heure auxquelles l'action doit être effectuée sur l'élément de ligne de commande. Type de données : chaîne | | productOrderItem.externalProductInventory | Tableau d'objets contenant des ID externes mappés aux inventaires de produits créés pour la commande. Type de données : tableau "externalProductInventory": [ { "externalProductInventoryId": "String" } ] | | productOrderItem.externalProductInventory.externalProductInventoryId | ID externe mappé à l'inventaire des produits. Type de données : chaîne | | productOrderItem.id | Identificateur unique de l'élément de ligne. Situé dans le champ sn_ind_tmt_orm_external_id de la table Élément de ligne de commande \[sn_ind_tmt_orm_order_line_item\]. Type de données : chaîne | | productOrderItem.itemPrice | Tableau d'objets décrivant le prix associé au produit. Type de données : tableau "itemPrice": [ { "price": {Object}, "priceType": "String", "recurringChargePeriod": "String" } ] | | productOrderItem.itemPrice.price | Description du prix du produit associé. Type de données : objet "price": { "taxIncludedAmount": {Object} } | | productOrderItem.itemPrice.price.taxIncludedAmount | Description du prix du produit associé, taxes comprises. Type de données : objet "taxIncludedAmount": { "unit": "String", "value": Number } | | productOrderItem.itemPrice.price.taxIncludedAmount.unit | Code de devise dans lequel le prix est représenté. Type de données : chaîne | | productOrderItem.itemPrice.price.taxIncludedAmount.value | Prix du produit, toutes taxes comprises. Type de données : nombre | | productOrderItem.itemPrice.priceType | Type de prix de l'article, récurrent ou non récurrent. Type de données : chaîne | | productOrderItem.itemPrice.recurringChargePeriod | Si le prix est récurrent, la période récurrente, par exemple le mois. Type de données : chaîne | | ArticleCommandeProduit.ponr | Marqueur indiquant si le point de non retour de la commande a été atteint. Valeurs valides : * true : le point de non-retour de la commande a été atteint. * false : le point de non-retour de la commande n'a pas été atteint. {#tmf_prod_order-GET-ord-productOrder__d2876e2597} Type de données : booléennes | | productOrderItem.product | Description des détails de l'instance du produit acheté par le client. Type de données : objet "product:" { "place": {Object}, "productCharacteristic": [Array], "productRelationship": [Array], "productSpecification": {Object}, "relatedParty": {Object}, "@type": "String" } | | productOrderItem.product.place | Cartes des emplacements sur lesquels installer le produit. Type de données : objet "place": { "id": "String", "@type": "String" } | | productOrderItem.product.place.id | Sys_id de l'enregistrement de l'emplacement associé dans la table Emplacement \[cmn_location\]. Type de données : chaîne | | productOrderItem.product.place.@type | Fait partie de la norme TMF Open API. Annotation pour le contact de l'élément de ligne de commande. Cette valeur est toujours Place. Ces informations ne sont pas stockées. Type de données : chaîne | | productOrderItem.product.productCharacteristic | Tableau d'objets décrivant les caractéristiques du produit associé. Seules les caractéristiques des produits qui value sont différentes de celles previousValue sont retournées. Type de données : tableau "productCharacteristic": [ { "name": "String", "previousValue": "String", "value": "String" } ] | | productOrderItem.product.productCharacteristic.name | Nom de l'enregistrement de la caractéristique à associer au produit. Situé dans la table Caractéristique \[sn_prd_pm_characteristic\]. Type de données : chaîne | | productOrderItem.product.productCharacteristic.previousValue | Valeurs d'option de caractéristique précédentes si la mise à jour concerne un ordre de changement. La demande est un ordre de changement si le paramètre est autre que ajouterproductOrderItem.action. Pour plus d'informations sur les valeurs des options de caractéristique, reportez-vous à la section [Create product characteristics and characteristic options](https://www.servicenow.com/docs/access?context=som-product-config-add-characteristics&version=xanadu&pubname=xanadu-order-management&ft:locale=en-US). Type de données : chaîne | | productOrderItem.product.productCharacteristic.value | Valeurs d'option de caractéristique associées au produit. Pour plus d'informations sur les valeurs des options de caractéristique, reportez-vous à la section [Create product characteristics and characteristic options](https://www.servicenow.com/docs/access?context=som-product-config-add-characteristics&version=xanadu&pubname=xanadu-order-management&ft:locale=en-US). Type de données : chaîne | | productOrderItem.product.productRelationship | Liste des détails de relation de produit pour un élément de ligne de commande. Type de données : tableau "productRelationship": [ { "id": "String", "relationshipType": "String" } ] | | productOrderItem.product.productRelationship.id | Sys_id ou sn_prd_invt_external_id de l'inventaire des produits. Situé dans le champ sys_id ou sn_prd_invt_external_id de la table Inventaire des produits \[sn_prd_invt_product_inventory\]. Type de données : chaîne | | productOrderItem.product.productRelationship.relationshipType | Type de relation entre l'élément de ligne de commande et l'inventaire des produits. Valeur possible : nécessite Type de données : chaîne | | productOrderItem.product.productSpecification | Description de la spécification du produit associée au produit. Type de données : objet "productSpecification:" { "id": "String", "internalId": "String", "internalVersion": "String", "name": "String", "version": "String", "@type": "String" } | | productOrderItem.product.productSpecification.id | Initial_version ou external_id des spécifications du produit. Le initial_version est le sys_id de la première version de la spécification. Situé dans le champ sys_id ou external_id de la table Spécification de produit \[sn_prd_pm_product_specification\]. Type de données : chaîne | | productOrderItem.product.productSpecification.internalId | Initial_version des spécifications du produit. Le initial_version est le sys_id de la première version de la spécification. Situé dans la table Spécification de produit \[sn_prd_pm_product_specification\]. Type de données : chaîne | | productOrderItem.product.productSpecification.internalVersion | Version de la spécification du produit. Situé dans la table Spécification de produit \[sn_prd_pm_product_specification\]. Type de données : chaîne | | productOrderItem.product.productSpecification.name | Nom de la spécification de produit. Situé dans la table Spécification de produit \[sn_prd_pm_product_specification\]. Type de données : chaîne | | productOrderItem.product.productSpecification.version | External_version des spécifications du produit. Situé dans la table Spécification de produit \[sn_prd_pm_product_specification\]. Type de données : chaîne | | productOrderItem.product.productSpecification.@type | Fait partie de la norme TMF Open API. Cette valeur est toujours ProductSpecificationRef. Ces informations ne sont pas stockées. Type de données : chaîne | | élémentcommandeproduit.produit.relatedparty | Liste des contacts pour les éléments de ligne. Type de données : tableau "relatedParty:" [ { "email": "String", "firstName": "String", "id": "String", "lastName": "String", "phone": "String", "@referredType": "String", "@type": "String" } ] | | productOrderItem.product.relatedParty.email | Adresse e-mail du contact. Type de données : chaîne | | productOrderItem.product.relatedParty.firstName | Prénom de la personne à contacter. Type de données : chaîne | | productOrderItem.product.relatedParty.id | Sys_id du contact de l'élément de ligne associé à l'élément de ligne de commande. Situé dans la table Contact de l'élément de ligne de commande \[sn_ind_tmt_orm_order_line_item_contact\]. Type de données : chaîne | | productOrderItem.product.relatedParty.lastName | Nom de famille du contact. Type de données : chaîne Type de données : chaîne | | productOrderItem.product.relatedParty.phone | Numéro de téléphone professionnel du contact. Type de données : chaîne | | productOrderItem.product.relatedParty.@referredType | Type de client. Valeur possible : OrderLineItemContact Type de données : chaîne | | productOrderItem.product.relatedParty.@type | Fait partie de la norme TMF Open API. Annotation pour le contact de l'élément de ligne de commande. Cette valeur est toujours RelatedParty. Ces informations ne sont pas stockées. Type de données : chaîne | | productOrderItem.productOffering | Description de l'offre de produit associée au produit. Type de données : objet "productOffering:" { "id": "String", "internalId": "String", "internalVersion": "String", "name": "String", "version": "String" } | | productOrderItem.productOffering.id | Initial_version ou external_id de l'offre de produits. Le initial_version est le sys_id de la première version de l'offre. Situé dans le champ sys_id ou external_id de la table Offre de produits \[sn_prd_pm_product_offering\]. Type de données : chaîne | | productOrderItem.productOffering.internalId | Initial_version de l'offre de produits. Le initial_version est le sys_id de la première version de l'offre. Situé dans la table Offre de produits \[sn_prd_pm_product_offering\]. Type de données : chaîne | | productOrderItem.productOffering.internalVersion | Version de l'offre de produit. Situé dans la table Offre de produits \[sn_prd_pm_product_offering\]. Type de données : chaîne | | productOrderItem.productOffering.name | Nom de l'offre de produits. Situé dans la table Offre de produits \[sn_prd_pm_product_offering\]. Type de données : chaîne | | Élément de commandedeproduit.offredeproduit.version | External_version de l'offre de produits. Situé dans la table Offre de produits \[sn_prd_pm_product_offering\]. Type de données : chaîne | | productOrderItem.quantity | Nombre d'éléments de produit achetés. Type de données : nombre | | productOrderItem.productOrderItemRelationship | Tableau d'objets décrivant les relations entre les éléments de ligne de commande. Type de données : tableau "productOrderItemRelationship": [ { "id": "String", "relationshipType": "String" } ] | | productOrderItem.productOrderItemRelationship.id | Identificateur unique de l'élément de ligne connexe. Situé dans le champ sn_ind_tmt_orm_external_id de la table Élément de ligne de commande \[sn_ind_tmt_orm_order_line_item\]. Type de données : chaîne | | productOrderItem.productOrderItemRelationship.relationshipType | Type de relation entre les deux éléments de ligne. Ces informations sont utilisées pour identifier la hiérarchie des relations. Valeurs possibles : * HasChild (en anglais seulement) * HasParent (en anglais seulement) * Exige {#tmf_prod_order-GET-ord-productOrder__ul_yqf_2ty_54b} `HasChild` et `HasParent` sont utilisés pour les relations parent/enfant. `Exige` est utilisé pour les relations horizontales (un élément de ligne nécessite un autre élément de ligne). Type de données : chaîne | | élémentcommandeproduit.état | État de la commande de l'élément de produit associé. Type de données : chaîne | | productOrderItem.version | Version de la commande. Type de données : chaîne | | productOrderItem.@type | Fait partie de la norme TMF Open API. Annotation pour le produit. Cette valeur est toujours ProductOrderItem. Ces informations ne sont pas stockées. Type de données : chaîne | | relatedParty | Liste des contacts de la commande. Chaque contact est un objet dans le tableau. Doit énumérer au moins un élément qui contient des informations sur le compte client ou le compte de consommateur. Type de données : tableau "relatedParty:" [ { "id": "String", "name": "String", "@referredType": "String", "@type": "String" } ] | | relatedParty.id | Sys_id ou external_id du compte, du contact client ou du consommateur associé à la commande. Situé dans la table Compte \[customer_account\], Contact \[customer_contact\] ou Consommateur \[csm_consumer\]. Type de données : chaîne | | relatedParty.name | Nom du compte, du client ou du consommateur. Type de données : chaîne | | relatedParty.@referredType | Type de client. Valeurs possibles : * Consommateur * Client * Contact du client {#tmf_prod_order-GET-ord-productOrder__ul_lcq_jwm_t4b} Type de données : chaîne | | relatedParty.@type | Fait partie de la norme TMF Open API. Annotation pour le produit. Cette valeur est toujours RelatedParty. Ces informations ne sont pas stockées. Type de données : chaîne | | requestedCompletionDate | Date de livraison demandée par le client. Type de données : chaîne | | Date de début demandée | Date de début de commande demandée par le client. Type de données : chaîne | | État | État actuel de la commande. Type de données : chaîne | | version | Version de la commande. Type de données : chaîne | | @type | Fait partie de la norme TMF Open API. Annotation pour le produit. Cette valeur est toujours ProductOrder. Ces informations ne sont pas stockées. Type de données : chaîne | [ ] {#tmf_prod_order-GET-ord-productOrder__table_inf_kxr_nsb} ### Demande cURL Cet exemple récupère toutes les commandes de produits. curl --location --request GET 'https://instance.service-now.com/api/sn_ind_tmt_orm/order/productOrder' \ --user 'username':'password' Corps de réponse. [ { "id": "8d75939453126010a795ddeeff7b126a", "href": "/api/sn_ind_tmt_orm/order/productOrder/8d75939453126010a795ddeeff7b126a", "ponr": "false", "orderCurrency": "USD", "expectedCompletionDate": "2021-05-02T08:13:59.000Z", "requestedCompletionDate": "2021-05-02T08:13:59.000Z", "requestedStartDate": "2020-05-03T08:13:59.000Z", "channel": [ { "id": "1", "name": "Agent Assist" } ], "note": [ { "author": "System Administrator", "date": "2021-02-25T14:22:07.000Z", "text": "This is a TMF product order illustration no 2" }, { "author": "System Administrator", "date": "2021-02-25T14:22:06.000Z", "text": "This is a TMF product order illustration" } ], "productOrderItem": [ { "id": "POI130", "ponr": "false", "quantity": 1, "action": "add", "actionReason": "adding service package OLI", "itemPrice": [ { "priceType": "recurring", "price": { "taxIncludedAmount": { "unit": "USD", "value": 20 } } }, { "priceType": "nonRecurring", "price": { "taxIncludedAmount": { "unit": "INR", "value": 0 } } } ], "product": { "@type": "Product", "productCharacteristic": [ { "name": "Security Type", "valueType": "Choice", "value": "Base", "previousValue": "" } ], "productSpecification": { "id": "a6514bd3534560102f18ddeeff7b1247", "name": "SD-WAN Security", "version": "v1", "internalVersion": "1", "internalId": "a6514bd3534560102f18ddeeff7b1247", "@type": "ProductSpecificationRef" }, "relatedParty": [ { "id": "4175939453126010a795ddeeff7b127d", "name": "John Smith", "email": "abc2@example.com", "phone": "32456768", "@type": "RelatedParty", "@referredType": "OrderLineItemContact" }, { "id": "c175939453126010a795ddeeff7b127c", "name": "Joe Doe", "email": "abc@example.com", "phone": "1234567890", "@type": "RelatedParty", "@referredType": "OrderLineItemContact" } ] }, "productOffering": { "id": "69017a0f536520103b6bddeeff7b127d", "name": "Premium SD-WAN Offering", "version": "v1", "internalId": "69017a0f536520103b6bddeeff7b127d", "internalVersion": "1" }, "productOrderItemRelationship": [ { "id": "POI100", "relationshipType": "HasParent" } ], "state": "in_progress", "version": "1", "@type": "ProductOrderItem" }, { "id": "POI100", "ponr": "false", "quantity": 1, "action": "add", "itemPrice": [ { "priceType": "recurring", "price": { "taxIncludedAmount": { "unit": "INR", "value": 0 } } }, { "priceType": "nonRecurring", "price": { "taxIncludedAmount": { "unit": "INR", "value": 0 } } } ], "product": { "@type": "Product", "productSpecification": { "id": "cfe5ef6a53702010cd6dddeeff7b12f6", "name": "SD-WAN Service Package", "version": "v1", "internalVersion": "1", "internalId": "cfe5ef6a53702010cd6dddeeff7b12f6", "@type": "ProductSpecificationRef" } }, "productOffering": { "id": "69017a0f536520103b6bddeeff7b127d", "name": "Premium SD-WAN Offering", "version": "v1", "internalId": "69017a0f536520103b6bddeeff7b127d", "internalVersion": "1" }, "productOrderItemRelationship": [ { "id": "POI130", "relationshipType": "HasChild" }, { "id": "POI120", "relationshipType": "HasChild" }, { "id": "POI110", "relationshipType": "HasChild" } ], "state": "in_progress", "version": "1", "@type": "ProductOrderItem" }, { "id": "POI120", "ponr": "false", "quantity": 1, "action": "add", "itemPrice": [ { "priceType": "recurring", "price": { "taxIncludedAmount": { "unit": "USD", "value": 20 } } }, { "priceType": "nonRecurring", "price": { "taxIncludedAmount": { "unit": "INR", "value": 0 } } } ], "product": { "@type": "Product", "productCharacteristic": [ { "name": "CPE Type", "valueType": "Choice", "value": "Physical", "previousValue": "" }, { "name": "WAN Optimization", "valueType": "Choice", "value": "Advance", "previousValue": "" }, { "name": "Routing", "valueType": "Choice", "value": "Premium", "previousValue": "" }, { "name": "CPE Model", "valueType": "Choice", "value": "ASR", "previousValue": "" } ], "productSpecification": { "id": "39b627aa53702010cd6dddeeff7b1202", "name": "SD-WAN Edge Device", "version": "v1", "internalVersion": "1", "internalId": "39b627aa53702010cd6dddeeff7b1202", "@type": "ProductSpecificationRef" }, "productRelationship": [ { "id": "326d13f45b5620102dff5e92dc81c785", "relationshipType": "Requires" } ] }, "productOffering": { "id": "69017a0f536520103b6bddeeff7b127d", "name": "Premium SD-WAN Offering", "version": "v1", "internalVersion": "1", "internalId": "69017a0f536520103b6bddeeff7b127d" }, "productOrderItemRelationship": [ { "id": "POI100", "relationshipType": "HasParent" }, { "id": "POI110", "relationshipType": "Requires" } ], "state": "in_progress", "version": "1", "@type": "ProductOrderItem" }, { "id": "POI110", "ponr": "false", "quantity": 1, "action": "add", "itemPrice": [ { "priceType": "recurring", "price": { "taxIncludedAmount": { "unit": "INR", "value": 0 } } }, { "priceType": "nonRecurring", "price": { "taxIncludedAmount": { "unit": "USD", "value": 5 } } } ], "product": { "@type": "Product", "productCharacteristic": [ { "name": "Tenancy", "valueType": "Choice", "value": "Base (10 site)", "previousValue": "" } ], "productSpecification": { "id": "216663aa53702010cd6dddeeff7b12b5", "name": "SD-WAN Controller", "version": "v1", "internalVersion": "1", "internalId": "216663aa53702010cd6dddeeff7b12b5", "@type": "ProductSpecificationRef" }, "place": { "id": "25ab9c4d0a0a0bb300f7dabdc0ca7c1c", "@type": "Place" } }, "productOffering": { "id": "69017a0f536520103b6bddeeff7b127d", "name": "Premium SD-WAN Offering", "version": "v1", "internalId": "69017a0f536520103b6bddeeff7b127d", "internalVersion": "1" }, "productOrderItemRelationship": [ { "id": "POI100", "relationshipType": "HasParent" } ], "state": "in_progress", "version": "1", "@type": "ProductOrderItem" } ], "relatedParty": [ { "id": "eaf68911c35420105252716b7d40ddde", "name": "Sally Thomas", "@type": "RelatedParty", "@referredType": "CustomerContact" }, { "id": "ffc68911c35420105252716b7d40dd55", "name": "Funco Intl", "@type": "RelatedParty", "@referredType": "Customer" }, { "id": "59f16de1c3b67110ff00ed23a140dd9e", "name": "Funco External", "@type": "RelatedParty", "@referredType": "Consumer" } ], "state": "in_progress", "version": "1", "@type": "ProductOrder" } ] ## Commande de produit API ouverte : GET /sn_ind_tmt_orm/order/productOrder/{id} {#ariaid-title3} Récupère la commande de produit spécifiée. Ce point de terminaison récupère les informations de commande à partir des tables suivantes : * Commande de clients \[sn_ind_tmt_orm_order\] * Caractéristique de commande \[sn_ind_tmt_orm_order_characteristic_value\] * Élément de ligne de commande \[sn_ind_tmt_orm_order_line_item\] * Contact de l'élément de ligne de commande \[sn_ind_tmt_orm_order_line_item_contact\] * Éléments de ligne de commande connexes \[sn_ind_tmt_orm_order_line_related_items\] {#tmf_prod_order-GET-ord-productOrder-id__ul_lxc_kxm_t4b} ### Format d'URL {#tmf_prod_order-GET-ord-productOrder-id__section_mbm_2ct_t4b} URL par défaut : /api/sn_ind_tmt_orm/order/productOrder/{id} ### Paramètres de demande pris en charge {#tmf_prod_order-GET-ord-productOrder-id__entry__2} | Nom | Description | |-|-| | id | Sys_id ou external_id de la commande du client à récupérer. Situé dans la table Commande client \[sn_ind_tmt_orm_order\]. Type de données : chaîne | [Tableau 7. Paramètres de chemin d'accès] {#tmf_prod_order-GET-ord-productOrder-id__entry__6} | Nom | Description | |-|-| | Aucun | | [Tableau 8. Paramètres de requête] {#tmf_prod_order-GET-ord-productOrder-id__entry__10} | Nom | Description | |-|-| | Aucun | | [Tableau 9. Paramètres du corps de la demande (JSON)] ### En-têtes Les en-têtes de demande et de réponse suivants s'appliquent à cette action HTTP uniquement ou s'appliquent à cette action d'une manière distincte. Pour obtenir la liste des en-têtes généraux utilisés dans l'API REST, consultez [En-têtes d'API REST pris en charge](https://servicenow-prod.fluidtopics.net/CFQa7z9NIrhoOq1u1cRN7g "REST (REpresentational State Transfer) est une architecture simple sans état qui fournit des normes entre les systèmes informatiques sur le Web, ce qui leur permet de communiquer plus facilement les uns avec les autres."). {#tmf_prod_order-GET-ord-productOrder-id__table_kqy_wgy_fsb__entry__2} | En-tête | Description | |-|-| | Aucun | | [Tableau 10. En-têtes de demandes] {#tmf_prod_order-GET-ord-productOrder-id__table_kqy_wgy_fsb} {#tmf_prod_order-GET-ord-productOrder-id__table_tzy_thy_ksb__entry__2} | En-tête | Description | |-|-| | Type de contenu | Format de données du corps de la réponse. Ne prend en charge application/jsonque les fichiers . | [Tableau 11. En-têtes de réponses] {#tmf_prod_order-GET-ord-productOrder-id__table_tzy_thy_ksb} ### Codes d'état Les codes d'état suivants s'appliquent à cette action HTTP. Pour obtenir la liste des codes d'état possibles utilisés dans l'API REST, consultez [Codes de réponse HTTP de l'API REST](https://servicenow-prod.fluidtopics.net/CFQa7z9NIrhoOq1u1cRN7g "REST (REpresentational State Transfer) est une architecture simple sans état qui fournit des normes entre les systèmes informatiques sur le Web, ce qui leur permet de communiquer plus facilement les uns avec les autres."). {#tmf_prod_order-GET-ord-productOrder-id__tmf-get-list-status-codes__entry__2} | Code d'état | Description | |-|-| | 200 | Demande traitée avec succès. Ressource complète renvoyée en réponse (aucune pagination). La réponse est renvoyée avec un message d'erreur si la commande sélectionnée présente des problèmes de traitement. * Une réponse 200 OK se produit si la commande se trouve dans la table File d'attente entrante \[sn_tmt_core_inbound_queue\] en attente que le planificateur sélectionne l'enregistrement à traiter. Le champ de message d'erreur inclut les détails de l'enregistrement. Par exemple : { "code": 102, "reason": "Request in queue", "message": "Request in queue", "details": [ { "message": "This Order is still in the inbound queue table waiting to be processed.", "datapath": "" } ] } * Une réponse 200 OK se produit si la création d'une commande échoue et que l'enregistrement de la table File d'attente entrante \[sn_tmt_core_inbound_queue\] présente un état d'erreur. Le champ de message d'erreur inclut des détails pour l'enregistrement de la table de file d'attente entrante. Par exemple : { "code": 23, "reason": "Missing body field", "message": "Missing body field", "details": [ { "message": "Invalid payload: orderCurrency is missing", "datapath": "/" } ] } {#tmf_prod_order-GET-ord-productOrder-id__ul_kdw_y4w_fwb} | | 206 | Ressource partielle renvoyée en réponse (avec pagination). | | 400 | Demande incorrecte. Raisons possibles : * Paramètre de chemin d'accès non valide * URI non valide {#tmf_prod_order-GET-ord-productOrder-id__ul_rys_1gy_fsb} | | 404 | Enregistrement introuvable. Aucun enregistrement correspondant aux paramètres de requête n'a été trouvé dans la table. | [Tableau 12. Codes d'état] {#tmf_prod_order-GET-ord-productOrder-id__tmf-get-list-status-codes} ### Paramètres de corps de réponse (JSON) {#tmf_prod_order-GET-ord-productOrder-id__entry__32}{#tmf_prod_order-GET-ord-productOrder-id__externalProdInv-resp-descr}{#tmf_prod_order-GET-ord-productOrder-id__externalProdInvId-resp-descr} | Nom | Description | |-|-| | canal | Tableau d'objets qui décrivent les canaux à utiliser pour vendre les produits. Type de données : tableau "channel": [ { "id": "String", "name": "String" } ] | | channel.id | Identificateur unique du canal à utiliser pour vendre les produits associés. Les valeurs d'ID de canal se trouvent dans le champ external_id de la table Canal de distribution \[sn_prd_pm_distribution_channel\]. Type de données : chaîne | | channel.name | Nom du canal à utiliser pour vendre les produits associés. Type de données : chaîne | | committedDueDate | Date et heure auxquelles l'action doit être effectuée sur la commande. Cette valeur doit être identique ou ultérieure aux valeurs de committedDueDate chaque élément de ligne de commande. Type de données : chaîne | | expectedCompletionDate | Date à laquelle la commande sera terminée. Type de données : chaîne | | href | Lien relatif à l'enregistrement de commande de produit. Type de données : chaîne | | id | Sys_id de la commande de produit. Type de données : chaîne | | note | Tableau d'objets qui décrivent les notes supplémentaires prises par le client lors de la commande. Type de données : tableau "note": [ { "author": "String", "date": "String", "text": "String" } ] | | note.auteur | Nom d'utilisateur de la personne qui a rédigé la note associée. Type de données : chaîne | | note.date | Date de création de la note. Type de données : chaîne | | note.texte | Remarques/commentaires supplémentaires formulés par le client lors de la commande. Type de données : chaîne | | orderCurrency | Code de devise pour la commande et les éléments de ligne de commande. Type de données : chaîne | | ponr | Marqueur indiquant si le point de non retour de la commande a été atteint. Valeurs valides : * true : le point de non-retour de la commande a été atteint. * false : le point de non-retour de la commande n'a pas été atteint. {#tmf_prod_order-GET-ord-productOrder-id__ul_tdq_rw1_hqb} Type de données : booléennes | | Élément de commande produit | Liste décrivant les éléments associés à la commande de produit et leur action associée. Type de données : tableau "productOrderItem:" [ { "action": "String", "actionReason": "String", "committedDueDate": "String", "externalProductInventory": [Array], "id": "String", "itemPrice": [Array], "product": {Object}, "productOffering": {Object}, "productOrderItemReleationship": [Array], "quantity": Number, "state": "String", "@type": "String" } ] | | productOrderItem.action | Action à effectuer sur le produit. Les actions possibles sont définies dans l'onglet Liste de choix de l'entrée du dictionnaire d'actions de la table sn_ind_tmt_orm_order_line_item. Type de données : chaîne | | Élément de commandeproduit.actionReason | Motif de l'ajout de l'élément de ligne de commande. Type de données : chaîne Table/champ mis à jour : sn_ind_tmt_orm_order_line_item/action_reason | | productOrderItem.committedDueDate | Date et heure auxquelles l'action doit être effectuée sur l'élément de ligne de commande. Type de données : chaîne | | productOrderItem.externalProductInventory | Tableau d'objets contenant des ID externes mappés aux inventaires de produits créés pour la commande. Type de données : tableau "externalProductInventory": [ { "externalProductInventoryId": "String" } ] | | productOrderItem.externalProductInventory.externalProductInventoryId | ID externe mappé à l'inventaire des produits. Type de données : chaîne | | productOrderItem.id | Identificateur unique de l'élément de ligne. Situé dans le champ sn_ind_tmt_orm_external_id de la table Élément de ligne de commande \[sn_ind_tmt_orm_order_line_item\]. Type de données : chaîne | | productOrderItem.itemPrice | Tableau d'objets décrivant le prix associé au produit. Type de données : tableau "itemPrice": [ { "price": {Object}, "priceType": "String", "recurringChargePeriod": "String" } ] | | productOrderItem.itemPrice.price | Description du prix du produit associé. Type de données : objet "price": { "taxIncludedAmount": {Object} } | | productOrderItem.itemPrice.price.taxIncludedAmount | Description du prix du produit associé, taxes comprises. Type de données : objet "taxIncludedAmount": { "unit": "String", "value": Number } | | productOrderItem.itemPrice.price.taxIncludedAmount.unit | Code de devise dans lequel le prix est représenté. Type de données : chaîne | | productOrderItem.itemPrice.price.taxIncludedAmount.value | Prix du produit, toutes taxes comprises. Type de données : nombre | | productOrderItem.itemPrice.priceType | Type de prix de l'article, récurrent ou non récurrent. Type de données : chaîne | | productOrderItem.itemPrice.recurringChargePeriod | Si le prix est récurrent, la période récurrente, par exemple le mois. Type de données : chaîne | | ArticleCommandeProduit.ponr | Marqueur indiquant si le point de non retour de la commande a été atteint. Valeurs valides : * true : le point de non-retour de la commande a été atteint. * false : le point de non-retour de la commande n'a pas été atteint. {#tmf_prod_order-GET-ord-productOrder-id__d2876e2597} Type de données : booléennes | | productOrderItem.product | Description des détails de l'instance du produit acheté par le client. Type de données : objet "product:" { "place": {Object}, "productCharacteristic": [Array], "productRelationship": [Array], "productSpecification": {Object}, "relatedParty": {Object}, "@type": "String" } | | productOrderItem.product.place | Cartes des emplacements sur lesquels installer le produit. Type de données : objet "place": { "id": "String", "@type": "String" } | | productOrderItem.product.place.id | Sys_id de l'enregistrement de l'emplacement associé dans la table Emplacement \[cmn_location\]. Type de données : chaîne | | productOrderItem.product.place.@type | Fait partie de la norme TMF Open API. Annotation pour le contact de l'élément de ligne de commande. Cette valeur est toujours Place. Ces informations ne sont pas stockées. Type de données : chaîne | | productOrderItem.product.productCharacteristic | Tableau d'objets décrivant les caractéristiques du produit associé. Seules les caractéristiques des produits qui value sont différentes de celles previousValue sont retournées. Type de données : tableau "productCharacteristic": [ { "name": "String", "previousValue": "String", "value": "String" } ] | | productOrderItem.product.productCharacteristic.name | Nom de l'enregistrement de la caractéristique à associer au produit. Situé dans la table Caractéristique \[sn_prd_pm_characteristic\]. Type de données : chaîne | | productOrderItem.product.productCharacteristic.previousValue | Valeurs d'option de caractéristique précédentes si la mise à jour concerne un ordre de changement. La demande est un ordre de changement si le paramètre est autre que ajouterproductOrderItem.action. Pour plus d'informations sur les valeurs des options de caractéristique, reportez-vous à la section [Create product characteristics and characteristic options](https://www.servicenow.com/docs/access?context=som-product-config-add-characteristics&version=xanadu&pubname=xanadu-order-management&ft:locale=en-US). Type de données : chaîne | | productOrderItem.product.productCharacteristic.value | Valeurs d'option de caractéristique associées au produit. Pour plus d'informations sur les valeurs des options de caractéristique, reportez-vous à la section [Create product characteristics and characteristic options](https://www.servicenow.com/docs/access?context=som-product-config-add-characteristics&version=xanadu&pubname=xanadu-order-management&ft:locale=en-US). Type de données : chaîne | | productOrderItem.product.productRelationship | Liste des détails de relation de produit pour un élément de ligne de commande. Type de données : tableau "productRelationship": [ { "id": "String", "relationshipType": "String" } ] | | productOrderItem.product.productRelationship.id | Sys_id ou sn_prd_invt_external_id de l'inventaire des produits. Situé dans le champ sys_id ou sn_prd_invt_external_id de la table Inventaire des produits \[sn_prd_invt_product_inventory\]. Type de données : chaîne | | productOrderItem.product.productRelationship.relationshipType | Type de relation entre l'élément de ligne de commande et l'inventaire des produits. Valeur possible : nécessite Type de données : chaîne | | productOrderItem.product.productSpecification | Description de la spécification du produit associée au produit. Type de données : objet "productSpecification:" { "id": "String", "internalId": "String", "internalVersion": "String", "name": "String", "version": "String", "@type": "String" } | | productOrderItem.product.productSpecification.id | Initial_version ou external_id des spécifications du produit. Le initial_version est le sys_id de la première version de la spécification. Situé dans le champ sys_id ou external_id de la table Spécification de produit \[sn_prd_pm_product_specification\]. Type de données : chaîne | | productOrderItem.product.productSpecification.internalId | Initial_version des spécifications du produit. Le initial_version est le sys_id de la première version de la spécification. Situé dans la table Spécification de produit \[sn_prd_pm_product_specification\]. Type de données : chaîne | | productOrderItem.product.productSpecification.internalVersion | Version de la spécification du produit. Situé dans la table Spécification de produit \[sn_prd_pm_product_specification\]. Type de données : chaîne | | productOrderItem.product.productSpecification.name | Nom de la spécification de produit. Situé dans la table Spécification de produit \[sn_prd_pm_product_specification\]. Type de données : chaîne | | productOrderItem.product.productSpecification.version | External_version des spécifications du produit. Situé dans la table Spécification de produit \[sn_prd_pm_product_specification\]. Type de données : chaîne | | productOrderItem.product.productSpecification.@type | Fait partie de la norme TMF Open API. Cette valeur est toujours ProductSpecificationRef. Ces informations ne sont pas stockées. Type de données : chaîne | | élémentcommandeproduit.produit.relatedparty | Liste des contacts pour les éléments de ligne. Type de données : tableau "relatedParty:" { "email": "String", "firstName": "String", "id": "String", "lastName": "String", "phone": "String", "@referredType": "String", "@type": "String" } | | productOrderItem.product.relatedParty.email | Adresse e-mail du contact. Type de données : chaîne | | productOrderItem.product.relatedParty.firstName | Prénom de la personne à contacter. Type de données : chaîne | | productOrderItem.product.relatedParty.id | Sys_id du contact de l'élément de ligne associé à l'élément de ligne de commande. Situé dans la table Contact de l'élément de ligne de commande \[sn_ind_tmt_orm_order_line_item_contact\]. Type de données : chaîne | | productOrderItem.product.relatedParty.lastName | Nom de famille du contact. Type de données : chaîne Type de données : chaîne | | productOrderItem.product.relatedParty.phone | Numéro de téléphone professionnel du contact. Type de données : chaîne | | productOrderItem.product.relatedParty.@referredType | Type de client. Valeur possible : OrderLineItemContact Type de données : chaîne | | productOrderItem.product.relatedParty.@type | Fait partie de la norme TMF Open API. Annotation pour le contact de l'élément de ligne de commande. Cette valeur est toujours RelatedParty. Ces informations ne sont pas stockées. Type de données : chaîne | | productOrderItem.productOffering | Description de l'offre de produit associée au produit. Type de données : objet "productOffering:" { "id": "String", "internalId": "String", "internalVersion": "String", "name": "String", "version": "String" } | | productOrderItem.productOffering.id | Initial_version ou external_id de l'offre de produits. Le initial_version est le sys_id de la première version de l'offre. Situé dans le champ sys_id ou external_id de la table Offre de produits \[sn_prd_pm_product_offering\]. Type de données : chaîne | | productOrderItem.productOffering.internalId | Initial_version de l'offre de produits. Le initial_version est le sys_id de la première version de l'offre. Situé dans la table Offre de produits \[sn_prd_pm_product_offering\]. Type de données : chaîne | | productOrderItem.productOffering.internalVersion | Version de l'offre de produit. Situé dans la table Offre de produits \[sn_prd_pm_product_offering\]. Type de données : chaîne | | productOrderItem.productOffering.name | Nom de l'offre de produits. Situé dans la table Offre de produits \[sn_prd_pm_product_offering\]. Type de données : chaîne | | Élément de commandedeproduit.offredeproduit.version | External_version de l'offre de produits. Situé dans la table Offre de produits \[sn_prd_pm_product_offering\]. Type de données : chaîne | | productOrderItem.quantity | Nombre d'éléments de produit achetés. Type de données : nombre | | productOrderItem.productOrderItemRelationship | Tableau d'objets décrivant les relations entre les éléments de ligne de commande. Type de données : tableau "productOrderItemRelationship": [ { "id": "String", "relationshipType": "String" } ] | | productOrderItem.productOrderItemRelationship.id | Identificateur unique de l'élément de ligne connexe. Situé dans le champ sn_ind_tmt_orm_external_id de la table Élément de ligne de commande \[sn_ind_tmt_orm_order_line_item\]. Type de données : chaîne | | productOrderItem.productOrderItemRelationship.relationshipType | Type de relation entre les deux éléments de ligne. Ces informations sont utilisées pour identifier la hiérarchie des relations. Valeurs possibles : * HasChild (en anglais seulement) * HasParent (en anglais seulement) * Exige {#tmf_prod_order-GET-ord-productOrder-id__ul_yqf_2ty_54b} `HasChild` et `HasParent` sont utilisés pour les relations parent/enfant. `Exige` est utilisé pour les relations horizontales (un élément de ligne nécessite un autre élément de ligne). Type de données : chaîne | | élémentcommandeproduit.état | État de la commande de l'élément de produit associé. Type de données : chaîne | | productOrderItem.version | Version de la commande. Type de données : chaîne | | productOrderItem.@type | Fait partie de la norme TMF Open API. Annotation pour le produit. Cette valeur est toujours ProductOrderItem. Ces informations ne sont pas stockées. Type de données : chaîne | | relatedParty | Liste des contacts de la commande. Chaque contact est un objet dans le tableau. Doit énumérer au moins un élément qui contient des informations sur le compte client ou le compte de consommateur. Type de données : tableau "relatedParty:" [ { "id": "String", "name": "String", "@referredType": "String", "@type": "String" } ] | | relatedParty.id | Sys_id ou external_id du compte, du contact client ou du consommateur associé à la commande. Situé dans la table Compte \[customer_account\], Contact \[customer_contact\] ou Consommateur \[csm_consumer\]. Type de données : chaîne | | relatedParty.name | Nom du compte, du client ou du consommateur. Type de données : chaîne | | relatedParty.@referredType | Type de client. Valeurs possibles : * Consommateur * Client * Contact du client {#tmf_prod_order-GET-ord-productOrder-id__ul_lcq_jwm_t4b} Type de données : chaîne | | relatedParty.@type | Fait partie de la norme TMF Open API. Annotation pour le produit. Cette valeur est toujours RelatedParty. Ces informations ne sont pas stockées. Type de données : chaîne | | requestedCompletionDate | Date de livraison demandée par le client. Type de données : chaîne | | Date de début demandée | Date de début de commande demandée par le client. Type de données : chaîne | | État | État actuel de la commande. Type de données : chaîne | | version | Version de la commande. Type de données : chaîne | | @type | Fait partie de la norme TMF Open API. Annotation pour le produit. Cette valeur est toujours ProductOrder. Ces informations ne sont pas stockées. Type de données : chaîne | [ ] ### Demande cURL Cet exemple récupère une commande de produit spécifiée. curl -X GET "https://instance.service-now.com/api/sn_ind_tmt_orm/order/productOrder/8d75939453126010a795ddeeff7b126a" \ -u "username":"password" Corps de réponse. { "id": "8d75939453126010a795ddeeff7b126a", "href": "/api/sn_ind_tmt_orm/order/productOrder/8d75939453126010a795ddeeff7b126a", "ponr": "false", "orderCurrency": "USD", "expectedCompletionDate": "2021-05-02T08:13:59.000Z", "requestedCompletionDate": "2021-05-02T08:13:59.000Z", "requestedStartDate": "2020-05-03T08:13:59.000Z", "channel": [ { "id": "1", "name": "Agent Assist" } ], "note": [ { "author": "System Administrator", "date": "2021-02-25T14:22:07.000Z", "text": "This is a TMF product order illustration no 2" }, { "author": "System Administrator", "date": "2021-02-25T14:22:06.000Z", "text": "This is a TMF product order illustration" } ], "productOrderItem": [ { "id": "POI130", "ponr": "false", "quantity": 1, "action": "add", "actionReason": "adding service package OLI", "itemPrice": [ { "priceType": "recurring", "price": { "taxIncludedAmount": { "unit": "USD", "value": 20 } } }, { "priceType": "nonRecurring", "price": { "taxIncludedAmount": { "unit": "INR", "value": 0 } } } ], "product": { "@type": "Product", "productCharacteristic": [ { "name": "Security Type", "valueType": "Choice", "value": "Base", "previousValue": "" } ], "productSpecification": { "id": "a6514bd3534560102f18ddeeff7b1247", "name": "SD-WAN Security", "version": "v1", "internalVersion": "1", "internalId": "a6514bd3534560102f18ddeeff7b1247", "@type": "ProductSpecificationRef" }, "relatedParty": [ { "id": "4175939453126010a795ddeeff7b127d", "name": "John Smith", "email": "abc2@example.com", "phone": "32456768", "@type": "RelatedParty", "@referredType": "OrderLineItemContact" }, { "id": "c175939453126010a795ddeeff7b127c", "name": "Joe Doe", "email": "abc@example.com", "phone": "1234567890", "@type": "RelatedParty", "@referredType": "OrderLineItemContact" } ] }, "productOffering": { "id": "69017a0f536520103b6bddeeff7b127d", "name": "Premium SD-WAN Offering", "version": "v1", "internalId": "69017a0f536520103b6bddeeff7b127d", "internalVersion": "1" }, "productOrderItemRelationship": [ { "id": "POI100", "relationshipType": "HasParent" } ], "state": "in_progress", "version": "1", "@type": "ProductOrderItem" }, { "id": "POI100", "ponr": "false", "quantity": 1, "action": "add", "actionReason":"adding service package OLI", "itemPrice": [ { "priceType": "recurring", "price": { "taxIncludedAmount": { "unit": "INR", "value": 0 } } }, { "priceType": "nonRecurring", "price": { "taxIncludedAmount": { "unit": "INR", "value": 0 } } } ], "product": { "@type": "Product", "productSpecification": { "id": "cfe5ef6a53702010cd6dddeeff7b12f6", "name": "SD-WAN Service Package", "version": "v1", "internalVersion": "1", "internalId": "cfe5ef6a53702010cd6dddeeff7b12f6", "@type": "ProductSpecificationRef" } }, "productOffering": { "id": "69017a0f536520103b6bddeeff7b127d", "name": "Premium SD-WAN Offering", "version": "v1", "internalId": "69017a0f536520103b6bddeeff7b127d", "internalVersion": "1" }, "productOrderItemRelationship": [ { "id": "POI130", "relationshipType": "HasChild" }, { "id": "POI120", "relationshipType": "HasChild" }, { "id": "POI110", "relationshipType": "HasChild" } ], "state": "in_progress", "version": "1", "@type": "ProductOrderItem" }, { "id": "POI120", "ponr": "false", "quantity": 1, "action": "add", "actionReason": "adding service package OLI", "itemPrice": [ { "priceType": "recurring", "price": { "taxIncludedAmount": { "unit": "USD", "value": 20 } } }, { "priceType": "nonRecurring", "price": { "taxIncludedAmount": { "unit": "INR", "value": 0 } } } ], "product": { "@type": "Product", "productCharacteristic": [ { "name": "CPE Type", "valueType": "Choice", "value": "Physical", "previousValue": "" }, { "name": "WAN Optimization", "valueType": "Choice", "value": "Advance", "previousValue": "" }, { "name": "Routing", "valueType": "Choice", "value": "Premium", "previousValue": "" }, { "name": "CPE Model", "valueType": "Choice", "value": "ASR", "previousValue": "" } ], "productSpecification": { "id": "39b627aa53702010cd6dddeeff7b1202", "name": "SD-WAN Edge Device", "version": "v1", "internalVersion": "1", "internalId": "39b627aa53702010cd6dddeeff7b1202", "@type": "ProductSpecificationRef" }, "productRelationship": [ { "id": "326d13f45b5620102dff5e92dc81c785", "relationshipType": "Requires" } ] }, "productOffering": { "id": "69017a0f536520103b6bddeeff7b127d", "name": "Premium SD-WAN Offering", "version": "v1", "internalVersion": "1", "internalId": "69017a0f536520103b6bddeeff7b127d" }, "productOrderItemRelationship": [ { "id": "POI100", "relationshipType": "HasParent" }, { "id": "POI110", "relationshipType": "Requires" } ], "state": "in_progress", "version": "1", "@type": "ProductOrderItem" }, { "id": "POI110", "ponr": "false", "quantity": 1, "action": "add", "actionReason": "adding service package OLI", "itemPrice": [ { "priceType": "recurring", "price": { "taxIncludedAmount": { "unit": "INR", "value": 0 } } }, { "priceType": "nonRecurring", "price": { "taxIncludedAmount": { "unit": "USD", "value": 5 } } } ], "product": { "@type": "Product", "productCharacteristic": [ { "name": "Tenancy", "valueType": "Choice", "value": "Base (10 site)", "previousValue": "" } ], "productSpecification": { "id": "216663aa53702010cd6dddeeff7b12b5", "name": "SD-WAN Controller", "version": "v1", "internalVersion": "1", "internalId": "216663aa53702010cd6dddeeff7b12b5", "@type": "ProductSpecificationRef" }, "place": { "id": "25ab9c4d0a0a0bb300f7dabdc0ca7c1c", "@type": "Place" } }, "productOffering": { "id": "69017a0f536520103b6bddeeff7b127d", "name": "Premium SD-WAN Offering", "version": "v1", "internalId": "69017a0f536520103b6bddeeff7b127d", "internalVersion": "1" }, "productOrderItemRelationship": [ { "id": "POI100", "relationshipType": "HasParent" } ], "state": "in_progress", "version": "1", "@type": "ProductOrderItem" } ], "relatedParty": [ { "id": "eaf68911c35420105252716b7d40ddde", "name": "Sally Thomas", "@type": "RelatedParty", "@referredType": "CustomerContact" }, { "id": "ffc68911c35420105252716b7d40dd55", "name": "Funco Intl", "@type": "RelatedParty", "@referredType": "Customer" }, { "id": "59f16de1c3b67110ff00ed23a140dd9e", "name": "Funco External", "@type": "RelatedParty", "@referredType": "Consumer" } ], "state": "in_progress", "version": "1", "@type": "ProductOrder" } ## API ouverte de commande de produit : GET /sn_ind_tmt_orm/productorder {#ariaid-title4} Récupère toutes les commandes de produits. Important : Ce point de terminaison est obsolète à partir de la Tokyo mise en production. La nouvelle version de ce point de terminaison est [Commande de produit Ouvrir l'API : GET /sn_ind_tmt_orm/order/productOrder](https://servicenow-prod.fluidtopics.net/7R48AWEcFp5whb2FwX7mKg#tmf_prod_order-GET-ord-productOrder "Récupère toutes les commandes de produits."). Ce point de terminaison récupère les informations de commande à partir des tables suivantes : * Commande de clients \[sn_ind_tmt_orm_order\] * Caractéristique de commande \[sn_ind_tmt_orm_order_characteristic_value\] * Élément de ligne de commande \[sn_ind_tmt_orm_order_line_item\] * Contact de l'élément de ligne de commande \[sn_ind_tmt_orm_order_line_item_contact\] {#tmf_prod_order-GET-productorder__ul_lxc_kxm_t4b} ### Format d'URL {#tmf_prod_order-GET-productorder__section_mbm_2ct_t4b} URL par défaut : /api/sn_ind_tmt_orm/productorder ### Paramètres de demande pris en charge {#tmf_prod_order-GET-productorder__table_ofr_vgy_fsb__entry__2} | Nom | Description | |-|-| | Aucun | | [Tableau 13. Paramètres de chemin d'accès] {#tmf_prod_order-GET-productorder__table_ofr_vgy_fsb} {#tmf_prod_order-GET-productorder__table_pfr_vgy_fsb__entry__2} | Nom | Description | |-|-| | champs | Liste des champs à renvoyer dans la réponse. Les champs non valides sont ignorés. Type de données : chaîne Par défaut : tous les champs renvoyés. | | limite | Nombre maximal d'enregistrements à renvoyer. Pour les demandes qui dépassent ce nombre d'enregistrements, utilisez le paramètre pour paginer la récupération de l'enregistrement offset . Par défaut : 20 Maximum : 100 Type de données : nombre | | décalage | Index de départ auquel commencer à récupérer des enregistrements. Utilisez cette valeur pour paginer la récupération des enregistrements. Cette fonctionnalité permet de récupérer tous les enregistrements, quel que soit le nombre d'enregistrements, par petits blocs gérables. Par défaut : 0 Type de données : nombre | | État | Filtrer les commandes par état. Seules les commandes dont l'état correspond à la valeur de ce paramètre sont renvoyées dans la réponse. Type de données : chaîne Par défaut : tous les états sont renvoyés. | [Tableau 14. Paramètres de requête] {#tmf_prod_order-GET-productorder__table_pfr_vgy_fsb} {#tmf_prod_order-GET-productorder__table_xcm_cvr_nsb__entry__2} | Nom | Description | |-|-| | Aucun | | [Tableau 15. Paramètres du corps de la demande (JSON)] {#tmf_prod_order-GET-productorder__table_xcm_cvr_nsb} ### En-têtes Les en-têtes de demande et de réponse suivants s'appliquent à cette action HTTP uniquement ou s'appliquent à cette action d'une manière distincte. Pour obtenir la liste des en-têtes généraux utilisés dans l'API REST, consultez [En-têtes d'API REST pris en charge](https://servicenow-prod.fluidtopics.net/CFQa7z9NIrhoOq1u1cRN7g "REST (REpresentational State Transfer) est une architecture simple sans état qui fournit des normes entre les systèmes informatiques sur le Web, ce qui leur permet de communiquer plus facilement les uns avec les autres."). {#tmf_prod_order-GET-productorder__table_kqy_wgy_fsb__entry__2} | En-tête | Description | |-|-| | Aucun | | [Tableau 16. En-têtes de demandes] {#tmf_prod_order-GET-productorder__table_kqy_wgy_fsb} {#tmf_prod_order-GET-productorder__table_h4r_fxr_nsb__entry__2}{#tmf_prod_order-GET-productorder__content-range-row}{#tmf_prod_order-GET-productorder__content-type-row}{#tmf_prod_order-GET-productorder__links-pagination-row}{#tmf_prod_order-GET-productorder__x-total-count-descr} | En-tête | Description | |-|-| | Plage de contenu | Spécifie la plage de contenu renvoyée dans un appel paginé. Par exemple, si `offset=2` et `limit=3`, la valeur de l'en-tête Content-Range est `les éléments 3 à 5`. | | Type de contenu | Format de données du corps de la réponse. Ne prend en charge application/jsonque les fichiers . | | Lien | Contient les liens suivants pour parcourir les résultats de la requête. * premier * dernier * suivant * previous {#tmf_prod_order-GET-productorder__ul_zzk_sdm_lsb} | | X-Total-Count | Pour les requêtes paginées, cet en-tête indique le nombre total d'enregistrements disponibles sur le serveur. | [Tableau 17. En-têtes de réponses] {#tmf_prod_order-GET-productorder__table_h4r_fxr_nsb} ### Codes d'état Les codes d'état suivants s'appliquent à cette action HTTP. Pour obtenir la liste des codes d'état possibles utilisés dans l'API REST, consultez [Codes de réponse HTTP de l'API REST](https://servicenow-prod.fluidtopics.net/CFQa7z9NIrhoOq1u1cRN7g "REST (REpresentational State Transfer) est une architecture simple sans état qui fournit des normes entre les systèmes informatiques sur le Web, ce qui leur permet de communiquer plus facilement les uns avec les autres."). {#tmf_prod_order-GET-productorder__table_wdl_3xr_nsb__entry__2}{#tmf_prod_order-GET-productorder__tmf-get-status-200-p}{#tmf_prod_order-GET-productorder__tmf-get-status-206-entry}{#tmf_prod_order-GET-productorder__tmf-get-status-400-entry}{#tmf_prod_order-GET-productorder__tmf-get-status-404-entry} | Code d'état | Description | |-|-| | 200 | Demande traitée avec succès. Ressource complète renvoyée en réponse (aucune pagination). | | 206 | Ressource partielle renvoyée en réponse (avec pagination). | | 400 | Demande incorrecte. Raisons possibles : * Paramètre de chemin d'accès non valide * URI non valide {#tmf_prod_order-GET-productorder__ul_rys_1gy_fsb} | | 404 | Enregistrement introuvable. Aucun enregistrement correspondant aux paramètres de requête n'a été trouvé dans la table. | [Tableau 18. Codes d'état] {#tmf_prod_order-GET-productorder__table_wdl_3xr_nsb} ### Paramètres de corps de réponse (JSON) {#tmf_prod_order-GET-productorder__section_hnf_kxr_nsb} {#tmf_prod_order-GET-productorder__table_inf_kxr_nsb__entry__2} | Nom | Description | |-|-| | canal | Tableau d'objets qui décrivent les canaux à utiliser pour vendre les produits. Type de données : tableau "channel": [ { "id": "String", "name": "String" } ] | | channel.id | Identificateur unique du canal à utiliser pour vendre les produits associés. Les valeurs d'ID de canal se trouvent dans le champ external_id de la table Canal de distribution \[sn_prd_pm_distribution_channel\]. Type de données : chaîne | | channel.name | Nom du canal à utiliser pour vendre les produits associés. Type de données : chaîne | | expectedCompletionDate | Date à laquelle la commande sera terminée. Type de données : chaîne | | note | Tableau d'objets qui décrivent les notes supplémentaires prises par le client lors de la commande. Type de données : tableau "note": { "author": "String", "date": "String", "text": "String" } | | note.auteur | Nom d'utilisateur de la personne qui a rédigé la note associée. Type de données : chaîne | | note.date | Date de création de la note. Type de données : chaîne | | note.texte | Remarques/commentaires supplémentaires formulés par le client lors de la commande. Type de données : chaîne | | ponr | Marqueur indiquant si le point de non retour de la commande a été atteint. Valeurs valides : * true : le point de non-retour de la commande a été atteint. * false : le point de non-retour de la commande n'a pas été atteint. {#tmf_prod_order-GET-productorder__ul_tdq_rw1_hqb} Type de données : booléennes | | Élément de commande produit | Liste décrivant les éléments associés à la commande de produit et leur action associée. Type de données : tableau "productOrderItem:" [ { "action": "String", "actionReason": "String", "id": "String", "itemPrice": [Array], "product": {Object}, "productOffering": {Object}, "productOrderItemReleationship": [Array], "quantity": Number, "state": "String", "@type": "String" } ] | | productOrderItem.action | Action à effectuer sur le produit. Les actions possibles sont définies dans l'onglet Liste de choix de l'entrée du dictionnaire d'actions de la table sn_ind_tmt_orm_order_line_item. Type de données : chaîne | | Élément de commandeproduit.actionReason | Motif de l'ajout de l'élément de ligne de commande. Type de données : chaîne Table/champ mis à jour : sn_ind_tmt_orm_order_line_item/action_reason | | productOrderItem.id | Identificateur unique de l'élément de ligne. Situé dans le champ sn_ind_tmt_orm_external_id de la table Élément de ligne de commande \[sn_ind_tmt_orm_order_line_item\]. Type de données : chaîne | | productOrderItem.itemPrice | Tableau d'objets décrivant le prix associé au produit. Type de données : tableau "itemPrice": [ { "price": {Object}, "priceType": "String", "recurringChargePeriod": "String" } ] | | productOrderItem.itemPrice.price | Description du prix du produit associé. Type de données : objet "price": { "taxIncludedAmount": {Object} } | | productOrderItem.itemPrice.price.taxIncludedAmount | Description du prix du produit associé, taxes comprises. Type de données : objet "taxIncludedAmount": { "unit": "String", "value": Number } | | productOrderItem.itemPrice.price.taxIncludedAmount.unit | Code de devise dans lequel le prix est représenté. Type de données : chaîne | | productOrderItem.itemPrice.price.taxIncludedAmount.value | Prix du produit, toutes taxes comprises. Type de données : nombre | | productOrderItem.itemPrice.priceType | Type de prix de l'article, récurrent ou non récurrent. Type de données : chaîne | | productOrderItem.itemPrice.recurringChargePeriod | Si le prix est récurrent, la période récurrente, par exemple le mois. Type de données : chaîne | | ArticleCommandeProduit.ponr | Marqueur indiquant si le point de non retour de la commande a été atteint. Valeurs valides : * true : le point de non-retour de la commande a été atteint. * false : le point de non-retour de la commande n'a pas été atteint. {#tmf_prod_order-GET-productorder__d2876e2597} Type de données : booléennes | | productOrderItem.product | Description des détails de l'instance du produit acheté par le client. Type de données : objet "product:" { "place": {Object}, "productCharacteristic": [Array], "productSpecification": {Object}, "relatedParty": {Object}, "@type": "String" } | | productOrderItem.product.place | Cartes des emplacements sur lesquels installer le produit. Type de données : objet "place": { "id": "String", "@type": "String" } | | productOrderItem.product.place.id | Sys_id de l'enregistrement de l'emplacement associé dans la table Emplacement \[cmn_location\]. Type de données : chaîne | | productOrderItem.product.place.@type | Fait partie de la norme TMF Open API. Annotation pour le contact de l'élément de ligne de commande. Cette valeur est toujours Place. Ces informations ne sont pas stockées. Type de données : chaîne | | productOrderItem.product.productCharacteristic | Tableau d'objets décrivant les caractéristiques du produit associé. Seules les caractéristiques des produits qui value sont différentes de celles previousValue sont retournées. Type de données : tableau "productCharacteristic": [ { "name": "String", "previousValue": "String", "value": "String" } ] | | productOrderItem.product.productCharacteristic.name | Nom de l'enregistrement de la caractéristique à associer au produit. Situé dans la table Caractéristique \[sn_prd_pm_characteristic\]. Type de données : chaîne | | productOrderItem.product.productCharacteristic.previousValue | Valeurs d'option de caractéristique précédentes si la mise à jour concerne un ordre de changement. La demande est un ordre de changement si le paramètre est autre que ajouterproductOrderItem.action. Pour plus d'informations sur les valeurs des options de caractéristique, reportez-vous à la section [Create product characteristics and characteristic options](https://www.servicenow.com/docs/access?context=som-product-config-add-characteristics&version=xanadu&pubname=xanadu-order-management&ft:locale=en-US). Type de données : chaîne | | productOrderItem.product.productCharacteristic.value | Valeurs d'option de caractéristique associées au produit. Pour plus d'informations sur les valeurs des options de caractéristique, reportez-vous à la section [Create product characteristics and characteristic options](https://www.servicenow.com/docs/access?context=som-product-config-add-characteristics&version=xanadu&pubname=xanadu-order-management&ft:locale=en-US). Type de données : chaîne | | productOrderItem.product.productSpecification | Description de la spécification du produit associée au produit. Type de données : objet "productSpecification:" { "id": "String", "name": "String", "@type": "String" } | | productOrderItem.product.productSpecification.id | Initial_version ou external_id des spécifications du produit. Le initial_version est le sys_id de la première version de la spécification. Situé dans le champ sys_id ou external_id de la table Spécification de produit \[sn_prd_pm_product_specification\]. Type de données : chaîne | | productOrderItem.product.productSpecification.name | Nom de la spécification de produit. Situé dans la table Spécification de produit \[sn_prd_pm_product_specification\]. Type de données : chaîne | | productOrderItem.product.productSpecification.@type | Fait partie de la norme TMF Open API. Cette valeur est toujours ProductSpecificationRef. Ces informations ne sont pas stockées. Type de données : chaîne | | élémentcommandeproduit.produit.relatedparty | Liste des contacts pour les éléments de ligne. Type de données : tableau "relatedParty:" { "email": "String", "firstName": "String", "id": "String", "lastName": "String", "phone": "String", "@referredType": "String", "@type": "String" } | | productOrderItem.product.relatedParty.email | Adresse e-mail du contact. Type de données : chaîne | | productOrderItem.product.relatedParty.firstName | Prénom de la personne à contacter. Type de données : chaîne | | productOrderItem.product.relatedParty.id | Sys_id du contact de l'élément de ligne associé à l'élément de ligne de commande. Situé dans la table Contact de l'élément de ligne de commande \[sn_ind_tmt_orm_order_line_item_contact\]. Type de données : chaîne | | productOrderItem.product.relatedParty.lastName | Nom de famille du contact. Type de données : chaîne Type de données : chaîne | | productOrderItem.product.relatedParty.phone | Numéro de téléphone professionnel du contact. Type de données : chaîne | | productOrderItem.product.relatedParty.@referredType | Type de client. Valeur possible : OrderLineItemContact Type de données : chaîne | | productOrderItem.product.relatedParty.@type | Fait partie de la norme TMF Open API. Annotation pour le contact de l'élément de ligne de commande. Cette valeur est toujours RelatedParty. Ces informations ne sont pas stockées. Type de données : chaîne | | productOrderItem.productOffering | Description de l'offre de produit associée au produit. Type de données : objet "productOffering": { "id": "String", "internalVersion": "String", "name": "String", "version": "String" } | | productOrderItem.productOffering.id | Initial_version ou external_id de l'offre de produits. Le initial_version est le sys_id de la première version de l'offre. Situé dans le champ sys_id ou external_id de la table Offre de produits \[sn_prd_pm_product_offering\]. Type de données : chaîne | | productOrderItem.productOffering.name | Nom de l'offre de produits. Situé dans la table Offre de produits \[sn_prd_pm_product_offering\]. Type de données : chaîne | | productOrderItem.quantity | Nombre d'éléments de produit achetés. Type de données : nombre | | productOrderItem.productOrderItemRelationship | Tableau d'objets décrivant les relations entre les éléments de ligne de commande. Type de données : tableau "productOrderItemRelationship": [ { "id": "String", "relationshipType": "String" } ] | | productOrderItem.productOrderItemRelationship.id | Identificateur unique de l'élément de ligne connexe. Situé dans le champ sn_ind_tmt_orm_external_id de la table Élément de ligne de commande \[sn_ind_tmt_orm_order_line_item\]. Type de données : chaîne | | productOrderItem.productOrderItemRelationship.relationshipType | Type de relation entre les deux éléments de ligne. Ces informations sont utilisées pour identifier la hiérarchie des relations. Valeurs possibles : * HasChild (en anglais seulement) * HasParent (en anglais seulement) * Exige {#tmf_prod_order-GET-productorder__ul_yqf_2ty_54b} `HasChild` et `HasParent` sont utilisés pour les relations parent/enfant. `Exige` est utilisé pour les relations horizontales (un élément de ligne nécessite un autre élément de ligne). Type de données : chaîne | | élémentcommandeproduit.état | État de la commande de l'élément de produit associé. Type de données : chaîne | | productOrderItem.version | Version de la commande. Type de données : chaîne | | productOrderItem.@type | Fait partie de la norme TMF Open API. Annotation pour le produit. Cette valeur est toujours ProductOrderItem. Ces informations ne sont pas stockées. Type de données : chaîne | | relatedParty | Liste des contacts de la commande. Chaque contact est un objet dans le tableau. Doit énumérer au moins un élément qui contient des informations sur le compte client ou le compte de consommateur. Type de données : tableau "relatedParty:" [ { "id": "String", "name": "String", "@referredType": "String", "@type": "String" } ] | | relatedParty.id | Sys_id ou external_id du compte, du contact client ou du consommateur associé à la commande. Situé dans la table Compte \[customer_account\], Contact \[customer_contact\] ou Consommateur \[csm_consumer\]. Type de données : chaîne | | relatedParty.name | Nom du compte, du client ou du consommateur. Type de données : chaîne | | relatedParty.@referredType | Type de client. Valeurs possibles : * Consommateur * Client * Contact du client {#tmf_prod_order-GET-productorder__ul_lcq_jwm_t4b} Type de données : chaîne | | relatedParty.@type | Fait partie de la norme TMF Open API. Annotation pour le produit. Cette valeur est toujours RelatedParty. Ces informations ne sont pas stockées. Type de données : chaîne | | requestedCompletionDate | Date de livraison demandée par le client. Type de données : chaîne | | Date de début demandée | Date de début de commande demandée par le client. Type de données : chaîne | | État | État actuel de la commande. Type de données : chaîne | | version | Version de la commande. Type de données : chaîne | | @type | Fait partie de la norme TMF Open API. Annotation pour le produit. Cette valeur est toujours ProductOrder. Ces informations ne sont pas stockées. Type de données : chaîne | [ ] {#tmf_prod_order-GET-productorder__table_inf_kxr_nsb} ### Demande cURL Cet exemple récupère toutes les commandes de produits. curl --location --request GET 'https://instance.servicenow.com/api/sn_ind_tmt_orm/productorder' \ --user 'username':'password' Corps de réponse. [ { "id": "8d75939453126010a795ddeeff7b126a", "ponr": "false", "expectedCompletionDate": "2021-05-02T08:13:59.000Z", "requestedCompletionDate": "2021-05-02T08:13:59.000Z", "requestedStartDate": "2020-05-03T08:13:59.000Z", "channel": [ { "id": "1", "name": "Agent Assist" } ], "note": [ { "author": "System Administrator", "date": "2021-02-25T14:22:07.000Z", "text": "This is a TMF product order illustration no 2" }, { "author": "System Administrator", "date": "2021-02-25T14:22:06.000Z", "text": "This is a TMF product order illustration" } ], "productOrderItem": [ { "id": "POI130", "ponr": "false", "quantity": 1, "action": "add", "actionReason": "adding service package OLI", "itemPrice": [ { "priceType": "recurring", "price": { "taxIncludedAmount": { "unit": "USD", "value": 20 } } }, { "priceType": "nonRecurring", "price": { "taxIncludedAmount": { "unit": "INR", "value": 0 } } } ], "product": { "@type": "Product", "productCharacteristic": [ { "name": "Security Type", "valueType": "Choice", "value": "Base", "previousValue": "" } ], "productSpecification": { "id": "a6514bd3534560102f18ddeeff7b1247", "name": "SD-WAN Security", "@type": "ProductSpecificationRef" }, "relatedParty": [ { "id": "4175939453126010a795ddeeff7b127d", "name": "John Smith", "email": "abc2@example.com", "phone": "32456768", "@type": "RelatedParty", "@referredType": "OrderLineItemContact" }, { "id": "c175939453126010a795ddeeff7b127c", "name": "Joe Doe", "email": "abc@example.com", "phone": "1234567890", "@type": "RelatedParty", "@referredType": "OrderLineItemContact" } ] }, "productOffering": { "id": "69017a0f536520103b6bddeeff7b127d", "name": "Premium SD-WAN Offering" }, "productOrderItemRelationship": [ { "id": "POI100", "relationshipType": "HasParent" } ], "state": "in_progress", "version": "1", "@type": "ProductOrderItem" }, { "id": "POI100", "ponr": "false", "quantity": 1, "action": "add", "itemPrice": [ { "priceType": "recurring", "price": { "taxIncludedAmount": { "unit": "INR", "value": 0 } } }, { "priceType": "nonRecurring", "price": { "taxIncludedAmount": { "unit": "INR", "value": 0 } } } ], "product": { "@type": "Product", "productSpecification": { "id": "cfe5ef6a53702010cd6dddeeff7b12f6", "name": "SD-WAN Service Package", "@type": "ProductSpecificationRef" } }, "productOffering": { "id": "69017a0f536520103b6bddeeff7b127d", "name": "Premium SD-WAN Offering" }, "productOrderItemRelationship": [ { "id": "POI130", "relationshipType": "HasChild" }, { "id": "POI120", "relationshipType": "HasChild" }, { "id": "POI110", "relationshipType": "HasChild" } ], "state": "in_progress", "version": "1", "@type": "ProductOrderItem" }, { "id": "POI120", "ponr": "false", "quantity": 1, "action": "add", "actionReason":"adding service package OLI", "itemPrice": [ { "priceType": "recurring", "price": { "taxIncludedAmount": { "unit": "USD", "value": 20 } } }, { "priceType": "nonRecurring", "price": { "taxIncludedAmount": { "unit": "INR", "value": 0 } } } ], "product": { "@type": "Product", "productCharacteristic": [ { "name": "CPE Type", "valueType": "Choice", "value": "Physical", "previousValue": "" }, { "name": "WAN Optimization", "valueType": "Choice", "value": "Advance", "previousValue": "" }, { "name": "Routing", "valueType": "Choice", "value": "Premium", "previousValue": "" }, { "name": "CPE Model", "valueType": "Choice", "value": "ASR", "previousValue": "" } ], "productSpecification": { "id": "39b627aa53702010cd6dddeeff7b1202", "name": "SD-WAN Edge Device", "@type": "ProductSpecificationRef" } }, "productOffering": { "id": "69017a0f536520103b6bddeeff7b127d", "name": "Premium SD-WAN Offering" }, "productOrderItemRelationship": [ { "id": "POI100", "relationshipType": "HasParent" } ], "state": "in_progress", "version": "1", "@type": "ProductOrderItem" }, { "id": "POI110", "ponr": "false", "quantity": 1, "action": "add", "actionReason": "adding service package OLI", "itemPrice": [ { "priceType": "recurring", "price": { "taxIncludedAmount": { "unit": "INR", "value": 0 } } }, { "priceType": "nonRecurring", "price": { "taxIncludedAmount": { "unit": "USD", "value": 5 } } } ], "product": { "@type": "Product", "productCharacteristic": [ { "name": "Tenancy", "valueType": "Choice", "value": "Base (10 site)", "previousValue": "" } ], "productSpecification": { "id": "216663aa53702010cd6dddeeff7b12b5", "name": "SD-WAN Controller", "@type": "ProductSpecificationRef" }, "place": { "id": "25ab9c4d0a0a0bb300f7dabdc0ca7c1c", "@type": "Place" } }, "productOffering": { "id": "69017a0f536520103b6bddeeff7b127d", "name": "Premium SD-WAN Offering" }, "productOrderItemRelationship": [ { "id": "POI100", "relationshipType": "HasParent" } ], "state": "in_progress", "version": "1", "@type": "ProductOrderItem" } ], "relatedParty": [ { "id": "eaf68911c35420105252716b7d40ddde", "name": "Sally Thomas", "@type": "RelatedParty", "@referredType": "CustomerContact" }, { "id": "ffc68911c35420105252716b7d40dd55", "name": "Funco Intl", "@type": "RelatedParty", "@referredType": "Customer" }, { "id": "59f16de1c3b67110ff00ed23a140dd9e", "name": "Funco External", "@type": "RelatedParty", "@referredType": "Consumer" } ], "state": "in_progress", "version": "1", "@type": "ProductOrder" } ] ## API ouverte de commande de produit : GET /sn_ind_tmt_orm/productorder/{id} {#ariaid-title5} Récupère la commande de produit spécifiée. Important : Ce point de terminaison est obsolète à partir de la Tokyo mise en production. La nouvelle version de ce point de terminaison est [Commande de produit API ouverte : GET /sn_ind_tmt_orm/order/productOrder/{id}](https://servicenow-prod.fluidtopics.net/7R48AWEcFp5whb2FwX7mKg#tmf_prod_order-GET-ord-productOrder-id "Récupère la commande de produit spécifiée."). Ce point de terminaison récupère les informations de commande à partir des tables suivantes : * Commande de clients \[sn_ind_tmt_orm_order\] * Caractéristique de commande \[sn_ind_tmt_orm_order_characteristic_value\] * Élément de ligne de commande \[sn_ind_tmt_orm_order_line_item\] * Contact de l'élément de ligne de commande \[sn_ind_tmt_orm_order_line_item_contact\] {#tmf_prod_order-GET-productOrder-id__ul_lxc_kxm_t4b} ### Format d'URL {#tmf_prod_order-GET-productOrder-id__section_mbm_2ct_t4b} URL par défaut : /api/sn_ind_tmt_orm/productorder/{id} ### Paramètres de demande pris en charge {#tmf_prod_order-GET-productOrder-id__entry__2} | Nom | Description | |-|-| | id | Sys_id ou external_id de la commande du client à récupérer. Situé dans la table Commande client \[sn_ind_tmt_orm_order\]. Type de données : chaîne | [Tableau 19. Paramètres de chemin d'accès] {#tmf_prod_order-GET-productOrder-id__entry__6} | Nom | Description | |-|-| | Aucun | | [Tableau 20. Paramètres de requête] {#tmf_prod_order-GET-productOrder-id__entry__10} | Nom | Description | |-|-| | Aucun | | [Tableau 21. Paramètres du corps de la demande (JSON)] ### En-têtes Les en-têtes de demande et de réponse suivants s'appliquent à cette action HTTP uniquement ou s'appliquent à cette action d'une manière distincte. Pour obtenir la liste des en-têtes généraux utilisés dans l'API REST, consultez [En-têtes d'API REST pris en charge](https://servicenow-prod.fluidtopics.net/CFQa7z9NIrhoOq1u1cRN7g "REST (REpresentational State Transfer) est une architecture simple sans état qui fournit des normes entre les systèmes informatiques sur le Web, ce qui leur permet de communiquer plus facilement les uns avec les autres."). {#tmf_prod_order-GET-productOrder-id__table_kqy_wgy_fsb__entry__2} | En-tête | Description | |-|-| | Aucun | | [Tableau 22. En-têtes de demandes] {#tmf_prod_order-GET-productOrder-id__table_kqy_wgy_fsb} {#tmf_prod_order-GET-productOrder-id__table_tzy_thy_ksb__entry__2} | En-tête | Description | |-|-| | Type de contenu | Format de données du corps de la réponse. Ne prend en charge application/jsonque les fichiers . | [Tableau 23. En-têtes de réponses] {#tmf_prod_order-GET-productOrder-id__table_tzy_thy_ksb} ### Codes d'état Les codes d'état suivants s'appliquent à cette action HTTP. Pour obtenir la liste des codes d'état possibles utilisés dans l'API REST, consultez [Codes de réponse HTTP de l'API REST](https://servicenow-prod.fluidtopics.net/CFQa7z9NIrhoOq1u1cRN7g "REST (REpresentational State Transfer) est une architecture simple sans état qui fournit des normes entre les systèmes informatiques sur le Web, ce qui leur permet de communiquer plus facilement les uns avec les autres."). {#tmf_prod_order-GET-productOrder-id__entry__22}{#tmf_prod_order-GET-productOrder-id__entry-404-status-code} | Code d'état | Description | |-|-| | 201 | Réussi. La demande a été correctement traitée. | | 400 | Demande incorrecte. Cela peut être dû à l'une des raisons suivantes : * Paramètre de requête manquant * URI non valide | | 404 | Introuvable. L'élément demandé est introuvable. | [Tableau 24. Codes d'état] ### Paramètres de corps de réponse (JSON) {#tmf_prod_order-GET-productOrder-id__entry__30} | Nom | Description | |-|-| | canal | Tableau d'objets qui décrivent les canaux à utiliser pour vendre les produits. Type de données : tableau "channel": [ { "id": "String", "name": "String" } ] | | channel.id | Identificateur unique du canal à utiliser pour vendre les produits associés. Les valeurs d'ID de canal se trouvent dans le champ external_id de la table Canal de distribution \[sn_prd_pm_distribution_channel\]. Type de données : chaîne | | channel.name | Nom du canal à utiliser pour vendre les produits associés. Type de données : chaîne | | expectedCompletionDate | Date à laquelle la commande sera terminée. Type de données : chaîne | | note | Tableau d'objets qui décrivent les notes supplémentaires prises par le client lors de la commande. Type de données : tableau "note": { "author": "String", "date": "String", "text": "String" } | | note.auteur | Nom d'utilisateur de la personne qui a rédigé la note associée. Type de données : chaîne | | note.date | Date de création de la note. Type de données : chaîne | | note.texte | Remarques/commentaires supplémentaires formulés par le client lors de la commande. Type de données : chaîne | | ponr | Marqueur indiquant si le point de non retour de la commande a été atteint. Valeurs valides : * true : le point de non-retour de la commande a été atteint. * false : le point de non-retour de la commande n'a pas été atteint. {#tmf_prod_order-GET-productOrder-id__ul_tdq_rw1_hqb} Type de données : booléennes | | Élément de commande produit | Liste décrivant les éléments associés à la commande de produit et leur action associée. Type de données : tableau "productOrderItem:" [ { "action": "String", "actionReason": "String", "id": "String", "itemPrice": [Array], "product": {Object}, "productOffering": {Object}, "productOrderItemReleationship": [Array], "quantity": Number, "state": "String", "@type": "String" } ] | | productOrderItem.action | Action à effectuer sur le produit. Les actions possibles sont définies dans l'onglet Liste de choix de l'entrée du dictionnaire d'actions de la table sn_ind_tmt_orm_order_line_item. Type de données : chaîne | | Élément de commandeproduit.actionReason | Motif de l'ajout de l'élément de ligne de commande. Type de données : chaîne Table/champ mis à jour : sn_ind_tmt_orm_order_line_item/action_reason | | productOrderItem.id | Identificateur unique de l'élément de ligne. Situé dans le champ sn_ind_tmt_orm_external_id de la table Élément de ligne de commande \[sn_ind_tmt_orm_order_line_item\]. Type de données : chaîne | | productOrderItem.itemPrice | Tableau d'objets décrivant le prix associé au produit. Type de données : tableau "itemPrice": [ { "price": {Object}, "priceType": "String", "recurringChargePeriod": "String" } ] | | productOrderItem.itemPrice.price | Description du prix du produit associé. Type de données : objet "price": { "taxIncludedAmount": {Object} } | | productOrderItem.itemPrice.price.taxIncludedAmount | Description du prix du produit associé, taxes comprises. Type de données : objet "taxIncludedAmount": { "unit": "String", "value": Number } | | productOrderItem.itemPrice.price.taxIncludedAmount.unit | Code de devise dans lequel le prix est représenté. Type de données : chaîne | | productOrderItem.itemPrice.price.taxIncludedAmount.value | Prix du produit, toutes taxes comprises. Type de données : nombre | | productOrderItem.itemPrice.priceType | Type de prix de l'article, récurrent ou non récurrent. Type de données : chaîne | | productOrderItem.itemPrice.recurringChargePeriod | Si le prix est récurrent, la période récurrente, par exemple le mois. Type de données : chaîne | | ArticleCommandeProduit.ponr | Marqueur indiquant si le point de non retour de la commande a été atteint. Valeurs valides : * true : le point de non-retour de la commande a été atteint. * false : le point de non-retour de la commande n'a pas été atteint. {#tmf_prod_order-GET-productOrder-id__d2876e2597} Type de données : booléennes | | productOrderItem.product | Description des détails de l'instance du produit acheté par le client. Type de données : objet "product:" { "place": {Object}, "productCharacteristic": [Array], "productSpecification": {Object}, "relatedParty": {Object}, "@type": "String" } | | productOrderItem.product.place | Cartes des emplacements sur lesquels installer le produit. Type de données : objet "place": { "id": "String", "@type": "String" } | | productOrderItem.product.place.id | Sys_id de l'enregistrement de l'emplacement associé dans la table Emplacement \[cmn_location\]. Type de données : chaîne | | productOrderItem.product.place.@type | Fait partie de la norme TMF Open API. Annotation pour le contact de l'élément de ligne de commande. Cette valeur est toujours Place. Ces informations ne sont pas stockées. Type de données : chaîne | | productOrderItem.product.productCharacteristic | Tableau d'objets décrivant les caractéristiques du produit associé. Seules les caractéristiques des produits qui value sont différentes de celles previousValue sont retournées. Type de données : tableau "productCharacteristic": [ { "name": "String", "previousValue": "String", "value": "String" } ] | | productOrderItem.product.productCharacteristic.name | Nom de l'enregistrement de la caractéristique à associer au produit. Situé dans la table Caractéristique \[sn_prd_pm_characteristic\]. Type de données : chaîne | | productOrderItem.product.productCharacteristic.previousValue | Valeurs d'option de caractéristique précédentes si la mise à jour concerne un ordre de changement. La demande est un ordre de changement si le paramètre est autre que ajouterproductOrderItem.action. Pour plus d'informations sur les valeurs des options de caractéristique, reportez-vous à la section [Create product characteristics and characteristic options](https://www.servicenow.com/docs/access?context=som-product-config-add-characteristics&version=xanadu&pubname=xanadu-order-management&ft:locale=en-US). Type de données : chaîne | | productOrderItem.product.productCharacteristic.value | Valeurs d'option de caractéristique associées au produit. Pour plus d'informations sur les valeurs des options de caractéristique, reportez-vous à la section [Create product characteristics and characteristic options](https://www.servicenow.com/docs/access?context=som-product-config-add-characteristics&version=xanadu&pubname=xanadu-order-management&ft:locale=en-US). Type de données : chaîne | | productOrderItem.product.productSpecification | Description de la spécification du produit associée au produit. Type de données : objet "productSpecification:" { "id": "String", "name": "String", "@type": "String" } | | productOrderItem.product.productSpecification.id | Initial_version ou external_id des spécifications du produit. Le initial_version est le sys_id de la première version de la spécification. Situé dans le champ sys_id ou external_id de la table Spécification de produit \[sn_prd_pm_product_specification\]. Type de données : chaîne | | productOrderItem.product.productSpecification.name | Nom de la spécification de produit. Situé dans la table Spécification de produit \[sn_prd_pm_product_specification\]. Type de données : chaîne | | productOrderItem.product.productSpecification.@type | Fait partie de la norme TMF Open API. Cette valeur est toujours ProductSpecificationRef. Ces informations ne sont pas stockées. Type de données : chaîne | | élémentcommandeproduit.produit.relatedparty | Liste des contacts pour les éléments de ligne. Type de données : tableau "relatedParty:" { "email": "String", "firstName": "String", "id": "String", "lastName": "String", "phone": "String", "@referredType": "String", "@type": "String" } | | productOrderItem.product.relatedParty.email | Adresse e-mail du contact. Type de données : chaîne | | productOrderItem.product.relatedParty.firstName | Prénom de la personne à contacter. Type de données : chaîne | | productOrderItem.product.relatedParty.id | Sys_id du contact de l'élément de ligne associé à l'élément de ligne de commande. Situé dans la table Contact de l'élément de ligne de commande \[sn_ind_tmt_orm_order_line_item_contact\]. Type de données : chaîne | | productOrderItem.product.relatedParty.lastName | Nom de famille du contact. Type de données : chaîne | | productOrderItem.product.relatedParty.phone | Numéro de téléphone professionnel du contact. Type de données : chaîne | | productOrderItem.product.relatedParty.@referredType | Type de client. Valeur possible : OrderLineItemContact Type de données : chaîne | | productOrderItem.product.relatedParty.@type | Fait partie de la norme TMF Open API. Annotation pour le contact de l'élément de ligne de commande. Cette valeur est toujours RelatedParty. Ces informations ne sont pas stockées. Type de données : chaîne | | productOrderItem.productOffering | Description de l'offre de produit associée au produit. Type de données : objet "productOffering": { "id": "String", "internalVersion": "String", "name": "String", "version": "String" } | | productOrderItem.productOffering.id | Initial_version ou external_id de l'offre de produits. Le initial_version est le sys_id de la première version de l'offre. Situé dans le champ sys_id ou external_id de la table Offre de produits \[sn_prd_pm_product_offering\]. Type de données : chaîne | | productOrderItem.productOffering.name | Nom de l'offre de produits. Situé dans la table Offre de produits \[sn_prd_pm_product_offering\]. Type de données : chaîne | | productOrderItem.quantity | Nombre d'éléments de produit achetés. Type de données : nombre | | productOrderItem.productOrderItemRelationship | Tableau d'objets décrivant les relations entre les éléments de ligne de commande. Type de données : tableau "productOrderItemRelationship": [ { "id": "String", "relationshipType": "String" } ] | | productOrderItem.productOrderItemRelationship.id | Identificateur unique de l'élément de ligne connexe. Situé dans le champ sn_ind_tmt_orm_external_id de la table Élément de ligne de commande \[sn_ind_tmt_orm_order_line_item\]. Type de données : chaîne | | productOrderItem.productOrderItemRelationship.relationshipType | Type de relation entre les deux éléments de ligne. Ces informations sont utilisées pour identifier la hiérarchie des relations. Valeurs possibles : * HasChild (en anglais seulement) * HasParent (en anglais seulement) * Exige {#tmf_prod_order-GET-productOrder-id__ul_yqf_2ty_54b} `HasChild` et `HasParent` sont utilisés pour les relations parent/enfant. `Exige` est utilisé pour les relations horizontales (un élément de ligne nécessite un autre élément de ligne). Type de données : chaîne | | élémentcommandeproduit.état | État de la commande de l'élément de produit associé. Type de données : chaîne | | productOrderItem.version | Version de la commande. Type de données : chaîne | | productOrderItem.@type | Fait partie de la norme TMF Open API. Annotation pour le produit. Cette valeur est toujours ProductOrderItem. Ces informations ne sont pas stockées. Type de données : chaîne | | relatedParty | Liste des contacts de la commande. Chaque contact est un objet dans le tableau. Doit énumérer au moins un élément qui contient des informations sur le compte client ou le compte de consommateur. Type de données : tableau "relatedParty:" [ { "id": "String", "name": "String", "@referredType": "String", "@type": "String" } ] | | relatedParty.id | Sys_id ou external_id du compte, du contact client ou du consommateur associé à la commande. Situé dans la table Compte \[customer_account\], Contact \[customer_contact\] ou Consommateur \[csm_consumer\]. Type de données : chaîne | | relatedParty.name | Nom du compte, du client ou du consommateur. Type de données : chaîne | | relatedParty.@referredType | Type de client. Valeurs possibles : * Consommateur * Client * Contact du client {#tmf_prod_order-GET-productOrder-id__ul_lcq_jwm_t4b} Type de données : chaîne | | relatedParty.@type | Fait partie de la norme TMF Open API. Annotation pour le produit. Cette valeur est toujours RelatedParty. Ces informations ne sont pas stockées. Type de données : chaîne | | requestedCompletionDate | Date de livraison demandée par le client. Type de données : chaîne | | Date de début demandée | Date de début de commande demandée par le client. Type de données : chaîne | | État | État actuel de la commande. Type de données : chaîne | | version | Version de la commande. Type de données : chaîne | | @type | Fait partie de la norme TMF Open API. Annotation pour le produit. Cette valeur est toujours ProductOrder. Ces informations ne sont pas stockées. Type de données : chaîne | [ ] ### Demande cURL L'exemple de code suivant demande une commande client existante. curl -X GET "https://servicenow-instance/api/sn_ind_tmt_orm/productorder/8d75939453126010a795ddeeff7b126a" \ -u "username":"password" Corps de réponse. { "id": "8d75939453126010a795ddeeff7b126a", "ponr": "false", "expectedCompletionDate": "2021-05-02T08:13:59.000Z", "requestedCompletionDate": "2021-05-02T08:13:59.000Z", "requestedStartDate": "2020-05-03T08:13:59.000Z", "channel": [ { "id": "1", "name": "Agent Assist" } ], "note": [ { "author": "System Administrator", "date": "2021-02-25T14:22:07.000Z", "text": "This is a TMF product order illustration no 2" }, { "author": "System Administrator", "date": "2021-02-25T14:22:06.000Z", "text": "This is a TMF product order illustration" } ], "productOrderItem": [ { "id": "POI130", "ponr": "false", "quantity": 1, "action": "add", "actionReason":"adding service package OLI", "itemPrice": [ { "priceType": "recurring", "price": { "taxIncludedAmount": { "unit": "USD", "value": 20 } } }, { "priceType": "nonRecurring", "price": { "taxIncludedAmount": { "unit": "INR", "value": 0 } } } ], "product": { "@type": "Product", "productCharacteristic": [ { "name": "Security Type", "valueType": "Choice", "value": "Base", "previousValue": "" } ], "productSpecification": { "id": "a6514bd3534560102f18ddeeff7b1247", "name": "SD-WAN Security", "@type": "ProductSpecificationRef" }, "relatedParty": [ { "id": "4175939453126010a795ddeeff7b127d", "name": "John Smith", "email": "abc2@example.com", "phone": "32456768", "@type": "RelatedParty", "@referredType": "OrderLineItemContact" }, { "id": "c175939453126010a795ddeeff7b127c", "name": "Joe Doe", "email": "abc@example.com", "phone": "1234567890", "@type": "RelatedParty", "@referredType": "OrderLineItemContact" } ] }, "productOffering": { "id": "69017a0f536520103b6bddeeff7b127d", "name": "Premium SD-WAN Offering" }, "productOrderItemRelationship": [ { "id": "POI100", "relationshipType": "HasParent" } ], "state": "in_progress", "version": "1", "@type": "ProductOrderItem" }, { "id": "POI100", "ponr": "false", "quantity": 1, "action": "add", "itemPrice": [ { "priceType": "recurring", "price": { "taxIncludedAmount": { "unit": "INR", "value": 0 } } }, { "priceType": "nonRecurring", "price": { "taxIncludedAmount": { "unit": "INR", "value": 0 } } } ], "product": { "@type": "Product", "productSpecification": { "id": "cfe5ef6a53702010cd6dddeeff7b12f6", "name": "SD-WAN Service Package", "@type": "ProductSpecificationRef" } }, "productOffering": { "id": "69017a0f536520103b6bddeeff7b127d", "name": "Premium SD-WAN Offering" }, "productOrderItemRelationship": [ { "id": "POI130", "relationshipType": "HasChild" }, { "id": "POI120", "relationshipType": "HasChild" }, { "id": "POI110", "relationshipType": "HasChild" } ], "state": "in_progress", "version": "1", "@type": "ProductOrderItem" }, { "id": "POI120", "ponr": "false", "quantity": 1, "action": "add", "itemPrice": [ { "priceType": "recurring", "price": { "taxIncludedAmount": { "unit": "USD", "value": 20 } } }, { "priceType": "nonRecurring", "price": { "taxIncludedAmount": { "unit": "INR", "value": 0 } } } ], "product": { "@type": "Product", "productCharacteristic": [ { "name": "CPE Type", "valueType": "Choice", "value": "Physical", "previousValue": "" }, { "name": "WAN Optimization", "valueType": "Choice", "value": "Advance", "previousValue": "" }, { "name": "Routing", "valueType": "Choice", "value": "Premium", "previousValue": "" }, { "name": "CPE Model", "valueType": "Choice", "value": "ASR", "previousValue": "" } ], "productSpecification": { "id": "39b627aa53702010cd6dddeeff7b1202", "name": "SD-WAN Edge Device", "@type": "ProductSpecificationRef" } }, "productOffering": { "id": "69017a0f536520103b6bddeeff7b127d", "name": "Premium SD-WAN Offering" }, "productOrderItemRelationship": [ { "id": "POI100", "relationshipType": "HasParent" } ], "state": "in_progress", "version": "1", "@type": "ProductOrderItem" }, { "id": "POI110", "ponr": "false", "quantity": 1, "action": "add", "actionReason":"adding service package OLI", "itemPrice": [ { "priceType": "recurring", "price": { "taxIncludedAmount": { "unit": "INR", "value": 0 } } }, { "priceType": "nonRecurring", "price": { "taxIncludedAmount": { "unit": "USD", "value": 5 } } } ], "product": { "@type": "Product", "productCharacteristic": [ { "name": "Tenancy", "valueType": "Choice", "value": "Base (10 site)", "previousValue": "" } ], "productSpecification": { "id": "216663aa53702010cd6dddeeff7b12b5", "name": "SD-WAN Controller", "@type": "ProductSpecificationRef" }, "place": { "id": "25ab9c4d0a0a0bb300f7dabdc0ca7c1c", "@type": "Place" } }, "productOffering": { "id": "69017a0f536520103b6bddeeff7b127d", "name": "Premium SD-WAN Offering" }, "productOrderItemRelationship": [ { "id": "POI100", "relationshipType": "HasParent" } ], "state": "in_progress", "version": "1", "@type": "ProductOrderItem" } ], "relatedParty": [ { "id": "eaf68911c35420105252716b7d40ddde", "name": "Sally Thomas", "@type": "RelatedParty", "@referredType": "CustomerContact" }, { "id": "ffc68911c35420105252716b7d40dd55", "name": "Funco Intl", "@type": "RelatedParty", "@referredType": "Customer" }, { "id": "59f16de1c3b67110ff00ed23a140dd9e", "name": "Funco External", "@type": "RelatedParty", "@referredType": "Consumer" } ], "state": "in_progress", "version": "1", "@type": "ProductOrder" } ## API ouverte pour la commande de produit : PATCH /sn_ind_tmt_orm/order/productOrder/{id} {#ariaid-title6} Met à jour la commande client spécifiée. ### Format d'URL URL par défaut : /api/sn_ind_tmt_orm/order/productOrder/{id} ### Paramètres de demande pris en charge {#tmf_prod_order-PATCH-ord-productOrder-id__entry__2} | Nom | Description | |-|-| | id | Sys_id de la commande client à mettre à jour. Situé dans la table Commande client \[sn_ind_tmt_orm_order\]. Type de données : chaîne | [Tableau 25. Paramètres de chemin d'accès] {#tmf_prod_order-PATCH-ord-productOrder-id__entry__6} | Nom | Description | |-|-| | Aucun | | [Tableau 26. Paramètres de requête] {#tmf_prod_order-PATCH-ord-productOrder-id__id_vk2_p5n_t4b__entry__2}{#tmf_prod_order-PATCH-ord-productOrder-id__channel-ph-tmf622}{#tmf_prod_order-PATCH-ord-productOrder-id__channel_id-ph-tmf622}{#tmf_prod_order-PATCH-ord-productOrder-id__channel_name-ph-tmf622}{#tmf_prod_order-PATCH-ord-productOrder-id__due-date-PATCH}{#tmf_prod_order-PATCH-ord-productOrder-id__externalId-ph-tmf622}{#tmf_prod_order-PATCH-ord-productOrder-id__note-ph-tmf622}{#tmf_prod_order-PATCH-ord-productOrder-id__note_text-ph-tmf622}{#tmf_prod_order-PATCH-ord-productOrder-id__prodOrdItem-ph-tmf622}{#tmf_prod_order-PATCH-ord-productOrder-id__prodOrdItem_action-ph-tmf622}{#tmf_prod_order-PATCH-ord-productOrder-id__prodOrdItem_actionReason-response-tmf622}{#tmf_prod_order-PATCH-ord-productOrder-id__due-date-item-PATCH}{#tmf_prod_order-PATCH-ord-productOrder-id__externalProdInv-descr-PATCH}{#tmf_prod_order-PATCH-ord-productOrder-id__externalProdInvId-decsr}{#tmf_prod_order-PATCH-ord-productOrder-id__prodOrdItem_id-ph-tmf622}{#tmf_prod_order-PATCH-ord-productOrder-id__itemPrice-ph-tmf622}{#tmf_prod_order-PATCH-ord-productOrder-id__itemPrice_price-ph-tmf622}{#tmf_prod_order-PATCH-ord-productOrder-id__itemPrice_price_taxIncludedAmt-ph-tmf622}{#tmf_prod_order-PATCH-ord-productOrder-id__itemPrice_price_taxIncludedAmt_unit-ph-tmf622}{#tmf_prod_order-PATCH-ord-productOrder-id__itemPrice_price_taxIncludedAmt_value-ph-tmf622}{#tmf_prod_order-PATCH-ord-productOrder-id__itemPrice_priceType_data_type-p-tmf622}{#tmf_prod_order-PATCH-ord-productOrder-id__itemPrice_recurringChargePeriod_data_type-p-tmf622}{#tmf_prod_order-PATCH-ord-productOrder-id__product-p-tmf622}{#tmf_prod_order-PATCH-ord-productOrder-id__product_id-ph-tmf622}{#tmf_prod_order-PATCH-ord-productOrder-id__product_place-ph-tmf622}{#tmf_prod_order-PATCH-ord-productOrder-id__product_place_id-ph-tmf622}{#tmf_prod_order-PATCH-ord-productOrder-id__product_place_type_data_type-p-tmf622}{#tmf_prod_order-PATCH-ord-productOrder-id__prod_prodChar-ph-tmf622}{#tmf_prod_order-PATCH-ord-productOrder-id__prod_prodChar_name-ph-tmf622}{#tmf_prod_order-PATCH-ord-productOrder-id__prod_prodChar_previousValue-ph-tmf622}{#tmf_prod_order-PATCH-ord-productOrder-id__prod_prodChar_value-ph-tmf622}{#tmf_prod_order-PATCH-ord-productOrder-id__prod_prodSpec-ph-tmf622}{#tmf_prod_order-PATCH-ord-productOrder-id__prod_prodSpec_id_data_type-p-tmf622}{#tmf_prod_order-PATCH-ord-productOrder-id__prod_prodSpec_name_data_type-p-tmf622}{#tmf_prod_order-PATCH-ord-productOrder-id__prod_prodSpec_type_data_type-p-tmf622}{#tmf_prod_order-PATCH-ord-productOrder-id__prod_relParty-ph-tmf622}{#tmf_prod_order-PATCH-ord-productOrder-id__prod_relParty_email-ph-tmf622}{#tmf_prod_order-PATCH-ord-productOrder-id__prod_relParty_firstName-ph-tmf622}{#tmf_prod_order-PATCH-ord-productOrder-id__prod_relParty_id-ph-tmf622}{#tmf_prod_order-PATCH-ord-productOrder-id__prod_relParty_lastName-ph-tmf622}{#tmf_prod_order-PATCH-ord-productOrder-id__prod_relParty_phone-ph-tmf622}{#tmf_prod_order-PATCH-ord-productOrder-id__prod_relParty_refType_data_type-p-tmf622}{#tmf_prod_order-PATCH-ord-productOrder-id__product_relatedParty_type_data_type-row-tmf622}{#tmf_prod_order-PATCH-ord-productOrder-id__product_type_data_type-p-tmf622}{#tmf_prod_order-PATCH-ord-productOrder-id__productOffer-ph-tmf622}{#tmf_prod_order-PATCH-ord-productOrder-id__prodOffer_id_data_type-p-tmf622}{#tmf_prod_order-PATCH-ord-productOrder-id__prodOffer_name_data_type-p-tmf622}{#tmf_prod_order-PATCH-ord-productOrder-id__prodOrdItem_quantity-ph-tmf622}{#tmf_prod_order-PATCH-ord-productOrder-id__prodOrderItemRel-ph-tmf622}{#tmf_prod_order-PATCH-ord-productOrder-id__prodOrderItemRel_id-ph-tmf622}{#tmf_prod_order-PATCH-ord-productOrder-id__prodOrderItemRel_relType_data_type-p-tmf622}{#tmf_prod_order-PATCH-ord-productOrder-id__prodOrdItem_type-entry-tmf622}{#tmf_prod_order-PATCH-ord-productOrder-id__relatedParty-ph-tmf622}{#tmf_prod_order-PATCH-ord-productOrder-id__relatedParty_id_data_type-p-tmf622}{#tmf_prod_order-PATCH-ord-productOrder-id__relatedParty_name_data_type-p-tmf622}{#tmf_prod_order-PATCH-ord-productOrder-id__relatedParty_refType_data_type-p-tmf622}{#tmf_prod_order-PATCH-ord-productOrder-id__relatedParty_type_data_type-p-tmf622}{#tmf_prod_order-PATCH-ord-productOrder-id__requestedCompletionDate-ph-tmf622}{#tmf_prod_order-PATCH-ord-productOrder-id__reqStartDate-ph-tmf622}{#tmf_prod_order-PATCH-ord-productOrder-id__type-entry-tmf622} | Nom | Description | |-|-| | canal | Tableau d'objets qui décrivent les canaux à utiliser pour vendre les produits. Type de données : tableau{#tmf_prod_order-PATCH-ord-productOrder-id__channel_data_type-p-tmf622} "channel": [ { "id": "String", "name": "String" } ] {#tmf_prod_order-PATCH-ord-productOrder-id__channel_obj_def-codeblock-tmf622} Table/champ mis à jour : sn_ind_tmt_orm_order | | channel.id | Requis si le channel paramètre est utilisé. Identificateur unique du canal à utiliser pour vendre les produits associés. Les valeurs d'ID de canal se trouvent dans le champ external_id de la table Canal de distribution \[sn_prd_pm_distribution_channel\]. Type de données : chaîne{#tmf_prod_order-PATCH-ord-productOrder-id__channel_id_data_type-p-tmf622} Table/champ mis à jour : sn_ind_tmt_orm_order/canal Par défaut : chaîne vide | | channel.name | Nom du canal à utiliser pour vendre les produits associés. Les noms de canaux possibles sont définis dans l'onglet Liste de choix de l'entrée du dictionnaire des canaux de la table sn_ind_tmt_orm_order. Type de données : chaîne{#tmf_prod_order-PATCH-ord-productOrder-id__channel_name_data_type-p-tmf622} Par défaut : chaîne vide | | committedDueDate | Date et heure auxquelles l'action doit être effectuée sur la commande. Cette valeur doit être identique ou ultérieure aux valeurs de committedDueDate chaque élément de ligne de commande. Si l'action pour les éléments de ligne de commande est suspendre ou reprendre, ce paramètre ne peut pas être mis à jour. Type de données : chaîne Table/champ mis à jour : sn_ind_tmt_orm_order/committed_due_date | | externalId | Identificateur unique de la commande du client. Cette valeur est déterminée par un système externe. Type de données : chaîne{#tmf_prod_order-PATCH-ord-productOrder-id__externalId_data_type-p-tmf622} Table/champ mis à jour : sn_ind_tmt_orm_order/external_id Par défaut : chaîne vide | | note | Tableau d'objets qui décrivent les notes supplémentaires prises par le client lors de la commande. Type de données : tableau{#tmf_prod_order-PATCH-ord-productOrder-id__note_data_type-p-tmf622} "note": [ { "text": "String" } ] {#tmf_prod_order-PATCH-ord-productOrder-id__note-codeblock-tmf622} Table/champ mis à jour : sn_ind_tmt_orm_order | | note.texte | Remarques/commentaires supplémentaires formulés par le client lors de la commande. Type de données : chaîne{#tmf_prod_order-PATCH-ord-productOrder-id__note_text_data_type-p-tmf622} Table/champ mis à jour : sn_ind_tmt_orm_order/commentaires Par défaut : chaîne vide | | orderCurrency | Code de devise pour la commande et les éléments de ligne de commande. La mise à jour du code de devise d'une commande existante n'est pas prise en charge. Fournir une valeur autre que le code de devise déjà associé à la commande entraîne le rejet de la mise à jour. Type de données : chaîne | | Élément de commande produit | Liste décrivant les éléments associés à la commande de produit et leur action associée. Type de données : tableau{#tmf_prod_order-PATCH-ord-productOrder-id__prodOrdItem_data_type-p-tmf622} "productOrderItem": [ { "action": "String", "actionReason": "String", "committedDueDate": "String", "externalProductInventory": [Array], "id": "String", "itemPrice": [Array], "product": {Object}, "productOffering": {Object}, "productOrderItemRelationship": [Array], "quantity": Number, "revisionOperation": "String", "@type": "String" } ] {#tmf_prod_order-PATCH-ord-productOrder-id__prodOrdItem-codeblock-tmf622} Table/champ mis à jour : sn_ind_tmt_orm_order_line_item | | productOrderItem.action | Requis si le productOrderItem paramètre est utilisé. Action à effectuer sur le produit. Les actions possibles sont définies dans l'onglet Liste de choix de l'entrée du dictionnaire d'actions de la table sn_ind_tmt_orm_order_line_item. Valeurs possibles : * ajouter * changement * supprimer * Aucun changement * reprendre * suspendre {#tmf_prod_order-PATCH-ord-productOrder-id__ul_zwn_nxp_ysb} Type de données : chaîne{#tmf_prod_order-PATCH-ord-productOrder-id__prodOrdItem_action_data_type-p-tmf622} Table/champ mis à jour : sn_ind_tmt_orm_order_line_item/action Par défaut : add | | Élément de commandeproduit.actionReason | Motif de l'ajout de l'élément de ligne de commande. Type de données : chaîne Table/champ mis à jour : sn_ind_tmt_orm_order_line_item/action_reason | | productOrderItem.committedDueDate | Date et heure auxquelles l'action doit être effectuée sur l'élément de ligne de commande. Si l'action pour l'élément est suspendre ou reprendre, ce paramètre ne peut pas être mis à jour. Type de données : chaîne Table/champ mis à jour : sn_ind_tmt_orm_order_line_item/committed_due_date | | productOrderItem.externalProductInventory | Tableau d'objets contenant des ID externes à mapper aux inventaires de produits créés pour la commande. Type de données : tableau "externalProductInventory": [ { "externalProductInventoryId": "String" } ] Remarque : Auparavant, lors de la création d'une commande PATCH avec un ID d'inventaire de produit externe qui existait déjà, l'opération était abandonnée et renvoyait une erreur. Avec la Xanadu version, ce paramètre est simplement ignoré lorsqu'un ID d'inventaire de produits externe existant est fourni et qu'une erreur n'est pas générée. | | productOrderItem.externalProductInventory.externalProductInventoryId | ID externe à mapper à l'inventaire des produits. Type de données : chaîne Table/champ mis à jour : sn_ind_tmt_orm_order_line_item/external_inventory_id et sn_prd_invt_product_inventory/sn_prd_invt_external_id | | productOrderItem.id | Requis si le productOrderItem paramètre est utilisé. Identificateur unique de l'élément de ligne. Situé dans le champ sn_ind_tmt_orm_external_id de la table Élément de ligne de commande \[sn_ind_tmt_orm_order_line_item\]. Type de données : chaîne{#tmf_prod_order-PATCH-ord-productOrder-id__prodOrdItem_id_data_type-p-tmf622} Table/champ mis à jour : sn_ind_tmt_orm_order_line_item/external_id Longueur maximale : 40 Par défaut : chaîne vide | | productOrderItem.itemPrice | Tableau d'objets décrivant le prix associé au produit. Type de données : tableau{#tmf_prod_order-PATCH-ord-productOrder-id__itemPrice_data_type-p-tmf622} "itemPrice": [ { "price": {Object}, "priceType": "String", "recurringChargePeriod": "String" } ] {#tmf_prod_order-PATCH-ord-productOrder-id__itemPrice-codeblock-tmf622} Table mise à jour : sn_ind_tmt_orm_order Par défaut : chaîne vide | | productOrderItem.itemPrice.price | Description du prix du produit associé. Type de données : objet{#tmf_prod_order-PATCH-ord-productOrder-id__itemPrice_price_data_type-p-tmf622} "price": { "taxIncludedAmount": {Object} } {#tmf_prod_order-PATCH-ord-productOrder-id__itemPrice_price-codeblock-tmf622} Table mise à jour : sn_ind_tmt_orm_order_line_item Par défaut : chaîne vide | | productOrderItem.itemPrice.price.taxIncludedAmount | Description du prix du produit associé, taxes comprises. Type de données : objet{#tmf_prod_order-PATCH-ord-productOrder-id__itemPrice_price_taxIncludedAmt_data_type-p-tmf622} "taxIncludedAmount": { "unit": "String", "value": Number } {#tmf_prod_order-PATCH-ord-productOrder-id__itemPrice_price_taxIncludedAmt-codeblock-tmf622} Table mise à jour : sn_ind_tmt_orm_order_line_item | | productOrderItem.itemPrice.price.taxIncludedAmount.unit | Code de devise dans lequel le prix est représenté. Type de données : chaîne{#tmf_prod_order-PATCH-ord-productOrder-id__itemPrice_price_taxIncludedAmt_unit_data_type-p-tmf622} Table/champ mis à jour : sn_ind_tmt_orm_order_line_item/mrc ou nrc | | productOrderItem.itemPrice.price.taxIncludedAmount.value | Prix du produit, toutes taxes comprises. Type de données : nombre{#tmf_prod_order-PATCH-ord-productOrder-id__itemPrice_price_taxIncludedAmt_value_data_type-p-tmf622} Table/champ mis à jour : sn_ind_tmt_orm_order_line_item/mrc ou nrc | | productOrderItem.itemPrice.priceType | Type de prix de l'article, récurrent ou non récurrent. Type de données : chaîne | | productOrderItem.itemPrice.recurringChargePeriod | Si le prix est récurrent, la période récurrente, par exemple le mois. Type de données : chaîne | | productOrderItem.product | Requis si productOrderItem.action c'est un changement ou une suppression. Description des détails de l'instance du produit acheté par le client. Type de données : objet{#tmf_prod_order-PATCH-ord-productOrder-id__product_data_type-p-tmf622} "product": { "id": "String", "place": {Object}, "productCharacteristic": [Array], "productSpecification": {Object}, "relatedParty": {Object}, "@type": "String" } {#tmf_prod_order-PATCH-ord-productOrder-id__product-codeblock-tmf622} Table/champ mis à jour : sn_ind_tmt_orm_order_line_item | | productOrderItem.product.id | Requis si productOrderItem.action c'est un changement ou une suppression. Identificateur unique du produit vendu. Situé dans le champ sys_id ou sn_ind_tmt_orm_external_id de la table Inventaire des produits \[sn_ind_tmt_orm_product_inventory\]. Type de données : chaîne{#tmf_prod_order-PATCH-ord-productOrder-id__product_id_data_type-p-tmf622} Par défaut : chaîne vide | | ArticleCommandeProduit.produit.place | Cartes des emplacements sur lesquels installer le produit. Type de données : objet{#tmf_prod_order-PATCH-ord-productOrder-id__product_place_data_type-p-tmf622} "place": { "id": "String", "@type": "String" } {#tmf_prod_order-PATCH-ord-productOrder-id__product_place-codeblock-tmf622} Table/champ mis à jour : sn_ind_tmt_orm_order_line_item | | productOrderItem.product.place.id | Requis si le productOrderItem.product.place paramètre est utilisé. Sys_id de l'enregistrement de l'emplacement associé dans la table Emplacement \[cmn_location\]. Type de données : chaîne{#tmf_prod_order-PATCH-ord-productOrder-id__product_place_id_data_type-p-tmf622} Table/champ mis à jour : sn_ind_tmt_orm_order_line_item/emplacement Par défaut : chaîne vide | | productOrderItem.product.place.@type | Fait partie de la norme TMF Open API. Annotation pour le contact de l'élément de ligne de commande. Cette valeur est toujours Place. Ces informations ne sont pas stockées. Type de données : chaîne | | productOrderItem.product.productCharacteristic | Tableau d'objets décrivant les caractéristiques du produit associé. Type de données : tableau{#tmf_prod_order-PATCH-ord-productOrder-id__prod_prodChar_data_type-p-tmf622} "productCharacteristic": [ { "name": "String", "previousValue": "String", "value": "String" } ] {#tmf_prod_order-PATCH-ord-productOrder-id__prod_prodChar-codeblock-tmf622} Table/champ mis à jour : sn_ind_tmt_orm_order_characteristic_value | | productOrderItem.product.productCharacteristic.name | Nom de l'enregistrement de la caractéristique à associer au produit. Situé dans la table Caractéristique \[sn_prd_pm_characteristic\]. Type de données : chaîne{#tmf_prod_order-PATCH-ord-productOrder-id__prod_prodChar_name_data_type-p-tmf622} Table/champ mis à jour : sn_ind_tmt_orm_order_characteristic_value/caractéristiques Par défaut : chaîne vide | | productOrderItem.product.productCharacteristic.previousValue | Valeurs d'option de caractéristique précédentes si la mise à jour concerne un ordre de changement. La demande est un ordre de changement si le paramètre est autre que ajouterproductOrderItem.action. Pour plus d'informations sur les valeurs des options de caractéristique, reportez-vous à la section [Create product characteristics and characteristic options](https://www.servicenow.com/docs/access?context=som-product-config-add-characteristics&version=xanadu&pubname=xanadu-order-management&ft:locale=en-US). Type de données : chaîne{#tmf_prod_order-PATCH-ord-productOrder-id__prod_prodChar_previousValue_data_type-p-tmf622} Table/champ mis à jour : sn_ind_tmt_orm_order_characteristic_value/previous_characteristic_option_value Par défaut : chaîne vide | | productOrderItem.product.productCharacteristic.value | Valeurs d'option de caractéristique associées au produit. Pour plus d'informations sur les valeurs des options de caractéristique, reportez-vous à la section [Create product characteristics and characteristic options](https://www.servicenow.com/docs/access?context=som-product-config-add-characteristics&version=xanadu&pubname=xanadu-order-management&ft:locale=en-US). Type de données : chaîne{#tmf_prod_order-PATCH-ord-productOrder-id__prod_prodChar_value_data_type-p-tmf622} Table/champ mis à jour : sn_ind_tmt_orm_order_characteristic_value/characteristic_option_value Par défaut : chaîne vide | | productOrderItem.product.productSpecification | Description de la spécification du produit associée au produit. Remarque : Les ordres de changement (productOrderItem.action est `un changement`) sont traités différemment en fonction de la valeur de la sn_ind_tmt_orm.allowSpecVersionUpdateInChangeOrder propriété système. La valeur de cette propriété système détermine le mode de traitement de la commande si la version de l'inventaire des produits est différente de celle indiquée dans la commande. * Lorsque cette propriété système est définie sur vrai (par défaut), l'inventaire des produits est automatiquement mis à niveau vers la version de la commande en modifiant les spécifications du produit référencé. Cela permet de traiter la commande avec succès. * Lorsque cette propriété système est définie sur faux, si l'inventaire des produits est d'une version différente de celle indiquée dans la commande, la commande échoue en raison d'une incompatibilité de version. {#tmf_prod_order-PATCH-ord-productOrder-id__ul_sgb_q5y_hbc} Type de données : objet{#tmf_prod_order-PATCH-ord-productOrder-id__prod_prodSpec_data_type-p-tmf622} "productSpecification": { "id": "String", "internalVersion": "String", "name": "String", "version": "String", "@type": "String" } {#tmf_prod_order-PATCH-ord-productOrder-id__prod_prodSpec-codeblock-tmf622} Table/champ mis à jour : sn_ind_tmt_orm_order_line_item | | productOrderItem.product.productSpecification.id | Requis si le productOrderItem.product.productSpecification paramètre est utilisé. Initial_version ou external_id des spécifications du produit. Le initial_version est le sys_id de la première version de la spécification. Situé dans le champ sys_id ou external_id de la table Spécification de produit \[sn_prd_pm_product_specification\]. Type de données : chaîne | | productOrderItem.product.productSpecification.internalVersion | Version de la spécification du produit. Situé dans la table Spécification de produit \[sn_prd_pm_product_specification\]. Type de données : chaîne | | productOrderItem.product.productSpecification.name | Nom de la spécification de produit. Situé dans la table Spécification de produit \[sn_prd_pm_product_specification\]. Type de données : chaîne | | productOrderItem.product.productSpecification.version | External_version des spécifications du produit. Situé dans la table Spécification de produit \[sn_prd_pm_product_specification\]. Type de données : chaîne | | productOrderItem.product.productSpecification.@type | Fait partie de la norme TMF Open API. Cette valeur est toujours ProductSpecificationRef. Ces informations ne sont pas stockées. Type de données : chaîne | | élémentcommandeproduit.produit.relatedparty | Liste des contacts pour les éléments de ligne. Type de données : tableau{#tmf_prod_order-PATCH-ord-productOrder-id__prod_relParty_data_type-p-tmf622} "relatedParty": [ { "email": "String", "firstName": "String", "id": "String", "lastName": "String", "phone": "String", "@referredType": "String", "@type": "String" } ] {#tmf_prod_order-PATCH-ord-productOrder-id__prod_relParty-codeblock-tmf622} Table/champ mis à jour : sn_ind_tmt_orm_order_line_item_contact | | productOrderItem.product.relatedParty.email | Adresse e-mail du contact. Type de données : chaîne{#tmf_prod_order-PATCH-ord-productOrder-id__prod_relParty_email_data_type-p-tmf622} Table/champ mis à jour : sn_ind_tmt_orm_order_line_item_contact/e-mail Par défaut : chaîne vide | | productOrderItem.product.relatedParty.firstName | Prénom de la personne à contacter. Type de données : chaîne{#tmf_prod_order-PATCH-ord-productOrder-id__prod_relParty_firstName_data_type-p-tmf622} Table/champ mis à jour : sn_ind_tmt_orm_order_line_item_contact/first_name Par défaut : chaîne vide | | productOrderItem.product.relatedParty.id | Sys_id du contact de l'élément de ligne associé à l'élément de ligne de commande. Situé dans la table Contact de l'élément de ligne de commande \[sn_ind_tmt_orm_order_line_item_contact\]. Type de données : chaîne{#tmf_prod_order-PATCH-ord-productOrder-id__prod_relParty_id_data_type-p-tmf622} Table/champ mis à jour : sn_ind_tmt_orm_order_line_item_contact/sys_id Par défaut : chaîne vide | | productOrderItem.product.relatedParty.lastName | Nom de famille du contact. Type de données : chaîne{#tmf_prod_order-PATCH-ord-productOrder-id__prod_relParty_lastName_data_type-p-tmf622} Table/champ mis à jour : sn_ind_tmt_orm_order_line_item_contact/lastName Par défaut : chaîne vide | | ArticleCommandeProduit.produit.Partie.Téléphone.Produit.CommandeProduit.Téléphone.ProduitCommandeProduit.ProduitCommandeT | Numéro de téléphone professionnel du contact. Type de données : chaîne{#tmf_prod_order-PATCH-ord-productOrder-id__prod_relParty_phone_data_type-p-tmf622} Table/champ mis à jour : sn_ind_tmt_orm_order_line_item_contact/business_phone Par défaut : chaîne vide | | productOrderItem.product.relatedParty.@referredType | Type de client. Valeur possible : OrderLineItemContact{#tmf_prod_order-PATCH-ord-productOrder-id__prod_relParty_refType-p-tmf622} Type de données : chaîne | | productOrderItem.product.relatedParty.@type | Fait partie de la norme TMF Open API. Annotation pour le contact de l'élément de ligne de commande. Cette valeur est toujours RelatedParty. Ces informations ne sont pas stockées. Type de données : chaîne | | productOrderItem.product.@type | Fait partie de la norme TMF Open API. Annotation pour le produit. Cette valeur est toujours Produit. Ces informations ne sont pas stockées. Type de données : chaîne | | productOrderItem.productOffering | Description de l'offre de produit associée au produit. Type de données : objet{#tmf_prod_order-PATCH-ord-productOrder-id__prodOffer_data_type-p-tmf622} "productOffering": { "id": "String", "internalVersion": "String", "name": "String", "version": "String" } {#tmf_prod_order-PATCH-ord-productOrder-id__prodOffer-codeblock-tmf622} Table mise à jour : sn_ind_tmt_orm_order_line_item | | productOrderItem.productOffering.id | Requis si le productOrderItem.productOffering paramètre est utilisé. Initial_version ou external_id de l'offre de produits. Le initial_version est le sys_id de la première version de l'offre. Situé dans le champ sys_id ou external_id de la table Offre de produits \[sn_prd_pm_product_offering\]. Type de données : chaîne | | productOrderItem.productOffering.internalVersion | Version de l'offre de produit. Situé dans la table Offre de produits \[sn_prd_pm_product_offering\]. Type de données : chaîne | | productOrderItem.productOffering.name | Nom de l'offre de produits. Situé dans la table Offre de produits \[sn_prd_pm_product_offering\]. Type de données : chaîne | | Élément de commandedeproduit.offredeproduit.version | External_version de l'offre de produits. Situé dans la table Offre de produits \[sn_prd_pm_product_offering\]. Type de données : chaîne | | productOrderItem.productOrderItem.quantity | Nombre des éléments associés à commander. Type de données : nombre{#tmf_prod_order-PATCH-ord-productOrder-id__prodOrdItem_quantity_data_type-p-tmf622} Table/champ mis à jour : sn_ind_tmt_orm_order/quantité Par défaut : null | | productOrderItem.productOrderItemRelationship | Tableau d'objets décrivant les relations entre les éléments de ligne de commande. Type de données : tableau{#tmf_prod_order-PATCH-ord-productOrder-id__prodOrderItemRel_data_type-p-tmf622} "productOrderItemRelationship": [ { "id": "String", "relationshipType": "String" } ] {#tmf_prod_order-PATCH-ord-productOrder-id__prodOrderItemRel-codeblock-tmf622} Table/champ mis à jour : sn_ind_tmt_orm_order_line_item | | productOrderItem.productOrderItemRelationship.id | Requis si le productOrderItem.productOrderItemRelationship paramètre est utilisé. Identificateur unique de l'élément de ligne connexe. Situé dans le champ sn_ind_tmt_orm_external_id de la table Élément de ligne de commande \[sn_ind_tmt_orm_order_line_item\]. Type de données : chaîne{#tmf_prod_order-PATCH-ord-productOrder-id__prodOrderItemRel_id_data_type-p-tmf622} Table/champ mis à jour : sn_ind_tmt_orm_order_line_item/parent_line_item Par défaut : chaîne vide | | productOrderItem.productOrderItemRelationship.relationshipType | Type de relation entre les deux éléments de ligne. Ces informations sont utilisées pour identifier la hiérarchie des relations. Valeurs possibles : * HasChild (en anglais seulement) * HasParent (en anglais seulement) * Exige {#tmf_prod_order-PATCH-ord-productOrder-id__ul_yqf_2ty_54b} `HasChild` et `HasParent` sont utilisés pour les relations parent/enfant. `Exige` est utilisé pour les relations horizontales (un élément de ligne nécessite un autre élément de ligne). Type de données : chaîne | | productOrderItem.quantity | Nombre d'éléments commandés. Type de données : nombre Table/champ mis à jour : sn_ind_tmt_orm_order/quantité Par défaut : chaîne vide | | ArticleCommandeProduit.OpérationRévision | Type de mise à jour à effectuer sur l'élément de ligne. Si cette valeur est vide, l'élément de ligne existant est mis à jour ou un nouvel élément de ligne est ajouté s'il n'existe pas déjà. Si cette valeur est définie sur Annuler, l'élément de ligne est annulé. Type de données : chaîne Par défaut : chaîne vide | | productOrderItem.@type | Fait partie de la norme TMF Open API. Annotation pour le produit. Cette valeur est toujours ProductOrderItem. Ces informations ne sont pas stockées. Type de données : chaîne | | relatedParty | Liste des contacts de la commande. Chaque contact est un objet dans le tableau. Doit énumérer au moins un élément qui contient des informations sur le compte client ou le compte de consommateur. Type de données : tableau{#tmf_prod_order-PATCH-ord-productOrder-id__relatedParty_data_type-p-tmf622} "relatedParty": [ { "id": "String", "name": "String", "@referredType": "String", "@type": "String" } ] {#tmf_prod_order-PATCH-ord-productOrder-id__relatedParty-codeblock-tmf622} | | relatedParty.id | Sys_id ou external_id du compte, du contact client ou du consommateur associé à la commande. Situé dans la table Compte \[customer_account\], Contact \[customer_contact\] ou Consommateur \[csm_consumer\]. Type de données : chaîne | | relatedParty.name | Nom du compte, du client ou du consommateur. Type de données : chaîne | | relatedParty.@referredType | Type de client. Valeurs possibles : * Consommateur * Client * Contact du client {#tmf_prod_order-PATCH-ord-productOrder-id__ul_lcq_jwm_t4b} Type de données : chaîne | | relatedParty.@type | Fait partie de la norme TMF Open API. Annotation pour le produit. Cette valeur est toujours RelatedParty. Ces informations ne sont pas stockées. Type de données : chaîne | | requestedCompletionDate | Date de livraison demandée par le client. Type de données : chaîne{#tmf_prod_order-PATCH-ord-productOrder-id__reqCompDate_data_type-p-tmf622} Table/champ mis à jour : sn_ind_tmt_orm_order/expected_end_date Par défaut : chaîne vide | | Date de début demandée | Date de début de commande demandée par le client. Type de données : chaîne{#tmf_prod_order-PATCH-ord-productOrder-id__reqStartDate_data_type-p-tmf622} Table/champ mis à jour : sn_ind_tmt_orm_order/expected_start_date Par défaut : chaîne vide | | @type | Fait partie de la norme TMF Open API. Annotation pour le produit. Cette valeur est toujours ProductOrder. Ces informations ne sont pas stockées. Type de données : chaîne | [Tableau 27. Paramètres du corps de la demande (JSON)] {#tmf_prod_order-PATCH-ord-productOrder-id__id_vk2_p5n_t4b} ### En-têtes Les en-têtes de demande et de réponse suivants s'appliquent à cette action HTTP uniquement ou s'appliquent à cette action d'une manière distincte. Pour obtenir la liste des en-têtes généraux utilisés dans l'API REST, consultez [En-têtes d'API REST pris en charge](https://servicenow-prod.fluidtopics.net/CFQa7z9NIrhoOq1u1cRN7g "REST (REpresentational State Transfer) est une architecture simple sans état qui fournit des normes entre les systèmes informatiques sur le Web, ce qui leur permet de communiquer plus facilement les uns avec les autres."). {#tmf_prod_order-PATCH-ord-productOrder-id__table_omb_dvk_5rb__entry__2}{#tmf_prod_order-PATCH-ord-productOrder-id__accept-JSON-only-entry-RESTAPI}{#tmf_prod_order-PATCH-ord-productOrder-id__content_type-JSON-only-entry-RESTAPI} | En-tête | Description | |-|-| | Accepter | Format de données du corps de la réponse. Prend uniquement en charge application/json. | | Content-Type | Format de données du corps de la demande. Prend uniquement en charge application/json. | [Tableau 28. En-têtes de demandes] {#tmf_prod_order-PATCH-ord-productOrder-id__table_omb_dvk_5rb} {#tmf_prod_order-PATCH-ord-productOrder-id__table_tzy_thy_ksb__entry__2} | En-tête | Description | |-|-| | Type de contenu | Format de données du corps de la réponse. Ne prend en charge application/jsonque les fichiers . | [Tableau 29. En-têtes de réponses] {#tmf_prod_order-PATCH-ord-productOrder-id__table_tzy_thy_ksb} ### Codes d'état Les codes d'état suivants s'appliquent à cette action HTTP. Pour obtenir la liste des codes d'état possibles utilisés dans l'API REST, consultez [Codes de réponse HTTP de l'API REST](https://servicenow-prod.fluidtopics.net/CFQa7z9NIrhoOq1u1cRN7g "REST (REpresentational State Transfer) est une architecture simple sans état qui fournit des normes entre les systèmes informatiques sur le Web, ce qui leur permet de communiquer plus facilement les uns avec les autres."). {#tmf_prod_order-PATCH-ord-productOrder-id__table_xfv_2vk_5rb__entry__2} | Code d'état | Description | |-|-| | 201 | Réussi. En cas de problèmes avec les caractéristiques ou les informations d'option des caractéristiques, le point de terminaison stocke les commentaires suivants dans les champs de notes de travail de l'enregistrement d'élément de ligne de commande client associé : * Les caractéristiques de l'élément de commande suivantes n'existent pas : Examinez la spécification \ et corrigez la caractéristique et l'option de caractéristique dans l'élément de ligne de commande avant d'approuver la commande. * Caractéristique de l'élément de commande : \ avec la valeur caractéristique : \n'est pas valide. Corrigez les valeurs caractéristiques avant d'approuver la commande. {#tmf_prod_order-PATCH-ord-productOrder-id__ul_xtx_xym_t4b} | | 400 | Demande incorrecte. L'une des raisons suivantes peut être l'une des suivantes : * Charge utile non valide : corps de la demande manquant : la charge utile n'a pas été transmise dans le corps de la demande. * Charge utile non valide : productOrderItem est manquant : l'objet de l'élément de ligne de commande de produit ou JSON est manquant. * Charge utile non valide : l'ID de productOrderItem est manquant : le id paramètre est manquant dans l'élément de ligne de commande de produit de la charge utile. * Charge utile non valide : l'action productOrderItem est manquante : le action paramètre est manquant dans l'élément de ligne de commande de produit de la charge utile. * Charge utile non valide : productOrderItem productOffering est manquant : l'objet ou JSON de l'offre de produit est manquant dans l'élément de ligne de commande de produit dans la charge utile. * Charge utile non valide : l'ID productOffering est manquant : le id paramètre est manquant dans l'élément de ligne de commande de produit de l'objet d'offre de produit dans la charge utile. * Charge utile non valide : l'offre de produit n'existe pas : l'offre de produit dans l'élément de ligne de commande de produit n'est pas valide. * Charge utile non valide : productOrderItem produit manquant : l'objet produit ou JSON dans l'élément de ligne de commande de produit est manquant dans la charge utile. * Charge utile non valide : product productSpecification est manquant : l'objet de spécification du produit ou le JSON dans l'élément de ligne de commande de produit est manquant dans la charge utile. * Charge utile non valide : l'ID de spécification de produit est manquant : le id paramètre de l'élément de ligne de commande de produit de l'objet de spécification de produit est manquant dans la charge utile. * Charge utile non valide : la spécification du produit n'existe pas : la spécification du produit dans l'élément de ligne de commande de produit n'est pas valide. * Charge utile non valide : l'inventaire de produits n'existe pas : dans un ordre de changement (action = changement), la quantité d'un élément est supérieure à ce qui est en stock. * Charge utile non valide : l'ID d'inventaire de produits est manquant : dans un ordre de changement, le product.id est manquant dans la charge utile. * Charge utile non valide : produit vendu est inactif : dans un ordre de changement, un produit spécifié dans la charge utile est inactif. * Charge utile non valide : relatedParty est manquant : l'objet de la partie associée est manquant dans la charge utile. * Le compte client ou le consommateur est manquant : le client tiers connexe ou l'objet de consommateur est manquant dans la charge utile. * Charge utile non valide : Le consommateur n'existe pas : le consommateur tiers associé spécifié n'existe pas dans l'instance ServiceNow . * Charge utile non valide : Le compte client n'existe pas : le client tiers associé spécifié n'existe pas dans l'instance ServiceNow . * Charge utile non valide : Échec de la création de la commande : impossible de créer la commande demandée. * Révision en cours de la devise de la commande non prise en charge : le orderCurrency paramètre ne peut pas être mis à jour une fois la commande créée. * Cette commande n'a pas encore été créée dans la table de commande client. Veuillez vérifier dans la file d'attente entrante pour plus de détails. -- L'ID de commande fourni n'est pas dans la table des commandes du client. * La demande de correctif ne peut pas être effectuée car le type d'exécution de la commande n'est pas \<\< livrer \>\>. : la demande de correctif a été effectuée sur une commande dont le type d'exécution est autre que \<\< livrer \>\>. {#tmf_prod_order-PATCH-ord-productOrder-id__ul_g2v_rzm_t4b} | [Tableau 30. Codes d'état] {#tmf_prod_order-PATCH-ord-productOrder-id__table_xfv_2vk_5rb} ### Paramètres de corps de réponse (JSON) {#tmf_prod_order-PATCH-ord-productOrder-id__section_b1v_xpk_5rb} {#tmf_prod_order-PATCH-ord-productOrder-id__table_c1v_xpk_5rb__entry__2}{#tmf_prod_order-PATCH-ord-productOrder-id__d2876e1604}{#tmf_prod_order-PATCH-ord-productOrder-id__externalProdInvId-resp-descr} | Nom | Description | |-|-| | canal | Tableau d'objets qui décrivent les canaux à utiliser pour vendre les produits. Type de données : tableau "channel": [ { "id": "String", "name": "String" } ] | | channel.id | Identificateur unique du canal à utiliser pour vendre les produits associés. Les valeurs d'ID de canal se trouvent dans le champ external_id de la table Canal de distribution \[sn_prd_pm_distribution_channel\]. Type de données : chaîne | | channel.name | Nom du canal à utiliser pour vendre les produits associés. Type de données : chaîne | | committedDueDate | Date et heure auxquelles l'action doit être effectuée sur la commande. Cette valeur doit être identique ou ultérieure aux valeurs de committedDueDate chaque élément de ligne de commande. Type de données : chaîne | | externalId | Identificateur externe de la commande client, tel qu'un numéro de bon de commande. Type de données : chaîne | | href | Lien relatif à l'enregistrement de commande de produit. Type de données : chaîne | | id | Sys_id de la commande client mis à jour pour cette demande. Type de données : chaîne | | note | Tableau d'objets qui décrivent les notes supplémentaires prises par le client lors de la commande. Type de données : tableau "note": [ { "text": "String" } ] | | note.texte | Remarques/commentaires supplémentaires formulés par le client lors de la commande. Type de données : chaîne | | orderCurrency | Code de devise pour la commande et les éléments de ligne de commande. Type de données : chaîne | | Élément de commande produit | Liste décrivant les éléments associés à la commande de produit et leur action associée. Type de données : tableau "productOrderItem:" [ { "action": "String", "committedDueDate": "String", "externalProductInventory": [Array], "id": "String", "itemPrice": [Array], "product": {Object}, "productOffering": {Object}, "productOrderItemReleationship": [Array], "quantity": Number, "state": "String", "@type": "String" } ] | | productOrderItem.action | Action à effectuer sur le produit. Les actions possibles sont définies dans l'onglet Liste de choix de l'entrée du dictionnaire d'actions de la table sn_ind_tmt_orm_order_line_item. Type de données : chaîne | | Élément de commandeproduit.actionReason | Motif de l'ajout de l'élément de ligne de commande. Type de données : chaîne Table/champ mis à jour : sn_ind_tmt_orm_order_line_item/action_reason | | productOrderItem.committedDueDate | Date et heure auxquelles l'action doit être effectuée sur l'élément de ligne de commande. Type de données : chaîne | | productOrderItem.externalProductInventory | Tableau d'objets contenant des ID externes à mapper aux inventaires de produits créés pour la commande. Type de données : tableau "externalProductInventory": [ { "externalProductInventoryId": "String" } ] Remarque : Auparavant, lors de la création d'une commande PATCH avec un ID d'inventaire de produit externe qui existait déjà, l'opération était abandonnée et renvoyait une erreur. Avec la Xanadu version, ce paramètre est simplement ignoré lorsqu'un ID d'inventaire de produits externe existant est fourni et qu'une erreur n'est pas générée. | | productOrderItem.externalProductInventory.externalProductInventoryId | ID externe mappé à l'inventaire des produits. Type de données : chaîne | | productOrderItem.id | Identificateur unique de l'élément de ligne. Situé dans le champ sn_ind_tmt_orm_external_id de la table Élément de ligne de commande \[sn_ind_tmt_orm_order_line_item\]. Type de données : chaîne | | productOrderItem.itemPrice | Tableau d'objets décrivant le prix associé au produit. Type de données : tableau "itemPrice": [ { "price": {Object}, "priceType": "String", "recurringChargePeriod": "String" } ] | | productOrderItem.itemPrice.price | Description du prix du produit associé. Type de données : objet "price": { "taxIncludedAmount": {Object} } | | productOrderItem.itemPrice.price.taxIncludeAmount | Description du prix du produit associé, taxes comprises. Type de données : objet "taxIncludedAmount": { "unit": "String", "value": Number } | | productOrderItem.itemPrice.price.taxIncludeAmount.unit | Code de devise dans lequel le prix est représenté. Type de données : chaîne | | productOrderItem.itemPrice.price.taxIncludeAmount.value | Prix du produit, toutes taxes comprises. Type de données : nombre | | productOrderItem.itemPrice.priceType | Type de prix de l'article, récurrent ou non récurrent. Type de données : chaîne | | productOrderItem.itemPrice.recurringChargePeriod | Si le prix est récurrent, la période récurrente, par exemple le mois. Type de données : chaîne | | productOrderItem.product | Description des détails de l'instance du produit acheté par le client. Type de données : objet "product": { "id": "String", "place": {Object}, "productCharacteristic": [Array], "productSpecification": {Object}, "relatedParty": {Object}, "@type": "String" } | | productOrderItem.product.id | Identificateur unique du produit vendu. Situé dans le champ sys_id ou sn_ind_tmt_orm_external_id de la table Inventaire des produits \[sn_ind_tmt_orm_product_inventory\]. Type de données : chaîne | | productOrderItem.product.place | Cartes des emplacements sur lesquels installer le produit. Type de données : objet "place": { "id": "String", "@type": "String" } | | productOrderItem.product.place.id | Sys_id de l'enregistrement de l'emplacement associé dans la table Emplacement \[cmn_location\]. Type de données : chaîne | | productOrderItem.product.productCharacteristic | Tableau d'objets décrivant les caractéristiques du produit associé. Type de données : tableau "productCharacteristic": [ { "name": "String", "previousValue": "String", "value": "String" } ] | | productOrderItem.product.productCharacteristic.name | Nom de l'enregistrement de la caractéristique à associer au produit. Situé dans la table Caractéristique \[sn_prd_pm_characteristic\]. Type de données : chaîne | | productOrderItem.product.productCharacteristic.previousValue | Valeurs d'option de caractéristique précédentes si la mise à jour concerne un ordre de changement. La demande est un ordre de changement si le paramètre est autre que ajouterproductOrderItem.action. Pour plus d'informations sur les valeurs des options de caractéristique, reportez-vous à la section [Create product characteristics and characteristic options](https://www.servicenow.com/docs/access?context=som-product-config-add-characteristics&version=xanadu&pubname=xanadu-order-management&ft:locale=en-US). Type de données : chaîne | | productOrderItem.product.productCharacteristic.value | Valeurs d'option de caractéristique associées au produit. Pour plus d'informations sur les valeurs des options de caractéristique, reportez-vous à la section [Create product characteristics and characteristic options](https://www.servicenow.com/docs/access?context=som-product-config-add-characteristics&version=xanadu&pubname=xanadu-order-management&ft:locale=en-US). Type de données : chaîne | | productOrderItem.product.productSpecification | Description de la spécification du produit associée au produit. Type de données : objet "productSpecification:" { "id": "String", "internalId": "String", "internalVersion": "String", "name": "String", "version": "String", "@type": "String" } | | productOrderItem.product.productSpecification.id | Initial_version ou external_id des spécifications du produit. Le initial_version est le sys_id de la première version de la spécification. Situé dans le champ sys_id ou external_id de la table Spécification de produit \[sn_prd_pm_product_specification\]. Type de données : chaîne | | productOrderItem.product.productSpecification.internalId | Initial_version des spécifications du produit. Le initial_version est le sys_id de la première version de la spécification. Situé dans la table Spécification de produit \[sn_prd_pm_product_specification\]. Type de données : chaîne | | productOrderItem.product.productSpecification.internalVersion | Version de la spécification du produit. Situé dans la table Spécification de produit \[sn_prd_pm_product_specification\]. Type de données : chaîne | | productOrderItem.product.productSpecification.name | Nom de la spécification de produit. Situé dans la table Spécification de produit \[sn_prd_pm_product_specification\]. Type de données : chaîne | | productOrderItem.product.productSpecification.version | External_version des spécifications du produit. Situé dans la table Spécification de produit \[sn_prd_pm_product_specification\]. Type de données : chaîne | | productOrderItem.product.productSpecification.@type | Fait partie de la norme TMF Open API. Cette valeur est toujours ProductSpecificationRef. Ces informations ne sont pas stockées. Type de données : chaîne | | élémentcommandeproduit.produit.relatedparty | Liste des contacts pour les éléments de ligne. Type de données : tableau "relatedParty": [ { "email": "String", "firstName": "String", "id": "String", "lastName": "String", "phone": "String", "@referredType": "String", "@type": "String" } ] | | productOrderItem.product.relatedParty.email | Adresse e-mail du contact. Type de données : chaîne | | productOrderItem.product.relatedParty.firstName | Prénom de la personne à contacter. Type de données : chaîne | | productOrderItem.product.relatedParty.id | Sys_id du contact de l'élément de ligne associé à l'élément de ligne de commande. Situé dans la table Contact de l'élément de ligne de commande \[sn_ind_tmt_orm_order_line_item_contact\]. Type de données : chaîne | | productOrderItem.product.relatedParty.lastName | Nom de famille du contact. Type de données : chaîne | | productOrderItem.product.relatedParty.phone | Numéro de téléphone professionnel du contact. Type de données : chaîne | | productOrderItem.product.relatedParty.@referredType | Type de client. Valeur possible : OrderLineItemContact Type de données : chaîne | | productOrderItem.product.relatedParty.@type | Fait partie de la norme TMF Open API. Annotation pour le contact de l'élément de ligne de commande. Cette valeur est toujours RelatedParty. Ces informations ne sont pas stockées. Type de données : chaîne | | productOrderItem.product.@type | Fait partie de la norme TMF Open API. Annotation pour le produit. Cette valeur est toujours Produit. Ces informations ne sont pas stockées. Type de données : chaîne | | productOrderItem.productOffering | Description de l'offre de produit associée au produit. Type de données : objet "productOffering:" { "id": "String", "internalId": "String", "internalVersion": "String", "name": "String", "version": "String" } | | productOrderItem.productOffering.id | Initial_version ou external_id de l'offre de produits. Le initial_version est le sys_id de la première version de l'offre. Situé dans le champ sys_id ou external_id de la table Offre de produits \[sn_prd_pm_product_offering\]. Type de données : chaîne | | productOrderItem.productOffering.internalId | Initial_version de l'offre de produits. Le initial_version est le sys_id de la première version de l'offre. Situé dans la table Offre de produits \[sn_prd_pm_product_offering\]. Type de données : chaîne | | productOrderItem.productOffering.internalVersion | Version de l'offre de produit. Situé dans la table Offre de produits \[sn_prd_pm_product_offering\]. Type de données : chaîne | | productOrderItem.productOffering.name | Nom de l'offre de produits. Situé dans la table Offre de produits \[sn_prd_pm_product_offering\]. Type de données : chaîne | | Élément de commandedeproduit.offredeproduit.version | External_version de l'offre de produits. Situé dans la table Offre de produits \[sn_prd_pm_product_offering\]. Type de données : chaîne | | productOrderItem.productOrderItemRelationship | Tableau d'objets décrivant les relations entre les éléments de ligne de commande. Type de données : tableau "productOrderItemRelationship": [ { "id": "String", "relationshipType": "String" } ] | | productOrderItem.productOrderItemRelationship.id | Identificateur unique de l'élément de ligne connexe. Situé dans le champ sn_ind_tmt_orm_external_id de la table Élément de ligne de commande \[sn_ind_tmt_orm_order_line_item\]. Type de données : chaîne | | productOrderItem.productOrderItemRelationship.relationshipType | Type de relation entre les deux éléments de ligne. Ces informations sont utilisées pour identifier la hiérarchie des relations. Type de données : chaîne | | productOrderItem.quantity | Nombre des éléments associés à commander. Type de données : nombre | | élémentcommandeproduit.état | État actuel de l'élément de commande de produit. Type de données : chaîne | | productOrderItem.@type | Fait partie de la norme TMF Open API. Annotation pour le produit. Cette valeur est toujours ProductOrderItem. Ces informations ne sont pas stockées. Type de données : chaîne | | relatedParty | Liste des contacts de la commande. Chaque contact est un objet dans le tableau. Doit énumérer au moins un élément qui contient des informations sur le compte client ou le compte de consommateur. Type de données : tableau "relatedParty": [ { "id": "String", "name": "String", "@referredType": "String", "@type": "String" } ] | | relatedParty.id | Sys_id ou external_id du compte, du contact client ou du consommateur associé à la commande. Situé dans la table Compte \[customer_account\], Contact \[customer_contact\] ou Consommateur \[csm_consumer\]. Type de données : chaîne | | relatedParty.name | Nom du compte, du client ou du consommateur. Type de données : chaîne | | relatedParty.type | Type de client. Valeurs possibles : * Consommateur * Client * Contact du client {#tmf_prod_order-PATCH-ord-productOrder-id__d2876e2460} Type de données : chaîne | | requestedCompletionDate | Date de livraison demandée par le client. Type de données : chaîne | | Date de début demandée | Date de début de commande demandée par le client. Type de données : chaîne | | État | État actuel de la commande. Type de données : chaîne | | @type | Fait partie de la norme TMF Open API. Annotation pour le produit. Cette valeur est toujours ProductOrder. Ces informations ne sont pas stockées. Type de données : chaîne | [ ] {#tmf_prod_order-PATCH-ord-productOrder-id__table_c1v_xpk_5rb} ### Demande cURL {#tmf_prod_order-PATCH-ord-productOrder-id__example_jsc_1dc_vrb} Cet exemple met à jour le canal pour une commande de produit. curl -X PATCH "https://instance.service-now.com/api/sn_ind_tmt_orm/order/productOrder/8d75939453126010a795ddeeff7b126a" \ -H "Accept: application/json" \ -H "Content-Type: application/json" \ -u "username":"password" \ -d { "channel": [ { "id": "1", "name": "Agent Assist" } ] } Corps de réponse. { "id": "8d75939453126010a795ddeeff7b126a", "href": "/api/sn_ind_tmt_orm/order/productOrder/8d75939453126010a795ddeeff7b126a", "expectedCompletionDate": "2021-05-02T08:13:59.000Z", "requestedCompletionDate": "2021-05-02T08:13:59.000Z", "requestedStartDate": "2020-05-03T08:13:59.000Z", "externalId": "PO-456", "orderCurrency": "USD", "channel": [ { "id": "1", "name": "Agent Assist" } ], "note": [ { "author": "System Administrator", "date": "2021-02-25T14:22:07.000Z", "text": "This is a TMF product order illustration no 2" }, { "author": "System Administrator", "date": "2021-02-25T14:22:06.000Z", "text": "This is a TMF product order illustration" } ], "productOrderItem": [ { "id": "POI130", "ponr": "false", "quantity": 1, "action": "add", "actionReason": "adding service package OLI", "itemPrice": [ { "priceType": "recurring", "price": { "taxIncludedAmount": { "unit": "USD", "value": 20 } } }, { "priceType": "nonRecurring", "price": { "taxIncludedAmount": { "unit": "INR", "value": 0 } } } ], "product": { "@type": "Product", "productCharacteristic": [ { "name": "Security Type", "valueType": "Choice", "value": "Base", "previousValue": "" } ], "productSpecification": { "id": "a6514bd3534560102f18ddeeff7b1247", "name": "SD-WAN Security", "version": "v1", "internalVersion": "1", "internalId": "a6514bd3534560102f18ddeeff7b1247", "@type": "ProductSpecificationRef" }, "relatedParty": [ { "id": "4175939453126010a795ddeeff7b127d", "name": "John Smith", "email": "abc2@example.com", "phone": "32456768", "@type": "RelatedParty", "@referredType": "OrderLineItemContact" }, { "id": "c175939453126010a795ddeeff7b127c", "name": "Joe Doe", "email": "abc@example.com", "phone": "1234567890", "@type": "RelatedParty", "@referredType": "OrderLineItemContact" } ] }, "productOffering": { "id": "69017a0f536520103b6bddeeff7b127d", "name": "Premium SD-WAN Offering", "version": "v1", "internalId": "69017a0f536520103b6bddeeff7b127d", "internalVersion": "1" }, "productOrderItemRelationship": [ { "id": "POI100", "relationshipType": "HasParent" } ], "state": "in_progress", "version": "1", "@type": "ProductOrderItem" }, { "id": "POI100", "ponr": "false", "quantity": 1, "action": "add", "itemPrice": [ { "priceType": "recurring", "price": { "taxIncludedAmount": { "unit": "INR", "value": 0 } } }, { "priceType": "nonRecurring", "price": { "taxIncludedAmount": { "unit": "INR", "value": 0 } } } ], "product": { "@type": "Product", "productSpecification": { "id": "cfe5ef6a53702010cd6dddeeff7b12f6", "name": "SD-WAN Service Package", "version": "v1", "internalVersion": "1", "internalId": "cfe5ef6a53702010cd6dddeeff7b12f6", "@type": "ProductSpecificationRef" } }, "productOffering": { "id": "69017a0f536520103b6bddeeff7b127d", "name": "Premium SD-WAN Offering", "version": "v1", "internalId": "69017a0f536520103b6bddeeff7b127d", "internalVersion": "1" }, "productOrderItemRelationship": [ { "id": "POI130", "relationshipType": "HasChild" }, { "id": "POI120", "relationshipType": "HasChild" }, { "id": "POI110", "relationshipType": "HasChild" } ], "state": "in_progress", "version": "1", "@type": "ProductOrderItem" }, { "id": "POI120", "ponr": "false", "quantity": 1, "action": "add", "actionReason": "adding service package OLI", "itemPrice": [ { "priceType": "recurring", "price": { "taxIncludedAmount": { "unit": "USD", "value": 20 } } }, { "priceType": "nonRecurring", "price": { "taxIncludedAmount": { "unit": "INR", "value": 0 } } } ], "product": { "@type": "Product", "productCharacteristic": [ { "name": "CPE Type", "valueType": "Choice", "value": "Physical", "previousValue": "" }, { "name": "WAN Optimization", "valueType": "Choice", "value": "Advance", "previousValue": "" }, { "name": "Routing", "valueType": "Choice", "value": "Premium", "previousValue": "" }, { "name": "CPE Model", "valueType": "Choice", "value": "ASR", "previousValue": "" } ], "productSpecification": { "id": "39b627aa53702010cd6dddeeff7b1202", "name": "SD-WAN Edge Device", "version": "v1", "internalVersion": "1", "internalId": "39b627aa53702010cd6dddeeff7b1202", "@type": "ProductSpecificationRef" } }, "productOffering": { "id": "69017a0f536520103b6bddeeff7b127d", "name": "Premium SD-WAN Offering", "version": "v1", "internalVersion": "1", "internalId": "69017a0f536520103b6bddeeff7b127d" }, "productOrderItemRelationship": [ { "id": "POI100", "relationshipType": "HasParent" } ], "state": "in_progress", "version": "1", "@type": "ProductOrderItem" }, { "id": "POI110", "ponr": "false", "quantity": 1, "action": "add", "actionReason":"adding service package OLI", "itemPrice": [ { "priceType": "recurring", "price": { "taxIncludedAmount": { "unit": "INR", "value": 0 } } }, { "priceType": "nonRecurring", "price": { "taxIncludedAmount": { "unit": "USD", "value": 5 } } } ], "product": { "@type": "Product", "productCharacteristic": [ { "name": "Tenancy", "valueType": "Choice", "value": "Base (10 site)", "previousValue": "" } ], "productSpecification": { "id": "216663aa53702010cd6dddeeff7b12b5", "name": "SD-WAN Controller", "version": "v1", "internalVersion": "1", "internalId": "216663aa53702010cd6dddeeff7b12b5", "@type": "ProductSpecificationRef" }, "place": { "id": "25ab9c4d0a0a0bb300f7dabdc0ca7c1c", "@type": "Place" } }, "productOffering": { "id": "69017a0f536520103b6bddeeff7b127d", "name": "Premium SD-WAN Offering", "version": "v1", "internalId": "69017a0f536520103b6bddeeff7b127d", "internalVersion": "1" }, "productOrderItemRelationship": [ { "id": "POI100", "relationshipType": "HasParent" } ], "state": "in_progress", "version": "1", "@type": "ProductOrderItem" } ], "relatedParty": [ { "id": "eaf68911c35420105252716b7d40ddde", "name": "Sally Thomas", "@type": "RelatedParty", "@referredType": "CustomerContact" }, { "id": "ffc68911c35420105252716b7d40dd55", "name": "Funco Intl", "@type": "RelatedParty", "@referredType": "Customer" }, { "id": "59f16de1c3b67110ff00ed23a140dd9e", "name": "Funco External", "@type": "RelatedParty", "@referredType": "Consumer" } ], "state": "in_progress", "@type": "ProductOrder" } ## API ouverte pour la commande de produit : PATCH /sn_ind_tmt_orm/productorder/{id} {#ariaid-title7} Met à jour la commande client spécifiée. Important : Ce point de terminaison est obsolète à partir de la Tokyo mise en production. La nouvelle version de ce point de terminaison est [API ouverte pour la commande de produit : PATCH /sn_ind_tmt_orm/order/productOrder/{id}](https://servicenow-prod.fluidtopics.net/7R48AWEcFp5whb2FwX7mKg#tmf_prod_order-PATCH-ord-productOrder-id "Met à jour la commande client spécifiée."). ### Format d'URL URL par défaut : /api/sn_ind_tmt_orm/productorder/{id} ### Paramètres de demande pris en charge {#tmf_prod_order-PATCH-productorder-id__entry__2} | Nom | Description | |-|-| | id | Sys_id de la commande client à mettre à jour. Situé dans la table Commande client \[sn_ind_tmt_orm_order\]. Type de données : chaîne | [Tableau 31. Paramètres de chemin d'accès] {#tmf_prod_order-PATCH-productorder-id__entry__6} | Nom | Description | |-|-| | Aucun | | [Tableau 32. Paramètres de requête] {#tmf_prod_order-PATCH-productorder-id__id_vk2_p5n_t4b__entry__2}{#tmf_prod_order-PATCH-productorder-id__channel-ph-tmf622}{#tmf_prod_order-PATCH-productorder-id__channel_id-ph-tmf622}{#tmf_prod_order-PATCH-productorder-id__channel_name-ph-tmf622}{#tmf_prod_order-PATCH-productorder-id__due-date-PATCH}{#tmf_prod_order-PATCH-productorder-id__externalId-ph-tmf622}{#tmf_prod_order-PATCH-productorder-id__note-ph-tmf622}{#tmf_prod_order-PATCH-productorder-id__note_text-ph-tmf622}{#tmf_prod_order-PATCH-productorder-id__prodOrdItem-ph-tmf622}{#tmf_prod_order-PATCH-productorder-id__prodOrdItem_action-ph-tmf622}{#tmf_prod_order-PATCH-productorder-id__prodOrdItem_actionReason-response-tmf622}{#tmf_prod_order-PATCH-productorder-id__due-date-item-PATCH}{#tmf_prod_order-PATCH-productorder-id__externalProdInv-descr-PATCH}{#tmf_prod_order-PATCH-productorder-id__externalProdInvId-decsr}{#tmf_prod_order-PATCH-productorder-id__prodOrdItem_id-ph-tmf622}{#tmf_prod_order-PATCH-productorder-id__itemPrice-ph-tmf622}{#tmf_prod_order-PATCH-productorder-id__itemPrice_price-ph-tmf622}{#tmf_prod_order-PATCH-productorder-id__itemPrice_price_taxIncludedAmt-ph-tmf622}{#tmf_prod_order-PATCH-productorder-id__itemPrice_price_taxIncludedAmt_unit-ph-tmf622}{#tmf_prod_order-PATCH-productorder-id__itemPrice_price_taxIncludedAmt_value-ph-tmf622}{#tmf_prod_order-PATCH-productorder-id__itemPrice_priceType_data_type-p-tmf622}{#tmf_prod_order-PATCH-productorder-id__itemPrice_recurringChargePeriod_data_type-p-tmf622}{#tmf_prod_order-PATCH-productorder-id__product-p-tmf622}{#tmf_prod_order-PATCH-productorder-id__product_id-ph-tmf622}{#tmf_prod_order-PATCH-productorder-id__product_place-ph-tmf622}{#tmf_prod_order-PATCH-productorder-id__product_place_id-ph-tmf622}{#tmf_prod_order-PATCH-productorder-id__product_place_type_data_type-p-tmf622}{#tmf_prod_order-PATCH-productorder-id__prod_prodChar-ph-tmf622}{#tmf_prod_order-PATCH-productorder-id__prod_prodChar_name-ph-tmf622}{#tmf_prod_order-PATCH-productorder-id__prod_prodChar_previousValue-ph-tmf622}{#tmf_prod_order-PATCH-productorder-id__prod_prodChar_value-ph-tmf622}{#tmf_prod_order-PATCH-productorder-id__prod_prodSpec-ph-tmf622}{#tmf_prod_order-PATCH-productorder-id__prod_prodSpec_id_data_type-p-tmf622}{#tmf_prod_order-PATCH-productorder-id__prod_prodSpec_name_data_type-p-tmf622}{#tmf_prod_order-PATCH-productorder-id__prod_prodSpec_type_data_type-p-tmf622}{#tmf_prod_order-PATCH-productorder-id__prod_relParty-ph-tmf622}{#tmf_prod_order-PATCH-productorder-id__prod_relParty_email-ph-tmf622}{#tmf_prod_order-PATCH-productorder-id__prod_relParty_firstName-ph-tmf622}{#tmf_prod_order-PATCH-productorder-id__prod_relParty_id-ph-tmf622}{#tmf_prod_order-PATCH-productorder-id__prod_relParty_lastName-ph-tmf622}{#tmf_prod_order-PATCH-productorder-id__prod_relParty_phone-ph-tmf622}{#tmf_prod_order-PATCH-productorder-id__prod_relParty_refType_data_type-p-tmf622}{#tmf_prod_order-PATCH-productorder-id__product_relatedParty_type_data_type-row-tmf622}{#tmf_prod_order-PATCH-productorder-id__product_type_data_type-p-tmf622}{#tmf_prod_order-PATCH-productorder-id__productOffer-ph-tmf622}{#tmf_prod_order-PATCH-productorder-id__prodOffer_id_data_type-p-tmf622}{#tmf_prod_order-PATCH-productorder-id__prodOffer_name_data_type-p-tmf622}{#tmf_prod_order-PATCH-productorder-id__prodOrdItem_quantity-ph-tmf622}{#tmf_prod_order-PATCH-productorder-id__prodOrderItemRel-ph-tmf622}{#tmf_prod_order-PATCH-productorder-id__prodOrderItemRel_id-ph-tmf622}{#tmf_prod_order-PATCH-productorder-id__prodOrderItemRel_relType_data_type-p-tmf622}{#tmf_prod_order-PATCH-productorder-id__prodOrdItem_type-entry-tmf622}{#tmf_prod_order-PATCH-productorder-id__relatedParty-ph-tmf622}{#tmf_prod_order-PATCH-productorder-id__relatedParty_id_data_type-p-tmf622}{#tmf_prod_order-PATCH-productorder-id__relatedParty_name_data_type-p-tmf622}{#tmf_prod_order-PATCH-productorder-id__relatedParty_refType_data_type-p-tmf622}{#tmf_prod_order-PATCH-productorder-id__relatedParty_type_data_type-p-tmf622}{#tmf_prod_order-PATCH-productorder-id__requestedCompletionDate-ph-tmf622}{#tmf_prod_order-PATCH-productorder-id__reqStartDate-ph-tmf622}{#tmf_prod_order-PATCH-productorder-id__type-entry-tmf622} | Nom | Description | |-|-| | canal | Tableau d'objets qui décrivent les canaux à utiliser pour vendre les produits. Type de données : tableau{#tmf_prod_order-PATCH-productorder-id__channel_data_type-p-tmf622} "channel": [ { "id": "String", "name": "String" } ] {#tmf_prod_order-PATCH-productorder-id__channel_obj_def-codeblock-tmf622} Table/champ mis à jour : sn_ind_tmt_orm_order | | channel.id | Requis si le channel paramètre est utilisé. Identificateur unique du canal à utiliser pour vendre les produits associés. Les valeurs d'ID de canal se trouvent dans le champ external_id de la table Canal de distribution \[sn_prd_pm_distribution_channel\]. Type de données : chaîne{#tmf_prod_order-PATCH-productorder-id__channel_id_data_type-p-tmf622} Table/champ mis à jour : sn_ind_tmt_orm_order/canal Par défaut : chaîne vide | | channel.name | Nom du canal à utiliser pour vendre les produits associés. Les noms de canaux possibles sont définis dans l'onglet Liste de choix de l'entrée du dictionnaire des canaux de la table sn_ind_tmt_orm_order. Type de données : chaîne{#tmf_prod_order-PATCH-productorder-id__channel_name_data_type-p-tmf622} Par défaut : chaîne vide | | committedDueDate | Date et heure auxquelles l'action doit être effectuée sur la commande. Cette valeur doit être identique ou ultérieure aux valeurs de committedDueDate chaque élément de ligne de commande. Si l'action pour les éléments de ligne de commande est suspendre ou reprendre, ce paramètre ne peut pas être mis à jour. Type de données : chaîne Table/champ mis à jour : sn_ind_tmt_orm_order/committed_due_date | | externalId | Identificateur unique de la commande du client. Cette valeur est déterminée par un système externe. Type de données : chaîne{#tmf_prod_order-PATCH-productorder-id__externalId_data_type-p-tmf622} Table/champ mis à jour : sn_ind_tmt_orm_order/external_id Par défaut : chaîne vide | | note | Tableau d'objets qui décrivent les notes supplémentaires prises par le client lors de la commande. Type de données : tableau{#tmf_prod_order-PATCH-productorder-id__note_data_type-p-tmf622} "note": [ { "text": "String" } ] {#tmf_prod_order-PATCH-productorder-id__note-codeblock-tmf622} Table/champ mis à jour : sn_ind_tmt_orm_order | | note.texte | Remarques/commentaires supplémentaires formulés par le client lors de la commande. Type de données : chaîne{#tmf_prod_order-PATCH-productorder-id__note_text_data_type-p-tmf622} Table/champ mis à jour : sn_ind_tmt_orm_order/commentaires Par défaut : chaîne vide | | orderCurrency | Code de devise pour la commande et les éléments de ligne de commande. La mise à jour du code de devise d'une commande existante n'est pas prise en charge. Fournir une valeur autre que le code de devise déjà associé à la commande entraîne le rejet de la mise à jour. Type de données : chaîne | | Élément de commande produit | Liste décrivant les éléments associés à la commande de produit et leur action associée. Type de données : tableau{#tmf_prod_order-PATCH-productorder-id__prodOrdItem_data_type-p-tmf622} "productOrderItem": [ { "action": "String", "actionReason": "String", "committedDueDate": "String", "externalProductInventory": [Array], "id": "String", "itemPrice": [Array], "product": {Object}, "productOffering": {Object}, "productOrderItemRelationship": [Array], "quantity": Number, "revisionOperation": "String", "@type": "String" } ] {#tmf_prod_order-PATCH-productorder-id__prodOrdItem-codeblock-tmf622} Table/champ mis à jour : sn_ind_tmt_orm_order_line_item | | productOrderItem.action | Requis si le productOrderItem paramètre est utilisé. Action à effectuer sur le produit. Les actions possibles sont définies dans l'onglet Liste de choix de l'entrée du dictionnaire d'actions de la table sn_ind_tmt_orm_order_line_item. Valeurs possibles : * ajouter * changement * supprimer * Aucun changement * reprendre * suspendre {#tmf_prod_order-PATCH-productorder-id__ul_zwn_nxp_ysb} Type de données : chaîne{#tmf_prod_order-PATCH-productorder-id__prodOrdItem_action_data_type-p-tmf622} Table/champ mis à jour : sn_ind_tmt_orm_order_line_item/action Par défaut : add | | Élément de commandeproduit.actionReason | Motif de l'ajout de l'élément de ligne de commande. Type de données : chaîne Table/champ mis à jour : sn_ind_tmt_orm_order_line_item/action_reason | | productOrderItem.committedDueDate | Date et heure auxquelles l'action doit être effectuée sur l'élément de ligne de commande. Si l'action pour l'élément est suspendre ou reprendre, ce paramètre ne peut pas être mis à jour. Type de données : chaîne Table/champ mis à jour : sn_ind_tmt_orm_order_line_item/committed_due_date | | productOrderItem.externalProductInventory | Tableau d'objets contenant des ID externes à mapper aux inventaires de produits créés pour la commande. Type de données : tableau "externalProductInventory": [ { "externalProductInventoryId": "String" } ] Remarque : Auparavant, lors de la création d'une commande PATCH avec un ID d'inventaire de produit externe qui existait déjà, l'opération était abandonnée et renvoyait une erreur. Avec la Xanadu version, ce paramètre est simplement ignoré lorsqu'un ID d'inventaire de produits externe existant est fourni et qu'une erreur n'est pas générée. | | productOrderItem.externalProductInventory.externalProductInventoryId | ID externe à mapper à l'inventaire des produits. Type de données : chaîne Table/champ mis à jour : sn_ind_tmt_orm_order_line_item/external_inventory_id et sn_prd_invt_product_inventory/sn_prd_invt_external_id | | productOrderItem.id | Requis si le productOrderItem paramètre est utilisé. Identificateur unique de l'élément de ligne. Situé dans le champ sn_ind_tmt_orm_external_id de la table Élément de ligne de commande \[sn_ind_tmt_orm_order_line_item\]. Type de données : chaîne{#tmf_prod_order-PATCH-productorder-id__prodOrdItem_id_data_type-p-tmf622} Table/champ mis à jour : sn_ind_tmt_orm_order_line_item/external_id Longueur maximale : 40 Par défaut : chaîne vide | | productOrderItem.itemPrice | Tableau d'objets décrivant le prix associé au produit. Type de données : tableau{#tmf_prod_order-PATCH-productorder-id__itemPrice_data_type-p-tmf622} "itemPrice": [ { "price": {Object}, "priceType": "String", "recurringChargePeriod": "String" } ] {#tmf_prod_order-PATCH-productorder-id__itemPrice-codeblock-tmf622} Table mise à jour : sn_ind_tmt_orm_order Par défaut : chaîne vide | | productOrderItem.itemPrice.price | Description du prix du produit associé. Type de données : objet{#tmf_prod_order-PATCH-productorder-id__itemPrice_price_data_type-p-tmf622} "price": { "taxIncludedAmount": {Object} } {#tmf_prod_order-PATCH-productorder-id__itemPrice_price-codeblock-tmf622} Table mise à jour : sn_ind_tmt_orm_order_line_item Par défaut : chaîne vide | | productOrderItem.itemPrice.price.taxIncludedAmount | Description du prix du produit associé, taxes comprises. Type de données : objet{#tmf_prod_order-PATCH-productorder-id__itemPrice_price_taxIncludedAmt_data_type-p-tmf622} "taxIncludedAmount": { "unit": "String", "value": Number } {#tmf_prod_order-PATCH-productorder-id__itemPrice_price_taxIncludedAmt-codeblock-tmf622} Table mise à jour : sn_ind_tmt_orm_order_line_item | | productOrderItem.itemPrice.price.taxIncludedAmount.unit | Code de devise dans lequel le prix est représenté. Type de données : chaîne{#tmf_prod_order-PATCH-productorder-id__itemPrice_price_taxIncludedAmt_unit_data_type-p-tmf622} Table/champ mis à jour : sn_ind_tmt_orm_order_line_item/mrc ou nrc | | productOrderItem.itemPrice.price.taxIncludedAmount.value | Prix du produit, toutes taxes comprises. Type de données : nombre{#tmf_prod_order-PATCH-productorder-id__itemPrice_price_taxIncludedAmt_value_data_type-p-tmf622} Table/champ mis à jour : sn_ind_tmt_orm_order_line_item/mrc ou nrc | | productOrderItem.itemPrice.priceType | Type de prix de l'article, récurrent ou non récurrent. Type de données : chaîne | | productOrderItem.itemPrice.recurringChargePeriod | Si le prix est récurrent, la période récurrente, par exemple le mois. Type de données : chaîne | | productOrderItem.product | Requis si productOrderItem.action c'est un changement ou une suppression. Description des détails de l'instance du produit acheté par le client. Type de données : objet{#tmf_prod_order-PATCH-productorder-id__product_data_type-p-tmf622} "product": { "id": "String", "place": {Object}, "productCharacteristic": [Array], "productSpecification": {Object}, "relatedParty": {Object}, "@type": "String" } {#tmf_prod_order-PATCH-productorder-id__product-codeblock-tmf622} Table/champ mis à jour : sn_ind_tmt_orm_order_line_item | | productOrderItem.product.id | Requis si productOrderItem.action c'est un changement ou une suppression. Identificateur unique du produit vendu. Situé dans le champ sys_id ou sn_ind_tmt_orm_external_id de la table Inventaire des produits \[sn_ind_tmt_orm_product_inventory\]. Type de données : chaîne{#tmf_prod_order-PATCH-productorder-id__product_id_data_type-p-tmf622} Par défaut : chaîne vide | | ArticleCommandeProduit.produit.place | Cartes des emplacements sur lesquels installer le produit. Type de données : objet{#tmf_prod_order-PATCH-productorder-id__product_place_data_type-p-tmf622} "place": { "id": "String", "@type": "String" } {#tmf_prod_order-PATCH-productorder-id__product_place-codeblock-tmf622} Table/champ mis à jour : sn_ind_tmt_orm_order_line_item | | productOrderItem.product.place.id | Requis si le productOrderItem.product.place paramètre est utilisé. Sys_id de l'enregistrement de l'emplacement associé dans la table Emplacement \[cmn_location\]. Type de données : chaîne{#tmf_prod_order-PATCH-productorder-id__product_place_id_data_type-p-tmf622} Table/champ mis à jour : sn_ind_tmt_orm_order_line_item/emplacement Par défaut : chaîne vide | | productOrderItem.product.place.@type | Fait partie de la norme TMF Open API. Annotation pour le contact de l'élément de ligne de commande. Cette valeur est toujours Place. Ces informations ne sont pas stockées. Type de données : chaîne | | productOrderItem.product.productCharacteristic | Tableau d'objets décrivant les caractéristiques du produit associé. Type de données : tableau{#tmf_prod_order-PATCH-productorder-id__prod_prodChar_data_type-p-tmf622} "productCharacteristic": [ { "name": "String", "previousValue": "String", "value": "String" } ] {#tmf_prod_order-PATCH-productorder-id__prod_prodChar-codeblock-tmf622} Table/champ mis à jour : sn_ind_tmt_orm_order_characteristic_value | | productOrderItem.product.productCharacteristic.name | Nom de l'enregistrement de la caractéristique à associer au produit. Situé dans la table Caractéristique \[sn_prd_pm_characteristic\]. Type de données : chaîne{#tmf_prod_order-PATCH-productorder-id__prod_prodChar_name_data_type-p-tmf622} Table/champ mis à jour : sn_ind_tmt_orm_order_characteristic_value/caractéristiques Par défaut : chaîne vide | | productOrderItem.product.productCharacteristic.previousValue | Valeurs d'option de caractéristique précédentes si la mise à jour concerne un ordre de changement. La demande est un ordre de changement si le paramètre est autre que ajouterproductOrderItem.action. Pour plus d'informations sur les valeurs des options de caractéristique, reportez-vous à la section [Create product characteristics and characteristic options](https://www.servicenow.com/docs/access?context=som-product-config-add-characteristics&version=xanadu&pubname=xanadu-order-management&ft:locale=en-US). Type de données : chaîne{#tmf_prod_order-PATCH-productorder-id__prod_prodChar_previousValue_data_type-p-tmf622} Table/champ mis à jour : sn_ind_tmt_orm_order_characteristic_value/previous_characteristic_option_value Par défaut : chaîne vide | | productOrderItem.product.productCharacteristic.value | Valeurs d'option de caractéristique associées au produit. Pour plus d'informations sur les valeurs des options de caractéristique, reportez-vous à la section [Create product characteristics and characteristic options](https://www.servicenow.com/docs/access?context=som-product-config-add-characteristics&version=xanadu&pubname=xanadu-order-management&ft:locale=en-US). Type de données : chaîne{#tmf_prod_order-PATCH-productorder-id__prod_prodChar_value_data_type-p-tmf622} Table/champ mis à jour : sn_ind_tmt_orm_order_characteristic_value/characteristic_option_value Par défaut : chaîne vide | | productOrderItem.product.productSpecification | Description de la spécification du produit associée au produit. Remarque : Les ordres de changement (productOrderItem.action est `un changement`) sont traités différemment en fonction de la valeur de la sn_ind_tmt_orm.allowSpecVersionUpdateInChangeOrder propriété système. La valeur de cette propriété système détermine le mode de traitement de la commande si la version de l'inventaire des produits est différente de celle indiquée dans la commande. * Lorsque cette propriété système est définie sur vrai (par défaut), l'inventaire des produits est automatiquement mis à niveau vers la version de la commande en modifiant les spécifications du produit référencé. Cela permet de traiter la commande avec succès. * Lorsque cette propriété système est définie sur faux, si l'inventaire des produits est d'une version différente de celle indiquée dans la commande, la commande échoue en raison d'une incompatibilité de version. {#tmf_prod_order-PATCH-productorder-id__ul_sgb_q5y_hbc} Type de données : objet{#tmf_prod_order-PATCH-productorder-id__prod_prodSpec_data_type-p-tmf622} "productSpecification": { "id": "String", "internalVersion": "String", "name": "String", "version": "String", "@type": "String" } {#tmf_prod_order-PATCH-productorder-id__prod_prodSpec-codeblock-tmf622} Table/champ mis à jour : sn_ind_tmt_orm_order_line_item | | productOrderItem.product.productSpecification.id | Requis si le productOrderItem.product.productSpecification paramètre est utilisé. Initial_version ou external_id des spécifications du produit. Le initial_version est le sys_id de la première version de la spécification. Situé dans le champ sys_id ou external_id de la table Spécification de produit \[sn_prd_pm_product_specification\]. Type de données : chaîne | | productOrderItem.product.productSpecification.internalVersion | Version de la spécification du produit. Situé dans la table Spécification de produit \[sn_prd_pm_product_specification\]. Type de données : chaîne | | productOrderItem.product.productSpecification.name | Nom de la spécification de produit. Situé dans la table Spécification de produit \[sn_prd_pm_product_specification\]. Type de données : chaîne | | productOrderItem.product.productSpecification.version | External_version des spécifications du produit. Situé dans la table Spécification de produit \[sn_prd_pm_product_specification\]. Type de données : chaîne | | productOrderItem.product.productSpecification.@type | Fait partie de la norme TMF Open API. Cette valeur est toujours ProductSpecificationRef. Ces informations ne sont pas stockées. Type de données : chaîne | | élémentcommandeproduit.produit.relatedparty | Liste des contacts pour les éléments de ligne. Type de données : tableau{#tmf_prod_order-PATCH-productorder-id__prod_relParty_data_type-p-tmf622} "relatedParty": [ { "email": "String", "firstName": "String", "id": "String", "lastName": "String", "phone": "String", "@referredType": "String", "@type": "String" } ] {#tmf_prod_order-PATCH-productorder-id__prod_relParty-codeblock-tmf622} Table/champ mis à jour : sn_ind_tmt_orm_order_line_item_contact | | productOrderItem.product.relatedParty.email | Adresse e-mail du contact. Type de données : chaîne{#tmf_prod_order-PATCH-productorder-id__prod_relParty_email_data_type-p-tmf622} Table/champ mis à jour : sn_ind_tmt_orm_order_line_item_contact/e-mail Par défaut : chaîne vide | | productOrderItem.product.relatedParty.firstName | Prénom de la personne à contacter. Type de données : chaîne{#tmf_prod_order-PATCH-productorder-id__prod_relParty_firstName_data_type-p-tmf622} Table/champ mis à jour : sn_ind_tmt_orm_order_line_item_contact/first_name Par défaut : chaîne vide | | productOrderItem.product.relatedParty.id | Sys_id du contact de l'élément de ligne associé à l'élément de ligne de commande. Situé dans la table Contact de l'élément de ligne de commande \[sn_ind_tmt_orm_order_line_item_contact\]. Type de données : chaîne{#tmf_prod_order-PATCH-productorder-id__prod_relParty_id_data_type-p-tmf622} Table/champ mis à jour : sn_ind_tmt_orm_order_line_item_contact/sys_id Par défaut : chaîne vide | | productOrderItem.product.relatedParty.lastName | Nom de famille du contact. Type de données : chaîne{#tmf_prod_order-PATCH-productorder-id__prod_relParty_lastName_data_type-p-tmf622} Table/champ mis à jour : sn_ind_tmt_orm_order_line_item_contact/lastName Par défaut : chaîne vide | | ArticleCommandeProduit.produit.Partie.Téléphone.Produit.CommandeProduit.Téléphone.ProduitCommandeProduit.ProduitCommandeT | Numéro de téléphone professionnel du contact. Type de données : chaîne{#tmf_prod_order-PATCH-productorder-id__prod_relParty_phone_data_type-p-tmf622} Table/champ mis à jour : sn_ind_tmt_orm_order_line_item_contact/business_phone Par défaut : chaîne vide | | productOrderItem.product.relatedParty.@referredType | Type de client. Valeur possible : OrderLineItemContact{#tmf_prod_order-PATCH-productorder-id__prod_relParty_refType-p-tmf622} Type de données : chaîne | | productOrderItem.product.relatedParty.@type | Fait partie de la norme TMF Open API. Annotation pour le contact de l'élément de ligne de commande. Cette valeur est toujours RelatedParty. Ces informations ne sont pas stockées. Type de données : chaîne | | productOrderItem.product.@type | Fait partie de la norme TMF Open API. Annotation pour le produit. Cette valeur est toujours Produit. Ces informations ne sont pas stockées. Type de données : chaîne | | productOrderItem.productOffering | Description de l'offre de produit associée au produit. Type de données : objet{#tmf_prod_order-PATCH-productorder-id__prodOffer_data_type-p-tmf622} "productOffering": { "id": "String", "internalVersion": "String", "name": "String", "version": "String" } {#tmf_prod_order-PATCH-productorder-id__prodOffer-codeblock-tmf622} Table mise à jour : sn_ind_tmt_orm_order_line_item | | productOrderItem.productOffering.id | Requis si le productOrderItem.productOffering paramètre est utilisé. Initial_version ou external_id de l'offre de produits. Le initial_version est le sys_id de la première version de l'offre. Situé dans le champ sys_id ou external_id de la table Offre de produits \[sn_prd_pm_product_offering\]. Type de données : chaîne | | productOrderItem.productOffering.internalVersion | Version de l'offre de produit. Situé dans la table Offre de produits \[sn_prd_pm_product_offering\]. Type de données : chaîne | | productOrderItem.productOffering.name | Nom de l'offre de produits. Situé dans la table Offre de produits \[sn_prd_pm_product_offering\]. Type de données : chaîne | | Élément de commandedeproduit.offredeproduit.version | External_version de l'offre de produits. Situé dans la table Offre de produits \[sn_prd_pm_product_offering\]. Type de données : chaîne | | productOrderItem.productOrderItem.quantity | Nombre des éléments associés à commander. Type de données : nombre{#tmf_prod_order-PATCH-productorder-id__prodOrdItem_quantity_data_type-p-tmf622} Table/champ mis à jour : sn_ind_tmt_orm_order/quantité Par défaut : null | | productOrderItem.productOrderItemRelationship | Tableau d'objets décrivant les relations entre les éléments de ligne de commande. Type de données : tableau{#tmf_prod_order-PATCH-productorder-id__prodOrderItemRel_data_type-p-tmf622} "productOrderItemRelationship": [ { "id": "String", "relationshipType": "String" } ] {#tmf_prod_order-PATCH-productorder-id__prodOrderItemRel-codeblock-tmf622} Table/champ mis à jour : sn_ind_tmt_orm_order_line_item | | productOrderItem.productOrderItemRelationship.id | Requis si le productOrderItem.productOrderItemRelationship paramètre est utilisé. Identificateur unique de l'élément de ligne connexe. Situé dans le champ sn_ind_tmt_orm_external_id de la table Élément de ligne de commande \[sn_ind_tmt_orm_order_line_item\]. Type de données : chaîne{#tmf_prod_order-PATCH-productorder-id__prodOrderItemRel_id_data_type-p-tmf622} Table/champ mis à jour : sn_ind_tmt_orm_order_line_item/parent_line_item Par défaut : chaîne vide | | productOrderItem.productOrderItemRelationship.relationshipType | Type de relation entre les deux éléments de ligne. Ces informations sont utilisées pour identifier la hiérarchie des relations. Valeurs possibles : * HasChild (en anglais seulement) * HasParent (en anglais seulement) * Exige {#tmf_prod_order-PATCH-productorder-id__ul_yqf_2ty_54b} `HasChild` et `HasParent` sont utilisés pour les relations parent/enfant. `Exige` est utilisé pour les relations horizontales (un élément de ligne nécessite un autre élément de ligne). Type de données : chaîne | | productOrderItem.quantity | Nombre d'éléments commandés. Type de données : nombre Table/champ mis à jour : sn_ind_tmt_orm_order/quantité Par défaut : chaîne vide | | ArticleCommandeProduit.OpérationRévision | Type de mise à jour à effectuer sur l'élément de ligne. Si cette valeur est vide, l'élément de ligne existant est mis à jour ou un nouvel élément de ligne est ajouté s'il n'existe pas déjà. Si cette valeur est définie sur Annuler, l'élément de ligne est annulé. Type de données : chaîne Par défaut : chaîne vide | | productOrderItem.@type | Fait partie de la norme TMF Open API. Annotation pour le produit. Cette valeur est toujours ProductOrderItem. Ces informations ne sont pas stockées. Type de données : chaîne | | relatedParty | Liste des contacts de la commande. Chaque contact est un objet dans le tableau. Doit énumérer au moins un élément qui contient des informations sur le compte client ou le compte de consommateur. Type de données : tableau{#tmf_prod_order-PATCH-productorder-id__relatedParty_data_type-p-tmf622} "relatedParty": [ { "id": "String", "name": "String", "@referredType": "String", "@type": "String" } ] {#tmf_prod_order-PATCH-productorder-id__relatedParty-codeblock-tmf622} | | relatedParty.id | Sys_id ou external_id du compte, du contact client ou du consommateur associé à la commande. Situé dans la table Compte \[customer_account\], Contact \[customer_contact\] ou Consommateur \[csm_consumer\]. Type de données : chaîne | | relatedParty.name | Nom du compte, du client ou du consommateur. Type de données : chaîne | | relatedParty.@referredType | Type de client. Valeurs possibles : * Consommateur * Client * Contact du client {#tmf_prod_order-PATCH-productorder-id__ul_lcq_jwm_t4b} Type de données : chaîne | | relatedParty.@type | Fait partie de la norme TMF Open API. Annotation pour le produit. Cette valeur est toujours RelatedParty. Ces informations ne sont pas stockées. Type de données : chaîne | | requestedCompletionDate | Date de livraison demandée par le client. Type de données : chaîne{#tmf_prod_order-PATCH-productorder-id__reqCompDate_data_type-p-tmf622} Table/champ mis à jour : sn_ind_tmt_orm_order/expected_end_date Par défaut : chaîne vide | | Date de début demandée | Date de début de commande demandée par le client. Type de données : chaîne{#tmf_prod_order-PATCH-productorder-id__reqStartDate_data_type-p-tmf622} Table/champ mis à jour : sn_ind_tmt_orm_order/expected_start_date Par défaut : chaîne vide | | @type | Fait partie de la norme TMF Open API. Annotation pour le produit. Cette valeur est toujours ProductOrder. Ces informations ne sont pas stockées. Type de données : chaîne | [Tableau 33. Paramètres du corps de la demande (JSON)] {#tmf_prod_order-PATCH-productorder-id__id_vk2_p5n_t4b} ### En-têtes Les en-têtes de demande et de réponse suivants s'appliquent à cette action HTTP uniquement ou s'appliquent à cette action d'une manière distincte. Pour obtenir la liste des en-têtes généraux utilisés dans l'API REST, consultez [En-têtes d'API REST pris en charge](https://servicenow-prod.fluidtopics.net/CFQa7z9NIrhoOq1u1cRN7g "REST (REpresentational State Transfer) est une architecture simple sans état qui fournit des normes entre les systèmes informatiques sur le Web, ce qui leur permet de communiquer plus facilement les uns avec les autres."). {#tmf_prod_order-PATCH-productorder-id__table_omb_dvk_5rb__entry__2}{#tmf_prod_order-PATCH-productorder-id__accept-JSON-only-entry-RESTAPI}{#tmf_prod_order-PATCH-productorder-id__content_type-JSON-only-entry-RESTAPI} | En-tête | Description | |-|-| | Accepter | Format de données du corps de la réponse. Prend uniquement en charge application/json. | | Content-Type | Format de données du corps de la demande. Prend uniquement en charge application/json. | [Tableau 34. En-têtes de demandes] {#tmf_prod_order-PATCH-productorder-id__table_omb_dvk_5rb} {#tmf_prod_order-PATCH-productorder-id__table_tzy_thy_ksb__entry__2} | En-tête | Description | |-|-| | Type de contenu | Format de données du corps de la réponse. Ne prend en charge application/jsonque les fichiers . | [Tableau 35. En-têtes de réponses] {#tmf_prod_order-PATCH-productorder-id__table_tzy_thy_ksb} ### Codes d'état Les codes d'état suivants s'appliquent à cette action HTTP. Pour obtenir la liste des codes d'état possibles utilisés dans l'API REST, consultez [Codes de réponse HTTP de l'API REST](https://servicenow-prod.fluidtopics.net/CFQa7z9NIrhoOq1u1cRN7g "REST (REpresentational State Transfer) est une architecture simple sans état qui fournit des normes entre les systèmes informatiques sur le Web, ce qui leur permet de communiquer plus facilement les uns avec les autres."). {#tmf_prod_order-PATCH-productorder-id__table_xfv_2vk_5rb__entry__2} | Code d'état | Description | |-|-| | 201 | Réussi. En cas de problèmes avec les caractéristiques ou les informations d'option des caractéristiques, le point de terminaison stocke les commentaires suivants dans les champs de notes de travail de l'enregistrement d'élément de ligne de commande client associé : * Les caractéristiques de l'élément de commande suivantes n'existent pas : Examinez la spécification \ et corrigez la caractéristique et l'option de caractéristique dans l'élément de ligne de commande avant d'approuver la commande. * Caractéristique de l'élément de commande : \ avec la valeur caractéristique : \n'est pas valide. Corrigez les valeurs caractéristiques avant d'approuver la commande. {#tmf_prod_order-PATCH-productorder-id__ul_xtx_xym_t4b} | | 400 | Demande incorrecte. L'une des raisons suivantes peut être l'une des suivantes : * Charge utile non valide : corps de la demande manquant : la charge utile n'a pas été transmise dans le corps de la demande. * Charge utile non valide : productOrderItem est manquant : l'objet de l'élément de ligne de commande de produit ou JSON est manquant. * Charge utile non valide : l'ID de productOrderItem est manquant : le id paramètre est manquant dans l'élément de ligne de commande de produit de la charge utile. * Charge utile non valide : l'action productOrderItem est manquante : le action paramètre est manquant dans l'élément de ligne de commande de produit de la charge utile. * Charge utile non valide : productOrderItem productOffering est manquant : l'objet ou JSON de l'offre de produit est manquant dans l'élément de ligne de commande de produit dans la charge utile. * Charge utile non valide : l'ID productOffering est manquant : le id paramètre est manquant dans l'élément de ligne de commande de produit de l'objet d'offre de produit dans la charge utile. * Charge utile non valide : l'offre de produit n'existe pas : l'offre de produit dans l'élément de ligne de commande de produit n'est pas valide. * Charge utile non valide : productOrderItem produit manquant : l'objet produit ou JSON dans l'élément de ligne de commande de produit est manquant dans la charge utile. * Charge utile non valide : product productSpecification est manquant : l'objet de spécification du produit ou le JSON dans l'élément de ligne de commande de produit est manquant dans la charge utile. * Charge utile non valide : l'ID de spécification de produit est manquant : le id paramètre de l'élément de ligne de commande de produit de l'objet de spécification de produit est manquant dans la charge utile. * Charge utile non valide : la spécification du produit n'existe pas : la spécification du produit dans l'élément de ligne de commande de produit n'est pas valide. * Charge utile non valide : l'inventaire de produits n'existe pas : dans un ordre de changement (action = changement), la quantité d'un élément est supérieure à ce qui est en stock. * Charge utile non valide : l'ID d'inventaire de produits est manquant : dans un ordre de changement, le product.id est manquant dans la charge utile. * Charge utile non valide : produit vendu est inactif : dans un ordre de changement, un produit spécifié dans la charge utile est inactif. * Charge utile non valide : relatedParty est manquant : l'objet de la partie associée est manquant dans la charge utile. * Charge utile non valide : compte client ou consommateur manquant : le client tiers connexe ou l'objet consommateur est manquant dans la charge utile. * Charge utile non valide : Le consommateur n'existe pas : le consommateur tiers associé spécifié n'existe pas dans l'instance ServiceNow . * Charge utile non valide : Le compte client n'existe pas : le client tiers associé spécifié n'existe pas dans l'instance ServiceNow . * Charge utile non valide : Échec de la création de la commande : impossible de créer la commande demandée. * Charge utile non valide : cette commande doit encore être créée dans la table de commande du client. Veuillez vérifier dans la file d'attente entrante pour plus de détails. - La demande de correctif a été effectuée pour une commande qui n'est pas encore dans la table de commande du client. La commande se trouve dans la table File d'attente entrante \[sn_tmt_core_inbound_queue\] en attente que le planificateur choisisse l'enregistrement à traiter. * Charge utile non valide : la demande de correctif ne peut pas être effectuée car le type d'exécution de la commande n'est pas \<\< livrer \>\>. - La demande de correctif a été effectuée pour une commande dont le type d'exécution est différent deliver. {#tmf_prod_order-PATCH-productorder-id__ul_g2v_rzm_t4b} | [Tableau 36. Codes d'état] {#tmf_prod_order-PATCH-productorder-id__table_xfv_2vk_5rb} ### Paramètres de corps de réponse (JSON) {#tmf_prod_order-PATCH-productorder-id__section_b1v_xpk_5rb} {#tmf_prod_order-PATCH-productorder-id__table_c1v_xpk_5rb__entry__2} | Nom | Description | |-|-| | canal | Tableau d'objets qui décrivent les canaux à utiliser pour vendre les produits. Type de données : tableau "channel": [ { "id": "String", "name": "String" } ] | | channel.id | Identificateur unique du canal à utiliser pour vendre les produits associés. Les valeurs d'ID de canal se trouvent dans le champ external_id de la table Canal de distribution \[sn_prd_pm_distribution_channel\]. Type de données : chaîne | | channel.name | Nom du canal à utiliser pour vendre les produits associés. Type de données : chaîne | | id | Sys_id de la commande client mis à jour pour cette demande. Type de données : chaîne | | externalId | Identificateur externe de la commande client, tel qu'un numéro de bon de commande. Type de données : chaîne | | note | Tableau d'objets qui décrivent les notes supplémentaires prises par le client lors de la commande. Type de données : tableau "note": [ { "text": "String" } ] | | note.texte | Remarques/commentaires supplémentaires formulés par le client lors de la commande. Type de données : chaîne | | Élément de commande produit | Liste décrivant les éléments associés à la commande de produit et leur action associée. Type de données : tableau "productOrderItem:" [ { "action": "String", "actionReason": "String", "id": "String", "itemPrice": [Array], "product": {Object}, "productOffering": {Object}, "productOrderItemReleationship": [Array], "quantity": Number, "state": "String", "@type": "String" } ] | | productOrderItem.action | Action à effectuer sur le produit. Les actions possibles sont définies dans l'onglet Liste de choix de l'entrée du dictionnaire d'actions de la table sn_ind_tmt_orm_order_line_item. Type de données : chaîne | | Élément de commandeproduit.actionReason | Motif de l'ajout de l'élément de ligne de commande. Type de données : chaîne Table/champ mis à jour : sn_ind_tmt_orm_order_line_item/action_reason | | productOrderItem.id | Identificateur unique de l'élément de ligne. Situé dans le champ sn_ind_tmt_orm_external_id de la table Élément de ligne de commande \[sn_ind_tmt_orm_order_line_item\]. Type de données : chaîne | | productOrderItem.itemPrice | Tableau d'objets décrivant le prix associé au produit. Type de données : tableau "itemPrice": [ { "price": {Object}, "priceType": "String", "recurringChargePeriod": "String" } ] | | productOrderItem.itemPrice.price | Description du prix du produit associé. Type de données : objet "price": { "taxIncludedAmount": {Object} } | | productOrderItem.itemPrice.price.taxIncludeAmount | Description du prix du produit associé, taxes comprises. Type de données : objet "taxIncludedAmount": { "unit": "String", "value": Number } | | productOrderItem.itemPrice.price.taxIncludeAmount.unit | Code de devise dans lequel le prix est représenté. Type de données : chaîne | | productOrderItem.itemPrice.price.taxIncludeAmount.value | Prix du produit, toutes taxes comprises. Type de données : nombre | | productOrderItem.itemPrice.priceType | Type de prix de l'article, récurrent ou non récurrent. Type de données : chaîne | | productOrderItem.itemPrice.recurringChargePeriod | Si le prix est récurrent, la période récurrente, par exemple le mois. Type de données : chaîne | | productOrderItem.product | Description des détails de l'instance du produit acheté par le client. Type de données : objet "product": { "id": "String", "place": {Object}, "productCharacteristic": [Array], "productSpecification": {Object}, "relatedParty": {Object}, "@type": "String" } | | productOrderItem.product.id | Identificateur unique du produit vendu. Situé dans le champ sys_id ou sn_ind_tmt_orm_external_id de la table Inventaire des produits \[sn_ind_tmt_orm_product_inventory\]. Type de données : chaîne | | productOrderItem.product.place | Cartes des emplacements sur lesquels installer le produit. Type de données : objet "place": { "id": "String", "@type": "String" } | | productOrderItem.product.place.id | Sys_id de l'enregistrement de l'emplacement associé dans la table Emplacement \[cmn_location\]. Type de données : chaîne | | productOrderItem.product.productCharacteristic | Tableau d'objets décrivant les caractéristiques du produit associé. Type de données : tableau "productCharacteristic": [ { "name": "String", "previousValue": "String", "value": "String" } ] | | productOrderItem.product.productCharacteristic.name | Nom de l'enregistrement de la caractéristique à associer au produit. Situé dans la table Caractéristique \[sn_prd_pm_characteristic\]. Type de données : chaîne | | productOrderItem.product.productCharacteristic.previousValue | Valeurs d'option de caractéristique précédentes si la mise à jour concerne un ordre de changement. La demande est un ordre de changement si le paramètre est autre que ajouterproductOrderItem.action. Pour plus d'informations sur les valeurs des options de caractéristique, reportez-vous à la section [Create product characteristics and characteristic options](https://www.servicenow.com/docs/access?context=som-product-config-add-characteristics&version=xanadu&pubname=xanadu-order-management&ft:locale=en-US). Type de données : chaîne | | productOrderItem.product.productCharacteristic.value | Valeurs d'option de caractéristique associées au produit. Pour plus d'informations sur les valeurs des options de caractéristique, reportez-vous à la section [Create product characteristics and characteristic options](https://www.servicenow.com/docs/access?context=som-product-config-add-characteristics&version=xanadu&pubname=xanadu-order-management&ft:locale=en-US). Type de données : chaîne | | productOrderItem.product.productSpecification | Description de la spécification du produit associée au produit. Type de données : objet "productSpecification": { "id": "String", "internalVersion": "String", "name": "String", "version": "String", "@type": "String" } | | productOrderItem.product.productSpecification.id | Initial_version ou external_id des spécifications du produit. Le initial_version est le sys_id de la première version de la spécification. Situé dans le champ sys_id ou external_id de la table Spécification de produit \[sn_prd_pm_product_specification\]. Type de données : chaîne | | productOrderItem.product.productSpecification.name | Nom de la spécification de produit. Situé dans la table Spécification de produit \[sn_prd_pm_product_specification\]. Type de données : chaîne | | productOrderItem.product.productSpecification.@type | Fait partie de la norme TMF Open API. Cette valeur est toujours ProductSpecificationRef. Ces informations ne sont pas stockées. Type de données : chaîne | | élémentcommandeproduit.produit.relatedparty | Liste des contacts pour les éléments de ligne. Type de données : tableau "relatedParty": [ { "email": "String", "firstName": "String", "id": "String", "lastName": "String", "phone": "String", "@referredType": "String", "@type": "String" } ] | | productOrderItem.product.relatedParty.email | Adresse e-mail du contact. Type de données : chaîne | | productOrderItem.product.relatedParty.firstName | Prénom de la personne à contacter. Type de données : chaîne | | productOrderItem.product.relatedParty.id | Sys_id du contact de l'élément de ligne associé à l'élément de ligne de commande. Situé dans la table Contact de l'élément de ligne de commande \[sn_ind_tmt_orm_order_line_item_contact\]. Type de données : chaîne | | productOrderItem.product.relatedParty.lastName | Nom de famille du contact. Type de données : chaîne Type de données : chaîne | | productOrderItem.product.relatedParty.phone | Numéro de téléphone professionnel du contact. Type de données : chaîne | | productOrderItem.product.relatedParty.@referredType | Type de client. Valeur possible : OrderLineItemContact Type de données : chaîne | | productOrderItem.product.relatedParty.@type | Fait partie de la norme TMF Open API. Annotation pour le contact de l'élément de ligne de commande. Cette valeur est toujours RelatedParty. Ces informations ne sont pas stockées. Type de données : chaîne | | productOrderItem.product.@type | Fait partie de la norme TMF Open API. Annotation pour le produit. Cette valeur est toujours Produit. Ces informations ne sont pas stockées. Type de données : chaîne | | productOrderItem.productOffering | Description de l'offre de produit associée au produit. Type de données : objet "productOffering": { "id": "String", "internalVersion": "String", "name": "String", "version": "String" } | | productOrderItem.productOffering.id | Initial_version ou external_id de l'offre de produits. Le initial_version est le sys_id de la première version de l'offre. Situé dans le champ sys_id ou external_id de la table Offre de produits \[sn_prd_pm_product_offering\]. Type de données : chaîne | | productOrderItem.productOffering.name | Nom de l'offre de produits. Situé dans la table Offre de produits \[sn_prd_pm_product_offering\]. Type de données : chaîne | | productOrderItem.productOrderItemRelationship | Tableau d'objets décrivant les relations entre les éléments de ligne de commande. Type de données : tableau "productOrderItemRelationship": [ { "id": "String", "relationshipType": "String" } ] | | productOrderItem.productOrderItemRelationship.id | Identificateur unique de l'élément de ligne connexe. Situé dans le champ sn_ind_tmt_orm_external_id de la table Élément de ligne de commande \[sn_ind_tmt_orm_order_line_item\]. Type de données : chaîne | | productOrderItem.productOrderItemRelationship.relationshipType | Type de relation entre les deux éléments de ligne. Ces informations sont utilisées pour identifier la hiérarchie des relations. Type de données : chaîne | | productOrderItem.quantity | Nombre des éléments associés à commander. Type de données : nombre | | élémentcommandeproduit.état | État actuel de l'élément de commande de produit. Type de données : chaîne | | productOrderItem.@type | Fait partie de la norme TMF Open API. Annotation pour le produit. Cette valeur est toujours ProductOrderItem. Ces informations ne sont pas stockées. Type de données : chaîne | | relatedParty | Liste des contacts de la commande. Chaque contact est un objet dans le tableau. Doit énumérer au moins un élément qui contient des informations sur le compte client ou le compte de consommateur. Type de données : tableau "relatedParty": [ { "id": "String", "name": "String", "@referredType": "String", "@type": "String" } ] | | relatedParty.id | Sys_id ou external_id du compte, du contact client ou du consommateur associé à la commande. Situé dans la table Compte \[customer_account\], Contact \[customer_contact\] ou Consommateur \[csm_consumer\]. Type de données : chaîne | | relatedParty.name | Nom du compte, du client ou du consommateur. Type de données : chaîne | | relatedParty.type | Type de client. Valeurs possibles : * Consommateur * Client * Contact du client {#tmf_prod_order-PATCH-productorder-id__d2876e2460} Type de données : chaîne | | requestedCompletionDate | Date de livraison demandée par le client. Type de données : chaîne | | Date de début demandée | Date de début de commande demandée par le client. Type de données : chaîne | | État | État actuel de la commande. Type de données : chaîne | | @type | Fait partie de la norme TMF Open API. Annotation pour le produit. Cette valeur est toujours ProductOrder. Ces informations ne sont pas stockées. Type de données : chaîne | [ ] {#tmf_prod_order-PATCH-productorder-id__table_c1v_xpk_5rb} ### Demande cURL {#tmf_prod_order-PATCH-productorder-id__example_jsc_1dc_vrb} L'exemple de code suivant met à jour le canal pour une commande client. curl -X PATCH "https://instance.servicenow.com/api/sn_ind_tmt_orm/productorder/6be0a925c3a220103e2e73ce3640ddfe" \ -H "Accept: application/json" \ -H "Content-Type: application/json" \ -u "username":"password" \ -d { "channel": [ { "id": "1", "name": "Agent Assist" } ] } Corps de réponse. { "requestedCompletionDate": "2021-05-02T08:13:59.506Z", "requestedStartDate": "2020-05-03T08:13:59.506Z", "externalId": "PO-456", "channel": [ { "id": "1", "name": "Agent Assist" } ], "note": [ { "text": "This is a TMF product order illustration" }, { "text": "This is a TMF product order illustration no 2" } ], "productOrderItem": [ { "id": "POI100", "quantity": 1, "action": "change", "actionReason":"adding service package OLI", "product": { "id": "fa6d13f45b5620102dff5e92dc81c77f", "@type": "Product", "productSpecification": { "id": "cfe5ef6a53702010cd6dddeeff7b12f6", "name": "SD-WAN Service Package", "@type": "ProductSpecificationRef" }, "place": { "id": "25ab9c4d0a0a0bb300f7dabdc0ca7c1c", "@type": "Place" } }, "productOffering": { "id": "69017a0f536520103b6bddeeff7b127d", "name": "Premium SD-WAN Offering" }, "productOrderItemRelationship": [ { "id": "POI120", "relationshipType": "HasChild" }, { "id": "POI130", "relationshipType": "HasChild" } ], "@type": "ProductOrderItem", "state": "new" }, { "id": "POI120", "quantity": 1, "action": "change", "actionReason":"adding service package OLI", "itemPrice": [ { "priceType": "recurring", "recurringChargePeriod": "month", "price": { "taxIncludedAmount": { "unit": "USD", "value": 20 } } } ], "product": { "id": "766d13f45b5620102dff5e92dc81c78a", "@type": "Product", "productCharacteristic": [ { "name": "WAN Optimization", "value": "Base", "previousValue": "Advance" } ], "productSpecification": { "id": "39b627aa53702010cd6dddeeff7b1202", "name": "SD-WAN Edge Device", "@type": "ProductSpecificationRef" }, "relatedParty": [ { "id": "51670151c35420105252716b7d40ddfe", "firstName": "Joe", "lastName": "Doe", "email": "abc@example.com", "phone": "1234567890", "@type": "RelatedParty", "@referredType": "OrderLineItemContact" } ], "place": { "id": "25ab9c4d0a0a0bb300f7dabdc0ca7c1c", "@type": "Place" } }, "productOffering": { "id": "69017a0f536520103b6bddeeff7b127d", "name": "Premium SD-WAN Offering" }, "productOrderItemRelationship": [ { "id": "POI100", "relationshipType": "HasParent" } ], "@type": "ProductOrderItem", "state": "new" }, { "id": "POI130", "quantity": 1, "action": "add", "actionReason":"adding service package OLI", "itemPrice": [ { "priceType": "recurring", "recurringChargePeriod": "month", "price": { "taxIncludedAmount": { "unit": "USD", "value": 20 } } } ], "product": { "@type": "Product", "productCharacteristic": [ { "name": "Security Type", "value": "Base", "previousValue": "Advance" } ], "productSpecification": { "id": "a6514bd3534560102f18ddeeff7b1247", "name": "SD-WAN Security", "@type": "ProductSpecificationRef" }, "relatedParty": [ { "id": "51670151c35420105252716b7d40ddfe", "firstName": "Joe", "lastName": "Doe", "email": "abc@example.com", "phone": "1234567890", "@type": "RelatedParty", "@referredType": "OrderLineItemContact" } ], "place": { "id": "25ab9c4d0a0a0bb300f7dabdc0ca7c1c", "@type": "Place" } }, "productOffering": { "id": "69017a0f536520103b6bddeeff7b127d", "name": "Premium SD-WAN Offering" }, "productOrderItemRelationship": [ { "id": "POI100", "relationshipType": "HasParent" } ], "@type": "ProductOrderItem", "state": "new" } ], "relatedParty": [ { "id": "eaf68911c35420105252716b7d40ddde", "name": "Sally Thomas", "@type": "RelatedParty", "@referredType": "CustomerContact" }, { "id": "ffc68911c35420105252716b7d40dd55", "name": "Funco Intl", "@type": "RelatedParty", "@referredType": "Customer" }, { "id": "59f16de1c3b67110ff00ed23a140dd9e", "name": "Funco External", "@type": "RelatedParty", "@referredType": "Consumer" } ], "@type": "ProductOrder", "id": "6be0a925c3a220103e2e73ce3640ddfe", "state": "in_progress" } ## Commande de produit API ouverte : POST /sn_ind_tmt_orm/cancelproductorder {#ariaid-title8} Annule la commande du client spécifiée. ### Format d'URL URL par défaut : /api/sn_ind_tmt_orm/cancelproductorder ### Paramètres de demande pris en charge {#tmf_prod_order-POST-cancelproductorder__entry__2} | Nom | Description | |-|-| | Aucun | | [Tableau 37. Paramètres de chemin d'accès] {#tmf_prod_order-POST-cancelproductorder__entry__6} | Nom | Description | |-|-| | Aucun | | [Tableau 38. Paramètres de requête] {#tmf_prod_order-POST-cancelproductorder__entry__10} | Nom | Description | |-|-| | Motif d'annulation | Motif de l'annulation. Type de données : chaîne Par défaut : chaîne vide | | Commande de produit | Contient des données sur la commande de produit. Type de données : objet "productOrder": { "id": "String", "href": "String", "@referredType": "String" } | | productOrder.id | Requis. Sys_id de la commande du client à annuler. Situé dans la table Commande client \[sn_ind_tmt_orm_order\]. Type de données : chaîne | | commandeproduit.href | URL de l'ordre client à annuler. Type de données : chaîne Par défaut : chaîne vide | | productOrder.@referredType | La valeur de ce paramètre doit être `ProductOrder`. Type de données : chaîne Par défaut : chaîne vide | | requestedCancellationDate | Date d'annulation de la commande. Type de données : chaîne Par défaut : chaîne vide | | @type | La valeur de ce paramètre doit être `CancelProductOrder`. Type de données : chaîne Par défaut : chaîne vide | [Tableau 39. Paramètres du corps de la demande (JSON)] ### En-têtes Les en-têtes de demande et de réponse suivants s'appliquent à cette action HTTP uniquement ou s'appliquent à cette action d'une manière distincte. Pour obtenir la liste des en-têtes généraux utilisés dans l'API REST, consultez [En-têtes d'API REST pris en charge](https://servicenow-prod.fluidtopics.net/CFQa7z9NIrhoOq1u1cRN7g "REST (REpresentational State Transfer) est une architecture simple sans état qui fournit des normes entre les systèmes informatiques sur le Web, ce qui leur permet de communiquer plus facilement les uns avec les autres."). {#tmf_prod_order-POST-cancelproductorder__table_omb_dvk_5rb__entry__2}{#tmf_prod_order-POST-cancelproductorder__accept-JSON-only-entry-RESTAPI}{#tmf_prod_order-POST-cancelproductorder__content_type-JSON-only-entry-RESTAPI} | En-tête | Description | |-|-| | Accepter | Format de données du corps de la réponse. Prend uniquement en charge application/json. | | Content-Type | Format de données du corps de la demande. Prend uniquement en charge application/json. | [Tableau 40. En-têtes de demandes] {#tmf_prod_order-POST-cancelproductorder__table_omb_dvk_5rb} {#tmf_prod_order-POST-cancelproductorder__table_tzy_thy_ksb__entry__2} | En-tête | Description | |-|-| | Type de contenu | Format de données du corps de la réponse. Ne prend en charge application/jsonque les fichiers . | [Tableau 41. En-têtes de réponses] {#tmf_prod_order-POST-cancelproductorder__table_tzy_thy_ksb} ### Codes d'état Les codes d'état suivants s'appliquent à cette action HTTP. Pour obtenir la liste des codes d'état possibles utilisés dans l'API REST, consultez [Codes de réponse HTTP de l'API REST](https://servicenow-prod.fluidtopics.net/CFQa7z9NIrhoOq1u1cRN7g "REST (REpresentational State Transfer) est une architecture simple sans état qui fournit des normes entre les systèmes informatiques sur le Web, ce qui leur permet de communiquer plus facilement les uns avec les autres."). {#tmf_prod_order-POST-cancelproductorder__entry__36} | Code d'état | Description | |-|-| | 200 | Réussi. La demande a été correctement traitée. | | 400 | Demande incorrecte. L'une des raisons suivantes peut être l'une des suivantes : * Charge utile vide. * Charge utile non valide. Champ obligatoire manquant : \. * ID de commande non valide. * ID de commande non valide : cette commande n'a pas encore été créée dans la table de commande client. La demande d'annulation a été effectuée pour une commande qui n'a pas encore été créée. La commande se trouve dans la table File d'attente entrante \[sn_tmt_core_inbound_queue\] en attente que le planificateur récupère l'enregistrement. {#tmf_prod_order-POST-cancelproductorder__ul_lg1_5vt_5rb} | [Tableau 42. Codes d'état] ### Paramètres de corps de réponse (JSON) {#tmf_prod_order-POST-cancelproductorder__entry__42} | Nom | Description | |-|-| | Motif d'annulation | Motif de l'annulation. Type de données : chaîne | | href | URL de la commande annulée. Type de données : chaîne | | id | Sys_id de la commande annulée. Type de données : chaîne | | Commande de produit | Contient des données sur la commande de produit. Type de données : objet "productOrder": { "id": "String", "href": "String", "@referredType": "String" } | | productOrder.id | Sys_id de la commande annulée. Type de données : chaîne | | commandeproduit.href | URL de la commande annulée. Type de données : chaîne | | productOrder.@referredType | La valeur de ce paramètre est `ProductOrder`. Type de données : chaîne | | requestedCancellationDate | Date d'annulation de la commande. Type de données : chaîne | | État | État de l'annulation. Si la demande d'annulation a été traitée avec succès (code d'état 201), la valeur de ce paramètre est `définie`. Type de données : chaîne | | @type | La valeur de ce paramètre est `CancelProductOrder`. Type de données : chaîne | [ ] ### Demande cURL L'exemple de code suivant annule la commande d'un client. curl -X POST "https://instance.servicenow.com/api/sn_ind_tmt_orm/cancelproductorder" \ -H "Accept: application/json" \ -H "Content-Type: application/json" \ -u "username":"password" \ -d { "cancellationReason": "Duplicate order", "requestedCancellationDate": "2019-04-30T12:56:21.931Z", "productOrder": { "id": "163ee2805358811032a4ddeeff7b122d", "href": "https://instance.servicenow.com/productOrderingManagement/v4/productOrder/64a9607feb45301032a442871352285b", "@referredType": "ProductOrder" }, "@type": "CancelProductorder" } { "id": "163ee2805358811032a4ddeeff7b122d", "href": "https://instance.servicenow.com/productOrderingManagement/v4/productOrder/64a9607feb45301032a442871352285b", "cancellationReason": "Duplicate order", "requestedCancellationDate": "2019-04-30T12:56:21.931Z", "@type": "CancelProductorder", "productOrder": { "id": "163ee2805358811032a4ddeeff7b122d", "href": "https://instance.servicenow.com/productOrderingManagement/v4/productOrder/64a9607feb45301032a442871352285b", "@referredType": "ProductOrder" }, "state": "done" } ## API ouverte pour la commande de produit : POST /sn_ind_tmt_orm/order/productOrder {#ariaid-title9} Crée la commande client et les éléments de ligne de commande client spécifiés. Une fois traités, les enregistrements sont créés dans les tables suivantes : * Commande de clients \[sn_ind_tmt_orm_order\] * Caractéristique de commande \[sn_ind_tmt_orm_order_characteristic_value\] * Élément de ligne de commande \[sn_ind_tmt_orm_order_line_item\] * Contact de l'élément de ligne de commande \[sn_ind_tmt_orm_order_line_item_contact\] * Éléments de ligne de commande connexes \[sn_ind_tmt_orm_order_line_related_items\] {#tmf_prod_order-POST-ord-productOrder__ul_hxq_vdb_hqb} ### Format d'URL URL par défaut : /api/sn_ind_tmt_orm/order/productOrder ### Paramètres de demande pris en charge {#tmf_prod_order-POST-ord-productOrder__entry__2} | Nom | Description | |-|-| | Aucun | | [Tableau 43. Paramètres de chemin d'accès] {#tmf_prod_order-POST-ord-productOrder__entry__6} | Nom | Description | |-|-| | Mode | Active le traitement asynchrone des commandes. En d'autres termes, la commande est ajoutée à la table File d'attente entrante \[sn_tmt_core_inbound_queue\] à créer. Si elle n'est pas incluse, la commande est traitée de manière synchrone. Valeur possible : asynchrone Type de données : chaîne | [Tableau 44. Paramètres de requête] {#tmf_prod_order-POST-ord-productOrder__id_vk2_p5n_t4b__entry__2}{#tmf_prod_order-POST-ord-productOrder__due-date-entry}{#tmf_prod_order-POST-ord-productOrder__productOrder-href-request}{#tmf_prod_order-POST-ord-productOrder__productOrder-addReason-request}{#tmf_prod_order-POST-ord-productOrder__due-date-item-entry}{#tmf_prod_order-POST-ord-productOrder__externalProductInventory-GET-desc-request}{#tmf_prod_order-POST-ord-productOrder__externalProductInventoryId-desc} | Nom | Description | |-|-| | canal | Tableau d'objets qui décrivent les canaux à utiliser pour vendre les produits. Type de données : tableau "channel": [ { "id": "String", "name": "String" } ] Table/champ mis à jour : sn_ind_tmt_orm_order | | channel.id | Requis. Identificateur unique du canal à utiliser pour vendre les produits associés. Les valeurs d'ID de canal se trouvent dans le champ external_id de la table Canal de distribution \[sn_prd_pm_distribution_channel\]. Type de données : chaîne Table/champ mis à jour : sn_ind_tmt_orm_order/canal Par défaut : chaîne vide | | channel.name | Nom du canal à utiliser pour vendre les produits associés. Les noms de canaux possibles sont définis dans l'onglet Liste de choix de l'entrée du dictionnaire des canaux de la table sn_ind_tmt_orm_order. Type de données : chaîne Par défaut : chaîne vide | | committedDueDate | Date et heure auxquelles l'action doit être effectuée sur la commande. Cette valeur doit être identique ou ultérieure aux valeurs de committedDueDate chaque élément de ligne de commande. Type de données : chaîne Table/champ mis à jour : sn_ind_tmt_orm_order/committed_due_date | | externalId | Identificateur unique de la commande du client. Cette valeur est déterminée par un système externe. Type de données : chaîne Table/champ mis à jour : sn_ind_tmt_orm_order/external_id Par défaut : chaîne vide | | href | Un lien relatif vers l'enregistrement de ressource. Type de données : chaîne Par défaut : chaîne vide | | note | Tableau d'objets contenant des notes supplémentaires prises par le client lors de la commande. Type de données : tableau "note": [ { "text": "String" } ] Table/champ mis à jour : sn_ind_tmt_orm_order | | note.texte | Requis. Remarques/commentaires supplémentaires formulés par le client lors de la commande. Type de données : chaîne Table/champ mis à jour : sn_ind_tmt_orm_order/commentaires Par défaut : chaîne vide | | orderCurrency | Requis. Code de devise pour la commande et les éléments de ligne de commande. La devise doit être la même pour tous les éléments de la commande et des éléments de ligne de commande, sinon une erreur est renvoyée et la commande n'est pas créée. Une fois qu'une commande est créée, son code de devise ne peut pas être modifié. Type de données : chaîne | | Élément de commande produit | Requis. Tableau d'objets décrivant les éléments associés à la commande de produit et leur action associée. Type de données : tableau "productOrderItem": [ { "action": "String", "actionReason": "String", "committedDueDate": "String", "externalProductInventory": [Array], "id": "String", "itemPrice": [Array], "product": {Object}, "productOffering": {Object}, "productOrderItemRelationship": [Array], "quantity": Number, "@type": "String" } ] Table/champ mis à jour : sn_ind_tmt_orm_order_line_item | | productOrderItem.action | Requis. Action à effectuer sur le produit. Les actions possibles sont définies dans l'onglet Liste de choix de l'entrée du dictionnaire d'actions de la table sn_ind_tmt_orm_order_line_item. Valeurs possibles : * ajouter * changement * supprimer * Aucun changement * reprendre * suspendre {#tmf_prod_order-POST-ord-productOrder__ul_qbd_dyp_ysb} Type de données : chaîne Table/champ mis à jour : sn_ind_tmt_orm_order_line_item/action | | Élément de commandeproduit.actionReason | Facultatif. Description du motif de l'élément de ligne de commande. Type de données : chaîne Table/champ mis à jour : sn_ind_tmt_orm_order_line_item/action_reason | | productOrderItem.committedDueDate | Date et heure auxquelles l'action doit être effectuée sur l'élément de ligne de commande. Type de données : chaîne Table/champ mis à jour : sn_ind_tmt_orm_order_line_item/committed_due_date | | productOrderItem.externalProductInventory | Tableau d'objets contenant des ID externes à mapper aux inventaires de produits créés pour la commande. Type de données : tableau d'objets "externalProductInventory": [ { "externalProductInventoryId": "String" } ] | | productOrderItem.externalProductInventory.externalProductInventoryId | ID externe à mapper à l'inventaire des produits. Type de données : chaîne Table/champ mis à jour : sn_ind_tmt_orm_order_line_item/external_inventory_id et sn_prd_invt_product_inventory/sn_prd_invt_external_id | | productOrderItem.id | Requis. Identificateur unique de l'élément de ligne. Type de données : chaîne Table/champ mis à jour : sn_ind_tmt_orm_order_line_item/external_id Longueur maximale : 40 Par défaut : chaîne vide | | productOrderItem.itemPrice | Tableau d'objets décrivant le prix associé au produit. Type de données : tableau "itemPrice": [ { "price": {Object}, "priceType": "String", "recurringChargePeriod": "String" } ] Table mise à jour : sn_ind_tmt_orm_order Par défaut : chaîne vide | | productOrderItem.itemPrice.price | Description du prix du produit associé. Type de données : objet "price": { "taxIncludedAmount": {Object} } Table mise à jour : sn_ind_tmt_orm_order_line_item Par défaut : chaîne vide | | productOrderItem.itemPrice.price.taxIncludedAmount | Description du prix du produit associé, taxes comprises. Type de données : objet "taxIncludedAmount": { "unit": "String", "value": Number } Table mise à jour : sn_ind_tmt_orm_order_line_item | | productOrderItem.itemPrice.price.taxIncludedAmount.unit | Code de devise dans lequel le prix est représenté. Type de données : chaîne Table/champ mis à jour : sn_ind_tmt_orm_order_line_item/mrc ou nrc | | productOrderItem.itemPrice.price.taxIncludedAmount.value | Prix du produit, toutes taxes comprises. Type de données : nombre Table/champ mis à jour : sn_ind_tmt_orm_order_line_item/mrc ou nrc | | productOrderItem.itemPrice.priceType | Spécifie si le prix de l'élément est récurrent ou non récurrent. Type de données : chaîne | | productOrderItem.itemPrice.recurringChargePeriod | Si le prix est récurrent, spécifie la période récurrente, par exemple le mois. Type de données : chaîne | | productOrderItem.product | Requis si productOrderItem.action c'est un changement ou une suppression. Description des détails de l'instance du produit acheté par le client. Type de données : objet "product": { "id": "String", "place": {Object}, "productCharacteristic": [Array], "productSpecification": {Object}, "relatedParty": {Object}, "@type": "String" } Table/champ mis à jour : sn_ind_tmt_orm_order_line_item | | productOrderItem.product.id | Requis si productOrderItem.action c'est un changement ou une suppression. Identificateur unique du produit vendu. Situé dans le champ sys_id ou sn_ind_tmt_orm_external_id de la table Inventaire des produits \[sn_ind_tmt_orm_product_inventory\]. Type de données : chaîne Par défaut : chaîne vide | | productOrderItem.product.place | Cartes des emplacements sur lesquels installer le produit. Type de données : objet "place": { "id": "String", "@type": "String" } Table/champ mis à jour : sn_ind_tmt_orm_order_line_item | | productOrderItem.product.place.id | Requis. Sys_id de l'enregistrement de l'emplacement associé dans la table Emplacement \[cmn_location\]. Type de données : chaîne Table/champ mis à jour : sn_ind_tmt_orm_order_line_item/emplacement | | productOrderItem.product.place.@type | Fait partie de la norme TMF Open API. Annotation pour le contact de l'élément de ligne de commande. Cette valeur est toujours Place. Ces informations ne sont pas stockées. Type de données : chaîne | | productOrderItem.product.productCharacteristic | Tableau d'objets décrivant les caractéristiques du produit associé. Type de données : tableau "productCharacteristic": [ { "name": "String", "previousValue": "String", "value": "String" } ] Table/champ mis à jour : sn_ind_tmt_orm_order_characteristic_value | | productOrderItem.product.productCharacteristic.name | Nom de l'enregistrement de la caractéristique à associer au produit. Situé dans la table Caractéristique \[sn_prd_pm_characteristic\]. Type de données : chaîne Table/champ mis à jour : sn_ind_tmt_orm_order_characteristic_value/caractéristiques Par défaut : chaîne vide | | productOrderItem.product.productCharacteristic.previousValue | Valeurs d'option de caractéristique précédentes si la mise à jour concerne l'ordre de changement. La demande est un ordre de changement si le paramètre est autre que ajouterproductOrderItem.action. Pour plus d'informations sur les valeurs des options de caractéristique, reportez-vous à la section [Create product characteristics and characteristic options](https://www.servicenow.com/docs/access?context=som-product-config-add-characteristics&version=xanadu&pubname=xanadu-order-management&ft:locale=en-US). Type de données : chaîne Table/champ mis à jour : sn_ind_tmt_orm_order_characteristic_value/previous_characteristic_option_value Par défaut : chaîne vide | | productOrderItem.product.productCharacteristic.value | Valeurs d'option de caractéristique associées au produit. Pour plus d'informations sur les valeurs des options de caractéristique, reportez-vous à la section [Create product characteristics and characteristic options](https://www.servicenow.com/docs/access?context=som-product-config-add-characteristics&version=xanadu&pubname=xanadu-order-management&ft:locale=en-US). Type de données : chaîne Table/champ mis à jour : sn_ind_tmt_orm_order_characteristic_value/characteristic_option_value Par défaut : chaîne vide | | productOrderItem.product.productSpecification | Requis. Description de la spécification du produit associée au produit. Remarque : Les ordres de changement (productOrderItem.action est `un changement`) sont traités différemment en fonction de la valeur de la sn_ind_tmt_orm.allowSpecVersionUpdateInChangeOrder propriété système. La valeur de cette propriété système détermine le mode de traitement de la commande si la version de l'inventaire des produits est différente de celle indiquée dans la commande. * Lorsque cette propriété système est définie sur vrai (par défaut), l'inventaire des produits est automatiquement mis à niveau vers la version de la commande en modifiant les spécifications du produit référencé. Cela permet de traiter la commande avec succès. * Lorsque cette propriété système est définie sur faux, si l'inventaire des produits est d'une version différente de celle indiquée dans la commande, la commande échoue en raison d'une incompatibilité de version. {#tmf_prod_order-POST-ord-productOrder__ul_zbw_sdz_dbc} Type de données : objet "productSpecification": { "id": "String", "internalVersion": "String", "name": "String", "version": "String", "@type": "String" } Table/champ mis à jour : sn_ind_tmt_orm_order_line_item | | productOrderItem.product.productSpecification.id | Requis. Initial_version ou external_id des spécifications du produit. Le initial_version est le sys_id de la première version de la spécification. Situé dans le champ sys_id ou external_id de la table Spécification de produit \[sn_prd_pm_product_specification\]. Type de données : chaîne | | productOrderItem.product.productSpecification.internalVersion | Version de la spécification du produit. Situé dans la table Spécification de produit \[sn_prd_pm_product_specification\]. Type de données : chaîne | | productOrderItem.product.productSpecification.name | Nom de la spécification de produit. Situé dans la table Spécification de produit \[sn_prd_pm_product_specification\]. Type de données : chaîne | | productOrderItem.product.productSpecification.version | External_version des spécifications du produit. Situé dans la table Spécification de produit \[sn_prd_pm_product_specification\]. Type de données : chaîne | | productOrderItem.product.productSpecification.@type | Fait partie de la norme TMF Open API. Cette valeur est toujours ProductSpecificationRef. Ces informations ne sont pas stockées. Type de données : chaîne | | élémentcommandeproduit.produit.relatedparty | Tableau d'objets décrivant le rôle de partie lié à un OrderLineItemContact. Type de données : tableau "relatedParty": [ { "email": "String", "firstName": "String", "lastName": "String", "phone": "String", "@referredType": "String", "@type": "String" } ] Table/champ mis à jour : sn_ind_tmt_orm_order_line_item_contact | | productOrderItem.product.relatedParty.email | Adresse e-mail du contact. Type de données : chaîne Table/champ mis à jour : sn_ind_tmt_orm_order_line_item_contact/e-mail Par défaut : chaîne vide | | productOrderItem.product.relatedParty.firstName | Prénom de la personne à contacter. Type de données : chaîne Table/champ mis à jour : sn_ind_tmt_orm_order_line_item_contact/first_name Par défaut : chaîne vide | | productOrderItem.product.relatedParty.lastName | Nom de famille du contact. Type de données : chaîne Table/champ mis à jour : sn_ind_tmt_orm_order_line_item_contact/lastName Par défaut : chaîne vide | | productOrderItem.product.relatedParty.phone | Numéro de téléphone professionnel du contact. Type de données : chaîne Table/champ mis à jour : sn_ind_tmt_orm_order_line_item_contact/business_phone Par défaut : chaîne vide | | productOrderItem.product.relatedParty.@referredType | Requis. Type de client. Valeur possible : OrderLineItemContact Type de données : chaîne | | productOrderItem.product.relatedParty.@type | Fait partie de la norme TMF Open API. Annotation pour le contact de l'élément de ligne de commande. Cette valeur est toujours RelatedParty. Ces informations ne sont pas stockées. Type de données : chaîne | | productOrderItem.product.@type | Fait partie de la norme TMF Open API. Annotation pour le produit. Cette valeur est toujours Produit. Ces informations ne sont pas stockées. Type de données : chaîne | | productOrderItem.productOffering | Requis. Description de l'offre de produit associée au produit. Type de données : objet "productOffering": { "id": "String", "internalVersion": "String", "name": "String", "version": "String" } Table mise à jour : sn_ind_tmt_orm_order_line_item | | productOrderItem.productOffering.id | Requis. Initial_version ou external_id de l'offre de produits. Le initial_version est le sys_id de la première version de l'offre. Situé dans le champ sys_id ou external_id de la table Offre de produits \[sn_prd_pm_product_offering\]. Type de données : chaîne | | productOrderItem.productOffering.internalVersion | Version de l'offre de produit. Situé dans la table Offre de produits \[sn_prd_pm_product_offering\]. Type de données : chaîne | | productOrderItem.productOffering.name | Nom de l'offre de produits. Situé dans la table Offre de produits \[sn_prd_pm_product_offering\]. Type de données : chaîne | | Élément de commandedeproduit.offredeproduit.version | External_version de l'offre de produits. Situé dans la table Offre de produits \[sn_prd_pm_product_offering\]. Type de données : chaîne | | productOrderItem.productOrderItem.quantity | Nombre des éléments associés à commander. Type de données : nombre Table/champ mis à jour : sn_ind_tmt_orm_order/quantité Par défaut : null | | productOrderItem.productOrderItemRelationship | Requis. Tableau d'objets décrivant la relation parent/enfant entre les éléments de commande. Type de données : tableau "productOrderItemRelationship": [ { "id": "String", "relationshipType": "String" } ] Table/champ mis à jour : sn_ind_tmt_orm_order_line_item | | productOrderItem.productOrderItemRelationship.id | Requis. Identique à la productOrderItem.id valeur. Utilisé pour la relation parent/enfant Type de données : chaîne Table/champ mis à jour : sn_ind_tmt_orm_order_line_item/parent_line_item Par défaut : chaîne vide | | productOrderItem.productOrderItemRelationship.relationshipType | Requis. Type de relation entre les deux éléments de ligne. Ces informations sont utilisées pour identifier la hiérarchie des relations. Valeurs possibles : * HasChild (en anglais seulement) * HasParent (en anglais seulement) {#tmf_prod_order-POST-ord-productOrder__ul_rmq_vrk_5rb} Type de données : chaîne | | productOrderItem.quantity | Nombre d'éléments commandés. Type de données : nombre Table/champ mis à jour : sn_ind_tmt_orm_order/quantité Par défaut : chaîne vide | | productOrderItem.@type | Fait partie de la norme TMF Open API. Annotation pour le produit. Cette valeur est toujours ProductOrderItem. Ces informations ne sont pas stockées. Type de données : chaîne | | relatedParty | Liste des contacts de la commande. Chaque contact est un objet dans le tableau. Doit énumérer au moins un élément qui contient des informations sur le compte client ou le compte de consommateur. Type de données : tableau "relatedParty": [ { "id": "String", "name": "String", "@referredType": "String", "@type": "String" } ] | | relatedParty.id | Sys_id ou external_id du compte ou du contact client associé à la commande. Situé dans la table Compte \[customer_account\], Contact \[customer_contact\] ou Consommateur \[csm_consumer\]. Type de données : chaîne | | relatedParty.name | Nom du compte, du client ou du consommateur. Type de données : chaîne | | relatedParty.@referredType | Requis. Type de client. Valeurs possibles : * Consommateur * Client * Contact du client {#tmf_prod_order-POST-ord-productOrder__ul_smq_vrk_5rb} Type de données : chaîne | | relatedParty.@type | Fait partie de la norme TMF Open API. Annotation pour le produit. Cette valeur est toujours RelatedParty. Ces informations ne sont pas stockées. Type de données : chaîne | | requestedCompletionDate | Date de livraison demandée par le client. Type de données : chaîne Table/champ mis à jour : sn_ind_tmt_orm_order/expected_end_date Par défaut : chaîne vide | | Date de début demandée | Date de début de commande demandée par le client. Type de données : chaîne Table/champ mis à jour : sn_ind_tmt_orm_order/expected_start_date Par défaut : chaîne vide | | @type | Fait partie de la norme TMF Open API. Annotation pour le produit. Cette valeur est toujours ProductOrder. Ces informations ne sont pas stockées. Type de données : chaîne | [Tableau 45. Paramètres du corps de la demande (JSON)] {#tmf_prod_order-POST-ord-productOrder__id_vk2_p5n_t4b} ### En-têtes Les en-têtes de demande et de réponse suivants s'appliquent à cette action HTTP uniquement ou s'appliquent à cette action d'une manière distincte. Pour obtenir la liste des en-têtes généraux utilisés dans l'API REST, consultez [En-têtes d'API REST pris en charge](https://servicenow-prod.fluidtopics.net/CFQa7z9NIrhoOq1u1cRN7g "REST (REpresentational State Transfer) est une architecture simple sans état qui fournit des normes entre les systèmes informatiques sur le Web, ce qui leur permet de communiquer plus facilement les uns avec les autres."). {#tmf_prod_order-POST-ord-productOrder__table_omb_dvk_5rb__entry__2}{#tmf_prod_order-POST-ord-productOrder__accept-JSON-only-entry-RESTAPI}{#tmf_prod_order-POST-ord-productOrder__content_type-JSON-only-entry-RESTAPI} | En-tête | Description | |-|-| | Accepter | Format de données du corps de la réponse. Prend uniquement en charge application/json. | | Content-Type | Format de données du corps de la demande. Prend uniquement en charge application/json. | [Tableau 46. En-têtes de demandes] {#tmf_prod_order-POST-ord-productOrder__table_omb_dvk_5rb} {#tmf_prod_order-POST-ord-productOrder__table_tzy_thy_ksb__entry__2} | En-tête | Description | |-|-| | Type de contenu | Format de données du corps de la réponse. Ne prend en charge application/jsonque les fichiers . | [Tableau 47. En-têtes de réponses] {#tmf_prod_order-POST-ord-productOrder__table_tzy_thy_ksb} ### Codes d'état Les codes d'état suivants s'appliquent à cette action HTTP. Pour obtenir la liste des codes d'état possibles utilisés dans l'API REST, consultez [Codes de réponse HTTP de l'API REST](https://servicenow-prod.fluidtopics.net/CFQa7z9NIrhoOq1u1cRN7g "REST (REpresentational State Transfer) est une architecture simple sans état qui fournit des normes entre les systèmes informatiques sur le Web, ce qui leur permet de communiquer plus facilement les uns avec les autres."). {#tmf_prod_order-POST-ord-productOrder__entry__152} | Code d'état | Description | |-|-| | 201 | Réussi. En cas de problèmes avec les caractéristiques ou les informations d'option des caractéristiques, le point de terminaison stocke les commentaires suivants dans les champs de notes de travail de l'enregistrement d'élément de ligne de commande client associé : * Les caractéristiques de l'élément de commande suivantes n'existent pas : Examinez la spécification \ et corrigez la caractéristique et l'option de caractéristique dans l'élément de ligne de commande avant d'approuver la commande. * Caractéristique de l'élément de commande : \ avec la valeur caractéristique : \n'est pas valide. Corrigez les valeurs caractéristiques avant d'approuver la commande. {#tmf_prod_order-POST-ord-productOrder__ul_xtx_xym_t4b} | | 202 | Accepté. Demande réussie d'une commande en mode asynchrone. En d'autres termes, la demande a été effectuée avec le mode paramètre défini sur `asynchrone` et le traitement de l'enregistrement est planifié dans la table File d'attente entrante \[sn_tmt_core_inbound_queue\]. | | 400 | Demande incorrecte. L'une des raisons suivantes peut être l'une des suivantes : * Charge utile non valide : corps de la demande manquant : la charge utile n'a pas été transmise dans le corps de la demande. * Charge utile non valide : productOrderItem est manquant : l'objet de l'élément de ligne de commande de produit ou JSON est manquant. * Charge utile non valide : l'ID de productOrderItem est manquant : le id paramètre est manquant dans l'élément de ligne de commande de produit de la charge utile. * Charge utile non valide : l'action productOrderItem est manquante : le action paramètre est manquant dans l'élément de ligne de commande de produit de la charge utile. * Charge utile non valide : productOrderItem productOffering est manquant : l'objet ou JSON de l'offre de produit est manquant dans l'élément de ligne de commande de produit dans la charge utile. * Charge utile non valide : l'ID productOffering est manquant : le id paramètre est manquant dans l'élément de ligne de commande de produit de l'objet d'offre de produit dans la charge utile. * Charge utile non valide : l'offre de produit n'existe pas : l'offre de produit dans l'élément de ligne de commande de produit n'est pas valide. * Charge utile non valide : productOrderItem produit manquant : l'objet produit ou JSON dans l'élément de ligne de commande de produit est manquant dans la charge utile. * Charge utile non valide : product productSpecification est manquant : l'objet de spécification du produit ou le JSON dans l'élément de ligne de commande de produit est manquant dans la charge utile. * Charge utile non valide : l'ID de spécification de produit est manquant : le id paramètre de l'élément de ligne de commande de produit de l'objet de spécification de produit est manquant dans la charge utile. * Charge utile non valide : la spécification du produit n'existe pas : la spécification du produit dans l'élément de ligne de commande de produit n'est pas valide. * Charge utile non valide : l'inventaire de produits n'existe pas : dans un ordre de changement (action = changement), la quantité d'un élément est supérieure à ce qui est en stock. * Charge utile non valide : ID d'inventaire de produits manquant : dans l'ordre des changements, le product.id est manquant dans la charge utile. * Charge utile non valide : produit vendu est inactif : dans un ordre de changement, un produit spécifié dans la charge utile est inactif. * Charge utile non valide : relatedParty est manquant : l'objet de la partie associée est manquant dans la charge utile. * Charge utile non valide : compte client ou consommateur manquant : le client tiers connexe ou l'objet consommateur est manquant dans la charge utile. * Charge utile non valide : Le consommateur n'existe pas : le consommateur tiers associé spécifié n'existe pas dans l'instance ServiceNow . * Charge utile non valide : Le compte client n'existe pas : le client tiers associé spécifié n'existe pas dans l'instance ServiceNow . * Charge utile non valide : Échec de la création de la commande : impossible de créer la commande demandée. * Charge utile non valide : orderCurrency est requis : le orderCurrency paramètre est manquant dans la charge utile. * Code de devise inactive : \ : la devise fournie est inactive dans l'instance ServiceNow . * Un ou plusieurs éléments de ligne ont un code de devise différent de celui de la devise de la commande : tous les éléments de ligne n'ont pas le même code de devise que la devise de la commande. * Révision en cours de la devise de la commande non prise en charge : le orderCurrency paramètre ne peut pas être mis à jour une fois la commande créée. {#tmf_prod_order-POST-ord-productOrder__ul_g2v_rzm_t4b} | [Tableau 48. Codes d'état] ### Paramètres de corps de réponse (JSON) {#tmf_prod_order-POST-ord-productOrder__entry__160}{#tmf_prod_order-POST-ord-productOrder__externalProdInv-resp-descr}{#tmf_prod_order-POST-ord-productOrder__externalProdInvId-resp-descr} | Nom | Description | |-|-| | canal | Tableau d'objets qui décrivent les canaux à utiliser pour vendre les produits. Type de données : tableau "channel": [ { "id": "String", "name": "String" } ] | | channel.id | Identificateur unique du canal à utiliser pour vendre les produits associés. Les valeurs d'ID de canal se trouvent dans le champ external_id de la table Canal de distribution \[sn_prd_pm_distribution_channel\]. Type de données : chaîne | | channel.name | Nom du canal à utiliser pour vendre les produits associés. Type de données : chaîne | | committedDueDate | Date et heure auxquelles l'action doit être effectuée sur la commande. Cette valeur doit être identique ou ultérieure aux valeurs de committedDueDate chaque élément de ligne de commande. Type de données : chaîne | | externalId | Identificateur externe de la commande client, tel qu'un numéro de bon de commande. Type de données : chaîne | | href | Lien relatif à l'enregistrement de commande de produit. Type de données : chaîne | | id | Sys_id de la commande client créée pour cette demande. Type de données : chaîne | | note | Tableau d'objets qui décrivent les notes supplémentaires prises par le client lors de la commande. Type de données : tableau "note": [ { "text": "String" } ] | | note.texte | Remarques/commentaires supplémentaires formulés par le client lors de la commande. Type de données : chaîne | | orderCurrency | Code de devise pour la commande et les éléments de ligne de commande. Type de données : chaîne | | orderId | Sys_id de la commande à créer. En cas de demande réussie, la commande est ajoutée à la table File d'attente entrante \[sn_tmt_core_inbound_queue\] selon un calendrier à traiter. Remarque : Cette valeur est le seul résultat si la commande est créée de manière asynchrone à l'aide du paramètre de mode requête. { "orderId": "b0fc877ac3ab5110856d73ce3640dde0" } Type de données : chaîne | | Élément de commande produit | Liste décrivant les éléments associés à la commande de produit et leur action associée. Type de données : tableau "productOrderItem:" [ { "action": "String", "committedDueDate": "String", "externalProductInventory": [Array], "id": "String", "itemPrice": [Array], "product": {Object}, "productOffering": {Object}, "productOrderItemReleationship": [Array], "quantity": Number, "state": "String", "@type": "String" } ] | | productOrderItem.action | Action à effectuer sur le produit. Les actions possibles sont définies dans l'onglet Liste de choix de l'entrée du dictionnaire d'actions de la table sn_ind_tmt_orm_order_line_item. Type de données : chaîne | | Élément de commandeproduit.actionReason | Motif de l'ajout de l'élément de ligne de commande. Type de données : chaîne Table/champ mis à jour : sn_ind_tmt_orm_order_line_item/action_reason | | productOrderItem.committedDueDate | Date et heure auxquelles l'action doit être effectuée sur l'élément de ligne de commande. Type de données : chaîne | | productOrderItem.externalProductInventory | Tableau d'objets contenant des ID externes mappés aux inventaires de produits créés pour la commande. Type de données : tableau "externalProductInventory": [ { "externalProductInventoryId": "String" } ] | | productOrderItem.externalProductInventory.externalProductInventoryId | ID externe mappé à l'inventaire des produits. Type de données : chaîne | | productOrderItem.id | Identificateur unique de l'élément de ligne. Situé dans le champ sn_ind_tmt_orm_external_id de la table Élément de ligne de commande \[sn_ind_tmt_orm_order_line_item\]. Type de données : chaîne | | productOrderItem.itemPrice | Tableau d'objets décrivant le prix associé au produit. Type de données : tableau "itemPrice": [ { "price": {Object}, "priceType": "String", "recurringChargePeriod": "String" } ] | | productOrderItem.itemPrice.price | Description du prix du produit associé. Type de données : objet "price": { "taxIncludedAmount": {Object} } | | productOrderItem.itemPrice.price.taxIncludeAmount | Description du prix du produit associé, taxes comprises. Type de données : objet "taxIncludedAmount": { "unit": "String", "value": Number } | | productOrderItem.itemPrice.price.taxIncludeAmount.unit | Code de devise dans lequel le prix est représenté. Type de données : chaîne | | productOrderItem.itemPrice.price.taxIncludeAmount.value | Prix du produit, toutes taxes comprises. Type de données : nombre | | productOrderItem.itemPrice.priceType | Type de prix de l'article, récurrent ou non récurrent. Type de données : chaîne | | productOrderItem.itemPrice.recurringChargePeriod | Si le prix est récurrent, la période récurrente, par exemple le mois. Type de données : chaîne | | productOrderItem.product | Description des détails de l'instance du produit acheté par le client. Type de données : objet "product": { "id": "String", "place": {Object}, "productCharacteristic": [Array], "productSpecification": {Object}, "relatedParty": {Object}, "@type": "String" } | | productOrderItem.product.id | Identificateur unique du produit vendu. Situé dans le champ sys_id ou sn_ind_tmt_orm_external_id de la table Inventaire des produits \[sn_ind_tmt_orm_product_inventory\]. Ce paramètre n'est renvoyé que si productOrderItem.action la valeur est modifier ou supprimer. Si sys_id et external_id sont présents, le external_id est renvoyé. Type de données : chaîne | | productOrderItem.product.place | Cartes des emplacements sur lesquels installer le produit. Type de données : objet "place": { "id": "String", "@type": "String" } | | productOrderItem.product.place.id | Sys_id de l'enregistrement de l'emplacement associé dans la table Emplacement \[cmn_location\]. Type de données : chaîne | | productOrderItem.product.productCharacteristic | Tableau d'objets décrivant les caractéristiques du produit associé. Type de données : tableau "productCharacteristic": [ { "name": "String", "previousValue": "String", "value": "String" } ] | | productOrderItem.product.productCharacteristic.name | Nom de l'enregistrement de la caractéristique à associer au produit. Situé dans la table Caractéristique \[sn_prd_pm_characteristic\]. Type de données : chaîne | | productOrderItem.product.productCharacteristic.previousValue | Valeurs d'option de caractéristique précédentes si la mise à jour concerne un ordre de changement. La demande est un ordre de changement si le paramètre est autre que ajouterproductOrderItem.action. Pour plus d'informations sur les valeurs des options de caractéristique, reportez-vous à la section [Create product characteristics and characteristic options](https://www.servicenow.com/docs/access?context=som-product-config-add-characteristics&version=xanadu&pubname=xanadu-order-management&ft:locale=en-US). Type de données : chaîne | | productOrderItem.product.productCharacteristic.value | Valeurs d'option de caractéristique associées au produit. Pour plus d'informations sur les valeurs des options de caractéristique, reportez-vous à la section [Create product characteristics and characteristic options](https://www.servicenow.com/docs/access?context=som-product-config-add-characteristics&version=xanadu&pubname=xanadu-order-management&ft:locale=en-US). Type de données : chaîne | | productOrderItem.product.productRelationship | Liste des détails de relation de produit pour un élément de ligne de commande. Type de données : tableau "productRelationship": [ { "id": "String", "relationshipType": "String" } ] | | productOrderItem.product.productRelationship.id | Sys_id ou sn_prd_invt_external_id de l'inventaire des produits. Situé dans le champ sys_id ou sn_prd_invt_external_id de la table Inventaire des produits \[sn_prd_invt_product_inventory\]. Type de données : chaîne | | productOrderItem.product.productRelationship.relationshipType | Type de relation entre l'élément de ligne de commande et l'inventaire des produits. Valeur possible : nécessite Type de données : chaîne | | productOrderItem.product.productSpecification | Description de la spécification du produit associée au produit. Type de données : objet "productSpecification:" { "id": "String", "internalId": "String", "internalVersion": "String", "name": "String", "version": "String", "@type": "String" } | | productOrderItem.product.productSpecification.id | Initial_version ou external_id des spécifications du produit. Le initial_version est le sys_id de la première version de la spécification. Situé dans le champ sys_id ou external_id de la table Spécification de produit \[sn_prd_pm_product_specification\]. Si sys_id et external_id sont présents, le external_id est renvoyé. Type de données : chaîne | | productOrderItem.product.productSpecification.internalId | Initial_version des spécifications du produit. Le initial_version est le sys_id de la première version de la spécification. Situé dans la table Spécification de produit \[sn_prd_pm_product_specification\]. Type de données : chaîne | | productOrderItem.product.productSpecification.internalVersion | Version de la spécification du produit. Situé dans la table Spécification de produit \[sn_prd_pm_product_specification\]. Type de données : chaîne | | productOrderItem.product.productSpecification.name | Nom de la spécification de produit. Situé dans la table Spécification de produit \[sn_prd_pm_product_specification\]. Type de données : chaîne | | productOrderItem.product.productSpecification.version | External_version des spécifications du produit. Situé dans la table Spécification de produit \[sn_prd_pm_product_specification\]. Type de données : chaîne | | productOrderItem.product.productSpecification.@type | Fait partie de la norme TMF Open API. Cette valeur est toujours ProductSpecificationRef. Ces informations ne sont pas stockées. Type de données : chaîne | | élémentcommandeproduit.produit.relatedparty | Liste des contacts pour les éléments de ligne. Type de données : tableau "relatedParty:" [ { "email": "String", "firstName": "String", "lastName": "String", "phone": "String", "@referredType": "String", "@type": "String" } ] | | productOrderItem.product.relatedParty.email | Adresse e-mail du contact. Type de données : chaîne | | productOrderItem.product.relatedParty.firstName | Prénom de la personne à contacter. Type de données : chaîne | | productOrderItem.product.relatedParty.lastName | Nom de famille du contact. Type de données : chaîne Type de données : chaîne | | productOrderItem.product.relatedParty.phone | Numéro de téléphone professionnel du contact. Type de données : chaîne | | productOrderItem.product.relatedParty.@referredType | Type de client. Valeur possible : OrderLineItemContact Type de données : chaîne | | productOrderItem.product.relatedParty.@type | Fait partie de la norme TMF Open API. Annotation pour le contact de l'élément de ligne de commande. Cette valeur est toujours RelatedParty. Ces informations ne sont pas stockées. Type de données : chaîne | | productOrderItem.product.@type | Fait partie de la norme TMF Open API. Annotation pour le produit. Cette valeur est toujours Produit. Ces informations ne sont pas stockées. Type de données : chaîne | | productOrderItem.productOffering | Description de l'offre de produit associée au produit. Type de données : objet "productOffering:" { "id": "String", "internalId": "String", "internalVersion": "String", "name": "String", "version": "String" } | | productOrderItem.productOffering.id | Initial_version ou external_id de l'offre de produits. Le initial_version est le sys_id de la première version de l'offre. Situé dans le champ sys_id ou external_id de la table Offre de produits \[sn_prd_pm_product_offering\]. Si sys_id et external_id sont présents, le external_id est renvoyé. Type de données : chaîne | | productOrderItem.productOffering.internalId | Initial_version de l'offre de produits. Le initial_version est le sys_id de la première version de l'offre. Situé dans la table Offre de produits \[sn_prd_pm_product_offering\]. Type de données : chaîne | | productOrderItem.productOffering.internalVersion | Version de l'offre de produit. Situé dans la table Offre de produits \[sn_prd_pm_product_offering\]. Type de données : chaîne | | productOrderItem.productOffering.name | Nom de l'offre de produits. Situé dans la table Offre de produits \[sn_prd_pm_product_offering\]. Type de données : chaîne | | Élément de commandedeproduit.offredeproduit.version | External_version de l'offre de produits. Situé dans la table Offre de produits \[sn_prd_pm_product_offering\]. Type de données : chaîne | | productOrderItem.productOrderItemRelationship | Tableau d'objets décrivant les relations entre les éléments de ligne de commande. Type de données : tableau "productOrderItemRelationship": [ { "id": "String", "relationshipType": "String" } ] | | productOrderItem.productOrderItemRelationship.id | Identificateur unique de l'élément de ligne connexe. Situé dans le champ sn_ind_tmt_orm_external_id de la table Élément de ligne de commande \[sn_ind_tmt_orm_order_line_item\]. Type de données : chaîne | | productOrderItem.productOrderItemRelationship.relationshipType | Type de relation entre les deux éléments de ligne. Ces informations sont utilisées pour identifier la hiérarchie des relations. Valeurs possibles : * HasChild (en anglais seulement) * HasParent (en anglais seulement) * Exige {#tmf_prod_order-POST-ord-productOrder__ul_yqf_2ty_54b} `HasChild` et `HasParent` sont utilisés pour les relations parent/enfant. `Exige` est utilisé pour les relations horizontales (un élément de ligne nécessite un autre élément de ligne). Type de données : chaîne | | productOrderItem.quantity | Nombre des éléments associés à commander. Type de données : nombre | | élémentcommandeproduit.état | État actuel de l'élément de commande de produit. Cette valeur est toujours nouvelle. Type de données : chaîne | | productOrderItem.@type | Fait partie de la norme TMF Open API. Annotation pour le produit. Cette valeur est toujours ProductOrderItem. Ces informations ne sont pas stockées. Type de données : chaîne | | relatedParty | Liste des contacts de la commande. Chaque contact est un objet dans le tableau. Doit énumérer au moins un élément qui contient des informations sur le compte client ou le compte de consommateur. Type de données : tableau "relatedParty": [ { "id": "String", "name": "String", "@referredType": "String", "@type": "String" } ] | | relatedParty.id | Sys_id ou external_id du compte, du contact client ou du consommateur associé à la commande. Situé dans la table Compte \[customer_account\], Contact \[customer_contact\] ou Consommateur \[csm_consumer\]. Type de données : chaîne | | relatedParty.name | Nom du compte, du client ou du consommateur. Type de données : chaîne | | relatedParty.type | Type de client. Valeurs possibles : * Consommateur * Client * Contact du client {#tmf_prod_order-POST-ord-productOrder__ul_lcq_jwm_t4b} Type de données : chaîne | | requestedCompletionDate | Date de livraison demandée par le client. Type de données : chaîne | | Date de début demandée | Date de début de commande demandée par le client. Type de données : chaîne | | État | État actuel de la commande. Pour ce point de terminaison, cette valeur est toujours nouvelle. Type de données : chaîne | | @type | Fait partie de la norme TMF Open API. Annotation pour le produit. Cette valeur est toujours ProductOrder. Ces informations ne sont pas stockées. Type de données : chaîne | [ ] ### Traitement asynchrone {#tmf_prod_order-POST-ord-productOrder__example_ynv_vhx_fwb} Cet exemple montre comment utiliser le mode paramètre query pour créer une commande de manière asynchrone. La commande est ajoutée à la table File d'attente entrante \[sn_tmt_core_inbound_queue\] selon un calendrier à créer. curl -X POST 'https://instance.service-now.com/api/sn_ind_tmt_orm/order/productOrder?mode=async' \ -H "Accept: application/json" \ -H "Content-Type: application/json" \ -u "username":"password" \ -d '{ "requestedCompletionDate": "2021-05-02T08:13:59.506Z", "requestedStartDate": "2020-05-03T08:13:59.506Z", "orderDate": "2020-05-03T08:13:59.506Z", "externalId": "PO-4ddd56", "orderCurrency": "USD", "note": [ { "id": "1", "author": "Jean Pontus", "date": "2019-04-30T08:13:59.509Z", "text": "This is a TMF product order illustration" }, { "id": "2", "author": "Jean Pontus1", "date": "2019-04-30T08:13:59.509Z", "text": "This is a TMF product order illustration no 2" } ], "productOrderItem": [ { "id": "100", "quantity": 1, "action": "add", "actionReason":"adding service package OLI", "product": { "isBundle": false, "@type": "Product", "productSpecification": { "id": "cfe5ef6a53702010cd6dddeeff7b12f6", "name": "SD-WAN Service Package", "@type": "ProductSpecificationRef" }, "relatedParty": [ { "firstName": "John", "lastName": "Smith", "email": "abc2@example.com", "phone": "32456768", "@type": "RelatedParty", "@referredType": "OrderLineItemContact" } ], "productRelationship": [ { "id": "be6d13f45b5620102dff5e92dc81c781", "relationshipType": "Requires" } ] }, "productOffering": { "id": "69017a0f536520103b6bddeeff7b127d", "name": "Premium SD-WAN Offering" }, "productOrderItemRelationship": [ { "id": "110", "relationshipType": "HasChild" }, { "id": "120", "relationshipType": "HasChild" }, { "id": "130", "relationshipType": "HasChild" } ], "@type": "ProductOrderItem" }, { "id": "110", "quantity": 1, "action": "add", "itemPrice": [ { "description": "Access Fee", "name": "Access Fee", "priceType": "nonRecurring", "price": { "taxRate": 0, "dutyFreeAmount": { "unit": "USD", "value": 100 }, "taxIncludedAmount": { "unit": "USD", "value": 220 } } } ], "product": { "isBundle": false, "@type": "Product", "productCharacteristic": [ { "name": "Tenancy", "valueType": "string", "value": "Premium (>50 sites)" } ], "productSpecification": { "id": "216663aa53702010cd6dddeeff7b12b5", "name": "SD-WAN Controller", "@type": "ProductSpecificationRef" }, "place": { "@type": "Place", "id": "5671dd2ec3a53010188473ce3640dd81" }, "relatedParty": [ { "firstName": "John", "lastName": "Smith", "email": "abc2@example.com", "phone": "32456768", "@type": "RelatedParty", "@referredType": "OrderLineItemContact" } ], "productRelationship": [ { "id": "be6d13f45b5620102dff5e92dc81c781", "relationshipType": "Requires" } ] }, "productOffering": { "id": "69017a0f536520103b6bddeeff7b127d", "name": "Premium SD-WAN Offering" }, "productOrderItemRelationship": [ { "id": "100", "relationshipType": "HasParent" } ], "@type": "ProductOrderItem" }, { "id": "120", "action": "add", "actionReason":"adding service package OLI", "quantity": 1, "itemPrice": [ { "description": "Tariff plan monthly fee", "name": "MonthlyFee", "priceType": "recurring", "recurringChargePeriod": "month", "price": { "taxRate": 0, "dutyFreeAmount": { "unit": "USD", "value": 300 }, "taxIncludedAmount": { "unit": "USD", "value": 349 } } } ], "product": { "isBundle": false, "@type": "Product", "productCharacteristic": [ { "name": "CPE Model", "valueType": "string", "value": "ASR" }, { "name": "WAN Optimization", "valueType": "string", "value": "Advance" }, { "name": "CPE Type", "valueType": "string", "value": "Physical" }, { "name": "Routing", "valueType": "string", "value": "Premium" } ], "productSpecification": { "id": "39b627aa53702010cd6dddeeff7b1202", "name": "SD-WAN Edge Device", "@type": "ProductSpecificationRef" }, "place": { "@type": "Place", "id": "5671dd2ec3a53010188473ce3640dd81" }, "relatedParty": [ { "firstName": "John", "lastName": "Smith", "email": "abc2@example.com", "phone": "32456768", "@type": "RelatedParty", "@referredType": "OrderLineItemContact" } ], "productRelationship": [ { "id": "be6d13f45b5620102dff5e92dc81c781", "relationshipType": "Requires" } ] }, "productOffering": { "id": "69017a0f536520103b6bddeeff7b127d", "name": "Premium SD-WAN Offering" }, "productOrderItemRelationship": [ { "id": "100", "relationshipType": "HasParent" } ], "@type": "ProductOrderItem" }, { "id": "130", "quantity": 1, "action": "add", "actionReason":"adding service package OLI", "itemPrice": [ { "description": "Tariff plan monthly security", "name": "MonthlySecurity", "priceType": "nonRecurring", "recurringChargePeriod": "month", "price": { "taxRate": 0, "dutyFreeAmount": { "unit": "USD", "value": 30 }, "taxIncludedAmount": { "unit": "USD", "value": 30 } } } ], "product": { "isBundle": false, "@type": "Product", "productCharacteristic": [ { "name": "Security Type", "valueType": "string", "value": "Premium" } ], "productSpecification": { "id": "a6514bd3534560102f18ddeeff7b1247", "name": "SD-WAN Security", "@type": "ProductSpecificationRef" }, "place": { "@type": "Place", "id": "5671dd2ec3a53010188473ce3640dd81" }, "relatedParty": [ { "firstName": "John", "lastName": "Smith", "email": "abc2@example.com", "phone": "32456768", "@type": "RelatedParty", "@referredType": "OrderLineItemContact" } ], "productRelationship": [ { "id": "be6d13f45b5620102dff5e92dc81c781", "relationshipType": "Requires" } ] }, "productOffering": { "id": "69017a0f536520103b6bddeeff7b127d", "name": "Premium SD-WAN Offering" }, "productOrderItemRelationship": [ { "id": "100", "relationshipType": "HasParent" } ], "@type": "ProductOrderItem" } ], "relatedParty": [ { "id": "eaf68911c35420105252716b7d40ddde", "name": "Sally Thomas", "@type": "RelatedParty", "@referredType": "CustomerContact" }, { "id": "ffc68911c35420105252716b7d40dd55", "name": "Funco Intl", "@type": "RelatedParty", "@referredType": "Customer" }, { "id": "59f16de1c3b67110ff00ed23a140dd9e", "name": "Funco External", "@type": "RelatedParty", "@referredType": "Consumer" } ], "@type": "ProductOrder" }' Corps de réponse. { "orderId": "304e877ac3ab5110856d73ce3640dde5" } ### Traitement synchrone (par défaut) L'exemple suivant montre comment créer une commande de produit. curl -X POST "https://instance.service-now.com/api/sn_ind_tmt_orm/order/productOrder" \ -H "Accept: application/json" \ -H "Content-Type: application/json" \ -u "username":"password" \ -d { "requestedCompletionDate": "2021-05-02T08:13:59.506Z", "requestedStartDate": "2020-05-03T08:13:59.506Z", "externalId": "PO-456", "currencyCode": "USD", "channel": [ { "id": "2", "name": "Online channel" } ], "note": [ { "text": "This is a TMF product order illustration" }, { "text": "This is a TMF product order illustration no 2" } ], "productOrderItem": [ { "id": "POI100", "quantity": 1, "action": "change", "product": { "id": "fa6d13f45b5620102dff5e92dc81c77f", "@type": "Product", "productSpecification": { "id": "cfe5ef6a53702010cd6dddeeff7b12f6", "name": "SD-WAN Service Package", "@type": "ProductSpecificationRef" }, "place": { "id": "25ab9c4d0a0a0bb300f7dabdc0ca7c1c", "@type": "Place" } }, "productOffering": { "id": "69017a0f536520103b6bddeeff7b127d", "name": "Premium SD-WAN Offering" }, "productOrderItemRelationship": [ { "id": "POI120", "relationshipType": "HasChild" }, { "id": "POI130", "relationshipType": "HasChild" } ], "@type": "ProductOrderItem" }, { "id": "POI120", "quantity": 1, "action": "change", "actionReason":"adding service package OLI", "itemPrice": [ { "priceType": "recurring", "recurringChargePeriod": "month", "price": { "taxIncludedAmount": { "unit": "USD", "value": 20 } } } ], "product": { "id": "766d13f45b5620102dff5e92dc81c78a", "@type": "Product", "productCharacteristic": [ { "name": "WAN Optimization", "value": "Base", "previousValue": "Advance" } ], "productSpecification": { "id": "39b627aa53702010cd6dddeeff7b1202", "name": "SD-WAN Edge Device", "@type": "ProductSpecificationRef" }, "productRelationship": [ { "id": "326d13f45b5620102dff5e92dc81c785", "relationshipType": "Requires" } ], "relatedParty": [ { "id": "51670151c35420105252716b7d40ddfe", "firstName": "Joe", "lastName": "Doe", "email": "abc@example.com", "phone": "1234567890", "@type": "RelatedParty", "@referredType": "OrderLineItemContact" } ], "place": { "id": "25ab9c4d0a0a0bb300f7dabdc0ca7c1c", "@type": "Place" } }, "productOffering": { "id": "69017a0f536520103b6bddeeff7b127d", "name": "Premium SD-WAN Offering" }, "productOrderItemRelationship": [ { "id": "POI100", "relationshipType": "HasParent" }, { "id": "POI130", "relationshipType": "Requires" } ], "@type": "ProductOrderItem" }, { "id": "POI130", "quantity": 1, "action": "add", "actionReason":"adding service package OLI", "itemPrice": [ { "priceType": "recurring", "recurringChargePeriod": "month", "price": { "taxIncludedAmount": { "unit": "USD", "value": 20 } } } ], "product": { "@type": "Product", "productCharacteristic": [ { "name": "Security Type", "value": "Base", "previousValue": "Advance" } ], "productSpecification": { "id": "a6514bd3534560102f18ddeeff7b1247", "name": "SD-WAN Security", "@type": "ProductSpecificationRef" }, "relatedParty": [ { "id": "51670151c35420105252716b7d40ddfe", "firstName": "Joe", "lastName": "Doe", "email": "abc@example.com", "phone": "1234567890", "@type": "RelatedParty", "@referredType": "OrderLineItemContact" } ], "place": { "id": "25ab9c4d0a0a0bb300f7dabdc0ca7c1c", "@type": "Place" } }, "productOffering": { "id": "69017a0f536520103b6bddeeff7b127d", "name": "Premium SD-WAN Offering" }, "productOrderItemRelationship": [ { "id": "POI100", "relationshipType": "HasParent" } ], "@type": "ProductOrderItem" } ], "relatedParty": [ { "id": "eaf68911c35420105252716b7d40ddde", "name": "Sally Thomas", "@type": "RelatedParty", "@referredType": "CustomerContact" }, { "id": "ffc68911c35420105252716b7d40dd55", "name": "Funco Intl", "@type": "RelatedParty", "@referredType": "Customer" }, { "id": "59f16de1c3b67110ff00ed23a140dd9e", "name": "Funco External", "@type": "RelatedParty", "@referredType": "Consumer" } ], "@type": "ProductOrder" } Corps de réponse. { "requestedCompletionDate": "2021-05-02T08:13:59.506Z", "requestedStartDate": "2020-05-03T08:13:59.506Z", "externalId": "PO-456", "currencyCode": "USD", "channel": [ { "id": "2", "name": "Online chanel" } ], "note": [ { "text": "This is a TMF product order illustration" }, { "text": "This is a TMF product order illustration no 2" } ], "productOrderItem": [ { "id": "POI100", "quantity": 1, "action": "change", "actionReason":"adding service package OLI", "product": { "id": "fa6d13f45b5620102dff5e92dc81c77f", "@type": "Product", "productSpecification": { "id": "cfe5ef6a53702010cd6dddeeff7b12f6", "name": "SD-WAN Service Package", "internalVersion": "1", "version": "v1", "internalId": "cfe5ef6a53702010cd6dddeeff7b12f6", "@type": "ProductSpecificationRef" }, "place": { "id": "25ab9c4d0a0a0bb300f7dabdc0ca7c1c", "@type": "Place" } }, "productOffering": { "id": "69017a0f536520103b6bddeeff7b127d", "name": "Premium SD-WAN Offering", "internalVersion": "1", "version": "v1", "internalId": "69017a0f536520103b6bddeeff7b127d" }, "productOrderItemRelationship": [ { "id": "POI120", "relationshipType": "HasChild" }, { "id": "POI130", "relationshipType": "HasChild" } ], "@type": "ProductOrderItem", "state": "new" }, { "id": "POI120", "quantity": 1, "action": "change", "actionReason":"adding service package OLI", "itemPrice": [ { "priceType": "recurring", "recurringChargePeriod": "month", "price": { "taxIncludedAmount": { "unit": "USD", "value": 20 } } } ], "product": { "id": "766d13f45b5620102dff5e92dc81c78a", "@type": "Product", "productCharacteristic": [ { "name": "WAN Optimization", "value": "Base", "previousValue": "Advance" } ], "productSpecification": { "id": "39b627aa53702010cd6dddeeff7b1202", "name": "SD-WAN Edge Device", "internalVersion": "1", "version": "v1", "internalId": "39b627aa53702010cd6dddeeff7b1202", "@type": "ProductSpecificationRef" }, "productRelationship": [ { "id": "326d13f45b5620102dff5e92dc81c785", "relationshipType": "Requires" } ], "relatedParty": [ { "id": "51670151c35420105252716b7d40ddfe", "firstName": "Joe", "lastName": "Doe", "email": "abc@example.com", "phone": "1234567890", "@type": "RelatedParty", "@referredType": "OrderLineItemContact" } ], "place": { "id": "25ab9c4d0a0a0bb300f7dabdc0ca7c1c", "@type": "Place" } }, "productOffering": { "id": "69017a0f536520103b6bddeeff7b127d", "name": "Premium SD-WAN Offering", "internalVersion": "1", "version": "v1", "internalId": "69017a0f536520103b6bddeeff7b127d" }, "productOrderItemRelationship": [ { "id": "POI100", "relationshipType": "HasParent" }, { "id": "POI130", "relationshipType": "Requires" } ], "@type": "ProductOrderItem", "state": "new" }, { "id": "POI130", "quantity": 1, "action": "add", "actionReason":"adding service package OLI", "itemPrice": [ { "priceType": "recurring", "recurringChargePeriod": "month", "price": { "taxIncludedAmount": { "unit": "USD", "value": 20 } } } ], "product": { "@type": "Product", "productCharacteristic": [ { "name": "Security Type", "value": "Base", "previousValue": "Advance" } ], "productSpecification": { "id": "a6514bd3534560102f18ddeeff7b1247", "name": "SD-WAN Security", "internalVersion": "1", "version": "v1", "internalId": "a6514bd3534560102f18ddeeff7b1247", "@type": "ProductSpecificationRef" }, "relatedParty": [ { "id": "51670151c35420105252716b7d40ddfe", "firstName": "Joe", "lastName": "Doe", "email": "abc@example.com", "phone": "1234567890", "@type": "RelatedParty", "@referredType": "OrderLineItemContact" } ], "place": { "id": "25ab9c4d0a0a0bb300f7dabdc0ca7c1c", "@type": "Place" } }, "productOffering": { "id": "69017a0f536520103b6bddeeff7b127d", "name": "Premium SD-WAN Offering", "internalVersion": "1", "version": "v1", "internalId": "69017a0f536520103b6bddeeff7b127d" }, "productOrderItemRelationship": [ { "id": "POI100", "relationshipType": "HasParent" } ], "@type": "ProductOrderItem", "state": "new" } ], "relatedParty": [ { "id": "eaf68911c35420105252716b7d40ddde", "name": "Sally Thomas", "@type": "RelatedParty", "@referredType": "CustomerContact" }, { "id": "ffc68911c35420105252716b7d40dd55", "name": "Funco Intl", "@type": "RelatedParty", "@referredType": "Customer" }, { "id": "59f16de1c3b67110ff00ed23a140dd9e", "name": "Funco External", "@type": "RelatedParty", "@referredType": "Consumer" } ], "@type": "ProductOrder", "id": "8d75939453126010a795ddeeff7b126a", "href": "/api/sn_ind_tmt_orm/order/productOrder/8d75939453126010a795ddeeff7b126a", "state": "new" } ## API ouverte de commande de produit : POST /sn_ind_tmt_orm/productorder {#ariaid-title10} Crée la commande client et les éléments de ligne de commande client spécifiés. Important : Ce point de terminaison est obsolète à partir de la Tokyo mise en production. La nouvelle version de ce point de terminaison est [API ouverte pour la commande de produit : POST /sn_ind_tmt_orm/order/productOrder](https://servicenow-prod.fluidtopics.net/7R48AWEcFp5whb2FwX7mKg#tmf_prod_order-POST-ord-productOrder "Crée la commande client et les éléments de ligne de commande client spécifiés."). Une fois traités, de nouveaux enregistrements sont créés dans les tables suivantes : * Commande de clients \[sn_ind_tmt_orm_order\] * Caractéristique de commande \[sn_ind_tmt_orm_order_characteristic_value\] * Élément de ligne de commande \[sn_ind_tmt_orm_order_line_item\] * Contact de l'élément de ligne de commande \[sn_ind_tmt_orm_order_line_item_contact\] {#tmf_prod_order-POST-productOrder__ul_hxq_vdb_hqb} ### Format d'URL URL par défaut : /api/sn_ind_tmt_orm/productorder ### Paramètres de demande pris en charge {#tmf_prod_order-POST-productOrder__entry__2} | Nom | Description | |-|-| | Aucun | | [Tableau 49. Paramètres de chemin d'accès] {#tmf_prod_order-POST-productOrder__entry__6} | Nom | Description | |-|-| | Aucun | | [Tableau 50. Paramètres de requête] {#tmf_prod_order-POST-productOrder__id_vk2_p5n_t4b__entry__2}{#tmf_prod_order-POST-productOrder__due-date-entry}{#tmf_prod_order-POST-productOrder__productOrder-href-request}{#tmf_prod_order-POST-productOrder__productOrder-addReason-request}{#tmf_prod_order-POST-productOrder__due-date-item-entry}{#tmf_prod_order-POST-productOrder__externalProductInventory-GET-desc-request}{#tmf_prod_order-POST-productOrder__externalProductInventoryId-desc} | Nom | Description | |-|-| | canal | Tableau d'objets qui décrivent les canaux à utiliser pour vendre les produits. Type de données : tableau "channel": [ { "id": "String", "name": "String" } ] Table/champ mis à jour : sn_ind_tmt_orm_order | | channel.id | Requis. Identificateur unique du canal à utiliser pour vendre les produits associés. Les valeurs d'ID de canal se trouvent dans le champ external_id de la table Canal de distribution \[sn_prd_pm_distribution_channel\]. Type de données : chaîne Table/champ mis à jour : sn_ind_tmt_orm_order/canal Par défaut : chaîne vide | | channel.name | Nom du canal à utiliser pour vendre les produits associés. Les noms de canaux possibles sont définis dans l'onglet Liste de choix de l'entrée du dictionnaire des canaux de la table sn_ind_tmt_orm_order. Type de données : chaîne Par défaut : chaîne vide | | committedDueDate | Date et heure auxquelles l'action doit être effectuée sur la commande. Cette valeur doit être identique ou ultérieure aux valeurs de committedDueDate chaque élément de ligne de commande. Type de données : chaîne Table/champ mis à jour : sn_ind_tmt_orm_order/committed_due_date | | externalId | Identificateur unique de la commande du client. Cette valeur est déterminée par un système externe. Type de données : chaîne Table/champ mis à jour : sn_ind_tmt_orm_order/external_id Par défaut : chaîne vide | | href | Un lien relatif vers l'enregistrement de ressource. Type de données : chaîne Par défaut : chaîne vide | | note | Tableau d'objets contenant des notes supplémentaires prises par le client lors de la commande. Type de données : tableau "note": [ { "text": "String" } ] Table/champ mis à jour : sn_ind_tmt_orm_order | | note.texte | Requis. Remarques/commentaires supplémentaires formulés par le client lors de la commande. Type de données : chaîne Table/champ mis à jour : sn_ind_tmt_orm_order/commentaires Par défaut : chaîne vide | | orderCurrency | Requis. Code de devise pour la commande et les éléments de ligne de commande. La devise doit être la même pour tous les éléments de la commande et des éléments de ligne de commande, sinon une erreur est renvoyée et la commande n'est pas créée. Une fois qu'une commande est créée, son code de devise ne peut pas être modifié. Type de données : chaîne | | Élément de commande produit | Requis. Tableau d'objets décrivant les éléments associés à la commande de produit et leur action associée. Type de données : tableau "productOrderItem": [ { "action": "String", "actionReason": "String", "committedDueDate": "String", "externalProductInventory": [Array], "id": "String", "itemPrice": [Array], "product": {Object}, "productOffering": {Object}, "productOrderItemRelationship": [Array], "quantity": Number, "@type": "String" } ] Table/champ mis à jour : sn_ind_tmt_orm_order_line_item | | productOrderItem.action | Requis. Action à effectuer sur le produit. Les actions possibles sont définies dans l'onglet Liste de choix de l'entrée du dictionnaire d'actions de la table sn_ind_tmt_orm_order_line_item. Valeurs possibles : * ajouter * changement * supprimer * Aucun changement * reprendre * suspendre {#tmf_prod_order-POST-productOrder__ul_qbd_dyp_ysb} Type de données : chaîne Table/champ mis à jour : sn_ind_tmt_orm_order_line_item/action | | Élément de commandeproduit.actionReason | Facultatif. Description du motif de l'élément de ligne de commande. Type de données : chaîne Table/champ mis à jour : sn_ind_tmt_orm_order_line_item/action_reason | | productOrderItem.committedDueDate | Date et heure auxquelles l'action doit être effectuée sur l'élément de ligne de commande. Type de données : chaîne Table/champ mis à jour : sn_ind_tmt_orm_order_line_item/committed_due_date | | productOrderItem.externalProductInventory | Tableau d'objets contenant des ID externes à mapper aux inventaires de produits créés pour la commande. Type de données : tableau d'objets "externalProductInventory": [ { "externalProductInventoryId": "String" } ] | | productOrderItem.externalProductInventory.externalProductInventoryId | ID externe à mapper à l'inventaire des produits. Type de données : chaîne Table/champ mis à jour : sn_ind_tmt_orm_order_line_item/external_inventory_id et sn_prd_invt_product_inventory/sn_prd_invt_external_id | | productOrderItem.id | Requis. Identificateur unique de l'élément de ligne. Type de données : chaîne Table/champ mis à jour : sn_ind_tmt_orm_order_line_item/external_id Longueur maximale : 40 Par défaut : chaîne vide | | productOrderItem.itemPrice | Tableau d'objets décrivant le prix associé au produit. Type de données : tableau "itemPrice": [ { "price": {Object}, "priceType": "String", "recurringChargePeriod": "String" } ] Table mise à jour : sn_ind_tmt_orm_order Par défaut : chaîne vide | | productOrderItem.itemPrice.price | Description du prix du produit associé. Type de données : objet "price": { "taxIncludedAmount": {Object} } Table mise à jour : sn_ind_tmt_orm_order_line_item Par défaut : chaîne vide | | productOrderItem.itemPrice.price.taxIncludedAmount | Description du prix du produit associé, taxes comprises. Type de données : objet "taxIncludedAmount": { "unit": "String", "value": Number } Table mise à jour : sn_ind_tmt_orm_order_line_item | | productOrderItem.itemPrice.price.taxIncludedAmount.unit | Code de devise dans lequel le prix est représenté. Type de données : chaîne Table/champ mis à jour : sn_ind_tmt_orm_order_line_item/mrc ou nrc | | productOrderItem.itemPrice.price.taxIncludedAmount.value | Prix du produit, toutes taxes comprises. Type de données : nombre Table/champ mis à jour : sn_ind_tmt_orm_order_line_item/mrc ou nrc | | productOrderItem.itemPrice.priceType | Spécifie si le prix de l'élément est récurrent ou non récurrent. Type de données : chaîne | | productOrderItem.itemPrice.recurringChargePeriod | Si le prix est récurrent, spécifie la période récurrente, par exemple le mois. Type de données : chaîne | | productOrderItem.product | Requis si productOrderItem.action c'est un changement ou une suppression. Description des détails de l'instance du produit acheté par le client. Type de données : objet "product": { "id": "String", "place": {Object}, "productCharacteristic": [Array], "productSpecification": {Object}, "relatedParty": {Object}, "@type": "String" } Table/champ mis à jour : sn_ind_tmt_orm_order_line_item | | productOrderItem.product.id | Requis si productOrderItem.action c'est un changement ou une suppression. Identificateur unique du produit vendu. Situé dans le champ sys_id ou sn_ind_tmt_orm_external_id de la table Inventaire des produits \[sn_ind_tmt_orm_product_inventory\]. Type de données : chaîne Par défaut : chaîne vide | | productOrderItem.product.place | Cartes des emplacements sur lesquels installer le produit. Type de données : objet "place": { "id": "String", "@type": "String" } Table/champ mis à jour : sn_ind_tmt_orm_order_line_item | | productOrderItem.product.place.id | Requis. Sys_id de l'enregistrement de l'emplacement associé dans la table Emplacement \[cmn_location\]. Type de données : chaîne Table/champ mis à jour : sn_ind_tmt_orm_order_line_item/emplacement | | productOrderItem.product.place.@type | Fait partie de la norme TMF Open API. Annotation pour le contact de l'élément de ligne de commande. Cette valeur est toujours Place. Ces informations ne sont pas stockées. Type de données : chaîne | | productOrderItem.product.productCharacteristic | Tableau d'objets décrivant les caractéristiques du produit associé. Type de données : tableau "productCharacteristic": [ { "name": "String", "previousValue": "String", "value": "String" } ] Table/champ mis à jour : sn_ind_tmt_orm_order_characteristic_value | | productOrderItem.product.productCharacteristic.name | Nom de l'enregistrement de la caractéristique à associer au produit. Situé dans la table Caractéristique \[sn_prd_pm_characteristic\]. Type de données : chaîne Table/champ mis à jour : sn_ind_tmt_orm_order_characteristic_value/caractéristiques Par défaut : chaîne vide | | productOrderItem.product.productCharacteristic.previousValue | Valeurs d'option de caractéristique précédentes si la mise à jour concerne l'ordre de changement. La demande est un ordre de changement si le paramètre est autre que ajouterproductOrderItem.action. Pour plus d'informations sur les valeurs des options de caractéristique, reportez-vous à la section [Create product characteristics and characteristic options](https://www.servicenow.com/docs/access?context=som-product-config-add-characteristics&version=xanadu&pubname=xanadu-order-management&ft:locale=en-US). Type de données : chaîne Table/champ mis à jour : sn_ind_tmt_orm_order_characteristic_value/previous_characteristic_option_value Par défaut : chaîne vide | | productOrderItem.product.productCharacteristic.value | Valeurs d'option de caractéristique associées au produit. Pour plus d'informations sur les valeurs des options de caractéristique, reportez-vous à la section [Create product characteristics and characteristic options](https://www.servicenow.com/docs/access?context=som-product-config-add-characteristics&version=xanadu&pubname=xanadu-order-management&ft:locale=en-US). Type de données : chaîne Table/champ mis à jour : sn_ind_tmt_orm_order_characteristic_value/characteristic_option_value Par défaut : chaîne vide | | productOrderItem.product.productSpecification | Requis. Description de la spécification du produit associée au produit. Remarque : Les ordres de changement (productOrderItem.action est `un changement`) sont traités différemment en fonction de la valeur de la sn_ind_tmt_orm.allowSpecVersionUpdateInChangeOrder propriété système. La valeur de cette propriété système détermine le mode de traitement de la commande si la version de l'inventaire des produits est différente de celle indiquée dans la commande. * Lorsque cette propriété système est définie sur vrai (par défaut), l'inventaire des produits est automatiquement mis à niveau vers la version de la commande en modifiant les spécifications du produit référencé. Cela permet de traiter la commande avec succès. * Lorsque cette propriété système est définie sur faux, si l'inventaire des produits est d'une version différente de celle indiquée dans la commande, la commande échoue en raison d'une incompatibilité de version. {#tmf_prod_order-POST-productOrder__ul_zbw_sdz_dbc} Type de données : objet "productSpecification": { "id": "String", "internalVersion": "String", "name": "String", "version": "String", "@type": "String" } Table/champ mis à jour : sn_ind_tmt_orm_order_line_item | | productOrderItem.product.productSpecification.id | Requis. Initial_version ou external_id des spécifications du produit. Le initial_version est le sys_id de la première version de la spécification. Situé dans le champ sys_id ou external_id de la table Spécification de produit \[sn_prd_pm_product_specification\]. Type de données : chaîne | | productOrderItem.product.productSpecification.internalVersion | Version de la spécification du produit. Situé dans la table Spécification de produit \[sn_prd_pm_product_specification\]. Type de données : chaîne | | productOrderItem.product.productSpecification.name | Nom de la spécification de produit. Situé dans la table Spécification de produit \[sn_prd_pm_product_specification\]. Type de données : chaîne | | productOrderItem.product.productSpecification.version | External_version des spécifications du produit. Situé dans la table Spécification de produit \[sn_prd_pm_product_specification\]. Type de données : chaîne | | productOrderItem.product.productSpecification.@type | Fait partie de la norme TMF Open API. Cette valeur est toujours ProductSpecificationRef. Ces informations ne sont pas stockées. Type de données : chaîne | | élémentcommandeproduit.produit.relatedparty | Tableau d'objets décrivant le rôle de partie lié à un OrderLineItemContact. Type de données : tableau "relatedParty": [ { "email": "String", "firstName": "String", "lastName": "String", "phone": "String", "@referredType": "String", "@type": "String" } ] Table/champ mis à jour : sn_ind_tmt_orm_order_line_item_contact | | productOrderItem.product.relatedParty.email | Adresse e-mail du contact. Type de données : chaîne Table/champ mis à jour : sn_ind_tmt_orm_order_line_item_contact/e-mail Par défaut : chaîne vide | | productOrderItem.product.relatedParty.firstName | Prénom de la personne à contacter. Type de données : chaîne Table/champ mis à jour : sn_ind_tmt_orm_order_line_item_contact/first_name Par défaut : chaîne vide | | productOrderItem.product.relatedParty.lastName | Nom de famille du contact. Type de données : chaîne Table/champ mis à jour : sn_ind_tmt_orm_order_line_item_contact/lastName Par défaut : chaîne vide | | productOrderItem.product.relatedParty.phone | Numéro de téléphone professionnel du contact. Type de données : chaîne Table/champ mis à jour : sn_ind_tmt_orm_order_line_item_contact/business_phone Par défaut : chaîne vide | | productOrderItem.product.relatedParty.@referredType | Requis. Type de client. Valeur possible : OrderLineItemContact Type de données : chaîne | | productOrderItem.product.relatedParty.@type | Fait partie de la norme TMF Open API. Annotation pour le contact de l'élément de ligne de commande. Cette valeur est toujours RelatedParty. Ces informations ne sont pas stockées. Type de données : chaîne | | productOrderItem.product.@type | Fait partie de la norme TMF Open API. Annotation pour le produit. Cette valeur est toujours Produit. Ces informations ne sont pas stockées. Type de données : chaîne | | productOrderItem.productOffering | Requis. Description de l'offre de produit associée au produit. Type de données : objet "productOffering": { "id": "String", "internalVersion": "String", "name": "String", "version": "String" } Table mise à jour : sn_ind_tmt_orm_order_line_item | | productOrderItem.productOffering.id | Requis. Initial_version ou external_id de l'offre de produits. Le initial_version est le sys_id de la première version de l'offre. Situé dans le champ sys_id ou external_id de la table Offre de produits \[sn_prd_pm_product_offering\]. Type de données : chaîne | | productOrderItem.productOffering.internalVersion | Version de l'offre de produit. Situé dans la table Offre de produits \[sn_prd_pm_product_offering\]. Type de données : chaîne | | productOrderItem.productOffering.name | Nom de l'offre de produits. Situé dans la table Offre de produits \[sn_prd_pm_product_offering\]. Type de données : chaîne | | Élément de commandedeproduit.offredeproduit.version | External_version de l'offre de produits. Situé dans la table Offre de produits \[sn_prd_pm_product_offering\]. Type de données : chaîne | | productOrderItem.productOrderItem.quantity | Nombre des éléments associés à commander. Type de données : nombre Table/champ mis à jour : sn_ind_tmt_orm_order/quantité Par défaut : null | | productOrderItem.productOrderItemRelationship | Requis. Tableau d'objets décrivant la relation parent/enfant entre les éléments de commande. Type de données : tableau "productOrderItemRelationship": [ { "id": "String", "relationshipType": "String" } ] Table/champ mis à jour : sn_ind_tmt_orm_order_line_item | | productOrderItem.productOrderItemRelationship.id | Requis. Identique à la productOrderItem.id valeur. Utilisé pour la relation parent/enfant Type de données : chaîne Table/champ mis à jour : sn_ind_tmt_orm_order_line_item/parent_line_item Par défaut : chaîne vide | | productOrderItem.productOrderItemRelationship.relationshipType | Requis. Type de relation entre les deux éléments de ligne. Ces informations sont utilisées pour identifier la hiérarchie des relations. Valeurs possibles : * HasChild (en anglais seulement) * HasParent (en anglais seulement) {#tmf_prod_order-POST-productOrder__ul_rmq_vrk_5rb} Type de données : chaîne | | productOrderItem.quantity | Nombre d'éléments commandés. Type de données : nombre Table/champ mis à jour : sn_ind_tmt_orm_order/quantité Par défaut : chaîne vide | | productOrderItem.@type | Fait partie de la norme TMF Open API. Annotation pour le produit. Cette valeur est toujours ProductOrderItem. Ces informations ne sont pas stockées. Type de données : chaîne | | relatedParty | Liste des contacts de la commande. Chaque contact est un objet dans le tableau. Doit énumérer au moins un élément qui contient des informations sur le compte client ou le compte de consommateur. Type de données : tableau "relatedParty": [ { "id": "String", "name": "String", "@referredType": "String", "@type": "String" } ] | | relatedParty.id | Sys_id ou external_id du compte ou du contact client associé à la commande. Situé dans la table Compte \[customer_account\], Contact \[customer_contact\] ou Consommateur \[csm_consumer\]. Type de données : chaîne | | relatedParty.name | Nom du compte, du client ou du consommateur. Type de données : chaîne | | relatedParty.@referredType | Requis. Type de client. Valeurs possibles : * Consommateur * Client * Contact du client {#tmf_prod_order-POST-productOrder__ul_smq_vrk_5rb} Type de données : chaîne | | relatedParty.@type | Fait partie de la norme TMF Open API. Annotation pour le produit. Cette valeur est toujours RelatedParty. Ces informations ne sont pas stockées. Type de données : chaîne | | requestedCompletionDate | Date de livraison demandée par le client. Type de données : chaîne Table/champ mis à jour : sn_ind_tmt_orm_order/expected_end_date Par défaut : chaîne vide | | Date de début demandée | Date de début de commande demandée par le client. Type de données : chaîne Table/champ mis à jour : sn_ind_tmt_orm_order/expected_start_date Par défaut : chaîne vide | | @type | Fait partie de la norme TMF Open API. Annotation pour le produit. Cette valeur est toujours ProductOrder. Ces informations ne sont pas stockées. Type de données : chaîne | [Tableau 51. Paramètres du corps de la demande (JSON)] {#tmf_prod_order-POST-productOrder__id_vk2_p5n_t4b} ### En-têtes Les en-têtes de demande et de réponse suivants s'appliquent à cette action HTTP uniquement ou s'appliquent à cette action d'une manière distincte. Pour obtenir la liste des en-têtes généraux utilisés dans l'API REST, consultez [En-têtes d'API REST pris en charge](https://servicenow-prod.fluidtopics.net/CFQa7z9NIrhoOq1u1cRN7g "REST (REpresentational State Transfer) est une architecture simple sans état qui fournit des normes entre les systèmes informatiques sur le Web, ce qui leur permet de communiquer plus facilement les uns avec les autres."). {#tmf_prod_order-POST-productOrder__table_omb_dvk_5rb__entry__2}{#tmf_prod_order-POST-productOrder__accept-JSON-only-entry-RESTAPI}{#tmf_prod_order-POST-productOrder__content_type-JSON-only-entry-RESTAPI} | En-tête | Description | |-|-| | Accepter | Format de données du corps de la réponse. Prend uniquement en charge application/json. | | Content-Type | Format de données du corps de la demande. Prend uniquement en charge application/json. | [Tableau 52. En-têtes de demandes] {#tmf_prod_order-POST-productOrder__table_omb_dvk_5rb} {#tmf_prod_order-POST-productOrder__table_tzy_thy_ksb__entry__2} | En-tête | Description | |-|-| | Type de contenu | Format de données du corps de la réponse. Ne prend en charge application/jsonque les fichiers . | [Tableau 53. En-têtes de réponses] {#tmf_prod_order-POST-productOrder__table_tzy_thy_ksb} ### Codes d'état Les codes d'état suivants s'appliquent à cette action HTTP. Pour obtenir la liste des codes d'état possibles utilisés dans l'API REST, consultez [Codes de réponse HTTP de l'API REST](https://servicenow-prod.fluidtopics.net/CFQa7z9NIrhoOq1u1cRN7g "REST (REpresentational State Transfer) est une architecture simple sans état qui fournit des normes entre les systèmes informatiques sur le Web, ce qui leur permet de communiquer plus facilement les uns avec les autres."). {#tmf_prod_order-POST-productOrder__entry__152} | Code d'état | Description | |-|-| | 201 | Réussi. En cas de problèmes avec les caractéristiques ou les informations d'option des caractéristiques, le point de terminaison stocke les commentaires suivants dans les champs de notes de travail de l'enregistrement d'élément de ligne de commande client associé : * Les caractéristiques de l'élément de commande suivantes n'existent pas : Examinez la spécification \ et corrigez la caractéristique et l'option de caractéristique dans l'élément de ligne de commande avant d'approuver la commande. * Caractéristique de l'élément de commande : \ avec la valeur caractéristique : \n'est pas valide. Corrigez les valeurs caractéristiques avant d'approuver la commande. {#tmf_prod_order-POST-productOrder__ul_xtx_xym_t4b} | | 400 | Demande incorrecte. L'une des raisons suivantes peut être l'une des suivantes : * Charge utile non valide : corps de la demande manquant : la charge utile n'a pas été transmise dans le corps de la demande. * Charge utile non valide : productOrderItem est manquant : l'objet de l'élément de ligne de commande de produit ou JSON est manquant. * Charge utile non valide : l'ID de productOrderItem est manquant : le id paramètre est manquant dans l'élément de ligne de commande de produit de la charge utile. * Charge utile non valide : l'action productOrderItem est manquante : le action paramètre est manquant dans l'élément de ligne de commande de produit de la charge utile. * Charge utile non valide : productOrderItem productOffering est manquant : l'objet ou JSON de l'offre de produit est manquant dans l'élément de ligne de commande de produit dans la charge utile. * Charge utile non valide : l'ID productOffering est manquant : le id paramètre est manquant dans l'élément de ligne de commande de produit de l'objet d'offre de produit dans la charge utile. * Charge utile non valide : l'offre de produit n'existe pas : l'offre de produit dans l'élément de ligne de commande de produit n'est pas valide. * Charge utile non valide : productOrderItem produit manquant : l'objet produit ou JSON dans l'élément de ligne de commande de produit est manquant dans la charge utile. * Charge utile non valide : product productSpecification est manquant : l'objet de spécification du produit ou le JSON dans l'élément de ligne de commande de produit est manquant dans la charge utile. * Charge utile non valide : l'ID de spécification de produit est manquant : le id paramètre de l'élément de ligne de commande de produit de l'objet de spécification de produit est manquant dans la charge utile. * Charge utile non valide : la spécification du produit n'existe pas : la spécification du produit dans l'élément de ligne de commande de produit n'est pas valide. * Charge utile non valide : l'inventaire de produits n'existe pas : dans un ordre de changement (action = changement), la quantité d'un élément est supérieure à ce qui est en stock. * Charge utile non valide : ID d'inventaire de produits manquant : dans l'ordre des changements, le product.id est manquant dans la charge utile. * Charge utile non valide : produit vendu est inactif : dans un ordre de changement, un produit spécifié dans la charge utile est inactif. * Charge utile non valide : relatedParty est manquant : l'objet de la partie associée est manquant dans la charge utile. * Charge utile non valide : compte client ou consommateur manquant : le client tiers connexe ou l'objet consommateur est manquant dans la charge utile. * Charge utile non valide : Le consommateur n'existe pas : le consommateur tiers associé spécifié n'existe pas dans l'instance ServiceNow . * Charge utile non valide : Le compte client n'existe pas : le client tiers associé spécifié n'existe pas dans l'instance ServiceNow . * Charge utile non valide : Échec de la création de la commande : impossible de créer la commande demandée. {#tmf_prod_order-POST-productOrder__ul_g2v_rzm_t4b} | [Tableau 54. Codes d'état] ### Paramètres de corps de réponse (JSON) {#tmf_prod_order-POST-productOrder__entry__158} | Nom | Description | |-|-| | canal | Tableau d'objets qui décrivent les canaux à utiliser pour vendre les produits. Type de données : tableau "channel": [ { "id": "String", "name": "String" } ] | | channel.id | Identificateur unique du canal à utiliser pour vendre les produits associés. Les valeurs d'ID de canal se trouvent dans le champ external_id de la table Canal de distribution \[sn_prd_pm_distribution_channel\]. Type de données : chaîne | | channel.name | Nom du canal à utiliser pour vendre les produits associés. Type de données : chaîne | | id | Sys_id de la commande client créée pour cette demande. Type de données : chaîne | | externalId | Identificateur externe de la commande client, tel qu'un numéro de bon de commande. Type de données : chaîne | | note | Tableau d'objets qui décrivent les notes supplémentaires prises par le client lors de la commande. Type de données : tableau "note": [ { "text": "String" } ] | | note.texte | Remarques/commentaires supplémentaires formulés par le client lors de la commande. Type de données : chaîne | | Élément de commande produit | Liste décrivant les éléments associés à la commande de produit et leur action associée. Type de données : tableau "productOrderItem:" [ { "action": "String", "id": "String", "itemPrice": [Array], "product": {Object}, "productOffering": {Object}, "productOrderItemReleationship": [Array], "quantity": Number, "state": "String", "@type": "String" } ] | | productOrderItem.action | Action à effectuer sur le produit. Les actions possibles sont définies dans l'onglet Liste de choix de l'entrée du dictionnaire d'actions de la table sn_ind_tmt_orm_order_line_item. Type de données : chaîne | | productOderItem.actionReason | Motif de l'ajout de l'élément de ligne de commande. Type de données : chaîne Table/champ mis à jour : sn_ind_tmt_orm_order_line_item/action_reason | | productOrderItem.id | Identificateur unique de l'élément de ligne. Situé dans le champ sn_ind_tmt_orm_external_id de la table Élément de ligne de commande \[sn_ind_tmt_orm_order_line_item\]. Type de données : chaîne | | productOrderItem.itemPrice | Tableau d'objets décrivant le prix associé au produit. Type de données : tableau "itemPrice": [ { "price": {Object}, "priceType": "String", "recurringChargePeriod": "String" } ] | | productOrderItem.itemPrice.price | Description du prix du produit associé. Type de données : objet "price": { "taxIncludedAmount": {Object} } | | productOrderItem.itemPrice.price.taxIncludeAmount | Description du prix du produit associé, taxes comprises. Type de données : objet "taxIncludedAmount": { "unit": "String", "value": Number } | | productOrderItem.itemPrice.price.taxIncludeAmount.unit | Code de devise dans lequel le prix est représenté. Type de données : chaîne | | productOrderItem.itemPrice.price.taxIncludeAmount.value | Prix du produit, toutes taxes comprises. Type de données : nombre | | productOrderItem.itemPrice.priceType | Type de prix de l'article, récurrent ou non récurrent. Type de données : chaîne | | productOrderItem.itemPrice.recurringChargePeriod | Si le prix est récurrent, la période récurrente, par exemple le mois. Type de données : chaîne | | productOrderItem.product | Description des détails de l'instance du produit acheté par le client. Type de données : objet "product": { "id": "String", "place": {Object}, "productCharacteristic": [Array], "productSpecification": {Object}, "relatedParty": {Object}, "@type": "String" } | | productOrderItem.product.id | Identificateur unique du produit vendu. Situé dans le champ sys_id ou sn_ind_tmt_orm_external_id de la table Inventaire des produits \[sn_ind_tmt_orm_product_inventory\]. Ce paramètre n'est renvoyé que si productOrderItem.action la valeur est modifier ou supprimer. Si sys_id et external_id sont présents, le external_id est renvoyé. Type de données : chaîne | | productOrderItem.product.place | Cartes des emplacements sur lesquels installer le produit. Type de données : objet "place": { "id": "String", "@type": "String" } | | productOrderItem.product.place.id | Sys_id de l'enregistrement de l'emplacement associé dans la table Emplacement \[cmn_location\]. Type de données : chaîne | | productOrderItem.product.productCharacteristic | Tableau d'objets décrivant les caractéristiques du produit associé. Type de données : tableau "productCharacteristic": [ { "name": "String", "previousValue": "String", "value": "String" } ] | | productOrderItem.product.productCharacteristic.name | Nom de l'enregistrement de la caractéristique à associer au produit. Situé dans la table Caractéristique \[sn_prd_pm_characteristic\]. Type de données : chaîne | | productOrderItem.product.productCharacteristic.previousValue | Valeurs d'option de caractéristique précédentes si la mise à jour concerne un ordre de changement. La demande est un ordre de changement si le paramètre est autre que ajouterproductOrderItem.action. Pour plus d'informations sur les valeurs des options de caractéristique, reportez-vous à la section [Create product characteristics and characteristic options](https://www.servicenow.com/docs/access?context=som-product-config-add-characteristics&version=xanadu&pubname=xanadu-order-management&ft:locale=en-US). Type de données : chaîne | | productOrderItem.product.productCharacteristic.value | Valeurs d'option de caractéristique associées au produit. Pour plus d'informations sur les valeurs des options de caractéristique, reportez-vous à la section [Create product characteristics and characteristic options](https://www.servicenow.com/docs/access?context=som-product-config-add-characteristics&version=xanadu&pubname=xanadu-order-management&ft:locale=en-US). Type de données : chaîne | | productOrderItem.product.productSpecification | Description de la spécification du produit associée au produit. Type de données : objet "productSpecification": { "id": "String", "internalVersion": "String", "name": "String", "version": "String", "@type": "String" } | | productOrderItem.product.productSpecification.id | Initial_version ou external_id des spécifications du produit. Le initial_version est le sys_id de la première version de la spécification. Situé dans le champ sys_id ou external_id de la table Spécification de produit \[sn_prd_pm_product_specification\]. Si sys_id et external_id sont présents, le external_id est renvoyé. Type de données : chaîne | | productOrderItem.product.productSpecification.name | Nom de la spécification de produit. Situé dans la table Spécification de produit \[sn_prd_pm_product_specification\]. Type de données : chaîne | | productOrderItem.product.productSpecification.@type | Fait partie de la norme TMF Open API. Cette valeur est toujours ProductSpecificationRef. Ces informations ne sont pas stockées. Type de données : chaîne | | élémentcommandeproduit.produit.relatedparty | Liste des contacts pour les éléments de ligne. Type de données : tableau "relatedParty:" [ { "email": "String", "firstName": "String", "lastName": "String", "phone": "String", "@referredType": "String", "@type": "String" } ] | | productOrderItem.product.relatedParty.email | Adresse e-mail du contact. Type de données : chaîne | | productOrderItem.product.relatedParty.firstName | Prénom de la personne à contacter. Type de données : chaîne | | productOrderItem.product.relatedParty.lastName | Nom de famille du contact. Type de données : chaîne Type de données : chaîne | | productOrderItem.product.relatedParty.phone | Numéro de téléphone professionnel du contact. Type de données : chaîne | | productOrderItem.product.relatedParty.@referredType | Type de client. Valeur possible : OrderLineItemContact Type de données : chaîne | | productOrderItem.product.relatedParty.@type | Fait partie de la norme TMF Open API. Annotation pour le contact de l'élément de ligne de commande. Cette valeur est toujours RelatedParty. Ces informations ne sont pas stockées. Type de données : chaîne | | productOrderItem.product.@type | Fait partie de la norme TMF Open API. Annotation pour le produit. Cette valeur est toujours Produit. Ces informations ne sont pas stockées. Type de données : chaîne | | productOrderItem.productOffering | Description de l'offre de produit associée au produit. Type de données : objet "productOffering": { "id": "String", "internalVersion": "String", "name": "String", "version": "String" } | | productOrderItem.productOffering.id | Initial_version ou external_id de l'offre de produits. Le initial_version est le sys_id de la première version de l'offre. Situé dans le champ sys_id ou external_id de la table Offre de produits \[sn_prd_pm_product_offering\]. Si sys_id et external_id sont présents, le external_id est renvoyé. Type de données : chaîne | | productOrderItem.productOffering.name | Nom de l'offre de produits. Situé dans la table Offre de produits \[sn_prd_pm_product_offering\]. Type de données : chaîne | | productOrderItem.productOrderItemRelationship | Tableau d'objets décrivant les relations entre les éléments de ligne de commande. Type de données : tableau "productOrderItemRelationship": [ { "id": "String", "relationshipType": "String" } ] | | productOrderItem.productOrderItemRelationship.id | Identificateur unique de l'élément de ligne connexe. Situé dans le champ sn_ind_tmt_orm_external_id de la table Élément de ligne de commande \[sn_ind_tmt_orm_order_line_item\]. Type de données : chaîne | | productOrderItem.productOrderItemRelationship.relationshipType | Type de relation entre les deux éléments de ligne. Ces informations sont utilisées pour identifier la hiérarchie des relations. Type de données : chaîne | | productOrderItem.quantity | Nombre des éléments associés à commander. Type de données : nombre | | élémentcommandeproduit.état | État actuel de l'élément de commande de produit. Cette valeur est toujours nouvelle. Type de données : chaîne | | productOrderItem.@type | Fait partie de la norme TMF Open API. Annotation pour le produit. Cette valeur est toujours ProductOrderItem. Ces informations ne sont pas stockées. Type de données : chaîne | | relatedParty | Liste des contacts de la commande. Chaque contact est un objet dans le tableau. Doit énumérer au moins un élément qui contient des informations sur le compte client ou le compte de consommateur. Type de données : tableau "relatedParty": [ { "id": "String", "name": "String", "@referredType": "String", "@type": "String" } ] | | relatedParty.id | Sys_id ou external_id du compte, du contact client ou du consommateur associé à la commande. Situé dans la table Compte \[customer_account\], Contact \[customer_contact\] ou Consommateur \[csm_consumer\]. Type de données : chaîne | | relatedParty.name | Nom du compte, du client ou du consommateur. Type de données : chaîne | | relatedParty.type | Type de client. Valeurs possibles : * Consommateur * Client * Contact du client {#tmf_prod_order-POST-productOrder__ul_lcq_jwm_t4b} Type de données : chaîne | | requestedCompletionDate | Date de livraison demandée par le client. Type de données : chaîne | | Date de début demandée | Date de début de commande demandée par le client. Type de données : chaîne | | État | État actuel de la commande. Pour ce point de terminaison, cette valeur est toujours nouvelle. Type de données : chaîne | | @type | Fait partie de la norme TMF Open API. Annotation pour le produit. Cette valeur est toujours ProductOrder. Ces informations ne sont pas stockées. Type de données : chaîne | [ ] ### Demande cURL L'exemple de code suivant crée une commande client. curl -X POST "https://servicenow-instance/api/sn_ind_tmt_orm/productorder" \ -H "Accept: application/json" \ -H "Content-Type: application/json" \ -u "username":"password" \ -d { "requestedCompletionDate": "2021-05-02T08:13:59.506Z", "requestedStartDate": "2020-05-03T08:13:59.506Z", "externalId": "PO-456", "channel": [ { "id": "2", "name": "Online channel" } ], "note": [ { "text": "This is a TMF product order illustration" }, { "text": "This is a TMF product order illustration no 2" } ], "productOrderItem": [ { "id": "POI100", "quantity": 1, "action": "change", "product": { "id": "fa6d13f45b5620102dff5e92dc81c77f", "@type": "Product", "productSpecification": { "id": "cfe5ef6a53702010cd6dddeeff7b12f6", "name": "SD-WAN Service Package", "@type": "ProductSpecificationRef" }, "place": { "id": "25ab9c4d0a0a0bb300f7dabdc0ca7c1c", "@type": "Place" } }, "productOffering": { "id": "69017a0f536520103b6bddeeff7b127d", "name": "Premium SD-WAN Offering" }, "productOrderItemRelationship": [ { "id": "POI120", "relationshipType": "HasChild" }, { "id": "POI130", "relationshipType": "HasChild" } ], "@type": "ProductOrderItem" }, { "id": "POI120", "quantity": 1, "action": "change", "itemPrice": [ { "priceType": "recurring", "recurringChargePeriod": "month", "price": { "taxIncludedAmount": { "unit": "USD", "value": 20 } } } ], "product": { "id": "766d13f45b5620102dff5e92dc81c78a", "@type": "Product", "productCharacteristic": [ { "name": "WAN Optimization", "value": "Base", "previousValue": "Advance" } ], "productSpecification": { "id": "39b627aa53702010cd6dddeeff7b1202", "name": "SD-WAN Edge Device", "@type": "ProductSpecificationRef" }, "relatedParty": [ { "id": "51670151c35420105252716b7d40ddfe", "firstName": "Joe", "lastName": "Doe", "email": "abc@example.com", "phone": "1234567890", "@type": "RelatedParty", "@referredType": "OrderLineItemContact" } ], "place": { "id": "25ab9c4d0a0a0bb300f7dabdc0ca7c1c", "@type": "Place" } }, "productOffering": { "id": "69017a0f536520103b6bddeeff7b127d", "name": "Premium SD-WAN Offering" }, "productOrderItemRelationship": [ { "id": "POI100", "relationshipType": "HasParent" } ], "@type": "ProductOrderItem" }, { "id": "POI130", "quantity": 1, "action": "add", "itemPrice": [ { "priceType": "recurring", "recurringChargePeriod": "month", "price": { "taxIncludedAmount": { "unit": "USD", "value": 20 } } } ], "product": { "@type": "Product", "productCharacteristic": [ { "name": "Security Type", "value": "Base", "previousValue": "Advance" } ], "productSpecification": { "id": "a6514bd3534560102f18ddeeff7b1247", "name": "SD-WAN Security", "@type": "ProductSpecificationRef" }, "relatedParty": [ { "id": "51670151c35420105252716b7d40ddfe", "firstName": "Joe", "lastName": "Doe", "email": "abc@example.com", "phone": "1234567890", "@type": "RelatedParty", "@referredType": "OrderLineItemContact" } ], "place": { "id": "25ab9c4d0a0a0bb300f7dabdc0ca7c1c", "@type": "Place" } }, "productOffering": { "id": "69017a0f536520103b6bddeeff7b127d", "name": "Premium SD-WAN Offering" }, "productOrderItemRelationship": [ { "id": "POI100", "relationshipType": "HasParent" } ], "@type": "ProductOrderItem" } ], "relatedParty": [ { "id": "eaf68911c35420105252716b7d40ddde", "name": "Sally Thomas", "@type": "RelatedParty", "@referredType": "CustomerContact" }, { "id": "ffc68911c35420105252716b7d40dd55", "name": "Funco Intl", "@type": "RelatedParty", "@referredType": "Customer" }, { "id": "59f16de1c3b67110ff00ed23a140dd9e", "name": "Funco External", "@type": "RelatedParty", "@referredType": "Consumer" } ], "@type": "ProductOrder" } Corps de réponse. { "requestedCompletionDate": "2021-05-02T08:13:59.506Z", "requestedStartDate": "2020-05-03T08:13:59.506Z", "externalId": "PO-456", "channel": [ { "id": "2", "name": "Online chanel" } ], "note": [ { "text": "This is a TMF product order illustration" }, { "text": "This is a TMF product order illustration no 2" } ], "productOrderItem": [ { "id": "POI100", "quantity": 1, "action": "change", "product": { "id": "fa6d13f45b5620102dff5e92dc81c77f", "@type": "Product", "productSpecification": { "id": "cfe5ef6a53702010cd6dddeeff7b12f6", "name": "SD-WAN Service Package", "@type": "ProductSpecificationRef" }, "place": { "id": "25ab9c4d0a0a0bb300f7dabdc0ca7c1c", "@type": "Place" } }, "productOffering": { "id": "69017a0f536520103b6bddeeff7b127d", "name": "Premium SD-WAN Offering" }, "productOrderItemRelationship": [ { "id": "POI120", "relationshipType": "HasChild" }, { "id": "POI130", "relationshipType": "HasChild" } ], "@type": "ProductOrderItem", "state": "new" }, { "id": "POI120", "quantity": 1, "action": "change", "itemPrice": [ { "priceType": "recurring", "recurringChargePeriod": "month", "price": { "taxIncludedAmount": { "unit": "USD", "value": 20 } } } ], "product": { "id": "766d13f45b5620102dff5e92dc81c78a", "@type": "Product", "productCharacteristic": [ { "name": "WAN Optimization", "value": "Base", "previousValue": "Advance" } ], "productSpecification": { "id": "39b627aa53702010cd6dddeeff7b1202", "name": "SD-WAN Edge Device", "@type": "ProductSpecificationRef" }, "relatedParty": [ { "id": "51670151c35420105252716b7d40ddfe", "firstName": "Joe", "lastName": "Doe", "email": "abc@example.com", "phone": "1234567890", "@type": "RelatedParty", "@referredType": "OrderLineItemContact" } ], "place": { "id": "25ab9c4d0a0a0bb300f7dabdc0ca7c1c", "@type": "Place" } }, "productOffering": { "id": "69017a0f536520103b6bddeeff7b127d", "name": "Premium SD-WAN Offering" }, "productOrderItemRelationship": [ { "id": "POI100", "relationshipType": "HasParent" } ], "@type": "ProductOrderItem", "state": "new" }, { "id": "POI130", "quantity": 1, "action": "add", "itemPrice": [ { "priceType": "recurring", "recurringChargePeriod": "month", "price": { "taxIncludedAmount": { "unit": "USD", "value": 20 } } } ], "product": { "@type": "Product", "productCharacteristic": [ { "name": "Security Type", "value": "Base", "previousValue": "Advance" } ], "productSpecification": { "id": "a6514bd3534560102f18ddeeff7b1247", "name": "SD-WAN Security", "@type": "ProductSpecificationRef" }, "relatedParty": [ { "id": "51670151c35420105252716b7d40ddfe", "firstName": "Joe", "lastName": "Doe", "email": "abc@example.com", "phone": "1234567890", "@type": "RelatedParty", "@referredType": "OrderLineItemContact" } ], "place": { "id": "25ab9c4d0a0a0bb300f7dabdc0ca7c1c", "@type": "Place" } }, "productOffering": { "id": "69017a0f536520103b6bddeeff7b127d", "name": "Premium SD-WAN Offering" }, "productOrderItemRelationship": [ { "id": "POI100", "relationshipType": "HasParent" } ], "@type": "ProductOrderItem", "state": "new" } ], "relatedParty": [ { "id": "eaf68911c35420105252716b7d40ddde", "name": "Sally Thomas", "@type": "RelatedParty", "@referredType": "CustomerContact" }, { "id": "ffc68911c35420105252716b7d40dd55", "name": "Funco Intl", "@type": "RelatedParty", "@referredType": "Customer" }, { "id": "59f16de1c3b67110ff00ed23a140dd9e", "name": "Funco External", "@type": "RelatedParty", "@referredType": "Consumer" } ], "@type": "ProductOrder", "id": "6be0a925c3a220103e2e73ce3640ddfe", "state": "new" }