Ir al contenido

Crear un cierre mensual

POST/api/account-clouse-monthly

Crea el cierre del mes indicado. El servidor calcula saldos, totales y conteos con AccountClosureMonthlyService::createMonthlyAccountClosure. Valida que el mes ya haya terminado, que los movimientos estén conciliados, que no esté ya cerrado y que se respete el orden de cierres.

Diferencia con Crear un cierre desde el formulario: esta acción recibe solo cuenta, mes y año; no guarda notas, extracto ni los datos de cierre (close_status, closed_at, closed_by_user_id, period_label). El cierre que se hace al conciliar está en Conciliar una cuenta.

account_idintegerobligatorio

Cuenta a cerrar. Debe existir.

monthintegerobligatorio

Mes a cerrar, de 1 a 12.

yearintegerobligatorio

Año a cerrar.

cashbox.account.closure.create, que se valida en AccountClosureMonthlyPolicy::create.

Ventana de terminal
curl -X POST \
"https://servererp.allendostmen.app/api/account-clouse-monthly" \
-H "Authorization: Bearer $TOKEN" \
-H "Accept: application/json" \
-H "Content-Type: application/json" \
-d '{
"account_id": 4,
"month": 10,
"year": 2026
}'
Cierre creado201
{
"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"
}
Mes ya cerrado422
{
"message": "Ya has cerrado el mes de 10/2026.",
"errors": {
"date": [
"Ya has cerrado el mes de 10/2026."
]
}
}