B2B функционал
- Natalia Chernichko
- Elena
- Dmitro Bevza
Новый блок customer_details в Получение списка заказов
Нові параметри для замовлень по дропшіпінгу
Для /api/customer-groups/export:
dropshipping - показує, чи включені для цієї групи опції дропшипінгу
Для Отримання списку замовлень:
новий блок параметрів dropshipping_details
в масиві delivery_data новий параметр ownTTNPicked — вказує, чи додав дропшипер свій номер ЕН та/або завантажив свій файл з накладною.
Экспорт групп покупателей
Функция /api/customer-groups/export
// запрос
{
"token" : "1b360dca3d4e837b6091fdb07470eaf3"
}Пример ответа:
{
"status": "OK",
"response": {
"customer_groups": [
{
"id": 1,
"title": "Анонимные посетители",
"visible_price_level": {
"id": 2,
"title": "Розничная цена"
},
"product_visibility": {
"id": 3,
"title": "Полный доступ к товарам"
},
"show_residues_near_status": false,
"show_price_list": false,
"dropshipping": false,
"available_payment_methods": ["12", "13"],
"available_delivery_methods": ["3", "8"]
},
{
"id": 3,
"title": "Оптові користувачі",
"visible_price_level": {
"id": 2,
"title": "Розничная цена"
},
"product_visibility": {
"id": 3,
"title": "Полный доступ к товарам"
},
"show_residues_near_status": false,
"show_price_list": false,
"dropshipping": true,
"available_payment_methods": ["12", "13", "14", "15", "16"],
"available_delivery_methods": ["3", "8", "22"]
}
]
}
}
Импорт пользователей
В импорт пользователей добавлены параметры:
группа покупателя
баланс счета
валюта баланса
менеджер
ссылка на сайт
компания
должность
// запрос
{
"token": "4bb2ecabecb205256c20ac0d37c050e8",
"users": [{
"email": "email.123@gmail.com",
"customer_group_id": 3, //id группы покупателей
"balance": 5000,
"balance_currency": 1,
"manager_id": 61,
"site_link": "url.com",
"company": "Название компании",
"role": "Должность"
}]
}
Экспорт пользователей
В экспорт пользователей добавлены поля:
группа покупателя
баланс счета
валюта баланса
менеджер
ссылка на сайт
компания
должность
// ответ
{
"status": "OK",
"response": {
"users": [{
"id": 1,
"title": "asdasdasd",
"email": "email.123@gmail.com",
"phone": "",
"country": "",
"city": "",
"address": "",
"registered": "2020-01-16 15:42:27",
"customer_group_id": 3, //id группы покупателей
"balance": 122,
"balance_currency": 2,
"manager": {
"id": 61,
"name": "aasdasdasd",
"phone": 380994565789
},
"site_link": "asdasdasd",
"company": "dasdasdasd",
"role": ""
}]
}
}
Импорт товаров в каталог
В импорт товаров добавлен импорт цен разных типов:
// запрос
{
"token": "{{token}}",
"products": [
{
"article": "BH-12345",
"price": 1500,
"price_old": 1600,
"price_levels": [
{
"level_id": 3,
"price": 1000
},
{
"level_id": 4,
"price": 900
},
{
"level_id": 5,
"price": 800
},
{
"level_id": 6,
"price": 700
}
]
}
]
}Уровни цен необходимо передавать отдельным массивом price_levels.
Обратите внимание: в массиве price_levels необходимо передавать только те типы цен, которые были созданы вами в разделе Клиенты → Типы цен.
Розничную цену по-прежнему необходимо передавать через свойство price. Иначе вы получите ошибку:
Импорт цен для уровня "2" ("level_id") объекта массива "price_levels" осуществляется другим способом
Экспорт уровней цен
Функция /api/price-levels/export
Пример запроса:
{
"token" : "1b360dca3d4e837b6091fdb07470eaf3"
}Пример ответа:
{
"status": "OK",
"response": {
"price_levels": [
{
"id": 1,
"title": "Скрыть цены"
},
{
"id": 2,
"title": "Цена"
},
{
"id": 3,
"title": "Оптовая цена 1"
},
{
"id": 4,
"title": "Оптовая цена 2"
}
]
}
}
Дополнительные данные в Получении списка заказов customer_details
В Получение списка заказов добавляем дополнительные данные о покупателе - группу, к которой он относится и тип цены, назначенной этой группе.
customer_details — массив дополнительных данных о покупателе для b2b-проектов
group
id - id группы покупателей, к которой принадлежит покупатель
title - название группы покупателей, к которой принадлежит покупатель
price_level
id - id типа цены для группы покупателя
title - название типа цены для группы покупателя
Пример ответа:
{
"status": "OK",
"response": {
"orders": [
{
"order_id": 7,
"user": 6,
"delivery_name": "John Doe",
"delivery_email": "john.doe@gmail.com",
"delivery_phone": "+38 (055) 555-55-55",
"delivery_city": "Киев",
"delivery_address": "Отделение №13 (до 30 кг на одно место): ул. Оранжерейная, 3 (метро Дорогожичи)",
"delivery_type": {
"id": 3,
"title": "Новой почтой"
},
"delivery_price": -1,
"comment": "Комментарий к заказу",
"payment_type": {
"id": 13,
"title": "Наличными"
},
"payment_price": 0,
"payed": 0,
"total_default": 3413,
"total_sum": 3413,
"total_quantity": 2,
"discount_percent": 0,
"discount_value": 0,
"coupon_code": "",
"coupon_percent": 0,
"coupon_discount_value": 0,
"coupon_type": 0,
"stat_status": 2,
"stat_created": "2021-04-09 12:09:01",
"currency": "UAH",
"order_without_callback": false,
"customer_details": {
"group": {
"id": 4,
"title": "Дилеры"
},
"price_level": {
"id": 3,
"title": "Цена для опта"
}
................
Додаткові дані в Отримані списку замовлень dropshipping_details
В Отримання списку замовлень додаємо новий блок параметрів для замовлень, які були оформлені з опцією дропшипінгу. Блок dropshipping_details буде присутній тільки у разі, якщо замовлення було оформлене користувачем з групи з включеним дропшипінгом.
Приклад відповіді
{
"status": "OK",
"response": {
"orders": [
{
"order_id": 158,
"user": 12,
...
"customer_details": {
"group": {
"id": 2,
"title": "Зарегистрированные пользователи"
},
"price_level": {
"id": 2,
"title": "Розничная цена"
}
},
"dropshipping_details": {
"recipient_payment_price": 40211,
"dropshiper": {
"name": "asdasdasd",
"phone": "+38 (065) 465-46-54"
}
}
}
]
}
}
Власна накладна в замовлені
В Отримання списку замовлень в масиві delivery_data новий параметр ownTTNPicked, який вказує на те, чи вказав дропшипер свій номер ттн та/або завантажив свій файл з накладною.
Приклад відповіді
"delivery_data": {
"ownTTNPicked": true,
}