Portal de clientes y compartición

El portal de clientes es la cara de Invotify orientada al cliente — todo lo que su cliente ve y hace sin necesidad de crear una cuenta. Usted genera un enlace seguro para compartir, se lo envía a su cliente, y este obtiene una página limpia y con su marca donde puede leer la factura, descargar el PDF y (en Pro) pagar en línea. Mientras tanto, usted obtiene un registro discreto de cuándo y desde dónde la abrió exactamente.

Qué hace el portal:

• Vista pública de la factura — Un enlace basado en token abre la factura en el navegador. Sin inicio de sesión, sin contraseña, sin fricción para el cliente.
• Descarga de PDF — El cliente descarga con un clic un PDF A4 impecable de su factura.
• Pago en línea (Pro) — Un botón «Pagar ahora» (Pay Now) lleva al cliente a un pago seguro de Stripe para abonar el total o una parte.
• Seguimiento de visualizaciones — Cada apertura queda registrada: cuándo, desde dónde, el número de visualizaciones y las marcas de tiempo de la primera y la última.
• Preferencias de correo — Una baja con un clic y control granular sobre qué correos recibe el cliente.

Dos tipos de enlace:

• Enlace de factura individual (/invoice/{token}) — Muestra una factura concreta con todo su detalle y una acción de descarga/pago.
• Enlace del portal de clientes (/portal/{token}) — Una vista unificada de las facturas recientes del cliente, su saldo pendiente total, cualquier indicador de vencimiento y el saldo de notas de crédito, cada factura con su propia acción de pago.

Planes: La vista pública, la descarga de PDF, el seguimiento de visualizaciones y la gestión de preferencias de correo están disponibles en todos los planes. El pago en línea desde el portal requiere un plan Pro con Stripe conectado.

Cada página del portal lleva el nombre y el logotipo de su negocio, incluye un discreto pie «Con tecnología de Invotify» (Powered by Invotify) y está marcada como noindex para que nunca aparezca en los motores de búsqueda.

Compartir una factura crea un token único y difícil de adivinar, y lo convierte en un enlace público que su cliente puede abrir sin iniciar sesión. El token es un UUID aleatorio — no se puede adivinar incrementando un número — y corresponde exactamente a una factura.

Cómo funciona el token de compartición:

• Generar un enlace crea un share_token para la factura y devuelve una URL con la forma https://your-app/invoice/{token}.
• Si ya existe un token para esa factura, Invotify devuelve el mismo — volver a compartir no cambia el enlace ni rompe una URL que ya haya enviado.
• El enlace es la única credencial. Cualquiera que lo tenga puede ver la factura, así que trátelo como un enlace privado.
• Puede revocar un enlace compartido en cualquier momento. Revocarlo borra el token y la URL antigua deja de funcionar de inmediato (devuelve «no encontrado» (not found)). Genere un enlace nuevo para volver a compartir.

Permisos: Generar o revocar un enlace de compartición requiere el permiso «Gestionar facturas» (Manage invoices), de modo que solo los miembros del equipo autorizados pueden exponer una factura.

Qué recibe el cliente: Cuando envía una factura por correo, el enlace (y, en Pro, un enlace de pago) puede viajar con ella. También puede copiar la URL de compartición y enviarla por cualquier canal — chat, su propio cliente de correo, una aplicación de mensajería.

Compartir el PDF por WhatsApp, Telegram, Slack y compañía: El diálogo de compartir de facturas y presupuestos entrega el PDF renderizado directamente a la hoja de compartir de su dispositivo (en teléfonos, tabletas y navegadores de escritorio modernos). Toque WhatsApp, Telegram, Slack o Messenger y el PDF ya va adjunto — elija el destinatario y envíe. En navegadores sin compatibilidad con archivos en la hoja de compartir, Invotify recurre a descargar el PDF y abrir la aplicación para que pueda adjuntarlo manualmente.

Cuando un cliente abre un enlace compartido, llega a una página limpia y adaptada a móviles que no requiere inicio de sesión. Hay dos experiencias según el enlace.

Página de factura individual (`/invoice/{token}`): El cliente ve la factura completa — el nombre y el logotipo de su negocio, el número y el estado de la factura, las fechas de emisión y vencimiento, los datos de facturación, cada línea con sus cantidades y totales, y cualquier nota que usted haya añadido. Al final están las acciones: - Descargar PDF — Genera y descarga un PDF A4 profesional, idéntico al que usted enviaría. Se genera en el servidor bajo demanda. - Pagar ahora (Pay Now) — Aparece solo cuando hay un enlace de pago disponible y la factura no está ya pagada o cancelada (Pro — vea «Pago en línea» más abajo).

Página del portal unificado (`/portal/{token}`): Una vista general tipo panel para el cliente sobre todas sus facturas con usted: - Saldo pendiente — El total que aún se adeuda en todas las facturas impagadas (no solo la que abrió), con un indicador de vencido si alguna está fuera de plazo. - Saldo de notas de crédito — Cualquier crédito emitido o aplicado que el cliente tenga. - Lista de facturas — Sus facturas recientes que no sean borrador, paginadas, cada una con número, fechas, estado, importe y una acción de pago.

Privacidad por diseño: El portal solo devuelve un subconjunto seguro de datos. Los IDs internos, el propio token de compartición y todo lo no relacionado con ese cliente se eliminan de la respuesta. El portal unificado se limita estrictamente al único cliente al que pertenece el token. Las respuestas del portal se envían con caché no-store, de modo que ningún intermediario almacena nada sensible.

Con un plan Pro y Stripe conectado, el portal convierte una visualización en un pago. El cliente hace clic en «Pagar ahora» (Pay Now) y llega al pago alojado y seguro de Stripe — Invotify nunca toca los datos de su tarjeta.

Cómo fluye un pago desde el portal: 1. El cliente abre su factura o el portal unificado y hace clic en Pagar (Pay). 2. Invotify crea una sesión de Stripe Checkout para esa factura y redirige al cliente. 3. El cliente paga en la página alojada de Stripe. Su correo viene prerrellenado para agilizar el pago. 4. Si el pago se completa, vuelve a una página de confirmación; si lo cancela, regresa sin problemas. 5. Stripe confirma el pago y el estado de la factura pasa a Pagada (Paid) automáticamente.

Pagos totales o parciales: - De forma predeterminada, el cliente paga el saldo pendiente completo (el importe adeudado, no solo el total original — así se tienen en cuenta los pagos parciales anteriores). - Si ha activado los pagos parciales en la factura, el cliente puede pagar un importe menor. Invotify aplica cualquier importe mínimo de pago que usted haya fijado y nunca permite que el cliente pague más de lo que aún se adeuda.

Salvaguardas integradas: - Las facturas ya pagadas o canceladas no se pueden volver a pagar — el botón de pago se oculta y la solicitud se rechaza en el servidor. - El punto de pago del portal tiene limitación de frecuencia para evitar abusos. - El importe del pago se valida contra el saldo pendiente en vivo y el cargo mínimo de Stripe antes de crear una sesión.

Importante: El pago en línea requiere un plan Pro y una cuenta de Stripe conectada. Sin Stripe conectado, el portal sigue funcionando para ver y descargar — simplemente no hay botón de pago.

Deje de preguntarse si su cliente abrió realmente la factura. Cada vez que se visualiza una factura compartida, Invotify lo registra — así sabe exactamente cuándo la vio, cuántas veces y desde dónde.

Qué se registra en cada visualización: - Marca de tiempo — Cuándo se produjo la visualización. - Origen — De dónde vino la visualización: link (un enlace de factura individual compartido), email, portal o api. El valor predeterminado es link. - IP del visitante — La dirección IP del cliente (extraída de la cabecera de reenvío), para distinguir las aperturas repetidas desde el mismo lugar de las nuevas. - User-agent — La cadena del navegador/dispositivo, truncada a una longitud segura.

Estadísticas agregadas que Invotify mantiene por factura: - Número de visualizaciones — El total acumulado de aperturas. - Primera visualización — Exactamente cuándo se abrió la factura por primera vez (se registra una sola vez, nunca se sobrescribe). - Última visualización — La apertura más reciente. - IPs únicas — Cuántas direcciones IP distintas la han visto.

Dónde lo ve: Las estadísticas de visualización de la factura aparecen en su página de detalle — una insignia compacta muestra el número de visualizaciones, con las marcas de tiempo de la primera y la última al pasar el cursor, y un indicador en vivo cuando la factura se abrió hace poco. El registro completo de visualizaciones (cada apertura individual con su origen, IP y user-agent) está disponible a través de los datos de visualizaciones de la factura, limitados a su empresa.

Protección contra abusos: El punto de seguimiento tiene limitación de frecuencia por IP y por token, de modo que un solo cliente recargando la página repetidamente no puede inflar su contador de visualizaciones, y el punto no puede bombardearse para hinchar las cifras.

Cada correo que Invotify envía a un cliente lleva un enlace de baja / preferencias, de modo que los clientes siempre controlan lo que llega a su bandeja de entrada. El enlace funciona sin ningún inicio de sesión — el propio token de baja demuestra la titularidad de la dirección de correo.

Qué pueden controlar los clientes: - Correos de documentos — Facturas, presupuestos y otros documentos que se les envían. - Correos de recordatorio — Recordatorios de pagos vencidos y próximos. - Correos de marketing — Cualquier mensaje promocional o de anuncios.

Cada categoría es un interruptor independiente. Un cliente que solo quiera facturas pero no recordatorios puede tener exactamente eso — no es todo o nada.

Baja con un clic: La página de preferencias es la misma superficie que el enlace de baja de cualquier correo. Los clientes pueden desactivar una sola categoría, o darse de baja de todo, en un solo lugar. Los cambios se guardan de inmediato y se aplican a los envíos futuros.

Cómo se mantiene seguro: - El punto de preferencias requiere un token válido (se rechaza si es demasiado corto o falta), y ese token por sí solo autoriza leer y actualizar las preferencias — sin necesidad de cuenta. - Solo se aceptan las claves de preferencia conocidas y permitidas, y solo valores booleanos, de modo que el punto no puede forzarse para cambiar nada más. - Las lecturas y escrituras tienen limitación de frecuencia por IP.

Respetar estas preferencias mantiene sana su reputación de envío y le mantiene del lado correcto de las normas antispam — los clientes que decidieron darse de baja simplemente dejan de recibir esa categoría.