Diferencias

Muestra las diferencias entre dos versiones de la página.

--- a:finance:billing:receipt_search [2026/09/14 23:40]
wiki: a:finance:billing:receipt_search gana la sección del icono Imprimir (panel de Opciones con casillas por bloque, cabecera Fecha de creación/Elaboró, panel de Totales y el aviso de que la impresión no es automática) (+1 mejoras más de la corrida), algebraix
+++ a:finance:billing:receipt_search [2026/09/15 06:40] (actual)
wiki: a:finance:billing:receipt_search profundiza "Ver detalles de factura o recibo" con los campos reales del panel (folio, cliente, forma de pago, fechas, datos fiscales y de mensualidades), el bloque de cancelación con sus estados, los avisos de RFC facturado a otro y de folio ligado a factura global, los botones Modificar/Cancelar/Notas de crédito, y los paneles Documentos relacionados y Contenido (con el desglose de descuentos y pagos aplicados por cobro); también se agregó a Permisos el grant "Detalle de factura o recibo" (ADMINISTRACIÓN DE FOLIOS) que en realidad abre esta pantalla — el artículo solo tenía citado el de FACTURACIÓN ELECTRÓNICA, que es el de folios privados., algebraix
@@ Línea 119: / Línea 119: @@
 ===== Ver detalles de factura o recibo =====
 <notes>También se conoce como imprimir recibo, folio, factura.</notes>
 Si necesitas visualizar los detalles de una factura o recibo, sigue estos pasos:
   - Realiza la **búsqueda de folios** según los criterios deseados.
   - Haz clic en el **número de folio** correspondiente para consultar los detalles de la factura o recibo.
-  - Desde la vista de detalles, podrás realizar diversas acciones según sea necesario:
+  - En el panel izquierdo, **Detalles de factura o recibo**, encontrarás:
-      * Visualizar información general, como quién creó el folio, forma de pago, total, entre otros.
+      * **Número de folio**, **Nombre del cliente** (con enlace a su ficha si es un padre de familia dado de alta), **Creado por** y **Notas**, si el folio las tiene capturadas.
-      * Modificar el folio. <notes>También se conoce como facturar al papá un folio que no se pudo en su momento.</notes>
+      * **Forma de pago** y, si el pago se hizo en línea, el **Número de autorización**. <notes>Si el saldo se pagó con saldo a favor de otro folio, junto a la forma de pago aparece un ícono de cartera con el mensaje "Pagado con saldo a favor del folio {1}" (o el plural si vienen de varios folios).</notes>
-      * Realizar devoluciones.
+      * **Fecha de creación** y **Fecha de folio**.
-      * Generar notas de crédito.
+      * Si el folio corresponde a una factura electrónica: **Fecha de factura electrónica**, **Folio fiscal**, **RFC emisor** (si se facturó con datos fiscales distintos a los del colegio), **RFC receptor**, **Tipo de documento** y **Tipo de factura**; si la factura permite meses sin intereses, también **Meses sin intereses**.
-      * Imprimir la factura o recibo.
+      * Si el folio ya está confirmado como pagado: **Fecha de confirmación de pago**, **Forma de pago** y, si aplica, **Dígitos de forma de pago**.
-      * Cancelar la factura o recibo.
+      * Si el folio tiene una factura de uso interno relacionada, se agrega **Número de folio** y **Folio fiscal** "de factura global" (o "de factura" según el caso), con enlace al detalle de esa factura de uso interno.
+      * Si la factura se pagó en mensualidades, se muestra **Pagos en mensualidades** con el número de meses.
+  - **IMPORTANTE:** si el folio se facturó a un RFC distinto al que tiene registrado el cliente por motivos fiscales, arriba del panel aparece el aviso "Por motivos fiscales, el recibo de pago fue facturado a" seguido del nombre y RFC utilizados.
+  - Si el folio está cancelado o tiene una cancelación en trámite, el panel agrega en su lugar:
+      * **Estado de folio**, con el texto "Cancelado", o bien un ícono que indica que la cancelación está pendiente de sustitución o de vencimiento del plazo, según el motivo.
+      * **Usuario que canceló**, **Fecha de solicitud de cancelación** y, si ya se completó, **Fecha de cancelación**.
+      * **Motivo de cancelación**; si el motivo corresponde a un error de captura del folio, además **Número de folio de sustitución** (con enlace al folio que lo sustituye, o "No registrado" si aún no se ha capturado) y **Folio fiscal** de esa sustitución.
+      * **Notas de cancelación**, si están registradas.
+      * **Estado de cancelación**, con el ícono y el texto "Cancelación confirmada", "Cancelación no confirmada, consulte al administrador" o "En proceso de confirmación", según el avance de la cancelación ante el SAT.
+  - **Nota:** si el folio no puede eliminarse ni modificarse por estar relacionado a una factura global, arriba del panel aparece el aviso "El folio no se puede eliminar/modificar porque está relacionado a una factura global. Para poder hacer modificaciones, primero se debe cancelar la factura global."; en ese caso el botón **Modificar** aparece deshabilitado.
+  - Debajo de la información general se muestra el resumen de montos: **Sub-total**, el desglose de **IVA** (por cada porcentaje aplicado, si el folio combina varios) y **Total**.
+  - En la parte superior del panel encontrarás, según el tipo de folio y su estado:
+      * **Descargar factura electrónica en formato XML**, si el folio es una factura electrónica.
+      * **Imprimir**.
+  - Si el folio está activo, en la parte inferior del panel encontrarás:
+      * El botón **Modificar** para editar el folio. <notes>También se conoce como facturar al papá un folio que no se pudo en su momento.</notes>
+      * El ícono para **Cancelar** el folio; no aparece si el folio ya tiene una cancelación pendiente sin confirmar, o si fue emitido por Mattilda (esa cancelación la realiza Mattilda).
+      * Si el folio es una factura electrónica activa que no está ligada a un pago ni es de Mattilda, un menú de **Notas de crédito** con las opciones **Agregar nota de crédito** y consultar las ya generadas.
+  - Si el folio no permite devoluciones, el sistema no muestra la pestaña de **Devoluciones**; cuando sí la muestra, se documenta como tarea aparte.
+  - Cuando el folio tiene documentos relacionados (por ejemplo, la factura que lo sustituyó, sus complementos de pago o los folios de la misma familia de facturación electrónica), se agrega el panel **Documentos relacionados** con la lista de folios (número de folio, tipo de documento y folio fiscal) y, junto a cada uno, los íconos para **Imprimir** y descargar su XML.
+  - Cuando el folio tiene conceptos, se agrega el panel **Contenido** con la lista de cobros incluidos:
+      * Cada renglón muestra el concepto (con enlace al detalle del cobro), el estudiante y su grupo, y el saldo pendiente de ese cobro; un ícono verde indica que el cobro ya quedó saldado y uno rojo que aún tiene saldo.
+      * Si el cobro ya tiene pagos aplicados, puedes desplegar el renglón para ver el desglose: **Monto original**, **Descuentos** (con las notas del descuento, si las tiene), **Total a pagar**, cada **Pago recibido** (con la cuenta de banco, la fecha y el número de folio del pago, con enlace a su detalle) y, si aplica, **Recargo**.
 {{:a:finance:billing:ver_folio.png?direct&600|}}
+<notes>FALTA_CAPTURA — pantalla: Búsqueda de folios → Resultados de la búsqueda de folios → Ver detalles de factura o recibo; mostrar: el panel izquierdo Detalles de factura o recibo con el resumen de montos y los botones Modificar/Cancelar, junto a los paneles Documentos relacionados y Contenido a la derecha; archivo sugerido: :a:finance:billing:detalle_folio_publico.jpg</notes>
+===== Ver detalles de un folio privado =====
+<notes>Folio privado: el que se genera para un cliente que no es un estudiante o padre de familia dado de alta en la plataforma (por ejemplo, facturación a terceros). Al filtrar por Folios privados en la búsqueda de folios, el número de folio abre esta vista, distinta de la de un folio público.</notes>
+Si el folio que consultas es de tipo **Folios privados**, la vista de detalle es distinta a la de un folio público:
+  - Realiza la **búsqueda de folios** con el filtro **Folios privados** activo, o localiza el folio con cualquier otro criterio de búsqueda.
+  - Haz clic en el **número de folio** correspondiente. La pantalla abre con el encabezado **Detalles de factura de uso interno**.
+  - En el panel de la izquierda encontrarás la información general del folio:
+      * **Número de folio**, **Nombre del cliente**, **RFC del cliente** y **Creado por**.
+      * **Notas**, si el folio las tiene capturadas.
+      * **Forma de pago** y, si aplica, **Tipo de documento**.
+      * **Información global**, si el folio es de tipo global (muestra periodicidad, meses y año).
+      * **Método de pago**, si el folio maneja parcialidades.
+      * **Fecha de creación**, **Fecha de folio**, **Fecha de factura electrónica** y **Folio fiscal**.
+      * **RFC emisor**, si el folio se emitió con datos fiscales distintos a los del colegio.
+      * **Clave de servicio**, si el folio tiene una asignada.
+  - Si el folio está cancelado, el panel agrega:
+      * El estado **Cancelados** y el **Usuario que canceló**.
+      * **Fecha de solicitud de cancelación** y **Fecha de cancelación**, si están registradas.
+      * **Motivo de cancelación**, si está registrado.
+      * Si el motivo de cancelación corresponde a un error de captura, además se muestran **Número de folio de sustitución** (enlaza al folio que lo sustituye, o "No registrado" si aún no se ha capturado) y **Folio de sustitución** (el folio fiscal del documento que lo sustituye, o "No registrado").
+      * **Notas de cancelación**, si están registradas.
+      * **Estado de cancelación**, con el ícono y el texto "Cancelación confirmada", "Cancelación no confirmada, consulte al administrador" o "En proceso de confirmación", según el avance de la cancelación ante el SAT.
+  - Debajo de la información general se muestra el resumen de montos: **Sub-total**, **IVA**, **R.IVA** (si el folio tiene retención) y **Total**.
+  - En el panel de la derecha, **Contenido**, se muestra la tabla de conceptos del folio con **Cantidad**, **Concepto**, **Precio**, **IVA** y **Total**; si el folio incluye conceptos con identificación, se agrega la columna **No Identificación**, que enlaza al folio público relacionado con ese concepto.
+  - En la parte superior del panel de información general encontrarás las siguientes acciones:
+      * Descargar factura electrónica en formato XML.
+      * Imprimir.
+      * Enviar factura por correo: abre un formulario para capturar el **Correo electrónico** del destinatario; al dar clic en **Enviar** se manda el folio y aparece el aviso "Se envió correo electrónico"; si el correo capturado no tiene un formato válido, aparece el aviso "E-Mail inválido." y no se envía.
+  - Si el folio está activo, no tiene una cancelación pendiente y no fue emitido por Mattilda, también encontrarás el ícono para cancelarlo:
+      * Si el folio tiene un documento relacionado activo, al dar clic aparece el aviso "Este folio tiene un documento relacionado, es necesario cancelarlo antes de poder cancelar el folio." y la cancelación no continúa.
+      * De lo contrario se abre una ventana de **Confirmación** que pregunta si deseas cancelar el folio; selecciona un **Motivo de cancelación** de la lista y da clic en **Confirmar**. Si no seleccionas un motivo, el botón **Confirmar** permanece deshabilitado y, si de cualquier forma intentas continuar, aparece el aviso "Motivo de cancelación inválido".
+  - **Nota:** los folios emitidos por Mattilda no muestran la opción para cancelarlos; esa cancelación la realiza Mattilda.
+<notes>FALTA_CAPTURA — pantalla: Búsqueda de folios → Resultados de la búsqueda de folios → folio privado → Detalles de factura de uso interno; mostrar: el panel izquierdo con la información general y el resumen de montos junto al panel Contenido con la tabla de conceptos; archivo sugerido: :a:finance:billing:detalle_folio_privado.jpg</notes>
 ===== 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:
+Para que el operador pueda realizar estas configuraciones, es necesario asignarle los siguientes permisos al momento de agregarlo o modificar su perfil:
     * Desde "Permisos globales" > **Colegiatura** > ADMINISTRACIÓN DE FOLIOS.
       * **Búsqueda de folios:** Permite hacer la búsqueda de los folios generados.
+      * **Detalle de factura o recibo:** Permite consultar el detalle de una factura o recibo público.
+    * Desde "Permisos globales" > **Colegiatura** > FACTURACIÓN ELECTRÓNICA.
+      * **Detalles facturación electrónica:** Permite consultar y, en el caso de un folio privado, imprimir el detalle de una factura o recibo.
+      * **Descargas facturación electrónica:** Permite descargar el XML de la factura electrónica desde su detalle.
+      * **Eliminar facturación electrónica:** Permite cancelar un folio privado desde su detalle.
+El administrador de la escuela consulta el detalle de un folio público sin necesidad de que se le asigne ningún permiso. Cualquier operador, tenga o no estos permisos asignados, puede enviar por correo electrónico un folio privado desde su detalle.
 <notes>REVISION_PENDIENTE — redactado por el canal automático y publicado sin revisión de un segundo lector. Para revisarlo: ARTICULOS="a:finance:billing:receipt_search" make -C pipeline revisar</notes>