Add order number to cart

curl --request POST \
  --url https://api.fabric.inc/v3/carts/{cartId}/actions/add-order-number \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --header 'x-fabric-tenant-id: <x-fabric-tenant-id>' \
  --data '
{
  "orderNumber": "121213"
}
'

import requests

url = "https://api.fabric.inc/v3/carts/{cartId}/actions/add-order-number"

payload = { "orderNumber": "121213" }
headers = {
    "x-fabric-tenant-id": "<x-fabric-tenant-id>",
    "Authorization": "Bearer <token>",
    "Content-Type": "application/json"
}

response = requests.post(url, json=payload, headers=headers)

print(response.text)

const options = {
  method: 'POST',
  headers: {
    'x-fabric-tenant-id': '<x-fabric-tenant-id>',
    Authorization: 'Bearer <token>',
    'Content-Type': 'application/json'
  },
  body: JSON.stringify({orderNumber: '121213'})
};

fetch('https://api.fabric.inc/v3/carts/{cartId}/actions/add-order-number', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://api.fabric.inc/v3/carts/{cartId}/actions/add-order-number",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "POST",
  CURLOPT_POSTFIELDS => json_encode([
    'orderNumber' => '121213'
  ]),
  CURLOPT_HTTPHEADER => [
    "Authorization: Bearer <token>",
    "Content-Type: application/json",
    "x-fabric-tenant-id: <x-fabric-tenant-id>"
  ],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

package main

import (
	"fmt"
	"strings"
	"net/http"
	"io"
)

func main() {

	url := "https://api.fabric.inc/v3/carts/{cartId}/actions/add-order-number"

	payload := strings.NewReader("{\n  \"orderNumber\": \"121213\"\n}")

	req, _ := http.NewRequest("POST", url, payload)

	req.Header.Add("x-fabric-tenant-id", "<x-fabric-tenant-id>")
	req.Header.Add("Authorization", "Bearer <token>")
	req.Header.Add("Content-Type", "application/json")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

HttpResponse<String> response = Unirest.post("https://api.fabric.inc/v3/carts/{cartId}/actions/add-order-number")
  .header("x-fabric-tenant-id", "<x-fabric-tenant-id>")
  .header("Authorization", "Bearer <token>")
  .header("Content-Type", "application/json")
  .body("{\n  \"orderNumber\": \"121213\"\n}")
  .asString();

require 'uri'
require 'net/http'

url = URI("https://api.fabric.inc/v3/carts/{cartId}/actions/add-order-number")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Post.new(url)
request["x-fabric-tenant-id"] = '<x-fabric-tenant-id>'
request["Authorization"] = 'Bearer <token>'
request["Content-Type"] = 'application/json'
request.body = "{\n  \"orderNumber\": \"121213\"\n}"

response = http.request(request)
puts response.read_body

{
  "id": "c695af14-5e33-402c-9d8d-71edcf4856a8",
  "createdAt": "2022-09-06T14:07:17.000Z",
  "updatedAt": "2022-09-06T14:07:17.000Z",
  "name": "cart_it",
  "description": "IT department cart",
  "lineItems": [
    {
      "id": "12gved0f-7645-40cb-y7b0-167f8bggdb3z",
      "itemId": "<unknown>",
      "position": 1,
      "name": "Varnet Garden Light Kit",
      "sku": "16B2GS8LD5FDS",
      "productAttributes": [
        {
          "name": "gift wrapping (small)",
          "value": "true",
          "attributeId": "60c2a358eb2ec30008ae70a1",
          "description": "Gift wrapping for a small package",
          "mapping": "ITEM",
          "type": "GIFT",
          "price": 10,
          "level": "order"
        }
      ],
      "createdAt": "2022-09-06T14:07:17.000Z",
      "updatedAt": "2022-09-06T14:07:17.000Z",
      "quantity": 15,
      "priceListId": 108674,
      "isActive": true,
      "price": "<unknown>",
      "discounts": [
        "<unknown>"
      ],
      "groups": [
        "61d38e117162b7dba69c3d6d"
      ],
      "attributes": {
        "productFamily": "Laptop computers"
      },
      "channel": "12",
      "isPickup": true,
      "warehouseId": "XYZ-1234",
      "shippingDetails": {
        "id": "fef78121-bee3-4448-bf1c-d5b5461dbda2",
        "createdAt": "2022-09-06T14:07:17.000Z",
        "updatedAt": "2022-09-06T14:07:17.000Z",
        "address": {
          "addressLine1": "123 Main St.",
          "city": "Seattle",
          "region": "WA",
          "country": "USA",
          "postalCode": "98121",
          "addressLine2": "Suite 100",
          "addressLine3": "Seventh floor",
          "addressLine4": "Attention: Pat E. Kake",
          "attention": "Billing manager",
          "email": "test@example.com",
          "type": "shipping",
          "name": "Pat E Kake",
          "phone": {
            "number": "123-456-7899",
            "type": "MOBILE"
          }
        },
        "type": "SHIP_TO_ADDRESS",
        "taxCode": "FR1000",
        "isPickup": true,
        "altPickupPerson": {
          "name": "Pat E Kake",
          "phone": {
            "number": "123-456-7899",
            "type": "MOBILE"
          },
          "email": "test@example.com"
        },
        "pickupPerson": {
          "name": "Pat E Kake",
          "phone": {
            "number": "123-456-7899",
            "type": "MOBILE"
          },
          "email": "test@example.com"
        },
        "warehouseId": "XYZ-1234",
        "storeId": "ABC-123",
        "shippingCost": 150.25,
        "shippingMethodId": "dfsae-2d32113-32lpdd",
        "shippingDiscount": 150.25,
        "shippingMethodName": "Express Delivery"
      },
      "fulfillment": {
        "type": "WEB_SDD",
        "networkCode": "ShipToHome",
        "channelId": "12",
        "inventoryType": "availableToPurchase",
        "inventory": {
          "inventoryId": "723910d81723",
          "sku": "SKU1",
          "itemId": 12345,
          "locationNumber": 12345,
          "region": "North America",
          "channelId": "channel_xyz",
          "vendorId": "vendor1",
          "createdAt": "2022-08-01T18:03:28.483971941Z",
          "updatedAt": "2022-08-01T20:03:28.483971941Z",
          "leadTime": "5 days",
          "type": "primary",
          "hasInfiniteInventory": false,
          "backorderShipmentAt": "2022-08-01T20:03:28.483971941Z",
          "preorderShipmentAt": "2022-08-01T20:03:28.483971941Z",
          "backorderLimit": 50,
          "preorderLimit": 40,
          "safetyStock": 10,
          "lowStock": 10,
          "networkCode": "ShipToHome",
          "counters": {
            "onHand": 100,
            "allocated": 10,
            "shipped": 20
          },
          "customAttributes": {
            "isBopis": true
          },
          "networkCounters": {
            "softReserve": 10
          },
          "virtualCounters": {
            "availableToPurchase": 60
          }
        }
      },
      "fees": [
        {
          "feeId": "73bc09d0-874a-4c3d-84d0-df1670d03578",
          "name": "gift",
          "type": "gift_wrap",
          "amount": 10.5,
          "attributes": {
            "from": "sam"
          }
        }
      ],
      "adjustments": [
        {
          "id": "c695af14-5e33-402c-9d8d-71edcf4856a8",
          "amount": 60.5,
          "reason": "CSR Adjustment",
          "attributes": {
            "productFamily": "Laptop computers"
          },
          "createdAt": "2022-09-06T14:07:17.000Z",
          "updatedAt": "2022-09-06T14:07:17.000Z"
        }
      ]
    }
  ],
  "totalItems": 3,
  "totalUniqueItems": 2,
  "status": "PENDING",
  "accountId": "5f689caa4216e7000750d1ef",
  "configuration": {
    "allowAnonymousUser": true,
    "orderNumberSource": "CART_ID",
    "isSoftReservationEnabled": false,
    "orderSequence": {
      "sequenceName": "ORDER_NUMBER",
      "sequenceKey": "LOCATE"
    },
    "orderNumberGeneration": "NONE"
  },
  "customerContext": {
    "id": "d7e78a21-bee3-4448-bf1c-d5b5461dbda2",
    "type": "EMPLOYEE",
    "attributes": {
      "isAdmin": false
    },
    "segments": [
      [
        {
          "name": "category",
          "value": [
            "GOLD",
            "YELLOW"
          ]
        }
      ]
    ]
  },
  "totalAmount": 10,
  "totalDiscount": 10,
  "totalFees": 10,
  "subTotal": 10,
  "currency": "USD",
  "attributes": {
    "approver": "620d8896058edb0009385311"
  },
  "appliedDiscounts": [
    {
      "promotionId": "6197ec46e836ff000952c665",
      "promotionName": "Buy shoes get socks for free",
      "couponCode": "SUPERCOUPON20",
      "type": "COUPON",
      "amount": 105.15
    }
  ],
  "fees": [
    {
      "feeId": "73bc09d0-874a-4c3d-84d0-df1670d03578",
      "name": "gift",
      "type": "gift_wrap",
      "amount": 10.5,
      "attributes": {
        "from": "sam"
      }
    }
  ],
  "suggestedProducts": [
    {
      "promotionId": "6197ec46e836ff000952c665",
      "promotionName": "Buy shoes get socks for free",
      "itemId": 234343,
      "itemIds": [
        500001
      ],
      "sku": "SHOE1234",
      "skus": [
        "SHOE-4"
      ],
      "eligiblePriceLists": [
        1000
      ],
      "quantity": 2,
      "promotionQuantity": 10,
      "isFree": true,
      "discountType": "PERCENTAGE_OFF",
      "amount": 100.15
    }
  ],
  "orderNumber": "121213",
  "error": {
    "prices": [
      {
        "price": {
          "sale": 1000.15,
          "cost": 900.15,
          "base": 2000.15,
          "unitPriceWithoutDiscounts": 2000.15,
          "lineTotalWithoutDiscounts": 2000.15,
          "lineTotalWithDiscounts": 2000.15,
          "type": "BASE"
        },
        "channel": "12",
        "kind": "PROMOTION",
        "position": 1,
        "discounts": [
          {
            "amount": 100.15,
            "quantity": 1,
            "proratedAmount": 100.15,
            "proratedQuantity": 1,
            "application": 1,
            "promotion": {
              "id": "6197ec46e836ff000952d668",
              "value": 2000.15,
              "groupId": "61a6354d0d70e30009415f16",
              "level": 1,
              "isStackable": true,
              "isAlwaysApplied": true,
              "name": "20% OFF",
              "type": "Coupon",
              "discountType": "AMOUNT_OFF"
            }
          }
        ]
      }
    ],
    "promotionErrors": [
      {
        "code": "UNKNOWN_ERROR",
        "detail": "Item is out of stock",
        "itemId": 1730902008,
        "sku": "16B2GS8LD5FDS",
        "position": 1
      }
    ],
    "inventoryErrors": [
      {
        "code": "UNKNOWN_ERROR",
        "detail": "Item is out of stock",
        "itemId": 1730902008,
        "sku": "16B2GS8LD5FDS",
        "position": 1
      }
    ]
  }
}

{
  "type": "BAD_REQUEST",
  "message": "Bad Request"
}

{
  "type": "UNAUTHORIZED",
  "message": "Unauthorized User"
}

{
  "type": "NOT_FOUND",
  "message": "Cart not found"
}

{
  "type": "INTERNAL_SERVER_ERROR",
  "message": "Internal server error"
}

POST

carts

{cartId}

actions

add-order-number

Add order number to cart

curl --request POST \
  --url https://api.fabric.inc/v3/carts/{cartId}/actions/add-order-number \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --header 'x-fabric-tenant-id: <x-fabric-tenant-id>' \
  --data '
{
  "orderNumber": "121213"
}
'

import requests

url = "https://api.fabric.inc/v3/carts/{cartId}/actions/add-order-number"

payload = { "orderNumber": "121213" }
headers = {
    "x-fabric-tenant-id": "<x-fabric-tenant-id>",
    "Authorization": "Bearer <token>",
    "Content-Type": "application/json"
}

response = requests.post(url, json=payload, headers=headers)

print(response.text)

const options = {
  method: 'POST',
  headers: {
    'x-fabric-tenant-id': '<x-fabric-tenant-id>',
    Authorization: 'Bearer <token>',
    'Content-Type': 'application/json'
  },
  body: JSON.stringify({orderNumber: '121213'})
};

fetch('https://api.fabric.inc/v3/carts/{cartId}/actions/add-order-number', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://api.fabric.inc/v3/carts/{cartId}/actions/add-order-number",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "POST",
  CURLOPT_POSTFIELDS => json_encode([
    'orderNumber' => '121213'
  ]),
  CURLOPT_HTTPHEADER => [
    "Authorization: Bearer <token>",
    "Content-Type: application/json",
    "x-fabric-tenant-id: <x-fabric-tenant-id>"
  ],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

package main

import (
	"fmt"
	"strings"
	"net/http"
	"io"
)

func main() {

	url := "https://api.fabric.inc/v3/carts/{cartId}/actions/add-order-number"

	payload := strings.NewReader("{\n  \"orderNumber\": \"121213\"\n}")

	req, _ := http.NewRequest("POST", url, payload)

	req.Header.Add("x-fabric-tenant-id", "<x-fabric-tenant-id>")
	req.Header.Add("Authorization", "Bearer <token>")
	req.Header.Add("Content-Type", "application/json")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

HttpResponse<String> response = Unirest.post("https://api.fabric.inc/v3/carts/{cartId}/actions/add-order-number")
  .header("x-fabric-tenant-id", "<x-fabric-tenant-id>")
  .header("Authorization", "Bearer <token>")
  .header("Content-Type", "application/json")
  .body("{\n  \"orderNumber\": \"121213\"\n}")
  .asString();

require 'uri'
require 'net/http'

url = URI("https://api.fabric.inc/v3/carts/{cartId}/actions/add-order-number")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Post.new(url)
request["x-fabric-tenant-id"] = '<x-fabric-tenant-id>'
request["Authorization"] = 'Bearer <token>'
request["Content-Type"] = 'application/json'
request.body = "{\n  \"orderNumber\": \"121213\"\n}"

response = http.request(request)
puts response.read_body

{
  "id": "c695af14-5e33-402c-9d8d-71edcf4856a8",
  "createdAt": "2022-09-06T14:07:17.000Z",
  "updatedAt": "2022-09-06T14:07:17.000Z",
  "name": "cart_it",
  "description": "IT department cart",
  "lineItems": [
    {
      "id": "12gved0f-7645-40cb-y7b0-167f8bggdb3z",
      "itemId": "<unknown>",
      "position": 1,
      "name": "Varnet Garden Light Kit",
      "sku": "16B2GS8LD5FDS",
      "productAttributes": [
        {
          "name": "gift wrapping (small)",
          "value": "true",
          "attributeId": "60c2a358eb2ec30008ae70a1",
          "description": "Gift wrapping for a small package",
          "mapping": "ITEM",
          "type": "GIFT",
          "price": 10,
          "level": "order"
        }
      ],
      "createdAt": "2022-09-06T14:07:17.000Z",
      "updatedAt": "2022-09-06T14:07:17.000Z",
      "quantity": 15,
      "priceListId": 108674,
      "isActive": true,
      "price": "<unknown>",
      "discounts": [
        "<unknown>"
      ],
      "groups": [
        "61d38e117162b7dba69c3d6d"
      ],
      "attributes": {
        "productFamily": "Laptop computers"
      },
      "channel": "12",
      "isPickup": true,
      "warehouseId": "XYZ-1234",
      "shippingDetails": {
        "id": "fef78121-bee3-4448-bf1c-d5b5461dbda2",
        "createdAt": "2022-09-06T14:07:17.000Z",
        "updatedAt": "2022-09-06T14:07:17.000Z",
        "address": {
          "addressLine1": "123 Main St.",
          "city": "Seattle",
          "region": "WA",
          "country": "USA",
          "postalCode": "98121",
          "addressLine2": "Suite 100",
          "addressLine3": "Seventh floor",
          "addressLine4": "Attention: Pat E. Kake",
          "attention": "Billing manager",
          "email": "test@example.com",
          "type": "shipping",
          "name": "Pat E Kake",
          "phone": {
            "number": "123-456-7899",
            "type": "MOBILE"
          }
        },
        "type": "SHIP_TO_ADDRESS",
        "taxCode": "FR1000",
        "isPickup": true,
        "altPickupPerson": {
          "name": "Pat E Kake",
          "phone": {
            "number": "123-456-7899",
            "type": "MOBILE"
          },
          "email": "test@example.com"
        },
        "pickupPerson": {
          "name": "Pat E Kake",
          "phone": {
            "number": "123-456-7899",
            "type": "MOBILE"
          },
          "email": "test@example.com"
        },
        "warehouseId": "XYZ-1234",
        "storeId": "ABC-123",
        "shippingCost": 150.25,
        "shippingMethodId": "dfsae-2d32113-32lpdd",
        "shippingDiscount": 150.25,
        "shippingMethodName": "Express Delivery"
      },
      "fulfillment": {
        "type": "WEB_SDD",
        "networkCode": "ShipToHome",
        "channelId": "12",
        "inventoryType": "availableToPurchase",
        "inventory": {
          "inventoryId": "723910d81723",
          "sku": "SKU1",
          "itemId": 12345,
          "locationNumber": 12345,
          "region": "North America",
          "channelId": "channel_xyz",
          "vendorId": "vendor1",
          "createdAt": "2022-08-01T18:03:28.483971941Z",
          "updatedAt": "2022-08-01T20:03:28.483971941Z",
          "leadTime": "5 days",
          "type": "primary",
          "hasInfiniteInventory": false,
          "backorderShipmentAt": "2022-08-01T20:03:28.483971941Z",
          "preorderShipmentAt": "2022-08-01T20:03:28.483971941Z",
          "backorderLimit": 50,
          "preorderLimit": 40,
          "safetyStock": 10,
          "lowStock": 10,
          "networkCode": "ShipToHome",
          "counters": {
            "onHand": 100,
            "allocated": 10,
            "shipped": 20
          },
          "customAttributes": {
            "isBopis": true
          },
          "networkCounters": {
            "softReserve": 10
          },
          "virtualCounters": {
            "availableToPurchase": 60
          }
        }
      },
      "fees": [
        {
          "feeId": "73bc09d0-874a-4c3d-84d0-df1670d03578",
          "name": "gift",
          "type": "gift_wrap",
          "amount": 10.5,
          "attributes": {
            "from": "sam"
          }
        }
      ],
      "adjustments": [
        {
          "id": "c695af14-5e33-402c-9d8d-71edcf4856a8",
          "amount": 60.5,
          "reason": "CSR Adjustment",
          "attributes": {
            "productFamily": "Laptop computers"
          },
          "createdAt": "2022-09-06T14:07:17.000Z",
          "updatedAt": "2022-09-06T14:07:17.000Z"
        }
      ]
    }
  ],
  "totalItems": 3,
  "totalUniqueItems": 2,
  "status": "PENDING",
  "accountId": "5f689caa4216e7000750d1ef",
  "configuration": {
    "allowAnonymousUser": true,
    "orderNumberSource": "CART_ID",
    "isSoftReservationEnabled": false,
    "orderSequence": {
      "sequenceName": "ORDER_NUMBER",
      "sequenceKey": "LOCATE"
    },
    "orderNumberGeneration": "NONE"
  },
  "customerContext": {
    "id": "d7e78a21-bee3-4448-bf1c-d5b5461dbda2",
    "type": "EMPLOYEE",
    "attributes": {
      "isAdmin": false
    },
    "segments": [
      [
        {
          "name": "category",
          "value": [
            "GOLD",
            "YELLOW"
          ]
        }
      ]
    ]
  },
  "totalAmount": 10,
  "totalDiscount": 10,
  "totalFees": 10,
  "subTotal": 10,
  "currency": "USD",
  "attributes": {
    "approver": "620d8896058edb0009385311"
  },
  "appliedDiscounts": [
    {
      "promotionId": "6197ec46e836ff000952c665",
      "promotionName": "Buy shoes get socks for free",
      "couponCode": "SUPERCOUPON20",
      "type": "COUPON",
      "amount": 105.15
    }
  ],
  "fees": [
    {
      "feeId": "73bc09d0-874a-4c3d-84d0-df1670d03578",
      "name": "gift",
      "type": "gift_wrap",
      "amount": 10.5,
      "attributes": {
        "from": "sam"
      }
    }
  ],
  "suggestedProducts": [
    {
      "promotionId": "6197ec46e836ff000952c665",
      "promotionName": "Buy shoes get socks for free",
      "itemId": 234343,
      "itemIds": [
        500001
      ],
      "sku": "SHOE1234",
      "skus": [
        "SHOE-4"
      ],
      "eligiblePriceLists": [
        1000
      ],
      "quantity": 2,
      "promotionQuantity": 10,
      "isFree": true,
      "discountType": "PERCENTAGE_OFF",
      "amount": 100.15
    }
  ],
  "orderNumber": "121213",
  "error": {
    "prices": [
      {
        "price": {
          "sale": 1000.15,
          "cost": 900.15,
          "base": 2000.15,
          "unitPriceWithoutDiscounts": 2000.15,
          "lineTotalWithoutDiscounts": 2000.15,
          "lineTotalWithDiscounts": 2000.15,
          "type": "BASE"
        },
        "channel": "12",
        "kind": "PROMOTION",
        "position": 1,
        "discounts": [
          {
            "amount": 100.15,
            "quantity": 1,
            "proratedAmount": 100.15,
            "proratedQuantity": 1,
            "application": 1,
            "promotion": {
              "id": "6197ec46e836ff000952d668",
              "value": 2000.15,
              "groupId": "61a6354d0d70e30009415f16",
              "level": 1,
              "isStackable": true,
              "isAlwaysApplied": true,
              "name": "20% OFF",
              "type": "Coupon",
              "discountType": "AMOUNT_OFF"
            }
          }
        ]
      }
    ],
    "promotionErrors": [
      {
        "code": "UNKNOWN_ERROR",
        "detail": "Item is out of stock",
        "itemId": 1730902008,
        "sku": "16B2GS8LD5FDS",
        "position": 1
      }
    ],
    "inventoryErrors": [
      {
        "code": "UNKNOWN_ERROR",
        "detail": "Item is out of stock",
        "itemId": 1730902008,
        "sku": "16B2GS8LD5FDS",
        "position": 1
      }
    ]
  }
}

{
  "type": "BAD_REQUEST",
  "message": "Bad Request"
}

{
  "type": "UNAUTHORIZED",
  "message": "Unauthorized User"
}

{
  "type": "NOT_FOUND",
  "message": "Cart not found"
}

{
  "type": "INTERNAL_SERVER_ERROR",
  "message": "Internal server error"
}

Authorizations

Authorization

string

header

required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Headers

x-fabric-tenant-id

string

required

A header used by fabric to identify the tenant making the request. You must include tenant id in the authentication header for an API request to access any of fabric’s endpoints. You can retrieve the tenant id , which is also called account id, from Copilot. This header is required.

x-fabric-channel-id

string

x-fabric-channel-id identifies the sales channel where the API request is being made; primarily for multichannel use cases. The channel ids are 12 corresponding to US and 13 corresponding to Canada. The default channel id is 12. This field is required.

x-fabric-request-id

string

Unique request ID

Path Parameters

cartId

string

required

Cart ID

Example:

"b8a64b52-dab4-8137-8d6a-f2c2337abc1"

Body

application/json

Sample request to add order number to the cart

Request to add order number to a cart.

orderNumber

string

required

The order number

Example:

"121213"

Response

string | null

Unique cart identifier

Example:

"c695af14-5e33-402c-9d8d-71edcf4856a8"

createdAt

string<date-time>

Time cart was created

Example:

"2022-09-06T14:07:17.000Z"

updatedAt

string<date-time>

Time cart was last updated

Example:

"2022-09-06T14:07:17.000Z"

name

string | null

Cart name

Example:

"cart_it"

description

string | null

Cart description

Example:

"IT department cart"

lineItems

object[]

Show child attributes

totalItems

integer<int32> | null

Number of line items in the cart

Example:

3

totalUniqueItems

integer<int32> | null

Number of different (unique) line items in the cart based on line item ID

Example:

2

status

enum<string>

Cart status
PENDING - Cart is in pending state
DELETED - Cart is in deleted state

Available options:

PENDING,

DELETED

Example:

"PENDING"

accountId

string | null

Customer account ID

Example:

"5f689caa4216e7000750d1ef"

configuration

object | null

Cart configurations

Show child attributes

customerContext

object | null

Customer context

Show child attributes

totalAmount

number<double> · null · null

Total price of line items after discount, including shipping and shipping discount

Example:

10

totalDiscount

number<double> · null · null

Total discount applied to cart

Example:

10

totalFees

number<double> · null · null

Total fees applied to cart

Example:

10

subTotal

number<double> · null · null

Total price of line items, including shipping, without discount

Example:

10

currency

string

default:USD

Currency type

Example:

"USD"

attributes

object

Cart attributes

Show child attributes

Example:

{ "approver": "620d8896058edb0009385311" }

appliedDiscounts

object[]

Applied discounts

Show child attributes

fees

object[] | null

Show child attributes

suggestedProducts

object[] | null

Suggested free products

Show child attributes

orderNumber

string | null

The order number

Example:

"121213"

error

object

Errors in this cart

Show child attributes

⌘I