Add items to cart
curl --request POST \
--url https://prod.cart.fabric.inc/v2/carts/items \
--header 'Authorization: <authorization>' \
--header 'Content-Type: application/json' \
--header 'x-site-context: <x-site-context>' \
--data '
{
"items": [
{
"itemId": "1000000001",
"quantity": 1,
"price": {
"currency": "USD",
"amount": 100,
"discount": {
"price": 80,
"promosApplied": [
{
"promoId": "fza065tdr787",
"promoCode": "coupon123",
"value": "20",
"unit": "%OFF"
}
],
"discounts": [
{
"promoId": "fza065tdr787",
"promoCode": "coupon123",
"promoTitle": "New Year discount",
"quantity": 1,
"amount": 20,
"value": 20,
"groupId": "new-items",
"promotionType": "PROMOTION",
"priority": 1,
"stackable": false,
"sku": "16B2GS8LD5FDS",
"itemId": "1000000001",
"itemKey": "Key1234",
"message": "New Year Promotion",
"unit": "%OFF",
"proratedQuantity": 1,
"proratedAmount": 3.33
}
],
"discountAmount": 20
},
"sale": 80
},
"sku": "16B2GS8LD5FDS",
"priceListId": "100000",
"type": "WEB_SHIP",
"subType": "Border-free",
"extra": {
"productFamily": "Laptop computers"
},
"fulfillment": {
"type": "WEB_SHIP",
"networkCode": "ShipToCNC",
"channelId": "12"
},
"group": [
"61d38e117162b7dba69c3d6d"
]
}
],
"cartId": "d7e78a21-bee3-4448-bf1c-d5b5461dbda2",
"name": "cart_it",
"description": "cart for the IT department",
"networkCode": "ShipToHome"
}
'import requests
url = "https://prod.cart.fabric.inc/v2/carts/items"
payload = {
"items": [
{
"itemId": "1000000001",
"quantity": 1,
"price": {
"currency": "USD",
"amount": 100,
"discount": {
"price": 80,
"promosApplied": [
{
"promoId": "fza065tdr787",
"promoCode": "coupon123",
"value": "20",
"unit": "%OFF"
}
],
"discounts": [
{
"promoId": "fza065tdr787",
"promoCode": "coupon123",
"promoTitle": "New Year discount",
"quantity": 1,
"amount": 20,
"value": 20,
"groupId": "new-items",
"promotionType": "PROMOTION",
"priority": 1,
"stackable": False,
"sku": "16B2GS8LD5FDS",
"itemId": "1000000001",
"itemKey": "Key1234",
"message": "New Year Promotion",
"unit": "%OFF",
"proratedQuantity": 1,
"proratedAmount": 3.33
}
],
"discountAmount": 20
},
"sale": 80
},
"sku": "16B2GS8LD5FDS",
"priceListId": "100000",
"type": "WEB_SHIP",
"subType": "Border-free",
"extra": { "productFamily": "Laptop computers" },
"fulfillment": {
"type": "WEB_SHIP",
"networkCode": "ShipToCNC",
"channelId": "12"
},
"group": ["61d38e117162b7dba69c3d6d"]
}
],
"cartId": "d7e78a21-bee3-4448-bf1c-d5b5461dbda2",
"name": "cart_it",
"description": "cart for the IT department",
"networkCode": "ShipToHome"
}
headers = {
"x-site-context": "<x-site-context>",
"Authorization": "<authorization>",
"Content-Type": "application/json"
}
response = requests.post(url, json=payload, headers=headers)
print(response.text)const options = {
method: 'POST',
headers: {
'x-site-context': '<x-site-context>',
Authorization: '<authorization>',
'Content-Type': 'application/json'
},
body: JSON.stringify({
items: [
{
itemId: '1000000001',
quantity: 1,
price: {
currency: 'USD',
amount: 100,
discount: {
price: 80,
promosApplied: [{promoId: 'fza065tdr787', promoCode: 'coupon123', value: '20', unit: '%OFF'}],
discounts: [
{
promoId: 'fza065tdr787',
promoCode: 'coupon123',
promoTitle: 'New Year discount',
quantity: 1,
amount: 20,
value: 20,
groupId: 'new-items',
promotionType: 'PROMOTION',
priority: 1,
stackable: false,
sku: '16B2GS8LD5FDS',
itemId: '1000000001',
itemKey: 'Key1234',
message: 'New Year Promotion',
unit: '%OFF',
proratedQuantity: 1,
proratedAmount: 3.33
}
],
discountAmount: 20
},
sale: 80
},
sku: '16B2GS8LD5FDS',
priceListId: '100000',
type: 'WEB_SHIP',
subType: 'Border-free',
extra: {productFamily: 'Laptop computers'},
fulfillment: {type: 'WEB_SHIP', networkCode: 'ShipToCNC', channelId: '12'},
group: ['61d38e117162b7dba69c3d6d']
}
],
cartId: 'd7e78a21-bee3-4448-bf1c-d5b5461dbda2',
name: 'cart_it',
description: 'cart for the IT department',
networkCode: 'ShipToHome'
})
};
fetch('https://prod.cart.fabric.inc/v2/carts/items', 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://prod.cart.fabric.inc/v2/carts/items",
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([
'items' => [
[
'itemId' => '1000000001',
'quantity' => 1,
'price' => [
'currency' => 'USD',
'amount' => 100,
'discount' => [
'price' => 80,
'promosApplied' => [
[
'promoId' => 'fza065tdr787',
'promoCode' => 'coupon123',
'value' => '20',
'unit' => '%OFF'
]
],
'discounts' => [
[
'promoId' => 'fza065tdr787',
'promoCode' => 'coupon123',
'promoTitle' => 'New Year discount',
'quantity' => 1,
'amount' => 20,
'value' => 20,
'groupId' => 'new-items',
'promotionType' => 'PROMOTION',
'priority' => 1,
'stackable' => false,
'sku' => '16B2GS8LD5FDS',
'itemId' => '1000000001',
'itemKey' => 'Key1234',
'message' => 'New Year Promotion',
'unit' => '%OFF',
'proratedQuantity' => 1,
'proratedAmount' => 3.33
]
],
'discountAmount' => 20
],
'sale' => 80
],
'sku' => '16B2GS8LD5FDS',
'priceListId' => '100000',
'type' => 'WEB_SHIP',
'subType' => 'Border-free',
'extra' => [
'productFamily' => 'Laptop computers'
],
'fulfillment' => [
'type' => 'WEB_SHIP',
'networkCode' => 'ShipToCNC',
'channelId' => '12'
],
'group' => [
'61d38e117162b7dba69c3d6d'
]
]
],
'cartId' => 'd7e78a21-bee3-4448-bf1c-d5b5461dbda2',
'name' => 'cart_it',
'description' => 'cart for the IT department',
'networkCode' => 'ShipToHome'
]),
CURLOPT_HTTPHEADER => [
"Authorization: <authorization>",
"Content-Type: application/json",
"x-site-context: <x-site-context>"
],
]);
$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://prod.cart.fabric.inc/v2/carts/items"
payload := strings.NewReader("{\n \"items\": [\n {\n \"itemId\": \"1000000001\",\n \"quantity\": 1,\n \"price\": {\n \"currency\": \"USD\",\n \"amount\": 100,\n \"discount\": {\n \"price\": 80,\n \"promosApplied\": [\n {\n \"promoId\": \"fza065tdr787\",\n \"promoCode\": \"coupon123\",\n \"value\": \"20\",\n \"unit\": \"%OFF\"\n }\n ],\n \"discounts\": [\n {\n \"promoId\": \"fza065tdr787\",\n \"promoCode\": \"coupon123\",\n \"promoTitle\": \"New Year discount\",\n \"quantity\": 1,\n \"amount\": 20,\n \"value\": 20,\n \"groupId\": \"new-items\",\n \"promotionType\": \"PROMOTION\",\n \"priority\": 1,\n \"stackable\": false,\n \"sku\": \"16B2GS8LD5FDS\",\n \"itemId\": \"1000000001\",\n \"itemKey\": \"Key1234\",\n \"message\": \"New Year Promotion\",\n \"unit\": \"%OFF\",\n \"proratedQuantity\": 1,\n \"proratedAmount\": 3.33\n }\n ],\n \"discountAmount\": 20\n },\n \"sale\": 80\n },\n \"sku\": \"16B2GS8LD5FDS\",\n \"priceListId\": \"100000\",\n \"type\": \"WEB_SHIP\",\n \"subType\": \"Border-free\",\n \"extra\": {\n \"productFamily\": \"Laptop computers\"\n },\n \"fulfillment\": {\n \"type\": \"WEB_SHIP\",\n \"networkCode\": \"ShipToCNC\",\n \"channelId\": \"12\"\n },\n \"group\": [\n \"61d38e117162b7dba69c3d6d\"\n ]\n }\n ],\n \"cartId\": \"d7e78a21-bee3-4448-bf1c-d5b5461dbda2\",\n \"name\": \"cart_it\",\n \"description\": \"cart for the IT department\",\n \"networkCode\": \"ShipToHome\"\n}")
req, _ := http.NewRequest("POST", url, payload)
req.Header.Add("x-site-context", "<x-site-context>")
req.Header.Add("Authorization", "<authorization>")
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://prod.cart.fabric.inc/v2/carts/items")
.header("x-site-context", "<x-site-context>")
.header("Authorization", "<authorization>")
.header("Content-Type", "application/json")
.body("{\n \"items\": [\n {\n \"itemId\": \"1000000001\",\n \"quantity\": 1,\n \"price\": {\n \"currency\": \"USD\",\n \"amount\": 100,\n \"discount\": {\n \"price\": 80,\n \"promosApplied\": [\n {\n \"promoId\": \"fza065tdr787\",\n \"promoCode\": \"coupon123\",\n \"value\": \"20\",\n \"unit\": \"%OFF\"\n }\n ],\n \"discounts\": [\n {\n \"promoId\": \"fza065tdr787\",\n \"promoCode\": \"coupon123\",\n \"promoTitle\": \"New Year discount\",\n \"quantity\": 1,\n \"amount\": 20,\n \"value\": 20,\n \"groupId\": \"new-items\",\n \"promotionType\": \"PROMOTION\",\n \"priority\": 1,\n \"stackable\": false,\n \"sku\": \"16B2GS8LD5FDS\",\n \"itemId\": \"1000000001\",\n \"itemKey\": \"Key1234\",\n \"message\": \"New Year Promotion\",\n \"unit\": \"%OFF\",\n \"proratedQuantity\": 1,\n \"proratedAmount\": 3.33\n }\n ],\n \"discountAmount\": 20\n },\n \"sale\": 80\n },\n \"sku\": \"16B2GS8LD5FDS\",\n \"priceListId\": \"100000\",\n \"type\": \"WEB_SHIP\",\n \"subType\": \"Border-free\",\n \"extra\": {\n \"productFamily\": \"Laptop computers\"\n },\n \"fulfillment\": {\n \"type\": \"WEB_SHIP\",\n \"networkCode\": \"ShipToCNC\",\n \"channelId\": \"12\"\n },\n \"group\": [\n \"61d38e117162b7dba69c3d6d\"\n ]\n }\n ],\n \"cartId\": \"d7e78a21-bee3-4448-bf1c-d5b5461dbda2\",\n \"name\": \"cart_it\",\n \"description\": \"cart for the IT department\",\n \"networkCode\": \"ShipToHome\"\n}")
.asString();require 'uri'
require 'net/http'
url = URI("https://prod.cart.fabric.inc/v2/carts/items")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Post.new(url)
request["x-site-context"] = '<x-site-context>'
request["Authorization"] = '<authorization>'
request["Content-Type"] = 'application/json'
request.body = "{\n \"items\": [\n {\n \"itemId\": \"1000000001\",\n \"quantity\": 1,\n \"price\": {\n \"currency\": \"USD\",\n \"amount\": 100,\n \"discount\": {\n \"price\": 80,\n \"promosApplied\": [\n {\n \"promoId\": \"fza065tdr787\",\n \"promoCode\": \"coupon123\",\n \"value\": \"20\",\n \"unit\": \"%OFF\"\n }\n ],\n \"discounts\": [\n {\n \"promoId\": \"fza065tdr787\",\n \"promoCode\": \"coupon123\",\n \"promoTitle\": \"New Year discount\",\n \"quantity\": 1,\n \"amount\": 20,\n \"value\": 20,\n \"groupId\": \"new-items\",\n \"promotionType\": \"PROMOTION\",\n \"priority\": 1,\n \"stackable\": false,\n \"sku\": \"16B2GS8LD5FDS\",\n \"itemId\": \"1000000001\",\n \"itemKey\": \"Key1234\",\n \"message\": \"New Year Promotion\",\n \"unit\": \"%OFF\",\n \"proratedQuantity\": 1,\n \"proratedAmount\": 3.33\n }\n ],\n \"discountAmount\": 20\n },\n \"sale\": 80\n },\n \"sku\": \"16B2GS8LD5FDS\",\n \"priceListId\": \"100000\",\n \"type\": \"WEB_SHIP\",\n \"subType\": \"Border-free\",\n \"extra\": {\n \"productFamily\": \"Laptop computers\"\n },\n \"fulfillment\": {\n \"type\": \"WEB_SHIP\",\n \"networkCode\": \"ShipToCNC\",\n \"channelId\": \"12\"\n },\n \"group\": [\n \"61d38e117162b7dba69c3d6d\"\n ]\n }\n ],\n \"cartId\": \"d7e78a21-bee3-4448-bf1c-d5b5461dbda2\",\n \"name\": \"cart_it\",\n \"description\": \"cart for the IT department\",\n \"networkCode\": \"ShipToHome\"\n}"
response = http.request(request)
puts response.read_body{
"items": [
{
"sku": "16B2GS8LD5FDS",
"items": [
{
"sku": "13B9CL6WT2SLW",
"quantity": 15,
"items": [
"<unknown>"
],
"cartItemId": "12gved0f-7645-40cb-y7b0-167f8bggdb3z",
"itemId": "1730902008",
"title": "Light Cover",
"attributes": [
{
"attributeId": "60c2a358eb2ec30008ae70a1",
"name": "gift wrapping (small)",
"type": "GIFT",
"price": 10,
"description": "Gift wrapping for a small package",
"mapping": "ITEM",
"value": "true",
"level": "order",
"items": [
"1000000001"
]
}
],
"createdAt": "2022-02-18T15:12:40.974580",
"updatedAt": "2022-02-18T15:12:40.974580",
"type": "WEB_SHIP",
"subType": "Border-free",
"priceListId": "108674",
"lineItemId": 1,
"isActive": true,
"unitPrice": {
"currency": "USD",
"amount": 100,
"discount": {
"price": 80,
"promosApplied": [
{
"promoId": "fza065tdr787",
"promoCode": "coupon123",
"value": "20",
"unit": "%OFF"
}
],
"discounts": [
{
"promoId": "fza065tdr787",
"promoCode": "coupon123",
"promoTitle": "New Year discount",
"quantity": 1,
"amount": 20,
"value": 20,
"groupId": "new-items",
"promotionType": "PROMOTION",
"priority": 1,
"stackable": false,
"sku": "16B2GS8LD5FDS",
"itemId": "1000000001",
"itemKey": "Key1234",
"message": "New Year Promotion",
"unit": "%OFF",
"proratedQuantity": 1,
"proratedAmount": 3.33
}
],
"discountAmount": 20
},
"sale": 80
},
"totalPrice": {
"currency": "USD",
"amount": 100,
"discount": {
"price": 80,
"promosApplied": [
{
"promoId": "fza065tdr787",
"promoCode": "coupon123",
"value": "20",
"unit": "%OFF"
}
],
"discounts": [
{
"promoId": "fza065tdr787",
"promoCode": "coupon123",
"promoTitle": "New Year discount",
"quantity": 1,
"amount": 20,
"value": 20,
"groupId": "new-items",
"promotionType": "PROMOTION",
"priority": 1,
"stackable": false,
"sku": "16B2GS8LD5FDS",
"itemId": "1000000001",
"itemKey": "Key1234",
"message": "New Year Promotion",
"unit": "%OFF",
"proratedQuantity": 1,
"proratedAmount": 3.33
}
],
"discountAmount": 20
},
"sale": 80
},
"attributeTotalPrice": 10,
"group": [
"61d38e117162b7dba69c3d6d"
],
"extra": {
"productFamily": "Laptop computers"
},
"channel": 12,
"isPickup": true,
"warehouseId": "XYZ-1234",
"shipToId": "fef78121-bee3-4448-bf1c-d5b5461dbda2",
"shipTo": {
"shipToId": "fef78121-bee3-4448-bf1c-d5b5461dbda2",
"cartId": "d7e78a21-bee3-4448-bf1c-d5b5461dbda2",
"createdAt": "2022-02-18T15:12:40.974580",
"updatedAt": "2022-02-18T15:12:40.974580",
"shipMethod": {
"cost": {
"amount": 10,
"currency": "USD",
"discount": 5
},
"shipMethodId": "1234",
"shipmentCarrier": "FedEx",
"shipmentMethod": "Next Day"
},
"address": {
"attention": "Billing manager",
"street1": "100 NE 100th St.",
"street2": "Suite 710",
"street3": "Seventh floor",
"street4": "Attention: Pat E. Kake",
"city": "Seattle",
"state": "Washington",
"country": "USA",
"zipCode": "98125",
"email": "test@mail.com",
"kind": "shipping",
"name": {
"first": "Pat",
"middle": "E",
"last": "Kake"
},
"phone": {
"number": "123-456-7899",
"kind": "MOBILE"
}
},
"shipToType": "SHIP_TO_ADDRESS",
"taxCode": "FR1000",
"isPickup": true,
"altPickupPerson": {
"name": {
"first": "Pat",
"middle": "E",
"last": "Kake"
},
"phone": {
"number": "123-456-7899",
"kind": "MOBILE"
},
"email": "test@mail.com"
},
"pickupPerson": {
"name": {
"first": "Pat",
"middle": "E",
"last": "Kake"
},
"phone": {
"number": "123-456-7899",
"kind": "MOBILE"
},
"email": "test@mail.com"
},
"warehouseId": "XYZ-1234",
"storeId": "ABC-123"
},
"fulfillment": {
"type": "WEB_SHIP",
"networkCode": "ShipToCNC",
"channelId": "12",
"inventoryType": "availablePreorder",
"inventory": {
"virtualCounters": {
"availableToPurchase": 10
},
"id": "62272e917b12209e68751d94",
"sku": "SKU00025",
"itemId": 4225678911,
"locationNum": 473746,
"channelId": 12,
"vendorId": "vendor123",
"leadTime": 1234,
"inventoryType": "Safety stock",
"infiniteInventory": true,
"counters": {
"on-hand": 10
},
"attributes": {
"buy online, pick up in-store (bopis)": true
},
"backOrderDate": "2022-08-08T00:00:00.000Z",
"preOrderDate": "2022-08-08T00:00:00.000Z",
"backOrderLimit": 100,
"preOrderLimit": 100,
"safetyStock": 10,
"lowStock": 10,
"segment": "Clothing",
"region": "US"
}
}
}
],
"quantity": 1,
"isPickup": true,
"cartItemId": "88cded0f-1439-40eb-a7a0-167e8bffdb3b",
"itemId": "1000000001",
"title": "Varnet Garden Light Kit",
"attributeTotalPrice": 10,
"createdAt": "2022-02-18T15:12:40.974580",
"updatedAt": "2022-02-18T15:12:40.974580",
"priceListId": "100000",
"lineItemId": 1,
"isActive": true,
"unitPrice": {
"currency": "USD",
"amount": 100,
"discount": {
"price": 80,
"promosApplied": [
{
"promoId": "fza065tdr787",
"promoCode": "coupon123",
"value": "20",
"unit": "%OFF"
}
],
"discounts": [
{
"promoId": "fza065tdr787",
"promoCode": "coupon123",
"promoTitle": "New Year discount",
"quantity": 1,
"amount": 20,
"value": 20,
"groupId": "new-items",
"promotionType": "PROMOTION",
"priority": 1,
"stackable": false,
"sku": "16B2GS8LD5FDS",
"itemId": "1000000001",
"itemKey": "Key1234",
"message": "New Year Promotion",
"unit": "%OFF",
"proratedQuantity": 1,
"proratedAmount": 3.33
}
],
"discountAmount": 20
},
"sale": 80
},
"totalPrice": {
"currency": "USD",
"amount": 100,
"discount": {
"price": 80,
"promosApplied": [
{
"promoId": "fza065tdr787",
"promoCode": "coupon123",
"value": "20",
"unit": "%OFF"
}
],
"discounts": [
{
"promoId": "fza065tdr787",
"promoCode": "coupon123",
"promoTitle": "New Year discount",
"quantity": 1,
"amount": 20,
"value": 20,
"groupId": "new-items",
"promotionType": "PROMOTION",
"priority": 1,
"stackable": false,
"sku": "16B2GS8LD5FDS",
"itemId": "1000000001",
"itemKey": "Key1234",
"message": "New Year Promotion",
"unit": "%OFF",
"proratedQuantity": 1,
"proratedAmount": 3.33
}
],
"discountAmount": 20
},
"sale": 80
},
"attributes": [
{
"attributeId": "60c2a358eb2ec30008ae70a1",
"name": "gift wrapping (small)",
"type": "GIFT",
"price": 10,
"description": "Gift wrapping for a small package",
"mapping": "ITEM",
"value": "true",
"level": "order",
"items": [
"1000000001"
]
}
],
"priceAdjustments": [
{
"id": "d7e78a21-bee3-4448-bf1c-d5b5461dbda2",
"reason": "compensation for delay",
"amount": 20,
"attributes": {
"goldMember": [
false
]
}
}
],
"warehouseId": "XYZ-1234",
"shipTo": {
"shipToId": "fef78121-bee3-4448-bf1c-d5b5461dbda2",
"cartId": "d7e78a21-bee3-4448-bf1c-d5b5461dbda2",
"createdAt": "2022-02-18T15:12:40.974580",
"updatedAt": "2022-02-18T15:12:40.974580",
"shipMethod": {
"cost": {
"amount": 10,
"currency": "USD",
"discount": 5
},
"shipMethodId": "1234",
"shipmentCarrier": "FedEx",
"shipmentMethod": "Next Day"
},
"address": {
"attention": "Billing manager",
"street1": "100 NE 100th St.",
"street2": "Suite 710",
"street3": "Seventh floor",
"street4": "Attention: Pat E. Kake",
"city": "Seattle",
"state": "Washington",
"country": "USA",
"zipCode": "98125",
"email": "test@mail.com",
"kind": "shipping",
"name": {
"first": "Pat",
"middle": "E",
"last": "Kake"
},
"phone": {
"number": "123-456-7899",
"kind": "MOBILE"
}
},
"shipToType": "SHIP_TO_ADDRESS",
"taxCode": "FR1000",
"isPickup": true,
"altPickupPerson": {
"name": {
"first": "Pat",
"middle": "E",
"last": "Kake"
},
"phone": {
"number": "123-456-7899",
"kind": "MOBILE"
},
"email": "test@mail.com"
},
"pickupPerson": {
"name": {
"first": "Pat",
"middle": "E",
"last": "Kake"
},
"phone": {
"number": "123-456-7899",
"kind": "MOBILE"
},
"email": "test@mail.com"
},
"warehouseId": "XYZ-1234",
"storeId": "ABC-123"
},
"channel": 12,
"group": [
"61d38e117162b7dba69c3d6d"
],
"fees": [
{
"feeId": "73bc09d0-874a-4c3d-84d0-df1670d03578",
"name": "gift",
"type": "gift_wrap",
"amount": 10.5,
"attributes": "{'from': 'sam', 'to': 'david' }"
}
]
}
],
"currency": "USD",
"metadata": {
"approver": "620d8896058edb0009385311"
},
"allPromosApplied": [
{
"promoId": "fza065tdr787",
"promoCode": "coupon123",
"value": "20",
"unit": "%OFF"
}
],
"sharedUserIds": [
"[\"*\"] or [userId1,userId2]"
],
"error": {
"price": [
{
"price": {
"base": 20,
"sale": 10,
"cost": 20,
"currency": "USD",
"finalPrice": 10,
"totalPrice": 20,
"kind": "Promotion",
"discount": 5.5
},
"channel": 12,
"kind": "PROMOTION",
"lineItemId": 1,
"discounts": [
{
"promoId": "fza065tdr787",
"promoCode": "coupon123",
"promoTitle": "New Year discount",
"quantity": 1,
"amount": 20,
"value": 20,
"groupId": "new-items",
"promotionType": "PROMOTION",
"priority": 1,
"stackable": false,
"sku": "16B2GS8LD5FDS",
"itemId": "1000000001",
"itemKey": "Key1234",
"message": "New Year Promotion",
"unit": "%OFF",
"proratedQuantity": 1,
"proratedAmount": 3.33
}
]
}
],
"promo": [
{
"code": "UNKNOWN_ERROR",
"detail": "Item is out of stock",
"itemId": "1000000001",
"sku": "16B2GS8LD5FDS",
"lineItemId": 1
}
],
"inventory": [
{
"code": "UNKNOWN_ERROR",
"detail": "Item is out of stock",
"itemId": "1000000001",
"sku": "16B2GS8LD5FDS",
"lineItemId": 1
}
]
},
"cartId": "d7e78a21-bee3-4448-bf1c-d5b5461dbda2",
"createdAt": "2022-02-11T14:09:40.836703",
"updatedAt": "2022-02-22T22:36:40.194293",
"totalItems": 3,
"totalUniqueItems": 2,
"cartState": "PENDING",
"tenantId": "5f689caa4216e7000750d1ef",
"accountId": "5f689caa4216e7000750d1ef",
"userId": "61b8e921d0cf2e000882b09f",
"configuration": {
"allowAnonymousUser": true,
"orderNumberSource": "CART_ID",
"softReserve": true,
"addItemBySkuEnabled": true
},
"customer": {
"id": "d7e78a21-bee3-4448-bf1c-d5b5461dbda2",
"type": "EMPLOYEE",
"attributes": {
"goldMember": [
false
]
},
"segments": {
"age": 23,
"gender": "female"
}
},
"totalAmount": 95,
"subTotal": 120,
"totalDiscount": 25,
"totalFees": 25,
"attributes": [
{
"attributeId": "60c2a358eb2ec30008ae70a1",
"name": "gift wrapping (small)",
"type": "GIFT",
"price": 10,
"description": "Gift wrapping for a small package",
"mapping": "ITEM",
"value": "true",
"level": "order",
"items": [
"1000000001"
]
}
],
"fees": [
{
"feeId": "73bc09d0-874a-4c3d-84d0-df1670d03578",
"name": "gift",
"type": "gift_wrap",
"amount": 10.5,
"attributes": "{'from': 'sam', 'to': 'david' }"
}
],
"suggestedProducts": [
{
"promotionId": "fef78121-bee3-4448-bf1c-d5b5461dbda2",
"promotionTitle": "Buy one get one free",
"itemId": 19,
"itemIds": [
19
],
"eligiblePriceLists": [
1000000001
],
"quantity": 1,
"promotionQuantity": 1,
"free": true,
"discountType": "AMOUNT_OFF",
"amount": 10
}
]
}{
"code": "Bad Request",
"message": "User ID or Cart ID does not exist"
}{
"code": "Cart or item not found",
"message": "If the issue persists please contact support@fabric.inc."
}{
"code": "Internal Server Error",
"message": "An internal error occurred. If the issue persists please contact support@fabric.inc."
}Cart
Add items to cart
Add items to cart, or create a new cart if cart does not exist
POST
/
v2
/
carts
/
items
Add items to cart
curl --request POST \
--url https://prod.cart.fabric.inc/v2/carts/items \
--header 'Authorization: <authorization>' \
--header 'Content-Type: application/json' \
--header 'x-site-context: <x-site-context>' \
--data '
{
"items": [
{
"itemId": "1000000001",
"quantity": 1,
"price": {
"currency": "USD",
"amount": 100,
"discount": {
"price": 80,
"promosApplied": [
{
"promoId": "fza065tdr787",
"promoCode": "coupon123",
"value": "20",
"unit": "%OFF"
}
],
"discounts": [
{
"promoId": "fza065tdr787",
"promoCode": "coupon123",
"promoTitle": "New Year discount",
"quantity": 1,
"amount": 20,
"value": 20,
"groupId": "new-items",
"promotionType": "PROMOTION",
"priority": 1,
"stackable": false,
"sku": "16B2GS8LD5FDS",
"itemId": "1000000001",
"itemKey": "Key1234",
"message": "New Year Promotion",
"unit": "%OFF",
"proratedQuantity": 1,
"proratedAmount": 3.33
}
],
"discountAmount": 20
},
"sale": 80
},
"sku": "16B2GS8LD5FDS",
"priceListId": "100000",
"type": "WEB_SHIP",
"subType": "Border-free",
"extra": {
"productFamily": "Laptop computers"
},
"fulfillment": {
"type": "WEB_SHIP",
"networkCode": "ShipToCNC",
"channelId": "12"
},
"group": [
"61d38e117162b7dba69c3d6d"
]
}
],
"cartId": "d7e78a21-bee3-4448-bf1c-d5b5461dbda2",
"name": "cart_it",
"description": "cart for the IT department",
"networkCode": "ShipToHome"
}
'import requests
url = "https://prod.cart.fabric.inc/v2/carts/items"
payload = {
"items": [
{
"itemId": "1000000001",
"quantity": 1,
"price": {
"currency": "USD",
"amount": 100,
"discount": {
"price": 80,
"promosApplied": [
{
"promoId": "fza065tdr787",
"promoCode": "coupon123",
"value": "20",
"unit": "%OFF"
}
],
"discounts": [
{
"promoId": "fza065tdr787",
"promoCode": "coupon123",
"promoTitle": "New Year discount",
"quantity": 1,
"amount": 20,
"value": 20,
"groupId": "new-items",
"promotionType": "PROMOTION",
"priority": 1,
"stackable": False,
"sku": "16B2GS8LD5FDS",
"itemId": "1000000001",
"itemKey": "Key1234",
"message": "New Year Promotion",
"unit": "%OFF",
"proratedQuantity": 1,
"proratedAmount": 3.33
}
],
"discountAmount": 20
},
"sale": 80
},
"sku": "16B2GS8LD5FDS",
"priceListId": "100000",
"type": "WEB_SHIP",
"subType": "Border-free",
"extra": { "productFamily": "Laptop computers" },
"fulfillment": {
"type": "WEB_SHIP",
"networkCode": "ShipToCNC",
"channelId": "12"
},
"group": ["61d38e117162b7dba69c3d6d"]
}
],
"cartId": "d7e78a21-bee3-4448-bf1c-d5b5461dbda2",
"name": "cart_it",
"description": "cart for the IT department",
"networkCode": "ShipToHome"
}
headers = {
"x-site-context": "<x-site-context>",
"Authorization": "<authorization>",
"Content-Type": "application/json"
}
response = requests.post(url, json=payload, headers=headers)
print(response.text)const options = {
method: 'POST',
headers: {
'x-site-context': '<x-site-context>',
Authorization: '<authorization>',
'Content-Type': 'application/json'
},
body: JSON.stringify({
items: [
{
itemId: '1000000001',
quantity: 1,
price: {
currency: 'USD',
amount: 100,
discount: {
price: 80,
promosApplied: [{promoId: 'fza065tdr787', promoCode: 'coupon123', value: '20', unit: '%OFF'}],
discounts: [
{
promoId: 'fza065tdr787',
promoCode: 'coupon123',
promoTitle: 'New Year discount',
quantity: 1,
amount: 20,
value: 20,
groupId: 'new-items',
promotionType: 'PROMOTION',
priority: 1,
stackable: false,
sku: '16B2GS8LD5FDS',
itemId: '1000000001',
itemKey: 'Key1234',
message: 'New Year Promotion',
unit: '%OFF',
proratedQuantity: 1,
proratedAmount: 3.33
}
],
discountAmount: 20
},
sale: 80
},
sku: '16B2GS8LD5FDS',
priceListId: '100000',
type: 'WEB_SHIP',
subType: 'Border-free',
extra: {productFamily: 'Laptop computers'},
fulfillment: {type: 'WEB_SHIP', networkCode: 'ShipToCNC', channelId: '12'},
group: ['61d38e117162b7dba69c3d6d']
}
],
cartId: 'd7e78a21-bee3-4448-bf1c-d5b5461dbda2',
name: 'cart_it',
description: 'cart for the IT department',
networkCode: 'ShipToHome'
})
};
fetch('https://prod.cart.fabric.inc/v2/carts/items', 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://prod.cart.fabric.inc/v2/carts/items",
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([
'items' => [
[
'itemId' => '1000000001',
'quantity' => 1,
'price' => [
'currency' => 'USD',
'amount' => 100,
'discount' => [
'price' => 80,
'promosApplied' => [
[
'promoId' => 'fza065tdr787',
'promoCode' => 'coupon123',
'value' => '20',
'unit' => '%OFF'
]
],
'discounts' => [
[
'promoId' => 'fza065tdr787',
'promoCode' => 'coupon123',
'promoTitle' => 'New Year discount',
'quantity' => 1,
'amount' => 20,
'value' => 20,
'groupId' => 'new-items',
'promotionType' => 'PROMOTION',
'priority' => 1,
'stackable' => false,
'sku' => '16B2GS8LD5FDS',
'itemId' => '1000000001',
'itemKey' => 'Key1234',
'message' => 'New Year Promotion',
'unit' => '%OFF',
'proratedQuantity' => 1,
'proratedAmount' => 3.33
]
],
'discountAmount' => 20
],
'sale' => 80
],
'sku' => '16B2GS8LD5FDS',
'priceListId' => '100000',
'type' => 'WEB_SHIP',
'subType' => 'Border-free',
'extra' => [
'productFamily' => 'Laptop computers'
],
'fulfillment' => [
'type' => 'WEB_SHIP',
'networkCode' => 'ShipToCNC',
'channelId' => '12'
],
'group' => [
'61d38e117162b7dba69c3d6d'
]
]
],
'cartId' => 'd7e78a21-bee3-4448-bf1c-d5b5461dbda2',
'name' => 'cart_it',
'description' => 'cart for the IT department',
'networkCode' => 'ShipToHome'
]),
CURLOPT_HTTPHEADER => [
"Authorization: <authorization>",
"Content-Type: application/json",
"x-site-context: <x-site-context>"
],
]);
$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://prod.cart.fabric.inc/v2/carts/items"
payload := strings.NewReader("{\n \"items\": [\n {\n \"itemId\": \"1000000001\",\n \"quantity\": 1,\n \"price\": {\n \"currency\": \"USD\",\n \"amount\": 100,\n \"discount\": {\n \"price\": 80,\n \"promosApplied\": [\n {\n \"promoId\": \"fza065tdr787\",\n \"promoCode\": \"coupon123\",\n \"value\": \"20\",\n \"unit\": \"%OFF\"\n }\n ],\n \"discounts\": [\n {\n \"promoId\": \"fza065tdr787\",\n \"promoCode\": \"coupon123\",\n \"promoTitle\": \"New Year discount\",\n \"quantity\": 1,\n \"amount\": 20,\n \"value\": 20,\n \"groupId\": \"new-items\",\n \"promotionType\": \"PROMOTION\",\n \"priority\": 1,\n \"stackable\": false,\n \"sku\": \"16B2GS8LD5FDS\",\n \"itemId\": \"1000000001\",\n \"itemKey\": \"Key1234\",\n \"message\": \"New Year Promotion\",\n \"unit\": \"%OFF\",\n \"proratedQuantity\": 1,\n \"proratedAmount\": 3.33\n }\n ],\n \"discountAmount\": 20\n },\n \"sale\": 80\n },\n \"sku\": \"16B2GS8LD5FDS\",\n \"priceListId\": \"100000\",\n \"type\": \"WEB_SHIP\",\n \"subType\": \"Border-free\",\n \"extra\": {\n \"productFamily\": \"Laptop computers\"\n },\n \"fulfillment\": {\n \"type\": \"WEB_SHIP\",\n \"networkCode\": \"ShipToCNC\",\n \"channelId\": \"12\"\n },\n \"group\": [\n \"61d38e117162b7dba69c3d6d\"\n ]\n }\n ],\n \"cartId\": \"d7e78a21-bee3-4448-bf1c-d5b5461dbda2\",\n \"name\": \"cart_it\",\n \"description\": \"cart for the IT department\",\n \"networkCode\": \"ShipToHome\"\n}")
req, _ := http.NewRequest("POST", url, payload)
req.Header.Add("x-site-context", "<x-site-context>")
req.Header.Add("Authorization", "<authorization>")
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://prod.cart.fabric.inc/v2/carts/items")
.header("x-site-context", "<x-site-context>")
.header("Authorization", "<authorization>")
.header("Content-Type", "application/json")
.body("{\n \"items\": [\n {\n \"itemId\": \"1000000001\",\n \"quantity\": 1,\n \"price\": {\n \"currency\": \"USD\",\n \"amount\": 100,\n \"discount\": {\n \"price\": 80,\n \"promosApplied\": [\n {\n \"promoId\": \"fza065tdr787\",\n \"promoCode\": \"coupon123\",\n \"value\": \"20\",\n \"unit\": \"%OFF\"\n }\n ],\n \"discounts\": [\n {\n \"promoId\": \"fza065tdr787\",\n \"promoCode\": \"coupon123\",\n \"promoTitle\": \"New Year discount\",\n \"quantity\": 1,\n \"amount\": 20,\n \"value\": 20,\n \"groupId\": \"new-items\",\n \"promotionType\": \"PROMOTION\",\n \"priority\": 1,\n \"stackable\": false,\n \"sku\": \"16B2GS8LD5FDS\",\n \"itemId\": \"1000000001\",\n \"itemKey\": \"Key1234\",\n \"message\": \"New Year Promotion\",\n \"unit\": \"%OFF\",\n \"proratedQuantity\": 1,\n \"proratedAmount\": 3.33\n }\n ],\n \"discountAmount\": 20\n },\n \"sale\": 80\n },\n \"sku\": \"16B2GS8LD5FDS\",\n \"priceListId\": \"100000\",\n \"type\": \"WEB_SHIP\",\n \"subType\": \"Border-free\",\n \"extra\": {\n \"productFamily\": \"Laptop computers\"\n },\n \"fulfillment\": {\n \"type\": \"WEB_SHIP\",\n \"networkCode\": \"ShipToCNC\",\n \"channelId\": \"12\"\n },\n \"group\": [\n \"61d38e117162b7dba69c3d6d\"\n ]\n }\n ],\n \"cartId\": \"d7e78a21-bee3-4448-bf1c-d5b5461dbda2\",\n \"name\": \"cart_it\",\n \"description\": \"cart for the IT department\",\n \"networkCode\": \"ShipToHome\"\n}")
.asString();require 'uri'
require 'net/http'
url = URI("https://prod.cart.fabric.inc/v2/carts/items")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Post.new(url)
request["x-site-context"] = '<x-site-context>'
request["Authorization"] = '<authorization>'
request["Content-Type"] = 'application/json'
request.body = "{\n \"items\": [\n {\n \"itemId\": \"1000000001\",\n \"quantity\": 1,\n \"price\": {\n \"currency\": \"USD\",\n \"amount\": 100,\n \"discount\": {\n \"price\": 80,\n \"promosApplied\": [\n {\n \"promoId\": \"fza065tdr787\",\n \"promoCode\": \"coupon123\",\n \"value\": \"20\",\n \"unit\": \"%OFF\"\n }\n ],\n \"discounts\": [\n {\n \"promoId\": \"fza065tdr787\",\n \"promoCode\": \"coupon123\",\n \"promoTitle\": \"New Year discount\",\n \"quantity\": 1,\n \"amount\": 20,\n \"value\": 20,\n \"groupId\": \"new-items\",\n \"promotionType\": \"PROMOTION\",\n \"priority\": 1,\n \"stackable\": false,\n \"sku\": \"16B2GS8LD5FDS\",\n \"itemId\": \"1000000001\",\n \"itemKey\": \"Key1234\",\n \"message\": \"New Year Promotion\",\n \"unit\": \"%OFF\",\n \"proratedQuantity\": 1,\n \"proratedAmount\": 3.33\n }\n ],\n \"discountAmount\": 20\n },\n \"sale\": 80\n },\n \"sku\": \"16B2GS8LD5FDS\",\n \"priceListId\": \"100000\",\n \"type\": \"WEB_SHIP\",\n \"subType\": \"Border-free\",\n \"extra\": {\n \"productFamily\": \"Laptop computers\"\n },\n \"fulfillment\": {\n \"type\": \"WEB_SHIP\",\n \"networkCode\": \"ShipToCNC\",\n \"channelId\": \"12\"\n },\n \"group\": [\n \"61d38e117162b7dba69c3d6d\"\n ]\n }\n ],\n \"cartId\": \"d7e78a21-bee3-4448-bf1c-d5b5461dbda2\",\n \"name\": \"cart_it\",\n \"description\": \"cart for the IT department\",\n \"networkCode\": \"ShipToHome\"\n}"
response = http.request(request)
puts response.read_body{
"items": [
{
"sku": "16B2GS8LD5FDS",
"items": [
{
"sku": "13B9CL6WT2SLW",
"quantity": 15,
"items": [
"<unknown>"
],
"cartItemId": "12gved0f-7645-40cb-y7b0-167f8bggdb3z",
"itemId": "1730902008",
"title": "Light Cover",
"attributes": [
{
"attributeId": "60c2a358eb2ec30008ae70a1",
"name": "gift wrapping (small)",
"type": "GIFT",
"price": 10,
"description": "Gift wrapping for a small package",
"mapping": "ITEM",
"value": "true",
"level": "order",
"items": [
"1000000001"
]
}
],
"createdAt": "2022-02-18T15:12:40.974580",
"updatedAt": "2022-02-18T15:12:40.974580",
"type": "WEB_SHIP",
"subType": "Border-free",
"priceListId": "108674",
"lineItemId": 1,
"isActive": true,
"unitPrice": {
"currency": "USD",
"amount": 100,
"discount": {
"price": 80,
"promosApplied": [
{
"promoId": "fza065tdr787",
"promoCode": "coupon123",
"value": "20",
"unit": "%OFF"
}
],
"discounts": [
{
"promoId": "fza065tdr787",
"promoCode": "coupon123",
"promoTitle": "New Year discount",
"quantity": 1,
"amount": 20,
"value": 20,
"groupId": "new-items",
"promotionType": "PROMOTION",
"priority": 1,
"stackable": false,
"sku": "16B2GS8LD5FDS",
"itemId": "1000000001",
"itemKey": "Key1234",
"message": "New Year Promotion",
"unit": "%OFF",
"proratedQuantity": 1,
"proratedAmount": 3.33
}
],
"discountAmount": 20
},
"sale": 80
},
"totalPrice": {
"currency": "USD",
"amount": 100,
"discount": {
"price": 80,
"promosApplied": [
{
"promoId": "fza065tdr787",
"promoCode": "coupon123",
"value": "20",
"unit": "%OFF"
}
],
"discounts": [
{
"promoId": "fza065tdr787",
"promoCode": "coupon123",
"promoTitle": "New Year discount",
"quantity": 1,
"amount": 20,
"value": 20,
"groupId": "new-items",
"promotionType": "PROMOTION",
"priority": 1,
"stackable": false,
"sku": "16B2GS8LD5FDS",
"itemId": "1000000001",
"itemKey": "Key1234",
"message": "New Year Promotion",
"unit": "%OFF",
"proratedQuantity": 1,
"proratedAmount": 3.33
}
],
"discountAmount": 20
},
"sale": 80
},
"attributeTotalPrice": 10,
"group": [
"61d38e117162b7dba69c3d6d"
],
"extra": {
"productFamily": "Laptop computers"
},
"channel": 12,
"isPickup": true,
"warehouseId": "XYZ-1234",
"shipToId": "fef78121-bee3-4448-bf1c-d5b5461dbda2",
"shipTo": {
"shipToId": "fef78121-bee3-4448-bf1c-d5b5461dbda2",
"cartId": "d7e78a21-bee3-4448-bf1c-d5b5461dbda2",
"createdAt": "2022-02-18T15:12:40.974580",
"updatedAt": "2022-02-18T15:12:40.974580",
"shipMethod": {
"cost": {
"amount": 10,
"currency": "USD",
"discount": 5
},
"shipMethodId": "1234",
"shipmentCarrier": "FedEx",
"shipmentMethod": "Next Day"
},
"address": {
"attention": "Billing manager",
"street1": "100 NE 100th St.",
"street2": "Suite 710",
"street3": "Seventh floor",
"street4": "Attention: Pat E. Kake",
"city": "Seattle",
"state": "Washington",
"country": "USA",
"zipCode": "98125",
"email": "test@mail.com",
"kind": "shipping",
"name": {
"first": "Pat",
"middle": "E",
"last": "Kake"
},
"phone": {
"number": "123-456-7899",
"kind": "MOBILE"
}
},
"shipToType": "SHIP_TO_ADDRESS",
"taxCode": "FR1000",
"isPickup": true,
"altPickupPerson": {
"name": {
"first": "Pat",
"middle": "E",
"last": "Kake"
},
"phone": {
"number": "123-456-7899",
"kind": "MOBILE"
},
"email": "test@mail.com"
},
"pickupPerson": {
"name": {
"first": "Pat",
"middle": "E",
"last": "Kake"
},
"phone": {
"number": "123-456-7899",
"kind": "MOBILE"
},
"email": "test@mail.com"
},
"warehouseId": "XYZ-1234",
"storeId": "ABC-123"
},
"fulfillment": {
"type": "WEB_SHIP",
"networkCode": "ShipToCNC",
"channelId": "12",
"inventoryType": "availablePreorder",
"inventory": {
"virtualCounters": {
"availableToPurchase": 10
},
"id": "62272e917b12209e68751d94",
"sku": "SKU00025",
"itemId": 4225678911,
"locationNum": 473746,
"channelId": 12,
"vendorId": "vendor123",
"leadTime": 1234,
"inventoryType": "Safety stock",
"infiniteInventory": true,
"counters": {
"on-hand": 10
},
"attributes": {
"buy online, pick up in-store (bopis)": true
},
"backOrderDate": "2022-08-08T00:00:00.000Z",
"preOrderDate": "2022-08-08T00:00:00.000Z",
"backOrderLimit": 100,
"preOrderLimit": 100,
"safetyStock": 10,
"lowStock": 10,
"segment": "Clothing",
"region": "US"
}
}
}
],
"quantity": 1,
"isPickup": true,
"cartItemId": "88cded0f-1439-40eb-a7a0-167e8bffdb3b",
"itemId": "1000000001",
"title": "Varnet Garden Light Kit",
"attributeTotalPrice": 10,
"createdAt": "2022-02-18T15:12:40.974580",
"updatedAt": "2022-02-18T15:12:40.974580",
"priceListId": "100000",
"lineItemId": 1,
"isActive": true,
"unitPrice": {
"currency": "USD",
"amount": 100,
"discount": {
"price": 80,
"promosApplied": [
{
"promoId": "fza065tdr787",
"promoCode": "coupon123",
"value": "20",
"unit": "%OFF"
}
],
"discounts": [
{
"promoId": "fza065tdr787",
"promoCode": "coupon123",
"promoTitle": "New Year discount",
"quantity": 1,
"amount": 20,
"value": 20,
"groupId": "new-items",
"promotionType": "PROMOTION",
"priority": 1,
"stackable": false,
"sku": "16B2GS8LD5FDS",
"itemId": "1000000001",
"itemKey": "Key1234",
"message": "New Year Promotion",
"unit": "%OFF",
"proratedQuantity": 1,
"proratedAmount": 3.33
}
],
"discountAmount": 20
},
"sale": 80
},
"totalPrice": {
"currency": "USD",
"amount": 100,
"discount": {
"price": 80,
"promosApplied": [
{
"promoId": "fza065tdr787",
"promoCode": "coupon123",
"value": "20",
"unit": "%OFF"
}
],
"discounts": [
{
"promoId": "fza065tdr787",
"promoCode": "coupon123",
"promoTitle": "New Year discount",
"quantity": 1,
"amount": 20,
"value": 20,
"groupId": "new-items",
"promotionType": "PROMOTION",
"priority": 1,
"stackable": false,
"sku": "16B2GS8LD5FDS",
"itemId": "1000000001",
"itemKey": "Key1234",
"message": "New Year Promotion",
"unit": "%OFF",
"proratedQuantity": 1,
"proratedAmount": 3.33
}
],
"discountAmount": 20
},
"sale": 80
},
"attributes": [
{
"attributeId": "60c2a358eb2ec30008ae70a1",
"name": "gift wrapping (small)",
"type": "GIFT",
"price": 10,
"description": "Gift wrapping for a small package",
"mapping": "ITEM",
"value": "true",
"level": "order",
"items": [
"1000000001"
]
}
],
"priceAdjustments": [
{
"id": "d7e78a21-bee3-4448-bf1c-d5b5461dbda2",
"reason": "compensation for delay",
"amount": 20,
"attributes": {
"goldMember": [
false
]
}
}
],
"warehouseId": "XYZ-1234",
"shipTo": {
"shipToId": "fef78121-bee3-4448-bf1c-d5b5461dbda2",
"cartId": "d7e78a21-bee3-4448-bf1c-d5b5461dbda2",
"createdAt": "2022-02-18T15:12:40.974580",
"updatedAt": "2022-02-18T15:12:40.974580",
"shipMethod": {
"cost": {
"amount": 10,
"currency": "USD",
"discount": 5
},
"shipMethodId": "1234",
"shipmentCarrier": "FedEx",
"shipmentMethod": "Next Day"
},
"address": {
"attention": "Billing manager",
"street1": "100 NE 100th St.",
"street2": "Suite 710",
"street3": "Seventh floor",
"street4": "Attention: Pat E. Kake",
"city": "Seattle",
"state": "Washington",
"country": "USA",
"zipCode": "98125",
"email": "test@mail.com",
"kind": "shipping",
"name": {
"first": "Pat",
"middle": "E",
"last": "Kake"
},
"phone": {
"number": "123-456-7899",
"kind": "MOBILE"
}
},
"shipToType": "SHIP_TO_ADDRESS",
"taxCode": "FR1000",
"isPickup": true,
"altPickupPerson": {
"name": {
"first": "Pat",
"middle": "E",
"last": "Kake"
},
"phone": {
"number": "123-456-7899",
"kind": "MOBILE"
},
"email": "test@mail.com"
},
"pickupPerson": {
"name": {
"first": "Pat",
"middle": "E",
"last": "Kake"
},
"phone": {
"number": "123-456-7899",
"kind": "MOBILE"
},
"email": "test@mail.com"
},
"warehouseId": "XYZ-1234",
"storeId": "ABC-123"
},
"channel": 12,
"group": [
"61d38e117162b7dba69c3d6d"
],
"fees": [
{
"feeId": "73bc09d0-874a-4c3d-84d0-df1670d03578",
"name": "gift",
"type": "gift_wrap",
"amount": 10.5,
"attributes": "{'from': 'sam', 'to': 'david' }"
}
]
}
],
"currency": "USD",
"metadata": {
"approver": "620d8896058edb0009385311"
},
"allPromosApplied": [
{
"promoId": "fza065tdr787",
"promoCode": "coupon123",
"value": "20",
"unit": "%OFF"
}
],
"sharedUserIds": [
"[\"*\"] or [userId1,userId2]"
],
"error": {
"price": [
{
"price": {
"base": 20,
"sale": 10,
"cost": 20,
"currency": "USD",
"finalPrice": 10,
"totalPrice": 20,
"kind": "Promotion",
"discount": 5.5
},
"channel": 12,
"kind": "PROMOTION",
"lineItemId": 1,
"discounts": [
{
"promoId": "fza065tdr787",
"promoCode": "coupon123",
"promoTitle": "New Year discount",
"quantity": 1,
"amount": 20,
"value": 20,
"groupId": "new-items",
"promotionType": "PROMOTION",
"priority": 1,
"stackable": false,
"sku": "16B2GS8LD5FDS",
"itemId": "1000000001",
"itemKey": "Key1234",
"message": "New Year Promotion",
"unit": "%OFF",
"proratedQuantity": 1,
"proratedAmount": 3.33
}
]
}
],
"promo": [
{
"code": "UNKNOWN_ERROR",
"detail": "Item is out of stock",
"itemId": "1000000001",
"sku": "16B2GS8LD5FDS",
"lineItemId": 1
}
],
"inventory": [
{
"code": "UNKNOWN_ERROR",
"detail": "Item is out of stock",
"itemId": "1000000001",
"sku": "16B2GS8LD5FDS",
"lineItemId": 1
}
]
},
"cartId": "d7e78a21-bee3-4448-bf1c-d5b5461dbda2",
"createdAt": "2022-02-11T14:09:40.836703",
"updatedAt": "2022-02-22T22:36:40.194293",
"totalItems": 3,
"totalUniqueItems": 2,
"cartState": "PENDING",
"tenantId": "5f689caa4216e7000750d1ef",
"accountId": "5f689caa4216e7000750d1ef",
"userId": "61b8e921d0cf2e000882b09f",
"configuration": {
"allowAnonymousUser": true,
"orderNumberSource": "CART_ID",
"softReserve": true,
"addItemBySkuEnabled": true
},
"customer": {
"id": "d7e78a21-bee3-4448-bf1c-d5b5461dbda2",
"type": "EMPLOYEE",
"attributes": {
"goldMember": [
false
]
},
"segments": {
"age": 23,
"gender": "female"
}
},
"totalAmount": 95,
"subTotal": 120,
"totalDiscount": 25,
"totalFees": 25,
"attributes": [
{
"attributeId": "60c2a358eb2ec30008ae70a1",
"name": "gift wrapping (small)",
"type": "GIFT",
"price": 10,
"description": "Gift wrapping for a small package",
"mapping": "ITEM",
"value": "true",
"level": "order",
"items": [
"1000000001"
]
}
],
"fees": [
{
"feeId": "73bc09d0-874a-4c3d-84d0-df1670d03578",
"name": "gift",
"type": "gift_wrap",
"amount": 10.5,
"attributes": "{'from': 'sam', 'to': 'david' }"
}
],
"suggestedProducts": [
{
"promotionId": "fef78121-bee3-4448-bf1c-d5b5461dbda2",
"promotionTitle": "Buy one get one free",
"itemId": 19,
"itemIds": [
19
],
"eligiblePriceLists": [
1000000001
],
"quantity": 1,
"promotionQuantity": 1,
"free": true,
"discountType": "AMOUNT_OFF",
"amount": 10
}
]
}{
"code": "Bad Request",
"message": "User ID or Cart ID does not exist"
}{
"code": "Cart or item not found",
"message": "If the issue persists please contact support@fabric.inc."
}{
"code": "Internal Server Error",
"message": "An internal error occurred. If the issue persists please contact support@fabric.inc."
}Headers
The x-site-context header is a JSON object that contains information about the source you wish to pull from. The mandatory account is the 24 character identifier found in Copilot. The channel (Sales channel ID), stage (environment name), and date attributes can be used to further narrow the scope of your data source.
Example:
"{\"date\": \"2023-01-01T00:00:00.000Z\", \"channel\": 12, \"account\": \"1234abcd5678efgh9ijklmno\",\"stage\":\"production\"}"
Body
application/json
Request body for adding items to, or updating items in the cart
Items (with details) to add to cart
Response
OK
Cart details
Was this page helpful?
