Админская таблица

Админская таблица — это полная база данных реферальной программы со всеми партнёрами, их связями, балансами и операциями.

В таблице пять листов:

«Реферальные связи» — справочник всех связей между партнёрами и рефералами.
«Балансы партнёров» — финансовые показатели по каждому партнёру в каждой валюте.
«История транзакций» — история всех начислений, выплат и оплат балансом.
«Запросы на вывод» — заявки партнёров на выплаты: ожидающие, подтверждённые и отклонённые.
«Приглашённые партнёры» — список приглашённых партнёров и их статусы.

Лист «Реферальные связи»

Лист «Реферальные связи» содержит справочник всех связей между партнёрами и рефералами в реферальной программе. Каждая строка — это одна связь, то есть пара «партнёр — реферал». Если у одного партнёра пять рефералов, в листе будет пять строк с этим партнёром в роли пригласившего и пятью разными рефералами.

«Дата подключения партнёра» — момент, когда партнёр стал участником программы. Если подключение прошло по ссылке другого партнёра — это дата перехода по ссылке. Если напрямую через бот — это дата подключения к боту.
«Toolsy ID партнёра», «Telegram ID партнёра», «Username партнёра», «Имя партнёра», «Фамилия партнёра» — данные пригласившего. Если у партнёра несколько рефералов — данные партнёра повторяются в каждой строке его реферальной связи.
«Уровень» — номер уровня в цепочке для этой связи. Уровень 1 — прямое приглашение, уровни 2 и глубже — связи через посредников в цепочке.
«Дата подключения реферала» — момент, когда реферал перешёл по ссылке партнёра и стал участником программы.
«Toolsy ID реферала», «Telegram ID реферала», «Username реферала», «Имя реферала», «Фамилия реферала» — данные реферала.
«Количество платежей с вознаграждением» — сколько платежей реферала принесёт партнёру вознаграждение, если на уровне задан лимит платежей.
«Срок начисления вознаграждения» — до какой даты с платежей реферала начисляется вознаграждение, если на уровне задан срок.

Лист «Балансы партнёров»

Лист «Балансы партнёров» содержит финансовые показатели по каждому партнёру в каждой валюте, в которой он получает вознаграждения. Если партнёр зарабатывает в трёх валютах, у него в листе три строки — по одной на каждую валюту.

«Дата подключения» — момент, когда партнёр стал участником программы. Если подключение прошло по ссылке другого партнёра — это дата перехода по ссылке. Если напрямую через бот — это дата подключения к боту.
«Toolsy ID партнёра», «Telegram ID партнёра», «Username партнёра», «Имя партнёра», «Фамилия партнёра» — данные партнёра.
«Количество рефералов» — суммарное количество рефералов партнёра на всех уровнях цепочки, включая прямых рефералов на уровне 1 и всех более глубоких рефералов на уровнях 2, 3 и далее. Например, если у партнёра один прямой реферал, который в свою очередь привёл двух своих рефералов, в счётчике будет 3.
«Валюта» — валюта, в которой считаются все финансовые показатели строки.
«Общая сумма начислений» — сколько партнёр всего заработал за всё время, без учёта возвратов.
«Общая сумма оплат балансом» — сколько партнёр потратил с реферального баланса на оплату тарифов за всё время.
«Общая сумма выплат» — сколько партнёр вывел (считаются только подтверждённые заявки).
«Актуальный баланс» — сколько у партнёра сейчас на балансе.
«Сумма в задержке» — сколько из актуального баланса пока недоступно для вывода, потому что не прошёл срок задержки выплаты.
«Доступно для вывода» — деньги, которые партнёр уже может запросить к выплате. Показатель равен разнице между актуальным балансом и суммой в задержке.

Лист «История транзакций»

Лист «История транзакций» содержит историю всех движений по балансам партнёров — начисления, оплаты балансом и выплаты.

«Дата транзакции» — момент совершения операции.
«Тип транзакции» — одно из трёх значений: «Начисление», «Оплата балансом», «Выплата».
«Валюта транзакции» — валюта, в которой прошла операция.
«Toolsy ID партнёра», «Telegram ID партнёра», «Username партнёра», «Имя партнёра», «Фамилия партнёра» — данные партнёра, у которого произошла операция.
«Уровень» — номер уровня в цепочке, по которому прошло начисление. Заполняется только для начислений. Для оплат балансом и выплат стоит прочерк, потому что эти операции не привязаны к уровню.
«Toolsy ID реферала», «Telegram ID реферала», «Username реферала», «Имя реферала», «Фамилия реферала» — данные реферала (заполняется только для начислений — когда оплата реферала принесла партнёру вознаграждение). Для остальных типов — прочерк.
«Тариф» — название тарифа, по которому прошла операция. Для начисления — тариф, который купил реферал. Для оплаты балансом — тариф, который купил партнёр. Для выплаты — прочерк.
«Стоимость» — стоимость тарифа. Для начисления — сколько заплатил реферал. Для оплаты балансом — сколько стоил тариф, который купил партнёр. Для выплаты — прочерк.
«Конвертация из валюты» и «Конвертация из суммы» — заполняются, когда вознаграждение начислено в одной валюте, а оплата реферала прошла в другой. Показывают исходную валюту и исходную сумму, из которых сделан пересчёт. Если валюта оплаты и валюта вознаграждения совпадают — прочерк.
«Вознаграждение» — фактически применённая ставка для этого начисления. Например «5%» или «50 USD». Заполняется только для начислений. Для остальных типов транзакций — прочерк.
«Сумма транзакции» — итоговая сумма, повлиявшая на баланс. Для начисления — положительная. Для оплаты балансом и выплаты — отрицательная.
«Номер платежа с вознаграждением» — номер платежа по счёту, если на уровне задан лимит платежей. Например «3» — третий платёж реферала, принёсший вознаграждение. Заполняется только для начислений. Для остальных типов транзакций — прочерк.
«Задержка выплаты (дней)» — сколько дней задержки действовало для этого начисления, если в реферальной программе настроена задержка выплаты. Заполняется только для начислений. Для остальных типов транзакций — прочерк.
«Дата окончания задержки» — дата, когда сумма начисления выходит из «Суммы в задержке» и переходит в «Доступно для вывода», если в реферальной программе настроена задержка выплаты. Заполняется только для начислений. Для остальных типов транзакций — прочерк.
«Баланс после операции» — актуальный баланс партнёра после этой транзакции в валюте операции.

Лист «Запросы на вывод»

Лист «Запросы на вывод» содержит все заявки партнёров на вывод средств — и обработанные, и ожидающие обработки. Лист работает как журнал заявок — в нём видны все запросы и их статусы.

«Дата запроса» — момент, когда партнёр отправил заявку из бота.
«Toolsy ID партнёра», «Telegram ID партнёра», «Username партнёра», «Имя партнёра», «Фамилия партнёра» — данные партнёра, отправившего заявку.
«Валюта» — валюта, в которой партнёр запрашивает вывод.
«Сумма» — запрошенная партнёром сумма к выводу.
«Минимальная выплата» — порог минимальной выплаты для этой валюты на момент создания заявки. Справочная колонка: показывает, какой порог действовал, когда партнёр отправлял заявку.
«Статус» — одно из трёх значений: «Ожидает» — заявка создана и ждёт обработки; «Подтверждён» — деньги переведены партнёру и заявка помечена как обработанная; «Отклонён» — в выплате отказано и заявка помечена как отклонённая.
«Дата обработки» — момент, когда статус заявки был изменён с «Ожидает» на «Подтверждён» или «Отклонён». Для заявок в статусе «Ожидает» — прочерк.
«Комментарий» — комментарий к заявке, в большинстве случаев — причина отклонения.

Лист «Приглашённые партнёры»

Лист «Приглашённые партнёры» содержит список пользователей, добавленных в режиме «Приглашённые партнёры».

«Дата приглашения» — момент, когда пользователь был добавлен в список через раздел «Приглашённые партнёры» в Toolsy.
«Toolsy ID», «Telegram ID», «Username», «Имя», «Фамилия» — данные приглашённого партнёра.
«Статус» — текущий статус партнёра: «Вкл» или «Выкл». При статусе «Вкл» программа работает для партнёра как обычно. При статусе «Выкл» программа для партнёра выключена, даже если в целом она активна для всех.

Лист заполняется, когда в реферальной программе используется режим «Приглашённые партнёры». Если режим не используется, лист пустой.