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.
Orígenes de un movimiento
Sección titulada «Orígenes de un movimiento»| 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 |
Qué hace cada camino de creación
Sección titulada «Qué hace cada camino de creació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.
Anulación: quién la ejecuta
Sección titulada «Anulación: quién la ejecuta»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)