Ir al contenido

Conciliar una cuenta

POST/api/account-conciliation/conciliate

Es el flujo vigente. En una sola transacción crea el lote como cerrada, marca los movimientos como conciliados, calcula opening_balance, closing_balance y sequence, y actualiza la cuenta. Si has_monthly_close es verdadero, además valida el extracto y crea el cierre mensual (AccountClosureMonthly) en la misma transacción.

Diferencias con las demás acciones: Crear un lote es el flujo anterior sin período ni cierre de mes; Deshacer una conciliación y Revertir un lote la deshacen.

Reglas que valida el servicio: el mes no puede tener un cierre mensual activo; todos los movimientos deben pertenecer a la cuenta, no estar anulados ni conciliados; deben ser del período indicado; no pueden quedar movimientos sin conciliar de meses anteriores; y no se pueden saltar movimientos dentro del mes. Si cierra el mes, además solo se puede cerrar a partir del primer día del mes siguiente, deben respetarse el orden secuencial de cierres, no deben quedar movimientos del mes fuera del lote y statement_balance debe coincidir con el saldo de cierre calculado.

account_idintegerobligatorio

Cuenta a conciliar. Debe existir y estar activa.

period_yearintegerobligatorio

Año del período, entre 2000 y 2100.

period_monthintegerobligatorio

Mes del período, entre 1 y 12.

movement_idsarrayobligatorio

Identificadores de los movimientos. Al menos uno; cada uno debe existir, no estar anulado ni conciliado.

has_monthly_closebooleanobligatorio

Indica si el lote cierra el mes.

statement_datedatecondicional

Fecha del extracto. Obligatoria si has_monthly_close es verdadero.

statement_balancenumbercondicional

Saldo del extracto. Obligatorio si has_monthly_close es verdadero y debe coincidir con el saldo calculado.

statement_referencestring

Referencia del extracto. Máximo 255 caracteres.

statement_filestring

Extracto como data URL en base64 (data:application/pdf;base64,...). PDF, JPG o PNG de hasta 10 MB. Solo se guarda si el lote cierra el mes.

statement_file_urlstring

Ruta del extracto, máximo 500 caracteres. Se usa solo si no se envía statement_file.

notesstring

Notas del cierre mensual. Máximo 1000 caracteres.

cashbox.account.conciliation.create, que se valida con Gate::authorize('create', AccountConciliation::class). Si has_monthly_close es verdadero, también se exige cashbox.account.closure.create («Cerrar mes»); sin él responde 403 con el mensaje Para cerrar el mes necesitas el permiso «Cerrar mes».

Ventana de terminal
curl -X POST \
"https://servererp.allendostmen.app/api/account-conciliation/conciliate" \
-H "Authorization: Bearer $TOKEN" \
-H "Accept: application/json" \
-H "Content-Type: application/json" \
-d '{
"account_id": 4,
"period_year": 2026,
"period_month": 10,
"movement_ids": [
1520,
1521,
1522
],
"has_monthly_close": true,
"statement_reference": "EXT-10-2026",
"statement_date": "2026-10-31",
"statement_balance": 6250.5,
"notes": "Cierre de octubre"
}'
Lote conciliado200
{
"id": 15,
"cashbox_id": 1,
"cashbox_opening_id": 3,
"account_id": 4,
"period_year": 2026,
"period_month": 10,
"period_label": "2026-10",
"sequence": 1,
"from_date": "2026-10-01",
"to_date": "2026-10-30",
"movements_count": 12,
"opening_balance": 5000,
"closing_balance": 6250.5,
"amount_in": 2000,
"amount_out": 749.5,
"amount": 1250.5,
"has_monthly_close": true,
"statement_reference": "EXT-10-2026",
"statement_date": "2026-10-31",
"statement_balance": 6250.5,
"statement_file_url": "account-conciliation/statements/extracto.pdf",
"conciliation_status": "cerrada",
"conciliated_at": "2026-11-02T15:20:00.000000Z",
"conciliated_by_user_id": 1,
"reversed_at": null,
"reversed_by_user_id": null,
"reversal_reason": null,
"description": "Lote #1 — Octubre 2026 — 12 movimiento(s)",
"status": "activo",
"create_user_id": 1,
"created_at": "2026-11-02T15:20:00.000000Z",
"updated_at": "2026-11-02T15:20:00.000000Z"
}
Falta el permiso de cierre403
{
"message": "Para cerrar el mes necesitas el permiso «Cerrar mes»."
}
Datos no válidos422
{
"message": "El saldo del extracto (6000) no coincide con el saldo calculado (6250.5). La diferencia debe ser cero para cerrar el mes.",
"errors": {
"statement_balance": [
"El saldo del extracto (6000) no coincide con el saldo calculado (6250.5). La diferencia debe ser cero para cerrar el mes."
]
}
}