API de commande

Rversion finale: Australia

Mis à jour 12 mars 2026

28 minutes de lecture

L’API de commande fournit des points de terminaison pour la récupération et la création de commandes avec des éléments de ligne de commande pour l’applicationGestion du service client.

Cette API nécessite l’application de Gestion des commandes stockage (app-csm-order-mgmt) et est fournie dans l’espace de noms sn_ind_tmt_orm . (pour en savoir plus, consultez Sales Customer Relationship Management) ;

Cette API nécessite l’accès à sn_csm_om.order_integrator et l’un des éléments suivants :

sn_csm_om.consumer_agent : accès en écriture à l’API limité aux commandes B2C.
sn_csm_om.customer_agent : accès en écriture à l’API limité aux commandes B2B.
sn_csm_om.order_admin : accès en écriture à l’API pour les commandes B2B ou B2C.

Pour plus d’informations sur les commandes B2B et B2C, consultez Modèles de données client pour B2B2C.

API de commande : GET /sn_ind_tmt_orm/order/{id}

Récupère les détails complets de la commande en spécifiant le sys_id ou le numéro de commande.

Format d'URL

URL avec version : /api/sn_ind_tmt_orm/{api_version}/order/{id}

URL par défaut : /api/sn_ind_tmt_orm/order/{id}

Remarque :

Les versions disponibles sont spécifiées dans l’explorateur d’API REST. Pour les API REST scriptées, des informations supplémentaires sur la version se trouvent dans le formulaire Service REST scripté.

Paramètres de demande pris en charge

Tableau 1. Paramètres de chemin d'accès
Nom	Description
api_version	Facultatif. Version du point de terminaison auquel accéder. Par exemple, `v1` ou `v2`. Spécifiez uniquement cette valeur pour utiliser une version de point de terminaison autre que la plus récente. Type de données : chaîne
id	Sys_id ou numéro d’ordre (order_id) de l’enregistrement à récupérer. Type de données : chaîne Table : Ordres [sn_csm_om_order]

Tableau 2. Paramètres de requête
Nom	Description
sysparm_display_value	Marqueur indiquant s’il faut afficher la valeur d’affichage des champs de référence. Valeurs valides : vrai : afficher la valeur d’affichage des champs de référence, des champs de choix et du champ de date dans la réponse. faux : indiquez la valeur réelle des champs de référence, des champs de choix et du champ de date dans la réponse. Valeur par défaut : false

Tableau 3. Paramètres de corps de demande (XML ou JSON)
Nom	Description
Néant

En-têtes

Les en-têtes de demande et de réponse suivants s’appliquent uniquement à cette action HTTP 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.

Tableau 4. En-têtes de demandes
En-tête	Description
Accepter	Format de données du corps de la réponse. Types pris en charge : application/json ou application/xml. Valeur par défaut : application/json

Tableau 5. En-têtes de réponses
En-tête	Description
Néant

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.

Tableau 6. Codes d'état
Code d'état	Description
200	Réussi. La demande a été traitée avec succès.
401	L’utilisateur n’est pas authentifié.
403	L’utilisateur n’est pas autorisé. L’utilisateur ne dispose pas des rôles requis pour accéder à l’API. L’utilisateur n’a pas l’autorisation de lire la commande. Cette API nécessite l’accès à sn_csm_om.order_integrator et l’un des éléments suivants : sn_csm_om.consumer_agent : accès en écriture à l’API limité aux commandes B2C. sn_csm_om.customer_agent : accès en écriture à l’API limité aux commandes B2B. sn_csm_om.order_admin : accès en écriture à l’API pour les commandes B2B ou B2C.

Paramètres du corps de la réponse (JSON ou XML)


Nom	Description
compte	Sys_id d’un enregistrement situé dans la table Comptes [customer_account]. Identifie le compte pour les commandes B2B. Type de données : chaîne
actual_end_date	Date de fin de la commande. Format : format UTC, aaaa-MM-jj HH :mm :ss Type de données : chaîne
actual_start_date	Date de début de la commande. Format : format UTC, aaaa-MM-jj HH :mm :ss Type de données : chaîne
billing_city	Nom de la ville de facturation. Type de données : chaîne
billing_country	Abréviation du pays de facturation. Type de données : chaîne
billing_state	Abréviation de l’état ou de la province de facturation. Type de données : chaîne
billing_street	Adresse postale de facturation. Type de données : chaîne
billing_zip	Zip/code postal de facturation. Type de données : chaîne
commentaires	Informations supplémentaires pour la commande. Type de données : chaîne
consommateur	Sys_id d’un enregistrement de consommateur. Identifie le consommateur pour les commandes B2C. Type de données : chaîne
contact	Sys_id du contact client lié au compte. Type de données : chaîne Table : Contacts [customer_contact]
contrat	Sys_id de l’enregistrement Service client du contrat. Type de données : chaîne Table : Contrats [ast_contract]
erreur	Détails décrivant une erreur rencontrée au cours du processus de demande. Type de données : objet `"error": { "detail": "String", "message": "String" }`
erreur.détail	Détails de l’erreur rencontrée au cours du processus de demande. Type de données : chaîne
message.erreur	Message pour l’erreur rencontrée pendant le processus de demande. Chaque message d’erreur a une description correspondante dans la detail propriété. Type de données : chaîne
expected_end_date	Date de fin prévue de la commande. Format : format UTC, aaaa-MM-jj HH :mm :ss Type de données : chaîne
expected_start_date	Date de début prévue de la commande. Format : format UTC, aaaa-MM-jj HH :mm :ss Type de données : chaîne
external_id	ID externe représentant un enregistrement connexe sur le système d’un tiers. Type de données : chaîne
external_system	Nom du système du client. Type de données : chaîne
order_category	Type de commande de client. Valeurs possibles : produit service Type de données : chaîne
order_currency	Code de devise représentant la devise dans laquelle la commande a été achetée. Par exemple, `USD` pour le dollar américain. Cette devise est utilisée pour tous les champs de montant dans les ordres de commande et de ligne. Les codes de devise sont répertoriés dans la table Devises [fx_currency]. Remarque : Cette propriété peut ne pas être disponible dans les versions antérieures de Gestion des commandes. Type de données : chaîne
order_date	Date et heure de création de la commande. Format : format UTC, aaaa-MM-jj HH :mm :ss Type de données : chaîne
order_id	Numéro de commande de la commande. Type de données : chaîne Table : Ordres [sn_csm_om_order]
order_line_items	Requis. Liste des objets qui définissent chaque élément de ligne de commande de la commande. Type de données : tableau Propriétés requises dans chaque objet d’élément de ligne de commande : account pour les commandes B2B ou consumer B2C. product_offering – quantity unit_of_measurements order_line_characteristics "order_line_items": [ { "account": "String", "action": "String", "comments": "String", "consumer": "String", "contact": "String", "delivered_quantity": "String", "effective_date": "String", "expiration_date": "String", "external_id": "String", "external_system": "String", "list_price": "String", "location": "String", "order_line_characteristics": [Array], "order_line_id": "String", "order": "String", "parent_line_item": "String", "previous_product_model": "String", "price_list": "String", "product_offering": "String", "product_specification": "String", "product": "String", "quantity": "String", "shipping_city": "String", "shipping_country": "String", "shipping_state": "String", "shipping_street": "String", "shipping_zip": "String", "short_description": "String", "sku": "String", "sold_product": "String", "specification": "String", "state": "String", "status": "String", "sys_class_name": "String", "sys_created_by": "String", "sys_created_on": "String", "sys_id": "String", "sys_mod_count": "String", "sys_tags": "String", "sys_updated_by": "String", "sys_updated_on": "String", "top_line_item": "String", "total_price": "String", "unit_of_measurement": "String", "unit_price": "String", "work_notes": "String" } ] Table : éléments de ligne de commande [sn_csm_om_order_line_item]
order_line_items	Liste des objets qui définissent chaque élément de ligne de commande de la commande. Type de données : tableau d’objets "order_line_items": [ { "account": "String", "action": "String", "comments": "String", "consumer": "String", "contact": "String", "delivered_quantity": "String", "effective_date": "String", "expiration_date": "String", "external_id": "String", "external_system": "String", "list_price": "String", "location": "String", "order_line_characteristics": [Array], "order_line_id": "String", "order": "String", "parent_line_item": "String", "previous_product_model": "String", "price_list": "String", "product_offering": "String", "product_specification": "String", "product": "String", "quantity": "String", "shipping_city": "String", "shipping_country": "String", "shipping_state": "String", "shipping_street": "String", "shipping_zip": "String", "short_description": "String", "sku": "String", "sold_product": "String", "specification": "String", "state": "String", "status": "String", "sys_class_name": "String", "sys_created_by": "String", "sys_created_on": "String", "sys_id": "String", "sys_mod_count": "String", "sys_tags": "String", "sys_updated_by": "String", "sys_updated_on": "String", "top_line_item": "String", "total_price": "String", "unit_of_measurement": "String", "unit_price": "String", "work_notes": "String" } ]
order_line_items.compte	Requis pour les commandes B2B. Sys_id du compte professionnel affecté à cet élément de ligne de bon de commande. Situé dans la table Accounts (Comptes) [customer_account]. La propriété consommateur est requise pour les commandes B2C. Type de données : chaîne
order_line_items.compte	Sys_id du compte professionnel affecté à cet élément de ligne de bon de commande. Situé dans la table Accounts (Comptes) [customer_account]. Type de données : chaîne
order_line_items.action	Action qui détermine comment la ligne de commande est ajoutée à la commande. Valeurs possibles : ajouter changement Type de données : chaîne
order_line_items.commentaires	Informations supplémentaires pour l’élément de ligne de bon de commande. Type de données : chaîne
order_line_items.consommateur	Sys_id du consommateur affecté à cet élément de ligne de commande. Situé dans la table Consumers (Consommateurs) [csm_consumer]. Type de données : chaîne
order_line_items.Contacter	sys_id de contact associées au compte. Type de données : chaîne
order_line_items.quantité_livrée	Nombre d’éléments dans la commande livrée. Type de données : chaîne
order_line_items.date_effectif	Date d’effet de la ligne de commande. Format : aaaa-MM-jj HH :mm :ss dans le fuseau horaire UTC Type de données : chaîne
order_line_items.expiration_date	Date d’expiration de la ligne de commande. Format : aaaa-MM-jj HH :mm :ss dans le fuseau horaire UTC Type de données : chaîne
order_line_items.identificateur_externe	ID externe de l’élément de ligne de commande. Type de données : chaîne
order_line_items.système_externe	sys_id externe de l’élément de ligne de bon de commande. Type de données : chaîne
order_line_items. prix_liste	Prix catalogue unitaire de l’offre de produit. Remarque : Cette propriété peut ne pas être disponible dans les versions antérieures de Gestion des commandes. Type de données : chaîne
order_line_items.emplacement	Sys_id d’un enregistrement de lieu d’expédition. Type de données : chaîne Table : emplacements [cmn_location]
order_line_items.commande	Le numéro de commande de cet élément de ligne tel qu’indiqué dans la table Commandes [sn_csm_om_order]. Type de données : chaîne
order_line_items. order_line_characteristics	Liste des objets définissant les caractéristiques de ligne de commande associées. Les caractéristiques de ligne de commande se trouvent dans la table Caractéristiques de ligne de commande [sn_csm_om_order_characteristic_value]. Type de données : tableau d’objets `"order_line_characteristics": [ { "characteristic": "String", "characteristic_option": "String" } ]`
order_line_items.order_line_characteristics.characteristic_option	Option unique de la caractéristique du produit qui déclenche la règle d’exclusion. Par exemple, la taille ou la couleur du produit. Type de données : chaîne
order_line_items. order_line_characteristics. characteristic_option_value	Valeur d’une option de caractéristique. Type de données : chaîne
order_line_items. order_line_characteristics. external_id	ID externe de la caractéristique de la ligne de commande. Type de données : objet
order_line_items. order_line_characteristics.numéro	Numéro de caractéristique de ligne de commande . Type de données : chaîne Table : Caractéristiques de ligne de commande [sn_csm_om_order_characteristic_value]
order_line_items. order_line_characteristics. order_line_item	Sys_id de l’élément de ligne de commande de cette caractéristique. Type de données : chaîne Table : éléments de ligne de commande [sn_csm_om_order_line_item]
order_line_items. order_line_characteristics. previous_characteristic_option_value	Nom de l’option de caractéristique précédente associée au modèle de produit dans la ligne de commande. Type de données : objet
order_line_items. order_line_characteristics. spécification	Spécification du service associée à la caractéristique de commande de service. Type de données : chaîne
order_line_items. order_line_characteristics. sys_class_name	Nom du système de la table dans laquelle se trouve cet enregistrement de caractéristique de ligne de commande. Type de données : chaîne
order_line_characteristics. sys_created_by	Nom système de l’utilisateur qui a créé cet enregistrement. Type de données : chaîne
order_line_items. order_line_characteristics. sys_created_on	Date et heure auxquelles l’enregistrement a été créé à l’origine. Type de données : chaîne
order_line_items. order_line_characteristics. sys_domain	Champ d’application de domaine dans lequel l’enregistrement de commande est accessible. Par exemple, global. Type de données : chaîne
order_line_items. order_line_characteristics. sys_domain_path	Chemin de domaine pour l’enregistrement. Type de données : chaîne Par défaut : / (global)
order_line_items. order_line_characteristics. sys_id	Sys_id de l’enregistrement de commande Type de données : chaîne Table : Caractéristiques de ligne de commande [sn_csm_om_order_characteristic_value]
order_line_items. order_line_characteristics. sys_mod_count	Nombre de fois où cet enregistrement a été modifié. Type de données : chaîne
order_line_items. order_line_characteristics. sys_tags	Balises système pour le contenu. Type de données : chaîne
order_line_items. order_line_characteristics. sys_updated_by	Nom système de l’utilisateur qui a récemment mis à jour cet enregistrement. Type de données : chaîne
order_line_items. order_line_characteristics. sys_updated_on	Date et heure de dernière mise à jour de l’enregistrement. Type de données : chaîne
order_line_items. order_line_characteristics.type	Type de caractéristique de ligne de commande. Valeurs possibles : produit service Type de données : chaîne
order_line_items.ID_ligne_de_commande	Numéro de commande de la commande associée à cet élément de ligne de commande. Type de données : chaîne
order_line_items.parent_line_item	Le cas échéant, identifie un élément de ligne parent pour cet élément de ligne. Type de données : chaîne
order_line_items.previous_product_model	Sys_id du modèle de produit pour le produit répertorié avant cet élément dans la ligne de commande. Type de données : chaîne Table : Modèles de produits [cmdb_model]
order_line_items.liste_prix	Sys_id d’un enregistrement de liste de prix dans la table Listes de prix [sn_csm_pricing_price_list]. Remarque : Cette propriété peut ne pas être disponible dans les versions antérieures de Gestion des commandes. Type de données : chaîne
order_line_items.produit	Sys_id du produit Type de données : chaîne Table : Modèles de produits [cmdb_model]
order_line_items.offre_produit	Sys_id du produit répertorié dans la table Offres de produits [sn_prd_pm_product_offering]. Type de données : chaîne
order_line_items.produit	Sys_id du modèle de produit répertorié dans la table Modèles de produit [cmdb_model]. Doit être fourni avec l’élément de ligne de commande correspondant Type de données : chaîne
order_line_items.Spécification_du_produit	Sys_id de la spécification du produit associée à l’élément de ligne de bon de commande. Répertoriées dans le tableau des spécifications de produit [sn_prd_pm_product_specification]. Type de données : chaîne
order_line_items.quantité	Nombre de modèles de produits commandés. Type de données : chaîne
order_line_items.ville_livraison	Nom de la ville de destination. Type de données : chaîne
order_line_items.pays_livraison	Abréviation du pays de destination. Type de données : chaîne
order_line_items.état_livraison	Abréviation de l’état ou de la province de destination. Type de données : chaîne
order_line_items. rue_livraison	Adresse postale de destination. Type de données : chaîne
order_line_items.zip_livraison	Zip ou code postal de destination. Type de données : chaîne
order_line_items.description_courte	Brève description de l’élément de ligne de bon de commande. Type de données : chaîne
order_line_items.sku	Numéro généré par un fournisseur qui identifie de manière unique un produit vendu par ce fournisseur. Type de données : chaîne
order_line_items.produit_vendu	Sys_id d’un enregistrement de produit vendu de base d’installation. Type de données : chaîne Table : produits vendus [sn_install_base_sold_product]
order_line_items. spécification	Spécification de l’élément de ligne de commande. Type de données : chaîne
order_line_items.état	État de la ligne de commande. Par exemple, brouillon, nouveau, in_progress ou terminé. Type de données : chaîne
order_line_items.état	État de l’élément de ligne de bon de commande. Valeurs possibles : échec réussite Type de données : chaîne
nom_classe_order_line_items.sys	Nom du système de la table dans laquelle se trouve cet enregistrement d’élément de ligne de commande. Type de données : chaîne
order_line_items.sys_created_by	Nom système de l’utilisateur qui a créé cet enregistrement. Type de données : chaîne
order_line_items.sys_created_on	Date et heure auxquelles l’enregistrement a été créé à l’origine. Type de données : chaîne
order_line_items.sys_domaine	Champ d’application de domaine dans lequel l’enregistrement de commande est accessible. Par exemple, global. Type de données : chaîne
order_line_items.sys_chemin_domaine	Chemin de domaine pour l’enregistrement. Type de données : chaîne Par défaut : / (global)
order_line_items.sys_id	Sys_id de l’enregistrement de l’élément de ligne Type de données : chaîne Table : éléments de ligne de commande [sn_csm_om_order_line_item]
order_line_items.sys_mod_count	Nombre de fois où cet enregistrement a été modifié. Type de données : chaîne
order_line_items.sys_balises	Balises système pour le contenu. Type de données : chaîne
order_line_items.sys_updated_by	Nom système de l’utilisateur qui a récemment mis à jour cet enregistrement. Type de données : chaîne
order_line_items.sys_updated_on	Date et heure de dernière mise à jour de l’enregistrement. Type de données : chaîne
order_line_items.top_line_item	Prix total de tous les éléments de ligne de commande cumulés dans cette commande. Type de données : chaîne
order_line_items.prix_total	Prix total de la ligne de commande. L’API ne calcule pas le total en fonction du prix net et de la quantité. Type de données : chaîne
order_line_items.unité_de_mesure	Sys_id pour l’unité de mesure commandée répertoriée dans la table Unité de mesures [sn_prd_pm_uom]. Remarque : Cette propriété peut ne pas être disponible dans les versions antérieures de Gestion des commandes. Type de données : chaîne
order_line_items.unit_of_measurement	Requis. Sys_id pour l’unité de mesure commandée répertoriée dans la table Unité de mesures [sn_prd_pm_uom]. Remarque : Cette propriété peut ne pas être disponible dans les versions antérieures de Gestion des commandes. Type de données : chaîne
order_line_items.prix_unitaire	Prix net de l’offre de produits par unité. Type de données : chaîne Table : Instances de devises [fx_currency_instance]
order_line_items.notes_de_travail	Notes de travail internes de forme libre pour l’élément de ligne de bon de commande. Type de données : chaîne
order_type	Action de commande qui détermine comment la commande est ajoutée. Valeurs possibles : ajouter changement Type de données : chaîne
partenaire	Pour les commandes B2B, sys_id de l’enregistrement de partenaire associé pour un compte. Type de données : chaîne Table : comptes [customer_account]
partner_contact	Pour les commandes B2B, sys_id du contact principal du partenaire pour le compte partenaire. Type de données : chaîne Table : Contacts [customer_contact]
payment_ref_id	Identificateur unique du paiement. Par exemple, numéro de chèque. Type de données : chaîne
price_list	Sys_id de l’enregistrement de liste de prix associé. Le prix n’est pas calculé en fonction du prix net et de la quantité par cette API. Remarque : Cette propriété peut ne pas être disponible dans les versions antérieures de Gestion des commandes. Type de données : chaîne Table : Listes de prix [sn_csm_pricing_price_list]
quote_id	ID unique pour le devis de prix de la commande. Type de données : chaîne
same_as_shipping_address	Marqueur indiquant si l’adresse de l’acheteur est identique à l’adresse d’expédition. Valeurs valides : vrai : l’adresse de l’acheteur est la même que l’adresse de livraison. faux : l’adresse de l’acheteur est différente de l’adresse de livraison. Type de données : booléennes
shipping_city	Nom de la ville de destination. Type de données : chaîne
shipping_country	Abréviation du pays de destination. Type de données : chaîne
shipping_location	Sys_id d’un enregistrement de lieu d’expédition. Type de données : chaîne Table : emplacements [cmn_location]
shipping_state	Abréviation de l’état ou de la province de destination. Type de données : chaîne
shipping_street	Adresse postale de destination. Type de données : chaîne
shipping_zip	Zip ou code postal de destination. Type de données : chaîne
short_description	Brève description de la commande. Type de données : chaîne
special_instructions	Instructions spéciales pour la commande. Type de données : chaîne
État	État de la commande. Par exemple, Nouveau, in_progress ou Terminé. Type de données : chaîne
statut	État de la commande. Valeurs possibles : réussite échec Type de données : chaîne
sys_class_name	Nom système de la table dans laquelle se trouve cet enregistrement de commande. Type de données : chaîne
sys_created_by	Nom système de l’utilisateur qui a créé cet enregistrement. Type de données : chaîne
sys_created_on	Date et heure auxquelles l’enregistrement a été créé à l’origine. Type de données : chaîne
sys_domain	Champ d’application de domaine dans lequel l’enregistrement de commande est accessible. Par exemple, global. Type de données : chaîne
sys_domain_path	Chemin de domaine pour l’enregistrement. Type de données : chaîne Par défaut : / (global)
sys_id	Sys_id de l’enregistrement de commande. Type de données : chaîne Table : Ordres [sn_csm_om_order]
sys_mod_count	Nombre de fois où cet enregistrement a été modifié. Type de données : chaîne
sys_tags	Balises système pour le contenu. Type de données : chaîne
sys_updated_by	Nom système de l’utilisateur qui a récemment mis à jour cet enregistrement. Type de données : chaîne
sys_updated_on	Date et heure de dernière mise à jour de l’enregistrement. Type de données : chaîne
total_amount	Coût total pour l’ensemble de la commande. Type de données : chaîne

Demande cURL

L’exemple suivant montre comment obtenir une commande par son numéro de commande.

curl "https://instance.service-now.com/api/sn_ind_tmt_orm/order/ORD0001034" \
--request GET \
--header "Accept:application/json" \
--user 'username':'password'

Réponse :

{
  "result": {
    "actual_start_date": "",
    "payment_ref_id": null,
    "shipping_city": null,
    "channel": "api",
    "expected_end_date": "",
    "sys_updated_on": "2022-03-30 21:59:41",
    "price_list": null,
    "sys_updated_by": "username",
    "sys_created_on": "2022-03-30 21:59:41",
    "contact": "96d0461553ab70101aaeddeeff7b120b",
    "sys_domain": "global",
    "state": "draft",
    "order_type": "add",
    "sys_created_by": "eseruser",
    "shipping_street": null,
    "special_instructions": null,
    "contract": null,
    "quote_id": null,
    "expected_start_date": "",
    "sys_domain_path": "/",
    "billing_street": null,
    "billing_city": null,
    "total_amount": "2000",
    "order_id": "ORD0001034",
    "shipping_country": "USA",
    "status": "new",
    "short_description": null,
    "shipping_state": null,
    "external_id": null,
    "sys_class_name": "sn_csm_om_order",
    "sys_id": "24fdf5bd75eec510f877f30c01a15aa0",
    "shipping_zip": null,
    "billing_state": null,
    "billing_zip": null,
    "same_as_shipping_address": "0",
    "consumer": null,
    "comments": "",
    "order_currency": "USD",
    "billing_country": "USA",
    "sys_mod_count": "1",
    "billing_location": null,
    "shipping_location": null,
    "sys_tags": "",
    "order_date": "2022-03-30 21:59:41",
    "order_category": "product",
    "actual_end_date": "",
    "partner": null,
    "partner_contact": null,
    "account": "c480021553ab70101aaeddeeff7b120f",
    "external_system": null,
    "order_line_items": [
      {
        "short_description": null,
        "shipping_state": "CA",
        "shipping_city": "Santa Clara",
        "product_offering": "2d4376760f740110603bf634a7767e46",
        "external_id": null,
        "sys_updated_on": "2022-03-30 21:59:41",
        "expiration_date": "",
        "sys_class_name": "sn_csm_om_order_line_item",
        "sold_product": null,
        "sys_id": "ecfdf5bd75eec510f877f30c01a15aa3",
        "unit_of_measurement": "cb2795d553020110286eddeeff7b12ff",
        "price_list": null,
        "sys_updated_by": "username",
        "shipping_zip": "94560",
        "sys_created_on": "2022-03-30 21:59:41",
        "contact": "96d0461553ab70101aaeddeeff7b120b",
        "sys_domain": "global",
        "effective_date": "",
        "action": "add",
        "order_line_id": "ORDL0001060",
        "state": "draft",
        "sku": null,
        "consumer": null,
        "sys_created_by": "username",
        "order": "24fdf5bd75eec510f877f30c01a15aa0",
        "previous_product_model": null,
        "shipping_street": "222 Star St",
        "product": "561dba7e0f740110603bf634a7767ebe",
        "quantity": "1",
        "comments": "",
        "total_price": "2000",
        "parent_line_item": null,
        "sys_mod_count": "1",
        "specification": "104f66720f740110603bf634a7767e7d",
        "list_price": "2000",
        "unit_price": "2000",
        "sys_domain_path": "/",
        "sys_tags": "",
        "delivered_quantity": null,
        "top_line_item": null,
        "product_specification": "104f66720f740110603bf634a7767e7d",
        "location": null,
        "work_notes": "",
        "shipping_country": "USA",
        "account": "c480021553ab70101aaeddeeff7b120f",
        "external_system": null,
        "status": "new",
        "order_line_characteristics": [
          {
            "characteristic_option": "1c6ceabe0f340110603bf634a7767e97",
            "sys_mod_count": "0",
            "specification": "104f66720f740110603bf634a7767e7d",
            "external_id": null,
            "sys_updated_on": "2022-03-30 21:59:41",
            "type": "1",
            "sys_domain_path": "/",
            "sys_tags": "",
            "characteristic": "4e76f1b20fb00110603bf634a7767ee3",
            "sys_class_name": "sn_csm_om_order_characteristic_value",
            "previous_characteristic_option_value": null,
            "number": "ORC000001041",
            "sys_id": "acfd79bd75eec510f877f30c01a15a94",
            "sys_updated_by": "username",
            "sys_created_on": "2022-03-30 21:59:41",
            "sys_domain": "global",
            "characteristic_option_value": "1.2 cu",
            "order_line_item": "ecfdf5bd75eec510f877f30c01a15aa3",
            "sys_created_by": "user"
          },
          {
            "characteristic_option": "2d0d66fe0f340110603bf634a7767ef6",
            "sys_mod_count": "0",
            "specification": "104f66720f740110603bf634a7767e7d",
            "external_id": null,
            "sys_updated_on": "2022-03-30 21:59:41",
            "type": "1",
            "sys_domain_path": "/",
            "sys_tags": "",
            "characteristic": "11e639b20fb00110603bf634a7767e17",
            "sys_class_name": "sn_csm_om_order_characteristic_value",
            "previous_characteristic_option_value": null,
            "number": "ORC000001042",
            "sys_id": "e0fd79bd75eec510f877f30c01a15a95",
            "sys_updated_by": "username",
            "sys_created_on": "2022-03-30 21:59:41",
            "sys_domain": "global",
            "characteristic_option_value": "Stainless steel",
            "order_line_item": "ecfdf5bd75eec510f877f30c01a15aa3",
            "sys_created_by": "user"
          }
        ]
      }
    ]
  }
}

API de commande : POST /sn_ind_tmt_orm/order

Crée une nouvelle commande avec des éléments de ligne et des caractéristiques.

Les commandes avec des éléments de ligne sont définies à l’aide des paramètres de corps de la demande. Les propriétés suivantes sont requises dans la plupart des versions de Gestion des commandes:

account pour les commandes B2B ou consumer B2C.
- account – Sys_id d’un enregistrement situé dans la table Comptes [customer_account].
- consumer – Sys_id d’un enregistrement de consommateur.
order_currency – Code de devise représentant la devise dans laquelle la commande a été achetée. Par exemple, USD pour le dollar américain. Cette devise est utilisée pour tous les champs de montant dans les ordres de commande et de ligne. Les codes de devise sont répertoriés dans la table Devises [fx_currency].
order_line_items – Liste des objets qui définissent chaque élément de ligne de commande de la commande. Propriétés requises dans chaque objet d’élément de ligne de commande :
- account pour les commandes B2B ou consumer B2C.
  - account – Sys_id du compte professionnel affecté à cet élément de ligne de bon de commande. Situé dans la table Accounts (Comptes) [customer_account].
  - consumer – Sys_id du consommateur affecté à cet élément de ligne de commande. Situé dans la table Consumers (Consommateurs) [csm_consumer].
- order_line_characteristics – Liste des objets définissant les caractéristiques de ligne de commande associées. Les caractéristiques de ligne de commande se trouvent dans la table Caractéristiques de ligne de commande [sn_csm_om_order_characteristic_value].
- product_offering – Sys_id du produit répertorié dans la table Offres de produits [sn_prd_pm_product_offering].
- quantity – Nombre de modèles de produits commandés.
- unit_of_measurements – Sys_id pour l’unité de mesure commandée répertoriée dans la table Unité de mesures [sn_prd_pm_uom].

La table Paramètres du corps de la demande contient plus de détails.