PATCH/api/mod/facturacion/{espacio}/payment-config

Cambia la configuración de cobro

Cambia solo los campos que mandes. Cada uno se reemplaza entero: cuentas es la lista completa y despacho, el objeto completo.

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.

CAMPO	TIPO	REQUERIDO	QUÉ ES
name · moneda	string	no	Un nombre y la moneda.
cuentas	[{ metodo, etiqueta, numero, titular, activo }]	no	Todas tus cuentas. `metodo` y `etiqueta` son obligatorios; `numero` es contra el que se comprueba el comprobante; `activo`, por defecto true.
pasarela	{ proveedor, public_key, secreto_webhook }	no	`proveedor`: wompi, bold o nequi_conecta. `secreto_webhook` se guarda y nunca se devuelve; si mandas `pasarela` sin él, el guardado se borra.
auto_aprobar_hasta	string	no	Total máximo para aprobar solo. Para que tenga efecto manda también `requiere_confirmacion_humana_siempre: false`.
ventana_comprobante_horas	integer	no	Margen de la fecha del comprobante, en horas.
zona_horaria	string	no	Un nombre IANA: America/Bogota, America/Mexico_City…
ttl_reserva_min	integer	no	Minutos para pagar. Vale para las órdenes nuevas.
reservar_stock	boolean	no	Apartar el stock en Productos al crear la orden.
emitir_factura_contable	boolean	no	Enviar la factura a Contabilidad al pagarse.
despacho	{ activo, bloquea_fulfillment, campos }	no	Ver despacho. Sin `campos`, vuelven los de fábrica.

La configuración completa, ya cambiada.

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.

STATUS	CUÁNDO	DETAIL LITERAL
403	El espacio no tiene el módulo Facturación	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 campo de despacho con nombre inválido o repetido, o un proveedor que no existe	—
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.

Para añadir una cuenta, lee la configuración, añade la tuya a cuentas y manda la lista entera.
Activa la aprobación automática solo si confías en tus cuentas: un comprobante falso y uno real pueden verse iguales.