GET
/api/mod/comercial/{espacio}/configLa configuración comercial
Las reglas de pago con las que se calcula el envío, el peso de los pedidos y los beneficios del espacio.
- 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 Comercial. |
RESPUESTA 200
| CAMPO | TIPO | QUÉ ES |
|---|---|---|
| name · moneda | string | Un nombre y la moneda (COP). |
| reglas_pago | object | Cómo se calcula el envío según el método: ver reglas_pago. |
| peso_default_pedido_kg | string | El peso de un pedido cuando no hay otro dato, en kilos. De fábrica, 2. |
| peso_sku | { sku: gramos } | El peso de cada producto, en gramos enteros, por su SKU. |
| beneficios[] | array | Bienvenida, envío gratis, pago anticipado…: ver beneficios. |
REGLAS_PAGO
| CAMPO | TIPO | QUÉ ES |
|---|---|---|
| umbral_asegurado | string | Desde este subtotal, la contraentrega va asegurada: IVA y comisión de recaudo en vez de cargo fijo. De fábrica, 250 mil. |
| cargo_fijo_contra | string | El cargo fijo de contraentrega por debajo del umbral. De fábrica, 5900. |
| iva_pct | string | El IVA del envío asegurado, como fracción. De fábrica, 0.19. |
| comision_recaudo_pct | string | La comisión de recaudo sobre subtotal + envío + IVA, como fracción. De fábrica, 0.02. |
| seguro_declarado_* | boolean · string · string | Una regla de valor declarado (_activo, _base_cubierta, _exceso_pct). Se guarda, pero hoy la cotización no la aplica. |
BENEFICIOS[]
| CAMPO | TIPO | QUÉ ES |
|---|---|---|
| codigo · nombre | string | Un código estable y un nombre para reconocerlo. |
| efecto_tipo | "descuento_pct" | "descuento_fijo" | "envio_gratis" | Qué hace. |
| efecto_valor | string | En descuento_pct, la fracción del subtotal (0.1 = 10 %); en descuento_fijo, el monto, sin pasar del subtotal. envio_gratis no lo usa. |
| activo | boolean | Por defecto true. Apagado no aplica nunca. |
| solo_primera_compra | boolean | Solo para clientes nuevos. Por defecto false. |
| subtotal_min | string | null | Subtotal mínimo para aplicar. |
| metodos_pago | string[] | Para qué métodos aplica: contra, transferencia, mixto. Vacío (por defecto): todos. |
| prosa | string | La frase corta que se le dice al cliente, con la voz de tu marca. |
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. |
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
- La primera vez que se lee, se crea con los valores de fábrica y sin beneficios.
- Las cifras van como texto decimal. La tabla de tarifas no está aquí: ver tarifa activa.