Portal do cliente e partilha

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

O que o portal faz:

• Vista pública da fatura — Uma ligação baseada em token abre a fatura no navegador. Sem início de sessão, sem palavra-passe, sem fricção para o cliente.
• Descarregamento de PDF — O cliente descarrega um PDF A4 impecável da sua fatura com um clique.
• Pagamento online (Pro) — Um botão «Pagar agora» (Pay Now) leva o cliente a um checkout seguro do Stripe, para pagamento total ou parcial.
• Registo de visualizações — Cada abertura fica registada: quando, de onde, o número de visualizações e a data/hora da primeira e da última visualização.
• Preferências de e-mail — Anulação de subscrição com um clique e controlo granular sobre os e-mails que o cliente recebe.

Dois tipos de ligação:

• Ligação de fatura única (/invoice/{token}) — Mostra uma fatura específica com todos os detalhes e uma ação de descarregamento/pagamento.
• Ligação do portal do cliente (/portal/{token}) — Uma vista unificada das faturas recentes do cliente, do seu saldo total em dívida, de um eventual indicador de atraso e do saldo de notas de crédito, com uma ação de pagamento em cada fatura.

Planos: A vista pública, o descarregamento de PDF, o registo de visualizações 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 o Stripe ligado.

Cada página do portal apresenta o nome e o logótipo do seu negócio, inclui um rodapé discreto «Com tecnologia Invotify» (Powered by Invotify) e está marcada como noindex, para que nunca apareça nos motores de pesquisa.

Partilhar uma fatura cria um token de partilha único e difícil de adivinhar e transforma-o numa ligação pública que o seu cliente pode abrir sem iniciar sessão. O token é um UUID aleatório — não pode ser adivinhado incrementando um número — e corresponde exatamente a uma fatura.

Como funciona o token de partilha:

• Gerar uma ligação cria um share_token para a fatura e devolve um URL no formato https://your-app/invoice/{token}.
• Se já existir um token para essa fatura, o Invotify devolve o mesmo — partilhar de novo não troca a ligação nem quebra um URL que já tenha enviado.
• A ligação é a única credencial. Qualquer pessoa com ela pode ver a fatura, por isso trate-a como uma ligação privada.
• Pode revogar uma ligação de partilha a qualquer momento. A revogação limpa o token e o URL antigo deixa imediatamente de funcionar (devolve «não encontrado» (not found)). Gere uma ligação nova para voltar a partilhar.

Permissões: Gerar ou revogar uma ligação de partilha requer a permissão «Gerir faturas» (Manage invoices), para que apenas membros autorizados da equipa possam expor uma fatura.

O que o cliente recebe: Quando envia uma fatura por e-mail, a ligação (e, no Pro, uma ligação de pagamento) pode seguir com ela. Também pode copiar o URL de partilha e enviá-lo por qualquer canal — chat, o seu próprio cliente de e-mail, uma aplicação de mensagens.

Partilhar o PDF para WhatsApp, Telegram, Slack e afins: A caixa de diálogo de partilha nas faturas e nos orçamentos entrega o PDF renderizado diretamente à folha de partilha do seu dispositivo (em telemóveis, tablets e navegadores de computador modernos). Toque em WhatsApp, Telegram, Slack ou Messenger e o PDF já vai anexado — escolha o destinatário e envie. Em navegadores sem suporte para ficheiros na folha de partilha, o Invotify recorre a descarregar o PDF e a abrir a aplicação, para que o possa anexar manualmente.

Quando um cliente abre uma ligação de partilha, chega a uma página limpa e otimizada para telemóvel que não exige início de sessão. Existem duas experiências, consoante a ligação.

Página de fatura única (`/invoice/{token}`): O cliente vê a fatura completa — o nome e o logótipo do seu negócio, o número e o estado da fatura, as datas de emissão e de vencimento, os dados de faturação, todas as linhas com quantidades e totais e quaisquer notas que tenha acrescentado. No fundo da página estão as ações: - Descarregar PDF (Download PDF) — Gera e descarrega um PDF A4 profissional, idêntico ao que enviaria. Gerado no servidor, a pedido. - Pagar agora (Pay Now) — Aparece apenas quando há uma ligação de pagamento disponível e a fatura ainda não está paga nem cancelada (Pro — veja «Pagamento online» mais abaixo).

Página de portal unificado (`/portal/{token}`): Uma visão geral em estilo de painel para o cliente, abrangendo todas as faturas dele consigo: - Saldo em dívida — O total ainda em dívida em todas as faturas por pagar (não apenas na que o cliente abriu), com um indicador de atraso se alguma estiver vencida. - Saldo de notas de crédito — Qualquer crédito emitido ou aplicado que o cliente detenha. - Lista de faturas — As faturas recentes do cliente que não sejam rascunhos, paginadas, cada uma com número, datas, estado, valor e uma ação de pagamento.

Privacidade desde a conceção: O portal devolve sempre apenas um subconjunto seguro dos dados. Os IDs internos, o próprio token de partilha e tudo o que não diga respeito a esse cliente são removidos da resposta. O portal unificado limita-se estritamente ao único cliente a quem o token pertence. As respostas do portal são enviadas com cache no-store, para que nada de sensível fique guardado em intermediários.

Com um plano Pro e o Stripe ligado, o portal transforma uma visualização num pagamento. O cliente clica em «Pagar agora» (Pay Now) e chega ao checkout alojado e seguro do Stripe — o Invotify nunca toca nos dados do cartão.

Como decorre um pagamento no portal: 1. O cliente abre a sua fatura ou o portal unificado e clica em Pagar (Pay). 2. O Invotify cria uma sessão de Stripe Checkout para essa fatura e redireciona o cliente para ela. 3. O cliente paga na página alojada do Stripe. O e-mail dele vem pré-preenchido, para um checkout mais rápido. 4. Em caso de sucesso, é reencaminhado para uma página de confirmação; se cancelar, regressa sem sobressaltos. 5. O Stripe confirma o pagamento e o estado da fatura passa automaticamente a Paga.

Pagamentos totais ou parciais: - Por predefinição, o cliente paga o saldo total em dívida (o valor em falta, não apenas o total original — os pagamentos parciais anteriores são tidos em conta). - Se tiver ativado pagamentos parciais na fatura, o cliente pode pagar um valor mais baixo. O Invotify aplica qualquer valor mínimo de pagamento que tenha definido e nunca deixa o cliente pagar mais do que o que ainda está em dívida.

Salvaguardas incorporadas: - Faturas já pagas ou canceladas não podem voltar a ser pagas — o botão de pagamento desaparece e o pedido é rejeitado no servidor. - O ponto de acesso de pagamento do portal tem limitação de pedidos, para evitar abusos. - O valor do pagamento é validado contra o saldo em dívida atual e o valor mínimo de cobrança do Stripe antes de a sessão ser criada.

Importante: O pagamento online requer um plano Pro e uma conta Stripe ligada. Sem o Stripe ligado, o portal continua a funcionar para ver e descarregar — simplesmente não há botão de pagamento.

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

O que é registado em cada visualização: - Data e hora — Quando a visualização ocorreu. - Origem — De onde veio a visualização: link (uma ligação partilhada de fatura única), email, portal ou api. A predefinição é link. - IP do visualizador — O endereço IP do cliente (extraído do cabeçalho de encaminhamento), para distinguir aberturas repetidas a partir do mesmo local de aberturas novas. - User-agent — A cadeia do navegador/dispositivo, truncada para um comprimento seguro.

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

Onde o vê: As estatísticas de visualização aparecem na página de detalhe da fatura — um distintivo compacto mostra o número de visualizações, com as datas da primeira e da última visualização ao passar o cursor, e um indicador em direto quando a fatura foi aberta recentemente. O registo completo de visualizações (cada abertura individual com a respetiva origem, IP e user-agent) está disponível através dos dados de visualizações da fatura, limitados à sua empresa.

Proteção contra abusos: O ponto de acesso de registo tem limitação de pedidos por IP e por token, pelo que um único cliente a atualizar a página repetidamente não consegue inflacionar o seu número de visualizações, nem o ponto de acesso pode ser bombardeado para empolar os números.

Todos os e-mails que o Invotify envia a um cliente incluem uma ligação de anulação de subscrição / preferências, para que os clientes mantenham sempre o controlo sobre o que chega à sua caixa de entrada. A ligação funciona sem qualquer início de sessão — o próprio token de anulação de subscrição comprova a titularidade do endereço de e-mail.

O que os clientes podem controlar: - E-mails de documentos — Faturas, orçamentos e outros documentos que lhes são enviados. - E-mails de lembrete — Lembretes de pagamentos em atraso e de pagamentos próximos. - E-mails de marketing — Quaisquer mensagens promocionais ou de anúncios.

Cada categoria é um interruptor independente de ligar/desligar. Um cliente que só queira faturas mas não lembretes pode ter exatamente isso — não é tudo ou nada.

Anulação de subscrição com um clique: A página de preferências é a mesma superfície da ligação de anulação de subscrição em qualquer e-mail. Os clientes podem desligar uma única categoria, ou cancelar tudo, num só lugar. As alterações são guardadas de imediato e aplicam-se aos envios futuros.

Como se mantém seguro: - O ponto de acesso de preferências exige um token válido (rejeitado se for demasiado curto ou estiver em falta), e só esse token autoriza a leitura e a atualização das preferências — sem necessidade de conta. - Apenas as chaves de preferência conhecidas e permitidas são aceites, e apenas valores booleanos, pelo que o ponto de acesso não pode ser manipulado para alterar mais nada. - As leituras e as escritas têm limitação de pedidos por IP.

Respeitar estas preferências mantém a sua reputação de envio saudável e mantém-no do lado certo das regras anti-spam — os clientes que optaram por sair simplesmente deixam de receber essa categoria.