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.
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. Mínimo 2000.
notesstringNotas. Máximo 1000 caracteres.
statement_filefileExtracto en PDF. Máximo 10 MB.
Permiso
Sección titulada «Permiso»cashbox.account.closure.create, que se valida en AccountClosureMonthlyPolicy::create.
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"const formData = new FormData();formData.append("account_id", "4");formData.append("month", "10");formData.append("year", "2026");formData.append("notes", "Cierre de octubre");formData.append("statement_file", fileInput.files[0]);
const response = await fetch( "https://servererp.allendostmen.app/api/account-closure-monthly", { method: "POST", headers: { Authorization: `Bearer ${token}`, Accept: "application/json", }, body: formData, },);const data = await response.json();use Illuminate\Support\Facades\Http;
$response = Http::withToken($token) ->acceptJson() ->attach('statement_file', file_get_contents('extracto.pdf'), 'extracto.pdf') ->post('https://servererp.allendostmen.app/api/account-closure-monthly', [ 'account_id' => '4', 'month' => '10', 'year' => '2026', 'notes' => 'Cierre de octubre', ]);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." ] }}