| Time | Status | User Agent | |
|---|---|---|---|
Retrieving recent requests… | |||
Aplica los cambios en orden sobre la version leida; lo que no se menciona (otras reglas, condiciones, acciones, posiciones, vencimiento, push) no cambia. Si la promocion cambio desde la lectura responde 409 y no escribe. Despues de escribir vuelve a leer y devuelve el estado guardado explicado y la version nueva (verificado). Si la escritura falla o no se sabe si aplico, lo comprueba releyendo antes de responder; un reintento de algo ya guardado responde sin_cambios. Queda en el historial del dashboard con el actor y los valores anteriores y nuevos.
| Scope requerido | promociones:write |
| Método | PATCH /ext/v3/beneficios/{beneficioId}/reglas |
| Idempotencia | header Idempotency-Key obligatorio |
Path
| Parámetro | Tipo | Requerido | Descripción |
|---|---|---|---|
beneficioId | integer | sí | Id del beneficio (mp_beneficios.ben_id, bId en beneficios_listar) |
Body
| Parámetro | Tipo | Requerido | Descripción |
|---|---|---|---|
version | string | sí | version devuelta por la lectura de las reglas |
cambios | array | sí | Cambios en orden; se aplican todos o ninguno |
Ejemplo
curl -X PATCH 'https://api3.clau.io/ext/v3/beneficios/22/reglas' \
-H 'apikey: ck_1_...' \
-H 'Idempotency-Key: 6f1e2d3c-0001' \
-H 'Content-Type: application/json' \
-d '{"version":"4c1d...","cambios":[{"op":"reemplazar_condicion","regla":"1","indice":0,"esperado":221,"condicion":{"tipo":221,"operador":"=","valor":["MF20","MF21"]}},{"op":"agregar_condicion","regla":"1","condicion":{"tipo":201,"operador":"=","valor":"SUC-CENTRO"}},{"op":"agregar_condicion","regla":"1","condicion":{"tipo":310,"valor":{"dias":["lunes","martes"],"desde":"07:00","hasta":"11:00"}}}]}'Respuesta 200
{
"codigoRespuesta": 0,
"msj": "Exito",
"data": "…",
"meta": {
"requestId": "5f1c…",
"appId": 1,
"scope": "promociones: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.