GET
/api/mod/facturacion/{espacio}/payment-configLa configuración de cobro
Las cuentas donde te pagan, cuánto dura una orden, cuándo se aprueba solo un comprobante, qué datos de despacho se piden y si se aparta stock en Productos o se factura en Contabilidad.
- 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 Facturación. |
RESPUESTA 200
| CAMPO | TIPO | QUÉ ES |
|---|---|---|
| name · moneda | string | Un nombre y la moneda (COP). |
| cuentas[] | { metodo, etiqueta, numero, titular, activo } | Dónde te pagan: metodo (nequi, daviplata, bancolombia, efectivo…), etiqueta para el cliente, numero de cuenta o celular y titular. Las activas salen en cada orden. |
| pasarela | { proveedor, public_key } | null | Tu pasarela de pago, si tienes: wompi, bold o nequi_conecta. |
| auto_aprobar_hasta | string | Hasta qué total se aprueba solo un comprobante que pasa las cinco comprobaciones, y solo si requiere_confirmacion_humana_siempre (boolean) es false. De fábrica: "0" y true, es decir, nunca. |
| ventana_comprobante_horas | integer | Margen, en horas, para la fecha del comprobante alrededor de la orden. Por defecto 24. |
| zona_horaria | string | Con qué hora local se lee el comprobante. Por defecto America/Bogota. |
| ttl_reserva_min | integer | Minutos para pagar una orden y tiempo que se aparta su stock. Por defecto 45. |
| reservar_stock | boolean | Apartar el stock en Productos al crear la orden. Por defecto true. |
| emitir_factura_contable | boolean | Enviar la factura a Contabilidad cuando una orden se paga. Por defecto false. |
| despacho | { activo, bloquea_fulfillment, campos } | Qué datos de despacho se piden: ver despacho. |
DESPACHO
| CAMPO | TIPO | QUÉ ES |
|---|---|---|
| activo | boolean | Pedir datos de despacho. Por defecto false: no se pide ni se guarda nada. |
| bloquea_fulfillment | boolean | Sin los requeridos, no deja marcar la orden despachada. Por defecto true. |
| campos[] | { campo, etiqueta, requerido, activo } | campo: minúsculas, números y _, empieza por letra, hasta 40; sin repetir. De fábrica: nombre, cedula, telefono, direccion, barrio y ciudad, todos activos y requeridos. |
ERRORES DE ESTA RUTA · SIEMPRE {"detail": …}
| STATUS | CUÁNDO | DETAIL LITERAL |
|---|---|---|
| 403 | El espacio no tiene el módulo Facturación | 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. El secreto de la pasarela nunca sale en la respuesta.