Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

...

Panel
panelIconId1f195
panelIcon:new:
panelIconText🆕
bgColor#DEEBFF

Новый блок New block customer_details в Получение списка заказов

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

...

in Get order list

New parameters for dropshipping orders

For /api/customer-groups/export:

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

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

  • новий блок параметрів dropshipping_details

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

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

    ...

    • shows whether dropshipping options are enabled for this group

    For Get order list:

    • new dropshipping_details parameter block

    • in the delivery_data array, a new parameter ownTTNPicked - indicates whether dropshipperhas added the invoice number and/or uploaded the invoice file.

    Export of customer groups

    Function/api/customer-groups/export

    Code Block
    languagejson
    // запросquery
    {
        "token" : "1b360dca3d4e837b6091fdb07470eaf3"
    }

    Пример ответаResponse example:

    Code Block
    {
        "status": "OK",
        "response": {
            "customer_groups": [
                {
                    "id": 1,
                    "title": "АнонимныеUnregistered посетителиvisitors",
                    "visible_price_level": {
                        "id": 2,
                        "title": "РозничнаяRetail ценаprice"
                    },
                    "product_visibility": {
                        "id": 3,
                        "title": "ПолныйFull доступaccess кto товарамproducts"
                    },
                    "show_residues_near_status": false,
                    "show_price_list": false,
                    "dropshipping": false,
                    "available_payment_methods": ["12", "13"],
                    "available_delivery_methods": ["3", "8"]
                },
                {
                    "id": 3,
                    "title": "ОптовіWholesale користувачіcustomers",
                    "visible_price_level": {
                        "id": 2,
                        "title": "РозничнаяRetail ценаprice"
                    },
                    "product_visibility": {
                        "id": 3,
                        "title": "ПолныйFull доступaccess кto товарамproducts"
                    },
                    "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"]
                }
            ]
        }
    }

    Импорт пользователей

    В импорт пользователей добавлены параметры:

    ...

    группа покупателя

    ...

    баланс счета

    ...

    валюта баланса

    ...

    менеджер

    ...

    ссылка на сайт

    ...

    компания

    ...

    Users import

    Added parameters to users import:

    • customer group

    • account balance

    • balance currency

    • manager

    • website link

    • company

    • position

    Code Block
    languagejson
    // запросquery
    {
      "token": "4bb2ecabecb205256c20ac0d37c050e8",
      "users": [{
        "email": "email.123@gmail.com",
        "customer_group_id": 3, //idcustomer группыgroup покупателейid
        "balance": 5000,
        "balance_currency": 1,
        "manager_id": 61,
        "site_link": "url.com",
        "company": "НазваниеCompany компанииname",
        "role": "ДолжностьPosition"
      }]
    }

    Экспорт пользователей

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

    ...

    группа покупателя

    ...

    баланс счета

    ...

    валюта баланса

    ...

    менеджер

    ...

    ссылка на сайт

    ...

    компания

    ...

    Export users

    Added fields to export users:

    • customer group

    • account balance

    • balance currency

    • manager

    • website link

    • company

    • position

    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, //idcustomer группыgroup покупателейid
          "balance": 122,
          "balance_currency": 2,
          "manager": {
            "id": 61,
            "name": "aasdasdasd",
            "phone": 380994565789
          },
          "site_link": "asdasdasd",
          "company": "dasdasdasd",
          "role": ""
        }]
      }
    }

     

    Импорт товаров в каталог

    ...

    Import products into catalog

    Added import of prices of different types to Import products:

    Code Block
    languagejson
    // запросquery
    {
        "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 should be passed in a separateprice_levels array .

    Info

    Обратите внимание: в массиве Please note: in the price_levels необходимо передавать только те типы цен, которые были созданы вами в разделе КлиентыТипы цен.

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

    Импорт цен для уровня array, only the price tiers you created in CustomersPrice tiers need to be passed in.

    The retail price still needs to be passed through the price property. Otherwise, you will get an error:

    Import of prices for level "2" ("level_id") объекта массива of the "price_levels" осуществляется другим способом

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

    ...

    array object is performed in a different way

    Export price levels


    Function/api/price-levels/export

    Пример запросаQuery example:

    Code Block
    languagejson
    {
        "token" : "1b360dca3d4e837b6091fdb07470eaf3"
    }

    Пример ответаResponse example:

    Code Block
    languagejson
    {
        "status": "OK",
        "response": {
            "price_levels": [
                {
                    "id": 1,
                    "title": "СкрытьHide ценыprices"
                },
                {
                    "id": 2,
                    "title": "ЦенаPrice"
                },
                {
                    "id": 3,
                    "title": "ОптоваяWholesale ценаprice 1"
                },
                {
                    "id": 4,
                    "title": "ОптоваяWholesale ценаprice 2"
                }
            ]
        }
    }

    ...

    Additional data in Get order list customer_details

    В Получение списка заказов добавляем дополнительные данные о покупателе - группу, к которой он относится и тип цены, назначенной этой группеIn Get order list additional data about the customer is added - the group he belongs to and the type of price assigned to this group.

    • customer_details — массив дополнительных данных о покупателе для b2b-проектовarray of additional customer data for B2B projects

      • group

        • id - id группы покупателей, к которой принадлежит покупательtitle - название группы покупателей, к которой принадлежит покупательID of the customer group to which the customer belongs

        • title - name of the customer group to which the customer belongs

      • price_level

        • id - id типа цены для группы покупателя

        • title - название типа цены для группы покупателя

    ...

        • ID of the price tier for the customer group

        • title - name of the price tier for the customer group

    Response example:

    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": "КиевKyiv",
            "delivery_address": "ОтделениеBranch №13 (до 30 кг на одно место): ул. Оранжерейная, 3 (метро Дорогожичи) Dorohozhytska St, 4",
            "delivery_type": {
              "id": 3,
              "title": "НовойNova Poshta почтойBranch"
            },
            "delivery_price": -1,
            "comment": "КомментарийOrder к заказуcomment",
            "payment_type": {
              "id": 13,
              "title": "НаличнымиIn cash"
            },
            "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": "ДилерыDealers"
                        },
                        "price_level": {
                            "id": 3,
                            "title": "ЦенаWholesale для оптаprice"
                        }
                    ................

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

    В Отримання списку замовлень додаємо новий блок параметрів для замовлень, які були оформлені з опцією дропшипінгу. Блок dropshipping_details буде присутній тільки у разі, якщо замовлення було оформлене користувачем з групи з включеним дропшипінгом.

    ...

    Additional data in the Get order list dropshipping_details

    In the Get orders list a new block of parameters was added for orders that were placed with the dropshipping option. The dropshipping_details block will be present only if the order was placed by a user from a group with dropshipping enabled.

    Response example:

    Code Block
    {
        "status": "OK",
        "response": {
            "orders": [
                {
                    "order_id": 158,
                    "user": 12,
                    ...
                    "customer_details": {
                        "group": {
                            "id": 2,
                            "title": "ЗарегистрированныеRegistered пользователиcustomers"
                        },
                        "price_level": {
                            "id": 2,
                            "title": "РозничнаяRetail ценаprice"
                        }
                    },
                    "dropshipping_details": {
                        "recipient_payment_price": 40211,
                        "dropshiper": {
                            "name": "asdasdasd",
                            "phone": "+38 (065) 465-46-54"
                        }
                    }
                }
            ]
        }
    }

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

    В Отримання списку замовлень в масиві delivery_data новий параметр ownTTNPicked, який вказує на те, чи вказав дропшипер свій номер ттн та/або завантажив свій файл з накладною.

    ...

    Own invoice in the order

    In the Get order list in the delivery_data array, a new parameter ownTTNPicked, which indicates whether the dropshipper has indicated his invoice number and/or uploaded his invoice file.

    Response example:

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