Skip to end of metadata
Go to start of metadata

You are viewing an old version of this page. View the current version.

Compare with Current View Page History

Version 1 Current »

для b2b проектов добавляем блок 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,       
}
  • No labels