PATCH
/api/mod/productos/{espacio}/variants/{variante}Edita una variante
Activa o desactiva una variante, o cambia sus valores de opción, su código de barras o su id externo.
- 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. |
| variante | string | SÍ | El id de la variante: sale en variantes[] del producto (32 caracteres hexadecimales). |
CUERPO · JSON
| CAMPO | TIPO | REQUERIDO | QUÉ ES |
|---|---|---|---|
| sku | string | SÍ | Obligatorio, pero no se cambia: manda el que tiene. |
| activo | boolean | no | Si no lo mandas, vuelve a true. |
| option_values | object | no | Si no lo mandas, queda vacío. |
| barcode · external_id | string | no | Si no los mandas, no cambian. |
RESPUESTA 200
La variante, ya cambiada.
| CAMPO | TIPO | QUÉ ES |
|---|---|---|
| id · product_id | string | La variante y su producto. |
| sku | string | Su SKU: único en el espacio. |
| option_values | object | El valor de cada opción, p. ej. {"Molienda": "En grano"}. Vacío si no tiene. |
| barcode · external_id | string | null | Los que diste. |
| activo | boolean | Si se vende. Una inactiva no sale en la búsqueda. |
| 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 | No hay una variante con ese id en el espacio | variante no encontrada. |
| 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
- Manda siempre
activoyoption_valuescon su valor actual: lo que no mandes vuelve a su valor por defecto. Para cambiar el SKU, crea otra variante y borra esta.