Portal do Cliente e Partilha

O portal do cliente é o lado voltado para o cliente do Invotify — tudo o que o seu cliente vê e faz sem nunca criar uma conta. Gera um link de partilha seguro, envia-o ao seu cliente, e ele obtém uma página limpa com a sua marca onde pode ler a fatura, transferir o PDF e (no Pro) pagar online. Entretanto, fica com um registo discreto de exatamente quando e onde a abriu.

O que o portal faz:

• Vista pública da fatura — Um link baseado em token abre a fatura no browser. Sem início de sessão, sem palavra-passe, sem fricção para o cliente.
• Transferência de PDF — O cliente transfere um PDF A4 perfeito da sua fatura com um clique.
• Pagamento online (Pro) — Um botão "Pagar Agora" leva o cliente ao checkout seguro Stripe para pagamento total ou parcial.
• Rastreio de visualização — Cada abertura é registada: quando, de onde, contagem de visualizações e primeiro/último timestamp de visualização.
• Preferências de e-mail — Cancelamento de subscrição com um clique e controlo granular sobre que e-mails o cliente recebe.

Dois tipos de link:

• Link de fatura única (/invoice/{token}) — Mostra uma fatura específica com todos os detalhes e uma ação de transferência/pagamento.
• Link do portal do cliente (/portal/{token}) — Uma vista unificada das faturas recentes do cliente, o total em dívida, qualquer alerta de atraso e saldo de notas de crédito, cada fatura com a sua própria ação de pagamento.

Planos: A vista pública, a transferência de PDF, o rastreio de visualização e a gestão de preferências de e-mail estão disponíveis em todos os planos. O pagamento online a partir do portal requer um plano Pro com Stripe ligado.

Cada página do portal tem a sua marca com o nome e logótipo da sua empresa, inclui um rodapé discreto "Powered by Invotify" e é marcada com noindex para nunca aparecer nos motores de busca.

Partilhar uma fatura cria um token de partilha único e difícil de adivinhar e transforma-o num link público que o seu cliente pode abrir sem iniciar sessão. O token é um UUID aleatório — não pode ser adivinhado por incremento — e mapeia exatamente uma fatura.

Como funciona o token de partilha:

• Gerar um link cria um share_token para a fatura e devolve um URL da forma https://seu-app/invoice/{token}.
• Se já existir um token para essa fatura, o Invotify devolve o mesmo — partilhar novamente não muda o link nem quebra um URL já enviado.
• O link é a única credencial. Qualquer pessoa com o link pode ver a fatura, por isso trate-o como um link privado.
• Pode revogar um link de partilha a qualquer momento. A revogação limpa o token e o URL antigo deixa imediatamente de funcionar. Gere um link novo para partilhar novamente.

Permissões: Gerar ou revogar um link de partilha requer a permissão "Gerir faturas", pelo que apenas membros autorizados da equipa podem expor uma fatura.

Partilhar o PDF para WhatsApp, Telegram, Slack e outros: O diálogo de Partilha em faturas e orçamentos entrega o PDF renderizado diretamente para a folha de partilha do dispositivo (em telemóveis, tablets e browsers de ambiente de trabalho modernos). Toque em WhatsApp, Telegram, Slack ou Messenger e o PDF já está anexado — escolha o destinatário e envie.

Quando um cliente abre um link de partilha, chega a uma página limpa e compatível com dispositivos móveis que não requer início de sessão. Existem duas experiências consoante o link.

Página de fatura única (`/invoice/{token}`): O cliente vê a fatura completa — nome e logótipo da sua empresa, número e estado da fatura, datas de emissão e vencimento, detalhes de faturação, cada linha com quantidades e totais, e quaisquer notas que adicionou. No fundo encontram-se as ações: - Transferir PDF — Gera e transfere um PDF A4 profissional, idêntico ao que enviaria. Gerado no servidor a pedido. - Pagar Agora — Aparece apenas quando existe um link de pagamento disponível e a fatura não está já paga ou cancelada (Pro).

Página do portal unificado (`/portal/{token}`): Uma vista estilo dashboard para o cliente sobre todas as suas faturas consigo: - Saldo em dívida — O total ainda devido em todas as faturas não pagas (não apenas aquela em que clicou), com alerta de atraso se alguma estiver vencida. - Saldo de notas de crédito — Qualquer crédito emitido ou aplicado que detenha. - Lista de faturas — As faturas não-rascunho recentes, paginadas, cada uma mostrando número, datas, estado, valor e ação de pagamento.

Privacidade por conceção: O portal apenas devolve um subconjunto seguro de dados. IDs internos, o próprio token de partilha e qualquer coisa não relacionada com esse cliente são removidos da resposta. O portal unificado está estritamente limitado ao cliente a quem o token pertence.

Num plano Pro com Stripe ligado, o portal transforma uma visualização num pagamento. O cliente clica em Pagar Agora e chega ao checkout seguro alojado pelo Stripe — o Invotify nunca toca nos dados do cartão.

Como flui um pagamento pelo portal: 1. O cliente abre a fatura ou o portal unificado e clica em Pagar. 2. O Invotify cria uma sessão Stripe Checkout para essa fatura e redireciona o cliente. 3. O cliente paga na página alojada pelo Stripe. O e-mail é pré-preenchido para um checkout mais rápido. 4. Em caso de sucesso, é redirecionado para uma página de confirmação; em caso de cancelamento, regressa sem problemas. 5. O Stripe confirma o pagamento e o estado da fatura atualiza para Pago automaticamente.

Pagamentos totais ou parciais: - Por predefinição, o cliente paga o saldo total em dívida (o valor devido, não apenas o total original — por isso os pagamentos parciais anteriores são tidos em conta). - Se ativar os pagamentos parciais na fatura, o cliente pode pagar um valor menor. O Invotify impõe qualquer valor mínimo de pagamento que definir e nunca permite que o cliente pague mais do que o que ainda deve.

Salvaguardas integradas: - Faturas já pagas ou canceladas não podem ser pagas novamente — o botão Pagar oculta e o pedido é rejeitado no servidor. - O endpoint de pagamento do portal tem limite de frequência para prevenir abusos. - O valor do pagamento é validado em relação ao saldo em dívida atual e ao montante mínimo do Stripe antes de ser criada uma sessão.

Importante: O pagamento online requer um plano Pro e uma conta Stripe ligada.

Deixe de perguntar-se se o seu cliente abriu a fatura. Sempre que uma fatura partilhada é visualizada, o Invotify regista-o — para que saiba exatamente quando a viram, quantas vezes e de onde.

O que é registado em cada visualização: - Timestamp — Quando a visualização aconteceu. - Fonte — De onde veio a visualização: link (um link de fatura única partilhado), email, portal ou api. Por predefinição link. - IP do visualizador — O endereço IP do cliente, para distinguir aberturas repetidas do mesmo local de novas. - User-agent — A string do browser/dispositivo, truncada a um comprimento seguro.

Estatísticas agregadas que o Invotify mantém por fatura: - Contagem de visualizações — O total corrente de aberturas. - Primeira visualização em — Exatamente quando a fatura foi aberta pela primeira vez (registado uma vez, nunca substituído). - Última visualização em — A abertura mais recente. - IPs únicos — Quantos endereços IP distintos a viram.

Onde pode ver: As estatísticas de visualização da fatura aparecem na página de detalhes da fatura — um distintivo compacto mostra a contagem de visualizações, com timestamps de primeira e última visualização ao passar o rato, e um indicador ao vivo quando a fatura foi aberta recentemente.

Proteção contra abusos: O endpoint de rastreio tem limite de frequência por IP e por token, pelo que um único cliente a atualizar repetidamente não pode inflar a contagem de visualizações.

Todos os e-mails que o Invotify envia a um cliente incluem um link de cancelamento de subscrição / preferências, para que os clientes mantenham sempre o controlo do que recebem na caixa de entrada. O link funciona sem início de sessão — o token de cancelamento em si prova a propriedade do endereço de e-mail.

O que os clientes podem controlar: - E-mails de documentos — Faturas, orçamentos e outros documentos enviados para eles. - E-mails de lembrete — Lembretes de atraso e de pagamento próximo. - E-mails de marketing — Quaisquer mensagens promocionais ou de anúncio.

Cada categoria é um botão de ativar/desativar independente. Um cliente que só quer faturas mas não lembretes pode ter exatamente isso.

Cancelamento de subscrição com um clique: A página de preferências é a mesma que o link de cancelamento em qualquer e-mail. Os clientes podem desativar uma única categoria ou cancelar a subscrição de tudo num único lugar. As alterações são guardadas imediatamente.

Como permanece seguro: - O endpoint de preferências requer um token válido, e esse token por si só autoriza a leitura e atualização das preferências — sem conta necessária. - Apenas as chaves de preferência conhecidas e permitidas são aceites, e apenas valores booleanos. - Leituras e escritas têm limite de frequência por IP.