Ir al contenido

Actualizar una cuenta

PUT/api/account/{id}

Actualiza los datos de una cuenta. La caja no se modifica por esta ruta: el campo cashbox_id se ignora (use las rutas de asignación). La moneda y el saldo solo se pueden cambiar mientras la cuenta no tenga movimientos; si el saldo cambia sin movimientos, se regenera la conciliación inicial.

idintegerobligatorio

Identificador de la cuenta.

namestringobligatorio

Nombre de la cuenta. No puede repetirse otra cuenta con el mismo nombre, tipo y moneda (y banco, si el tipo es virtual); para esa comparación se leen type y bank_id del cuerpo.

coin_idintegerobligatorio

Moneda de la cuenta. No puede cambiar si la cuenta ya tiene movimientos. Si account_type es detracción, debe ser Soles.

amountnumberobligatorio

Saldo de la cuenta. No puede cambiar si la cuenta ya tiene movimientos.

numberstring

Número de la cuenta. Debe ser único dentro de la misma caja.

number_ccistring

Código de cuenta interbancario. Debe ser único dentro de la misma caja.

settingsobject

Configuración de la cuenta. Acepta overdraft_enabled (booleano).

descriptionstring

Descripción de la cuenta. Se guarda en mayúsculas.

responsiblestring

Responsable de la cuenta. Se guarda en mayúsculas.

cashbox.account.edit, que se valida en AccountPolicy::update. Ver Permisos y políticas.

Ventana de terminal
curl -X PUT \
"https://servererp.allendostmen.app/api/account/1" \
-H "Authorization: Bearer $TOKEN" \
-H "Accept: application/json" \
-H "Content-Type: application/json" \
-d '{
"name": "Cuenta corriente soles",
"coin_id": 1,
"amount": 1500.5,
"description": "Cuenta para pagos",
"responsible": "Juan Pérez"
}'
Cuenta actualizada200
{
"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": "activo",
"previous_status": null,
"status_update_comment": null,
"status_update_date": null,
"create_user_id": 1,
"update_user_id": 1,
"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:05:00.000000Z"
}
Sin permiso403
{
"message": "Esta acción no está autorizada."
}
No encontrado404
{
"message": "No query results for model [App\\Models\\Account] 999"
}
Datos no válidos422
{
"message": "La moneda de la cuenta no puede ser modificada porque ya tiene movimientos asociados",
"errors": {
"account_id": [
"La moneda de la cuenta no puede ser modificada porque ya tiene movimientos asociados"
]
}
}