Ir al contenido

PaymentMethod

Un método de pago es la forma en que se mueve el dinero en caja, por ejemplo transferencia o efectivo. Su campo payment_settings decide en qué tipos de movimiento y con qué tipos de cuenta se puede usar, y qué campos muestra y exige el formulario de movimientos de caja.

Modelo App\Models\PaymentMethod
Tabla payment_methods
idinteger

Identificador del método de pago.

namestring

Nombre del método de pago.

descriptionstring

Descripción del método de pago.

is_for_account_virtualboolean

Indicador heredado de uso con cuentas virtuales. Por defecto, verdadero en la base de datos.

is_for_account_physicalboolean

Indicador heredado de uso con cuentas físicas. Por defecto, verdadero.

is_for_incomeboolean

Indicador heredado de uso en ingresos. Por defecto, verdadero.

is_for_expenseboolean

Indicador heredado de uso en egresos. Por defecto, verdadero.

include_commissionboolean

Indicador heredado de comisión. Por defecto, falso.

payment_settingsobject

Configuración en JSON del método de pago. Estructura en la sección siguiente.

statusstring

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

previous_statusstring

Estado anterior. Lo llena el sistema al eliminar, restaurar o cambiar el estado.

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 PaymentMethod200
{
"id": 1,
"name": "Transferencia",
"description": "Transferencia bancaria",
"is_for_account_virtual": true,
"is_for_account_physical": true,
"is_for_income": true,
"is_for_expense": true,
"include_commission": false,
"payment_settings": {
"egreso": {
"enable": true,
"inputs": {
"commission": {
"show": false,
"required": false
},
"operationNumber": {
"show": true,
"required": true
}
}
},
"ingreso": {
"enable": true,
"inputs": {
"commission": {
"show": true,
"required": false
},
"operationNumber": {
"show": true,
"required": true
}
}
},
"account": {
"fisica": {
"enable": true
},
"virtual": {
"enable": true
}
},
"forCollection": true,
"forDisbursement": true,
"requiresAccount": true,
"requiresReference": false
},
"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,
"restored_at": null,
"created_at": "2026-11-19T10:40:15.000000Z",
"updated_at": "2026-11-19T10:40:15.000000Z",
"deleted_at": null
}

StoreCashboxMovementRequest lee payment_settings para validar cada movimiento de caja. La clave egreso o ingreso se elige según el tipo del movimiento.

{
"egreso": {
"enable": true,
"inputs": {
"commission": { "show": false, "required": false },
"operationNumber": { "show": true, "required": true }
}
},
"ingreso": {
"enable": true,
"inputs": {
"commission": { "show": true, "required": false },
"operationNumber": { "show": true, "required": true }
}
},
"account": {
"fisica": { "enable": true },
"virtual": { "enable": true }
},
"forCollection": true,
"forDisbursement": true,
"requiresAccount": true,
"requiresReference": false
}
Clave Efecto en un movimiento de caja
egreso.enable o ingreso.enable Si no es verdadero, el movimiento se rechaza con El método de pago no está configurado para realizar un movimiento de tipo egreso. o ... de tipo ingreso.
inputs.operationNumber.show Si es verdadero, el campo opcode se valida: obligatorio si required es verdadero y opcional en caso contrario.
inputs.commission.show Si es verdadero, se valida include_commission: debe ser verdadero y aceptado si required es verdadero, y opcional en caso contrario.
account.fisica.enable Si no es verdadero y la cuenta no es virtual, se rechaza con El método de pago no está configurado para usar cuentas físicas.
account.virtual.enable Si no es verdadero y la cuenta es virtual, se rechaza con El método de pago no está configurado para usar cuentas virtuales.

Si include_commission es verdadero, el movimiento exige además commission_type_id, commission_amount y admite commission_opcode. Las claves forCollection, forDisbursement, requiresAccount y requiresReference son obligatorias al guardar el método, pero StoreCashboxMovementRequest no las lee.

Ver Crear un movimiento.

Campos permitidos para ordenar: id, name, description, status, created_at, updated_at.

La búsqueda de texto (search) compara con la columna name.

El estado usa ModelStatusEnum. Un método nuevo queda en activo; al eliminarlo pasa a eliminado.