Saltar al contenido
API v1 · https://bentho.org/api
POST/api/mod/ventas/{espacio}/pricing/versions/{tabla}/activate

Valida y activa una versión

La versión pasa a validada y desde ese momento es la que cotiza. La que estaba activa pasa a retirada en el mismo paso.

  • 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 Ventas.
tablastringSÍEl id de la versión de la tabla de tarifas: el version_id que devolvió subirla (32 caracteres hexadecimales).
request_userstring, querynoQuién la valida. Queda en validada_por.

RESPUESTA 200

La versión, ya validada.

CAMPOTIPOQUÉ ES
idstringEl id de la versión.
estado"draft" | "validada" | "retirada"draft: borrador, no cotiza. validada: la activa, la única con la que se cotiza. retirada: ya no se usa.
origen · doc_sourcestringDe qué tipo de archivo salió (pdf, csv, xlsx) y su nombre.
sha256stringLa huella del archivo. Cada cotización la cita en tarifa_version.
validada_porstring | nullQuién la activó, si lo dijiste al activarla.
created_at · activated_atnumber · number | nullCuándo se subió y cuándo se activó, en segundos desde 1970.

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

STATUSCUÁNDODETAIL LITERAL
403El espacio no tiene el módulo Ventasmódulo no habilitado para este espacio.
403La clave es de solo lecturaTu cuenta es de solo lectura en este espacio.
409Quedan filas con tarifa 0 o sin días… tarifa(s) incompletas (coste/días en 0); corrígelas antes de validar
409La versión no tiene filasla versión no tiene tarifas; no puede activarse
409La versión está retiradano se puede activar una versión retirada
409No hay una versión con ese idversión no encontrada

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

  • Siempre hay como mucho una versión validada. Para volver a una anterior, súbela de nuevo: una retirada no se reactiva.