Info | ||
---|---|---|
| ||
Доступно з версії 3.23.0 |
Функция Функція users/import
Параметры запросаПараметри запиту
- token - ключ авторизации полученный через функцию авторизації, отриманий через функцію auth
- users - список импортируемых пользователейімпортованих користувачів
- users[i].title -
- ПІБ користувача (обов'язкове поле)
- users[i].email - Email
- користувача (
- обов'язкове,
- унікальне поле)
- users[i].phone - Номер
- телефону (
- з кодом
- країни)
- users[i].country -
- Країна доставки користувача за замовчуванням (не використовується, якщо вимкнена функція вибору країн у замовленні)
- users[i].city -
- Місто доставки користувача за замовчуванням
- users[i].address -
- Адреса доставки користувача за замовчуванням
- users[i].discount_card -
- Персональна знижка користувача
- users[i].discount_card.discount -
- розмір знижки (%)
- users[i].discount_card.active -
- увімкнення/вимкнення персональної знижки
- users[i].discount_card.date_limit -
- термін дії знижки (Формат
- РРРР-ММ-ДД)
- users[i].discount_card.status - статус
- знижки
- 1 -
- підтверджена
- 2 -
- очікує на підтвердження
- 3 -
- відхилена
Info | ||
---|---|---|
| ||
Нові параметри для Хорошоп b2b начиная с версии з версії 4.0 |
- users[i].customer_group_id - id группы покупателей, к которой относится пользовательгрупи покупців, до якої належить користувач
- users[i].balance - сумма баланса пользователя, может быть отрицательнойсума балансу користувача, може бути від'ємною
- users[i].balance_currency - валюта баланса пользователябалансу користувача
- users[i].manager_id- id менеджера магазинамагазину, закрепленного закріпленого за пользователемкористувачем
- users[i].site_link - строкарядок, ссылка посилання на сайт пользователякористувача
- users[i].company - строка, название компании пользователярядок, назва компанії користувача
- users[i].role - строкарядок, должность пользователя посада користувача в компаниикомпанії
Параметры ответаПараметри відповіді
- status - Статус выполнения запросавиконання запиту
- OK - Все пользователи запроса были успешно добавлены/обновленыУсіх користувачів запиту було успішно додано/оновлено
- WARNING - Некоторые пользователи не были добавлены/обновленыДеякі користувачі не були додані/оновлені
- response.log - Журнал обновленияоновлення
- response.log[i].code - Код сообщений повідомлень (смдив. таблицу нижетаблицю нижче)
- response.log[i].message - Расшифровка сообщения
...
- Розшифровка повідомлення
Коди повідомлень журналу
Код | ЗначениеЗначення | |
---|---|---|
0 | Пользователь был успешно импортирован/обновлёнКористувача було успішно імпортовано/оновлено | |
1 | Пропущены обязательные Пропущені обовʼязкові поля | |
2 | Ошибка валидации полейПомилка валідації полів | |
3 | Необработанная ошибкаНеоброблена помилка |
Приклад запиту
Code Block | title | Пример запроса
---|
POST http://<DOMAIN>/api/users/import/ Content-Type: application/json { "token": "<TOKEN>", "users": [ { "title": "ИвановСвириденко ИванПетро ИвановичОлександрович", "email": "ivan@mail.net", "phone": "+380631234567", "country": "УкраинаУкраїна", "city": "КиевКиїв", "address": "улвул. ПушкинаСагайдачного, д. Колотушкина16", "discount_card": { "discount": 3, "active": true, "date_limit": "2019-01-01", "status": 1 } }, { "title": "ИвановаСвириденко ЕленаОлена ОлеговнаОлегівна", "email": "elena@mail.net", "phone": "+380631234567", "country": "УкраинаУкраїна", "city": "КиевКиїв", "address": "улвул. КрещатикХрещатик, д. 1", "discount_card": { "discount": 3, "active": true, "date_limit": "2020-01-01", "status": 1 } }, { "email": "some@email" } ] } |
Приклад запиту
Code Block | title | Пример ответа
---|
{ "status": "WARNING", "response": { "log": [ { "info": [ { "code": 0, "message": "Обновление пользователя ivan@mail.net завершено успешно!" } ] }, { "info": [ { "code": 0, "message": "Обновление пользователя elena@mail.net завершено успешно!" } ] }, { "info": [ { "code": 1, "message": "Поле email (some@email) задано некорректно!" } ] } ] } } |
...