CustomerAccount
Una cuenta de cliente es una cuenta bancaria de un cliente (banco, moneda, número y responsable). Los movimientos de caja la usan para indicar a qué cuenta del cliente se hizo o se recibió el pago.
| Modelo | App\Models\CustomerAccount |
| Tabla | customer_accounts |
El objeto CustomerAccount
Sección titulada «El objeto CustomerAccount»Atributos
Sección titulada «Atributos»idintegerIdentificador del registro.
customer_idintegerIdentificador del cliente dueño de la cuenta.
bank_idintegerBanco de la cuenta.
coin_idintegerMoneda de la cuenta.
namestringNombre de la cuenta.
responsiblestringResponsable de la cuenta.
account_numberstringNúmero de cuenta.
account_typestringTipo de cuenta (AccountTypeEnum): detracción o recaudación.
emailstringCorreo de la cuenta. Existe en la tabla pero ninguna validación lo acepta, por lo que la API no lo guarda.
descriptionstringDescripción de la cuenta.
statusstringEstado del registro (ModelStatusEnum). Se asigna al crear.
previous_statusstringEstado anterior. Lo llena el sistema al eliminar o restaurar.
status_update_commentstringComentario del último cambio de estado.
status_update_datedatetimeFecha del último cambio de estado.
status_update_user_idintegerUsuario que hizo el último cambio de estado.
create_user_idintegerUsuario que creó el registro. Se asigna automáticamente.
update_user_idintegerUsuario que hizo la última modificación.
delete_user_idintegerUsuario que eliminó el registro.
restore_user_idintegerUsuario que restauró el registro.
restored_atdatetimeFecha de la última restauración.
created_atdatetimeFecha de creación.
updated_atdatetimeFecha de la última modificación.
deleted_atdatetimeFecha de eliminación lógica.
{ "id": 1, "customer_id": 12, "bank_id": 3, "coin_id": 1, "responsible": "Juan Pérez", "name": "Cuenta soles", "account_number": "19412345678", "account_type": "recaudación", "email": null, "description": null, "status": "activo", "previous_status": null, "status_update_comment": null, "status_update_date": null, "status_update_user_id": null, "create_user_id": 1, "update_user_id": null, "delete_user_id": null, "restore_user_id": null, "created_at": "2026-11-19T10:40:15.000000Z", "updated_at": "2026-11-19T10:40:15.000000Z", "deleted_at": null}Cómo la usa un movimiento de caja
Sección titulada «Cómo la usa un movimiento de caja»CashboxMovement guarda la cuenta en la columna customer_account_id y la expone con la relación customerAccount. Al crear o actualizar un movimiento, StoreCashboxMovementRequest y UpdateCashboxMovementRequest solo conservan los identificadores del tipo de tercero elegido en third_party_type: si el tipo es cliente, se conserva customer_account_id; si es otro tipo, customer_account_id se pone en nulo.
El campo customer_account_id solo se valida como opcional (nullable). El código no comprueba que la cuenta exista, que esté activa ni que pertenezca al cliente indicado en el movimiento; esa coherencia depende del cliente que llama a la API.
Validación propia de la cuenta
Sección titulada «Validación propia de la cuenta»Cuando account_type es detracción:
- El banco debe ser el Banco de la Nación. Si no, el mensaje es
Para cuentas de detracción, el banco debe ser Banco de la Nación. - La moneda debe ser la moneda marcada por defecto. Si no, el mensaje es
Para cuentas de detracción, se debe seleccionar la moneda por defecto (nombre de la moneda).Si no hay moneda por defecto:No se ha definido una moneda por defecto.
Estas reglas salen de StoreCustomerAccountRequest y UpdateCustomerAccountRequest.
Relaciones
Sección titulada «Relaciones»| Relación | Tipo | Modelo |
|---|---|---|
bank |
belongsTo | Bank |
customer |
belongsTo | Customer |
coin |
belongsTo | Coin |
El modelo Customer declara la relación inversa hasMany hacia CustomerAccount. CashboxMovement la referencia desde customer_account_id.
Se encadenan en CustomerAccountController::index:
| Scope | Parámetro | Efecto |
|---|---|---|
customerId |
customer_id |
Filtra por cliente. |
accountType |
account_type |
Filtra por tipo de cuenta. |
whenBankId |
bank_id |
Filtra por banco. |
Campos permitidos para ordenar: id, name, responsible, account_number, status, created_at, updated_at.
Búsqueda
Sección titulada «Búsqueda»La búsqueda de texto (search) compara con las columnas responsible y account_number.
Estados
Sección titulada «Estados»El estado usa ModelStatusEnum. Una cuenta nueva queda en activo; al eliminarla pasa a eliminado y se puede restaurar.
Permisos
Sección titulada «Permisos»Lectura abierta a cualquier usuario autenticado. Crear, editar y eliminar o restaurar usan los permisos del módulo de clientees: customer.create, customer.edit y customer.delete.
