От архива до первой выдачи.
Свяжите свои лоты FunPay с товарами Birgen Store и управляйте автовыдачей из Cardinal.
Настройте Cardinal по шагам. Не выключайте тестовый режим, пока не проверили баланс, товар, лот и цену.
Подготовьте Cardinal
Проверьте, что Cardinal работает, его Telegram-бот отвечает, а связь с FunPay стабильна. У лотов, которые привяжете к Birgen, отключите другую автовыдачу, чтобы покупатель не получил два разных сообщения.
Создайте доступ к API магазина
В боте Birgen Store откройте Профиль → Мой API и создайте ключ. Сохраните ключ и секрет при выдаче, затем пополните баланс магазина, с которого будут идти закупки. Открыть бота ↗
Установите три файла
Скачайте архив плагина. Поместите birgen_supplier.py, birgen_order_guard.py и supplier_margin_lock.py в plugins/ Cardinal. Перед заменой одноимённых файлов и базы storage/cache/birgen_supplier.sqlite3 сохраните копии. Перезапускайте Cardinal после завершения текущих покупок и выдач.
Подключите магазин
В Telegram-боте Cardinal откройте /birgen → ⚙️ Настройки → 🔐 Настроить API-ключи. Отправьте ключ, затем секрет отдельными сообщениями. Плагин удаляет их после получения. Снова откройте /birgen: API должен быть настроен, баланс — доступен.
Выберите товар
Сначала нажмите /birgen → 🆕 Обновить товары у поставщика и дождитесь обновления каталога. Затем откройте 📦 Мои товары → ➕ Добавить из каталога поставщика. Найдите товар по названию или через «Добавить по ID API». Проверьте Birgen ID, цену, остаток и вариант. Новый товар сначала выключен.
Привяжите лот FunPay
В карточке товара откройте 🔗 Привязанные лоты / отвязать → ➕ Привязать ID. Введите цифровой ID своего лота из ссылки вида funpay.com/lots/offer?id=123456. Проверьте ID лота и цену продажи. Один лот привязывается к одному товару Birgen.
Настройте цену и проверьте
Для напрямую привязанного лота в ₽ кнопка «Маржа» позволяет задать прибыль в рублях или процент. Проверьте итоговую цену: плагин учитывает комиссию FunPay 6%. При необходимости выберите интервал остатков, включите товар и запустите ⚙️ Настройки → 🧪 Полный тест без покупки. Сначала устраните все найденные проблемы.
Включите выдачу
После проверки баланса, лота, наличия и цены выключите тестовый режим и включите автовыдачу в /birgen. После первого заказа смотрите «Очередь», «Проблемы и ручная обработка» и «Журнал операций».
После запуска
Если заказ требует внимания, сначала проверьте очередь и список проблем. При неизвестном результате отправки плагин оставляет заказ для ручной проверки: повторную закупку вслепую не запускайте.
Частые вопросы при настройке
Почему товар недоступен?
Обновите каталог и цену/остаток в карточке товара. Проверьте наличие Birgen, баланс, прямую привязку лота и включение товара. Если остаток неизвестен, плагин может выключить привязанный лот.
Почему тестовый заказ ничего не покупает?
В тестовом режиме плагин останавливается до закупки. Запустите полный тест и переключите режим на рабочий только после проверки лота, цены, баланса и остатка.
Что делать при неизвестном результате выдачи?
Откройте очередь, список проблем и журнал операций. Не запускайте вторую закупку, пока не проверили исходный заказ у поставщика.