Ir al contenido

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
accounting_account_idinteger

Cuenta contable que recibe la parte del monto (AccountingAccount).

cashbox_movement_idinteger

Movimiento de caja que se reparte (CashboxMovement).

amountnumber

Monto asignado a la cuenta contable.

percentagenumber

Porcentaje del total del movimiento que representa ese monto.

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 AccountingAccountMovement200
{
"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.

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 con La 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.

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.

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.

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).

Relación Tipo Modelo
accountingAccount belongsTo AccountingAccount
cashboxMovement belongsTo CashboxMovement

Desde CashboxMovement se accede con la relación accountingAccountMovements (hasMany).

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.