Commission
Una comisión define cuánto se cobra por un tipo de comisión en una moneda, entre un banco de origen y, si no es variable, un banco de destino.
| Modelo | App\Models\Commission |
| Tabla | commissions |
El objeto Commission
Sección titulada «El objeto Commission»Atributos
Sección titulada «Atributos»idintegerIdentificador del registro.
commission_type_idintegerTipo de comisión (CommissionType).
coin_idintegerMoneda de la comisión.
origin_bank_idintegerBanco de origen.
destination_bank_idintegerBanco de destino. Es nulo cuando la comisión es variable.
variablebooleanIndica si la comisión es variable.
amountnumberMonto de la comisión (decimal 20,8). Es opcional.
commentstringColumna de texto de la tabla. El modelo no la declara en $fillable.
descriptionstringAtributo que declaran el modelo y las validaciones. Ver la advertencia más abajo.
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, "commission_type_id": 2, "coin_id": 1, "origin_bank_id": 3, "destination_bank_id": 5, "variable": false, "amount": "2.50000000", "comment": 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}Relaciones
Sección titulada «Relaciones»| Relación | Tipo | Modelo |
|---|---|---|
commissionType |
belongsTo | CommissionType |
coin |
belongsTo | Coin |
originBank |
belongsTo | Bank (origin_bank_id) |
destinationBank |
belongsTo | Bank (destination_bank_id) |
Relación con CommissionType
Sección titulada «Relación con CommissionType»Cada comisión pertenece a un tipo de comisión mediante commission_type_id. El tipo clasifica la comisión (por ejemplo, la bancaria); la comisión concreta fija la moneda, los bancos y el monto para ese tipo.
Relación con CashboxMovement
Sección titulada «Relación con CashboxMovement»CashboxMovement declara la relación commission (belongsTo hacia Commission), pero la tabla cashbox_movements no tiene la columna commission_id, así que esa relación no se puede resolver hoy. Lo que sí guarda un movimiento es commission_type_id, junto con include_commission, commission_amount y commission_opcode: el movimiento enlaza con el tipo de comisión, no con una comisión de esta tabla. Ver Movimientos de caja.
Se encadenan en CommissionController::index:
| Scope | Parámetro | Efecto |
|---|---|---|
whenCommissionTypeId |
commission_type_id |
Filtra por tipo de comisión. |
whenOriginBankId |
origin_bank_id |
Filtra por banco de origen. |
whenDestinationBankId |
destination_bank_id |
Filtra por banco de destino. |
whenAccountId |
account_id |
Comisiones cuyo banco de origen tiene esa cuenta. |
Campos permitidos para ordenar: id, name, amount, description, status, created_at, updated_at. La tabla no tiene columna name ni description, así que ordenar por ellas no es útil.
Búsqueda
Sección titulada «Búsqueda»La búsqueda de texto (search) compara con el nombre del tipo de comisión (commissionType.name).
Estados
Sección titulada «Estados»El estado usa ModelStatusEnum. Una comisión 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 cashbox.configuration.create, cashbox.configuration.edit y cashbox.configuration.delete.
