PUT
Update Seller Product

Authorizations

x-api-key
string
header
required

Path Parameters

sku
string
required

SKU of the product, exactly as you registered it.

Body

application/json

All fields are optional. Send only the ones you want to change.

name
string

Product name.

variant
string

Variant of the product (size, color, flavor...).

category
string

Product category.

brand
string

Product brand.

active
boolean

Whether the product is active.

image
string

Currently not applied by this endpoint; the image cannot be changed through the API after creation.

composite
boolean

Currently not applied by this endpoint.

low_stock_notification_threshold
integer

Currently not applied by this endpoint.

Required range: x >= 1
inbound_minimum_shelf_life
integer

Minimum remaining shelf life, in days, a unit must have to be received into a Melonn warehouse. Must be greater than or equal to storage_minimum_shelf_life (the value sent, or the stored one). Cannot be cleared.

Required range: x >= 1
storage_minimum_shelf_life
integer

Minimum remaining shelf life, in days, a unit must keep while stored to remain available for orders. Cannot be cleared.

Required range: x >= 1
min_storage_temp_celcius
integer

Minimum storage temperature, in degrees Celsius.

Required range: x >= 1
max_storage_temp_celcius
integer

Maximum storage temperature, in degrees Celsius.

Required range: x >= 1
allows_cross_contamination
boolean

Whether the product can be stored next to other products without risk of cross contamination.

buyer_returns_allowed
boolean

Currently not applied by this endpoint.

control_by_lot_number
boolean

Currently not applied by this endpoint.

control_by_serial_number
boolean

Currently not applied by this endpoint.

expiration_date_format
string

Currently not applied by this endpoint.

fragile
boolean

Whether the product is fragile.

packing_instructions
string

Currently not applied by this endpoint.

perishable
boolean

Whether the product is perishable.

pre_packed_order_container
boolean

Currently not applied by this endpoint.

reception_instructions
string

Currently not applied by this endpoint.

requires_health_register
boolean

Currently not applied by this endpoint.

default_buyer_return_item_action_id
enum<string>

What to do with a unit returned by a buyer.

Available options:
RETURN_STOCK,
RETURN_SELLER,
DISCARD,
DONATE
restock_failed_inspection_buyer_return_item_action_id
enum<string>

What to do with a returned unit that fails the restock inspection.

Available options:
RETURN_STOCK,
RETURN_SELLER,
DISCARD,
DONATE
stackable
boolean

Whether units can be stacked on top of each other.

storage_instructions
string

Currently not applied by this endpoint.

seller_product_barcodes
object[]

Only the first barcode is used. If it is new, it is added to the product and becomes its main barcode. Use Create Barcode to add several barcodes.

seller_product_info_by_country
object

Cost, price and declared value of the product in one country.

Response

The product was updated. The body is the updated product with its product attributes at the top level and its packaging levels in seller_product_case_level.

The created or updated product, with the product attributes at the top level.

seller_id
integer

Your seller id.

active
boolean

Whether the product is active.

composite
boolean | null

Whether the product is a kit made of other products.

sku
string

Your code for the product.

external_barcode
string | null

Main barcode of the product.

source_seller_ecommerce_store_id
integer | null

Sales-channel store the product was imported from, if any.

reception_instructions
string | null
packing_instructions
string | null
creation_date
string<date-time> | null
last_updated_date
string<date-time> | null
buyer_returns_allowed
boolean
default_buyer_return_item_action_id
integer | null

1 RETURN_STOCK, 2 RETURN_SELLER, 3 DISCARD, 4 DONATE.

restock_failed_inspection_buyer_return_item_action_id
integer | null

1 RETURN_STOCK, 2 RETURN_SELLER, 3 DISCARD, 4 DONATE.

buyer_return_restock_inspection_instructions
string | null
low_stock_notification_threshold
integer

Stock level that triggers a low-stock notification.

last_low_stock_notification_date
string<date-time> | null
storage_instructions
string | null
requires_health_register
boolean | null
health_register_document_url
string | null
packing_material_type_id
integer | null
pre_packed_order_container
boolean | null
product_type_id
integer | null

1 = sellable product.

product_category_id
integer | null
product_category
string | null
product_brand_id
integer | null
product_brand
string | null
name
string
description
string | null
variant
string | null
perishable
boolean | null
control_by_lot_number
boolean | null
control_by_serial_number
boolean | null
fragile
boolean | null
net_content
string | null
small_image_url
string | null
medium_image_url
string | null
large_image_url
string | null
stackable
boolean | null
min_storage_temp_celcius
integer | null
max_storage_temp_celcius
integer | null
allows_cross_contamination
boolean | null
flammable
boolean | null
weapon
boolean | null
sat_category_id
integer | null

Mexican SAT product category, if assigned.

lot_number_regex
string | null
serial_number_regex
string | null
expiration_date_format
enum<string> | null
Available options:
DDMMYY,
MMDDYY,
DDMMMYY,
MMMDDYY,
DDMMM,
MMMYYYY,
null
use_state_height
number | null
use_state_length
number | null
use_state_width
number | null
use_state_dimensions_validated
boolean | null
exclude_from_dimensioning
boolean | null
requires_sanitary_registry
boolean | null
inbound_minimum_shelf_life
integer | null

Minimum remaining shelf life (days) to receive a unit.

storage_minimum_shelf_life
integer | null

Minimum remaining shelf life (days) to keep a stored unit available.

product_type
object
seller_product_case_level
object[]

Packaging levels of the product (unit, case...). Returned by Update Seller Product only.