AccountClosureMonthly
El cierre mensual sella un mes de una cuenta. Se crea junto con el lote final de la conciliación o con los endpoints de este modelo.
| Modelo | App\Models\AccountClosureMonthly |
| Tabla | account_closure_monthlies |
El objeto AccountClosureMonthly
Sección titulada «El objeto AccountClosureMonthly»Atributos
Sección titulada «Atributos»idintegerIdentificador del cierre.
account_idintegerCuenta cerrada.
monthintegerMes cerrado, de 1 a 12.
yearintegerAño cerrado.
period_labelstringEtiqueta del período con el formato AAAA-MM.
previous_balancenumberSaldo al iniciar el mes.
new_balancenumberSaldo al cerrar el mes.
net_amountnumberIngresos menos egresos del mes.
total_incomesnumberTotal de ingresos del mes.
total_expensesnumberTotal de egresos del mes.
incomes_countintegerCantidad de ingresos.
expenses_countintegerCantidad de egresos.
movements_countintegerCantidad total de movimientos.
conciliations_countintegerCantidad de lotes del mes.
first_conciliation_idintegerPrimer lote de conciliación del mes.
last_conciliation_idintegerLote que cerró el mes.
statement_file_urlstringRuta del extracto adjunto.
notesstringNotas del cierre.
close_statusstringEstado del cierre (AccountClosureMonthlyStatusEnum: cerrado o reabierto).
closed_atdatetimeFecha del cierre.
closed_by_user_idintegerUsuario que cerró.
reopened_atdatetimeFecha de reapertura.
reopened_by_user_idintegerUsuario que reabrió.
reopen_reasonstringMotivo de la reapertura.
statusstringEstado del registro (ModelStatusEnum, por ejemplo activo). Se asigna automáticamente al crear.
previous_statusstringEstado anterior. Lo llena el sistema al cambiar el estado.
restored_atdatetimeFecha de la última restauración.
create_user_idintegerUsuario que creó el registro.
update_user_idintegerÚltimo usuario que modificó el registro.
delete_user_idintegerUsuario que eliminó el registro.
restore_user_idintegerUsuario que restauró el registro.
created_atdatetimeFecha de creación.
updated_atdatetimeFecha de la última modificación.
{ "id": 7, "account_id": 4, "month": 10, "year": 2026, "period_label": "2026-10", "previous_balance": 5000, "new_balance": 6250.5, "net_amount": 1250.5, "total_incomes": 2000, "total_expenses": 749.5, "incomes_count": 8, "expenses_count": 4, "movements_count": 12, "conciliations_count": 1, "first_conciliation_id": 15, "last_conciliation_id": 15, "statement_file_url": "account-conciliation/statements/extracto.pdf", "notes": "Cierre de octubre", "close_status": "cerrado", "closed_at": "2026-11-02T15:20:00.000000Z", "closed_by_user_id": 1, "reopened_at": null, "reopened_by_user_id": null, "reopen_reason": null, "status": "activo", "create_user_id": 1, "created_at": "2026-11-02T15:20:00.000000Z", "updated_at": "2026-11-02T15:20:00.000000Z"}Relaciones
Sección titulada «Relaciones»| Relación | Tipo | Modelo |
|---|---|---|
account |
belongsTo | Account |
firstConciliation |
belongsTo | AccountConciliation |
lastConciliation |
belongsTo | AccountConciliation |
closedBy |
belongsTo | User |
reopenedBy |
belongsTo | User |
scopeWhenAccountId, scopeWhenMonth y scopeWhenYear.
Endpoints
Sección titulada «Endpoints»Las rutas del recurso se escriben account-clouse-monthly (con «clouse») en el código; las de vista previa y creación desde formulario usan account-closure-monthly.
