Інтеграція
Розробники вашої компанії можуть підключити до WMS бухгалтерську чи ERP-систему. Ще до написання коду адміністратор налаштовує сторону WMS у десктоп-застосунку Клієнт, у розділі Адміністрування. Цей розділ описує таке налаштування. Наприкінці у вас буде все, що потрібно коду для першого запиту.
Як це влаштовано
Інтеграція складається з двох речей, які ви створюєте в Клієнті:
- Технічний користувач — обліковий запис для програми, а не для людини. Він входить за токеном замість пароля й має доступ лише до інтеграційних ендпоінтів, більше ні до чого у WMS. Як і будь-який користувач, він отримує доступ через членство в групі доступу — див. Права доступу.
- Зовнішня система — запис про саму підключену систему. Він вказує на її технічного користувача й визначає, що системі дозволено: її можливості, як обробляються дублікати та конфліктні зміни, і з якими складами вона може працювати.
Зовнішня система пов'язана з технічним користувачем, а не з конкретним токеном. Коли ви видаєте технічному користувачу новий токен, зовнішня система продовжує працювати вже з ним.
Вибір, який ви робите на зовнішній системі, пояснюють довідники: Можливості інтеграції, Режими дедуплікації, Політики конфлікту власності. Стани токенів описано в Статуси технічних токенів.
Порядок налаштування
Увесь процес зібрано на одній сторінці: Налаштування інтеграції. Кожен крок нижче веде на власну сторінку.
- Створіть технічного користувача. Дайте йому ім'я та код і ввімкніть його.
- Надайте доступ. Додайте його до групи доступу так само, як і людину.
- Видайте токен. Сирий токен показується лише один раз, тож скопіюйте його одразу. Технічний користувач має один активний токен: видача нового відкликає поточний, тож усе, що ще використовує старий токен, уже не може увійти (сеанс, який воно вже мало, завершиться за кілька хвилин).
- Зареєструйте зовнішню систему. Оберіть її код і назву, прив'яжіть технічного користувача та задайте можливості й налаштування поведінки. Код неможливо змінити після створення системи.
- Задайте область складів. Або дозвольте всі склади, або перелічіть ті, з якими система може працювати. Якщо глобальний доступ вимкнено, а список порожній, система не має доступу до жодного складу.
- Передайте розробнику. Див. контрольний список нижче.
Контрольний список передачі
Передайте розробнику три речі:
- Код компанії — те, що на екрані входу в Клієнт показано як поле Компанія (в англійському інтерфейсі — Tenant). Він визначає, до якої компанії належать запити.
- Сирий токен — показується один раз під час видачі. Якщо його втрачено, видайте новий (це відкликає попередній).
- Код зовнішньої системи — код, який ви обрали під час реєстрації системи.
Ліміт ліцензії
Технічні користувачі займають технічні місця вашої ліцензії. Коли всі місця зайняті, увімкнення ще одного технічного користувача завершується помилкою, а інтеграцію може бути відхилено під час входу, якщо технічні місця ліцензії перевищено. Щоб побачити, скільки у вашої компанії технічних місць і скільки використано, відкрийте в Клієнті, у розділі Адміністрування, пункт Ліцензія.
Для розробника
Маючи ці три речі, розробник підключає вашу систему через інтеграційне API:
- Основи API — вхід, заголовки, помилки та клієнт, на якому побудовано всі приклади;
- Формування payload — як записуються дані та ідентифікатори;
- Імпорт, Стрічка змін, Повна ресинхронізація і Залишки на дату — операції обміну;
- Приклад: ідентифікатори в прийманні — один документ туди й назад.
Що робити з конфліктами власності та дедуплікації, описано в статті Конфлікти.