Ir al contenido

Flujos de movimientos de Caja

Un movimiento de Caja no nace solo desde la pantalla de Caja. Otros módulos y procesos también lo crean, lo cambian o lo anulan. Esta sección documenta esos flujos; los modelos y endpoints de cada recurso están en las demás secciones de Caja.

Origen Quién lo crea Campos que fija Camino de creación Más información
Manual (ingreso o egreso) CashboxMovementController::store con StoreCashboxMovementRequest Los que envía el formulario. type, account_id, payment_method_id, subtotal_amount, payment_date, tercero, centro de costo (solo egreso) y reparto contable. CashboxMovementStoreService::store Ciclo de vida y Crear movimiento
Orden de pago (pago) PaymentCashboxMovementService::create, llamado por RegisterPaymentUseCase type egreso, third_party_type proveedor, provider_id de la orden, subtotal_amount igual a la suma de las líneas, cost_center_id de la orden de compra (o el indicado). CashboxMovementStoreService::store Órdenes de pago
Orden de pago (devolución) PaymentCashboxMovementService::createRefund, llamado por RegisterPaymentRefundUseCase type ingreso, proveedor de la orden, subtotal_amount igual a la suma de las líneas devueltas. CashboxMovementStoreService::store Órdenes de pago
Inversión (capital recibido) InvestmentController::store, que llama a CashboxMovementController::store type ingreso, third_party_type otro (si no se indica), concept con el nombre del inversionista y la inversión, subtotal_amount igual al monto de la inversión. CashboxMovementStoreService::store Inversiones y cuotas
Pago de una cuota o de todas las cuotas pendientes InvestmentWithdrawalController::payInstallmentInvestment y payPendingInstallmentsInvestment, que llaman a CashboxMovementController::store type egreso, concept generado, cost_center_id del centro de la inversión. CashboxMovementStoreService::store Inversiones y cuotas
Liquidación de una inversión y alta manual de un retiro InvestmentWithdrawalController::liquidationInstallmentInvestment y store, con CashboxMovementCreateService::createFromLegacyPayload type egreso, user_id y create_user_id del usuario autenticado, código de 6 dígitos. Camino heredado: CashboxMovement::create directo Inversiones y cuotas
Transferencia entre cuentas CashboxMovementController::createTransfer Dos movimientos: egreso en el origen (is_transfer verdadero) e ingreso en el destino con transfer_cashbox_movement_id apuntando al egreso. Método de pago: transferencia. BaseControllerHelper::store con callback propio Crear transferencia
Cambio de moneda CashboxMovementController::createExchangeRate Igual que la transferencia, más is_exchange_rate verdadero, coin_exchange_rate por pata, exchange_rate_value y exchange_rate_reference_coin_id. BaseControllerHelper::store con callback propio Crear cambio de moneda
Comisión CashboxMovementController::createCommissions type egreso, subtotal_amount 0, total_amount igual a la comisión, concept con el prefijo Comisión y el nombre del tipo, sin método de pago. BaseControllerHelper::store con callback propio Crear comisión
Caja de cliente (ingreso) CustomerCashboxMovementController::store type ingreso, concept tomado de la observación. Crea también un CustomerCashboxMovement. BaseControllerHelper::store con setCode() Caja de cliente
Caja de cliente (transferencia entre cajas de cliente) CustomerCashboxController::transfer Un egreso y un ingreso, con origin_account_id y destination_account_id. BaseControllerHelper::store con setCode() Caja de cliente
Asistente de IA AiAssistantController::confirmCashboxMovement type, cuenta, método de pago, subtotal_amount igual a total_amount, tercero, segmento de ingreso. Camino directo: CashboxMovement::create Asistente de IA
Conciliación AccountConciliationController (flujo anterior) type conciliación, montos en 0, conciliated verdadero, conciliation_amount. Marca el corte; no mueve el saldo. CashboxMovement::insert Reglas de conciliación
Efecto CashboxMovementStoreService::store BaseControllerHelper::store con callback propio (transferencias, cambio de moneda, comisión, caja de cliente) createFromLegacyPayload y asistente de IA
Permiso create de CashboxMovementPolicy Sí, vía BaseControllerHelper::store Sí, vía BaseControllerHelper::store Asistente de IA: Gate::allows('create', CashboxMovement::class) en process y confirm. Camino heredado de inversiones: ninguno en el controlador.
Observador CashboxMovementObserver::created (saldo de la cuenta y bitácora) Sí Sí Sí
Validación de caja abierta y saldo AccountHelper::validateAvailabilityAndMovement Transferencia, cambio de moneda y comisión: validateAvailabilityAndMovement en el egreso y validateAvailability en el ingreso. Caja de cliente: apertura y saldo validados en el propio controlador. Heredado: validateAvailabilityAndMovement. IA: CashboxHelper::validateOpening más AccountHelper::validateMovement.
Bloqueo de la fila de la cuenta Sí Solo el que hace el observador Solo el que hace el observador
Movimiento de centro de costos Sí, si es egreso con centro No No
Reparto contable (AccountingAccountMovement) Sí, si se envía Solo en transferencias No
Código Correlativo de 12 dígitos setCode() en caja de cliente. En transferencia, cambio de moneda y comisión no se asigna. 6 dígitos (heredado) o 12 dígitos (IA)

Los detalles de cada fila están en las páginas de cada flujo.

PUT cashbox-movement/{id}/anulate
|
+--> movimiento vinculado a un pago de orden de pago
| --> AnnulPaymentUseCase (anula el pago y el movimiento)
|
+--> movimiento es la devolución de un pago
| --> rechazado: no se anula desde Caja
|
+--> cualquier otro
--> CashboxMovementAnnulService::annul
(revierte centro de costos y cuotas de inversión)
PUT cashbox-movement/anulate/{id} (solo transferencias y cambios de moneda)
--> CashboxMovementController::anulateMovement (anula ambas patas)
PUT customer-cashbox-movement/{id}/change-status
--> CustomerCashboxMovementController::changeStatus (anula el par de cliente)