У попередній статті Індивідуальні поля в замовленнях: покрокові налаштування для Мобільної торгівлі. Частина 1 ми ознайомили Вас з новим функціоналом – трьома додатковими полями Властивість замовлення 1, Властивість замовлення 2, Властивість замовлення 3, яким можна присвоювати будь-які назви й формувати для них будь-які списки значень. Зазначені поля належать до загальної інформації про замовлення і відображаються для всіх типів документів.
У цій статті мова піде про додаткові поля, які можна налаштовувати безпосередньо для товарів, причому набір полів можна варіювати залежно від обраного типу замовлень (типу документів).
Пропонуємо ознайомитися з налаштуванням додаткових полів на прикладі такого завдання:
- Необхідно реалізувати можливість вибору типу замовлення з двох варіантів: замовлення нового товару або повернення товару з торгової точки.
- Для позицій товару, які йдуть на повернення, потрібно вказати термін придатності товару.
- Також для повернутих позицій необхідно налаштувати можливість вибирати подальші дії – утилізувати товар або відправити на склад.
1. Створення типів замовлення
За допомогою API v2 внесемо дані про типи замовлень, які в мобільному застосунку відображаються в полі «Тип документа». У нашому прикладі це два типи: Замовлення та Повернення. Створення та оновлення типів замовлень виконується через API методом POST /EditOrderType. Під час формування запиту заповнюються такі атрибути:
- OrderType_Id — ідентифікатор типу замовлення (порядковий номер значення у списку «Тип документа»).
- OrderType_Name — назва типу замовлення, яка відображається в мобільному застосунку.
- Show_Fields — перелік користувацьких полів замовлення, які повинні відображатися для вибраного типу документа. Якщо необхідно відобразити кілька полів, вони вказуються через кому, наприклад: OrderUserField_1,OrderUserField_2,OrderUserField_3. Якщо додаткові поля для типу замовлення не потрібні, цей параметр не заповнюється.
Кожен тип замовлення передається окремим API-запитом. Після виконання запиту система повертає відповідь з результатом операції — успішне створення або повідомлення про помилку.
Для видалення раніше створених типів замовлень використовується окремий метод DELETE, у якому вказується ідентифікатор типу замовлення, що потрібно видалити.
Зверніть увагу! В атрибуті Show_Fields вказано значення OrderUserField_1. Це означає, що для типу замовлення Повернення буде відображатися Користувацьке поле замовлення 1.
Зазначимо також, що якщо в відображенні користувацьких полів нема потреби, то типи замовлення можна створити наступним чином. Зайдемо в Довідники – Мобільна торгівля – Тип замовлення, натиснемо на панелі управління кнопку «+» і у вікні Додавання запису в полі Тип замовлення вкажемо найменування:
За допомогою даного функціоналу також зручно видаляти та редагувати типи замовлень, використовуючи кнопки панелі управління.
2. Налаштування поля Термін придатності за допомогою Користувацького поля замовлення
Далі необхідно виконати налаштування користувацьких полів замовлення. У нашому прикладі використано тільки одне поле OrderUserField_1 (для типу замовлення Повернення) – Користувацьке поле замовлення 1. Зайдемо в Налаштування таблиць 1 в панелі Довідник, виділимо рядок Документи/Моб.агент (Товари) 2. У підлеглому вікні відкриється список полів. Подвійним клацанням миші по рядку Корист. поле замовлення 1 3 викличемо вікно Редагування запису. У вкладці Загальні 4 в Поле 5 змінимо найменування (у нашому прикладі – Термін придатності), в полі Тип даних 6 вкажемо необхідний формат введення даних (у нашому прикладі – дата). Перейдемо до вкладки Моб. застосунок 7 і вимкнемо перемикач «Пок. (mobile)».
Зверніть увагу! Перемикач «Пок. (mobile)» активуємо лише у разі, якщо користувацьке поле замовлення потрібно відображати для всіх типів замовлення.
Якщо ж користувацьке поле замовлення має відображатися не для всіх типів, перемикач «Пок. (mobile)» залишаємо вимкненим, а під час заповнення API в атрибуті Show_Fields параметра OrderTypes для потрібного типу замовлення вказуємо необхідність відображення цього користувацького поля.
За потреби аналогічні дії повторимо для корист. поля замовлення 2, корист. поля замовлення 3.
3. Створення поля з випадаючим списком за допомогою поля Значення типу замовлення
Перейдемо до виконання третьої умови нашого прикладу: для типу замовлення Повернення необхідно додати для товарів поле Дія з товаром з можливістю вибору значення з випадаючого списку – Утилізувати товар або Відправити на склад. Можливість вибору для товару значення з випадаючого списку реалізується за допомогою відображення і налаштування поля Значення типу замовлення.
Зайдемо в Налаштування таблиць 1 в панелі Довідник, виділимо рядок Документи/Моб. агент (Товари) 2. У підлеглому вікні відкриється список полів. Подвійним клацанням миші по рядку Значення типу замовлення 3 викличемо вікно Редагування запису. У вкладці Загальні 4 в Поле 5 змінимо найменування (у нашому прикладі – Дія з товаром), у вкладці Моб. застосунок 6 переводимо перемикач Пок (Mobile) в активне положення.
Далі за допомогою API v2 створимо список значень, які можна буде присвоювати новому перейменованому полю «Дія з товаром». У нашому прикладі це значення: «Відправити на склад» та «Утилізувати».
Передача значень виконується через API методом POST /EditOrderTypeValues. Під час формування запиту для кожного значення заповнюються такі атрибути:
- OrderType_Id – ідентифікатор типу замовлення, для якого створюються значення. У нашому випадку використовується значення 2, оскільки дані створюються для типу замовлення «Повернення».
- OrderTypeValue_Id – ідентифікатор значення типу замовлення (порядковий номер у списку). Для значення «Відправити на склад» використовується 1, для «Утилізувати» – 2.
OrderTypeValue_Name – назва значення типу замовлення, яка відображається в інтерфейсі для відповідного поля замовлення.
Після виконання запиту система повертає відповідь з результатом обробки – успішне створення значень або повідомлення про помилку.
Для видалення раніше створених значень використовується окремий метод DELETE відповідного API.
4. Відображення полів у мобільному застосунку
Далі перевіримо виконані налаштування додаткових полів у мобільному застосунку. Перейдемо на екран Замовлення, вкладку Документ 1. Виберемо значення для полів Напрямок 2 і Торгова точка 3. Детальніше про формування замовлення, використання товарного напрямку тощо ви можете дізнатися зі статті Замовлення в торгових точках.
У полі Тип документа 4 виберемо необхідний пункт зі створеного випадаючого списку (у нашому випадку Замовлення або Повернення). Перейдемо до вкладки Товари 5, в якій побачимо створені нами поля Термін придатності та Дія з товаром. Натиснувши на необхідний рядок з товаром, перейдемо до вікна редагування. Вкажемо термін придатності товару 6 і виберемо з випадаючого списку потрібну дію: Відправити на склад або Утилізувати 7. Збережемо зміни.
Використання додаткових полів, розглянутих у цій статті, дозволяє індивідуально налаштувати внесення інформації про товари в замовленні, спрощуючи торговим агентам процес створення замовлень, оформлення повернень тощо.
Якщо Вас зацікавив описаний функціонал – ми готові продемонструвати його роботу, виконати необхідні налаштування і надати доступ до сервісу. Для цього залиште заявку на сайті ANT-Logistics.
