Клиентский портал и совместный доступ

Клиентский портал — это сторона Invotify, обращённая к клиенту: всё, что видит и делает ваш клиент без создания аккаунта. Вы создаёте защищённую ссылку для общего доступа, отправляете её клиенту, и он попадает на чистую брендированную страницу, где может прочитать счёт, скачать PDF и (в Pro) оплатить онлайн. При этом вы получаете незаметную запись о том, когда именно и откуда его открыли.

Что делает портал:

• Публичный просмотр счёта — ссылка с токеном открывает счёт в браузере. Никакого входа, никакого пароля — никаких сложностей для клиента.
• Скачивание PDF — клиент скачивает идеальный A4 PDF своего счёта одним кликом.
• Онлайн-оплата (Pro) — кнопка «Оплатить» ведёт клиента к защищённой оплате Stripe.
• Отслеживание просмотров — каждое открытие фиксируется: когда, откуда, количество просмотров, время первого и последнего просмотра.
• Настройки email — отписка в один клик и тонкий контроль над тем, какие письма получает клиент.

Два типа ссылок:

• Ссылка на отдельный счёт (/invoice/{token}) — отображает один конкретный счёт с полными данными и возможностью скачать или оплатить.
• Ссылка на клиентский портал (/portal/{token}) — сводный обзор последних счетов клиента, общего остатка задолженности, флага просрочки и баланса кредит-нот, с возможностью оплаты по каждому счёту.

Планы: Просмотр, скачивание PDF, отслеживание просмотров и управление настройками email доступны на всех планах. Онлайн-оплата с портала требует плана Pro с подключённым Stripe.

Отправка счёта создаёт уникальный труднопредсказуемый токен доступа и превращает его в публичную ссылку, которую клиент может открыть без входа. Токен — это случайный UUID; его нельзя угадать, перебирая числа — он соответствует ровно одному счёту.

Как работает токен доступа:

• Создание ссылки генерирует share_token для счёта и возвращает URL вида https://your-app/invoice/{token}.
• Если токен для этого счёта уже существует, Invotify возвращает тот же — повторная отправка не меняет ссылку и не ломает уже отправленный URL.
• Ссылка — единственное подтверждение. Любой, у кого она есть, может просмотреть счёт, поэтому обращайтесь с ней как с приватной ссылкой.
• Ссылку можно отозвать в любое время. При отзыве токен очищается, и старый URL немедленно перестаёт работать. Создайте новую ссылку для повторного предоставления доступа.

Разрешения: Создание или отзыв ссылки требует права «Управление счетами», поэтому только уполномоченные члены команды могут предоставить доступ к счёту.

Отправка PDF через WhatsApp, Telegram, Slack и другие: диалог «Поделиться» на счетах и предложениях передаёт готовый PDF напрямую в системный диалог отправки вашего устройства (на телефонах, планшетах и современных настольных браузерах). Нажмите WhatsApp, Telegram, Slack или Messenger — PDF уже прикреплён, выберите получателя и отправьте.

Когда клиент открывает ссылку для доступа, он попадает на чистую, оптимизированную для мобильных устройств страницу без необходимости входа. В зависимости от ссылки доступны два варианта.

Страница отдельного счёта (`/invoice/{token}`): Клиент видит полный счёт — название и логотип компании, номер и статус счёта, даты выставления и оплаты, реквизиты, каждую позицию с количеством и итогами, а также добавленные примечания. Внизу — действия: - Скачать PDF — создаёт и скачивает профессиональный PDF формата A4, идентичный отправляемому. Генерируется на сервере по запросу. - Оплатить — отображается только при наличии платёжной ссылки и если счёт ещё не оплачен (Pro).

Сводная страница портала (`/portal/{token}`): Обзор в стиле панели управления для клиента по всем его счетам у вас: - Задолженность — общая неоплаченная сумма по всем неоплаченным счетам (не только по одному) с флагом просрочки. - Баланс кредит-нот — имеющийся кредит клиента. - Список счетов — последние неживотные счета с постраничной навигацией, каждый с номером, датами, статусом, суммой и возможностью оплаты.

В плане Pro с подключённым Stripe портал превращает просмотр в оплату. Клиент нажимает «Оплатить» и попадает на безопасную хостинговую страницу оплаты Stripe — Invotify никогда не прикасается к данным карты.

Как проходит оплата через портал: 1. Клиент открывает счёт или сводный портал и нажимает «Оплатить» 2. Invotify создаёт сессию Stripe Checkout для этого счёта и перенаправляет клиента 3. Клиент оплачивает на хостинговой странице Stripe. Его email предзаполнен для ускорения оформления 4. При успехе клиент возвращается на страницу подтверждения; при отмене — обратно без ошибок 5. Stripe подтверждает платёж, и статус счёта автоматически меняется на «Оплачен»

Полные или частичные платежи: - По умолчанию клиент платит полный остаток задолженности (сумму к оплате, с учётом предыдущих частичных платежей) - При включённых частичных платежах клиент может оплатить меньшую сумму

Встроенные ограничения: - Уже оплаченные или отменённые счета нельзя оплатить повторно — кнопка «Оплатить» скрывается, запрос отклоняется на стороне сервера - Конечная точка оплаты портала ограничена по частоте запросов - Сумма проверяется по текущему остатку и минимальному платежу Stripe перед созданием сессии

Больше никаких сомнений, открыл ли клиент счёт. Каждый раз при просмотре общего счёта Invotify фиксирует это — вы точно знаете, когда они его увидели, сколько раз и откуда.

Что фиксируется при каждом просмотре: - Метка времени — когда произошёл просмотр - Источник — откуда пришёл просмотр: link (ссылка на отдельный счёт), email, portal или api - IP-адрес зрителя — IP-адрес клиента (из заголовка пересылки) - User-agent — строка браузера/устройства

Сводная статистика по счёту: - Количество просмотров — общее число открытий - Первый просмотр — точное время первого открытия (фиксируется однажды и никогда не перезаписывается) - Последний просмотр — самое последнее открытие - Уникальные IP — количество уникальных IP-адресов, просмотревших счёт

Где это отображается: Статистика просмотров счёта находится на его странице сведений — компактный значок показывает количество просмотров, при наведении — метки времени первого и последнего просмотра, а при недавнем открытии отображается живой индикатор.

Каждое письмо, которое Invotify отправляет клиенту, содержит ссылку на отписку/настройки, чтобы клиенты всегда контролировали, что попадает в их почтовый ящик. Ссылка работает без входа — токен отписки сам по себе подтверждает владение email-адресом.

Что клиенты могут контролировать: - Письма с документами — счета, коммерческие предложения и другие документы, отправленные им - Письма-напоминания — напоминания о просрочке и предстоящих платежах - Маркетинговые письма — рекламные или информационные сообщения

Каждая категория является независимым переключателем вкл/выкл. Клиент, желающий получать только счета без напоминаний, может настроить именно это.

Отписка в один клик: Страница настроек — та же поверхность, что и ссылка отписки в любом письме. Клиенты могут отключить отдельную категорию или отписаться от всего в одном месте. Изменения сохраняются немедленно и применяются к будущим отправкам.

Безопасность: - Конечная точка настроек требует действительного токена, который один авторизует чтение и обновление настроек — аккаунт не нужен - Принимаются только известные разрешённые ключи настроек и только логические значения