X-Purchase cart

Key features

Working with shopping cart;
Auto evaluating taxes and prices;
Multi-Laguage;
Multi-Currency;
Lazy resolving;

QueryRoot

List of queries:

№	Endpoint	Arguments	Return
1	cart	`storeId` `cartName` `userId` `cultureName` `currencyCode` `cartType`	Shopping cart
2	carts	`storeId` `cartName` `userId` `cultureName` `currencyCode` `cartType` `sort` `skip` `take`	Paginated shopping cart list
### Cart
{ cart (storeId: "Electronics" cartName: "default" userId: "d97ee2c7-e29d-440a-a43a-388eb5586087" cultureName: "en-Us" currencyCode: "USD" cartType: "cart") { id name hasPhysicalProducts status storeId isAnonymous comment taxPercentRate taxType shipments { shipmentMethodCode shipmentMethodOption } availableShippingMethods { code optionName optionDescription } discounts { amount description } currency { code symbol } payments { paymentGatewayCode } availablePaymentMethods { code paymentMethodType } items { id sku } coupons { code isAppliedSuccessfully } itemsCount itemsQuantity type } }
> [!TIP]
> See also CartType schema for better understanding of possible fields in request.
### Carts connection
With this connection you can get all user's carts/whishlists.
`{ carts (storeId: "Electronics" userId: "d97ee2c7-e29d-440a-a43a-388eb5586087" cultureName: "en-Us" currencyCode: "USD" cartType: "cart" take: 5 skip: 0) { items { id name hasPhysicalProducts status storeId isAnonymous } pageInfo { startCursor endCursor hasNextPage hasPreviousPage } } }`

Queriable objects

CartType

CartType schema structure

Mutations

Every mutation contains base arguments for working with cart context: - storeId - Id of current store - cartName - Cart name - userId - Id of current user - currencyCode - Currency code (e.g. "USD") - cultureName - Culture name of current language (e.g. "en-Us") - cartType - Type of cart ("cart" or "whishlist")

Mutation list:

№	Endpoint	Arguments	Description
1	addItem	`!productId` `!quantity` `price` `comment`	Add item to cart.
2	clearCart	-	Remove items from cart.
3	changeComment	`comment`	Update cart comment.
4	changeCartItemPrice	`!productId` `!price`	Change cart item price.
5	changeCartItemQuantity	`!lineItemId` `!quantity`	Change cart item quantity.
6	changeCartItemComment	`!lineItemId` `comment`	Change cart item comment.
7	removeCartItem	`!lineItemId`	Remove cart item from cart.
8	addCoupon	`!couponCode`	Add coupon to cart.
9	removeCoupon	`couponCode`	Remove coupon from cart. If coupon not passed clear all coupons from cart.
10	removeShipment	`shipmentId`	Remove shipment from cart.
11	addOrUpdateCartShipment	`!shipment`(type)	Add or update shipment for cart.
12	addOrUpdateCartPayment	`!payment`(type)	Add or update payment for cart.
13	validateCoupon	`!coupon`	Validate coupon, return result.
14	mergeCart	`!secondCartId`	Merge two carts into one.
15	removeCart	`!cartId`	Remove cart.
16	clearShipments	-	Clear cart shipments.
17	clearPayments	-	Clear cart payments.

[!NOTE] In arguments column we only show additional arguments. if they are marked with an exclamation mark, they are required.

AddItem

This mutation validates item and add it to cart, recalculate promotion rewards and taxes then save cart.

Query:

mutation ($command:InputAddItemType!)
{
    (command: $command)
    {
        name
        items
        {
            id
            sku
        }
        itemsCount
        itemsQuantity
    }
}

Variables:

"command": {
    "storeId": "Electronics",
    "cartName": "default",
    "userId": "b57d06db-1638-4d37-9734-fd01a9bc59aa",
    "cultureName": "en-US",
    "currencyCode": "USD",
    "cartType": "cart",
    "productId": "9cbd8f316e254a679ba34a900fccb076",
    "quantity": 1
}

ClearCart

This mutation removes all items from cart, reset promotion rewards based on amount of items and save cart.

Query:

mutation ($command:InputClearCartType!)
{
    (command: $command)
    {
        name
        items
        {
            id
            sku
        }
        itemsCount
        itemsQuantity
    }
}

Variables:

"command": {
    "storeId": "Electronics",
    "cartName": "default",
    "userId": "b57d06db-1638-4d37-9734-fd01a9bc59aa",
    "cultureName": "en-US",
    "currencyCode": "USD",
    "cartType": "cart"
}

ChangeComment

This mutation changes cart comment.

Query:

mutation ($command:InputChangeCommentType!)
{
    (command: $command)
    {
        name
        comment
    }
}

Variables:

"command": {
    "storeId": "Electronics",
    "cartName": "default",
    "userId": "b57d06db-1638-4d37-9734-fd01a9bc59aa",
    "cultureName": "en-US",
    "currencyCode": "USD",
    "cartType": "cart",
    "comment": "Hi, Virto! :)"
}

ChangeCartItemPrice

This mutation changes cart item price.

Query:

mutation ($command:InputChangeCartItemPriceType!)
{
    (command: $command)
    {
        id
        items
        {
            sku
            productId
            listPrice
            listPriceWithTax
            salePrice
            salePriceWithTax
        }
    }
}

Variables:

"command": {
    "storeId": "Electronics",
    "cartName": "default",
    "userId": "b57d06db-1638-4d37-9734-fd01a9bc59aa",
    "cultureName": "en-US",
    "currencyCode": "USD",
    "cartType": "cart",
    "productId": "9cbd8f316e254a679ba34a900fccb076",
    "price": 777
}

ChangeCartItemQuantity

This mutation changes cart item quantity.

Query:

mutation ($command:InputChangeCartItemQuantityType!)
{
    (command: $command)
    {
        id
        items
        {
            sku
            productId
            quantity
        }
        itemsCount
        itemsQuantity
    }
}

Variables:

"command": {
    "storeId": "Electronics",
    "cartName": "default",
    "userId": "b57d06db-1638-4d37-9734-fd01a9bc59aa",
    "cultureName": "en-US",
    "currencyCode": "USD",
    "cartType": "cart",
    "lineItemId": "9cbd8f316e254a679ba34a900fccb076",
    "quantity": 7
}

ChangeCartItemComment

This mutation changes cart item comment.

Query:

mutation ($command:InputChangeCartItemCommentType!)
{
    (command: $command)
    {
        id
        items
        {
            sku
            productId
            comment
        }
    }
}

Variables:

"command": {
    "storeId": "Electronics",
    "cartName": "default",
    "userId": "b57d06db-1638-4d37-9734-fd01a9bc59aa",
    "cultureName": "en-US",
    "currencyCode": "USD",
    "cartType": "cart",
    "lineItemId": "9cbd8f316e254a679ba34a900fccb076",
    "comment": "nice product"
}

RemoveCartItem

This mutation removes item from cart.

Query:

mutation ($command:InputRemoveItemType!)
{
    (command: $command)
    {
        id
        items
        {
            sku
            productId
        }
        itemsCount
        itemsQuantity
    }
}

Variables:

"command": {
    "storeId": "Electronics",
    "cartName": "default",
    "userId": "b57d06db-1638-4d37-9734-fd01a9bc59aa",
    "cultureName": "en-US",
    "currencyCode": "USD",
    "cartType": "cart",
    "lineItemId": "9cbd8f316e254a679ba34a900fccb076",
}

AddCoupon

This mutation checks and adds coupon to cart.

Query:

mutation ($command:InputAddCouponType!)
{
    (command: $command)
    {
        name
        coupons
        {
            code
            isAppliedSuccessfully
        }
    }
}

Variables:

"command": {
    "storeId": "Electronics",
    "cartName": "default",
    "userId": "b57d06db-1638-4d37-9734-fd01a9bc59aa",
    "cultureName": "en-US",
    "currencyCode": "USD",
    "cartType": "cart",
    "couponCode": "freeItemsCouponCode",
}

RemoveCoupon

This mutation removes coupon from cart.

Query:

mutation ($command:InputRemoveCouponType!)
{
    (command: $command)
    {
        name
        coupons
        {
            code
            isAppliedSuccessfully
        }
    }
}

Variables:

"command": {
    "storeId": "Electronics",
    "cartName": "default",
    "userId": "b57d06db-1638-4d37-9734-fd01a9bc59aa",
    "cultureName": "en-US",
    "currencyCode": "USD",
    "cartType": "cart",
    "couponCode": "freeItemsCouponCode",
}

RemoveShipment

This mutation removes shipment from cart.

Query:

mutation ($command:InputRemoveShipmentType!)
{
    (command: $command)
    {
        name
        availableShippingMethods
        {
          code
          optionName
          optionDescription
        }
    }
}

Variables:

"command": {
    "storeId": "Electronics",
    "cartName": "default",
    "userId": "b57d06db-1638-4d37-9734-fd01a9bc59aa",
    "cultureName": "en-US",
    "currencyCode": "USD",
    "cartType": "cart",
    "shipmentId": "7777-7777-7777-7777",
}

AddOrUpdateCartShipment

This mutation adds or updates shipment of cart.

Query:

mutation ($command:InputAddOrUpdateCartShipmentType!)
{
    (command: $command)
    {
        name
        availableShippingMethods
        {
          code
          optionName
          optionDescription
        }
    }
}

Variables:

"command": {
    "storeId": "Electronics",
    "cartName": "default",
    "userId": "b57d06db-1638-4d37-9734-fd01a9bc59aa",
    "cultureName": "en-US",
    "currencyCode": "USD",
    "cartType": "cart",
    "shipment": {
        "fulfillmentCenterId": "7777-7777-7777-7777",
        "height": 7,
        "shipmentMethodCode": "code",
        "currency": "USD",
        "price": 98
    },
}

[!TIP] To see all possible parametrs for shipment object look here...

AddOrUpdateCartPayment

This mutation adds or updates payment of cart.

Query:

mutation ($command:InputAddOrUpdateCartPaymentType!)
{
    (command: $command)
    {
        name
        availablePaymentMethods
        {
          code
          name
          paymentMethodType
        }
    }
}

Variables:

"command": {
    "storeId": "Electronics",
    "cartName": "default",
    "userId": "b57d06db-1638-4d37-9734-fd01a9bc59aa",
    "cultureName": "en-US",
    "currencyCode": "USD",
    "cartType": "cart",
    "payment": {
        "outerId": "7777-7777-7777-7777",
        "paymentGatewayCode": "code",
        "currency": "USD",
        "price": 98,
        "amount": 55
    },
}

[!TIP] To see all possible parametrs for payment object look here...

ValidateCoupon

This mutation validates coupon.

Query:

mutation ($command:InputValidateCouponType!)
{
    (command: $command)
}

Variables:

"command": {
    "storeId": "Electronics",
    "cartName": "default",
    "userId": "b57d06db-1638-4d37-9734-fd01a9bc59aa",
    "cultureName": "en-US",
    "currencyCode": "USD",
    "cartType": "cart",
    "coupon": {
        "code": "freeItemsCouponCode"
    },
}

MergeCart

This mutation merges two carts. You can use it to merge anonymous cart with user cart after authorization.

Query:

mutation ($command:InputMergeCartType!)
{
    (command: $command)
    {
        id
        isAnonymous
    }
}

Variables:

"command": {
    "storeId": "Electronics",
    "cartName": "default",
    "userId": "b57d06db-1638-4d37-9734-fd01a9bc59aa",
    "cultureName": "en-US",
    "currencyCode": "USD",
    "cartType": "cart",
    "secondCartId": "7777-7777-7777-7777",
}

RemoveCart

This mutation removes cart.

Query:

mutation ($command:InputRemoveCartType!)
{
    (command: $command)
}

Variables:

"command": {
    "cartId": "7777-7777-7777-7777"
}

ClearShipments

This mutation removes all shipments from cart.

Query:

mutation ($command:InputClearShipmentsType!)
{
    (command: $command)
    {
        name
        availableShippingMethods
        {
          code
          optionName
          optionDescription
        }
    }
}

Variables:

"command": {
    "storeId": "Electronics",
    "cartName": "default",
    "userId": "b57d06db-1638-4d37-9734-fd01a9bc59aa",
    "cultureName": "en-US",
    "currencyCode": "USD",
    "cartType": "cart"
}

ClearPayments

This mutation removes all payments from cart.

Query:

mutation ($command:InputClearPaymentsType!)
{
    (command: $command)
    {
        name
        availablePaymentMethods
        {
          code
          name
          paymentMethodType
        }
    }
}

Variables:

"command": {
    "storeId": "Electronics",
    "cartName": "default",
    "userId": "b57d06db-1638-4d37-9734-fd01a9bc59aa",
    "cultureName": "en-US",
    "currencyCode": "USD",
    "cartType": "cart"
}

Last update: May 14, 2021