Portal klienta i udostępnianie

Portal klienta to strona Invotify widoczna dla klienta — wszystko, co klient widzi i robi bez zakładania konta. Generujesz bezpieczny link do udostępniania, wysyłasz go klientowi, a klient otwiera czystą, markową stronę, na której może przeczytać fakturę, pobrać PDF i (w planie Pro) zapłacić online. Tymczasem Ty otrzymujesz cichy zapis dokładnie tego, kiedy i gdzie go otworzył.

Co robi portal:

• Publiczny widok faktury — link oparty na tokenie otwiera fakturę w przeglądarce. Bez logowania, bez hasła, bez tarcia dla klienta.
• Pobieranie PDF — klient pobiera dokładny PDF A4 jednym kliknięciem.
• Płatność online (Pro) — przycisk „Zapłać teraz" kieruje klienta na bezpieczną kasę Stripe do pełnej lub częściowej płatności.
• Śledzenie wyświetleń — każde otwarcie jest rejestrowane: kiedy, skąd, liczba wyświetleń oraz znaczniki pierwszego i ostatniego wyświetlenia.
• Preferencje e-mail — rezygnacja z subskrypcji jednym kliknięciem i szczegółowa kontrola nad tym, jakie e-maile klient otrzymuje.

Dwa typy linków:

• Link do pojedynczej faktury (/invoice/{token}) — wyświetla jedną konkretną fakturę ze szczegółami i akcją pobierania/płatności.
• Link do portalu klienta (/portal/{token}) — zbiorczy widok ostatnich faktur klienta, łącznego zaległego salda, ewentualnego oznaczenia przeterminowania i salda not kredytowych, z akcją płatności dla każdej faktury.

Plany: Publiczny widok, pobieranie PDF, śledzenie wyświetleń i zarządzanie preferencjami e-mail są dostępne w każdym planie. Płatność online z portalu wymaga planu Pro ze skonfigurowanym Stripe.

Każda strona portalu jest opatrzona nazwą i logo Twojej firmy, zawiera dyskretną stopkę „Powered by Invotify" i jest oznaczona noindex, aby nigdy nie pojawiała się w wynikach wyszukiwania.

Udostępnienie faktury tworzy unikalny, trudny do odgadnięcia token udostępniania i przekształca go w publiczny link, który klient może otworzyć bez logowania. Token to losowy UUID — nie można go odgadnąć, inkrementując liczbę — i odpowiada dokładnie jednej fakturze.

Jak działa token udostępniania:

• Generowanie linku tworzy share_token dla faktury i zwraca URL w postaci https://your-app/invoice/{token}.
• Jeśli token już istnieje dla tej faktury, Invotify zwraca ten sam — ponowne udostępnianie nie zmienia linku ani nie psuje URL, który już wysłałeś.
• Link jest jedynym poświadczeniem. Każdy, kto go posiada, może wyświetlić fakturę, więc traktuj go jak prywatny link.
• Możesz cofnąć link do udostępniania w dowolnym momencie. Cofnięcie usuwa token, a stary URL natychmiast przestaje działać (zwraca „nie znaleziono"). Wygeneruj nowy link, aby ponownie udostępnić.

Uprawnienia: Generowanie lub cofanie linku do udostępniania wymaga uprawnienia „Zarządzaj fakturami", więc tylko autoryzowani członkowie zespołu mogą ujawnić fakturę.

Co otrzymuje klient: Gdy wysyłasz fakturę e-mailem, link (i w planie Pro — link do płatności) może podróżować razem z nią. Możesz też skopiować URL udostępniania i wysłać go dowolnym kanałem — przez czat, własnego klienta pocztowego, aplikację do przesyłania wiadomości.

Udostępnianie PDF przez WhatsApp, Telegram, Slack i inne: Okno dialogowe Udostępnij na fakturach i ofertach przekazuje wygenerowany PDF bezpośrednio do arkusza udostępniania urządzenia (na telefonach, tabletach i nowoczesnych przeglądarkach desktopowych). Dotknij WhatsApp, Telegram, Slack lub Messenger, a PDF będzie już dołączony — wybierz odbiorcę i wyślij. W przeglądarkach nieobsługujących udostępniania plików przez arkusz Invotify wraca do pobierania PDF i otwierania aplikacji, abyś mógł go dołączyć ręcznie.

Gdy klient otwiera link do udostępniania, trafia na czystą, przyjazną dla urządzeń mobilnych stronę, która nie wymaga logowania. Dostępne są dwa warianty w zależności od linku.

Strona pojedynczej faktury (`/invoice/{token}`): Klient widzi pełną fakturę — nazwę i logo firmy, numer i status faktury, daty wystawienia i termin płatności, dane rozliczeniowe, każdą pozycję z ilościami i sumami oraz wszelkie dodane uwagi. Na dole dostępne są akcje: - Pobierz PDF — generuje i pobiera profesjonalny PDF A4, identyczny z tym, który byś wysłał. Generowany po stronie serwera na żądanie. - Zapłać teraz — pojawia się tylko wtedy, gdy dostępny jest link do płatności i faktura nie jest jeszcze opłacona lub anulowana (Pro — patrz Płatność online poniżej).

Zunifikowana strona portalu (`/portal/{token}`): Przegląd w stylu panelu nawigacyjnego dla klienta dotyczący wszystkich jego faktur u Ciebie: - Zaległe saldo — łączna kwota nadal należna ze wszystkich nieopłaconych faktur (nie tylko tej, w którą kliknął), z oznaczeniem przeterminowania, jeśli któraś jest po terminie. - Saldo not kredytowych — wszelkie wystawione lub zastosowane kredyty, które posiada. - Lista faktur — jego ostatnie faktury inne niż wersje robocze, ze stronicowaniem, każda z numerem, datami, statusem, kwotą i akcją płatności.

Prywatność zgodnie z projektem: Portal zwraca tylko bezpieczny podzbiór danych. Wewnętrzne identyfikatory, sam token udostępniania i wszystko niezwiązane z tym klientem są usuwane. Zunifikowany portal jest ściśle ograniczony do jednego klienta, do którego należy token.

W planie Pro ze skonfigurowanym Stripe portal zamienia wyświetlanie w płatność. Klient klika Zapłać teraz i trafia na bezpieczną hostowaną kasę Stripe — Invotify nigdy nie dotyka danych karty.

Jak przebiega płatność z portalu: 1. Klient otwiera fakturę lub zunifikowany portal i klika Zapłać. 2. Invotify tworzy sesję Stripe Checkout dla tej faktury i przekierowuje klienta do niej. 3. Klient płaci na hostowanej stronie Stripe. Jego e-mail jest wstępnie wypełniony dla szybszej kasy. 4. Po sukcesie jest kierowany na stronę potwierdzenia; jeśli anuluje, trafia z powrotem bez problemu. 5. Stripe potwierdza płatność, a status faktury automatycznie zmienia się na Opłacona.

Pełne lub częściowe płatności: - Domyślnie klient płaci pełne zaległe saldo (kwotę do zapłaty, nie tylko oryginalną sumę — uwzględniane są wcześniejsze częściowe płatności). - Jeśli włączyłeś częściowe płatności dla faktury, klient może zapłacić mniejszą kwotę. Invotify egzekwuje ewentualną minimalną kwotę płatności i nigdy nie pozwala klientowi zapłacić więcej niż pozostałe saldo.

Wbudowane zabezpieczenia: - Już opłaconych lub anulowanych faktur nie można opłacić ponownie — przycisk Zapłać jest ukryty, a żądanie jest odrzucane po stronie serwera. - Punkt końcowy płatności portalu jest ograniczony, aby zapobiegać nadużyciom. - Kwota płatności jest weryfikowana względem bieżącego zaległego salda i minimalnej kwoty Stripe przed utworzeniem sesji.

Ważne: Płatność online wymaga planu Pro i podłączonego konta Stripe. Bez skonfigurowanego Stripe portal nadal działa do wyświetlania i pobierania — po prostu nie ma przycisku Zapłać.

Przestań zastanawiać się, czy klient faktycznie otworzył fakturę. Za każdym razem, gdy udostępniona faktura jest wyświetlana, Invotify to rejestruje — więc wiesz dokładnie, kiedy ją zobaczył, ile razy i skąd.

Co jest rejestrowane przy każdym wyświetleniu: - Znacznik czasowy — kiedy doszło do wyświetlenia. - Źródło — skąd pochodzi wyświetlenie: link (udostępniony link do pojedynczej faktury), email, portal lub api. Domyślnie link. - IP przeglądarki — adres IP klienta (odczytany z nagłówka przekazywania), dzięki czemu możesz odróżnić powtórne otwarcia z tego samego miejsca od nowych. - User-agent — ciąg przeglądarki/urządzenia, obcięty do bezpiecznej długości.

Statystyki zbiorcze Invotify per faktura: - Liczba wyświetleń — suma otwarć. - Pierwsze wyświetlenie — dokładnie kiedy faktura była po raz pierwszy otwarta (zapisywane raz, nigdy nadpisywane). - Ostatnie wyświetlenie — najnowsze otwarcie. - Unikalne adresy IP — ile różnych adresów IP ją wyświetliło.

Gdzie to widać: Statystyki wyświetleń faktury pojawiają się na stronie szczegółów faktury — kompaktowa odznaka pokazuje liczbę wyświetleń z znacznikami pierwszego i ostatniego wyświetlenia po najechaniu, oraz wskaźnik na żywo, gdy faktura była ostatnio otwarta.

Ochrona przed nadużyciami: Punkt końcowy śledzenia jest ograniczony per IP i per token, więc jeden klient odświeżający wielokrotnie nie może pompować liczby wyświetleń.

Każdy e-mail wysyłany przez Invotify do klienta zawiera link do rezygnacji z subskrypcji/preferencji, dzięki czemu klienci zawsze mają kontrolę nad tym, co trafia do ich skrzynki. Link działa bez logowania — sam token rezygnacji z subskrypcji dowodzi własności adresu e-mail.

Czym mogą zarządzać klienci: - E-maile z dokumentami — faktury, oferty i inne dokumenty wysyłane do nich. - E-maile z przypomnieniami — przypomnienia o przeterminowaniu i nadchodzących płatnościach. - E-maile marketingowe — wszelkie promocyjne lub ogłoszeniowe wiadomości.

Każda kategoria to niezależny przełącznik włącz/wyłącz. Klient, który chce tylko faktury, ale nie przypomnienia, może to dokładnie ustawić — to nie jest wszystko albo nic.

Rezygnacja jednym kliknięciem: Strona preferencji to ta sama powierzchnia co link rezygnacji z subskrypcji w dowolnym e-mailu. Klienci mogą wyłączyć jedną kategorię lub zrezygnować ze wszystkiego w jednym miejscu. Zmiany są zapisywane natychmiast.

Jak to jest zabezpieczone: - Punkt końcowy preferencji wymaga prawidłowego tokenu (odrzucany, jeśli jest za krótki lub brakujący), a sam token autoryzuje odczytywanie i aktualizowanie preferencji — konto nie jest potrzebne. - Akceptowane są tylko znane, dozwolone klucze preferencji i tylko wartości logiczne, więc punkt końcowy nie może być używany do zmiany czegokolwiek innego. - Odczyty i zapisy są ograniczone per IP.

Respektowanie tych preferencji utrzymuje dobrą reputację wysyłania i zachowuje zgodność z przepisami antyspamowymi.