Canales externos (reporte)

Ruta: /reportes/canales Quién la usa: dueño y gerente Permiso requerido: reports.view (y además reports.cashier para registrar liquidaciones) Capturas: docs/manual/screenshots/reportes/

Qué es

El reporte de las plataformas de pedidos: cuánto se vendió por cada una, cuánta comisión estimó el sistema al cobrar, y cuánto pagó realmente la plataforma según su estado de cuenta. Trae una tarjeta por plataforma, la venta bruta por día, la tabla Estimado vs. real y el formulario Registrar liquidación.

Cuándo se usa

Dos momentos distintos. Durante la semana, para ver cuánto se está yendo en comisiones. Y cuando llega el pago de la plataforma —normalmente semanal—, para capturar el estado de cuenta y comprobar que el depósito calza con lo que el sistema esperaba cobrar.

Paso a paso

Desde Analytics, bloque Reportes detallados, presione Canales externos. Entra con el preajuste Este mes.
Ajuste el rango con los preajustes o con las dos fechas + Aplicar.
Lea la tarjeta de cada plataforma. En frankies-sim, PedidosYa: Pedidos 1, Venta bruta $40.13, Comisiones est. $4.29, Neto est. $35.84. Uber Eats y ASAP aparecen igual, en ceros, aunque no tengan contrato cargado.
Revise Venta bruta por día para ubicar el día del movimiento.
Revise Estimado vs. real. Mientras no haya cargado ningún estado de cuenta, la tabla dice «Sin liquidaciones registradas en este periodo.».
Para cargar el estado de cuenta, baje a Registrar liquidación. Elija la Plataforma y confirme Periodo desde / Periodo hasta (entran con la última semana completa de lunes a domingo).
Copie del Partner Portal los montos: Bruto, Comisión, Otras deducciones, ITBMS y Payout; agregue Notas (opcional) si el pago trae un ajuste.
Presione Guardar liquidación. La fila aparece en Estimado vs. real con su Diferencia: en rojo cuando la plataforma pagó menos de lo estimado (falta por cobrar) y en verde cuando pagó más.

Campos y botones

Campo/Botón	Qué hace	Notas
← Reportes	Vuelve a `/reportes`	—
Preajustes de rango + fechas + Aplicar	Fijan el periodo	Los mismos siete preajustes de Analytics
Pedidos · Venta bruta	Pedidos y venta de esa plataforma en el rango	Un pedido reembolsado deja de contar aquí
Comisiones est.	Comisión + fee + cargo fijo + ITBMS que calculó el sistema al cobrar	Sale del contrato cargado en Ajustes → Canales externos
Neto est.	Venta bruta − comisiones estimadas	Es lo que se espera recibir
«N pedido(s) sin estimado»	Aviso con enlace a Ajustes → Canales externos	Solo aparece cuando hay pedidos de plataforma sin contrato que los cubra; en la simulación no salió
Venta bruta por día	Barras por día del rango	Todas las plataformas juntas
Estimado vs. real	Compara cada liquidación con el estimado de su propio periodo	Bruto est. · Bruto real · Deducciones est. · Deducciones reales · Payout real · Diferencia
Diferencia	Neto estimado − payout real	Rojo = pagaron de menos; verde = pagaron de más
Plataforma · Periodo desde · Periodo hasta	Identifican la liquidación	Guardar con el mismo periodo corrige la anterior
Bruto · Comisión · Otras deducciones · ITBMS · Payout (B/.)	Los montos del estado de cuenta	Se dejan en 0 si vienen vacíos
Notas (opcional)	Respaldo del pago	Texto libre
Guardar liquidación	Guarda o corrige la liquidación del periodo	Requiere `reports.cashier`

Lo que la pantalla no hace: no descarga nada de la plataforma —los montos se copian a mano del Partner Portal—, no borra una liquidación ya guardada (solo se corrige guardando el mismo periodo otra vez) y no cambia el contrato: para eso está Ajustes → Canales externos. Nótese que las cifras de arriba se muestran con $ mientras el formulario rotula los montos con (B/.): es la misma moneda.

Mensajes y errores

"Sin permiso." — es lo que ve un rol sin reports.view; el cajero de la simulación recibe exactamente este texto.

"No tienes sedes asignadas."

"No hay plataformas de marketplace configuradas."

"Sin liquidaciones registradas en este periodo."

"Elige una plataforma."

"Revisa el periodo (desde no puede ser posterior a hasta)."

"Revisa los montos ingresados."

"Liquidación guardada."

"No tienes permiso para esta acción." NG_FORBIDDEN — al guardar sin reports.cashier.

"Plataforma desconocida" NG_PROVIDER_UNKNOWN

"No se pudo guardar la liquidación." — respaldo cuando el servidor no devuelve un código conocido.

Un rol con reports.view pero sin reports.cashier ve el reporte completo y no ve el bloque «Registrar liquidación»: la pantalla no avisa que existe.