---
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


---

# CartJS - Dans le champ d'application

# CartJS - Dans le champ d'application {#ariaid-title1}

* Rversion finale: Xanadu
* 
* Mis à jour 1 août 2024
* 
* ![](https://www.servicenow.com/docs/portal-asset/ico-clock) 9 minutes de lecture

L'API CartJS fournit des méthodes qui vous permettent d'accéder au panier d'achat d'un utilisateur.

Cette API s'exécute dans l'espace de noms `sn_sc` . Le module d'extension Service Catalog Scoped API (ID : com.glideapp.servicecatalog.scoped.api), qui est activé par défaut, est requis pour accéder à l'API CartJS .

## CartJS : CartJS(String cartName) {#ariaid-title2}

Crée une instance de la classe CartJS avec le nom d'un panier défini pour l'utilisateur actuellement connecté.
{#r_CJSS-CartJS_S__table_zs3_bhy_5z__entry__3}

| Nom | Type | Description |
|-|-|-|
| nom du panier | Chaîne | Facultatif. Nom d'un panier défini pour l'utilisateur actuellement connecté. |
[Tableau 1. Paramètres]

{#r_CJSS-CartJS_S__table_zs3_bhy_5z}  

    var cart = new sn_sc.CartJS(cart1);

## CartJS : addToCart(demande de carte) {#ariaid-title3}

Ajoute la demande d'un élément de catalogue au panier actuel.
{#r_CJSS-addToCart_M__table_ecz_zjy_5z__entry__3}

| Nom | Type | Description |
|-|-|-|
| request | Carte | Un objet JSON qui contient les détails de l'élément de catalogue à ajouter au panier. La structure de l'objet de la demande est la suivante : { 'sysparm_id': item_id, 'sysparm_quantity': item_quantity, 'variables':{ 'var_name': 'var_value', ... } } * item_id : sys_id de l'élément à ajouter au panier * item_quantity : nombre d'éléments à ajouter. La valeur par défaut est 1. * var_name : Nom de la question. * var_value : valeur de la réponse (pas la valeur d'affichage). {#r_CJSS-addToCart_M__ul_tdn_1ly_5z} |
[Tableau 2. Paramètres]

{#r_CJSS-addToCart_M__table_ecz_zjy_5z} {#r_CJSS-addToCart_M__table_fcz_zjy_5z__entry__2}

| Type | Description |
|-|-|
| JSON | Structure du panier actuel. { 'subtotal': value, 'items':[ { itemName:'', quantity:'', price:'', recurring_price:'' } ...] } |
[Tableau 3. Renvoie]

{#r_CJSS-addToCart_M__table_fcz_zjy_5z}  
Cet exemple montre comment ajouter plusieurs éléments au panier. Notez que `var cart = new sn_sc. CartJS() ;` se trouve à l'intérieur de la boucle. Vous devez appeler `sn_sc. CartJS()` plusieurs fois pour pouvoir ajouter plusieurs articles au panier.

    for (i = 0; i < 2; i++) { 
    var cart = new sn_sc.CartJS();
    var item =
    {
    'sysparm_id': '0d08837237153000158bbfc8bcbe5d02',
    'sysparm_quantity': '1',
    'variables':{
    'carrier': 'at_and_t_mobility',
    'data_plan': '500MB',
    'duration': 'eighteen_months',
    'color': 'slate',
    'storage': 'sixtyfour' 
    }};
    var cartDetails = cart.addToCart(item);
    gs.info(JSON.stringify(cartDetails));
    }

Sortie

    //The cart after the first item is added
    {
      "cart_id": "c0f5828a1b476010593876a61a4bcb71",
      "subtotal": "$599.99",
      "items": [
        {
          "catalog_item_id": "0d08837237153000158bbfc8bcbe5d02",
          "quantity": "1",
          "localized_price": "$599.99",
          "price": "$599.99",
          "recurring_frequency": "Monthly",
          "localized_recurring_price": "$30.00",
          "recurring_price": "$29.00",
          "item_name": "Apple iPhone 5",
          "cart_item_id": "40f5828a1b476010593876a61a4bcb72"
        }
      ]
    }

    //The cart after the second item is added
    {
      "cart_id": "c0f5828a1b476010593876a61a4bcb71",
      "subtotal": "$1,199.98",
      "items": [
        {
          "catalog_item_id": "0d08837237153000158bbfc8bcbe5d02",
          "quantity": "1",
          "localized_price": "$599.99",
          "price": "$599.99",
          "recurring_frequency": "Monthly",
          "localized_recurring_price": "$30.00",
          "recurring_price": "$29.00",
          "item_name": "Apple iPhone 5",
          "cart_item_id": "40f5828a1b476010593876a61a4bcb72"
        },
        {
          "catalog_item_id": "0d08837237153000158bbfc8bcbe5d02",
          "quantity": "1",
          "localized_price": "$599.99",
          "price": "$599.99",
          "recurring_frequency": "Monthly",
          "localized_recurring_price": "$30.00",
          "recurring_price": "$29.00",
          "item_name": "Apple iPhone 5",
          "cart_item_id": "98f5828a1b476010593876a61a4bcb75"
        }
      ]
    }

## CartJS : canViewRF() {#ariaid-title4}

Spécifie si l'utilisateur actuel a le rôle requis pour modifier le champ Demande pour .
{#CJSS-canViewRF__table_jy1_pzt_qbb__entry__3}

| Nom | Type | Description |
|-|-|-|
| Aucun |   |   |
[Tableau 4. Paramètres]

{#CJSS-canViewRF__table_jy1_pzt_qbb} {#CJSS-canViewRF__table_ky1_pzt_qbb__entry__2}

| Type | Description |
|-|-|
| Booléen | Marqueur indiquant si l'utilisateur dispose du rôle requis pour modifier le champ demandé pour. Valeurs possibles : * true : l'utilisateur a le rôle requis. * faux : l'utilisateur ne possède pas le rôle requis. Type de données : booléennes |
[Tableau 5. Renvoie]

{#CJSS-canViewRF__table_ky1_pzt_qbb}  
Cet exemple de code de script en arrière-plan montre comment vérifier si l'utilisateur actuel dispose du rôle nécessaire pour modifier le champ demandé pour.

    gs.log(sn_sc.CartJS.canViewRF());

Réponse :

    true

## CartJS : checkoutCart() {#ariaid-title5}

Effectue la validation du panier. Si la validation en deux étapes est activée, renvoie le récapitulatif de la commande. Si la validation en deux étapes est désactivée, le panier est envoyé et les détails de la demande générée sont renvoyés.
{#r_CJSS-checkoutCart__table_vqd_hsd_zz__entry__3}

| Nom | Type | Description |
|-|-|-|
| Aucun |   |   |
[Tableau 6. Paramètres]

{#r_CJSS-checkoutCart__table_vqd_hsd_zz} {#r_CJSS-checkoutCart__table_wqd_hsd_zz__entry__2}

| Type | Description |
|-|-|
| JSON | Si la validation en deux étapes est activée, le récapitulatif des éléments dans le panier est renvoyé. { "subtotal_price":"", "subtotal_recurring_frequency":"", "delivery_address":"", "special_instructions":"", "total_title":"", "requested_for_user":"System Administrator", "requested_for":"6816f79cc0a8016401c5a33be04be441", "daily": ["frequency_subtotal":"", "items":[{}, {}, ...], ...], "monthly":["frequency_subtotal":"", "items":[{}, {}, ...], ...], "annually":["frequency_subtotal":"", "items":[{}, {}, ...], ...], "none":["frequency_subtotal":"", "items":[{}, {}, ...], ...], } Si la validation en deux étapes est désactivée : { 'request_id' : "sys_id of the generated request", "request_number" : "Number of the generated request" } |
[Tableau 7. Renvoie]

{#r_CJSS-checkoutCart__table_wqd_hsd_zz}  

    var cart = new sn_sc.CartJS();
    var checkoutInfo = cart.checkoutCart();
    gs.info(checkoutInfo);

Sortie

    If two step checkout enabled:
    {"subtotal_price":"$2,748.49","subtotal_recurring_frequency":"","delivery_address":"","special_instructions":"","total_title":"Total","requested_for_user":"System Administrator","requested_for":"6816f79cc0a8016401c5a33be04be441","weekly":{"subtotal_price":"$399.50","subtotal_recurring_frequency":"Weekly","subtotal_recurring_price":"$0.00","total_title":"Total","items":[{"catalog_item_id":"e90a0f7237153000158bbfc8bcbe5d7f","variables":{},"quantity":"1","localized_price":"$399.50","price":"$399.50","recurring_frequency":"Weekly","localized_recurring_price":"$0.00","recurring_price":"$0.00","item_name":"Brother Network-Ready Color Laser Printer","cart_item_id":"f3f5c9b3c322320076173b0ac3d3ae00","delivery_time":"2 Days"}],"show_subtotal_price":"true","subtotal_title":"Subtotal"},"show_subtotal_price":"true","cart_id":"251c0562c326320076173b0ac3d3aeb4","subtotal_recurring_price":"$131.00","monthly":{"subtotal_price":"$849.99","subtotal_recurring_frequency":"Monthly","subtotal_recurring_price":"$31.00","total_title":"Total","items":[{"catalog_item_id":"d82ea08510247200964f77ffeec6c4ee","variables":{"Monthly data allowance":"500MB","Storage":"64GB","Color":"Space Gray","Is this a replacement for a lost or broken iPhone?":"No","What was the original phone number?":""},"quantity":"1","localized_price":"$799.99","price":"$849.99","recurring_frequency":"Monthly","localized_recurring_price":"$30.00","recurring_price":"$31.00","item_name":"Apple iPhone 6s Plus","cart_item_id":"18c509b3c322320076173b0ac3d3aef4","delivery_time":"2 Days"}],"show_subtotal_price":"true","subtotal_title":"Subtotal"},"yearly":{"subtotal_price":"$1,499.00","subtotal_recurring_frequency":"Annually","subtotal_recurring_price":"$100.00","total_title":"Total","items":[{"catalog_item_id":"774906834fbb4200086eeed18110c737","variables":{"Adobe Photoshop":"false","Adobe Acrobat":"false","Optional Software":"","Additional software requirements":"","Eclipse IDE":"true"},"quantity":"1","localized_price":"$1,499.00","price":"$1,499.00","recurring_frequency":"Annually","localized_recurring_price":"$100.00","recurring_price":"$100.00","item_name":"Developer Laptop (Mac)","cart_item_id":"6306c9b3c322320076173b0ac3d3ae89","delivery_time":"5 Days"}],"show_subtotal_price":"true","subtotal_title":"Subtotal"},"subtotal_title":"Subtotal"}
    If two step checkout disabled:
    {"request_number":"REQ0010001","request_id":"2f2789f3c322320076173b0ac3d3ae62"}

## CartJS - empty() {#ariaid-title6}

Supprime le panier actuel.
{#r_CJSS-empty__table_pzw_gjy_5z__entry__3}

| Nom | Type | Description |
|-|-|-|
| Aucun |   |   |
[Tableau 8. Paramètres]

{#r_CJSS-empty__table_pzw_gjy_5z} {#r_CJSS-empty__table_qzw_gjy_5z__entry__2}

| Type | Description |
|-|-|
| nul |   |
[Tableau 9. Renvoie]

{#r_CJSS-empty__table_qzw_gjy_5z}  

    var cart = new sn_sc.CartJS();
          cart.empty();

## CartJS : getCartDetails() {#ariaid-title7}

Renvoie les détails du panier.
{#CJSS-getCartDetails__table_kct_215_qbb__entry__3}

| Nom | Type | Description |
|-|-|-|
| Aucun |   |   |
[Tableau 10. Paramètres]

{#CJSS-getCartDetails__table_kct_215_qbb} {#CJSS-getCartDetails__table_lct_215_qbb__entry__2}

| Type | Description |
|-|-|
| Objet | Objet pointant vers les détails du panier actuel. |
[Tableau 11. Renvoie]

{#CJSS-getCartDetails__table_lct_215_qbb}  
Exemple :

    var cart=new sn_sc.CartJS();
    	console.log (cart.getCartDetails());

Sortie :

    delivery_address : "Brasilia,Brasil" 
            name : "DEFAULT" 
            requested_for : "62826bf03710200044e0bfc8bcbe5df1" 
            requested_for_display_name : "Abel Tuter" 
            special_instructions : "" 
            sys_id : "c2ac090087150300318d05a888cb0bd7" 

## CartJS : getCartID() {#ariaid-title8}

Renvoie l'ID du panier actuel.
{#r_CJSS-getCartID__table_l4t_j3y_5z__entry__3}

| Nom | Type | Description |
|-|-|-|
| Aucun |   |   |
[Tableau 12. Paramètres]

{#r_CJSS-getCartID__table_l4t_j3y_5z} {#r_CJSS-getCartID__table_m4t_j3y_5z__entry__2}

| Type | Description |
|-|-|
| Chaîne | Sys_id du panier actuel. |
[Tableau 13. Renvoie]

{#r_CJSS-getCartID__table_m4t_j3y_5z}  
Renvoie l'sys_id du panier actuel.

    var cart = new sn_sc.CartJS();
    var cartId = cart.getCartID();
    gs.info(cartId);

Sortie

    039c516237b1300054b6a3549dbe5dfc

## CartJS : getCartItems() {#ariaid-title9}

Renvoie un objet GlideRecord contenant des enregistrements pour les éléments du panier actuel.
{#r_CJSS-getCartItems__table_c5z_53y_5z__entry__3}

| Nom | Type | Description |
|-|-|-|
| Aucun |   |   |
[Tableau 14. Paramètres]

{#r_CJSS-getCartItems__table_c5z_53y_5z} {#r_CJSS-getCartItems__table_d5z_53y_5z__entry__2}

| Type | Description |
|-|-|
| GlideRecord | Objet GlideRecord incluant les enregistrements et les champs de la table Élément \[sc_cart_item\] qui décrivent un élément dans le panier actuel. |
[Tableau 15. Renvoie]

{#r_CJSS-getCartItems__table_d5z_53y_5z}  
Renvoie les valeurs du champ Quantité et Élément de catalogue pour les éléments du panier actuel.

    var cart = new sn_sc.CartJS();

    var cartItems = cart.getCartItems();
    while (cartItems.next()) {
      gs.info(cartItems.getElement('quantity').getDisplayValue()
      + " x "
      + cartItems.getElement('cat_item').getDisplayValue());
    }

Sortie


    1 x Apple iPhone 6s Plus
    1 x Apple iPhone 6s
    1 x Apple MacBook Pro 15"

## CartJS : getDeliveryAddress() {#ariaid-title10}

Renvoie l'adresse de livraison du panier actuel.
{#r_CJSS-getDeliveryAddress__table_ns4_cny_5z__entry__3}

| Nom | Type | Description |
|-|-|-|
| Aucun |   |   |
[Tableau 16. Paramètres]

{#r_CJSS-getDeliveryAddress__table_ns4_cny_5z} {#r_CJSS-getDeliveryAddress__table_os4_cny_5z__entry__2}

| Type | Description |
|-|-|
| Chaîne | Adresse de livraison du panier actuel. |
[Tableau 17. Renvoie]

{#r_CJSS-getDeliveryAddress__table_os4_cny_5z}  
Définit, puis renvoie l'adresse de livraison du panier actuel.

    var cart = new sn_sc.CartJS();
    cart.setDeliveryAddress("Brasilia, Brasil");
    var deliveryAddress = cart.getDeliveryAddress();
    gs.info(deliveryAddress);

Sortie

    Brasilia, Brasil

## CartJS : getRequestedFor() {#ariaid-title11}

Renvoie le sys_id de l'utilisateur pour lequel le panier est demandé.
{#r_CJSS-getRequestedFor__table_wds_4ly_5z__entry__3}

| Nom | Type | Description |
|-|-|-|
| Aucun |   |   |
[Tableau 18. Paramètres]

{#r_CJSS-getRequestedFor__table_wds_4ly_5z} {#r_CJSS-getRequestedFor__table_xds_4ly_5z__entry__2}

| Type | Description |
|-|-|
| Chaîne | Sys_id de la fiche utilisateur pour laquelle le panier est demandé ; situé dans la table Utilisateur \[sys_user\]. |
[Tableau 19. Renvoie]

{#r_CJSS-getRequestedFor__table_xds_4ly_5z}  
Renvoie l'utilisateur sys_id associé au panier.

    var cart = new sn_sc.CartJS();
    cart.setRequestedFor("039c516237b1300054b6a3549dbe5dfc")
    var userId = cart.getRequestedFor();
    gs.info(userId);

Sortie

    039c516237b1300054b6a3549dbe5dfc

## CartJS : getRequestedForDisplayName() {#ariaid-title12}

Renvoie le nom de l'utilisateur pour lequel le panier actuel est demandé.
{#r_CJSS-getRequestedForDisplayName__table_y4j_dmy_5z__entry__3}

| Nom | Type | Description |
|-|-|-|
| Aucun |   |   |
[Tableau 20. Paramètres]

{#r_CJSS-getRequestedForDisplayName__table_y4j_dmy_5z} {#r_CJSS-getRequestedForDisplayName__table_z4j_dmy_5z__entry__2}

| Type | Description |
|-|-|
| Chaîne | Nom de l'utilisateur pour lequel le panier actuel est demandé ; situé dans la table Utilisateur \[sys_user\]. |
[Tableau 21. Renvoie]

{#r_CJSS-getRequestedForDisplayName__table_z4j_dmy_5z}  
Renvoie le nom de l'utilisateur associé au panier.

    var cart = new sn_sc.CartJS();
    var userName = cart.getRequestedForDisplayName();
    gs.info(userName);

Sortie

    Abel Tuter

## CartJS : getSpecialInstructions() {#ariaid-title13}

Renvoie les instructions spéciales pour le panier actuel.
{#r_CJSS-getSpecialInstructions__table_mj2_5my_5z__entry__3}

| Nom | Type | Description |
|-|-|-|
| Aucun |   |   |
[Tableau 22. Paramètres]

{#r_CJSS-getSpecialInstructions__table_mj2_5my_5z} {#r_CJSS-getSpecialInstructions__table_nj2_5my_5z__entry__2}

| Type | Description |
|-|-|
| Chaîne | Instructions spéciales pour le panier actuel. |
[Tableau 23. Renvoie]

{#r_CJSS-getSpecialInstructions__table_nj2_5my_5z}  
Cet exemple montre comment définir et récupérer les instructions spéciales pour le panier actuel.

    var cart = new sn_sc.CartJS();
    cart.setSpecialInstructions("Delivery before 8 AM.");
    var specInstruction = cart.getSpecialInstructions();
    gs.info(specInstruction);

Sortie

    Delivery before 8 AM.

## CartJS : orderNow (demande de carte) {#ariaid-title14}

Commande un seul élément. Si la validation en deux étapes est activée, la méthode ajoute l'élément spécifié au panier et renvoie la sys_id du panier. Si la validation en deux étapes est désactivée, la méthode finalise l'achat de l'élément spécifié et renvoie le sys_id de la demande générée.
{#r_CJSS-orderNow_M__table_n4w_b4d_zz__entry__3}

| Nom | Type | Description |
|-|-|-|
| request | Carte | Objet JSON contenant les détails de l'élément de catalogue à commander. |
| request.delivery_address | Chaîne | Adresse à laquelle livrer les éléments. Par défaut : adresse de l'utilisateur |
| request.sysparm_id | Chaîne | Requis. La sys_id de l'élément à acheter. |
| request.special_instructions | Chaîne | Instructions à suivre lors du traitement de la commande. |
| request.sysparm_quantity | Chaîne | Quantité de l'élément spécifié à acheter. Valeur par défaut : 1 |
| request.sysparm_requested_for | Chaîne | sys_id de l'utilisateur pour lequel l'élément est demandé. Par défaut : utilisateur de la session |
| demande.variables | Tableau | Questions et réponses du client associées à l'élément. |
| request.variables.var_name | Chaîne | Nom de la question. |
| request.variables.var_value | Chaîne | Réponse du client à la question associée. |
[Tableau 24. Paramètres]

{#r_CJSS-orderNow_M__table_n4w_b4d_zz} {#r_CJSS-orderNow_M__table_o4w_b4d_zz__entry__2}

| Type | Description |
|-|-|
| Paires clé/valeur JSON | Sortie si la validation en deux étapes est activée : { 'cart_id' : '<sys_id of the cart to which the items were added>' } Sortie si la validation en deux étapes est désactivée : { 'request_id' : '<sys_id of the generated request>', 'request_number' : '<Number of the generated request>' } |
[Tableau 25. Renvoie]

{#r_CJSS-orderNow_M__table_o4w_b4d_zz}  


    var cart = new sn_sc.CartJS();
    var request =
    {
      'sysparm_id': '0d08837237153000158bbfc8bcbe5d02',
      'sysparm_quantity': '1',
      'variables':{
        'carrier': 'at_and_t_mobility',
        'data_plan': '500MB',
        'duration': 'eighteen_months',
        'color': 'slate',
        'storage': 'sixtyfour'
      }
    }
    var cartDetails = cart.orderNow(request);
    gs.info(cartDetails);

Sortie


    // If two-step checkout is enabled:
    {"cart_id":"55384df3c322320076173b0ac3d3aec5"}

    // If two-step checkout is disabled:
    {"request_id":"4c690137c322320076173b0ac3d3ae03", "request_number": "REQ0010003"}

## CartJS : setDeliveryAddress(String address) {#ariaid-title15}

Définit l'adresse de livraison du panier actuel.
{#r_CJSS-setDeliveryAddress_S__table_xjn_kny_5z__entry__3}

| Nom | Type | Description |
|-|-|-|
| adresse | Chaîne | Adresse de livraison du panier actuel. |
[Tableau 26. Paramètres]

{#r_CJSS-setDeliveryAddress_S__table_xjn_kny_5z} {#r_CJSS-setDeliveryAddress_S__table_yjn_kny_5z__entry__2}

| Type | Description |
|-|-|
| nul |   |
[Tableau 27. Renvoie]

{#r_CJSS-setDeliveryAddress_S__table_yjn_kny_5z}  


          var cart = new sn_sc.CartJS();
          cart.setDeliveryAddress("Brasilia, Brasil"); 
          
## CartJS : setRequestedFor(utilisateur de chaîne) {#ariaid-title16}

Définit le sys_id dans l'enregistrement de sys_user de l'utilisateur pour lequel le panier est demandé.
{#CJSS-setRequestedFor_S__table_rdc_gxt_qbb__entry__3}

| Nom | Type | Description |
|-|-|-|
| utilisateur | Chaîne | sys_id à définir dans l'enregistrement sys_user de l'utilisateur pour lequel le panier est demandé. |
[Tableau 28. Paramètres]

{#CJSS-setRequestedFor_S__table_rdc_gxt_qbb} {#CJSS-setRequestedFor_S__table_sdc_gxt_qbb__entry__2}

| Type | Description |
|-|-|
| nul |   |
[Tableau 29. Renvoie]

{#CJSS-setRequestedFor_S__table_sdc_gxt_qbb}  


    var cart = new sn_sc.CartJS();
    cart.setRequestedFor("039c516237b1300054b6a3549dbe5dfc")

## CartJS - setSpecialInstructions(String specialInstructions) {#ariaid-title17}

Définit les instructions spéciales pour le panier actuel.
{#r_CJSS-setSpecialInstructions_S__table_iwt_5ny_5z__entry__3}

| Nom | Type | Description |
|-|-|-|
| Instructions spéciales | Chaîne | Instructions spéciales pour le panier actuel. |
[Tableau 30. Paramètres]

{#r_CJSS-setSpecialInstructions_S__table_iwt_5ny_5z} {#r_CJSS-setSpecialInstructions_S__table_jwt_5ny_5z__entry__2}

| Type | Description |
|-|-|
| nul |   |
[Tableau 31. Renvoie]

{#r_CJSS-setSpecialInstructions_S__table_jwt_5ny_5z}  


          var cart = new sn_sc.CartJS();
          cart.setSpecialInstructions("Delivery before 8 AM."); 
       
## CartJS : submitOrder(demande de carte) {#ariaid-title18}

Met à jour les instructions spéciales, la demande et l'adresse request de livraison à partir du paramètre et vérifie le panier. Utilisez cette API pour modifier les paramètres mentionnés du panier et effectuer le paiement simultanément. Les paramètres manquants dans l'objet request auront leur valeur par défaut.
{#r_CJSS-submitOrder_M__table_ymx_brd_zz__entry__3}

| Nom | Type | Description |
|-|-|-|
| request | Carte | Objet JSON qui contient les détails du panier à soumettre. { 'special_instructions': "String", 'requested_for': '"String", 'delivery_address': "String" } |
| request.special_instructions | Chaîne | Instructions spéciales à inclure dans la commande. |
| request.requested_for | Chaîne | Sys_id de l'utilisateur pour lequel la commande est demandée. Situé dans la table Utilisateur \[sys_user\]. Par défaut : l'utilisateur actuel. |
| request.delivery_address | Chaîne | Adresse de livraison de la commande. |
[Tableau 32. Paramètres]

{#r_CJSS-submitOrder_M__table_ymx_brd_zz} {#r_CJSS-submitOrder_M__table_zmx_brd_zz__entry__2}

| Type | Description |
|-|-|
| JSON | Structure du panier. { 'request_id' : 'sys_id of the generated Request', 'request_number' : 'Number of the generated Request' } |
[Tableau 33. Renvoie]

{#r_CJSS-submitOrder_M__table_zmx_brd_zz}  
Exemple :

    var cart = new sn_sc.CartJS();
    var request =
    {
      'special_instructions' : 'Delivery only in working hours',
      'requested_for' : '62826bf03710200044e0bfc8bcbe5df1',
      'delivery_address' : "Brasilia, Brasil",
    };
    var requestDetails = cart.submitOrder(request);
    gs.info(JSON.stringify(requestDetails));

Sortie :

    {"request_id":"6eed229047801200e0ef563dbb9a71c2", "request_number": "REQ0000001"}

## CartJS : updateItem(demande de carte, chaîne cart_item_id) {#ariaid-title19}

Met à jour un élément dans le panier.
{#r_CJSS-updateItem_M_S__table_zvx_npd_zz__entry__3}

| Nom | Type | Description |
|-|-|-|
| request | Carte | Objet JSON contenant les détails de l'élément de catalogue à mettre à jour. La structure de l'objet de la demande est la suivante : { 'sysparm_quantity' : item_quantity, 'sysparm_requested_for' : requested_for, 'variables' : { 'var_name' : 'var_value', ... } } * item_quantity : nombre d'éléments à ajouter. La valeur par défaut est 1. * var_name : Nom de la question. * var_value : valeur de la réponse (pas la valeur d'affichage). {#r_CJSS-updateItem_M_S__ul_agy_ypd_zz} |
| cart_item_id | Chaîne | sys_id de l'élément du panier à modifier. |
[Tableau 34. Paramètres]

{#r_CJSS-updateItem_M_S__table_zvx_npd_zz} {#r_CJSS-updateItem_M_S__table_awx_npd_zz__entry__2}

| Type | Description |
|-|-|
| JSON | Détails du panier. { 'subtotal': value, 'items':[ { itemName:'', quantity:'', price:'', recurring_price:'' } ...], ... } |
[Tableau 35. Renvoie]

{#r_CJSS-updateItem_M_S__table_awx_npd_zz}  

    var cart = new sn_sc.CartJS();
    var request =
    {
      'sysparm_quantity': '1',
      'variables':{
        'carrier': 'at_and_t_mobility',
        'data_plan': '500MB',
        'duration': 'eighteen_months',
        'color': 'slate',
        'storage': 'sixtyfour'
      }
    };
    var cart_item_id = "4d69b672c322320076173b0ac3d3ae79";
    var cartDetails = cart.updateItem(request, cart_item_id);
    gs.info(cartDetails);

Sortie


    { "cart_id":"35ec9e8947a13200e0ef563dbb9a7109", "items":[ { "cart_item_id":"35ec9e8947a13200e0ef563dbb9a710a", "catalog_item_id":"0d08837237153000158bbfc8bcbe5d02", "item_name":"Apple iPhone 5", "localized_price":"$799.99", "localized_recurring_price":"$30.00", "price":"$799.99", "quantity":"1", "recurring_frequency":"Monthly", "recurring_price":"$29.00" } ] "subtotal":"$799.99" }


