Payment types supported by SIMAP Digital collections

Documentation Index

Fetch the complete documentation index at: https://mintlify.com/AdriP-maker/JAAR_Antigravity/llms.txt

Use this file to discover all available pages before exploring further.

​

Overview

​

Default configuration

export const DEFAULT_CONFIG = {
  cuotaMensual:     3.00,   // Monthly quota in Balboas
  permitirParciales: true,  // Allow partial payments
  mesesGraciaCorte:  3,     // Months before cutoff (corte) state
};

​

Payment types reference

​

Type-by-type details

​

1. mensual — Standard monthly quota

• Amount: cfg.cuotaMensual (default B/.3.00). No manual entry required.
• Months covered: The mesTarget passed in, or the current month if omitted.
• Points: otorgarPuntos(userId, 5, 'Pago puntual (Mes al día)') — 5 points awarded automatically.
• Resulting state: saldo.estado = 'pagado', saldo.saldo = 0.

​

2. diario — Daily rate payment

• Daily rate: cuotaMensual ÷ 30 = B/.0.10/day at the default tariff.
• Amount: monto passed in from the CobroModal (e.g. 15 days × B/.0.10 = B/.1.50).
• Months covered: Only the current month’s running total.
• Points: None until the month reaches pagado status.
• Resulting state: parcial until accumulated daily payments reach cuotaMensual.

​

3. parcial — Partial payment

• Amount: Entered freely by the cobrador in the modal (min B/.0.10, max B/.3.00 at default tariff).
• Months covered: Current or specified month only.
• Points: None until the month is fully paid.
• Resulting state: parcial (saldo.saldo = cuotaTotal - accumulated). Once the running total reaches cuotaTotal, the state flips to pagado.

​

4. multi_mes — Multiple months at once

• Amount: cuotaMensual × N (e.g. 4 months = B/.12.00).
• Months covered: N months starting from the current month (or an explicit mesesTarget array).
• Points: N × 10 bonus points — rewarding consolidated payment (e.g. 4 months = 40 pts).
• Resulting state: Each month in the range becomes pagado individually in the saldos ledger.

for (const mes of meses) {
  const recibo = await crearRecibo(userId, cfg.cuotaMensual, 'multi_mes', mes, meses, nota);
  await actualizarSaldo(userId, mes, cfg.cuotaMensual, recibo.idPago);
}
await otorgarPuntos(userId, numMeses * 10, `Pago de múltiples meses (${numMeses})`);

​

5. adelanto — Advance payment for future months

• Amount: cuotaMensual × N future months.
• Months covered: Starts from currentMonth + 1 (cursor advances one month before generating the target list).
• Points: Same as multi_mes — N × 10 bonus points.
• Resulting state: Future-month saldo records created and immediately set to pagado.

// The cursor starts at next month
const cursor = new Date(ahora);
cursor.setMonth(cursor.getMonth() + 1);
const meses = generateMonths(cursor, numMeses);

​

6. puesta_al_dia — Pay all outstanding debt

• Amount: Auto-calculated — the sum of all saldo.saldo values across every pending month. Shown in the modal as “Deuda total: B/.X.XX”.
• Months covered: All months from the earliest unpaid back to the current month.
• Points: No extra bonus (the resident is clearing debt, not paying ahead). Base points apply when each month moves to pagado.
• Resulting state: All previously pendiente or parcial months become pagado. The resident’s overall state transitions from moroso/corte to activo.

​

Saldo composite key pattern

• Each resident has at most one saldo record per month.
• Looking up a specific resident-month pair is an O(1) IndexedDB get: db.saldos.get([userId, mes]).
• Partial payments on the same month accumulate into the same record rather than creating duplicate rows.

​

Estado transition lifecycle

pendiente  ──(any payment < cuotaTotal)──►  parcial
parcial    ──(payment completes balance)──► pagado
pendiente  ──(full payment in one shot)───► pagado

activo   ← current month pagado + no prior debt
parcial  ← current month saldo.estado === 'parcial'
moroso   ← 1–2 consecutive months unpaid
corte    ← mesesDeuda >= mesesGraciaCorte (default 3)

​

Code example: calling registrarPago()

import { registrarPago } from './services/pagosService';

// 1. Standard monthly payment for the current month
const receipts = await registrarPago(userId, {
  tipo: 'mensual',
  nota: 'Cobro en puerta — efectivo',
});
// → creates 1 receipt, updates saldo to 'pagado', awards 5 pts

// 2. Multi-month payment covering 3 months (B/.9.00)
const receipts = await registrarPago(userId, {
  tipo: 'multi_mes',
  monto: 9.00,          // system derives numMeses = 9.00 / 3.00 = 3
  nota: 'Pago trimestral',
});
// → creates 3 receipts (one per month), awards 30 pts (3 × 10)

// 3. Clear all outstanding debt automatically
const receipts = await registrarPago(userId, {
  tipo: 'puesta_al_dia',
  nota: 'Puesta al día — visita de campo',
});
// → creates N receipts for every pending/partial month