====== Conciliación de pagos recurrentes con tarjeta ======

La conciliación de pagos es el proceso de verificación y comparación entre los pagos registrados en un sistema interno y los pagos realmente realizados por los usuarios, ya sea a través de bancos, plataformas de pago o recibos físicos. La conciliación de pagos recurrentes con tarjeta en Algebraix tiene como propósito principal asegurar que los cargos automáticos realizados a las tarjetas de los usuarios (padres de familia o estudiantes con supervisión propia) se hayan ejecutado correctamente y que cada transacción esté debidamente reflejada y registrada en el sistema.


===== Consultar conciliación =====

  -Accede a **Panel de control** y selecciona la opción **Pagos recurrentes con tarjeta**.
  -Luego haz clic en la pestaña **Conciliación** y selecciona la opción **Conciliación**. **Nota**: si tu escuela tiene configurado un servicio con American Express, esta misma pestaña ofrece además la opción **Conciliación AMEX**, que muestra la conciliación exclusivamente de esos servicios.
  -En el panel **Búsqueda entre fechas** puedes acotar la consulta ingresando **Inicio** y **Fin** y dando clic en **Buscar**. **Nota**: Si no aplicas ningún filtro de fechas, se mostrará el registro del mes en curso, y podrás avanzar o retroceder de mes con las flechas junto al título **Registro de archivos cargados**; esas flechas desaparecen en cuanto filtras por fechas.
  -Si no se ha cargado ningún archivo de conciliación, verás el aviso "No se han cargado archivos de conciliación"; si filtraste por fechas y no hay resultados en ese rango, el aviso es "No se encontraron archivos de conciliación".
  -Cuando hay archivos cargados, se muestra el panel **Pagos confirmados** con una tabla, un renglón por archivo cargado, con las columnas:
    ***(icono sin etiqueta):** indica en verde o rojo si el archivo tiene **Pagos pendientes** por resolver.
    ***Fecha:** la fecha en que se cargó el archivo; da clic sobre ella para ver el detalle de los pagos de ese archivo.
    ***Servicio:** el servicio de pagos recurrentes con tarjeta al que corresponde.
    ***Pagos registrados:** cuántos pagos trae el archivo.
    ***Pago(s) confirmado(s):** cuántos de esos pagos ya fueron confirmados. **Nota**: no todo pago registrado llega a confirmarse.
    ***Total de pagos:** el monto total de los pagos del archivo.
    -Si el servicio reporta depósito, se agregan además **Monto de comisión**, **IVA** y **Depósito** por archivo.
  -Puedes descargar esta tabla dando clic en el icono **Descargar a Microsoft Excel**.

===== Detalle del registro del día =====

Al dar clic sobre una fecha en **Consultar conciliación** entras al detalle de los pagos de ese archivo.

  -En la esquina superior derecha puedes descargar los datos con los iconos **Descargar a Microsoft Excel** y **Descargar archivo de conciliación**.
  -A la izquierda se muestra un panel con la fecha del archivo y la leyenda **Registro del día**, seguido del conteo de **Total de pagos**, **Pagos confirmados**, **Pagos registrados**, **Pagos pendientes**, **Pagos incompletos**, **Pagos no registrados** y **Pagos eliminados**; los conteos de pendientes, incompletos y no registrados se marcan en rojo cuando son mayores a cero.
  -Si el servicio tiene comisión configurada, el mismo panel agrega **Depósito**, **Monto de comisión**, **IVA** y **Total**, y si hay pagos cancelados en el archivo, también **Devoluciones**.
  -**Nota:** si hay pagos de otros procesos de cobro sin actualizar, verás el aviso "Existen pagos de procesos sin actualizar" con un enlace al detalle de ese proceso.
  -Cuando hay pagos confirmados, se muestra el panel **Folios relacionados** (solo si alguno de los folios generados tiene comprobantes fiscales relacionados) con la tabla **Fecha**, **Usuario**, **Folio** y **Monto**; y el panel **Pagos confirmados**, con una tabla que indica con un icono si el pago cuadra con el monto esperado, y las columnas **Fecha**, **Usuario**, **Razón social**, **Folios**, **Folios relacionados**, **Monto de comisión**, **IVA comisión** y **Monto**. **Nota:** si un pago fue cancelado se marca con el aviso "Existe una devolución para este pago" junto a la fecha, y si su folio debe cancelarse, el folio se muestra en rojo con el aviso "Este folio debe ser cancelado".
  -Cuando hay pagos registrados pendientes de confirmar, se muestra el panel **Pagos registrados** con una casilla por fila (y una casilla en el encabezado para marcarlas todas); selecciona las que quieras confirmar y haz clic en **Aceptar**.
  -Cuando hay pagos pendientes, incompletos o no registrados, se muestran sus paneles correspondientes (ver las secciones **Pagos pendientes** y **Pagos incompletos** de este artículo); el panel **Pagos no registrados** solo lista **Fecha**, **Monto de comisión**, **IVA comisión** y **Monto**, sin ninguna acción disponible.
  -Cuando hay pagos eliminados, se muestra el panel **Pagos eliminados** con las columnas **Fecha**, **Usuario**, **Folios**, **Monto de comisión**, **IVA comisión** y **Monto**.

<notes>FALTA_CAPTURA — pantalla: Pagos recurrentes con tarjeta → Conciliación → Consultar conciliación → [fecha]; mostrar: el panel lateral de conteos (Registro del día) junto con el panel Pagos confirmados de la derecha; archivo sugerido: :a:finance:charges:detalle_registro_del_dia.png</notes>

===== Imprimir estado de cuenta =====

Cuando consultas la conciliación de un mes completo que ya terminó (sin aplicar el filtro de fechas y sin ser el mes en curso), puedes generar un estado de cuenta imprimible por servicio.

  -Accede a **Panel de control** y selecciona la opción **Pagos recurrentes con tarjeta**.
  -Luego haz clic en la pestaña **Conciliación** y selecciona la opción **Conciliación**, sin aplicar ningún filtro de fechas y consultando un mes ya terminado.
  -En el panel **Pagos confirmados** aparecerá el icono **Imprimir**. **Nota**: este icono solo aparece si el mes consultado ya cerró; si consultas por rango de fechas o el mes en curso, no está disponible.
  -Si un solo servicio tiene pagos ese mes, da clic en el icono **Imprimir** y se abrirá directamente su estado de cuenta.
  -Si hay más de un servicio con pagos ese mes, da clic en el icono **Imprimir** para desplegar la lista de servicios y selecciona el que corresponda.
  -El estado de cuenta muestra el nombre y RFC de tu escuela, el **Periodo** y el **Servicio**, y una tabla con las columnas **Fecha**, **Pagos reg.**, **Monto bruto**, **Comisión**, **IVA** y **Monto neto** por cada fecha con pagos.
  -Al final se presentan los totales de comisión del periodo: subtotal, **IVA** y **Total a facturar**, junto con la **Fecha de generación** del documento.

<notes>FALTA_CAPTURA — pantalla: Pagos recurrentes con tarjeta → Conciliación → Consultar conciliación (mes cerrado) → icono Imprimir; mostrar: el panel Pagos confirmados con el icono Imprimir visible en la barra de acciones; archivo sugerido: :a:finance:charges:conciliacion_icono_imprimir.png</notes>

<notes>FALTA_CAPTURA — pantalla: Pagos recurrentes con tarjeta → Conciliación → Estado de cuenta impreso; mostrar: el estado de cuenta completo con encabezado, tabla de fechas y totales de comisión; archivo sugerido: :a:finance:charges:estado_de_cuenta_conciliacion.png</notes>

===== Cargar archivo de conciliación =====

Algunos servicios de pagos recurrentes con tarjeta no comparten sus pagos automáticamente con Algebraix; para esos, el desglose de pagos se sube desde aquí.

  -Accede a **Panel de control** y selecciona la opción **Pagos recurrentes con tarjeta**.
  -Luego haz clic en la pestaña **Conciliación** y selecciona la opción **Cargar archivo de conciliación**.
  -Selecciona el **Servicio** al que corresponde la conciliación.
  -Si no hay ningún servicio disponible para cargar un archivo, verás el aviso "No se ha registrado ningún servicio de pagos recurrentes con soporte para conciliación fuera de línea".
  -Según el **Servicio** elegido, la pantalla te pide uno de estos dos datos:
    *Si el proveedor del servicio trae los pagos automáticamente por internet, se muestra el campo **Fecha**: indica el día de los pagos a conciliar.
    *En cualquier otro caso, se muestra el control **Archivo**: selecciona el archivo con el desglose de pagos. **Nota**: solo se aceptan archivos de texto plano o Excel.
  -Da clic en **Procesar** para cargar la información.
  -Si el archivo se cargó correctamente, verás el aviso "Archivo de conciliación cargado, se registraron **{cantidad}** pagos". **Nota**: Si no se registró ningún pago para el servicio elegido, el aviso indica "No se encontraron pagos correspondientes al servicio **{servicio}**".

<notes>FALTA_CAPTURA — pantalla: Pagos recurrentes con tarjeta → Conciliación → Cargar archivo de conciliación; mostrar: el formulario con el campo Servicio, y el estado del formulario tras elegir un servicio que pide Archivo; archivo sugerido: :a:finance:charges:cargar_archivo_conciliacion.png</notes>

===== Buscar por pagos =====

A diferencia de **Consultar conciliación**, que lista archivos cargados, esta opción busca directamente por los pagos registrados de un servicio en un rango de fechas.

  -Accede a **Panel de control** y selecciona la opción **Pagos recurrentes con tarjeta**.
  -Luego haz clic en la pestaña **Conciliación** y selecciona la opción **Búsqueda de pagos**.
  -En el panel **Búsqueda entre fechas** completa los tres campos:
    ***Inicio:** la fecha desde la que quieres buscar.
    ***Fin:** la fecha hasta la que quieres buscar.
    ***Servicio:** el servicio de pagos recurrentes con tarjeta a consultar. **Nota**: solo se listan los servicios que tienen soporte para conciliación fuera de línea; si tu escuela no tiene ninguno registrado, verás el aviso "No se ha registrado ningún servicio de pagos recurrentes con soporte para conciliación fuera de línea".
  -Da clic en **Buscar**.
  -Si no hay pagos confirmados en ese rango para el servicio elegido, verás el aviso "No se han encontrado pagos confirmados".
  -Cuando hay resultados, se muestra el panel **Pagos confirmados** con una tabla, un renglón por pago, con las columnas **Fecha**, **Usuario**, **Razón social**, **Folios**, **Folios relacionados**, **Monto de comisión**, **IVA comisión** y **Monto**; puedes descargarla dando clic en el icono **Descargar a Microsoft Excel**.
  -Si además hay pagos del rango que aún no se han conciliado, se muestra el panel **Pagos pendientes** con una tabla con las columnas **Fecha de pago**, **Servicio**, **Usuario**, **Razón social**, **Folios**, **Folios relacionados**, **Forma de pago** y **Monto**.

<notes>FALTA_CAPTURA — pantalla: Pagos recurrentes con tarjeta → Conciliación → Búsqueda de pagos, con resultados; mostrar: el panel Búsqueda entre fechas con los tres campos llenos y, debajo, los paneles Pagos confirmados y Pagos pendientes con al menos un renglón cada uno; archivo sugerido: :a:finance:charges:busqueda_de_pagos.png</notes>

===== Pagos pendientes =====

Cuando se detecte un pago pendiente, este aparecerá en una tabla con diferentes opciones para que puedas gestionarlo adecuadamente:
  ***Pago cancelado**: Esta opción permite anular un pago. Una vez cancelado, el movimiento se traslada a la tabla de Pagos confirmados, donde se mostrará con el estatus "Cancelado", manteniendo un historial claro y actualizado del registro.
  ***Aplicar pago**: Se genera el folio correspondiente al concepto que originalmente se intentaba pagar.
  ***Conciliar con folio existente**: Asocia el pago con un folio ya registrado del estudiante identificado, siempre que coincidan el monto y la fecha.
Si Algebraix no logra vincular la información del pago con ningún concepto o estudiante, no se mostrará ninguna opción de conciliación.

===== Pagos incompletos =====

Cuando se detecte un pago incompleto, este aparecerá en una tabla con diferentes opciones para que puedas gestionarlo adecuadamente:
  ***Pago cancelado**: Esta opción permite anular un pago. Una vez cancelado, el movimiento se traslada a la tabla de Pagos confirmados, donde se mostrará con el estatus "Cancelado", manteniendo un historial claro y actualizado del registro.
  ***Aplicar pago**: Se genera el folio correspondiente al concepto que originalmente se intentaba pagar.
  ***Pagar cobro existente**: Te permitirá seleccionar un cargo pendiente en el estado de cuenta del estudiante que coincida con el monto recibido.
  ***Conciliar con folio existente**: Asocia el pago con un folio ya registrado del estudiante identificado, siempre que coincidan el monto y la fecha.
Si Algebraix no logra vincular la información del pago con ningún concepto o estudiante, no se mostrará ninguna opción de conciliación.


==== Eliminar registro del día ====

**Nota:** eliminar un registro del día es una acción exclusiva de Algebraix; ni el administrador de tu escuela ni ningún operador pueden hacerlo, aunque tengan asignado el permiso de conciliación.

En el detalle de un registro del día (ver **Detalle del registro del día**), Algebraix puede hacer clic en el botón **Eliminar registro** para eliminarlo; se le preguntará "¿ Está seguro que desea eliminar el registro de pagos recurrentes ?".

===== Tipos de pagos =====

  ***Confirmados**: Transacciones recibidas y procesadas correctamente, sin errores.
  ***Registrados**:Transacciones ingresadas manualmente por medio del importe.
  ***Pendientes**:Transacciones aplicadas que aún requieren validación para confirmar si fueron aprobadas o rechazadas.
  ***Incompletos**:Transacciones aplicadas al usuario, pero de las cuales no se ha recibido notificación.
  ***No registrado**:Transacciones que se han recibido, pero no se encuentran en los registros del sistema.
  ***Eliminado**:Transacciones que han sido canceladas o removidas de los registros por alguna razón.
===== Permisos para el operador =====
Para que el operador pueda realizar estas configuraciones, es necesario asignarle el siguiente permiso al momento de agregarlo o modificar su perfil:
    * Desde "Permisos globales" > **Colegiatura** > PAGOS RECURRENTES CON TARJETA.
      * **Conciliación:** Permite revisar la conciliación del servicio de pagos recurrentes con tarjeta, incluida la impresión del estado de cuenta.
El administrador de la escuela consulta estas pantallas sin necesidad de asignarle ningún permiso.
<notes>REVISION_PENDIENTE — redactado por el canal automático y publicado sin revisión de un segundo lector. Para revisarlo: ARTICULOS="a:finance:charges:reconciliation_of_recurring_card_payments" make -C pipeline revisar</notes>