Conciliar una cuenta
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.
Parámetros del cuerpo
Sección titulada «Parámetros del cuerpo»account_idintegerobligatorioCuenta a conciliar. Debe existir y estar activa.
period_yearintegerobligatorioAño del período, entre 2000 y 2100.
period_monthintegerobligatorioMes del período, entre 1 y 12.
movement_idsarrayobligatorioIdentificadores de los movimientos. Al menos uno; cada uno debe existir, no estar anulado ni conciliado.
has_monthly_closebooleanobligatorioIndica si el lote cierra el mes.
statement_datedatecondicionalFecha del extracto. Obligatoria si has_monthly_close es verdadero.
statement_balancenumbercondicionalSaldo del extracto. Obligatorio si has_monthly_close es verdadero y debe coincidir con el saldo calculado.
statement_referencestringReferencia del extracto. Máximo 255 caracteres.
statement_filestringExtracto 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_urlstringRuta del extracto, máximo 500 caracteres. Se usa solo si no se envía statement_file.
notesstringNotas del cierre mensual. Máximo 1000 caracteres.
Permiso
Sección titulada «Permiso»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».
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"}'const response = await fetch( "https://servererp.allendostmen.app/api/account-conciliation/conciliate", { method: "POST", headers: { Authorization: `Bearer ${token}`, Accept: "application/json", "Content-Type": "application/json", }, body: JSON.stringify({ "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" }), },);const data = await response.json();use Illuminate\Support\Facades\Http;
$response = Http::withToken($token) ->acceptJson() ->post('https://servererp.allendostmen.app/api/account-conciliation/conciliate', [ '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', ]);{ "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"}{ "message": "Para cerrar el mes necesitas el permiso «Cerrar mes»."}{ "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." ] }}