====== Artículos por ingreso ======
Consulta, para un rango de fechas, cuánto compraste y vendiste de cada artículo en venta, con el precio promedio y el monto total de cada operación.

===== Consultar Artículos por ingreso =====
  - Desde tu Panel de control, selecciona **Artículos en venta.**
  - Se despliega un menú con varias opciones; selecciona **Artículos por ingreso.**
  - En el panel **Búsqueda por fecha** captura:
    * **Inicio:** la fecha desde la que quieres consultar movimientos.
    * **Final:** la fecha hasta la que quieres consultarlos.
  - Da clic en **Aceptar.**
  - Se muestra el panel **Ventas** con una tabla de una fila por artículo, con las columnas:
    * **Nombre:** el nombre del artículo; da clic para ir a su detalle de ingresos en ese rango de fechas.
    * **Vendidos:** las piezas vendidas en el rango de fechas.
    * **Precio venta:** el precio promedio al que se vendió el artículo.
    * **Venta total:** el monto total vendido del artículo.
    * **Comprados:** las piezas compradas en el rango de fechas.
    * **Costo venta:** el costo promedio de compra del artículo.
    * **Costo total:** el monto total de compra del artículo.
  - La última fila, **Totales,** suma cada columna de piezas y de montos.
Si no se encuentra ningún artículo comprado o vendido entre las fechas capturadas, se muestra el aviso "No se han encontrado artículos comprados o vendidos entre las fechas especificadas" y no se despliega la tabla.

<notes>FALTA_CAPTURA — pantalla: Artículos en venta → Artículos por ingreso; mostrar: el panel de búsqueda por fecha capturado y la tabla de resultados con su fila de Totales; archivo sugerido: :a:finance:inventory:articulos_por_ingreso.png</notes>

===== Descargar la tabla =====
  - Con la tabla desplegada, da clic en el ícono {{icon>far fa-file-excel text-green}} para descargar el reporte completo a Excel.

===== Consultar el detalle de ingresos de un artículo =====
Al dar clic en el nombre de un artículo, tanto desde **Artículos por ingreso** como desde **Artículos por inventario**, se abre el detalle de ese artículo en el mismo rango de fechas que consultaste.
En la pestaña **General** se muestra un panel con la información del artículo (**Artículo**, y cuando aplique **Autor**, **Editorial**, **Año**, **Edición**, **Páginas**, **Código de barras**, **IVA** o **Exento**, **Clave de servicio IVA**, **Contracuenta clave de servicio IVA**, **Concepto SAT** y **Unidad SAT** para escuelas en México, y **Precio**) y, debajo, un segundo panel:
    * **Recibidos:** las piezas que se han agregado al inventario de este artículo.
    * **Cobrados:** las piezas vendidas cuyo cobro no está cancelado.
    * **Transferidos:** las piezas que se han trasladado a otro campus.
    * **Total en inventario:** las piezas que le quedan disponibles en inventario.
    * **Cancelados:** las piezas vendidas cuyo cobro sí está cancelado.
  - En **Opciones** se muestra si el artículo tiene marcado **Mostrar en 'Ingreso de pagos'**.
Debajo, según el movimiento del artículo, se muestran hasta tres paneles:
    * **Historial de inventario:** una tabla con **Proveedor**, **Cantidad** y **Fecha** por cada movimiento de alta de inventario; da clic en el proveedor para ver o modificar ese movimiento.
    * **Transferencia de campus:** una tabla con **Tipo** ("Entrada" o "Salida"), **Campus**, **Cantidad** y **Fecha** por cada traslado entre campus.
    * **Historial de ventas:** una tabla con **Comprador**, **Cantidad**, **Precio** y **Fecha y hora** por cada venta; las ventas canceladas se marcan con un ícono en la columna **Cancelados**.
Si el artículo no tiene movimientos de alguno de estos tipos, el panel correspondiente no se muestra.

<notes>FALTA_CAPTURA — pantalla: Artículos por ingreso → nombre de un artículo; mostrar: el panel General del artículo con Recibidos/Cobrados/Transferidos/Total en inventario/Cancelados y, debajo, los paneles Historial de inventario, Transferencia de campus e Historial de ventas; archivo sugerido: :a:finance:inventory:income_report_detalle.png</notes>

===== Permisos para el operador =====
Para que el operador pueda consultar esta pantalla, es necesario asignarle el siguiente permiso al momento de agregarlo o modificar su perfil:
    * Desde "Permisos globales" > **Estadísticas.**
      * **Operadores:** Permite consultar las estadísticas de Artículos por ingreso y de Artículos por inventario, además de las notas de los operadores.
El administrador de la escuela consulta esta pantalla sin necesidad de asignarle ningún permiso.
Una vez dentro del detalle de un artículo, cualquier operador puede consultarlo, sin necesidad de un permiso adicional.

<notes>REVISION_PENDIENTE — redactado por el canal automático y publicado sin revisión de un segundo lector. Para revisarlo: ARTICULOS="a:finance:inventory:income_report" make -C pipeline revisar</notes>