POST
/api/mod/productos/{espacio}/campaignsCrea una campaña
Un presupuesto de descuentos compartido por varias promociones. Cuando lo descontado en ventas confirmadas llega al presupuesto, sus promociones dejan de aplicar.
- PERMISOescribe
- 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. |
CUERPO · JSON
| CAMPO | TIPO | REQUERIDO | QUÉ ES |
|---|---|---|---|
| nombre | string | SÍ | Para reconocerla. |
| presupuesto | number | string | no | Lo máximo a descontar, en la moneda de tus precios. Por defecto 0. |
RESPUESTA 201
| CAMPO | TIPO | QUÉ ES |
|---|---|---|
| id · nombre | string | Pon el id en campaign_id de cada promoción. |
| presupuesto | string | El que diste. |
| gastado | string | Lo descontado hasta ahora: 0 al crearla. |
| 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. |
| 403 | La clave es de solo lectura | Tu cuenta es de solo lectura en este espacio. |
| 422 | Falta un campo obligatorio o uno no es de su tipo (detail es una lista) | — |
Y los de cualquier ruta —clave inválida, cuenta no al día, IP, límites—, en Errores, límites y créditos.
CONVIENE SABER
- Con presupuesto 0, sus promociones no aplican nunca.
gastadosube solo con las ventas que declaran el descuento en promociones_aplicadas. Las cotizaciones no gastan.- Las campañas no se leen ni se editan por la API: guarda el id que devuelve.