Ir al contenido

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.

idintegerobligatorio

Identificador de la cuenta.

statusstringobligatorio

Nuevo estado: activo o inactivo.

status_update_commentstring

Motivo 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.

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.

Ventana de terminal
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"
}'
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."
]
}
}