У цій статті ми розповімо Вам про функціонал, який буде корисний багатьом користувачам модуля Мобільна торгівля. Він дозволить торговому агенту зручно і швидко вносити інформацію, якої немає в стандартних полях замовлення. Дане рішення також спростить передачу необхідної інформації від торгових агентів на сервіс ANT-Logistics або в облікову систему (наприклад, 1С).
Для замовлень в мобільному застосунку додано три додаткові поля – Властивість замовлення 1, Властивість замовлення 2, Властивість замовлення 3. Цим полям можна присвоювати будь-які назви й формувати для них будь-які списки значень. Наприклад, це можуть бути поля «Склад» зі списком доступних складів, «Пріоритет замовлення» зі списком значень пріоритету, «Тип оплати» зі списком можливих способів оплати тощо.
Для використання функціоналу виконаємо налаштування відображення полів властивості замовлення. Зайдемо в Налаштування таблиць 1, виділимо рядок Документи/Моб. агент (замовлення) 2. У підлеглому вікні відкриється список полів. Подвійним клацанням миші по рядку Властивості замовлення 1 3 викличемо вікно Редагування запису 4. У вкладці Загальні 5 в Поле 6 змінимо найменування (у нас в прикладі – Тип оплати), у вкладці Моб. застосунок в полі Пок. (mobile) активуємо перемикач..
Далі за допомогою API v2 створимо список значень, які можна буде присвоювати новому перейменованому полю «Тип оплати». У нашому випадку це значення: Готівка, Термінал, Передоплата.
Передача значень виконується з використанням методу POST /EditOrderProperty. Під час формування запиту заповнюються такі атрибути:
- OrderProperty_Index – індекс властивості замовлення. У цьому прикладі використовується значення 1, оскільки список значень створюється для поля «Властивість замовлення 1», перейменованого в «Тип оплати» (для поля «Властивості замовлення 2» потрібно вказати число 2, для поля «Властивості замовлення 3» – відповідно 3).
- OrderProperty_Id – ідентифікатор значення у списку (порядковий номер). Для значення Готівка використовується 1, для Термінал – 2, для Передоплата – 3.
- OrderProperty_Name – назва значення, яка буде відображатися у списку.
Кожне значення списку передається окремим API-запитом. Після виконання запиту система повертає відповідь з результатом обробки даних – успішне виконання операції або повідомлення про помилку.
Коректність створення списку значень можна перевірити, отримавши поточні властивості замовлення через відповідний GET-запит та переконавшись, що всі значення для поля «Тип оплати» додані.
Після виконаних дій нове перейменоване поле (Тип оплати) і список його значень (Готівка, Термінал, Передоплата) будуть відображатися при створенні замовлення в мобільному застосунку.
Зверніть увагу! Для оновлення даних може знадобитися авторизуватися заново – виконати вихід і повторно увійти в мобільний застосунок.
Якщо виникла необхідність видалити раніше створені значення зі списку Властивостей замовлення, використовується окремий метод API v2 — DELETE /DeleteOrderProperty.
Наприклад, щоб прибрати зі списку значень пункт «Готівка» і залишити лише «Термінал» та «Передоплата», необхідно виконати DELETE-запит із такими параметрами:
- index — індекс властивості замовлення, з якої видаляється значення. У нашому випадку використовується значення 1, оскільки поле «Тип оплати» є перейменованим полем «Властивість замовлення 1».
- id — ідентифікатор значення, яке потрібно видалити. Для значення «Готівка» використовується ідентифікатор 1 (який був заданий під час створення списку).
Після виконання запиту система повертає відповідь з результатом операції — успішне видалення значення або повідомлення про помилку у разі некоректно переданих параметрів.
При необхідності аналогічним чином можна перейменувати й присвоїти список значень для полів Властивості замовлення 2 і Властивості замовлення 3. Після цього у користувачів Мобільна торгівля буде додано для замовлень три поля з індивідуальним наповненням.
У наступній частині ми розповімо Вам про додаткові поля, які можна відображати окремо для різних типів документів. У цих полях буде вказуватися інформація по кожному товару в замовленні.
Якщо Вас зацікавив описаний функціонал – ми готові продемонструвати його роботу, виконати необхідні налаштування і надати доступ до сервісу. Для цього залиште заявку на сайті ANT-Logistics.
