Saltar al contenido
API v1 · https://bentho.org/api
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

CAMPOTIPOREQUERIDOQUÉ ES
espaciostringSÍEl id del espacio (sale en GET /api/companies). Tiene que tener el módulo Productos.
variantestringSÍEl id de la variante: sale en variantes[] del producto (32 caracteres hexadecimales).

CUERPO · JSON

CAMPOTIPOREQUERIDOQUÉ ES
skustringSÍObligatorio, pero no se cambia: manda el que tiene.
activobooleannoSi no lo mandas, vuelve a true.
option_valuesobjectnoSi no lo mandas, queda vacío.
barcode · external_idstringnoSi no los mandas, no cambian.

RESPUESTA 200

La variante, ya cambiada.

CAMPOTIPOQUÉ ES
id · product_idstringLa variante y su producto.
skustringSu SKU: único en el espacio.
option_valuesobjectEl valor de cada opción, p. ej. {"Molienda": "En grano"}. Vacío si no tiene.
barcode · external_idstring | nullLos que diste.
activobooleanSi se vende. Una inactiva no sale en la búsqueda.
created_atnumberSegundos desde 1970, con decimales.

ERRORES DE ESTA RUTA · SIEMPRE {"detail": …}

STATUSCUÁNDODETAIL LITERAL
403El espacio no tiene el módulo Productosmódulo no habilitado para este espacio.
403La clave es de solo lecturaTu cuenta es de solo lectura en este espacio.
404No hay una variante con ese id en el espaciovariante no encontrada.
422Falta 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 activo y option_values con su valor actual: lo que no mandes vuelve a su valor por defecto. Para cambiar el SKU, crea otra variante y borra esta.