POST
/api/mod/ventas/{espacio}/pricing/drafts/{tabla}/surchargesAñade un recargo
Un cargo que se suma al envío: un seguro, el recaudo contra entrega, un recargo por zona. Fijo o en porcentaje del envío, y solo cuando se cumple su condición.
- 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). |
CUERPO · JSON
| CAMPO | TIPO | REQUERIDO | QUÉ ES |
|---|---|---|---|
| concepto | string | SÍ | Cómo se llama en la cotización: «Seguro de envío». |
| tipo | "fijo" | "porcentual" | SÍ | fijo: un importe. porcentual: un porcentaje de la tarifa de envío. |
| valor | string | SÍ | El importe o el porcentaje, como texto decimal ("2500", "5"). |
| condicion | { zona_id, producto_id, min_total } | no | Cuándo aplica. zona_id y producto_id son listas de ids; min_total, la tarifa de envío mínima. Sin condición, aplica siempre. |
| base_normativa | string | no | De dónde sale (una norma, tu política). Viaja con el recargo en la cotización. |
RESPUESTA 201
| CAMPO | TIPO | QUÉ ES |
|---|---|---|
| id | string | El id del 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. |
| 403 | La clave es de solo lectura | Tu cuenta es de solo lectura en este espacio. |
| 400 | tipo no es fijo ni porcentual | tipo de recargo inválido: … |
| 422 | Falta un campo obligatorio o uno no es de su tipo (detail es una lista) | — |
| 500 | La versión no existe (hoy no responde 404) | Error interno del servidor. |
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
- No comprueba que la versión sea un borrador: un recargo añadido a la versión activa cuenta desde la siguiente cotización.
- Un recargo porcentual se calcula sobre la tarifa de envío, no sobre el pedido.