Endpoint: https://{base_url}/v1/seller-products/{sku}/
Method: PATCH
Headers:
JWT {id_token}application/jsonapplication/jsonThe URL must contain the following parameter:
sku: unique code for seller sku;
It is possible to edit multiple product fields. The following examples are some, but not all, the possible changes which may be done in a product.
Response codes:
Products may only be edited when their status is created or rejected. This restriction is not applied for price and stock update. After all updated are made, the status should be updated to moderation.
There is no way to delete a product, but you can deactivate it. The API does not support deactivation, so it will be necessary to do it in the webapp.
Changing the status from rejected to moderation is not allowed, this change must be made in the webapp.
Some fields may not be edited after product submission. Example:
gtinskugroupseller_idcurl --location --request PATCH 'https://{base_url}/v1/seller-products/{sku}/' \
--header 'Accept: application/json' \
--header 'Content-Type: application/json' \
--header 'Authorization: JWT {id_token}' \
--data '{
"product_code": "54321",
"name": "Camisa Polo Muito Linda Mesmo",
"brand": "Novo Século",
"description": "Camisa Polo Muito Linda Mesmo\n\nCor: Verde\nTamanho: G\n\nLorem ipsum dolor sit amet, consectetur adipiscing elit. Ut dui enim, aliquam eu sagittis a, accumsan ac lectus. Pellentesque at facilisis odio. Nulla sollicitudin volutpat metus et pharetra. Nullam non velit aliquam, tempus mi et, posuere sem. Sed nec nisi nec nibh vulputate tincidunt. Duis facilisis ipsum vel vulputate tincidunt. Vestibulum sit amet posuere nisi, eget rutrum nunc. Morbi eu nisi tristique, accumsan leo eu, accumsan enim. Pellentesque quis libero risus. Nullam enim nisl, ultrices sit amet volutpat quis, tempor in ipsum. Nullam sodales congue diam. Cras accumsan libero sed eros facilisis, vitae aliquet turpis vestibulum. Praesent tortor ipsum, gravida sed mollis a, sollicitudin ac mauris. Proin laoreet bibendum lacus. Nunc a imperdiet felis. Morbi in orci sapien.",
"price": "290.00",
"offer": "290.00",
"active": true,
"approval": false,
"availability_days": 0,
"currency": "BRL",
"display_status": "draft",
"free_shipping": false,
"free_shipping_amount": "0.00",
"in_campaign": false,
"is_external_integration": false,
"new_display_status": "pending",
"origin": "developers",
"photo": "https://olist-v2-dev.s3.amazonaws.com/products-images/85c8e282-1f1a-4bda-a7cc-7b55553bfc94.jpg",
"rejection_reasons": {},
"seller_price": null,
"status": "created",
"tags": [],
"type": "simple",
"virtual_campaign_opt_in": false,
"waiting_invoice": false,
"categories": [],
"created_at": "2025-01-12T23:06:21.326733Z",
"updated_at": "2025-01-12T23:06:21.326748Z",
"attributes": [
{
"attribute_name": "Cor",
"attribute_value": "Verde",
"category_attribute_id": null
},
{
"attribute_name": "Tamanho",
"attribute_value": "G",
"category_attribute_id": null
}
],
"package_measures": [
{
"id": "1edc7644-9800-4e3a-a394-052ba8da5be8",
"height_unit": "cm",
"height_value": "50.0000",
"length_unit": "cm",
"length_value": "90.0000",
"width_unit": "cm",
"width_value": "20.0000",
"weight_unit": "g",
"weight_value": "2000.0000",
"capacity": 1
}
],
"prices": [
{
"channel_slug": "mercadolivre",
"currency": "BRL",
"minimum_quantity": 1,
"offer": "290.00",
"value": "300.00",
"price_freight_shift": "0.00"
}
],
"product_measures": [
{
"id": "ab6d67f8-9fcd-4637-864c-bfd79838cf62",
"height_unit": "cm",
"height_value": "2.0000",
"length_unit": "cm",
"length_value": "23.0000",
"weight_unit": "g",
"weight_value": "358.0000",
"width_unit": "cm",
"width_value": "16.0000"
}
],
"stock": [
{
"quantity": 5,
"availability_days": 0
}
]
}'{
"seller_id": "dfb54328d6-6a5d-4c0e-b7e3-546f0f74a3fb",
"gtin": "21700719670851",
"sku": "PRDG7N4L17PRPSBW",
"group": "",
"product_code": "54321",
"name": "Camisa Polo Muito Linda Mesmo",
"brand": "Novo Século",
"description": "Camisa Polo Muito Linda Mesmo\n\nCor: Verde\nTamanho: G\n\nLorem ipsum dolor sit amet, consectetur adipiscing elit. Ut dui enim, aliquam eu sagittis a, accumsan ac lectus. Pellentesque at facilisis odio. Nulla sollicitudin volutpat metus et pharetra. Nullam non velit aliquam, tempus mi et, posuere sem. Sed nec nisi nec nibh vulputate tincidunt. Duis facilisis ipsum vel vulputate tincidunt. Vestibulum sit amet posuere nisi, eget rutrum nunc. Morbi eu nisi tristique, accumsan leo eu, accumsan enim. Pellentesque quis libero risus. Nullam enim nisl, ultrices sit amet volutpat quis, tempor in ipsum. Nullam sodales congue diam. Cras accumsan libero sed eros facilisis, vitae aliquet turpis vestibulum. Praesent tortor ipsum, gravida sed mollis a, sollicitudin ac mauris. Proin laoreet bibendum lacus. Nunc a imperdiet felis. Morbi in orci sapien.",
"price": "290.00",
"offer": "290.00",
"active": true,
"approval": false,
"availability_days": 0,
"catalog_category": "",
"currency": "BRL",
"display_status": "draft",
"free_shipping": false,
"free_shipping_amount": "0.00",
"inactive_reason": "",
"in_campaign": false,
"is_external_integration": false,
"moderation_started_at": "",
"new_display_status": "pending",
"odin": "",
"origin": "developers",
"part_number": "",
"photo": "https://olist-v2-dev.s3.amazonaws.com/products-images/85c8e282-1f1a-4bda-a7cc-7b55553bfc94.jpg",
"price_freight_shift": "",
"previous_offer": "",
"quality_score": "",
"rejection_reasons": {},
"seller_price": null,
"status": "created",
"tags": [],
"tax_informations": "",
"type": "simple",
"virtual_campaign_opt_in": false,
"waiting_invoice": false,
"waiting_validation": "",
"categories": [],
"created_at": "2025-01-12T23:06:21.326733Z",
"updated_at": "2025-01-12T23:13:49.753483Z",
"attributes": [
{
"attribute_name": "Cor",
"attribute_value": "Verde",
"category_attribute_id": null
},
{
"attribute_name": "Tamanho",
"attribute_value": "G",
"category_attribute_id": null
}
],
"package_measures": [
{
"id": "96f26e18-66cd-4ef9-8d34-dba00022d5be",
"height_unit": "cm",
"height_value": "50.0000",
"length_unit": "cm",
"length_value": "90.0000",
"width_unit": "cm",
"width_value": "20.0000",
"weight_unit": "g",
"weight_value": "2000.0000",
"capacity": 1
}
],
"photos": [
{
"id": "254fa3c1-406d-4f55-94c1-0086041e183d",
"order": 0,
"url": "https://olist-v2-dev.s3.amazonaws.com/products-images/85c8e282-1f1a-4bda-a7cc-7b55553bfc94.jpg",
"status": "pending",
"metadata": {},
"automatic_changes": [],
"download_error_reason": ""
},
{
"id": "39772172-dff3-46dd-bf63-7291a49a122e",
"order": 1,
"url": "https://olist-v2-dev.s3.amazonaws.com/products-images/c44563a73974485a-99cf-d58f9d67e599.jpg",
"status": "pending",
"metadata": {},
"automatic_changes": [],
"download_error_reason": ""
}
],
"prices": [
{
"channel_slug": "mercadolivre",
"currency": "BRL",
"minimum_quantity": 1,
"offer": "290.00",
"value": "300.00",
"price_freight_shift": "0.00"
}
],
"product_measures": [
{
"id": "c5ac1254-c8ff-45e6-926d-dd98fc1d38c5",
"height_unit": "cm",
"height_value": "2.0000",
"length_unit": "cm",
"length_value": "23.0000",
"weight_unit": "g",
"weight_value": "358.0000",
"width_unit": "cm",
"width_value": "16.0000"
}
],
"stock": [
{
"quantity": 5,
"availability_days": 0
}
]
}What's Next
Notification Details