API de commande

Rversion finale: Washingtondc

Mis à jour 1 févr. 2024

28 minutes de lecture

L’API de commande permet de récupérer et de créer des commandes avec des éléments de ligne de commande pour l’application Gestion du service clientèle (CSM) .

Cette API requiert l’application Order Management pour Gestion du service clientèle de stockage (app-csm-order-mgmt) et est fournie avec l’espace de noms sn_csm_order_mgmt . Pour plus d’informations, consultez Sales and Order Management.

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

sn_csm_om.consumer_agent – Accès en écriture de l’API restreint aux commandes B2C.
sn_csm_om.customer_agent – Accès en écriture de l’API restreint aux commandes B2B.
sn_csm_om.order_admin : accès en écriture de 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_csm_order_mgmt/order/{id}

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

Format d'URL

URL versionnée : /api/sn_csm_order_mgmt/{api_version}/order/{id}

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

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. Exemple : `v1` ou `v2`. Spécifiez uniquement cette valeur pour utiliser une version de point de terminaison différente de la dernière. Type de données : chaîne
ID	Sys_id ou numéro d’ordre (order_id) de l’enregistrement à récupérer situé dans la table Commandes [sn_csm_om_order]. Type de données : chaîne

Tableau 2. Paramètres de requête
Nom	Description
sysparm_display_value	Marqueur indiquant si la valeur d’affichage des champs de référence doit être affichée. Valeurs valides : true : affiche la valeur d’affichage des champs de référence, des champs de choix et du champ de date dans la réponse. false : affiche 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 à cette action HTTP uniquement ou s'appliquent à cette action d'une manière distincte. Pour obtenir une 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
Aucun

Codes d'état

Les codes d'état suivants s'appliquent à cette action HTTP. Pour obtenir une 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é correctement traitée.
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. L’accès à cette API nécessite sn_csm_om.order_integrator et l’un des éléments suivants : sn_csm_om.consumer_agent – Accès en écriture de l’API restreint aux commandes B2C. sn_csm_om.customer_agent – Accès en écriture de l’API restreint aux commandes B2B. sn_csm_om.order_admin : accès en écriture de l’API pour les commandes B2B ou B2C.

Paramètres de corps de 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 de facturation. Type de données : chaîne
billing_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 situé dans la table Consommateurs [csm_consumer]. Identifie le consommateur pour les commandes B2C. Type de données : chaîne
contact	Sys_id du contact client associé au compte. Répertorié dans la table Contacts [customer_contact]. Type de données : chaîne
Contrat	Sys_id du Service clientèle contrat répertorié dans la table Contrats [ast_contract]. Type de données : chaîne
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 d’erreur	Message de l’erreur rencontrée au cours du 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 les dollars américains. Cette devise est utilisée pour tous les champs de montant dans la commande et les commandes 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 Order Management. 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 répertoriée dans la table Commandes [sn_csm_om_order]. Type de données : chaîne
order_line_items	Requis. Liste d’objets qui définissent chaque élément de ligne de commande dans la commande. Situé dans la table Éléments de ligne de commande [sn_csm_om_order_line_item]. 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 pour les commandes 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" } ]
order_line_items	Liste d’objets qui définissent chaque élément de ligne de commande dans la commande. Situé dans la table Éléments de ligne de commande [sn_csm_om_order_line_item]. Type de données : tableau "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 business affecté à cet élément de ligne de commande. Situé dans la table Comptes [customer_account]. La propriété du consommateur est requise pour les commandes B2C. Type de données : chaîne
order_line_items.compte	Sys_id du compte business affecté à cet élément de ligne de commande. Situé dans la table 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 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 Consommateurs [csm_consumer]. Type de données : chaîne
order_line_items.contact	sys_id de contact associé au compte. Type de données : chaîne
order_line_items.quantité_livrée	Nombre d’éléments de la commande livrés. Type de données : chaîne
order_line_items.date_effective	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.date_expiration_	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.external_id	ID externe de l’élément de ligne de commande. Type de données : chaîne
order_line_items.system_externe_externe	sys_id externe de l’élément de ligne 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 Order Management. Type de données : chaîne
order_line_items.emplacement	Sys_id d’un emplacement d’expédition répertorié dans la table Emplacements [cmn_location]. Type de données : chaîne
order_line_items.commande	Numéro de commande de cet élément de ligne tel que répertorié 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 sont situées dans la table Caractéristiques de ligne de commande [sn_csm_om_order_characteristic_value]. `"order_line_characteristics": [ { "characteristic": "String", "characteristic_option": "String" } ]` Type de données : tableau
order_line_items.order_line_characteristics.characteristic_option	Option unique de 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. Nombre	Numéro de caractéristique de ligne de commande répertorié dans la table Caractéristiques de ligne de commande [sn_csm_om_order_characteristic_value]. Type de données : chaîne
order_line_items. order_line_characteristics. order_line_item	Sys_id de l’élément de ligne de commande de cette caractéristique dans la table Éléments de ligne de commande [sn_csm_om_order_line_item]. Type de données : chaîne
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 de service associée à la caractéristique de la 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 du 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 de création de l’enregistrement. Type de données : chaîne
order_line_items. order_line_characteristics. sys_domain	Périmètre 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 Valeur par défaut : / (global)
order_line_items. order_line_characteristics. sys_id	Sys_id de l’enregistrement de commande situé dans la table Caractéristiques de ligne de commande [sn_csm_om_order_characteristic_value]. Type de données : chaîne
order_line_items. order_line_characteristics. sys_mod_count	Nombre de fois que 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 du système de l’utilisateur qui a mis à jour cet enregistrement en dernier. 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. Type order_line_characteristics	Type de caractéristique de ligne d’ordre. Valeurs possibles : produit service Type de données : chaîne
order_line_items.ligne_de_commande_id	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.élément_ligne_parent	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.modèle_du_produit_précédent	Identifie le modèle de produit pour le produit répertorié avant cet élément dans la ligne de commande. Sys_id du produit répertorié dans la table Modèles de produits [cmdb_model]. Type de données : chaîne
liste de prix order_line_items.price	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 Order Management. Type de données : chaîne
order_line_items.produit	Sys_id du produit répertorié dans la table Modèles de produits [cmdb_model]. Type de données : chaîne
order_line_items.offre_de_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 produits [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_produit	Sys_id de la spécification de produit associée à l’élément de ligne de commande. Répertorié dans la table 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_d’expédition	Nom de la ville de destination. Type de données : chaîne
order_line_items.pays_d’expédition	Abréviation du pays de destination. Type de données : chaîne
order_line_items.état_de_livraison	Abréviation de l’état ou de la province de destination. Type de données : chaîne
order_line_items.rue_expédition	Adresse postale de destination. Type de données : chaîne
order_line_items.shipping_zip	Code postal de destination. Type de données : chaîne
order_line_items.brève_description	Brève description de l’élément de ligne de commande. Type de données : chaîne
order_line_items.sku	Nombre généré par un fournisseur qui identifie de manière unique un produit qu'il vend. Type de données : chaîne
order_line_items.produit_soldé	Sys_id d’un produit vendu de base d’installation répertorié dans la table Produits vendus [sn_install_base_sold_product]. Type de données : chaîne
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.Statut	État de l’élément de ligne de commande. Valeurs possibles : succès échec Type de données : chaîne
order_line_items.sys_nom_de_classe	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_créée_par	Nom du 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 de création de l’enregistrement. Type de données : chaîne
order_line_items.sys_domaine	Périmètre de domaine dans lequel l’enregistrement de commande est accessible. Par exemple, global. Type de données : chaîne
chemin_domaine_order_line_items.sys	Chemin de domaine pour l’enregistrement. Type de données : chaîne Valeur par défaut : / (global)
order_line_items.sys_id	Sys_id de l’enregistrement de l’élément de ligne situé dans la table Éléments de ligne de commande [sn_csm_om_order_line_item]. Type de données : chaîne
order_line_items.sys_compte_mod	Nombre de fois que cet enregistrement a été modifié. Type de données : chaîne
order_line_items.sys_tags	Balises système pour le contenu. Type de données : chaîne
order_line_items.sys_updated_by	Nom du système de l’utilisateur qui a mis à jour cet enregistrement en dernier. 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. élément de ligne supérieure	Prix total de tous les éléments de ligne de commande accumulés dans cette commande. Type de données : chaîne
order_line_items.total_price	Prix total de la ligne de commande. L’API ne calcule pas le total en fonction du prix et de la quantité nets. Type de données : chaîne
order_line_items.unite_de_mesure	Sys_id de 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 Order Management. Type de données : chaîne
order_line_items.unit_of_measurement	Requis. Sys_id de 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 Order Management. Type de données : chaîne
order_line_items.prix_unitaire	Prix net de l’offre de produits par unité répertoriée dans la table Instances de devises [fx_currency_instance]. Type de données : chaîne
order_line_items.notes_de_travail	Notes de travail internes de forme libre pour l’élément de ligne de commande. Type de données : chaîne
order_type	Action de commande qui détermine la façon dont la commande est ajoutée. Valeurs possibles : ajouter changement Type de données : chaîne
Partenaire	Pour les commandes B2B, sys_id du partenaire associé pour un compte répertorié dans la table Comptes [customer_account]. Type de données : chaîne
partner_contact	Pour les commandes B2B, sys_id du contact principal du partenaire pour le compte partenaire. Répertorié dans la table Contacts [customer_contact]. Type de données : chaîne
payment_ref_id	Identificateur unique du paiement. Par exemple, numéro de vérification. Type de données : chaîne
price_list	Sys_id de la liste de prix associée répertoriée dans la table Listes de prix [sn_csm_pricing_price_list]. Le prix n’est pas calculé sur la base 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 Order Management. Type de données : chaîne
quote_id	ID unique pour l’estimation du prix de la commande. Type de données : chaîne
same_as_shipping_address	Marqueur indiquant si l’adresse de l’acheteur est la même que l’adresse de livraison. Valeurs valides : true : l’adresse de l’acheteur est la même que l’adresse de livraison. false : 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 emplacement d’expédition répertorié dans la table Emplacements [cmn_location]. Type de données : chaîne
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	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 : succès échec Type de données : chaîne
sys_class_name	Nom du système de la table dans laquelle se trouve cet enregistrement de commande. Type de données : chaîne
sys_created_by	Nom du système de l’utilisateur qui a créé cet enregistrement. Type de données : chaîne
sys_created_on	Date et heure de création de l’enregistrement. Type de données : chaîne
sys_domain	Périmètre 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 Valeur par défaut : / (global)
sys_id	Sys_id de la commande répertoriée dans la table Commandes [sn_csm_om_order]. Type de données : chaîne
sys_mod_count	Nombre de fois que 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 du système de l’utilisateur qui a mis à jour cet enregistrement en dernier. 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 à l’aide de son numéro de commande.

curl "https://instance.service-now.com/api/sn_csm_order_mgmt/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_csm_order_mgmt/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 Order Management:

account pour les commandes B2B ou consumer pour les commandes B2C.
- account – Sys_id d’un enregistrement situé dans la table Comptes [customer_account].
- consumer – Sys_id d’un enregistrement situé dans la table Consommateurs [csm_consumer].
order_currency – Code de devise représentant la devise dans laquelle la commande a été achetée. Par exemple, USD pour les dollars américains. Cette devise est utilisée pour tous les champs de montant dans la commande et les commandes de ligne. Les codes de devise sont répertoriés dans la table Devises [fx_currency].
order_line_items – Liste d’objets qui définissent chaque élément de ligne de commande dans la commande. Situé dans la table Éléments de ligne de commande [sn_csm_om_order_line_item]. Propriétés requises dans chaque objet d’élément de ligne de commande :
- account pour les commandes B2B ou consumer pour les commandes B2C.
  - account – Sys_id du compte business affecté à cet élément de ligne de commande. Situé dans la table Comptes [customer_account].
  - consumer – Sys_id du consommateur affecté à cet élément de ligne de commande. Situé dans la table 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 sont situées 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 de 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.