• Uso del Plugin EstadoCuentaClienteFS

Uso del Plugin EstadoCuentaClienteFS

Objetivo del plugin

EstadoCuentaClienteFS permite consultar el estado de cuenta de un cliente directamente desde su ficha en FacturaScripts, con posibilidad de:

• revisar saldos pendientes
• aplicar una fecha de corte
• ver resumen por antigüedad
• imprimir en PDF
• exportar a CSV o Excel
• enviar el estado de cuenta por correo

Dónde se usa

El plugin se usa desde la ficha del cliente:

1. Abre el menú de clientes en FacturaScripts.
2. Entra a la ficha del cliente que quieras consultar.
3. Haz clic en la pestaña Estado de cuenta.

Qué verás en la pestaña

La pestaña muestra varias zonas:

• cabecera del estado de cuenta
• filtro por Fecha de corte
• acciones agrupadas en Imprimir, Exportar y Email
• tarjetas con totales principales
• resumen por antigüedad
• detalle de documentos pendientes

Uso de la fecha de corte

La Fecha de corte sirve para reconstruir el estado de cuenta a una fecha específica.

Cómo usarla

1. Selecciona una fecha en el campo Fecha de corte.
2. Pulsa Aplicar fecha.
3. Revisa los resultados actualizados.

Cómo quitarla

1. Pulsa Quitar filtro.
2. El plugin volverá al comportamiento por defecto usando la fecha actual del sistema.

Qué efecto tiene

Con la fecha de corte:

• solo se consideran facturas emitidas hasta esa fecha
• solo se consideran recibos generados hasta esa fecha
• solo se aplican pagos registrados hasta esa fecha

Esto permite ver un corte histórico del cliente y no solo su estado actual.

Totales principales

La parte superior muestra tres indicadores:

• Documentos pendientes: Cantidad de documentos que aún tienen saldo pendiente.
• Total facturado: Suma del importe facturado de los documentos pendientes incluidos en el corte.
• Total pendiente: Saldo pendiente total según el corte aplicado.

Resumen por antigüedad

El resumen por antigüedad agrupa saldos pendientes por rangos de días.

Rangos usados:

• 0 - 30 días
• 31 - 60 días
• 61 - 90 días
• Más de 90 días

Cada rango muestra:

• documentos
• recibos
• saldo pendiente

Detalle de documentos

La parte detallada muestra los documentos incluidos en el estado de cuenta.

Dependiendo de la instalación, puede incluir:

• fecha
• documento o factura
• NCF/e-NCF
• importe facturado
• pagos aplicados
• saldo pendiente
• días de antigüedad
• rango de antigüedad

Recomendaciones de uso

• Usa PDF resumido para clientes que solo necesitan ver el total y la antigüedad.
• Usa PDF detallado cuando necesites sustentar el saldo documento por documento.
• Usa Excel detallado para conciliaciones internas.
• Verifica siempre la Fecha de corte antes de exportar o enviar por correo.
• Si el cliente cuestiona un saldo histórico, vuelve a generar el estado de cuenta con la fecha exacta solicitada.

Criterio funcional actual

El plugin calcula el estado de cuenta usando estas fuentes:

• facturascli
• recibospagoscli
• pagoscli

Además:

• la fuente de verdad para cortes históricos es pagoscli
• el saldo pendiente se protege incluso si la estructura de recibos quedó incompleta
• el cálculo actual no incluye anticipos, notas de crédito ni rectificativas

Limitaciones conocidas

• No incluye todavía anticipos, notas de crédito ni rectificativas en el cálculo.
• Algunas instalaciones pueden requerir revisar la configuración de correo antes de usar la función Email.
• El paquete de traducciones incluye idiomas base y fallback, pero no todas las traducciones están revisadas manualmente.

Soporte operativo

Si un usuario reporta diferencias en el saldo:

1. revisa la fecha de corte usada
2. revisa pagos registrados después de esa fecha
3. compara el PDF detallado con el Excel detallado
4. valida si hay casos fuera del alcance actual, como anticipos o notas de crédito