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.
Parámetros del cuerpo
Sección titulada «Parámetros del cuerpo»account_idintegerobligatorioCuenta a cerrar. Debe existir.
monthintegerobligatorioMes a cerrar, de 1 a 12.
yearintegerobligatorioAño a cerrar.
Permiso
Sección titulada «Permiso»cashbox.account.closure.create, que se valida en AccountClosureMonthlyPolicy::create.
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}'const response = await fetch( "https://servererp.allendostmen.app/api/account-clouse-monthly", { method: "POST", headers: { Authorization: `Bearer ${token}`, Accept: "application/json", "Content-Type": "application/json", }, body: JSON.stringify({ "account_id": 4, "month": 10, "year": 2026 }), },);const data = await response.json();use Illuminate\Support\Facades\Http;
$response = Http::withToken($token) ->acceptJson() ->post('https://servererp.allendostmen.app/api/account-clouse-monthly', [ '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." ] }}