--- 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 service : API ouverte # Commande de service : API ouverte {#ariaid-title1} * Rversion finale: Xanadu * * Mis à jour 1 août 2024 * * ![](https://www.servicenow.com/docs/portal-asset/ico-clock) 69 minutes de lecture L'API ouverte de commande de service fournit un point de terminaison qui active un mécanisme standardisé pour passer des commandes de services. Cette API est une ServiceNow® implémentation de la spécification de l'API Open API TMForum TMForum TMF641 Service Ordering Management. Pour accéder à cette API, le module d'extension Gestion des commandes pour Telecommunications (sn_ind_tmt_orm) doit être activé. Pour plus d'informations, consultez . Pour en savoir plus sur les tables, les entités et les relations, reportez-vous Gestion des commandes à la section [Order Management data model](https://www.servicenow.com/docs/access?context=order-mgt-order-data-model&version=xanadu&pubname=xanadu-order-management&ft:locale=en-US). Cette API est fournie dans l'espace de noms `sn_tmf_api` . 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 les commandes de service](https://servicenow-prod.fluidtopics.net/1wg5ERk1kjnq7Lxy_GcPFA#service-order_dev-guide "Utilisez l’API ouverte de commande de service pour créer, mettre à jour et récupérer des informations de commande de service."). ## API ouverte de commande de service : GET /sn_tmf_api/order/serviceOrder {#ariaid-title2} Récupère toutes les commandes de service. Cette API récupère les informations sur la commande de service à partir des tables connexes suivantes : * Ordre \[sn_ind_tmt_orm_order\] * Valeur caractéristique de la 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\] {#serviceorder-GET__ul_lxc_kxm_t4b} ### Format d'URL /api/sn_tmf_api/order/serviceOrder ### Paramètres de demande pris en charge {#serviceorder-GET__table_ofr_vgy_fsb__entry__2} | Nom | Description | |-|-| | Aucun | | [Tableau 1. Paramètres de chemin d'accès] {#serviceorder-GET__table_ofr_vgy_fsb} {#serviceorder-GET__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 2. Paramètres de requête] {#serviceorder-GET__table_pfr_vgy_fsb} {#serviceorder-GET__table_xcm_cvr_nsb__entry__2} | Nom | Description | |-|-| | Aucun | | [Tableau 3. Paramètres du corps de la demande (JSON)] {#serviceorder-GET__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."). {#serviceorder-GET__table_kqy_wgy_fsb__entry__2} | En-tête | Description | |-|-| | Aucun | | [Tableau 4. En-têtes de demandes] {#serviceorder-GET__table_kqy_wgy_fsb} {#serviceorder-GET__table_h4r_fxr_nsb__entry__2}{#serviceorder-GET__content-range-row}{#serviceorder-GET__content-type-row}{#serviceorder-GET__links-pagination-row}{#serviceorder-GET__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 {#serviceorder-GET__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] {#serviceorder-GET__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."). {#serviceorder-GET__table_abf_sn5_4sb__entry__2}{#serviceorder-GET__tmf-get-status-200-p}{#serviceorder-GET__tmf-get-status-206-entry}{#serviceorder-GET__tmf-get-status-400-entry}{#serviceorder-GET__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 {#serviceorder-GET__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] {#serviceorder-GET__table_abf_sn5_4sb} ### Paramètres de corps de réponse (JSON) {#serviceorder-GET__section_ilb_1qx_kqb} {#serviceorder-GET__table_jlb_1qx_kqb__entry__2}{#serviceorder-GET__type-entry-tmf641} | Nom | Description | |-|-| | 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 doit être terminée. Type de données : chaîne | | href | Un lien relatif vers l'enregistrement de ressource. Type de données : chaîne Par défaut : chaîne vide | | id | Sys_id de la commande de service demandé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 | | orderDate | La date et l'horodatage de la commande. Format : JJ-MM-AAAA HH :MM :SS Type de données : chaîne Par défaut : chaîne vide | | 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. La commande ne peut pas être modifiée ou annulée pendant que l'exécution est en cours. * false : le point de non-retour de la commande n'a pas été atteint. La commande peut être modifiée ou annulée. {#serviceorder-GET__d7857e218}Type de données : booléennes | | relatedParty | Liste des contacts de la commande. Chaque contact est un objet dans le tableau. 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 {#serviceorder-GET__ul_oc5_dc2_hqb} Type de données : chaîne | | 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 | | 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 | | Élément de commande de service | Tableau d'objets décrivant les éléments de ligne dans la commande de service et leur action associée. "serviceOrderItem:" [ { "action": "String", "actionReason": "String", "committedDueDate": "String", "externalProductInventory": [Array], "id": "String", "orderRelationship": [Array], "quantity": "Number", "place": {Object}, "ponr": Boolean, "relatedParty": {Object}, "service": {Object}, "state": "String", "@type": "String", "version": "String" } ] Type de données : tableau | | serviceOrderItem.action | Action à effectuer sur l'élément de commande de service. Les actions possibles sont définies dans l'onglet Liste de choix du champ Entrée du dictionnaire d'actions de la table sn_ind_tmt_orm_order_line_item. Pour plus de détails, voir [Action types for customer and service orders](https://www.servicenow.com/docs/access?context=order-mgt-customer-order-types&version=xanadu&pubname=xanadu-order-management&ft:locale=en-US). Type de données : chaîne | | serviceOrderItem.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 | | serviceOrderItem.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 | | serviceOrderItem.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" } ] | | serviceOrderItem.externalProductInventory.externalProductInventoryId | ID externe mappé à l'inventaire des produits. Type de données : chaîne | | serviceOrderItem.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 | | serviceOrderItem.orderRelationship | Tableau d'objets décrivant les relations entre les éléments de ligne de commande. Type de données : tableau "orderRelationship:" [ { "id": "String", "relationshipType": "String" } ] | | serviceOrderItem.orderRelationship.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 | | serviceOrderItem.orderRelationship.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 {#serviceorder-GET__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 | | serviceOrderItem.quantity | Nombre d'éléments de ligne commandés. Type de données : nombre | | serviceOrderItem.place | Carte des emplacements sur lesquels installer le service. Type de données : objet "place:" { "id": "String", "@type": "String" } | | serviceOrderItem.place.id | Sys_id de l'enregistrement de l'emplacement associé dans la table Emplacement \[cmn_location\]. Type de données : chaîne | | serviceOrderItem.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 | | serviceOrderItem.ponr | Marqueur indiquant si le point de non retour de l'élément de ligne de commande a été atteint. Valeurs valides : * true : le point de non retour de l'élément de ligne de commande a été atteint. L'élément de ligne de commande ne peut pas être modifié ou annulé pendant que l'exécution est en cours. * faux : le point de non retour de l'élément de ligne de commande n'a pas été atteint. L'élément de ligne de commande peut être modifié ou annulé. {#serviceorder-GET__ul_asm_252_gqb}Type de données : booléennes | | serviceOrderItem.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" } ] | | serviceOrderItem.relatedParty.email | Adresse e-mail du contact. Type de données : chaîne | | serviceOrderItem.relatedParty.firstName | Prénom de la personne à contacter. Type de données : chaîne | | serviceOrderItem.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 | | serviceOrderItem.relatedParty.lastName | Nom de famille du contact. Type de données : chaîne | | serviceOrderItem.relatedParty.phone | Numéro de téléphone professionnel du contact. Type de données : chaîne | | serviceOrderItem.relatedParty.@referredType | Requis. Type de client. Valeur possible : OrderLineItemContact Type de données : chaîne | | serviceOrderItem.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 | | serviceOrderItem.service | Description des détails de l'instance du service acheté par le client. Type de données : objet "service:" { "serviceCharacteristic": [Array], "serviceRelationship": [Array], "serviceSpecification": {Object}, "serviceType": "String", "state": "String", "@type": "String" } | | serviceOrderItem.service.serviceCharacteristic | Liste décrivant les caractéristiques du service associé. Seules les caractéristiques de service avec un courant value différent de celui previousValue sont renvoyées. Type de données : tableau d'objets "serviceCharacteristic:" [ { "name": "String", "previousValue": "String", "value": "String", "valueType": "String" } ] | | serviceOrderItem.service.serviceCharacteristic.value | Valeurs d'option de caractéristique associées au service. 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 | | serviceOrderItem.service.serviceCharacteristic.valueType | Type de valeur caractéristique. Type de données : chaîne | | serviceOrderItem.service.serviceRelationship | Liste des inventaires de produits liés au service. Type de données : tableau "serviceRelationship": [ { "id": "String", "relationshipType": "String" } ] | | serviceOrderItem.service.serviceRelationship.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 | | serviceOrderItem.service.serviceRelationship.relationshipType | Type de relation entre le service et l'inventaire des produits. Valeur possible : nécessite Type de données : chaîne | | serviceOrderItem.service.serviceSpecification | Description de la spécification de service associée au service. Type de données : objet "serviceSpecification:" { "id": "String", "internalId": "String", "internalVersion": "String", "name": "String", "version": "String", "@type": "String" } | | serviceOrderItem.service.serviceSpecification.id | Initial_version ou external_id de la spécification de service. 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 service \[sn_prd_pm_service_specification\]. Type de données : chaîne | | serviceOrderItem.service.serviceSpecification.internalId | Initial_version de la spécification de service. Le initial_version est le sys_id de la première version de la spécification. Situé dans la table Spécification de service \[sn_prd_pm_service_specification\]. Type de données : chaîne | | serviceOrderItem.service.serviceSpecification.internalVersion | Version de la spécification de service. Situé dans la table Spécification de service \[sn_prd_pm_service_specification\]. Type de données : chaîne | | serviceOrderItem.service.serviceSpecification.name | Nom de la spécification de service. Situé dans la table Spécification de service \[sn_prd_pm_service_specification\]. Type de données : chaîne | | serviceOrderItem.service.serviceSpecification.version | External_version de la spécification de service. Situé dans la table Spécification de service \[sn_prd_pm_service_specification\]. Type de données : chaîne | | serviceOrderItem.service.serviceSpecification.@type | Fait partie de la norme TMF Open API. Cette valeur est toujours ServiceSpecificationRef. Ces informations ne sont pas stockées. Type de données : chaîne | | serviceOrderItem.service.serviceType | Type de service. Type de données : chaîne | | serviceOrderItem.service.state | État du produit vendu. Par exemple, nouveau. Type de données : chaîne | | serviceOrderItem.state | État de l'élément de commande de service. Par exemple, nouveau. Type de données : chaîne | | serviceOrderItem.version | Version d'élément de ligne de commande de service. Type de données : chaîne | | serviceOrderItem.@type | Fait partie de la norme TMF Open API. Cette valeur est toujours ServiceOrderItem. Ces informations ne sont pas stockées. Type de données : chaîne | | État | État de la commande de service. Pour plus d'informations, consultez. Type de données : chaîne | | @type | Fait partie de la norme TMF Open API. Cette valeur est toujours ServiceOrder. Ces informations ne sont pas stockées. Type de données : chaîne | [ ] {#serviceorder-GET__table_jlb_1qx_kqb} ### Demande cURL Cet exemple récupère toutes les commandes de service. curl --location --request GET 'http://instance.service-now.com/api/sn_tmf_api/order/serviceOrder' \ --user 'username':'password' Corps de réponse. [ { "id": "bd30366ec3a83010abc8b5183c40dd92", "ponr": "true", "href": "/api/sn_tmf_api/order/serviceOrder/bd30366ec3a83010abc8b5183c40dd92", "completionDate": "2021-06-07T21:52:12.000Z", "expectedCompletionDate": "2018-01-14T20:07:40.000Z", "orderDate": "2021-06-08T05:34:59.000Z", "requestedCompletionDate": "2018-01-14T20:07:40.000Z", "requestedStartDate": "2018-01-14T20:07:40.000Z", "serviceOrderItem": [ { "id": "100", "ponr": "true", "quantity": 1, "action": "add", "service": { "@type": "Service", "id": "4b5072aec3a83010abc8b5183c40dd42", "state": "active", "serviceType": "cfs", "serviceCharacteristic": [ { "name": "Firewall coverage", "valueType": "choice", "value": "Premium(Up to 50 sites)\n\t\t", "previousValue": "" }, { "name": "Firewall Security", "valueType": "choice", "value": "Premium", "previousValue": "" }, { "name": "CPE Type", "valueType": "choice", "value": "Physical", "previousValue": "" }, { "name": "Administration Support", "valueType": "choice", "value": "Basic( Customer Managed)\n\t\t", "previousValue": "" } ], "serviceSpecification": { "id": "f99546ff07266010a7955b7e0ad300a8", "name": "Managed Firewall Service", "version": "", "internalVersion": "1", "internalId": "f99546ff07266010a7955b7e0ad300a8", "@type": "ServiceSpecificationRef" } }, "place": { "id": "920cf6ac73d423002728660c4cf6a799", "@type": "Place" }, "state": "completed", "version": "2", "@type": "ServiceOrderItem" } ], "relatedParty": [ { "id": "ffc68911c35420105252716b7d40dd55", "name": "Funco Intl", "@type": "RelatedParty", "@referredType": "Customer" }, { "id": "eaf68911c35420105252716b7d40ddde", "name": "Sally Thomas", "@type": "RelatedParty", "@referredType": "CustomerContact" } ], "state": "completed", "version": "2", "@type": "ServiceOrder" } ] ## API ouverte de commande de service : GET /sn_tmf_api/order/serviceOrder/{id} {#ariaid-title3} Récupère une commande de service spécifiée. Cette API récupère les informations sur la commande de service à partir des tables connexes suivantes : * Ordre \[sn_ind_tmt_orm_order\] * Élément de ligne de commande \[sn_ind_tmt_orm_order_line_item\] * Valeur caractéristique de la 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\] {#serviceorder-GET-id__ul_lxc_kxm_t4b} ### Format d'URL /api/sn_tmf_api/order/serviceOrder/{id} ### Paramètres de demande pris en charge {#serviceorder-GET-id__entry__2} | Nom | Description | |-|-| | id | Sys_id de l'ordre de service à récupérer. Situé dans la table Ordre \[sn_ind_tmt_orm_order\]. Type de données : chaîne | [Tableau 7. Paramètres de chemin d'accès] {#serviceorder-GET-id__entry__6} | Nom | Description | |-|-| | Aucun | | [Tableau 8. Paramètres de requête] {#serviceorder-GET-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."). {#serviceorder-GET-id__table_ed2_jl5_4sb__entry__2} | En-tête | Description | |-|-| | Aucun | | [Tableau 10. En-têtes de demandes] {#serviceorder-GET-id__table_ed2_jl5_4sb} {#serviceorder-GET-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] {#serviceorder-GET-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."). {#serviceorder-GET-id__table_n5s_hjm_gqb__entry__2}{#serviceorder-GET-id__entry-404-status-code} | 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": "/" } ] } {#serviceorder-GET-id__ul_kdw_y4w_fwb} | | 400 | Demande incorrecte. Raisons possibles : * Paramètre de requête manquant * URI non valide {#serviceorder-GET-id__ul_o5s_hjm_gqb} | | 404 | Introuvable. L'élément demandé est introuvable. | [Tableau 12. Codes d'état] {#serviceorder-GET-id__table_n5s_hjm_gqb} ### Paramètres de corps de réponse (JSON) {#serviceorder-GET-id__section_ilb_1qx_kqb} {#serviceorder-GET-id__table_jlb_1qx_kqb__entry__2}{#serviceorder-GET-id__type-entry-tmf641} | Nom | Description | |-|-| | 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 doit être terminée. Type de données : chaîne | | id | Sys_id de la commande de service demandée. Type de données : chaîne | | 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 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 | | orderDate | La date et l'horodatage de la commande. Format : JJ-MM-AAAA HH :MM :SS Type de données : chaîne Par défaut : chaîne vide | | 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. La commande ne peut pas être modifiée ou annulée pendant que l'exécution est en cours. * false : le point de non-retour de la commande n'a pas été atteint. La commande peut être modifiée ou annulée. {#serviceorder-GET-id__d7857e218}Type de données : booléennes | | relatedParty | Liste des contacts de la commande. Chaque contact est un objet dans le tableau. 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 {#serviceorder-GET-id__ul_oc5_dc2_hqb} Type de données : chaîne | | 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 | | 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 | | Élément de commande de service | Tableau d'objets décrivant les éléments de ligne dans la commande de service et leur action associée. Type de données : tableau "serviceOrderItem:" [ { "action": "String", "actionReason": "String", "committedDueDate": "String", "externalProductInventory": [Array], "id": "String", "orderRelationship": [Array], "quantity": "Number", "place": {Object}, "ponr": Boolean, "relatedParty": {Object}, "service": {Object}, "state": "String", "@type": "String", "version": "String" } ] | | serviceOrderItem.action | Action à effectuer sur l'élément de commande de service. Les actions possibles sont définies dans l'onglet Liste de choix du champ Entrée du dictionnaire d'actions de la table sn_ind_tmt_orm_order_line_item. Pour plus d'informations, voir [Action types for customer and service orders](https://www.servicenow.com/docs/access?context=order-mgt-customer-order-types&version=xanadu&pubname=xanadu-order-management&ft:locale=en-US) Type de données : chaîne | | serviceOrderItem.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 | | serviceOrderItem.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 | | serviceOrderItem.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" } ] | | serviceOrderItem.externalProductInventory.externalProductInventoryId | ID externe mappé à l'inventaire des produits. Type de données : chaîne | | serviceOrderItem.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 | | serviceOrderItem.orderRelationship | Tableau d'objets décrivant les relations entre les éléments de ligne de commande. Type de données : tableau "orderRelationship:" [ { "id": "String", "relationshipType": "String" } ] | | serviceOrderItem.orderRelationship.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 | | serviceOrderItem.orderRelationship.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 {#serviceorder-GET-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 | | serviceOrderItem.quantity | Nombre d'éléments de ligne commandés. Type de données : nombre | | serviceOrderItem.place | Carte des emplacements sur lesquels installer le service. Type de données : objet "place:" { "id": "String", "@type": "String" } | | serviceOrderItem.place.id | Sys_id de l'enregistrement de l'emplacement associé dans la table Emplacement \[cmn_location\]. Type de données : chaîne | | serviceOrderItem.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 | | serviceOrderItem.ponr | Marqueur indiquant si le point de non retour de l'élément de ligne de commande a été atteint. Valeurs valides : * true : le point de non retour de l'élément de ligne de commande a été atteint. L'élément de ligne de commande ne peut pas être modifié ou annulé pendant que l'exécution est en cours. * faux : le point de non retour de l'élément de ligne de commande n'a pas été atteint. L'élément de ligne de commande peut être modifié ou annulé. {#serviceorder-GET-id__ul_asm_252_gqb}Type de données : booléennes | | serviceOrderItem.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" } | | serviceOrderItem.relatedParty.email | Adresse e-mail du contact. Type de données : chaîne | | serviceOrderItem.relatedParty.firstName | Prénom de la personne à contacter. Type de données : chaîne | | serviceOrderItem.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 | | serviceOrderItem.relatedParty.lastName | Nom de famille du contact. Type de données : chaîne | | serviceOrderItem.relatedParty.phone | Numéro de téléphone professionnel du contact. Type de données : chaîne | | serviceOrderItem.relatedParty.@referredType | Requis. Type de client. Valeur possible : OrderLineItemContact Type de données : chaîne | | serviceOrderItem.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 | | serviceOrderItem.service | Description des détails de l'instance du service acheté par le client. "service:" { "serviceCharacteristic": [Array], "serviceRelationship": [Array], "serviceSpecification": {Object}, "serviceType": "String", "state": "String", "@type": "String" } Type de données : objet | | serviceOrderItem.service.serviceCharacteristic | Liste décrivant les caractéristiques du service associé. Seules les caractéristiques de service avec un courant value différent de celui previousValue sont renvoyées. Type de données : tableau "serviceCharacteristic:" [ { "name": "String", "previousValue": "String", "value": "String", "valueType": "String" } ] | | serviceOrderItem.service.serviceCharacteristic.value | Valeurs d'option de caractéristique associées au service. 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 | | serviceOrderItem.service.serviceCharacteristic.valueType | Type de valeur caractéristique. Type de données : chaîne | | serviceOrderItem.service.serviceRelationship | Liste des inventaires de produits liés au service. Type de données : tableau "serviceRelationship": [ { "id": "String", "relationshipType": "String" } ] | | serviceOrderItem.service.serviceRelationship.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 | | serviceOrderItem.service.serviceRelationship.relationshipType | Type de relation entre le service et l'inventaire des produits. Valeur possible : nécessite Type de données : chaîne | | serviceOrderItem.service.serviceSpecification | Description de la spécification de service associée au service. Type de données : objet "serviceSpecification:" { "id": "String", "internalId": "String", "internalVersion": "String", "name": "String", "version": "String", "@type": "String" } | | serviceOrderItem.service.serviceSpecification.id | Initial_version ou external_id de la spécification de service. 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 service \[sn_prd_pm_service_specification\]. Type de données : chaîne | | serviceOrderItem.service.serviceSpecification.internalId | Initial_version de la spécification de service. Le initial_version est le sys_id de la première version de la spécification. Situé dans la table Spécification de service \[sn_prd_pm_service_specification\]. Type de données : chaîne | | serviceOrderItem.service.serviceSpecification.internalVersion | Version de la spécification de service. Situé dans la table Spécification de service \[sn_prd_pm_service_specification\]. Type de données : chaîne | | serviceOrderItem.service.serviceSpecification.name | Nom de la spécification de service. Situé dans la table Spécification de service \[sn_prd_pm_service_specification\]. Type de données : chaîne | | serviceOrderItem.service.serviceSpecification.version | External_version de la spécification de service. Situé dans la table Spécification de service \[sn_prd_pm_service_specification\]. Type de données : chaîne | | serviceOrderItem.service.serviceSpecification.@type | Fait partie de la norme TMF Open API. Cette valeur est toujours ServiceSpecificationRef. Ces informations ne sont pas stockées. Type de données : chaîne | | serviceOrderItem.service.serviceType | Type de service. Type de données : chaîne | | serviceOrderItem.service.state | État du produit vendu. Par exemple, nouveau. Type de données : chaîne | | serviceOrderItem.state | État de l'élément de commande de service. Par exemple, nouveau. Type de données : chaîne | | serviceOrderItem.version | Version d'élément de ligne de commande de service. Type de données : chaîne | | serviceOrderItem.@type | Fait partie de la norme TMF Open API. Cette valeur est toujours ServiceOrderItem. Ces informations ne sont pas stockées. Type de données : chaîne | | État | État de la commande de service. Pour plus d'informations, consultez. Type de données : chaîne | | @type | Fait partie de la norme TMF Open API. Cette valeur est toujours ServiceOrder. Ces informations ne sont pas stockées. Type de données : chaîne | [ ] {#serviceorder-GET-id__table_jlb_1qx_kqb} ### Demande cURL L'exemple suivant récupère une commande de service spécifiée. curl "https://instance.service-now.com/api/sn_tmf_api/order/serviceOrder/4f2af65ac3a030106e2473ce3640ddcf" \ --request GET \ --user 'username':'password' Corps de réponse. { "id": "4f2af65ac3a030106e2473ce3640ddcf", "ponr": "false", "expectedCompletionDate": "2018-01-15T09:37:40.000Z", "requestedCompletionDate": "2018-01-15T09:37:40.000Z", "requestedStartDate": "2018-01-15T09:37:40.000Z", "note": [ { "author": "System Administrator", "date": "2021-06-07T14:53:04.000Z", "text": "This is a TMF service order illustration no 2" }, { "author": "System Administrator", "date": "2021-06-07T14:53:03.000Z", "text": "This is a TMF service order illustration" } ], "serviceOrderItem": [ { "id": "100", "ponr": "false", "action": "add", "actionReason": "adding service package OLI", "quantity": 1, "service": { "@type": "Service", "state": "", "serviceType": "cfs", "serviceCharacteristic": [ { "name": "Firewall coverage", "valueType": "choice", "value": "Premium (Up to 50 sites)", "previousValue": "" }, { "name": "Firewall Security", "valueType": "choice", "value": "Standard", "previousValue": "" }, { "name": "Administration Support", "valueType": "choice", "value": "Basic (Customer Managed)", "previousValue": "" } ], "serviceRelationship": [ { "id": "326d13f45b5620102dff5e92dc81c785", "relationshipType": "Requires" } ], "serviceSpecification": { "id": "f99546ff07266010a7955b7e0ad300a8", "name": "Managed Firewall Service", "version": "v2", "internalVersion": "2", "internalId": "f99546ff07266010a7955b7e0ad300a8", "@type": "ServiceSpecificationRef" } }, "place": { "id": "920cf6ac73d423002728660c4cf6a799", "@type": "Place" }, "relatedParty": [ { "id": "972af65ac3a030106e2473ce3640ddda", "firstName": "Mike", "lastName": "Hudson", "email": "mike@example.com", "phone": "1234567890", "@type": "RelatedParty", "@referredType": "OrderLineItemContact" } ], "state": "new", "version": "1", "@type": "ServiceOrderItem" } ], "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": "new", "version": "1", "@type": "ServiceOrder" "href": "/api/sn_tmf_api/order/serviceOrder/4f2af65ac3a030106e2473ce3640ddcfç", "orderDate": "2021-06-08T05:34:59.000Z", } ## API ouverte de commande de service : PATCH /sn_tmf_api/order/serviceOrder/{id} {#ariaid-title4} Met à jour la commande de service spécifiée. ### Format d'URL URL par défaut : /api/sn_tmf_api/order/serviceOrder/{id} ### Paramètres de demande pris en charge {#serviceorder-PATCH-serviceOrder-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 13. Paramètres de chemin d'accès] {#serviceorder-PATCH-serviceOrder-id__entry__6} | Nom | Description | |-|-| | Aucun | | [Tableau 14. Paramètres de requête] {#serviceorder-PATCH-serviceOrder-id__table_m32_1l1_hwb__entry__2}{#serviceorder-PATCH-serviceOrder-id__svcOrdItem-ph-tmf641-externalid}{#serviceorder-PATCH-serviceOrder-id__note-ph-tmf622}{#serviceorder-PATCH-serviceOrder-id__note_text-ph-tmf622}{#serviceorder-PATCH-serviceOrder-id__requestedCompletionDate-ph-tmf622}{#serviceorder-PATCH-serviceOrder-id__reqStartDate-ph-tmf622}{#serviceorder-PATCH-serviceOrder-id__svcOrdItem-ph-tmf641}{#serviceorder-PATCH-serviceOrder-id__service_id-ph-tmf641}{#serviceorder-PATCH-serviceOrder-id__svcOrderItemRel_id-ph-tmf641}{#serviceorder-PATCH-serviceOrder-id__productOrderItemRelationship_relType-row-tmf622}{#serviceorder-PATCH-serviceOrder-id__service-s-tmf641} | Nom | Description | |-|-| | 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 | Numéro de commande unique pour l'ordre de service externe. Type de données : chaîne Table/champ mis à jour : sn_ind_tmt_orm_order | | note | Tableau d'objets qui décrivent les notes supplémentaires prises par le client lors de la commande. Type de données : tableau{#serviceorder-PATCH-serviceOrder-id__note_data_type-p-tmf622} "note": [ { "text": "String" } ] {#serviceorder-PATCH-serviceOrder-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{#serviceorder-PATCH-serviceOrder-id__note_text_data_type-p-tmf622} Table/champ mis à jour : sn_ind_tmt_orm_order/commentaires Par défaut : chaîne vide | | relatedParty | Liste des contacts de la commande. Chaque contact est un objet dans le tableau. La demande 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 | Requis. Sys_id ou external_id du compte, du contact client ou du consommateur associé à la commande. Situé dans la table Compte \[customer_account\], la table Contact \[customer_contact\] ou la table Consommateur \[csm_consumer\]. Type de données : chaîne Table mise à jour : sn_ind_tmt_orm_order | | 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 {#serviceorder-PATCH-serviceOrder-id__ul_cdn_ddp_kqb} Type de données : chaîne | | 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 | | requestedCompletionDate | Date de livraison demandée par le client. Type de données : chaîne{#serviceorder-PATCH-serviceOrder-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{#serviceorder-PATCH-serviceOrder-id__reqStartDate_data_type-p-tmf622} Table/champ mis à jour : sn_ind_tmt_orm_order/expected_start_date Par défaut : chaîne vide | | Élément de commande de service | Requis. Tableau d'objets décrivant les éléments de ligne dans la commande de service et leur action associée. Type de données : tableau{#serviceorder-PATCH-serviceOrder-id__svcOrdItem_data_type-p-tmf641} "serviceOrderItem:" [ { "action": "String", "actionReason": "String", "committedDueDate": "String", "externalProductInventory": [Array], "id": "String", "orderRelationship": [Array], "place": {Object}, "quantity": "Number", "relatedParty": {Object}, "service": {Object}, "@type": "String", "version": "String" } ] {#serviceorder-PATCH-serviceOrder-id__svcOrdItem-codeblock-tmf641} Table/champ mis à jour : sn_ind_tmt_orm_order_line_item | | serviceOrderItem.action | Requis. Action à effectuer sur l'élément de commande de service. Les actions possibles sont définies dans l'onglet Liste de choix du champ 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 {#serviceorder-PATCH-serviceOrder-id__ul_grg_vgl_gqb}Pour plus de détails, voir [Action types for customer and service orders](https://www.servicenow.com/docs/access?context=order-mgt-customer-order-types&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_line_item/action | | serviceOrderItem.actionReason | Facultatif. Description du motif de l'élément de ligne. Type de données : chaîne Table/champ mis à jour : table/action_reason de l'élément de ligne de commande \[sn_ind_tmt_orm_order_line_item\]. | | serviceOrderItem.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 | | serviceOrderItem.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. | | serviceOrderItem.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 | | serviceOrderItem.id | Requis. 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 Table/champ mis à jour : sn_ind_tmt_orm_order_line_item/external_id | | serviceOrderItem.orderRelationship | Requis. Tableau d'objets décrivant les relations entre les éléments de ligne de commande. Type de données : tableau "orderRelationship:" [ { "id": "String", "relationshipType": "String" } ] {#serviceorder-PATCH-serviceOrder-id__svcOrderItemRel-codeblock} Table/champ mis à jour : sn_ind_tmt_orm_order_line_item | | serviceOrderItem.orderRelationship.id | Requis. 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 Table/champ mis à jour : sn_ind_tmt_orm_order_line_item/parent_line_item ou sn_ind_tmt_orm_order_line_related_items/related_order_line_item | | serviceOrderItem.orderRelationship.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) * Exige {#serviceorder-PATCH-serviceOrder-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 | | serviceOrderItem.place | Carte des emplacements sur lesquels installer le service. Type de données : objet "place:" { "id": "String", "@type": "String" } | | serviceOrderItem.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 | | serviceOrderItem.place.@type | Fait partie de la norme TMF Open API. Annotation pour le lieu de l'élément de ligne de commande. Type de données : chaîne | | serviceOrderItem.quantity | Définit le nombre d'éléments de ligne à commander. Cette propriété s'applique uniquement lors de l'ajout d'une commande de service ; c'est-à-dire que la valeur de la action propriété est `additionnée`. Type de données : nombre Par défaut : chaîne vide Table/champ mis à jour : sn_ind_tmt_orm_order/quantité | | serviceOrderItem.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" } | | serviceOrderItem.relatedParty.email | Adresse e-mail du contact. Type de données : chaîne | | serviceOrderItem.relatedParty.firstName | Prénom de la personne à contacter. Type de données : chaîne | | serviceOrderItem.relatedParty.lastName | Nom de famille du contact. Type de données : chaîne | | serviceOrderItem.relatedParty.phone | Numéro de téléphone professionnel du contact. Type de données : chaîne | | serviceOrderItem.relatedParty.@referredType | Requis. Type de client. Valeur possible : OrderLineItemContact Type de données : chaîne | | serviceOrderItem.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 | | serviceOrderItem.service | Requis. Description des détails de l'instance du service acheté par le client. Type de données : objet "service:" { "id": "String", "serviceCharacteristic": [Array], "serviceRelationship": [Array], "serviceSpecification": {Object}, "@type": "String" } {#serviceorder-PATCH-serviceOrder-id__service-codeblock-tmf641} Table/champ mis à jour : sn_ind_tmt_orm_order_line_item | | serviceOrderItem.service.id | Identificateur unique du service vendu. Cette valeur peut être l'ID sys_id ou externe dans la table Inventaire des produits \[sn_ind_tmt_orm_product_inventory\]. Cette valeur n'est utilisée que pour les ordres de changement/déconnexion. Type de données : chaîne | | serviceOrderItem.service.serviceCharacteristic | Liste décrivant les caractéristiques du service associé. Seules les caractéristiques de service avec un courant value différent de celui previousValue sont renvoyées. Type de données : tableau "serviceCharacteristic:" [ { "name": "String", "previousValue": "String", "value": "String", } ] | | serviceOrderItem.service.serviceCharacteristic.name | Nom de l'enregistrement de la caractéristique à associer au service. Situé dans la table Caractéristique \[sn_prd_pm_characteristic\]. Type de données : chaîne | | serviceOrderItem.service.serviceCharacteristic.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 ajouterserviceOrderItem.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 | | serviceOrderItem.service.serviceCharacteristic.value | Valeurs d'option de caractéristique associées au service. 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 | | serviceOrderItem.service.serviceSpecification | Requis. Description de la spécification de service associée au service. Remarque : Les ordres de changement (serviceOrderItem.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. * Lorsque la propriété est définie sur vrai (par défaut), si le service est d'une version différente de celle indiquée dans la commande, le service est automatiquement mis à niveau vers la version dans la commande en modifiant la spécification du service référencé. Cela permet de traiter la commande avec succès. * Lorsque la propriété est définie sur false, si le service est une version différente de celle indiquée dans la commande, la commande échoue en raison de l'incompatibilité de version. {#serviceorder-PATCH-serviceOrder-id__ul_zbw_sdz_dbc} Type de données : objet "serviceSpecification:" { "id": "String", "name": "String", "@type": "String" } Met à jour le champ service_specification dans la table Élément de ligne de commande \[sn_ind_tmt_orm_order_line_item\]. | | serviceOrderItem.service.serviceSpecification.id | Requis. Initial_version ou external_id de la spécification de service. 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 service \[sn_prd_pm_service_specification\]. Type de données : chaîne | | serviceOrderItem.service.serviceSpecification.name | Requis. Nom de la spécification de service. Situé dans la table Spécification de service \[sn_prd_pm_service_specification\]. Type de données : chaîne | | serviceOrderItem.service.serviceSpecification.@type | Fait partie de la norme TMF Open API. Cette valeur est toujours ServiceSpecificationRef. Ces informations ne sont pas stockées. Type de données : chaîne | | serviceOrderItem.@type | Fait partie de la norme TMF Open API. Cette valeur est toujours ServiceOrderItem. Ces informations ne sont pas stockées. Type de données : chaîne | | @type | Fait partie de la norme TMF Open API. Cette valeur est toujours ServiceOrder. Ces informations ne sont pas stockées. Type de données : chaîne | [Tableau 15. Paramètres du corps de la demande (JSON)] {#serviceorder-PATCH-serviceOrder-id__table_m32_1l1_hwb} ### 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."). {#serviceorder-PATCH-serviceOrder-id__table_omb_dvk_5rb__entry__2}{#serviceorder-PATCH-serviceOrder-id__accept-JSON-only-entry-RESTAPI}{#serviceorder-PATCH-serviceOrder-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 16. En-têtes de demandes] {#serviceorder-PATCH-serviceOrder-id__table_omb_dvk_5rb} {#serviceorder-PATCH-serviceOrder-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 17. En-têtes de réponses] {#serviceorder-PATCH-serviceOrder-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."). {#serviceorder-PATCH-serviceOrder-id__table_xfv_2vk_5rb__entry__2} | Code d'état | Description | |-|-| | 200 | Réussi. La demande a été correctement traitée. | | 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. {#serviceorder-PATCH-serviceOrder-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 : serviceOrderItem est manquant : objet d'élément de ligne de commande de service ou JSON manquant. * Charge utile non valide : l'ID serviceOrderItem est manquant : le id paramètre est manquant dans l'élément de ligne de commande de service de la charge utile. * Charge utile non valide : l'action serviceOrderItem est manquante : le action paramètre est manquant dans l'élément de ligne de commande de service de la charge utile. * Charge utile non valide : serviceOrderItem serviceOffering est manquant : l'objet ou JSON de l'offre de service est manquant dans l'élément de ligne de commande de service dans la charge utile. * Charge utile non valide : l'ID serviceOffering est manquant : le id paramètre est manquant dans l'élément de ligne de commande de service de l'objet d'offre de service dans la charge utile. * Charge utile non valide : l'offre de service n'existe pas : l'offre de service indiquée dans l'élément de ligne de commande de service n'est pas valide. * Charge utile non valide : serviceOrderItem service manquant : l'objet de service ou JSON dans l'élément de ligne de commande de service est manquant dans la charge utile. * Charge utile non valide : serviceSpecification est manquant : l'objet de spécification de service ou JSON dans l'élément de ligne de commande de service est manquant dans la charge utile. * Charge utile non valide : l'ID de spécification de service est manquant : le id paramètre de l'élément de ligne de commande de service de l'objet de spécification de service est manquant dans la charge utile. * Charge utile non valide : la spécification de service n'existe pas : la spécification de service dans l'élément de ligne de commande de service n'est pas valide. * Charge utile non valide : l'inventaire de service 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 service manquant : dans un ordre de changement, le service.id est manquant dans la charge utile. * Charge utile non valide : vendu Le service est inactif : dans un ordre de changement, un service 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 compte client n'existe pas : le client tiers associé spécifié n'existe pas dans l'instance. * Charge utile non valide : Le consommateur n'existe pas : le consommateur tiers associé spécifié n'existe pas dans l'instance. * 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 \>\>. {#serviceorder-PATCH-serviceOrder-id__ul_g2v_rzm_t4b} | | 404 | Introuvable. L'élément demandé est introuvable. | [Tableau 18. Codes d'état] {#serviceorder-PATCH-serviceOrder-id__table_xfv_2vk_5rb} ### Paramètres de corps de réponse (JSON) {#serviceorder-PATCH-serviceOrder-id__section_b1v_xpk_5rb} {#serviceorder-PATCH-serviceOrder-id__table_t5s_hm1_hwb__entry__2} | Nom | Description | |-|-| | 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 | Numéro de commande unique pour l'ordre de service externe. Type de données : chaîne | | href | Un lien relatif vers l'enregistrement de ressource. Type de données : chaîne Par défaut : chaîne vide | | id | Sys_id de l'ordre de service. 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 | | orderDate | La date et l'horodatage de la commande. Format : JJ-MM-AAAA HH :MM :SS Type de données : chaîne Par défaut : chaîne vide | | relatedParty | Liste des contacts de la commande. Chaque contact est un objet dans le tableau. Type de données : tableau "relatedParty": [ { "id": "String", "name": "String", "@referredType": "String", "@type": "String" } ] | | relatedParty.id | Sys_id ou external_id du compte, du 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 : * Client * Contact du client * Consommateur {#serviceorder-PATCH-serviceOrder-id__ul_vvn_12p_kqb} Type de données : chaîne | | 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 | | 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 | | Élément de commande de service | Tableau d'objets décrivant les éléments de ligne dans la commande de service et leur action associée. Type de données : tableau "serviceOrderItem:" [ { "action": "String", "actionReason": "String", "committedDueDate": "String", "externalProductInventory": [Array], "id": "String", "orderRelationship": [Array], "place": {Object}, "quantity": "Number", "relatedParty": {Object}, "service": {Object}, "@type": "String", "version": "String" } ] | | serviceOrderItem.action | Action à effectuer sur l'élément de commande de service. Les actions possibles sont définies dans l'onglet Liste de choix du champ Entrée du dictionnaire d'actions de la table sn_ind_tmt_orm_order_line_item. Valeurs possibles : * ajouter * changement * supprimer {#serviceorder-PATCH-serviceOrder-id__ul_t4n_rqx_kqb}Pour plus de détails, voir [Action types for customer and service orders](https://www.servicenow.com/docs/access?context=order-mgt-customer-order-types&version=xanadu&pubname=xanadu-order-management&ft:locale=en-US). Type de données : chaîne | | serviceOrderItem.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 | | serviceOrderItem.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 | | serviceOrderItem.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. | | serviceOrderItem.externalProductInventory.externalProductInventoryId | ID externe mappé à l'inventaire des produits. Type de données : chaîne | | serviceOrderItem.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 | | serviceOrderItem.orderRelationship | Tableau d'objets décrivant les relations entre les éléments de ligne de commande. Type de données : tableau "orderRelationship:" [ { "id": "String", "relationshipType": "String" } ] | | serviceOrderItem.orderRelationship.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 | | serviceOrderItem.orderRelationship.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 {#serviceorder-PATCH-serviceOrder-id__d2876e2337} `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 | | serviceOrderItem.place | Carte des emplacements sur lesquels installer le service. Type de données : objet "place:" { "id": "String", "@type": "String" } | | serviceOrderItem.place.id | Sys_id de l'enregistrement de l'emplacement associé dans la table Emplacement \[cmn_location\]. Type de données : chaîne | | serviceOrderItem.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 | | serviceOrderItem.quantity | Nombre d'éléments de ligne commandés. Type de données : nombre | | serviceOrderItem.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" } | | serviceOrderItem.relatedParty.email | Adresse e-mail du contact. Type de données : chaîne | | serviceOrderItem.relatedParty.firstName | Prénom de la personne à contacter. Type de données : chaîne | | serviceOrderItem.relatedParty.lastName | Nom de famille du contact. Type de données : chaîne | | serviceOrderItem.relatedParty.phone | Numéro de téléphone professionnel du contact. Type de données : chaîne | | serviceOrderItem.relatedParty.@referredType | Type de client. Valeur possible : OrderLineItemContact Type de données : chaîne | | serviceOrderItem.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 | | serviceOrderItem.service | Description des détails de l'instance du service acheté par le client. Type de données : objet "service:" { "id": "String", "serviceCharacteristic": [Array], "serviceRelationship": [Array], "serviceSpecification": {Object}, "@type": "String" } | | serviceOrderItem.service.id | Identificateur unique du service vendu. Cette valeur peut être l'ID sys_id ou externe dans la table Inventaire des produits \[sn_ind_tmt_orm_product_inventory\]. Cette valeur n'est renvoyée que pour les ordres de changement/déconnexion. Type de données : chaîne | | serviceOrderItem.service.serviceCharacteristic | Liste décrivant les caractéristiques du service associé. Seules les caractéristiques de service avec un courant value différent de celui previousValue sont renvoyées. Type de données : tableau "serviceCharacteristic:" [ { "name": "String", "previousValue": "String", "value": "String", } ] | | serviceOrderItem.service.serviceCharacteristic.name | Nom de l'enregistrement de la caractéristique à associer au service. Situé dans la table Caractéristique \[sn_prd_pm_characteristic\]. Type de données : chaîne | | serviceOrderItem.service.serviceCharacteristic.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 ajouterserviceOrderItem.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 | | serviceOrderItem.service.serviceCharacteristic.value | Valeurs d'option de caractéristique associées au service. 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 | | serviceOrderItem.service.serviceSpecification | Description de la spécification de service associée au service. Type de données : objet "serviceSpecification:" { "id": "String", "name": "String", "@type": "String" } | | serviceOrderItem.service.serviceSpecification.id | Initial_version ou external_id de la spécification de service. 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 service \[sn_prd_pm_service_specification\]. Type de données : chaîne | | serviceOrderItem.service.serviceSpecification.name | Nom de la spécification de service. Situé dans la table Spécification de service \[sn_prd_pm_service_specification\]. Type de données : chaîne | | serviceOrderItem.service.serviceSpecification.@type | Fait partie de la norme TMF Open API. Cette valeur est toujours ServiceSpecificationRef. Ces informations ne sont pas stockées. Type de données : chaîne | | serviceOrderItem.@type | Fait partie de la norme TMF Open API. Cette valeur est toujours ServiceOrderItem. Ces informations ne sont pas stockées. Type de données : chaîne | | État | État de la commande de service. Pour plus d'informations, consultez. Type de données : chaîne | [ ] {#serviceorder-PATCH-serviceOrder-id__table_t5s_hm1_hwb} ### Demande cURL {#serviceorder-PATCH-serviceOrder-id__example_jsc_1dc_vrb} Cet exemple montre comment mettre à jour une commande de service. curl -X PATCH 'https://instance.service-now.com/api/sn_tmf_api/order/serviceOrder/a831e56e77602110c8b3a4d54b5a9954' \ -H "Accept: application/json" \ -H "Content-Type: application/json" \ -u "username":"password" \ -d '{ "externalId": "BSS748", "priority": "1", "description": "Managed Security", "category": "TMF resource illustration", "requestedStartDate": "2018-01-15T09:37:40.508Z", "requestedCompletionDate": "2018-01-15T09:37:40.508Z", "@type": "ServiceOrder", "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" } ], "serviceOrderItem": [ { "id": "100", "action": "add", "actionReason":"adding service package OLI", "quantity": 1, "@type": "ServiceOrderItem", "service": { "serviceState": "active", "@type": "CFS", "serviceCharacteristic": [ { "name": "CPE Type", "valueType": "string", "value": "Virtual" }, { "name": "Administration Support", "valueType": "string", "value": "Basic( Customer Managed)" }, { "name": "Firewall coverage", "valueType": "string", "value": "Standard(Up to 20 sites)" }, { "name": "Firewall Security", "valueType": "string", "value": "Basic" } ], "serviceSpecification": { "id": "f99546ff07266010a7955b7e0ad300a8", "name": "Managed Firewall Service", "internalVersion": "1", "@type": "Managed Firewall Service" }, "serviceRelationship": [ { "id": "326d13f45b5620102dff5e92dc81c785", "relationshipType": "Requires" } ] }, "place": { "id": "5671dd2ec3a53010188473ce3640dd81", "@type": "Place" } } ], "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" } ] }' Corps de réponse. { "externalId": "BSS748", "priority": "1", "description": "Managed Security", "category": "TMF resource illustration", "requestedStartDate": "2018-01-15T09:37:40.508Z", "requestedCompletionDate": "2018-01-15T09:37:40.508Z", "@type": "ServiceOrder", "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" } ], "serviceOrderItem": [ { "id": "100", "action": "add", v"actionReason": "adding service package OLI", "quantity": 1, "@type": "ServiceOrderItem", "service": { "serviceState": "active", "@type": "CFS", "serviceCharacteristic": [ { "name": "CPE Type", "valueType": "string", "value": "Virtual" }, { "name": "Administration Support", "valueType": "string", "value": "Basic(Customer Managed)" }, { "name": "Firewall coverage", "valueType": "string", "value": "Standard(Up to 20 sites)" }, { "name": "Firewall Security", "valueType": "string", "value": "Basic" } ], "serviceSpecification": { "id": "f99546ff07266010a7955b7e0ad300a8", "name": "Managed Firewall Service", "internalVersion": "1", "@type": "Managed Firewall Service", "sys_id": "f99546ff07266010a7955b7e0ad300a8", "version": "", "status": "published", "internalId": "f99546ff07266010a7955b7e0ad300a8" }, "serviceRelationship": [ { "id": "326d13f45b5620102dff5e92dc81c785", "relationshipType": "Requires" } ] }, "place": { "id": "5671dd2ec3a53010188473ce3640dd81", "@type": "Place" } } ], "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" } ], "orderType": "add", "state": "revision_received", "href": "/api/sn_tmf_api/order/serviceOrder/a831e56e77602110c8b3a4d54b5a9954" } ## API ouverte de commande de service : POST /sn_tmf_api/order/serviceOrder/cancelserviceorder {#ariaid-title5} Annule la commande de service spécifiée. Remarque : Ce point de terminaison ne peut pas être utilisé sur les commandes pour lesquelles le point de non-retour a été atteint. Un élément de ligne de commande ne peut pas être annulé alors que l'exécution est en cours. ### Format d'URL URL par défaut : /api/sn_tmf_api/order/serviceOrder/cancelserviceorder ### Paramètres de demande pris en charge {#serviceorder-POST-cancelserviceord__entry__2} | Nom | Description | |-|-| | Aucun | | [Tableau 19. Paramètres de chemin d'accès] {#serviceorder-POST-cancelserviceord__entry__6} | Nom | Description | |-|-| | Aucun | | [Tableau 20. Paramètres de requête] {#serviceorder-POST-cancelserviceord__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 service | Contient des données sur la commande de service. Type de données : objet "serviceOrder": { "id": "String", "href": "String", "@referredType": "String" } | | serviceOrder.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 | | commandeservices.href | URL de l'ordre client à annuler. Type de données : chaîne Par défaut : chaîne vide | | serviceOrder.@referredType | La valeur de ce paramètre doit être `ServiceOrder`. 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 `CancelServiceOrder`. Type de données : chaîne Par défaut : chaîne vide | [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."). {#serviceorder-POST-cancelserviceord__table_omb_dvk_5rb__entry__2}{#serviceorder-POST-cancelserviceord__accept-JSON-only-entry-RESTAPI}{#serviceorder-POST-cancelserviceord__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 22. En-têtes de demandes] {#serviceorder-POST-cancelserviceord__table_omb_dvk_5rb} {#serviceorder-POST-cancelserviceord__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] {#serviceorder-POST-cancelserviceord__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."). {#serviceorder-POST-cancelserviceord__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. {#serviceorder-POST-cancelserviceord__ul_lg1_5vt_5rb} | [Tableau 24. Codes d'état] ### Paramètres de corps de réponse (JSON) {#serviceorder-POST-cancelserviceord__entry__42} | Nom | Description | |-|-| | Motif d'annulation | Motif de l'annulation. Type de données : chaîne | | id | Sys_id de la commande annulée. Type de données : chaîne | | Commande de service | Contient des données sur la commande de service. Type de données : objet "serviceOrder": { "id": "String", "@referredType": "String" } | | serviceOrder.id | Sys_id de la commande annulée. Type de données : chaîne | | serviceOrder.@referredType | La valeur de ce paramètre est `ServiceOrder`. 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 `CancelServiceOrder`. 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_tmf_api/cancelserviceorder" \ -H "Content-Type: application/json" \ -u "username":"password" \ -d { "cancellationReason": "Duplicate order", "requestedCancellationDate": "2023-01-24T11:56:21.931Z", "serviceOrder": { "id": "5f4f5e5377a311101fa5a4d54b5a99fd", "@referredType": "ServiceOrder" }, "@type": "CancelServiceOrder" } { "id": "5f4f5e5377a311101fa5a4d54b5a99fd", "cancellationReason": "Duplicate order", "requestedCancellationDate": "2023-01-24T11:56:21.931Z", "@type": "CancelServiceOrder", "serviceOrder": { "id": "5f4f5e5377a311101fa5a4d54b5a99fd", "@referredType": "ServiceOrder" }, "state": "done" } ## API ouverte de commande de service : POST /sn_tmf_api/order/serviceOrder {#ariaid-title6} Crée, met à jour ou supprime une commande de service ou un élément de ligne. Lorsqu'une action d'ajout est reçue et acceptée, un nouvel enregistrement est créé dans les tables suivantes : * Ordre \[sn_ind_tmt_orm_order\] * Valeur caractéristique de la 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\] {#serviceorder-POST-order__ul_lxc_kxm_t4b} ### Format d'URL /api/sn_tmf_api/order/serviceOrder ### Paramètres de demande pris en charge {#serviceorder-POST-order__entry__2} | Nom | Description | |-|-| | Aucun | | [Tableau 25. Paramètres de chemin d'accès] {#serviceorder-POST-order__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 26. Paramètres de requête] {#serviceorder-POST-order__entry__10}{#serviceorder-POST-order__svcOrdItem-ph-tmf641-externalid}{#serviceorder-POST-order__note-ph-tmf622}{#serviceorder-POST-order__note_text-ph-tmf622}{#serviceorder-POST-order__requestedCompletionDate-ph-tmf622}{#serviceorder-POST-order__reqStartDate-ph-tmf622}{#serviceorder-POST-order__svcOrdItem-ph-tmf641}{#serviceorder-POST-order__service_id-ph-tmf641}{#serviceorder-POST-order__svcOrderItemRel_id-ph-tmf641}{#serviceorder-POST-order__productOrderItemRelationship_relType-row-tmf622}{#serviceorder-POST-order__service-s-tmf641} | Nom | Description | |-|-| | 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 | Numéro de commande unique pour l'ordre de service externe. Type de données : chaîne Table/champ mis à jour : sn_ind_tmt_orm_order | | 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 qui décrivent les notes supplémentaires prises par le client lors de la commande. Type de données : tableau{#serviceorder-POST-order__note_data_type-p-tmf622} "note": [ { "text": "String" } ] {#serviceorder-POST-order__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{#serviceorder-POST-order__note_text_data_type-p-tmf622} Table/champ mis à jour : sn_ind_tmt_orm_order/commentaires Par défaut : chaîne vide | | orderDate | La date et l'horodatage de la commande. Format : JJ-MM-AAAA HH :MM :SS Type de données : chaîne Par défaut : chaîne vide | | relatedParty | Liste des contacts de la commande. Chaque contact est un objet dans le tableau. La demande 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 | Requis. Sys_id ou external_id du compte, du contact client ou du consommateur associé à la commande. Situé dans la table Compte \[customer_account\], la table Contact \[customer_contact\] ou la table Consommateur \[csm_consumer\]. Type de données : chaîne Table mise à jour : sn_ind_tmt_orm_order | | relatedParty.name | Nom du compte, du client ou du consommateur. Type de données : chaîne | | relatedParty.@referredType | Type de client. Valeurs possibles : * Client * Contact du client * Consommateur {#serviceorder-POST-order__ul_cdn_ddp_kqb} Type de données : chaîne | | 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 | | requestedCompletionDate | Date de livraison demandée par le client. Type de données : chaîne{#serviceorder-POST-order__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{#serviceorder-POST-order__reqStartDate_data_type-p-tmf622} Table/champ mis à jour : sn_ind_tmt_orm_order/expected_start_date Par défaut : chaîne vide | | Élément de commande de service | Requis. Tableau d'objets décrivant les éléments de ligne dans la commande de service et leur action associée. Type de données : tableau{#serviceorder-POST-order__svcOrdItem_data_type-p-tmf641} "serviceOrderItem:" [ { "action": "String", "actionReason": "String", "committedDueDate": "String", "externalProductInventory": [Array], "id": "String", "orderRelationship": [Array], "place": {Object}, "quantity": "Number", "relatedParty": {Object}, "service": {Object}, "@type": "String", "version": "String" } ] {#serviceorder-POST-order__svcOrdItem-codeblock-tmf641} Table/champ mis à jour : sn_ind_tmt_orm_order_line_item | | serviceOrderItem.action | Requis. Action à effectuer sur l'élément de commande de service. Les actions possibles sont définies dans l'onglet Liste de choix du champ 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 {#serviceorder-POST-order__ul_grg_vgl_gqb}Pour plus de détails, voir [Action types for customer and service orders](https://www.servicenow.com/docs/access?context=order-mgt-customer-order-types&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_line_item/action Par défaut : add | | ServiceOrderItem.actionReason | Facultatif. Description du motif de l'élément de ligne. Type de données : chaîne Table/champ mis à jour : table/action_reason de l'élément de ligne de commande \[sn_ind_tmt_orm_order_line_item\]. | | serviceOrderItem.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 | | serviceOrderItem.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" } ] | | serviceOrderItem.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 | | serviceOrderItem.id | Requis. 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 Table/champ mis à jour : sn_ind_tmt_orm_order_line_item/external_id | | serviceOrderItem.orderRelationship | Requis. Tableau d'objets décrivant les relations entre les éléments de ligne de commande. Type de données : tableau "orderRelationship:" [ { "id": "String", "relationshipType": "String" } ] {#serviceorder-POST-order__svcOrderItemRel-codeblock} Table/champ mis à jour : sn_ind_tmt_orm_order_line_item | | serviceOrderItem.orderRelationship.id | Requis. 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 Table/champ mis à jour : sn_ind_tmt_orm_order_line_item/parent_line_item ou sn_ind_tmt_orm_order_line_related_items/related_order_line_item | | serviceOrderItem.orderRelationship.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) * Exige {#serviceorder-POST-order__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 | | serviceOrderItem.place | Carte des emplacements sur lesquels installer le service. Type de données : objet "place:" { "id": "String", "@type": "String" } | | serviceOrderItem.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 Par défaut : chaîne vide | | serviceOrderItem.place.@type | Fait partie de la norme TMF Open API. Annotation pour le lieu de l'élément de ligne de commande. Type de données : chaîne | | serviceOrderItem.quantity | Définit le nombre d'éléments de ligne à commander. Cette propriété s'applique uniquement lors de l'ajout d'une commande de service ; c'est-à-dire que la valeur de la action propriété est `additionnée`. Type de données : nombre Par défaut : chaîne vide Table/champ mis à jour : sn_ind_tmt_orm_order/quantité | | serviceOrderItem.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" } | | serviceOrderItem.relatedParty.email | Adresse e-mail du contact. Type de données : chaîne | | serviceOrderItem.relatedParty.firstName | Prénom de la personne à contacter. Type de données : chaîne | | serviceOrderItem.relatedParty.lastName | Nom de famille du contact. Type de données : chaîne | | serviceOrderItem.relatedParty.phone | Numéro de téléphone professionnel du contact. Type de données : chaîne | | serviceOrderItem.relatedParty.@referredType | Requis. Type de client. Valeur possible : OrderLineItemContact Type de données : chaîne | | serviceOrderItem.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 | | serviceOrderItem.service | Requis. Description des détails de l'instance du service acheté par le client. Type de données : objet "service:" { "id": "String", "serviceCharacteristic": [Array], "serviceRelationship": [Array], "serviceSpecification": {Object}, "@type": "String" } {#serviceorder-POST-order__service-codeblock-tmf641} Table/champ mis à jour : sn_ind_tmt_orm_order_line_item | | serviceOrderItem.service.id | Identificateur unique du service vendu. Cette valeur peut être l'ID sys_id ou externe dans la table Inventaire des produits \[sn_ind_tmt_orm_product_inventory\]. Cette valeur n'est utilisée que pour les ordres de changement/déconnexion. Type de données : chaîne | | serviceOrderItem.service.serviceCharacteristic | Liste décrivant les caractéristiques du service associé. Seules les caractéristiques de service avec un courant value différent de celui previousValue sont renvoyées. Type de données : tableau "serviceCharacteristic:" [ { "name": "String", "previousValue": "String", "value": "String", } ] | | serviceOrderItem.service.serviceCharacteristic.name | Nom de l'enregistrement de la caractéristique à associer au service. Situé dans la table Caractéristique \[sn_prd_pm_characteristic\]. Type de données : chaîne | | serviceOrderItem.service.serviceCharacteristic.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 ajouterserviceOrderItem.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 | | serviceOrderItem.service.serviceCharacteristic.value | Valeurs d'option de caractéristique associées au service. 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 | | serviceOrderItem.service.serviceRelationship | Liste des inventaires de produits liés au service. Type de données : tableau "serviceRelationship": [ { "id": "String", "relationshipType": "String" } ] | | serviceOrderItem.service.serviceRelationship.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 | | serviceOrderItem.service.serviceRelationship.relationshipType | Type de relation entre le service et l'inventaire des produits. Valeur possible : nécessite Type de données : chaîne | | serviceOrderItem.service.serviceSpecification | Requis. Description de la spécification de service associée au service. Remarque : Les ordres de changement (serviceOrderItem.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. * Lorsque la propriété est définie sur vrai (par défaut), si le service est d'une version différente de celle indiquée dans la commande, le service est automatiquement mis à niveau vers la version dans la commande en modifiant la spécification du service référencé. Cela permet de traiter la commande avec succès. * Lorsque la propriété est définie sur false, si le service est une version différente de celle indiquée dans la commande, la commande échoue en raison de l'incompatibilité de version. {#serviceorder-POST-order__ul_zbw_sdz_dbc} Type de données : objet "serviceSpecification:" { "id": "String", "internalVersion": "String", "name": "String", "version": "String", "@type": "String" } Met à jour le champ service_specification dans la table Élément de ligne de commande \[sn_ind_tmt_orm_order_line_item\]. | | serviceOrderItem.service.serviceSpecification.id | Requis. Initial_version ou external_id de la spécification de service. 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 service \[sn_prd_pm_service_specification\]. Type de données : chaîne | | serviceOrderItem.service.serviceSpecification.internalVersion | Version de la spécification de service. Situé dans la table Spécification de service \[sn_prd_pm_service_specification\]. Type de données : chaîne | | serviceOrderItem.service.serviceSpecification.name | Requis. Nom de la spécification de service. Situé dans la table Spécification de service \[sn_prd_pm_service_specification\]. Type de données : chaîne | | serviceOrderItem.service.serviceSpecification.version | External_version de la spécification de service. Situé dans la table Spécification de service \[sn_prd_pm_service_specification\]. Type de données : chaîne | | serviceOrderItem.service.serviceSpecification.@type | Fait partie de la norme TMF Open API. Cette valeur est toujours ServiceSpecificationRef. Ces informations ne sont pas stockées. Type de données : chaîne | | serviceOrderItem.@type | Fait partie de la norme TMF Open API. Cette valeur est toujours ServiceOrderItem. Ces informations ne sont pas stockées. Type de données : chaîne | | @type | Fait partie de la norme TMF Open API. Cette valeur est toujours ServiceOrder. Ces informations ne sont pas stockées. Type de données : chaîne | [Tableau 27. 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."). {#serviceorder-POST-order__entry__114}{#serviceorder-POST-order__accept-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. | [Tableau 28. En-têtes de demandes] {#serviceorder-POST-order__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] {#serviceorder-POST-order__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."). {#serviceorder-POST-order__table_kmf_3jm_gqb__entry__2}{#serviceorder-POST-order__entry-200-status-code}{#serviceorder-POST-order__entry-404-status-code} | Code d'état | Description | |-|-| | 200 | Réussi. La demande a été correctement traitée. | | 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. * La 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. {#serviceorder-POST-order__ul_r1r_jhm_gqb} | | 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 : serviceOrderItem manquant. - L'objet de l'élément de ligne de commande de service ou le JSON est manquant. * Charge utile non valide : l'ID serviceOrderItem est manquant. : l'ID est manquant dans l'élément de ligne de commande de service. * Charge utile non valide : l'action serviceOrderItem est manquante. : l'objet de service ou JSON est manquant dans la charge utile. * Charge utile non valide : le service serviceOrderItem est manquant. : la propriété de service est manquante dans l'élément de ligne de commande de service. * Charge utile non valide : serviceSpecification est manquant. - L'objet de spécification de service ou JSON dans l'élément de ligne de commande de service est manquant dans la charge utile. * Charge utile non valide : l'ID serviceSpecification est manquant. - Le id paramètre de l'élément de ligne de commande de service de l'objet de spécification de service est absent de la charge utile. * Charge utile non valide : la spécification de service n'existe pas. - La spécification de service dans l'élément de ligne de commande de service n'est pas valide. * Charge utile non valide : l'inventaire de produits n'existe pas. - Dans un ordre de modification ou de suppression (c'est-à-dire action = modification ou suppression), le service vendu envoyé n'est pas présent dans le système. * Charge utile non valide : l'ID d'inventaire de produits est manquant. -- Dans une commande de modification ou de suppression, l'ID du produit vendu 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 produit vendu est inactif. -- Dans une commande de modification ou de suppression, le Produit vendu envoyé dans la charge utile n'est pas dans l'état actif. * Charge utile non valide : Le consommateur n'existe pas : le consommateur tiers associé spécifié n'existe pas dans l'instance. * Charge utile non valide : le compte client n'existe pas. -- Le client tiers lié indiqué dans la charge utile n'est pas présent dans le système. * Charge utile non valide : échec de la création de la commande. - Impossible de créer la commande demandée. {#serviceorder-POST-order__ul_v1r_jhm_gqb} | | 404 | Introuvable. L'élément demandé est introuvable. | [Tableau 30. Codes d'état] {#serviceorder-POST-order__table_kmf_3jm_gqb} ### Paramètres de corps de réponse (JSON) {#serviceorder-POST-order__entry__134}{#serviceorder-POST-order__type-entry-tmf641} | Nom | Description | |-|-| | 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 | Numéro de commande unique pour l'ordre de service externe. Type de données : chaîne | | href | Un lien relatif vers l'enregistrement de ressource. Type de données : chaîne Par défaut : chaîne vide | | id | Sys_id de l'ordre de service. 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 | | orderDate | La date et l'horodatage de la commande. Format : JJ-MM-AAAA HH :MM :SS Type de données : chaîne Par défaut : chaîne vide | | 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 | | relatedParty | Liste des contacts de la commande. Chaque contact est un objet dans le tableau. Type de données : tableau "relatedParty": [ { "id": "String", "name": "String", "@referredType": "String", "@type": "String" } ] | | relatedParty.id | Sys_id ou external_id du compte, du 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 : * Client * Contact du client * Consommateur {#serviceorder-POST-order__ul_vvn_12p_kqb} Type de données : chaîne | | 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 | | 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 | | Élément de commande de service | Tableau d'objets décrivant les éléments de ligne dans la commande de service et leur action associée. Type de données : tableau "serviceOrderItem:" [ { "action": "String", "actionReason": "String", "committedDueDate": "String", "externalProductInventory": [Array], "id": "String", "orderRelationship": [Array], "place": {Object}, "quantity": "Number", "relatedParty": {Object}, "service": {Object}, "@type": "String", "version": "String" } ] | | serviceOrderItem.action | Action à effectuer sur l'élément de commande de service. Les actions possibles sont définies dans l'onglet Liste de choix du champ 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 {#serviceorder-POST-order__ul_t4n_rqx_kqb}Pour plus de détails, voir [Action types for customer and service orders](https://www.servicenow.com/docs/access?context=order-mgt-customer-order-types&version=xanadu&pubname=xanadu-order-management&ft:locale=en-US). Type de données : chaîne | | ServiceOrderItem.actionReason | Description du motif de l'ajout de l'élément de ligne. Situé dans la table Élément de ligne de commande \[sn_ind_tmt_orm_order_line_item\]. Type de données : chaîne | | serviceOrderItem.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 | | serviceOrderItem.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" } ] | | serviceOrderItem.externalProductInventory.externalProductInventoryId | ID externe mappé à l'inventaire des produits. Type de données : chaîne | | serviceOrderItem.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 | | serviceOrderItem.orderRelationship | Tableau d'objets décrivant les relations entre les éléments de ligne de commande. Type de données : tableau "orderRelationship:" [ { "id": "String", "relationshipType": "String" } ] | | serviceOrderItem.orderRelationship.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 | | serviceOrderItem.orderRelationship.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 {#serviceorder-POST-order__d2876e2337} `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 | | serviceOrderItem.place | Carte des emplacements sur lesquels installer le service. Type de données : objet "place:" { "id": "String", "@type": "String" } | | serviceOrderItem.place.id | Sys_id de l'enregistrement de l'emplacement associé dans la table Emplacement \[cmn_location\]. Type de données : chaîne | | serviceOrderItem.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 | | serviceOrderItem.quantity | Nombre d'éléments de ligne commandés. Type de données : nombre | | serviceOrderItem.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" } | | serviceOrderItem.relatedParty.email | Adresse e-mail du contact. Type de données : chaîne | | serviceOrderItem.relatedParty.firstName | Prénom de la personne à contacter. Type de données : chaîne | | serviceOrderItem.relatedParty.lastName | Nom de famille du contact. Type de données : chaîne | | serviceOrderItem.relatedParty.phone | Numéro de téléphone professionnel du contact. Type de données : chaîne | | serviceOrderItem.relatedParty.@referredType | Requis. Type de client. Valeur possible : OrderLineItemContact Type de données : chaîne | | serviceOrderItem.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 | | serviceOrderItem.service | Description des détails de l'instance du service acheté par le client. Type de données : objet "service:" { "id": "String", "serviceCharacteristic": [Array], "serviceRelationship": [Array], "serviceSpecification": {Object}, "@type": "String" } | | serviceOrderItem.service.id | Identificateur unique du service vendu. Cette valeur peut être l'ID sys_id ou externe dans la table Inventaire des produits \[sn_ind_tmt_orm_product_inventory\]. Cette valeur n'est renvoyée que pour les ordres de changement/déconnexion. Type de données : chaîne | | serviceOrderItem.service.serviceCharacteristic | Liste décrivant les caractéristiques du service associé. Seules les caractéristiques de service avec un courant value différent de celui previousValue sont renvoyées. Type de données : tableau "serviceCharacteristic:" [ { "name": "String", "previousValue": "String", "value": "String", } ] | | serviceOrderItem.service.serviceCharacteristic.name | Nom de l'enregistrement de la caractéristique à associer au service. Situé dans la table Caractéristique \[sn_prd_pm_characteristic\]. Type de données : chaîne | | serviceOrderItem.service.serviceCharacteristic.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 ajouterserviceOrderItem.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 | | serviceOrderItem.service.serviceCharacteristic.value | Valeurs d'option de caractéristique associées au service. 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 | | serviceOrderItem.service.serviceRelationship | Liste des inventaires de produits liés au service. Type de données : tableau "serviceRelationship": [ { "id": "String", "relationshipType": "String" } ] | | serviceOrderItem.service.serviceRelationship.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 | | serviceOrderItem.service.serviceRelationship.relationshipType | Type de relation entre le service et l'inventaire des produits. Valeur possible : nécessite Type de données : chaîne | | serviceOrderItem.service.serviceSpecification | Description de la spécification de service associée au service. Type de données : objet "serviceSpecification:" { "id": "String", "internalId": "String", "internalVersion": "String", "name": "String", "version": "String", "@type": "String" } | | serviceOrderItem.service.serviceSpecification.id | Initial_version ou external_id de la spécification de service. 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 service \[sn_prd_pm_service_specification\]. Type de données : chaîne | | serviceOrderItem.service.serviceSpecification.internalId | Initial_version de la spécification de service. Le initial_version est le sys_id de la première version de la spécification. Situé dans la table Spécification de service \[sn_prd_pm_service_specification\]. Type de données : chaîne | | serviceOrderItem.service.serviceSpecification.internalVersion | Version de la spécification de service. Situé dans la table Spécification de service \[sn_prd_pm_service_specification\]. Type de données : chaîne | | serviceOrderItem.service.serviceSpecification.name | Nom de la spécification de service. Situé dans la table Spécification de service \[sn_prd_pm_service_specification\]. Type de données : chaîne | | serviceOrderItem.service.serviceSpecification.version | External_version de la spécification de service. Situé dans la table Spécification de service \[sn_prd_pm_service_specification\]. Type de données : chaîne | | serviceOrderItem.service.serviceSpecification.@type | Fait partie de la norme TMF Open API. Cette valeur est toujours ServiceSpecificationRef. Ces informations ne sont pas stockées. Type de données : chaîne | | serviceOrderItem.state | État de l'élément de commande de service. Par exemple, nouveau. Type de données : chaîne | | serviceOrderItem.@type | Fait partie de la norme TMF Open API. Cette valeur est toujours ServiceOrderItem. Ces informations ne sont pas stockées. Type de données : chaîne | | État | État de la commande de service. Pour plus d'informations, consultez. Type de données : chaîne | | @type | Fait partie de la norme TMF Open API. Cette valeur est toujours ServiceOrder. Ces informations ne sont pas stockées. Type de données : chaîne | [ ] ### Traitement asynchrone {#serviceorder-POST-order__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_tmf_api/serviceorder?mode=async' \ -H "Accept: application/json" \ -H "Content-Type: application/json" \ -u "username":"password" \ -d '{ "externalId": "BSS748", "priority": "1", "description": "Managed Security", "category": "TMF resource illustration", "requestedStartDate": "2018-01-15T09:37:40.508Z", "requestedCompletionDate": "2018-01-15T09:37:40.508Z", "@type": "ServiceOrder", "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" } ], "serviceOrderItem": [ { "id": "100", "action": "add", "actionReason":"adding service package OLI", "quantity": 1, "@type": "ServiceOrderItem", "service": { "serviceState": "active", "@type": "CFS", "serviceCharacteristic": [ { "name": "CPE Type", "valueType": "string", "value": "Virtual" }, { "name": "Administration Support", "valueType": "string", "value": "Basic( Customer Managed)" }, { "name": "Firewall coverage", "valueType": "string", "value": "Standard(Up to 20 sites)" }, { "name": "Firewall Security", "valueType": "string", "value": "Basic" } ], "serviceSpecification": { "id": "f99546ff07266010a7955b7e0ad300a8", "name": "Managed Firewall Service", "internalVersion": "1", "@type": "Managed Firewall Service" }, "serviceRelationship": [ { "id": "326d13f45b5620102dff5e92dc81c785", "relationshipType": "Requires" } ] }, "place": { "id": "5671dd2ec3a53010188473ce3640dd81", "@type": "Place" } } ], "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" } ] }' Corps de réponse. { "orderId": "304e877ac3ab5110856d73ce3640dde5" } ### Traitement synchrone (par défaut) L'exemple suivant montre comment créer une commande de service en définissant la serviceOrderItem.action propriété à ajouter. curl "https://instance.service-now.com/api/sn_tmf_api/serviceorder" \ --request POST \ --header "Accept:application/json" \ --header "Content-Type:application/json" \ --data "{ "externalId": "BSS748", "requestedStartDate": "2018-01-15T09:37:40.508Z", "requestedCompletionDate": "2018-01-15T09:37:40.508Z", "@type": "ServiceOrder", "note": [ { "text": "This is a TMF service order illustration" }, { "text": "This is a TMF service order illustration no 2" } ], "serviceOrderItem": [ { "id": "100", "action": "add", "actionReason":"adding service package OLI", "quantity": 1, "@type": "ServiceOrderItem", "service": { "@type": "CFS", "serviceCharacteristic": [ { "name": "Firewall Security", "value": "Standard" }, { "name": "Firewall coverage", "value": "Premium (Up to 50 sites)" }, { "name": "Administration Support", "value": "Basic (Customer Managed)" } ], "serviceRelationship": [ { "id": "326d13f45b5620102dff5e92dc81c785", "relationshipType": "Requires" } ], "serviceSpecification": { "id": "f99546ff07266010a7955b7e0ad300a8", "name": "Managed Firewall Service", "@type": "Managed Firewall Service" } }, "relatedParty": [ { "firstName": "Mike", "lastName": "Hudson", "email": "mike@example.com", "phone": "1234567890", "@type": "RelatedParty", "@referredType": "OrderLineItemContact" } ], "place": { "id": "920cf6ac73d423002728660c4cf6a799", "@type": "Place" } } ], "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" } ] }" \ --user 'username':'password' Corps de réponse : { "externalId": "BSS748", "requestedStartDate": "2018-01-15T09:37:40.508Z", "requestedCompletionDate": "2018-01-15T09:37:40.508Z", "@type": "ServiceOrder", "note": [ { "text": "This is a TMF service order illustration" }, { "text": "This is a TMF service order illustration no 2" } ], "serviceOrderItem": [ { "id": "100", "action": "add", "actionReason":"adding service package OLI", "quantity": 1, "@type": "ServiceOrderItem", "service": { "@type": "CFS", "serviceCharacteristic": [ { "name": "Firewall Security", "value": "Standard" }, { "name": "Firewall coverage", "value": "Premium (Up to 50 sites)" }, { "name": "Administration Support", "value": "Basic (Customer Managed)" } ], "serviceRelationship": [ { "id": "326d13f45b5620102dff5e92dc81c785", "relationshipType": "Requires" } ], "serviceSpecification": { "id": "f99546ff07266010a7955b7e0ad300a8", "name": "Managed Firewall Service", "@type": "Managed Firewall Service", "internalVersion": "2", "version": "v2", "internalId": "f99546ff07266010a7955b7e0ad300a8" } }, "relatedParty": [ { "firstName": "Mike", "lastName": "Hudson", "email": "mike@example.com", "phone": "1234567890", "@type": "RelatedParty", "@referredType": "OrderLineItemContact" } ], "place": { "id": "920cf6ac73d423002728660c4cf6a799", "@type": "Place" }, "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" } ], "id": "4f2af65ac3a030106e2473ce3640ddcf", "href": "/api/sn_tmf_api/order/serviceOrder/4f2af65ac3a030106e2473ce3640ddcf", "orderDate": "2024-06-20T10:38:55.000Z", "state": "new" } ### Demande cURL {#serviceorder-POST-order__example_vrq_jgm_gqb} L'exemple suivant met à jour une commande de service en définissant la serviceOrderItem.action propriété sur change. curl "https://instance.service-now.com/api/sn_tmf_api/serviceorder" \ --request POST \ --header "Accept:application/json" \ --header "Content-Type:application/json" \ --data "{ "externalId": "BSS748", "requestedStartDate": "2018-01-15T09:37:40.508Z", "requestedCompletionDate": "2018-01-15T09:37:40.508Z", "@type": "ServiceOrder", "note": [ { "text": "This is a TMF service order illustration" }, { "text": "This is a TMF service order illustration no 2" } ], "serviceOrderItem": [ { "id": "100", "action": "change", "actionReason":"change service package OLI", "@type": "ServiceOrderItem", "service": { "@type": "CFS", "serviceCharacteristic": [ { "name": "Firewall Security", "value": "Premium", "previousValue": "Standard" } ], "id": "4b5072aec3a83010abc8b5183c40dd42" }, "relatedParty": [ { "firstName": "Mike", "lastName": "Hudson", "email": "mike@example.com", "phone": "1234567890", "@type": "RelatedParty", "@referredType": "OrderLineItemContact" } ], "place": { "id": "920cf6ac73d423002728660c4cf6a799", "@type": "Place" } } ], "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" } ] }" \ --user 'username':'password' Corps de réponse. { "externalId": "BSS748", "requestedStartDate": "2018-01-15T09:37:40.508Z", "requestedCompletionDate": "2018-01-15T09:37:40.508Z", "@type": "ServiceOrder", "note": [ { "text": "This is a TMF service order illustration" }, { "text": "This is a TMF service order illustration no 2" } ], "serviceOrderItem": [ { "id": "100", "action": "change", "actionReason":"change service package OLI", "@type": "ServiceOrderItem", "service": { "@type": "CFS", "serviceCharacteristic": [ { "name": "Firewall Security", "value": "Premium", "previousValue": "Standard" } ], "id": "4b5072aec3a83010abc8b5183c40dd42" }, "relatedParty": [ { "firstName": "Mike", "lastName": "Hudson", "email": "mike@example.com", "phone": "1234567890", "@type": "RelatedParty", "@referredType": "OrderLineItemContact" } ], "place": { "id": "920cf6ac73d423002728660c4cf6a799", "@type": "Place" }, "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" } ], "id": "4f2af65ac3a030106e2473ce3640ddcf", "href": "/api/sn_tmf_api/order/serviceOrder/4f2af65ac3a030106e2473ce3640ddcf", "orderDate": "2024-06-20T10:38:55.000Z", "state": "new" } ### Demande cURL {#serviceorder-POST-order__example_f5w_jgm_gqb} L'exemple suivant supprime un élément de ligne de commande de service en définissant la serviceOrderItem.action propriété à supprimer. curl "https://instance.service-now.com/api/sn_tmf_api/serviceorder" \ --request POST \ --header "Accept:application/json" \ --header "Content-Type:application/json" \ --data "{ "externalId": "BSS748", "requestedStartDate": "2018-01-15T09:37:40.508Z", "requestedCompletionDate": "2018-01-15T09:37:40.508Z", "@type": "ServiceOrder", "note": [ { "text": "This is a TMF service order illustration" }, { "text": "This is a TMF service order illustration no 2" } ], "serviceOrderItem": [ { "id": "100", "action": "delete", "actionReason":"delete service package OLI", "@type": "ServiceOrderItem", "service": { "@type": "CFS", "serviceCharacteristic": [ { "name": "Firewall Security", "value": "Premium", "previousValue": "Standard" } ], "id": "4b5072aec3a83010abc8b5183c40dd42" }, "relatedParty": [ { "firstName": "Mike", "lastName": "Hudson", "email": "mike@example.com", "phone": "1234567890", "@type": "RelatedParty", "@referredType": "OrderLineItemContact" } ], "place": { "id": "920cf6ac73d423002728660c4cf6a799", "@type": "Place" } } ], "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" } ] }" \ --user 'username':'password' Corps de réponse. { "externalId": "BSS748", "requestedStartDate": "2018-01-15T09:37:40.508Z", "requestedCompletionDate": "2018-01-15T09:37:40.508Z", "@type": "ServiceOrder", "note": [ { "text": "This is a TMF service order illustration" }, { "text": "This is a TMF service order illustration no 2" } ], "serviceOrderItem": [ { "id": "100", "action": "delete", "actionReason":"delete service package OLI", "@type": "ServiceOrderItem", "service": { "@type": "CFS", "serviceCharacteristic": [ { "name": "Firewall Security", "value": "Premium", "previousValue": "Standard" } ], "id": "4b5072aec3a83010abc8b5183c40dd42" }, "relatedParty": [ { "firstName": "Mike", "lastName": "Hudson", "email": "mike@example.com", "phone": "1234567890", "@type": "RelatedParty", "@referredType": "OrderLineItemContact" } ], "place": { "id": "920cf6ac73d423002728660c4cf6a799", "@type": "Place" }, "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" } ], "id": "4f2af65ac3a030106e2473ce3640ddcf", "href": "/api/sn_tmf_api/order/serviceOrder/4f2af65ac3a030106e2473ce3640ddcf", "orderDate": "2024-06-20T10:38:55.000Z", "state": "new" }