Portal klienta i udostępnianie

Portal klienta to skierowana do klienta strona Invotify — wszystko, co Twój klient widzi i robi, nigdy nie zakładając konta. Generujesz bezpieczny link do udostępniania, wysyłasz go klientowi, a on otrzymuje przejrzystą, opatrzoną Twoją marką stronę, na której może odczytać fakturę, pobrać plik PDF oraz (w planie Pro) zapłacić online. W tym samym czasie Ty otrzymujesz dyskretny zapis tego, dokładnie kiedy i skąd ją otworzył.

Co robi portal:

• Publiczny widok faktury — Link oparty na tokenie otwiera fakturę w przeglądarce. Bez logowania, bez hasła, bez przeszkód dla klienta.
• Pobieranie PDF — Klient pobiera idealnej jakości plik PDF w formacie A4 swojej faktury jednym kliknięciem.
• Płatność online (Pro) — Przycisk „Zapłać teraz” przenosi klienta do bezpiecznej kasy Stripe w celu pełnej lub częściowej płatności.
• Śledzenie wyświetleń — Każde otwarcie jest rejestrowane: kiedy, skąd, liczba wyświetleń oraz znaczniki czasu pierwszego/ostatniego wyświetlenia.
• Preferencje e-mail — Rezygnacja jednym kliknięciem oraz szczegółowa kontrola nad tym, które wiadomości otrzymuje klient.

Dwa rodzaje linków:

• Link do pojedynczej faktury (/invoice/{token}) — Pokazuje jedną konkretną fakturę z jej pełnymi szczegółami oraz akcją pobierania/płatności.
• Link do portalu klienta (/portal/{token}) — Zunifikowany widok ostatnich faktur klienta, jego łącznego salda do zapłaty, ewentualnej flagi przeterminowania oraz salda not korygujących, przy czym każda faktura ma własną akcję płatności.

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

Każda strona portalu jest opatrzona nazwą i logo Twojej firmy, zawiera dyskretną stopkę „Powered by Invotify” i jest oznaczona jako noindex, dzięki czemu nigdy nie pojawia się w wyszukiwarkach.

Udostępnienie faktury tworzy unikalny, trudny do odgadnięcia token udostępniania i zamienia go w publiczny link, który Twój klient może otworzyć bez logowania. Token to losowy UUID — nie można go odgadnąć przez zwiększanie liczby — i odwzorowuje dokładnie jedną fakturę.

Jak działa token udostępniania:

• Wygenerowanie linku tworzy share_token dla faktury i zwraca adres URL w postaci https://your-app/invoice/{token}.
• Jeśli token już istnieje dla danej faktury, Invotify zwraca ten sam — ponowne udostępnienie nie zmieni linku ani nie zepsuje już wysłanego adresu URL.
• Link jest jedynym poświadczeniem. Każdy, kto go posiada, może wyświetlić fakturę, więc traktuj go jak prywatny link.
• Możesz odwołać link udostępniania w dowolnym momencie. Odwołanie usuwa token, a stary adres URL natychmiast przestaje działać (zwraca „nie znaleziono”). Wygeneruj nowy link, aby ponownie udostępnić.

Uprawnienia: Wygenerowanie lub odwołanie linku udostępniania wymaga uprawnienia „Zarządzanie fakturami”, dzięki czemu tylko upoważnieni członkowie zespołu mogą ujawnić fakturę.

Co otrzymuje klient: Gdy wysyłasz fakturę e-mailem, link (a w planie Pro również link do płatności) może zostać dołączony do wiadomości. Możesz też skopiować adres URL udostępniania i wysłać go dowolnym kanałem — czat, Twój własny klient e-mail, komunikator.

Udostępnianie PDF do WhatsApp, Telegram, Slack i innych: Okno udostępniania na fakturach i ofertach przekazuje wyrenderowany plik PDF bezpośrednio do arkusza udostępniania Twojego urządzenia (na telefonach, tabletach i nowoczesnych przeglądarkach komputerowych). Dotknij WhatsApp, Telegram, Slack lub Messenger, a plik PDF jest już dołączony — wybierz odbiorcę i wyślij. W przeglądarkach bez obsługi plików w arkuszu udostępniania Invotify przechodzi awaryjnie do pobrania pliku PDF i otwarcia aplikacji, abyś mógł dołączyć go ręcznie.

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

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

Zunifikowana strona portalu (`/portal/{token}`): Przegląd w stylu pulpitu nawigacyjnego dla klienta obejmujący wszystkie jego faktury wystawione przez Ciebie: - Saldo do zapłaty — Łączna kwota wciąż należna ze wszystkich nieopłaconych faktur (nie tylko tej, którą kliknięto), z flagą przeterminowania, jeśli któraś jest po terminie. - Saldo not korygujących — Wszelki wystawiony lub zastosowany kredyt, który posiada. - Lista faktur — Jego ostatnie faktury inne niż szkice, podzielone na strony, każda pokazująca numer, daty, status, kwotę oraz akcję płatności.

Prywatność od podstaw: Portal zawsze zwraca jedynie bezpieczny podzbiór danych. Wewnętrzne identyfikatory, sam token udostępniania oraz wszystko, co nie jest związane z danym klientem, są usuwane z odpowiedzi. Zunifikowany portal ściśle ogranicza się do jednego klienta, do którego należy token. Odpowiedzi portalu są wysyłane z buforowaniem no-store, dzięki czemu nic poufnego nie jest buforowane przez pośredników.

W planie Pro z połączonym Stripe portal zamienia przeglądanie w płatność. Klient klika „Zapłać teraz” i trafia do bezpiecznej hostowanej kasy Stripe — Invotify nigdy nie ma styczności z danymi jego karty.

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

Płatności pełne lub częściowe: - Domyślnie klient płaci pełne saldo do zapłaty (kwotę należną, a nie tylko pierwotną sumę — dzięki czemu wcześniejsze płatności częściowe są uwzględniane). - Jeśli włączyłeś płatności częściowe na fakturze, klient może zapłacić mniejszą kwotę. Invotify egzekwuje ustaloną przez Ciebie kwotę minimalnej płatności i nigdy nie pozwala klientowi zapłacić więcej, niż wciąż jest należne.

Wbudowane zabezpieczenia: - Faktury już opłacone lub anulowane nie mogą zostać opłacone ponownie — przycisk płatności jest ukrywany, a żądanie jest odrzucane po stronie serwera. - Punkt końcowy płatności w portalu ma ograniczoną liczbę żądań, aby zapobiec nadużyciom. - Kwota płatności jest weryfikowana względem bieżącego salda do zapłaty oraz minimalnej kwoty obciążenia Stripe przed utworzeniem sesji.

Ważne: Płatność online wymaga planu Pro oraz połączonego konta Stripe. Bez połączonego Stripe portal nadal działa w zakresie przeglądania i pobierania — brakuje jedynie przycisku płatności.

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

Co jest rejestrowane przy każdym wyświetleniu: - Znacznik czasu — Kiedy nastąpiło wyświetlenie. - Źródło — Skąd pochodziło wyświetlenie: link (udostępniony link do pojedynczej faktury), email, portal lub api. Domyślnie link. - Adres IP odbiorcy — Adres IP klienta (odczytany z nagłówka przekierowania), dzięki czemu możesz odróżnić powtarzające się otwarcia z tego samego miejsca od nowych. - Klient użytkownika (user-agent) — Ciąg przeglądarki/urządzenia, skrócony do bezpiecznej długości.

Zbiorcze statystyki, które Invotify przechowuje dla każdej faktury: - Liczba wyświetleń — Bieżąca suma otwarć. - Pierwsze wyświetlenie — Dokładnie kiedy faktura została otwarta po raz pierwszy (oznaczone raz, nigdy nadpisywane). - Ostatnie wyświetlenie — Najnowsze otwarcie. - Unikalne adresy IP — Ile różnych adresów IP ją wyświetliło.

Gdzie to widzisz: Statystyki wyświetleń faktury pojawiają się na stronie szczegółów faktury — kompaktowy znacznik pokazuje liczbę wyświetleń, ze znacznikami czasu pierwszego i ostatniego wyświetlenia po najechaniu, oraz wskaźnik na żywo, gdy faktura została otwarta niedawno. Pełny dziennik wyświetleń (każde pojedyncze otwarcie wraz z jego źródłem, adresem IP i klientem użytkownika) jest dostępny poprzez dane wyświetleń faktury, ograniczone do zakresu Twojej firmy.

Ochrona przed nadużyciami: Punkt końcowy śledzenia ma ograniczoną liczbę żądań na adres IP i na token, dzięki czemu pojedynczy klient wielokrotnie odświeżający stronę nie może zawyżyć liczby Twoich wyświetleń, a punktu końcowego nie da się zasypywać żądaniami w celu sztucznego zawyżenia liczb.

Każda wiadomość e-mail, którą Invotify wysyła klientowi, zawiera link rezygnacji / preferencji, dzięki czemu klienci zawsze zachowują kontrolę nad tym, co trafia do ich skrzynki odbiorczej. Link działa bez żadnego logowania — sam token rezygnacji potwierdza własność adresu e-mail.

Co klienci mogą kontrolować: - Wiadomości z dokumentami — Faktury, oferty i inne wysyłane do nich dokumenty. - Wiadomości z przypomnieniami — Przypomnienia o zaległościach i nadchodzących płatnościach. - Wiadomości marketingowe — Wszelkie wiadomości promocyjne lub ogłoszeniowe.

Każda kategoria jest niezależnym przełącznikiem wł./wył. Klient, który chce otrzymywać tylko faktury, ale nie przypomnienia, może mieć dokładnie to — nie jest to zasada „wszystko albo nic”.

Rezygnacja jednym kliknięciem: Strona preferencji to ta sama powierzchnia co link rezygnacji w dowolnej wiadomości e-mail. Klienci mogą wyłączyć pojedynczą kategorię lub zrezygnować ze wszystkiego w jednym miejscu. Zmiany zapisują się natychmiast i mają zastosowanie do przyszłych wysyłek.

Jak zachowuje bezpieczeństwo: - Punkt końcowy preferencji wymaga prawidłowego tokenu (odrzucanego, jeśli jest za krótki lub go brakuje), a sam ten token autoryzuje odczyt i aktualizację preferencji — bez potrzeby posiadania konta. - Akceptowane są wyłącznie znane, dozwolone klucze preferencji i tylko wartości logiczne, dzięki czemu punktu końcowego nie można zmusić do zmiany czegokolwiek innego. - Odczyty i zapisy mają ograniczoną liczbę żądań na adres IP.

Honorowanie tych preferencji utrzymuje dobrą reputację Twoich wysyłek i zapewnia zgodność z przepisami antyspamowymi — klienci, którzy zdecydowali się zrezygnować, po prostu przestają otrzymywać daną kategorię.