Page Comparison

Table of Contents

Panel

panelIconId	1f195
panelIcon	:new:
panelIconText	🆕
bgColor	#DEEBFF

для b2b проектов добавляем блок customer_details в Получение списка заказов

(Скоро) Нові параметри для замовлень по дропшіпінгу

Для /api/customer-groups/export:

dropshipping - показуепоказує, чи включені для цієї групи опції дропшипінгу

Для Отримання списку замовлень:

новий блок параметрів dropshipping_details
в масиві delivery_data новий параметр ownTTNPicked — вказує, чи додавдропшипер свій номер ттн ТТН та/або завантажив свій файл з накладною.

Экспорт групп покупателей

...

Експорт груп покупців

Функція /api/customer-groups/export

Code Block

language	json

// запрос
{
    "token" : "1b360dca3d4e837b6091fdb07470eaf3"
}

Пример ответа:Приклад відповіді

Code Block

{
    "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"]
            }
        ]
    }
}

...

Імпорт користувачів

В импорт пользователей добавлены параметры імпорт користувачів додано параметри:

группа покупателягрупа покупця
баланс счетарахунку
валюта балансабалансу
менеджер
ссылка посилання на сайт
компанія
компанияпосададолжность

Приклад запиту

Code Block

language	json

// запрос
{
  "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": "Должность"
  }]
}

...

Експорт користувачів

В экспорт пользователей добавлены експорт користувачів додано поля:

группа покупателягрупа покупця
баланс счетарахунку
валюта балансабалансу
менеджер
ссылка посилання на сайт
компания
должностькомпанія
посада

Приклад запиту

Code Block

// ответ
{
  "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": ""
    }]
  }
}

...

Імпорт товарів в каталог

В импорт товаров добавлен импорт цен разных типов: імпорт товарів додано імпорт цін різних типів.

Приклад запиту

Code Block

language	json

// запрос
{
    "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.

Info

Обратите внимание: в массиве Зверніть увагу: у масиві price_levels необходимо передавать только те типы цен, которые были созданы вами в разделе Клиенты → Типы цен.

Розничную цену по-прежнему необходимо передавать через свойство price. Иначе вы получите ошибку:

Импорт цен для уровня необхідно передавати тільки ті типи цін, які були створені вами в розділі Клієнти → Типи цін.

Роздрібну ціну, як і раніше, необхідно передавати через властивість price. Інакше ви отримаєте помилку: Імпорт цін для рівня "2" ("level_id") объекта массива об'єкта масиву "price_levels" осуществляется другим способом

Экспорт уровней цен

...

здійснюється іншим чином.

Експорт рівнів цін

Функція /api/price-levels/export

Пример запроса:Приклад запиту

Code Block

language	json

{
    "token" : "1b360dca3d4e837b6091fdb07470eaf3"
}

Пример ответа:Приклад відповіді

Code Block

language	json

{
    "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 - название типа цены для группы покупателя

...

- - назва типу ціни для групи покупця

Приклад відповіді

Code Block

{
  "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 буде присутній тільки у разі, якщо замовлення було оформлене користувачем з групи з включеним дропшипінгом.

Приклад відповіді

Code Block

{
    "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, який вказує на те, чи вказав дропшипер свій номер ттн та/або завантажив свій файл з накладною.

Приклад відповіді

Code Block
"delivery_data": { "ownTTNPicked": true, }

Versions Compared

Old Version 1

New Version Current

Key

Экспорт групп покупателей

Експорт груп покупців

Імпорт користувачів

Експорт користувачів

Імпорт товарів в каталог

Экспорт уровней цен

Експорт рівнів цін

Додаткові дані в Отриманні списку замовлень customer_details

Додаткові дані в Отримані списку замовлень dropshipping_details

Власна накладна в замовлені