Cambiar el estado de una cuenta
PUT/api/account/{id}/change-status
Cambia el estado de la cuenta entre activo e inactivo y deja el cambio en la bitácora de la caja. La cuenta debe estar conciliada y no puede tener ya el estado pedido.
Parámetros de la ruta
Sección titulada «Parámetros de la ruta»idintegerobligatorioIdentificador de la cuenta.
Parámetros del cuerpo
Sección titulada «Parámetros del cuerpo»statusstringobligatorioNuevo estado: activo o inactivo.
status_update_commentstringMotivo del cambio. Es opcional para la validación, pero envíelo siempre en la solicitud, aunque sea null: el controlador lee esta clave sin comprobar si existe.
Permiso
Sección titulada «Permiso»No exige un permiso del catálogo. AccountPolicy::changeStatus niega la acción si la cuenta ya tiene ese estado o si no está conciliada. Ver Permisos y políticas.
curl -X PUT \ "https://servererp.allendostmen.app/api/account/1/change-status" \ -H "Authorization: Bearer $TOKEN" \ -H "Accept: application/json" \ -H "Content-Type: application/json" \ -d '{ "status": "inactivo", "status_update_comment": "Cuenta fuera de uso"}'const response = await fetch( "https://servererp.allendostmen.app/api/account/1/change-status", { method: "PUT", headers: { Authorization: `Bearer ${token}`, Accept: "application/json", "Content-Type": "application/json", }, body: JSON.stringify({ "status": "inactivo", "status_update_comment": "Cuenta fuera de uso" }), },);const data = await response.json();use Illuminate\Support\Facades\Http;
$response = Http::withToken($token) ->acceptJson() ->put('https://servererp.allendostmen.app/api/account/1/change-status', [ 'status' => 'inactivo', 'status_update_comment' => 'Cuenta fuera de uso', ]);Estado cambiado200
{ "id": 1, "cashbox_id": 1, "banking_product_id": null, "bank_id": 3, "coin_id": 1, "name": "CUENTA CORRIENTE SOLES", "number": "191-1234567-0-12", "modality": "cuenta bancaria", "swift_code": null, "type": "virtual", "amount": 1500.5, "description": "CUENTA PARA PAGOS", "account_type": "recaudación", "number_cci": "00219100123456701234", "responsible": "JUAN PÉREZ", "settings": { "overdraft_enabled": false }, "conciliated": true, "conciliated_movement_last_date": null, "conciliated_at": "2026-11-19T10:40:15.000000Z", "last_conciliation_id": null, "last_monthly_close_id": null, "status": "inactivo", "previous_status": "activo", "status_update_comment": "Cuenta fuera de uso", "status_update_date": null, "create_user_id": 1, "update_user_id": null, "delete_user_id": null, "restore_user_id": null, "status_update_user_id": null, "deleted_at": null, "created_at": "2026-11-19T10:40:15.000000Z", "updated_at": "2026-11-19T11:30:00.000000Z"}Sin permiso403
{ "message": "La cuenta ya está con el estado inactivo."}No encontrado404
{ "message": "No query results for model [App\\Models\\Account] 999"}Datos no válidos422
{ "message": "The selected status is invalid.", "errors": { "status": [ "The selected status is invalid." ] }}