GET
/api/mod/productos/{espacio}/promotions/{promocion}Una promoción
La promoción con su predicado y su método.
- PERMISOlee (vale cualquier clave)
- CRÉDITOSno gasta
- AUTENTICACIÓNBearer bth_…
PARÁMETROS
| CAMPO | TIPO | REQUERIDO | QUÉ ES |
|---|---|---|---|
| espacio | string | SÍ | El id del espacio (sale en GET /api/companies). Tiene que tener el módulo Productos. |
| promocion | string | SÍ | El id de la promoción: el que devolvió crearla (32 caracteres hexadecimales). |
RESPUESTA 200
| CAMPO | TIPO | QUÉ ES |
|---|---|---|
| id · nombre | string | El id y el nombre. |
| codigo | string | null | Su código, como etiqueta. |
| estado | string | activo o inactivo. Solo activo descuenta. |
| grupo_exclusividad | string | null | Una sola promoción por grupo en cada cotización. |
| prioridad | integer | Mayor gana dentro de su grupo. |
| limite_usos | integer | null | Cuántas ventas pueden usarla. null: sin límite. |
| starts_at · ends_at | string | null | Su vigencia, en ISO 8601. |
| predicado · metodo | object | Cuándo aplica y cuánto descuenta: ver metodo y predicado. |
| campaign_id | string | null | Su campaña, si tiene. |
| created_at | number | Segundos desde 1970, con decimales. |
ERRORES DE ESTA RUTA · SIEMPRE {"detail": …}
| STATUS | CUÁNDO | DETAIL LITERAL |
|---|---|---|
| 403 | El espacio no tiene el módulo Productos | módulo no habilitado para este espacio. |
| 404 | No hay una promoción con ese id en el espacio | promoción no encontrada. |
Y los de cualquier ruta —clave inválida, cuenta no al día, IP, límites—, en Errores, límites y créditos.