Merge a listing

Learn how to merge an Amazon listing for a given selling partner and Amazon marketplace using the Listings Items API.

Prerequisites

To complete this tutorial, you need:

Authorization from the selling partner for whom you are making calls. Refer to Authorizing Selling Partner API Applications for more information.
Approval for the Product Listing role in your developer profile.
The Product Listing role selected in the App registration page for your application.

Patch Merge operation

You can use the Patch merge operation to update the quantity field within the fulfillment_availability without specifying other optional fields such as restock_date and lead_time_to_ship_max_days. You must provide non-empty values for the selector field such as fulfillment_channel_code. There are no changes to other optional fields if not included, such as, restock_date, lead_time_to_ship_max_days.

{
    "patches": [
        {
            # The new merge operation introduced into the Patch API.
            "op": "merge",
     
            # The merge operation operates on fulfillment_availability target property.
            "path": "/attributes/fulfillment_availability",
            
            "value": [
                {
                    # Merge operation must provide non empty values for selector fields.
                    "fulfillment_channel_code": "DEFAULT",
                    
                    # Updates the current value of the optional quantity field with the new value.
                    "quantity": 20,
                   
                    # no change to other optional fields such as restock_date, lead_time_to_ship_max_days if not included
                }
            ]
        }
        
    ]
}

You can use the Patch merge operation to delete previously set values for quantity_discount_plan within the purchasable_offer by setting explicit null values . You must provide non-empty values for the selector field such as audience.

{
    "patches": [
        {
            # The new merge operation introduced into the Patch API.
            "op": "merge",
            
            # The merge operation operates on the purchasable_offer attribute.
            "path": "/attributes/purchasable_offer",
            
            "value": [
                {
                    # Merge operation must provide non empty values for selector fields.
                    "audience": "B2B",
                    # The user wants to delete the quantity discount
                   "quantity_discount_plan": null,
                }
            ]
        }
     ]
}