Правила закупки

Правило закупки — это конкретное указание внутри конфигурации: «для такого-то заказа купи у поставщика вот этот товар и передай ему вот эти данные».

Когда приходит заказ, сервис смотрит, какие правила конфигурации подходят под выбор покупателя, и покупает всё, что подошло.

Создание правила

Откройте связь товара → конфигурацию → вкладку Закупка и нажмите Добавить правило. Форма состоит из трёх частей.

Варианты маркетплейса

Если у товара на маркетплейсе есть варианты (регион, номинал, издание — всё, что выбирает покупатель), отметьте, при каких вариантах срабатывает это правило. Правило подойдёт, только если заказ содержит все отмеченные варианты.

Тумблер «Требовать точное совпадение вариантов» делает проверку строже: заказ не должен содержать никаких других вариантов, кроме отмеченных.

У товара без вариантов эту часть можно пропустить.

Товар поставщика

Выберите товар и вариант из каталога подключённых поставщиков — с поиском, ценами и остатками.

Каталог товаров поставщиков с выбором варианта

Количество к покупке — сколько единиц купить у поставщика.
Тумблер «Фиксированное количество закупки» (включён по умолчанию) — покупать ровно указанное количество, независимо от того, сколько штук заказал покупатель. Выключите его, если количество должно умножаться на количество из заказа — например, покупатель взял 3 штуки, сервис купит 3.

Поля поставщика

Некоторым товарам поставщика нужны данные для исполнения: логин аккаунта, регион, ID игрока. Для каждого поля выберите источник значения:

Постоянное значение — одно и то же для всех заказов. Например, регион «TR».
Текстовое поле заказа — значение берётся из того, что покупатель ввёл при покупке на маркетплейсе. Например, логин Steam. Выберите, из какого поля товара маркетплейса брать значение.

Поля с пометкой «Обязательное» нужно заполнить обязательно. Галочка «Учитывать ошибку валидации этого поля у поставщика» означает: если поставщик считает значение некорректным, заказ по этому правилу не пройдёт предпроверку — покупатель не сможет оплатить заказ с опечаткой в логине.

Несколько правил — наборы товаров

В конфигурации может быть несколько правил, в том числе к разным поставщикам. Все правила, совпавшие с заказом, покупаются вместе — так собираются наборы.

Готовые правила видны на вкладке «Закупка» конфигурации:

Вкладка «Закупка» конфигурации с двумя правилами закупки

Примеры

Пополнение Steam. Товар без вариантов, у поставщика — поле логина. Одно правило: товар поставщика «Steam Wallet», поле логина — источник «Текстовое поле заказа», то есть логин, который покупатель ввёл при покупке. Галочка проверки поля включена — заказ с опечаткой в логине не пройдёт предпроверку.

Ключ с регионами. У товара варианты «Регион: РФ» и «Регион: Мир». Два правила: для «РФ» — товар поставщика «Ключ RU», для «Мир» — «Ключ Global».

Игровая валюта с сервером. Например, кристаллы Genshin Impact: покупатель выбирает номинал и сервер, а в текстовое поле вводит ID игрока. В правиле можно отметить сразу два варианта — номинал и сервер, — чтобы оно сработало именно для этого сочетания, а в полях поставщика указать сервер постоянным значением, а ID взять из текстового поля заказа. И так — по правилу на каждое продаваемое сочетание.

Издание с бонусом. Для варианта «Издание: Deluxe» — два правила в одной конфигурации: «Ключ игры» и «Ключ DLC». Оба совпадут с заказом, и покупатель получит два ключа сразу.

Как правила работают при заказе

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