Consultar plantillas de necesidades por producto

Este endpoint devuelve las plantillas de necesidades que se han aplicado en un producto o sección en un periodo no superior a 30 días.

GET /api/v1/businesses/{business_id}/products/{product_id}/needs-templates?fromDate={yyyy-MM-dd}&toDate={yyyy-MM-dd}

En la URL de la petición, deben especificarse los siguientes parámetros:

  • Identificador de negocio (business_id).

  • Identificador del producto o sección (service_id).

  • Intervalo para el que se realiza la consulta (fromDate/toDate) en formato yyyy-MM-dd.

Si los datos incluidos en la URL son correctos, la respuesta contendrá las plantillas de necesidades aplicadas en el producto o sección cada uno de los días especificados en el intervalo de la petición.

A continuación, se expone un ejemplo:

GET /api/v1/businesses/BUSINESSID/products/0001-G/needs-templates?fromDate=2024-05-31&toDate=2024-06-01
[
    {
        "productId": "0001-G",
        "date": "2024/05/31",
        "id": "17536",
        "templateName": "General"
    },
    {
        "productId": "0001-G",
        "date": "2024/06/01",
        "id": "17537",
        "templateName": "Summer"
    }
]

Como se puede ver en el ejemplo, la petición devuelve las plantillas de necesidades aplicadas a cada producto o sección en los días especificados en la petición.

Aspectos que tener en cuenta

Si el producto indicado en la URL no existe en el negocio, la petición devolverá un error 404 Not Found, especificando en el mensaje not exits.

Si el intervalo de tiempo indicado en la URL es superior a 30 días, la petición devolverá un error 400 Bad Request, especificando en el mensaje Invalid days period.

Si no hay plantillas de necesidades aplicadas para el periodo de tiempo indicado, la petición devolverá un error 404 Not Found, especificando en el mensaje There is not needs template on the requested information.

Enlaces de interés

¿Qué son las necesidades?

¿Qué son las plantillas de necesidades?

¿Cómo es la estructura de una plantilla de necesidades?