Як передавати залишки товарів з KeyCRM на Wordpress

Розповідаємо, як синхронізувати залишки, щоб у всіх системах, що використовуються, були актуальні дані.
Написано Анастасія Останіна
Оновлено 3 тижні тому

Забезпечення актуальності залишків у всіх системах важливо для уникнення проблем з замовленнями на відсутні товари та своєчасного поповнення запасів.

Плагін інтеграції KeyCRM поки що підтримує тільки передачу замовлень, передачу залишків на сайт ви можете реалізувати з допомогою програміста та обміну даними з нашим API.

Підготовка до передачі даних

Незалежно від варіанта синхронізації даних, насамперед необхідно:

  1. Створити товари з артикулами в CRM: в ручну, імпортом з файлу, з публікацій або по API;
  2. Активувати та налаштувати складський облік;
  3. Завантажити початкові залишки в KeyCRM.

При цьому враховуйте основні моменти: 

  • Синхронізація товарів між системами відбувається по артикулу. Тому переконайтесь, що він однаковий в одному товарі в каталозі CRM і на сайті;
  • Кожен товар і варіант товару має мати свій унікальний артикул, оскільки виступає окремою одиницею складського обліку. Тому переконайтесь, що кожна варіація товару на сайті теж має свій унікальний артикул;
  • Для роботи з товарами по API вам може знадобитись ідентифікатор товару (productId) та варіанту товару (offerId) з CRM. Їх можна отримати у файлі експорту або запитами на отримання списку товарів чи варіантів товарів по API.
Зверніть увагу! В API KeyCRM є обмеження до 60 запитів на хвилину з однієї IP-адреси по API-ключу. Тому рекомендуємо налаштовувати паузу між запитами в 1 секунду, для запобігання перевищення ліміту.

Передача залишків з KeyCRM на Wordpress

Ви можете використовувати два основні методи реалізації:

  1. Отримувати всі залишки з певною періодичністю: для цього потрібно розмістити на сайті скрипт, який буде звертатись по API до KeyCRM, отримувати залишки по товарам і записувати їх відповідним товарам на сайті;
  2. Отримувати інформацію про зміну залишків в конкретному замовлені: для цього можна налаштувати відправку вебхука з KeyCRM на сайт на статус резерву чи списання товарів у замовлення та відповідно до цього змінювати залишки на сайті цих товарів.

Особливості отримання списку залишків

В методі отриманні списку залишків є декілька можливих фільтрів при формуванні запиту:

  • Фільтр за ідентифікатором варіанту товару — при вказані «offers_id» або декількох через кому (ідентифікатор варіанта товара в KeyCRM), будуть отримані залишки лише по вказаним варіантам;
  • Фільтр за sku варіанту товару — при вказані «offers_sku» або декількох через кому (артикул варіанта товару), будуть отримані залишки лише варіантам з цими артикулами;
  • Отримувати залишки по кожному складу окремо — додається масив «warehouse» з деталізацією залишків по кожному складу.

Як при отриманні загальних залишків по усім складам, так і при отриманні залишків по кожному складу окремо ви отримуєте кількість у двох полях:

  1. «quantity» — загальна кількість залишків;
  2. «reserve» — загальна кількість зарезервованих залишків.

Відповідно ви можете на стороні сайту від загального залишку віднімати резерв, щоб записувати кількість доступну до продажу з врахуванням резерву по товарам.

Приклад об'єкта отримання залишків по кожному складу:

"warehouse": [
        {
          "id": 1,  // ідентифікатор складу
          "name": "Основний",  // назва складу в CRM
          "quantity": 98,    // загальна кількість залишків
          "reserve": 8    // загальна кількість зарезервованих залишків
        },
       {
          "id": 2,  // ідентифікатор складу
          "name": "Магазин",  // назва складу в CRM
          "quantity": 35,    // загальна кількість залишків
          "reserve": 3    // загальна кількість зарезервованих залишків
        }
      ]  

Якщо у вас залишки вносяться на сайті чи ведуться в окремій складській програмі, ви можете обрати іншу схему для обміну даними.

Тепер ви можете забезпечити актуальність і точність залишків на своїх сайтах Wordpress, що дозволить ефективно працювати з замовленнями та вести складський облік в одному місці.

Теги: залишки, передача залишків на Wordpress, оновлення залишку, оновити кількість, товари по апі, залишки апі, синхронізація товарів, синхронізація залишків, вордпрес
Чи була наша стаття корисною?