POST
/api/mod/comercial/{espacio}/tarifas/{carga}/activateActiva una tabla de tarifas
Pone en uso un borrador. Recibe la siguiente tarifa_version y la tabla que estaba activa pasa a retirada. Desde ese momento, todas las cotizaciones usan esta.
- 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 Comercial. |
| carga | string | SÍ | El id de la carga de tarifas: el import_id que devolvió subirla (32 caracteres hexadecimales). |
| validada_por | string, query | no | Quién la revisó. Queda en la carga. |
RESPUESTA 200
La carga, ya activa.
| CAMPO | TIPO | QUÉ ES |
|---|---|---|
| id · estado | string | La carga y su estado: draft, activa o retirada. |
| tarifa_version | integer | null | Su versión, que sube de uno en uno al activar. null mientras es borrador. Es la que sale en cada cotización. |
| doc_source | string | El nombre del archivo que subiste. |
| sha256 | string | La huella del archivo. |
| ciudad_origen | string | null | La ciudad desde la que se envía, si el archivo la trae. |
| n_ciudades · n_precios | integer | Cuántos destinos y cuántos rangos de peso se leyeron. |
| validada_por | string | null | Quién la activó, si lo dijiste. |
| created_at · activated_at | number | null | Segundos desde 1970. activated_at es null mientras es borrador. |
ERRORES DE ESTA RUTA · SIEMPRE {"detail": …}
| STATUS | CUÁNDO | DETAIL LITERAL |
|---|---|---|
| 403 | El espacio no tiene el módulo Comercial | 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 carga con ese id en el espacio | import no encontrado. |
| 409 | La carga no es un borrador (ya está activa o retirada) | solo se activa un import en draft (estado: <estado>) |
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
- Una tabla retirada no se puede volver a activar: si quieres volver a ella, súbela otra vez y activa el borrador nuevo.
- Las órdenes ya creadas en Facturación no cambian: guardan el envío y la
tarifa_versioncon los que se cotizaron.