Cuotas
Administra cuotas de pago de facturas.
Cuotas de pago para facturas. Archivo opcional - solo necesario si maneja pagos en cuotas.
Dependencia: Requiere cargar Facturas primero.
⚠️ Importante: Al cargar cuotas para una factura, incluya TODAS las cuotas (1..n) de esa factura en el mismo archivo. Un archivo parcial se acepta, pero deja resultados incorrectos: las secuencias que no vienen siguen existiendo y también entran en el reparto, usando su monto anterior como peso.
Endpoint
POST /full-csv-integration/upload-installments
- Campo de Formulario:
installmentsFile
Campos Requeridos
| Campo | Tipo | Descripción | Validaciones |
|---|---|---|---|
erp_invoice_id | String | ID de la factura en ERP | No puede estar vacío. Debe existir en Facturas — ver más abajo |
sequence | Integer | Número de secuencia de la cuota | Entero mayor o igual a 1 y contiguo (1, 2, 3…). Con huecos la carga se rechaza |
due_date | Date | Fecha de vencimiento de la cuota | Formato YYYY-MM-DD; otros formatos se rechazan. Debe traer valor: una fecha vacía hace fallar el procesamiento del archivo completo |
amount | Float | Monto de la cuota | Número decimal mayor a 0 |
Campos Opcionales
| Campo | Tipo | Descripción | Por Defecto |
|---|---|---|---|
status | String | Estado de la cuota. Acepta pending, paid o partial, sin distinguir mayúsculas/minúsculas. Un valor no reconocido no genera error: se guarda como pending al crear y conserva el estado actual al actualizar. El valor por defecto solo aplica al crear | pending |
Cómo se usa el monto
amount funciona como peso, no como monto final: después de la carga, Fibek reparte el saldo de
la factura (saldo pendiente más pagos aplicados) entre las cuotas en proporción a los montos
enviados. Si la suma de las cuotas no coincide con el saldo de la factura, los montos guardados no
serán los del archivo.
Secuencias
- Las secuencias de cada factura deben ir de 1 a n sin saltos. Si hay huecos, la carga se rechaza con un error que indica la factura y las secuencias encontradas.
- Una carga no borra las cuotas que ya no vienen en el archivo: si la factura tenía 1, 2 y 3 y ahora envía solo 1 y 2, la cuota 3 sigue existiendo. Para eliminarla hay que hacerlo desde la plataforma.
⚠️ Filas con una factura que no existe: se descartan al procesar el archivo y eso no se refleja en la respuesta, que ya confirmó la carga. Si ninguna factura del archivo existe, no se procesa nada. Cargue Facturas primero.
Ejemplo CSV
erp_invoice_id,sequence,due_date,amount,status
INV001,1,2024-02-15,500000.00,paid
INV001,2,2024-03-15,500000.00,pending
INV002,1,2024-02-20,500000.00,pending