Consultar tus comisiones ganadas y proyectadas

Mis Comisiones es tu consulta personal: eliges un mes, Marko calcula en el servidor cuánto llevas ganado según las OC de Convenio Marco en las que apareces como ejecutivo, y te muestra el detalle OC por OC. No edita nada — todo lo que ves aquí, incluidos los descuentos y ajustes personalizados, está en modo lectura.

Qué vas a conseguir

Ver tus comisiones Personales, Compartidas y Comunes de un mes, el factor aplicado y el total a pagar, con el detalle de cada OC que las generó.

Para quién

La ve el Ejecutivo y el Ejecutivo avanzado. Manager y Administrador no tienen esta entrada en el menú.

Qué necesitas antes

Al menos una OC Convenio ganada donde figures como el ejecutivo asignado, dentro del mes que consultas.

Cuánto toma

Medio minuto: elegir el mes y esperar el cálculo.

Sólo ves lo tuyo A diferencia de otras pantallas comerciales de Marko, aquí no hay nada que confundir: el cálculo se pide siempre para userId = tu propia cuenta (functions/src/mercadopublico_api/processMyCommissions.function.ts:27-32). No existe forma de mirar el mes de otro ejecutivo desde esta pantalla, ni siquiera para un Ejecutivo avanzado, que en otras listas de Marko sí ve lo de todo el equipo.

Los pasos

Abre Comercial en el menú lateral y entra en Mis Comisiones.

Qué deberías verEl grupo Comercial abierto con nueve entradas, entre ellas Mis Comisiones. Arriba a la derecha, tu cuenta muestra el rol Ejecutivo: es el único dato de permisos que necesitas confirmar antes de seguir.
Espera: la pantalla arranca sola en el mes en curso y calcula sin que pidas nada.

Qué deberías verEl selector de mes ya con el mes de hoy escrito, y debajo el resultado del cálculo automático. Si todavía no ganaste ninguna OC este mes, verás el aviso No se encontraron comisiones con el texto No hay comisiones para el período seleccionado — es la respuesta normal de un mes sin OC propias, no un error.

Por qué esta captura sale vacía En el ambiente de demostración (QA, empresa ALIMENTOS SPA), la cuenta de Ejecutivo provista para este manual no tiene ninguna OC Convenio asignada como ejecutivo. Lo comprobamos en la base: de las 236 OC Convenio de la empresa, sólo 2 tienen algún ejecutivo asignado, y las dos pertenecen a otras cuentas de prueba sin contraseña documentada, no a las cuentas christian+<rol>@marko.cl con las que se capturan los manuales. Por eso este manual muestra el estado real de «sin comisiones» — que es exactamente lo que ve cualquier ejecutivo nuevo o sin OC ganadas ese mes — y describe el resultado con datos que sí están verificados en el código, no inventados, en la sección Qué trae el resultado.
Escribe otro período en el campo de mes (formato AAAA-MM).

Qué deberías verEn cuanto sueltas el campo, el resultado anterior desaparece y aparece Procesando comisiones… con el texto Esto puede tomar unos momentos. No hace falta pulsar nada más: cambiar el mes ya dispara el cálculo.

Para qué sirve el botón azul El botón con el ícono de flechas junto al campo (título Procesar mes) vuelve a pedir el mismo cálculo sin cambiar de mes — útil si crees que algo cambió en tus OC y quieres una cifra al día sin tocar el selector.
Lee el resultado del período que elegiste.

Qué deberías verSi hay OC tuyas ese mes: dos tablas de resumen — comisiones Personales/Compartidas/Comunes/Total a la izquierda, Factor calculado y Total a pagar a la derecha— y debajo la tabla Detalle OCs, una fila por orden. Si no hay ninguna, el mismo aviso No se encontraron comisiones del paso 2. La estructura completa de esa tabla, verificada en el código, está en Qué trae el resultado.
Cuando el resultado tenga datos, pulsa el botón verde Exportar a Excel.

Qué deberías verEl botón (título Exportar a Excel) está apagado mientras no haya comisiones que exportar — así se ve en esta captura, con el mes sin datos del paso anterior. Con resultado, se descarga un archivo mis_comisiones_<tu_nombre>_<AAAA-MM>.xlsx con dos hojas: Resumen (los mismos totales de la pantalla) y Detalle OCs (una fila por orden, con las mismas columnas de la tabla, más el % de margen ya calculado).

Qué trae el resultado

Verificado en my-commissions.component.html: esto es lo que arma la pantalla cuando sí hay OC tuyas en el mes, aunque las capturas de este manual no puedan mostrarlo lleno (ver el aviso del paso 2).

Las dos tablas de resumen

Campo	Qué es
Comisiones Personales	Suma de la utilidad de tus OC tipo Ejecutivo y Común, ya prorrateada.
Compartidas	Suma de la utilidad de tus OC tipo Compartida, dividida entre los dos ejecutivos que la comparten.
Comunes	Utilidad de las OC tipo Común, repartida entre el total de usuarios con perfil «executive» activos en la empresa.
Total Comisiones	Personales + Compartidas + Comunes ya prorrateadas.
Factor calculado	El porcentaje del tramo que te corresponde según el Total Comisiones (ver Cómo se calcula).
Total a pagar	Total Comisiones × Factor / 100. Nunca queda negativo: si diera menos que 0, se muestra $0.

La tabla Detalle OCs, columna por columna

Columna	Qué muestra
Fecha / OC	Fecha de la orden y su número, con enlace a la ficha de la OC de Convenio (`/company/:companyId/oc-convenio/:id`).
Tipo	Insignia de color con el tipo de OC — ver la tabla de tipos más abajo. Pasa el mouse por encima para leer qué reparto le corresponde.
Total Venta	El `TotalNeto` de la OC.
Total Facturado	Suma de las facturas (tipo 33) menos las notas de crédito (tipo 61) vinculadas a esa OC. $0 si todavía no se ha facturado.
Total Gastos	Lo gastado en OC de Proveedor asociadas a esta OC (sólo las que están Aprobadas o Recepcionadas), con el % de margen resultante debajo.
Desc. Transporte	El descuento por transporte aplicado. Trae la insignia Personalizado cuando alguien lo ajustó a mano en Pago de Comisiones, en vez del porcentaje configurado por la empresa.
Ajuste	Un monto manual, positivo (verde) o negativo (rojo), con la misma insignia Personalizado cuando existe.
Utilidad Original	Total Venta − Total Gastos − Desc. Transporte − Descuentos de la OC + Ajuste.
Utilidad Comisionable	La utilidad ya ajustada según el tipo de OC: completa en las Ejecutivo y Común, la mitad en las Compartidas, $0 en las de Empresa.

Los cuatro tipos de OC

Tipo	Insignia	Reparto
Ejecutivo	Azul	100% del margen para el ejecutivo asignado.
Compartida	Celeste	50% empresa, 50% ejecutivo.
Común	Amarilla	Distribuida entre todos los ejecutivos activos de la empresa.
Empresa	Verde	100% para la empresa: no genera comisión para nadie.

Cómo se calcula

Todo el cálculo ocurre en el servidor, en la función processMyCommissions (functions/src/mercadopublico_api/processMyCommissions.function.ts, apoyada en functions/src/services/commissions.service.ts). La pantalla sólo pinta el resultado.

Qué OC entran. Las de ocConvenios donde tu id figura en executive.id, y que además fueron creadas dentro del mes elegido o tienen su campo period igual a ese mes. Quedan fuera las OC en estado Cancelada, No Aceptada por Proveedor y No aceptada.
La utilidad de cada OC se calcula neta de IVA (si el TotalNeto guardado viene bruto, se corrige dividiendo por 1,19), menos los gastos de las OC de Proveedor asociadas, menos el descuento de transporte, menos los descuentos propios de la OC, más el ajuste manual si lo hay.
El descuento de transporte es, por defecto de fábrica, un 3% del total neto de la OC — cada empresa puede definir otro porcentaje, o desactivarlo, desde Configuración de Comisiones.
El factor final sale de tramos por utilidad total del mes, también configurables por empresa. Los de fábrica: $0–$2.000.000 → 0%, hasta $4.000.000 → 2%, hasta $6.000.000 → 4%, hasta $8.000.000 → 6%, hasta $10.000.000 → 8%, de ahí hacia arriba → 10%. Si la empresa nunca configuró sus propios tramos, usa estos.

Los ajustes se editan en otra pantalla Los descuentos de transporte y ajustes «Personalizados» que ves aquí sólo se pueden crear o cambiar desde Pago de Comisiones, la pantalla de Manager. Mis Comisiones únicamente los muestra.

Lo que todavía no hace

La documentación funcional de Marko (docs/01-ventas/10-mis-comisiones.md) describe varias cosas que esta pantalla, verificada contra el código, no tiene todavía. Para que no las esperes:

No hay gráfico de evolución. Ni gráfico mensual, ni comparativa con períodos anteriores, ni con otros ejecutivos: sólo las dos tablas y el detalle del mes elegido.
No se filtra ni se busca dentro del resultado. No hay filtro por estado, por cliente ni por OC, ni buscador de texto: el único control es el selector de mes.
No exporta a PDF ni envía por correo. La única salida es el botón Exportar a Excel.
No avisa de nada. No hay notificación de «comisión generada», «aprobada para pago» ni «pago realizado»: para enterarte tienes que entrar y elegir el mes.
No dice si ya te pagaron. Esta pantalla es sólo el cálculo del mes; el estado de pago y su registro viven en Pago de Comisiones, que no gestiona el Ejecutivo.
No hay gamificación. Sin badges, sin ranking, sin potencial adicional por meta: eso sólo está descrito en el documento funcional, no en el código.
No se recalcula sola. Si después de consultar un mes se aprueba un ajuste o se factura una OC, el número no cambia solo: hay que volver a elegir el mes o pulsar Procesar mes.
No hay forma de reclamar desde aquí. Si una cifra no cuadra, no existe un botón de disputa: hay que conversarlo fuera de Marko con quien gestione Pago de Comisiones.

Cuando algo no sale

Lo que ves	Qué pasa
«No se encontraron comisiones»	No tienes ninguna OC como ejecutivo asignado en ese mes. No es un error: es el resultado real de un mes sin OC propias.
«Procesando comisiones…» que no termina	El cálculo recorre cada OC del mes y sus gastos y facturas asociadas uno por uno; con muchas OC puede tardar. Espera a que aparezca el resultado antes de cambiar de mes otra vez.
«No tienes permisos para realizar esta acción»	La función devolvió el código `unauthenticated`. Cierra sesión y vuelve a entrar.
«Error interno del servidor»	La función devolvió el código `internal`. Reintenta con Procesar mes; si persiste, es un problema del lado del servidor, no de tus datos.
El botón Exportar a Excel está apagado	No hay resultado que exportar todavía — o el mes no tiene comisiones, o el cálculo sigue en curso.