Obtener plantillas de necesidades por servicio

Este endpoint devuelve las plantillas de necesidades que se han aplicado en un servicio en un periodo no superior a 31 días.

GET /api/v1/businesses/{businessId}/services/{serviceId}/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 servicio 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

404 Not Found

Needs Template on requested dates

El servicio 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, o el servicio no tiene ninguna definida.

Enlaces de interés

¿Qué son las necesidades?

¿Qué son las plantillas de necesidades?