Obtener 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 31 días.

GET /api/v1/businesses/{businessId}/products/{productId}/needs-templates?fromDate={yyyy-MM-dd}&toDate={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.

Ejemplo de respuesta

[
    {
        "productId": "0001-GENERAL",
        "date": "2026/08/31",
        "id": "17537",
        "templateName": "Summer"
    },
    {
        "productId": "0001-GENERAL",
        "date": "2026/09/01",
        "id": "17536",
        "templateName": "General"
    }
]
Detalles

  • productId: identificador externo del producto o sección.

  • date: fecha para la que se aplica la plantilla de necesidades en formato yyyy/MM/dd.

  • id: identificador interno de la plantilla en Orquest.

  • templateName: nombre configurado en el sistema para la plantilla.

Como se puede ver en el ejemplo, la petición devuelve la información de la plantilla de necesidades aplicada en cada día del intervalo de consulta.

Códigos de error

Además de los errores comunes, este endpoint puede devolver los siguientes códigos:

Código Mensaje Descripción

400 Bad Request

Invalid days period

El intervalo indicado entre fromDate y toDate es superior a 31 días, o toDate es anterior a fromDate. Se recomienda ajustar el rango de fechas de la consulta.

404 Not Found

Needs Template on requested dates

El servicio del producto no tiene horarios (ServiceTimes) configurados para el intervalo indicado.

There is not needs template on the requested information

No hay ninguna plantilla de necesidades aplicada para el intervalo indicado.

Enlaces de interés

¿Qué son las necesidades?

¿Qué son las plantillas de necesidades?