При запросе происходит поиск лида по одному из параметров (указаны в порядке приоритета поиска). При успешном поиске возвращается массив с данными о лиде/партнере.
Endpoint: GET /lead/
Parameters:
client_uid => (numbers only) ID контакта в CRM WinWinLand, может быть отрицательное значение.
client_phone => (numbers only). Если не указан client_uid, то производится поиск по номеру телефона. Будет выдан первый найденный контакт с этим номером.
client_email => Если не указан или не был найден контакт ни по client_uid, ни по client_phone, то производится поиск по email. Будет выдан первый найденный контакт с этим email.
client_tg => Поиск по telegram_id
client_vk => Поиск по vkontakte_id
order => (string). — не обязательно. Номер заказа. Если передано, то к результату будут добавлены данные по этому заказу, если он существует и относится к этому контакту
Response: 200, json
Структура данных, возвращаемых при успешном поиске:
Array
(
[secret] => не используется
[action] => не используется
[uid] => Уникальный идентификатор (client_uid) карточки в CRM WinWinLand
[first_name] => Имя
[last_name] => Фамилия
[phone] => Номер телефона
[email] => Электронная почта
[city] => Город
[telegram_id] => ID в Telegram
[telegram_nic] => Никнейм в Telegram
[vk_id] => ID ВКонтакте
[tm] => Временная метка (timestamp) создания записи
[comm] => Комментарий в карточке
[partner_id] => ID вышестоящего партнёра (если 0, значит, пользователь не привязан к партнеру)
[is_partner] => Флаг, указывающий, что это партнёр
[partner_code] => Партнёрский код пользователя (если партнер)
[cabinet_link] => ссылка на партнерский кабинет (если партнер)
[direct_code] => код для прямого доступа в партнерский кабинет. По этому коду партнер логинится в системе.
[bank_details] => реквизиты для выплаты вознаграждения, указанные в личном кабинете
[partner_data] => Array //Массив данных по партнеру (если партнер). Информация та же, что и в партнерском кабинете.
(
[cnt_reg_year] => Количество регистраций за год
[sum_buy_year] => Сумма покупок за год
[sum_fee_year] => Сумма комиссий за год
[sum_pay_year] => Сумма выплат за год
[cnt_reg_this_month] => Регистрации в текущем месяце
[sum_buy_this_month] => Покупки в текущем месяце
[sum_fee_this_month] => Комиссии в текущем месяце
[sum_pay_this_month] => Выплаты в текущем месяце
[cnt_reg_last_month] => Регистрации в прошлом месяце
[sum_buy_last_month] => Покупки в прошлом месяце
[sum_fee_last_month] => Комиссии в прошлом месяце
[sum_pay_last_month] => Выплаты в прошлом месяце
[cnt_reg_this_week] => Регистрации на текущей неделе
[sum_buy_this_week] => Покупки на текущей неделе
[sum_fee_this_week] => Комиссии на текущей неделе
[sum_pay_this_week] => Выплаты на текущей неделе
[cnt_reg_yesterday] => Регистрации за вчера
[sum_buy_yesterday] => Покупки за вчера
[sum_fee_yesterday] => Комиссии за вчера
[sum_pay_yesterday] => Выплаты за вчера
[cnt_reg_today] => Регистрации за сегодня
[sum_buy_today] => Покупки за сегодня
[sum_fee_today] => Комиссии за сегодня
[sum_pay_today] => Выплаты за сегодня
[sum_fee_all] => Общая сумма комиссий за всё время
[sum_pay_all] => Общая сумма выплат за всё время
[rest_all] => Остаток средств (разница между комиссиями и выплатами)
)
[current_order] => Array //массив данных по текущему оплаченному заказу (присутствует только, если вебхук был отправлен по событию "Покупка" или "Оплата")
[fee_detailed] =>array //начисления партнеру по операциям
(
[client_uid] => uid клиента, по продаже которому начислены комиссионные
[tm] => время операции (unix timestamp)
[first_name] => имя клиента
[last_name] => фамилия клиента
[order_number] => номер заказа
[order_descr] => продукт
[sum] => сумма заказа
[fee_percent] => вознагр в %
[fee_sum] => сумма начисленного вознаграждения
[level] => уровень в партнерской программе (1 - собственная продажа)
[partner_uid] => uid партнера, по продаже которого было начислено вознаграждение (либо собственная продажа)
[partner_name] => имя партнера, по продаже которого было начислено вознаграждение (либо собственная продажа)
[comm] => комментарий к операции, если был указан при ручном начислении
)
[fee_paid] => Array //выплаты партнеру по операциям
(
[tm] => время операции, timestamp
[sum_pay] => сумма оплаты
[vid] => Вид платежа. 1 - деньги, ...
[comm] => комментарий к платежу
)
[fee_orders] => Array //Заказы от рефералов
(
[tm]=> (timestamp) время заказа
[referal_uid] => uid реферала
[referal_name]=> имя реферала
[sum]=> сумма заказа
[paid]=> оплачен заказ или нет (1 или 0)
) ];
(
[tm] => Временная метка заказа
[pay_system] => Платёжная система
[sku] => Артикул товара
[order_id] => ID заказа
[order_number] => Номер заказа
[client_name] => Имя клиента (указанное при на заполнении платежной формы)
[phone] => Телефон клиента (указанное при на заполнении платежной формы)
[email] => Почта клиента (указанное при на заполнении платежной формы)
[uid] => ID клиента
[res] => Результат операции (1 — успешно)
[currency] => Валюта (0 — рубли)
[land_num] => Номер платежного лендинга
[comm] => Комментарий к заказу
[products] => Array //массив продуктов в составе заказа
(
[0] => Array
(
[product_id] => ID товара (соответствует номеру в справочнике продуктов)
[product_descr] => Наименование товара
[amount] => Стоимость товара
[tm_end] => Время окончания доступа (если 0 - то ограничения нет)
[fee_1] => Комиссия партнёра уровня 1 (значение заполнено, если при оплате был применен партнерский промокод, данные берутся из промокода. Если значение здесь указано,то данные для расчета комиссии будут браться отсюда, если нет,то будет взято значение из индивидуальных настроек для партнера,если и там нет - то из справочника продуктов.
[fee_2] => Комиссия партнёра уровня 2 (алгоритм то же)
)
)
[sum] => Общая сумма заказа
)
[promocodes] => Array //массив партнерских промокодов, доступных для использования (должен быть партнером)
(
[0] => Array
(
[id] => ID промокода
[tm1] => Начало действия
[tm2] => Окончание действия
[uid] => ID владельца промокода
[product_id] => Номер товара в системе, для которого действует промокод
[product_descr] => Наименование продукта
[discount] => Скидка. Если значение <100 , то считается, что это %, 100 и больше - считается в рублях
[price] => Фиксированная цена (если discount=0) (если обы значения 0 - то промокод дает нулевую цену)
[promocode] => Сам промокод
[fee_1] => Комиссия 1-го уровня для владельца (<100 - проценты, 100 и больше - рубли)
[fee_2] => Комиссия 2-го уровня для владельца
[cnt] => Ограничение на количество использований (-1 - без ограничений по количеству)
)
)