PATCH
/api/mod/comercial/{espacio}/configCambia la configuración comercial
Cambia solo los campos que mandes. Cada uno se reemplaza entero: beneficios es la lista completa, peso_sku la tabla completa y reglas_pago el objeto completo.
- 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. |
CUERPO · JSON
| CAMPO | TIPO | REQUERIDO | QUÉ ES |
|---|---|---|---|
| name · moneda | string | no | Un nombre y la moneda de las cotizaciones. |
| reglas_pago | object | no | Ver reglas_pago. Lo que no mandes dentro vuelve a su valor de fábrica. |
| peso_default_pedido_kg | string | no | Peso de un pedido sin más datos, en kilos. |
| peso_sku | { sku: gramos } | no | Gramos enteros por SKU. La tabla entera. |
| beneficios | array | no | Todos los beneficios: ver beneficios. |
RESPUESTA 200
La configuración completa, ya cambiada.
| 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. |
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. |
| 422 | Un efecto_tipo que no existe, un peso que no es entero o un beneficio sin codigo | — |
| 422 | Falta un campo obligatorio o uno no es de su tipo (detail es una lista) | — |
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
- Para cambiar un solo valor de
reglas_pago, lee la configuración y manda el objeto entero con tu cambio: lo que falte vuelve al valor de fábrica. - Para pausar un beneficio sin perderlo, mándalo con
activo: false.