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, debe incluir TODAS las cuotas (1..n) para esa factura en el mismo archivo. No se admiten actualizaciones parciales.

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	Debe existir en Facturas
`sequence`	Integer	Número de secuencia de la cuota	Entero, comenzando en 1. Debe ser contiguo (1, 2, 3…) — ver la advertencia más abajo
`due_date`	Date	Fecha de vencimiento de la cuota	Se recomienda `YYYY-MM-DD`. Se aceptan otros formatos y las fechas que no se puedan interpretar se guardan vacías en lugar de generar error
`amount`	Float	Monto de la cuota	Número decimal

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`

⚠️ Las secuencias no contiguas se descartan en silencio: si los valores de sequence de una factura tienen huecos, se descartan TODAS las cuotas de esa factura y la carga se reporta igualmente como exitosa. Verifica que las cuotas de cada factura vayan de 1 a n sin saltos antes de cargarlas.

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