POST
/api/mod/productos/{espacio}/pricesFija un precio
Pone el precio de una variante en una lista, en una moneda y desde una cantidad.
- 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 |
|---|---|---|---|
| price_list_id | string | SÍ | La lista. |
| variant_id | string | SÍ | La variante. |
| monto | number | string | SÍ | El precio unitario, en decimal. |
| moneda | string | no | El código de moneda. Por defecto "COP". |
| min_qty | number | string | no | Desde cuántas unidades vale: 12 para un precio por docena. Por defecto 1. |
RESPUESTA 201
El precio creado.
| CAMPO | TIPO | QUÉ ES |
|---|---|---|
| id · price_list_id · variant_id | string | El precio, su lista y su variante. |
| moneda | string | El código de moneda, p. ej. "COP". |
| monto | string | El precio unitario, en texto decimal. |
| min_qty | string | Desde cuántas unidades vale (escalón por cantidad). |
| 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. |
| 404 | price_list_id no es una lista del espacio | la lista de precios indicada no existe. |
| 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
- Fijar un precio añade otro: no reemplaza el anterior. Si en la misma lista quedan dos con el mismo escalón, cotiza el más bajo. Para cambiar un precio, borra el viejo.
- No comprueba que la variante exista: usa un variant_id del catálogo.
- Las cantidades y los importes viajan como texto decimal (
"32000","1.5") para no perder precisión. Al mandarlos vale un número o un texto.