GET
/api/mod/ventas/{espacio}/pricing/drafts/{tabla}Una versión, fila por fila
La versión con todas sus filas de tarifa y sus recargos. Es lo que revisas antes de activarla. Sirve para cualquier versión, no solo borradores.
- PERMISOlee (vale cualquier clave)
- 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). |
RESPUESTA 200
| CAMPO | TIPO | QUÉ ES |
|---|---|---|
| version | object | La versión: id, estado, origen, sha256… como en la lista. |
| rates[].id | string | El id de la fila: para corregirla. |
| rates[].zone_id · product_id | string · string | null | La zona y el producto, como nombre en minúsculas con guiones. product_id null: vale para cualquier producto. |
| rates[].qty_min · qty_max | integer · integer | null | El rango de cantidades que cubre. qty_max null: sin tope. |
| rates[].coste | string | La tarifa de envío, como texto decimal. 0: falta revisarla. |
| rates[].dias_min · dias_max | integer | Los días de entrega. 0 y 0: falta revisarlos. |
| rates[].vigente_desde | string | null | Desde cuándo vale, YYYY-MM-DD. |
| rates[].vigente_hasta | string | null | Hasta cuándo. Pasada la fecha, esa fila ya no cotiza (rate_expired). |
| surcharges[] | { id, concepto, tipo, valor, condicion, base_normativa } | Los recargos de la versión: ver añadir un recargo. |
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. |
| 404 | 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.