Saltar al contenido
API v1 · https://bentho.ai/api
POST/api/mod/productos/{espacio}/prices

Fija 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

CAMPOTIPOREQUERIDOQUÉ ES
espaciostringSÍEl id del espacio (sale en GET /api/companies). Tiene que tener el módulo Productos.

CUERPO · JSON

CAMPOTIPOREQUERIDOQUÉ ES
price_list_idstringSÍLa lista.
variant_idstringSÍLa variante.
montonumber | stringSÍEl precio unitario, en decimal.
monedastringnoEl código de moneda. Por defecto "COP".
min_qtynumber | stringnoDesde cuántas unidades vale: 12 para un precio por docena. Por defecto 1.

RESPUESTA 201

El precio creado.

CAMPOTIPOQUÉ ES
id · price_list_id · variant_idstringEl precio, su lista y su variante.
monedastringEl código de moneda, p. ej. "COP".
montostringEl precio unitario, en texto decimal.
min_qtystringDesde cuántas unidades vale (escalón por cantidad).
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.
404price_list_id no es una lista del espaciola lista de precios indicada no existe.
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

  • Fijar un precio con la misma lista, variante, moneda y min_qty que uno que ya existe lo reemplaza: el anterior deja de existir y la respuesta trae el id nuevo. Así se cambia un precio, sin borrarlo antes.
  • moneda y min_qty se comparan tal como los mandas: "COP" y "cop", o 12 y "12.00", son precios distintos y conviven.
  • 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.