POST
/api/mod/ventas/{espacio}/inventory/itemsCrea o fija un artículo
Da de alta un artículo o, si su SKU ya existe, lo reescribe y fija su cantidad. Para sumar o restar, usa ajustar.
- 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 Ventas. |
CUERPO · JSON
| CAMPO | TIPO | REQUERIDO | QUÉ ES |
|---|---|---|---|
| nombre | string | SÍ | El nombre del artículo. |
| sku | string | no | Tu SKU. Sin él, el nombre en minúsculas con guiones. |
| cantidad | string | no | La cantidad, texto decimal. Por defecto "0". |
| umbral_bajo | string | no | Desde esta cantidad hacia abajo, stock bajo. Texto decimal. |
| unidad | string | no | unidad, kg, caja… |
| bodega | string | no | Dónde está. |
| aliases | string[] | no | Otros nombres con los que el cliente lo pide. Sin ellos, el nombre. |
RESPUESTA 201
El artículo guardado.
| CAMPO | TIPO | QUÉ ES |
|---|---|---|
| sku · nombre | string | El SKU y el nombre. |
| cantidad | string | Lo que hay, como texto decimal ("12", "2.5"). Nunca baja de 0. |
| umbral_bajo | string | null | Desde esta cantidad hacia abajo cuenta como stock bajo. null: sin umbral. |
| unidad · bodega | string | null | La unidad (unidad, kg, caja…) y dónde está. |
| aliases_json | string | Otros nombres con los que se reconoce, como una lista JSON en texto: "[\"Café Huila\"]". |
| activo | 0 | 1 | 1 si se ofrece. |
| fuente | string | null | De dónde vino su última carga: csv, xlsx, pdf o manual. |
| external_id | string | null | Su id en tu sistema contable, si viene de una sincronización. |
| created_at · updated_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 Ventas | 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
- Las cantidades y los importes van como texto decimal (
"12","2.5"), no como número: un número da 422. - Al reescribir un artículo,
unidad,bodegayumbral_bajoque no mandes conservan su valor.