Criterios de homologación

Funcionalidades obligatorias

• Listar evaluaciones
  • Realice una solicitud GET /merchants/{merchantId}/reviews.
  Ejemplo cURL:
  curl -X GET "https://merchant-api.ifood.com.br/review/v2.0/merchants/{merchantId}/reviews?page=1&pageSize=10&addCount=true" \
    -H "Authorization: Bearer {JWT_TOKEN}" \
    -H "Content-Type: application/json"

  • Valide los campos: status, replies[], version, visibility.
  • Verifique paginación y conteo total con addCount=true (total, pageCount).
  • Confirme que el campo visibility retorna "PUBLIC" o "PRIVATE" correctamente.
  • Pruebe todos los estados: CREATED, NOT_REPLIED, REPLIED, PUBLISHED.
  • Use filtros de fecha (ejemplo: dateFrom=2024-01-01T00:00:00Z&dateTo=2024-01-31T23:59:59Z).
  • Simule escenario sin evaluaciones (reviews: [], total: 0).
  • Solicite más de 50 elementos por página y confirme respuesta 400 BAD REQUEST.
• Obtener detalles de la evaluación
  • Realice una solicitud GET /merchants/{merchantId}/reviews/{reviewId}.
  Ejemplo cURL:
  curl -X GET "https://merchant-api.ifood.com.br/review/v2.0/merchants/{merchantId}/reviews/{reviewId}" \
    -H "Authorization: Bearer {JWT_TOKEN}" \
    -H "Content-Type: application/json"

  • Valide el array replies[] y el campo from ("MERCHANT" o "CUSTOMER").
  • Confirme todos los campos V2.
  • Solicite una evaluación inexistente y verifique respuesta 404 NOT FOUND.
• Responder evaluación
  • Realice una solicitud POST /merchants/{merchantId}/reviews/{reviewId}/answers.
  Ejemplo cURL:
  curl -X POST "https://merchant-api.ifood.com.br/review/v2.0/merchants/{merchantId}/reviews/{reviewId}/answers" \
    -H "Authorization: Bearer {JWT_TOKEN}" \
    -H "Content-Type: application/json" \
    -d '{
      "text": "¡Muchas gracias por tu comentario! Estamos felices con la evaluación."
    }'

  • Responda solo evaluaciones con estado NOT_REPLIED.
  • Intente responder evaluaciones con estado PUBLISHED y confirme respuesta 422 UNPROCESSABLE ENTITY.
  • Valide el texto de la respuesta (10 a 300 caracteres). Confirme respuesta 201 CREATED para éxito y 422 para error de validación.
  • Asegúrese de que las respuestas no contengan lenguaje ofensivo, datos personales del cliente, ni enlaces o promociones no autorizadas.
  • Incluir documentación de la Política de Evaluaciones.

Endpoint adicional: Obtener resumen

• Resumen de evaluaciones
  • Realice una solicitud GET /merchants/{merchantId}/summary para obtener datos agregados de evaluaciones.
  Ejemplo cURL:
  curl -X GET "https://merchant-api.ifood.com.br/review/v2.0/merchants/{merchantId}/summary" \
    -H "Authorization: Bearer {JWT_TOKEN}" \
    -H "Content-Type: application/json"

  • Valide los campos: totalReviewsCount, validReviewsCount, score.
  • Confirme que el score es el promedio de las evaluaciones válidas de los últimos 3 meses.