POST
/api/mod/ventas/{espacio}/pricing/versions/{tabla}/activateValida 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
| CAMPO | TIPO | REQUERIDO | QUÉ ES |
|---|---|---|---|
| espacio | string | SÍ | El id del espacio (sale en GET /api/companies). Tiene que tener el módulo Ventas. |
| tabla | string | SÍ | El id de la versión de la tabla de tarifas: el version_id que devolvió subirla (32 caracteres hexadecimales). |
| request_user | string, query | no | Quién la valida. Queda en validada_por. |
RESPUESTA 200
La versión, ya validada.
| CAMPO | TIPO | QUÉ ES |
|---|---|---|
| id | string | El 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_source | string | De qué tipo de archivo salió (pdf, csv, xlsx) y su nombre. |
| sha256 | string | La huella del archivo. Cada cotización la cita en tarifa_version. |
| validada_por | string | null | Quién la activó, si lo dijiste al activarla. |
| created_at · activated_at | number · number | null | Cuándo se subió y cuándo se activó, en segundos desde 1970. |
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. |
| 409 | Quedan filas con tarifa 0 o sin días | … tarifa(s) incompletas (coste/días en 0); corrígelas antes de validar |
| 409 | La versión no tiene filas | la versión no tiene tarifas; no puede activarse |
| 409 | La versión está retirada | no se puede activar una versión retirada |
| 409 | No hay una versión con ese id | versió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.