Ми помітили, що користувачі Planfix дедалі частіше цікавляться додаванням QR-кодів до завдань. На жаль, наразі в системі немає готового рішення чи інтеграції з сервісами для генерації QR-кодів. Але тимчасово вирішити ситуацію допоможе сервіс Integromat. У ньому ми будемо формувати QR-код із посиланням на завдання в Planfix, щоб комірники або кур’єри могли швидко відкрити потрібне замовлення в мобільному застосунку.

Одразу зазначу: для новачків у Planfix ця замітка може здатися складною, тож запасіться терпінням і чаєм. Ми віримо, що ви з усім розберетеся 🙂

Тим, хто ще не працював із сервісом Integromat, радимо ознайомитися з нашою довідкою. У ній покроково описано відносно простий приклад використання сервісу для отримання курсу валют у поля завдання Planfix.

Перш ніж переходити до налаштувань, скажу кілька слів про те, навіщо це все потрібно.

Уявіть ситуацію: клієнт зробив замовлення на доставку товару, у Planfix з’явилося нове завдання. Менеджер його опрацьовує та зміною статусу запускає процес формування QR-коду для складу. Після цього він повертається до інших завдань.

Коли Integromat поверне в завдання QR-код, Planfix автоматично додасть його до потрібного поля, змінить статус і сповістить комірників про готовність замовлення. Комірники видрукувати QR-код і почнуть формувати посилку.

Для налаштування цього процесу нам знадобиться 2 сценарії в Planfix і 3 модулі в Integromat.

Починаємо.

Крок №1: Додаємо перший модуль в Integromat

На першому етапі нам потрібно “подружити” Planfix з Integromat, щоб вони спілкувалися між собою як найкращі друзі:

Planfix:
— Привіт, Integromat! Ось тобі дані завдання. Катя просила зробити QR-код.

Integromat:
— Привіт, Planfix! Сьогодні ти рано 🙂 Тримай QR-код і передай Каті, що я все зробив, як вона просила.

Щоб налагодити таку взаємодію між системами, додаємо до сценарію Integromat модуль Webhooks і копіюємо з нього посилання. На нього з Planfix ми надсилатимемо дані завдання.

Обираємо потрібну подію вебхука:

Додаємо його до модуля кнопкою «Add»:

Надаємо назву й зберігаємо:

Копіюємо посилання вебхуку кнопкою та переходимо до Planfix:

Крок №2: Налаштування першого сценарію Planfix

Налаштовуємо автоматичний сценарій, який реагуватиме на зміну статусу завдання:

А потім надсилатиме POST-запит із даними в Integromat:

У полі URL вставляємо скопійоване з Integromat посилання на вебхук і додаємо до нього такі параметри:

id	Ідентифікатор завдання	{{Task.Identifier}}
uri	Посилання на завдання	https://ваш_акаунт.planfix.com/task/{{Task.Number}}
num	Номер завдання	{{Task.Number}}
user	Виконавці завдання	{{Task.Assignee.Identifier}}

Тепер у Planfix створюємо тестове завдання та змінюємо його статус на «Сформувати QR-код». Спрацює автоматичний сценарій і надішле в Integromat дані:

Можна продовжувати налаштування Integromat.

Крок №3: Додаємо другий модуль Integromat

Для автоматичного формування QR-коду в Integromat є спеціальний модуль — Barcodes. Додаємо його до сценарію й заповнюємо поля змінними з Planfix:

• У полі Barcode type обираємо «QR Code»
• У полі Text вставляємо змінну uri, щоб після сканування переходити до завдання
• У полі File name вставляємо змінну num, що містить номер завдання, та вказуємо формат майбутнього QR-коду

Крок №4: Додаємо третій модуль Integromat

На цьому етапі ми використовуємо API Planfix, щоб завантажити згенерований QR-код у завдання й повідомити про це виконавців.

Щоб звернутися до Planfix через API, оберіть модуль HTTP → Make a Basic Auth request і сформуйте запит:

У полі Credentials додаємо нове підключення:

• Key name — Назва підключення
• Username — APIKey з акаунта Planfix
• Password — Token з акаунта Planfix

Переходимо до налаштування HTTP-запиту:

• URL — адреса для API-запитів (копіюємо зі сторінки «Управління акаунтом» → «Доступ до API»)
• Method — обираємо POST
• Headers і Query String — залишаємо порожніми
• Body type — Raw
• Content type — XML (application/xml)
• Request content — вставляємо XML-запит із довідки API Planfix і підставляємо відповідні змінні.

<?xml version="1.0" encoding="UTF-8"?>
<request method="file.upload">
  <account>Назва_вашого_акаунта_в_Planfix</account>
  <task>
    <id>{{8.id}}</id>
  </task>
  <files>
    <file>
      <name>{{9.fileName}}</name>
      <sourceType>FILESYSTEM</sourceType>
      <body>{{base64(9.data)}}</body>
    </file>
  </files>
  <notifiedList>    
    <users>
      <id>{{join(split(8.user; ","); "</id><id>")}}</id>
    </users>
  </notifiedList>
</request>

Зберігаємо налаштування.

Не забудьте увімкнути сценарій Integromat:

Тепер Integromat надсилатиме QR-код у коментар до завдання Planfix і повідомлятиме виконавця. Так зроблено навмисно, адже автоматизація іноді затримується, і формування QR-коду займає трохи часу — який можна використати на інші завдання. Навіщо просто сидіти й чекати, правда ж?

На цьому етапі налаштування автоматичного отримання QR-коду в Planfix можна вважати завершеним.

Останній штрих у налаштуванні

Не знаю, як вам, а мені все ж хочеться додати ще один сценарій у Planfix — який візьме QR-код із коментаря, додасть його в спеціальне поле, змінить статус завдання та повідомить наступний у ланцюжку підрозділ — склад — про готовність замовлення.

Для цього вказуємо такі тригер і умови для спрацювання сценарію в першому і другому блоці налаштувань:

А потім докладно вказуємо, що саме має виконати сценарій:

Ось тепер точно все 🙂

Сподіваюся, цей матеріал буде корисним тим, хто мріє працювати з QR-кодами в Planfix, але ще не знав, із чого почати.

---

Залишилися питання? Пишіть нам у Службу підтримки. Ми з радістю відповімо на всі ваші запитання. Покращуйте свої робочі процеси за допомогою Planfix.