Documentação do Mercado Livre

Confira todas as informações necessárias sobre as APIs Mercado Livre.
circulos azuis em degrade

Documentação do

Última atualização em 02/10/2023

Feedback on sale

Once a sale (or purchase) is fulfilled, the Seller may leave his/her feedback on the transaction and qualify the counterparty.
When the transaction is qualified as fulfilled, "custom" and "me1" shipments show that the product has been already delivered; therefore, bear in mind that this process should be started only if you are sure that the product has been delivered to the buyer. This way when the seller qualifies, a message will be sent to the buyer asking him/her about the sale and requesting confirmation of such sale product delivery.
Currently, this action is valid only for tracking shipment delivered statuses, that is, it has no impact on the involved Seller's reputation; it should be always applied to change status to delivered in sales without Mercado Envíos, moving these sales to the completed lists.


Resource description

Attribute Description
fulfilled True or False. Indicates whether the order was completed or not.Required.
message A string under 160 chars. Required.
rating Possible values are ‘negative’, ‘neutral’ in case ‘fulfilled’: ‘false’ or positive in case ‘fulfilled’: ‘true’. Required.
reason Mandatory field in case ‘fulfilled’: ‘false’.
restock_item Only for sellers, when ‘fulfilled’: ‘false’. When ‘restock_item’: ‘true’ means the order was not completed so the item should be restocked. The only restriction for restocking is that the status of the item cannot be ‘closed’.


Accepted values to send as "reason"

Sellers' available reasons are:

  • OUT_OF_STOCK: Out of stock
  • BUYER_NOT_ENOUGH_MONEY: Seller does not answer
  • BUYER_REGRETS: Buyer does not have enough money
  • SELLER_REGRETS: Buyer regrets transaction
  • BUYER_DID_NOT_ANSWER: Buyer does not answer
  • THEY_NOT_HONORING_POLICIES: Buyer is not honoring the policies
  • OTHER_MY_RESPONSIBILITY: It is my own responsibility (other reason)
  • OTHER_THEIR_RESPONSIBILITY: It is the counterparty's responsibility (other reason)
  • DUBIOUS_BUYER: Buyer is not reliable
  • HIGH_ML_COMISSION: Very high sales commission
  • HIGH_TAXES: Very high taxes
  • SELLER_HOLIDAY: No operations due to vacations
  • UNFRIENDLY_SHIPMENT_POLICY: Buyer does not accept shipment policy
  • UNAVAILABLE_PRODUCT: Product is not available
  • SELLER_ADDRESS_WITHDRAWAL: Buyer chooses to pick up product in person
  • WRONG_RECEIVER_ADDRESS: Wrong delivery address
  • HIGH_SHIPMENT_COST: Very high shipment costs
  • WRONG_SHIPMENT_COST: Wrongly estimated shipment cost
  • UNPRINTED_LABEL: Unable to print label
  • UNWITHDRAWN_PRODUCT_BY_DELIVER_COMPANY: Shipping company failed to pick up product for delivery
  • DENIED_PACKAGE: Shipping company failed to accept package due to size or weight
  • UNABLE_TO_READ_LABEL: Shipping company cannot read label
  • MANUFACTURING_PRODUCT_NOT_FINISHED: Unfinished manufactured product
  • SHIPMENT_PROBLEM_OTHER: Other shipment problems
  • DELIVERY_COMPANY_PROBLEM_OTHER: Shipping company had other problems

Buyers' available reasons are:

  • OUT_OF_STOCK: Out of stock
  • BUYER_PAID_BUT_DID_NOT_RECEIVE: Buyer made payment but did not receive product
  • OTHER_MY_RESPONSIBILITY: It is my own responsibility (other reason)
  • BUYER_REGRETS: Buyer regrets transaction
  • HIGH_SHIPMENT_COST: High shipment cost
  • SELLER_DID_NOT_ANSWER: Seller does not answer
  • THEY_NOT_HONORING_POLICIES: Buyer does not answer
  • OTHER_THEIR_RESPONSIBILITY: Seller is not honoring the policies
  • DESCRIPTION_DIDNT_MATCH_ARTICLE: The description does not match item


Posting feedback

You can reply to feedback you received from your trading partners to explain your reasons or to give additional information by doing a POST to the API, including feedback_id, as follows:

curl -X POST -H 'Authorization: Bearer $ACCESS_TOKEN' -H 'Content-Type: application/json' -d
'{
  "fulfilled": false,
  "rating": "neutral",
  "message": "Operation not completed",
  "reason": "OUT_OF_STOCK",
  "restock_item": false,
}'
https://api.mercadolibre.com/orders/$ORDER_ID/feedback
Notes:
- The seller cannot make a "not fulfilled" feedback once the order expired.
Status: 400
Error: not_fulfilled_feedback_in_order_expired.
Error message: You can't submit a not fulfilled feedback after order has expired.
- It's not allowed to create feedback more than once, when you make that POST again you will receive a 400 error.


Responding to feedback

You can respond to feedback received from your trading partners to explain your reasons or offer additional information with a POST request, including the feedback_id, as described below:

curl -X POST -H 'Authorization: Bearer $ACCESS_TOKEN' -H 'Content-Type: application/json' -d'{
"reply":"Muchas gracias por la buena predisposición"
}'
https://api.mercadolibre.com/feedback/$FEEDBACK_ID/reply


Get a sale feedback

Nota:
Sellers can access sales feedbacks that are up to 5 (five) years old.

With the following GET request to /orders/$order_id/feedback resource you can check the feedbacks made on sales and in the response you will also get the feedback_id:

Request:

curl -X GET -H 'Authorization: Bearer $ACCESS_TOKEN' https://api.mercadolibre.com/orders/$ORDER_ID/feedback

Example:

curl -X GET -H 'Authorization: Bearer $ACCESS_TOKEN' https://api.mercadolibre.com/orders/825103323/feedback

Respuesta:

{
	"sale": {
		"reason": null,
		"item": {
			"price": 275.48,
			"id": "MLB1179412386",
			"title": "Capa Térmica Para Piscina Thermocap Preta 7,5x3 Metros",
			"currency_id": "BRL"
		},
		"role": "seller",
		"extended_feedback": [],
		"date_created": "2020-09-25T16:33:29.000-04:00",
		"fulfilled": true,
		"rating": "positive",
		"visibility_date": "2020-09-29T18:39:35.000-04:00",
		"restock_item": false,
		"message": null,
		"has_seller_refunded_money": null,
		"site_id": "MLB",
		"modified": false,
		"from": {
			"nickname": "OLIST",
			"id": 219324699,
			"status": "active",
			"points": 702811
		},
		"id": 5040068160032,
		"to": {
			"nickname": "OLAD3975325",
			"id": 230788845,
			"status": "active",
			"points": 22
		},
		"reply": null,
		"order_id": 4025473265,
		"app_id": "1505",
		"status": "active"
	},
	"purchase": {
		"reason": null,
		"item": {
			"price": 275.48,
			"id": "MLB1179412386",
			"title": "Capa Térmica Para Piscina Thermocap Preta 7,5x3 Metros",
			"currency_id": "BRL"
		},
		"role": "buyer",
		"extended_feedback": [],
		"date_created": "2020-09-29T18:39:36.000-04:00",
		"fulfilled": true,
		"rating": "positive",
		"visibility_date": "2020-09-29T18:39:35.000-04:00",
		"message": "Produto chegou no prazo!",
		"has_seller_refunded_money": null,
		"site_id": "MLB",
		"modified": false,
		"from": {
			"nickname": "OLAD3975325",
			"id": 230788845,
			"status": "active",
			"points": 22
		},
		"id": 5040068164512,
		"to": {
			"nickname": "OLIST",
			"id": 219324699,
			"status": "active",
			"points": 702811
		},
		"reply": null,
		"order_id": 4025473265,
		"app_id": "1505",
		"status": "active"
	}
}

There is one pair of feedback_id for each transaction: sale and purchase. In this test example,“id”: 5040068160032 is the feedback_id for the sale-side , while “id”: 5040068164512 corresponds to purchase-side.

Notas:
In the case of shipments without Mercado Envíos (or Customized Shipping), it is essential to have the sales feedback for a successful closure. This is the confirmation that the buyer has received their product and is satisfied with the transaction. To validate that sales feedback has been received properly, it is important to verify certain attributes, such as:

"role": "buyer",
"extended_feedback": [],
"date_created": "2020-09-29T18:39:36.000-04:00",
"fulfilled": true,
"rating": "positive",
"visibility_date": "2020-09-29T18:39:35.000-04:00",
"message": "Produto chegou no prazo!",
"has_seller_refunded_money": null,
"site_id": "MLB"

It's important to highlight that once the sales feedback has been received and it has been confirmed that the transaction has been successfully completed, the payment is released to the seller. This is a crucial step to ensure reliability and efficiency in all transactions conducted through Mercado Libre.


Consult feedback

You can also make a GET request to get the details of a feedbacks using the ID of the feedback obtained in orders.

Request:

curl -X GET -H 'Authorization: Bearer $ACCESS_TOKEN'https://api.mercadolibre.com/feedback/$FEEDBACK_ID

Example:

curl -X GET -H 'Authorization: Bearer $ACCESS_TOKEN' https://api.mercadolibre.com/feedback/9041207884458

Resposta:

{
	"adult_content": false,
	"reason": null,
	"item": {
		"price": 275.48,
		"id": "MLB1179412386",
		"title": "Capa Térmica Para Piscina Thermocap Preta 7,5x3 Metros",
		"currency_id": "BRL"
	},
	"role": "seller",
	"extended_feedback": [],
	"date_created": "2020-09-25T16:33:29.000-04:00",
	"fulfilled": true,
	"rating": "positive",
	"visibility_date": "2020-09-29T18:39:35.000-04:00",
	"restock_item": false,
	"message": null,
	"has_seller_refunded_money": null,
	"site_id": "MLB",
	"modified": false,
	"from": {
		"nickname": "OLIST",
		"id": 219324699,
		"status": "active",
		"points": 702831
	},
	"id": 9041207884458,
	"to": {
		"nickname": "OLAD3975325",
		"id": 230788845,
		"status": "active",
		"points": 22
	},
	"reply": null,
	"order_id": 4025473265,
	"status": "active"
}
}


Changing feedback

You have already learned how to GET the other party’s feedback_id just by doing a POST to the API as follows:

curl -X PUT -H 'Authorization: Bearer $ACCESS_TOKEN' -H 'Content-Type: application/json' -d '{
  "fulfilled": true,
  "rating": "positive",
  "message": "It’s ok.",
}'
https://api.mercadolibre.com/feedback/$FEEDBACK_ID

Next topic: Searches & advanced features.