> ## Documentation Index
> Fetch the complete documentation index at: https://docs.agencyhandy.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Выставление счетов по подписке и повторяющиеся счета в AgencyHandy

> Как AgencyHandy обрабатывает повторяющееся выставление счетов по подписке — автоматические счета, платёжные циклы, методы оплаты, отмены и платёжные ссылки Wise.

Система выставления счетов по подписке AgencyHandy позволяет автоматизировать весь процесс работы с повторяющимися доходами. Когда клиент подписывается на услугу, платформа создаёт ID подписки, генерирует заказы и автоматически выставляет счета в каждом платёжном цикле — будь то ежедневно, еженедельно, ежемесячно или ежегодно. Вы сохраняете полный контроль: можете просматривать данные подписок, отслеживать историю платежей, обрабатывать неудавшиеся платежи и отменять подписки при необходимости — всё в рамках AgencyHandy.

## Как работает выставление счетов по подписке

Жизненный цикл подписки в AgencyHandy включает шесть ключевых этапов.

<Steps>
  <Step title="Создайте услугу на основе подписки">
    Перейдите в **Services** и нажмите **Create New Service**. Выберите **Subscription** в качестве типа услуги.

    Определите:

    * **Billing Cycle** — ежедневно, еженедельно, ежемесячно или ежегодно
    * **Renewal Behavior** — создать новый заказ, обновить существующий или оставить без изменений
    * **Pricing & Payment Method** — PayPal, Stripe или вручную

    Нажмите **Publish**, чтобы сделать услугу доступной.
  </Step>

  <Step title="Клиент приобретает подписку">
    Клиент выбирает услугу по подписке, переходит к оформлению и выбирает метод оплаты.

    AgencyHandy автоматически:

    * Создаёт **ID подписки**
    * Генерирует **заказ**
    * Выставляет **счёт**

    Для оплат через **PayPal или Stripe** счёт мгновенно получает статус **Paid**. Для **ручной оплаты** счёт остаётся в статусе **Open** до подтверждения получения агентством.
  </Step>

  <Step title="Автоматическое повторяющееся выставление счетов">
    При каждой дате продления AgencyHandy автоматически обрабатывает платёж (для PayPal/Stripe) и генерирует следующий счёт.

    Если оплата прошла успешно, счёт получает статус **Paid**. В случае неудачи:

    * Счёт остаётся в статусе **Open**
    * Клиент получает **уведомление о неудавшемся платеже**
    * Агентство получает оповещение для повторной попытки или запроса обновлённых платёжных данных
  </Step>

  <Step title="Управление активными подписками">
    Перейдите в **Subscription Management** на левой боковой панели для просмотра всех активных и неактивных подписок. Выберите любую подписку, чтобы увидеть её полные данные.
  </Step>

  <Step title="Обработка отмен">
    При отмене подписки вы можете выбрать:

    * **Полная отмена** — прекратить все будущие платежи и заказы
    * **Сохранить последний активный заказ** — позволить клиенту продолжать получать услугу до окончания текущего периода

    Для полного удаления услуги все активные подписки на неё должны быть отменены.
  </Step>

  <Step title="Уведомления">
    Система автоматически отправляет:

    * **Напоминания о продлении** перед следующей датой выставления счёта
    * **Подтверждения оплаты** после успешных списаний
    * **Оповещения о неудавшихся платежах** как клиенту, так и администраторам агентства
  </Step>
</Steps>

## Страница деталей подписки

Страница деталей подписки даёт полное представление о любой отдельной подписке — от услуги и пакета до каждого счёта и записи журнала событий.

### Как получить доступ

1. Перейдите в **Subscriptions** на левой боковой панели
2. Нажмите на любую подписку из списка, чтобы открыть страницу её деталей

### Что вы можете увидеть

<Tabs>
  <Tab title="Информация о подписке">
    * **Название услуги** и **название пакета**
    * **Имя клиента**
    * **Платёжный цикл** (например, ежемесячно, ежегодно)
    * **Дата начала** и **дата окончания**
    * **Статус** подписки (активна или неактивна)
  </Tab>

  <Tab title="Платёжные данные">
    * **Стоимость подписки**
    * **Общее количество платежей** на сегодняшний день
    * **Метод оплаты** (Stripe, PayPal, Wise, банковский перевод вручную и др.)
    * **Дата следующего платежа**
  </Tab>

  <Tab title="История заказов">
    * **ID заказа**
    * **Статус** (например, Ongoing, Completed)
    * **Дата начала** и **срок выполнения** для каждого заказа
  </Tab>

  <Tab title="История счетов">
    * **ID счёта**
    * **Сумма**
    * **Статус** (Open, Paid и др.)
    * **Дата оплаты** и **срок оплаты**
  </Tab>

  <Tab title="Журналы событий">
    Хронологический журнал всех действий, связанных с подпиской — изменения статуса, события оплаты, отмены и прочее.
  </Tab>
</Tabs>

<Note>
  Одна подписка может иметь несколько связанных заказов и счетов. Счета, привязанные к подпискам, динамически обновляются при получении платежей.
</Note>

## Поддержка Wise для ручных счетов по подписке

Если вы принимаете международные платежи, вы можете встроить **платёжную ссылку Wise** непосредственно в счета по подписке. Это даёт клиентам удобный способ оплаты без необходимости вручную настраивать банковский перевод.

### Требования

* Активная учётная запись AgencyHandy
* Активная учётная запись **Wise** с действующей платёжной ссылкой

### Шаги по добавлению ссылки Wise в счёт

<Steps>
  <Step title="Откройте раздел счетов">
    Нажмите **Invoices** на левой боковой панели, затем нажмите **+ Create Invoice**.
  </Step>

  <Step title="Выберите клиента и заказ">
    Выберите клиента из выпадающего списка. Появятся все связанные ID заказов. Выберите нужный ID заказа и введите сумму и выставляемые позиции.
  </Step>

  <Step title="Примените скидки и налоги">
    Добавьте процент скидки, сумму скидки, оплаченную сумму, сумму к оплате и сведения о НДС/налогах. При необходимости укажите платёжный адрес и заметки.
  </Step>

  <Step title="Добавьте платёжную ссылку Wise">
    В разделе **Payment Method** выберите **Wise** в качестве способа оплаты. Вставьте вашу платёжную ссылку Wise в соответствующее поле.
  </Step>

  <Step title="Сохраните счёт">
    Нажмите **Save**, чтобы завершить создание счёта. Платёжная ссылка Wise появится в счёте, позволяя клиенту оплатить напрямую.
  </Step>
</Steps>

<Tip>
  Всегда перепроверяйте свою платёжную ссылку Wise и итоговые суммы счёта перед сохранением. Убедитесь в точности данных заказа, скидок и налоговой информации, чтобы избежать ошибок при выставлении счетов.
</Tip>

## Важные замечания о выставлении счетов по подписке

<Accordion title="Кто может отменять подписки?">
  Только **Супер-администраторы** и **Администраторы** могут отменять подписки. Клиенты не могут самостоятельно отменить свои подписки — они должны обратиться с запросом об отмене в агентство.
</Accordion>

<Accordion title="ID подписок постоянны">
  После создания подписки её ID не может быть изменён. Это обеспечивает последовательное отслеживание на протяжении всего срока подписки.
</Accordion>

<Accordion title="Неудавшиеся платежи и создание заказов">
  При неудавшемся платеже счёт остаётся в статусе Open, а для неоплаченного периода создаётся новый заказ. Статус подписки остаётся **Active** до тех пор, пока администратор вручную не повторит попытку оплаты или не отменит подписку.
</Accordion>

<Accordion title="Заказы с ручной оплатой">
  Если клиент платит вне Stripe или PayPal (например, банковским переводом), администратор должен вручную отметить счёт как **Paid** в AgencyHandy. Система не делает это автоматически для ручных платежей.
</Accordion>

<Accordion title="Незавершённые попытки самостоятельного оформления">
  Если клиент начинает оформление подписки, но не завершает оплату, он остаётся в системе как **лид** до успешного оформления подписки.
</Accordion>

<Accordion title="Сроки оплаты счетов">
  Сроки оплаты для счетов по подписке устанавливаются автоматически на основе настроенного вами платёжного цикла (например, ежемесячные счета подлежат оплате через месяц после даты начала).
</Accordion>
