Billing overview

Descripción General:

– Vista tabular y de control para monitorear, filtrar y accionar sobre Bill Items a nivel global.

– Permite navegar por períodos, clientes, proyectos y estados; abrir detalles y realizar acciones masivas (cambio de estado/eliminación).

Funcionalidades Principales y Cómo Usarlas:

Funcionalidad A: Explorar y filtrar el overview de Billing

1. Ve a Finance > Billing Overview.
2. Usa el selector de fechas para acotar por período; por defecto se carga el mes actual.
3. Aplica filtros adicionales (cliente, proyecto, tipo/subtipo/concepto, estado) desde el panel de filtros.
4. Revisa las columnas clave: Domain, Billing Chain, Proyecto (y cliente), Tipo/Concepto, Asgmt, Período, BH (billable hours), Monto y Status.
5. Si los items tienen monedas distintas, el Total de “Amount” no se muestra (se indica “-”).

Funcionalidad B: Ver detalle de un Bill Item y su cadena de billing

1. Haz clic en un item para abrir el drawer de detalle.
2. Navega por las pestañas:

     – Main Info: datos principales del Bill Item (tipo, concepto, montos, BH, contratos, etc.).

     – Activity Log: actividades y cambios.

3. En la columna Billing Chain o dentro del detalle, revisa la cadena de facturación (cliente, broker, vendor, persona), útil para entender imputaciones y pagos.

Funcionalidad C: Acciones sobre un Bill Item (individuales)

1. Selecciona un item y abre el menú de acciones.
2. Cambia su estado respetando la secuencia:

     – PENDING ↔ READY_TO_BILL → PROCESSED → COMPLETED

     – Regresar a PENDING solo desde READY_TO_BILL.

3. Otras acciones:

     – Details: abre el drawer.

     – Delete: elimina el item si cumple condiciones de borrado (ver Puntos Clave).

4. Al confirmar, el sistema guarda y muestra confirmación; refresca la lista si corresponde.

Funcionalidad D: Acciones masivas (bulk)

1. Marca varios items en la tabla.
2. Desde el menú de acciones masivas, elige:

     – To Pending

     – To Ready to Bill

     – To Processed

     – To Completed

     – Delete

3. Confirma. El sistema aplica el cambio, guarda y refresca la lista; se notifica el total de items actualizados/eliminados.

Funcionalidad E: Navegación rápida a entidades relacionadas

1. Desde las columnas Proyecto/Cliente, haz clic para abrir `Project` o `Company` en una nueva pestaña.
2. Desde las referencias de Persona, abre su perfil en una nueva pestaña para validar contexto (contratos, rates, etc.).

Puntos Clave o Consejos:

– Estados y transiciones: fuera de BI Admin, se aplica una máquina de estados estricta:

  – PENDING ↔ READY_TO_BILL (cambio directo)

  – READY_TO_BILL → PROCESSED → COMPLETED (progresivo)

  – No se puede saltar estados intermedios; BI Admin puede forzar.

– Permisos:

• Alter BI: requerido para cambiar items no-royalty.
• Alter Royalty: requerido para items con royalty.
• BI Admin: puede cambiar a cualquier estado y borrar sin restricciones normales.

– Borrado:

• Sin BI Admin, solo puedes eliminar si el item está en PENDING, fuiste quien lo creó y tienes derecho a Alter BI (y no es royalty) o Alter Royalty (si lo es).

– Filtro de fechas:

  – Por defecto: mes actual. Al limpiar fechas, la UI reinicia el panel de filtros para evitar glitches visuales.

– Moneda:

  – El total de Amount solo se muestra si todos los items visibles comparten la misma moneda.

– Cobertura de tipos de servicio:

  – El overview mezcla staffing y solution; usa “Type/Concept” y color por “type” para distinguir:

    – type id 0 (invoice-color): facturación al cliente (típico en solution/staffing).

    – type id 1 (po-color): órdenes de compra/pagos (típico hacia vendor/persona).

  – Úsalo para auditar ambos streams en la misma vista y agrupar con filtros si necesitás enfocarte en uno.