Califica automáticamente

De acuerdo con las reglas de negocios de MercadoLibre, una vez completada la venta (o compra), el comprador y el vendedor deben dar feedback sobre la transacción y calificarse mutuamente. Los compradores y vendedores consolidan sus reputaciones en base a las calificaciones de sus socios comerciales.

Contenidos:

Descripción de recursos

AtributoDescripción
completadoVerdadero o Falso. Indica si el pedido se completó o no. Obligatorio.
mensajeCadena con menos de 160 caracteres. Obligatorio.
calificaciónLos valores posibles son: ‘negativo’, ‘neutro’ en caso de ‘completado: ‘falso’ o ‘positivo’ en caso de ‘completado’: ‘verdadero’. Obligatorio.
motivoCampo obligatorio en caso de ‘completado’: ‘falso’.
restock_itemSolo para compradores, en caso de ‘completado’: ‘falso’. En caso de ‘restock_item’: ‘verdadero’ significa que el pedido no fue completado, por eso se debe reponer el artículo. La única restricción para la reposición es que el estado del artículo no puede ser ‘cerrado’.
has_seller_refunded_moneySolo para vendedores, cuando el pedido es ‘completado’: ‘falso’ y existe un pago asociado al pedido. Indica si el usuario emitió un reintegro al comprador.

Valores aceptados para enviar como “motivo”

VENDEDOR (Todos los sitios salvo MLB, MPA, MRD y MPT):

  • SELLER_OUT_OF_STOCK
  • SELLER_DIDNT_TRY_TO_CONTACT_BUYER
  • BUYER_NOT_ENOUGH_MONEY
  • BUYER_REGRETS

VENDEDOR (MPA, MRD y MPT):

  • SELLER_REGRETS
  • THEY_DIDNT_ANSWER
  • BUYER_REGRETS
  • SELLER_OUT_OF_STOCK
  • SELLER_DIDNT_TRY_TO_CONTACT_BUYER
  • BUYER_NOT_ENOUGH_MONEY
  • THEY_NOT_HONORING_POLICIES
  • OTHER_MY_RESPONSIBILITY
  • OTHER_THEIR_RESPONSIBILITY

COMPRADOR:

  • SELLER_OUT_OF_STOCK
  • BUYER_PAID_BUT_DID_NOT_RECEIVE
  • OTHER_MY_RESPONSIBILITY

Publicar feedback

Para asociar feedback a un pedido, realiza una solicitud POST al pedido como se muestra a continuación:

curl -X POST -H "Content-Type: application/json" -d
'{
  "fulfilled": false,
  "rating": "neutral",
  "message": "Operation not completed",
  "reason": "THEY_DIDNT_ANSWER",
  "restock_item": false,
  "has_seller_refunded_money": true
}'

"https://api.mercadolibre.com/orders/{order_Id}/feedback?access_token=$ACCESS_TOKEN"

Responder al Feedback

Puedes responder al feedback recibido de tus socios comerciales para explicar tus motivos u ofrecer información adicional con una solicitud POST a la API, incluyendo el feedback_id, como se describe a continuación:

curl -X POST -H "Content-Type: application/json" -d'{
"reply":"COMMENT 2."
}' "https://api.mercadolibre.com/feedback/{feedback_Id}/reply?access_token=$ACCESS_TOKEN"

¿Cómo averiguo el ID de Feedback de la otra parte?

Esta información se puede obtener con una solicitud GET a orders. Si ya la hiciste, no es necesario que vuelvas a hacerla porque el feedback_id está incluido en la respuesta GET:

curl -X GET "https://api.mercadolibre.com/orders/{order_Id}?access_token=$ACCESS_TOKEN"

Respuesta:

{
  "id": 825103323,
  "status": "confirmed",
  "status_detail": {
	"code": null,
	"description": null
  },
  "date_created": "2014-03-17T23:27:53.000-04:00",
  "date_closed": "2014-03-17T23:27:53.000-04:00",
  "last_updated": "2014-06-01T16:36:28.000-04:00",
  "order_items": [
	{
  	"item": {
    	"id": "MLA494467937",
    	"title": "Tag Heuer Aquaracer Automatico 43mm Cal16 Day-d Linea Nueva",
    	"variation_id": null,
    	"variation_attributes": []
  	},
  	"quantity": 1,
  	"unit_price": 24100,
  	"currency_id": "ARS"
	}
  ],
  "total_amount": 24100,
  "currency_id": "ARS",
  "buyer": {
	"id": 9981145,
	"nickname": "CARLITOS8665",
	"email": "carlitos8665@gmail.com",
	"phone": {
  	"area_code": "011",
  	"number": "1544706706",
  	"extension": null
	},
	"alternative_phone": {
  	"area_code": "011",
  	"number": "48027618",
  	"extension": null
	},
	"first_name": "Carlos",
	"last_name": "Acuña",
	"billing_info": {
  	"doc_type": null,
  	"doc_number": null
	}
  },
  "seller": {
	"id": 114499680,
	"nickname": "WATCHES-LUXURY2",
	"email": "watches-luxury2@hotmail.com",
	"phone": {
  	"area_code": null,
  	"number": "( 011) 1552490473",
  	"extension": null
	},
	"alternative_phone": {
  	"area_code": null,
  	"number": "",
  	"extension": null
	},
	"first_name": "carolina soledad",
	"last_name": "casares"
  },
  "payments": [],
  "feedback": {
	"purchase": {
  	"id": 5040068164512,
  	"date_created": "2014-04-07T11:20:00.000-04:00",
  	"fulfilled": true,
  	"rating": "positive",
  	"status": "active"
	},
	"sale": {
  	"id": 5040068160032,
  	"date_created": "2014-04-07T11:20:57.000-04:00",
  	"fulfilled": true,
 	 "rating": "neutral",
  	"status": "active"
	}
  },
  "shipping": {
	"status": "to_be_agreed"
  },
  "tags": [
	"paid",
	"not_delivered"
  ],
  "mediations": [],
  "application_id": "2568868276694852",
  "hidden_for_seller": false,
  "buying_mode": "buy_it_now"
}

Existe un par de feedback_id para cada transacción: venta y compra. En este ejemplo, el “id”: 5040103892781 es el feedback_id para el lado de venta, mientras que el “id”: 5040103885872 corresponde al lado de compra.

Modificar el feedback

Ya aprendiste cómo realizar una solicitud GET para obtener el feedback_id de la otra parte con solo realizar una solicitud POST a la API como se muestra a continuación:

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



Siguiente:
Consultas avanzadas.

Por favor califica del 1 al 5