| Time | Status | User Agent | |
|---|---|---|---|
Retrieving recent requests… | |||
Cambia solo el alcance indicado: un cambio en una sucursal conserva el general y las demas sucursales. Cada item necesita la version leida con catalogo_horarios (si cambio entretanto, ese item queda en conflicto y no se toca). Respuesta por item: aplicado (releido y verificado), sin_cambios, conflicto, no_existe, incierto o error; estado general aplicado, parcial o fallido. Ante incierto o timeout, lea con catalogo_horarios antes de repetir. Queda en el historial con el actor y los valores anteriores y nuevos.
| Scope requerido | catalogo:write |
| Método | PATCH /ext/v3/catalogo/horarios |
| Idempotencia | header Idempotency-Key obligatorio |
Body
| Parámetro | Tipo | Requerido | Descripción |
|---|---|---|---|
items | array | sí | |
alcance | object | sí | |
horario | object | sí |
Ejemplo
curl -X PATCH 'https://api3.clau.io/ext/v3/catalogo/horarios' \
-H 'apikey: ck_1_...' \
-H 'Idempotency-Key: 6f1e2d3c-0001' \
-H 'Content-Type: application/json' \
-d '{"items":[{"catItemId":412,"version":"9f2c..."}],"alcance":{"sucursales":["SUC-CENTRO"]},"horario":{"modo":"restringido","dias":{"lunes":[{"desde":"07:00","hasta":"11:30"}],"martes":[{"desde":"07:00","hasta":"11:30"}],"sabado":[{"desde":"08:00","hasta":"12:00"}]}}}'Respuesta 200
{
"codigoRespuesta": 0,
"msj": "Exito",
"data": "…",
"meta": {
"requestId": "5f1c…",
"appId": 1,
"scope": "catalogo:write"
}
}Errores: 401 key inválida (9501), 403 sin scope (9503, meta.requiredScope), 400 parámetros (details), 409 idempotencia, 422 regla de negocio (meta.legacy), 429 límite de tasa. Agregue ?help=true para la ayuda en texto plano.
