Ir al contenido

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
idinteger

Identificador del registro.

commission_type_idinteger

Tipo de comisión (CommissionType).

coin_idinteger

Moneda de la comisión.

origin_bank_idinteger

Banco de origen.

destination_bank_idinteger

Banco de destino. Es nulo cuando la comisión es variable.

variableboolean

Indica si la comisión es variable.

amountnumber

Monto de la comisión (decimal 20,8). Es opcional.

commentstring

Columna de texto de la tabla. El modelo no la declara en $fillable.

descriptionstring

Atributo que declaran el modelo y las validaciones. Ver la advertencia más abajo.

statusstring

Estado del registro (ModelStatusEnum). Se asigna al crear.

previous_statusstring

Estado anterior. Lo llena el sistema al eliminar o restaurar.

status_update_commentstring

Comentario del último cambio de estado.

status_update_datedatetime

Fecha del último cambio de estado.

status_update_user_idinteger

Usuario que hizo el último cambio de estado.

create_user_idinteger

Usuario que creó el registro. Se asigna automáticamente.

update_user_idinteger

Usuario que hizo la última modificación.

delete_user_idinteger

Usuario que eliminó el registro.

restore_user_idinteger

Usuario que restauró el registro.

restored_atdatetime

Fecha de la última restauración.

created_atdatetime

Fecha de creación.

updated_atdatetime

Fecha de la última modificación.

deleted_atdatetime

Fecha de eliminación lógica.

El objeto Commission200
{
"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
}
Relación Tipo Modelo
commissionType belongsTo CommissionType
coin belongsTo Coin
originBank belongsTo Bank (origin_bank_id)
destinationBank belongsTo Bank (destination_bank_id)

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.

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.

La búsqueda de texto (search) compara con el nombre del tipo de comisión (commissionType.name).

El estado usa ModelStatusEnum. Una comisión nueva queda en activo; al eliminarla pasa a eliminado y se puede restaurar.

Lectura abierta a cualquier usuario autenticado. Crear, editar y eliminar o restaurar usan cashbox.configuration.create, cashbox.configuration.edit y cashbox.configuration.delete.