AccountingAccountMovement
Un movimiento de cuenta contable es una fila del reparto de un movimiento de caja entre cuentas contables: indica cuánto del monto, en importe y en porcentaje, corresponde a cada cuenta.
| Modelo | App\Models\AccountingAccountMovement |
| Tabla | accounting_account_movements |
El objeto AccountingAccountMovement
Sección titulada «El objeto AccountingAccountMovement»Atributos
Sección titulada «Atributos»accounting_account_idintegerCuenta contable que recibe la parte del monto (AccountingAccount).
cashbox_movement_idintegerMovimiento de caja que se reparte (CashboxMovement).
amountnumberMonto asignado a la cuenta contable.
percentagenumberPorcentaje del total del movimiento que representa ese monto.
statusstringEstado del registro (ModelStatusEnum). Se asigna al crear.
previous_statusstringEstado anterior. Lo llena el sistema al eliminar o restaurar.
status_update_commentstringComentario del último cambio de estado.
status_update_datedatetimeFecha del último cambio de estado.
status_update_user_idintegerUsuario que hizo el último cambio de estado.
create_user_idintegerUsuario que creó el registro. Se asigna automáticamente.
update_user_idintegerUsuario que hizo la última modificación.
delete_user_idintegerUsuario que eliminó el registro.
restore_user_idintegerUsuario que restauró el registro.
restored_atdatetimeFecha de la última restauración.
created_atdatetimeFecha de creación.
updated_atdatetimeFecha de la última modificación.
deleted_atdatetimeFecha de eliminación lógica.
{ "accounting_account_id": 4, "cashbox_movement_id": 1520, "amount": "100.00", "percentage": "66.67", "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}No hay endpoints para este modelo: routes/api.php no registra ninguna ruta y AccountingAccountMovementController tiene sus métodos vacíos. Las filas se crean y se reemplazan desde los endpoints de movimientos de caja. Por eso esta carpeta solo tiene el Resumen.
Cómo se genera
Sección titulada «Cómo se genera»Al crear un movimiento de caja se puede enviar el campo accounting_account_movements, un arreglo con el reparto del monto entre cuentas contables. Cada elemento lleva:
| Campo | Regla |
|---|---|
accounting_account_id |
Obligatorio; debe existir en accounting_accounts. |
amount |
Obligatorio, numérico, mínimo 0. |
percentage |
Obligatorio, numérico, mínimo 0. |
Después de guardar el movimiento, CashboxMovementStoreService::createAccountingAccountMovements valida el reparto completo y crea una fila por elemento:
- La suma de los porcentajes debe ser exactamente 100. Si no, falla con
La suma de los porcentajes debe ser exactamente 100%. Actualmente es X%. - La suma de los montos debe ser igual al total del movimiento (
total_amount), comparada con 2 decimales. Si no, falla conLa suma de los montos (X) debe ser igual al total del movimiento (Y).
Ambos errores se devuelven como 422 sobre el campo accounting_account_movements. Si el campo no se envía o viene vacío, no se crea ninguna fila.
Otros flujos reutilizan el mismo servicio y el mismo campo, bajo cashbox_movement.accounting_account_movements: el registro de pagos de órdenes de pago, las inversiones y los retiros de inversión.
Al actualizar el movimiento
Sección titulada «Al actualizar el movimiento»CashboxMovementController::update reconstruye el reparto solo si el campo accounting_account_movements viene en la solicitud: elimina de forma lógica las filas anteriores del movimiento y crea las nuevas con las mismas validaciones. Si el campo no se envía, las filas existentes no cambian.
Transferencias entre cajas
Sección titulada «Transferencias entre cajas»En una transferencia entre cajas el reparto es obligatorio (accounting_account_movements con al menos un elemento y amount mínimo 0.01), y se crean las filas para los dos movimientos de la transferencia, el de salida y el de entrada.
Al anular el movimiento
Sección titulada «Al anular el movimiento»Anular un movimiento (CashboxMovementAnnulService::annul) cambia su estado a anulado, pero no modifica ni elimina sus filas de reparto: siguen enlazadas al movimiento anulado. Los resúmenes por cuenta contable (CashboxMovementReportService) parten de los movimientos vigentes, por lo que ese reparto deja de contarse; CashboxSummaryService cuenta como «sin cuenta contable» a los egresos que no tienen reparto vigente (filas no eliminadas).
Relaciones
Sección titulada «Relaciones»| Relación | Tipo | Modelo |
|---|---|---|
accountingAccount |
belongsTo | AccountingAccount |
cashboxMovement |
belongsTo | CashboxMovement |
Desde CashboxMovement se accede con la relación accountingAccountMovements (hasMany).
Notas de diseño
Sección titulada «Notas de diseño»La tabla no tiene columna id: el modelo declara $primaryKey = null y $incrementing = false, así que una fila se identifica por la pareja movimiento y cuenta contable. El $fillable del modelo no incluye previous_status, aunque la tabla tiene esa columna.
