Як надсилати залишки з KeyCRM в інтернет-магазини

Розповідаємо, як налаштувати передачу залишків, щоб у всіх системах, що використовуються, були актуальні дані.
Написано Вадим Крижевський
Оновлено 6 місяців тому

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

Якщо у вас розміщений інтернет - магазин на CMS (WordpressOpencart, PrestaShop, CS-Cart, інші) чи власна розробка, то для передачі залишків на інтернет - магазин ви можете скористатися допомогою програміста та реалізувати обмін даними за допомогою нашого API.

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

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

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

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

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

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

Передача залишків з KeyCRM на інтернет - магазин

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

  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    // загальна кількість зарезервованих залишків
        }
      ]  

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

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

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