Ir al contenido

ProviderAccount

Una cuenta de proveedor es una cuenta bancaria de un proveedor (banco, moneda, número y responsable). Los movimientos de caja la usan para indicar a qué cuenta del proveedor se hizo o se recibió el pago.

Modelo App\Models\ProviderAccount
Tabla provider_accounts
idinteger

Identificador del registro.

provider_idinteger

Identificador del proveedor dueño de la cuenta.

bank_idinteger

Banco de la cuenta.

coin_idinteger

Moneda de la cuenta.

namestring

Nombre de la cuenta.

responsiblestring

Responsable de la cuenta.

account_numberstring

Número de cuenta.

account_typestring

Tipo de cuenta (AccountTypeEnum): detracción o recaudación.

emailstring

Correo de la cuenta. Existe en la tabla pero ninguna validación lo acepta, por lo que la API no lo guarda.

descriptionstring

Descripción de la cuenta.

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 ProviderAccount200
{
"id": 1,
"provider_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
}

CashboxMovement guarda la cuenta en la columna provider_account_id y la expone con la relación providerAccount. 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 proveedor, se conserva provider_account_id; si es otro tipo, provider_account_id se pone en nulo.

El campo provider_account_id solo se valida como opcional (nullable). El código no comprueba que la cuenta exista, que esté activa ni que pertenezca al proveedor indicado en el movimiento; esa coherencia depende del cliente que llama a la API.

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 StoreProviderAccountRequest y UpdateProviderAccountRequest.

Relación Tipo Modelo
bank belongsTo Bank
provider belongsTo Provider
coin belongsTo Coin

El modelo Provider declara la relación inversa hasMany hacia ProviderAccount. CashboxMovement la referencia desde provider_account_id.

Se encadenan en ProviderAccountController::index:

Scope Parámetro Efecto
providerId provider_id Filtra por proveedor.
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.

La búsqueda de texto (search) compara con las columnas responsible y account_number.

El estado usa ModelStatusEnum. Una cuenta 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 los permisos del módulo de proveedores: provider.create, provider.edit y provider.delete.