Ir al contenido

Crear un cierre mensual desde el formulario

POST/api/account-closure-monthly

Crea el cierre desde el formulario. Usa el mismo cálculo y las mismas validaciones que Crear un cierre mensual, y además deja el cierre en estado cerrado con closed_at, closed_by_user_id, period_label, net_amount y movements_count, guarda las notas y, si se envía, el extracto en PDF en el disco public. La solicitud es multipart/form-data.

account_idintegerobligatorio

Cuenta a cerrar. Debe existir.

monthintegerobligatorio

Mes a cerrar, de 1 a 12.

yearintegerobligatorio

Año a cerrar. Mínimo 2000.

notesstring

Notas. Máximo 1000 caracteres.

statement_filefile

Extracto en PDF. Máximo 10 MB.

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

Ventana de terminal
curl -X POST \
"https://servererp.allendostmen.app/api/account-closure-monthly" \
-H "Authorization: Bearer $TOKEN" \
-H "Accept: application/json" \
-F "account_id=4" \
-F "month=10" \
-F "year=2026" \
-F "notes=Cierre de octubre" \
-F "statement_file=@extracto.pdf"
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-closure-monthly/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"
}
Datos no válidos422
{
"message": "El extracto debe ser un archivo PDF.",
"errors": {
"statement_file": [
"El extracto debe ser un archivo PDF."
]
}
}