Shopify Individual Availability V2

Mark available v2 API:

POST: https://montecarlo.auperator.co/product-engine/api/v2/productListing

Request Body:

{
	"esin" : "0SGAT12SG25F",
	"channelCode" : "CH1234",
	"availability" : true
}

Response:

Case1: Success

{
    "esin": "0MPDO3FMHSR",
    "channelCode": "CH1234",
    "availability": true
}

Case2: Duplicate Listings

{
    "availability": false,
    "reason": "Duplicate Listings present for the product",
    "markAvailableDuplicateListings": [
        {
            "Shopify Variant SKU": "EBTRR",
            "shopify_handle_52": "z",
            "mrp": "399.00",
            "shopify_inventory_item_id_52": "40125733535938"
        },
        {
            "Shopify Variant SKU": "newvariant",
            "shopify_handle_52": "z",
            "mrp": "399.00",
            "shopify_inventory_item_id_52": "41820511764674"
        }
    ],
    "reasonCode": "listing_duplicate"
}

Call mark available API with the below request:

{
	"esin" : "0SGAT12SG25F",
	"channelCode" : "CH1234",
	"availability" : true,
	"sellerSku": "EBTRR"
}

Case3: Listing not available on shopify

{
 "availability": false,
 "message":"shopify_handle_52,sellerSku",
 "identifiers": [
        {
            "label": "Shopify Variant SKU",
            "internalName": "sellerSku"
        }
    ],
    "properties": [
        {
            "internalName": "shopify_handle_52"
        }
    ],
 "reason": "Listings Not present for the product",
 "reasonCode":"listing_unavailable"
}

label for sellerSku is as per the integration type eg: for flipkart: “Flipkart Seller SKU ID”

shopify: “Shopify Variant SKU“

Case4: Handle and property don't exist in product

{
    "availability": false,
    "message": "shopify_handle_52, sellerSku",
    "reason": "Required information is not available for the product",
    "reasonCode": "missing_fields",
    "identifiers": [
        {
            "label": "Shopify Variant SKU",
            "internalName": "sellerSku"
        }
    ],
  "properties": [
          {
            
            "internalName": "shopify_handle_52"
             
          }
      ]
}

Get label against the internalName shopify_handle_52
Open Pop up with fields sellerSku and label from above step
Update product
{ "additionalNames": { "others": [ "{{sellerSku}}" ] }, "properties": [ { "internalName": "shopify_handle_52", "value": [ "40122959331522" ] } ] }

When both additionalNames and properties are updated, Request for mark availability v2 API
{ "esin" : "0SGAT12SG25F", "channelCode" : "CH1234", "availability" : true, "sellerSku": "ABC_M", "properties": [ { "internalName": "shopify_product_handle_52", "value": [ "40122959331522" ] } ] }
When only property is updated, Request:
{ "esin" : "0SGAT12SG25F", "channelCode" : "CH1234", "availability" : true, "properties": [ { "internalName": "shopify_product_handle_52", "value": [ "40122959331522" ] } ] }
When only seller SKU is updated, Request:
{ "esin" : "0SGAT12SG25F", "channelCode" : "CH1234", "availability" : true, "sellerSku": "ABC_M", }

Success Response:

{
	"esin" : "0SGAT12SG25F",
	"channelCode" : "CH1234",
	"availability" : true,
	"sellerSku": "ABC_M",
    "properties": [
            {
              
              "internalName": "shopify_handle_52",
                "value": [
                    "40122959331522"
                ]
            }
        ]
}

Unavailable:

{
 "availability": false,
 "message":"shopify_handle_52,sellerSku",
 "identifiers": [
        {
            "label": "Shopify Variant SKU",
            "internalName": "sellerSku"
        }
    ],
    "properties": [
        {
            "internalName": "shopify_handle_52"
        }
    ],
 "reason": "Listings Not present for the product",
 "reasonCode":"sellerSku_unavailable"
}

Cases:

Property value check: comparing request body property with existing property in the product
{ "availability": false, "message": "shopify_handle_52, sellerSku", "reason": "shopify_handle_52 value mismatch", "reasonCode": "property_mismatch", "identifiers": [ { "label": "Shopify Variant SKU", "internalName": "sellerSku" } ], "properties": [ { "internalName": "shopify_handle_52" } ] }
SellerSKu value mismatch
{ "availability": false, "message": "shopify_handle_52, sellerSku", "reason": "Seller Sku is not available in product identifiers", "reasonCode": "sellerSku_mismatch", "identifiers": [ { "label": "Shopify Variant SKU", "internalName": "sellerSku" } ], "properties": [ { "internalName": "shopify_handle_52" } ] }

reasonCode	Reason

reasonCode	Reason
listing_unavailable	When listing is not available on shopify
sellerSku_unavailable	When the updated product is not available on shopify
`listing_duplicate`	When duplicate listings are present on shopify
`missing_fields`	When shopify handle property does not exist in the product
sellerSku_mismatch	When the sellerSku mentioned in the request does not exist in the product
property_mismatch	When the handle property provided in the request does not exist in the product

Apps and Automations

Shopify Individual Availability V2

Related content