> ## Documentation Index > Fetch the complete documentation index at: https://docs.getjusto.com/llms.txt > Use this file to discover all available pages before exploring further. # List order reviews > Lista las valoraciones de pedidos ecommerce de la marca autorizada: nota de la comida, nota del delivery, NPS, motivos, comentarios y preguntas personalizadas. Se ordenan de la más reciente a la más antigua. La data siempre queda limitada a la marca y a los locales de la autorización. Lista las valoraciones de los pedidos ecommerce de la marca autorizada: la nota de la comida, la nota del delivery, el NPS, los motivos, los comentarios y las respuestas a las preguntas personalizadas. Es la misma información que muestra la pestaña **Valoraciones** del panel de Justo. Requiere el permiso `admin`. La data queda siempre limitada a la marca y a los locales de la autorización, sin enviar `websiteId` en la request. ## Paginación Las valoraciones vienen ordenadas de la más reciente a la más antigua, con un orden estable entre páginas. Usa `page` y `limit` (20 por defecto, máximo 100) y avanza mientras `hasNextPage` sea `true`. ## Sincronizar valoraciones nuevas Para traer valoraciones periódicamente, consulta con `fromDate` igual a la fecha de tu última sincronización y recorre todas las páginas. El cliente puede modificar su valoración hasta 2 horas después de su última respuesta. Si la valoración viene sin `completedAt`, el cliente no la marcó como terminada y puede seguir cambiando. Para tener la versión final, vuelve a consultar ese período pasadas 2 horas. Hay valoraciones que nunca se marcan como terminadas: si filtras solo las que traen `completedAt`, las pierdes. Usa `_id` para actualizar valoraciones que ya guardaste en vez de duplicarlas. Cada valoración trae el `orderId`, con el que puedes obtener el detalle del pedido en [Obtener pedido](https://docs.getjusto.com/docs/ecommerce/endpoints/orders/get-order.md). ## OpenAPI ````yaml get /ecommerce/reviews openapi: 3.1.0 info: title: Justo API version: 3.0.0 servers: - url: https://api.service.getjusto.com/v3 description: Production server security: [] paths: /ecommerce/reviews: get: summary: List order reviews description: >- Lista las valoraciones de pedidos ecommerce de la marca autorizada: nota de la comida, nota del delivery, NPS, motivos, comentarios y preguntas personalizadas. Se ordenan de la más reciente a la más antigua. La data siempre queda limitada a la marca y a los locales de la autorización. parameters: - in: query name: storesIds required: false schema: type: array items: type: string description: Un arreglo con el ID o ID externo de los locales. - in: query name: fromDate required: false schema: type: string format: date-time description: Incluir valoraciones creadas desde esta fecha. - in: query name: toDate required: false schema: type: string format: date-time description: Incluir valoraciones creadas hasta esta fecha. - in: query name: page required: false schema: type: number example: 1 description: Número de página. - in: query name: limit required: false schema: type: number example: 10 description: 'Número de items por página. Max 100. Por defecto: 10.' responses: '200': description: The OpenAPI spec content: application/json: schema: type: object properties: success: type: boolean example: true data: type: object properties: items: type: array items: $ref: '#/components/schemas/apiReview' description: Items de la lista. hasNextPage: type: boolean description: Indica si hay una página siguiente. hasPreviousPage: type: boolean description: Indica si hay una página anterior. totalPages: type: number description: Total de páginas. totalCount: type: number description: Total de items. '400': description: Errors content: application/json: schema: type: object properties: success: type: boolean example: 'false' error: type: object properties: error: type: string example: error message: type: string example: The request has an error components: schemas: apiReview: type: object description: >- Valoración de un pedido ecommerce, la misma que se muestra en la pestaña Valoraciones del panel. Los campos sin respuesta del cliente no se incluyen. properties: _id: type: string description: ID de la valoración. websiteId: type: string description: ID de la marca. storeId: type: string description: ID del local del pedido. orderId: type: string description: ID del pedido. Sirve para consultar GET /ecommerce/orders/{orderId}. orderCode: type: string description: Código del pedido que se muestra en el panel. example: '#1234-05' orderDate: type: string example: '2020-01-01T00:00:00.000Z' format: date-time description: Fecha de entrega del pedido. rating: type: number enum: - 1 - 2 - 3 - 4 - 5 description: Nota de la comida (o de los productos, en tiendas), de 1 a 5. comment: type: string description: Comentario sobre la comida. ratingReason: $ref: '#/components/schemas/apiReviewRatingReason' deliveryRating: type: number enum: - 1 - 2 - 3 - 4 - 5 description: Nota del delivery, de 1 a 5. deliveryComment: type: string description: Comentario sobre el delivery. ratingDeliveryReason: $ref: '#/components/schemas/apiReviewRatingReason' npsRating: type: number minimum: 0 maximum: 10 description: Probabilidad de recomendar la marca (NPS), de 0 a 10. hasManagedDelivery: type: boolean description: Si el despacho lo hizo Justo. customReviews: type: array items: $ref: '#/components/schemas/apiCustomReview' description: Respuestas a las preguntas personalizadas de la marca. createdAt: type: string example: '2020-01-01T00:00:00.000Z' format: date-time description: Fecha en que el cliente empezó la valoración. updatedAt: type: string example: '2020-01-01T00:00:00.000Z' format: date-time description: Última modificación de la valoración. completedAt: type: string example: '2020-01-01T00:00:00.000Z' format: date-time description: >- Fecha en que el cliente terminó la valoración. Si no viene, el cliente todavía puede modificarla (hasta 2 horas desde la última respuesta). apiReviewRatingReason: type: object description: Motivo que eligió el cliente para explicar la nota. properties: value: type: string description: Identificador del motivo. example: disliked label: type: string description: Texto que vio el cliente. example: No me gustó. resumeLabel: type: string description: Texto corto del motivo, el mismo que muestra el panel. example: No gustó el pedido apiCustomReview: type: object description: >- Respuesta a una pregunta personalizada de valoración configurada por la marca. properties: reviewQuestionId: type: string description: ID de la pregunta. question: type: string description: Texto de la pregunta. rating: type: number enum: - 1 - 2 - 3 - 4 - 5 description: Nota de 1 a 5. reason: type: string description: Motivo elegido, si la pregunta tiene motivos. comment: type: string description: Comentario del cliente. ```` This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.