no-translate

Синхронізація залишків з keyCRM на власний сайт

Розповідаємо, як налаштувати передачу залишків, щоб у всіх системах, що використовуються, були актуальні дані.
Written by Анастасія Останіна
Updated 1 month ago

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

З деякими конструкторами є вбудована передача залишків, зокрема на Wix, Хорошоп та Shopify. Якщо у вас самописний сайт чи інший конструктор сайтів, то для передачі залишків на сайт ви можете скористатися допомогою програміста та реалізувати обмін даними за допомогою нашого API.

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

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

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

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

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

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

Передача залишків з keyCRM на сайт

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

  1. Отримувати всі залишки з певною періодичністю: для цього потрібно розмістити на сайті скрипт, який буде звертатися до API keyCRM, отримувати залишки по товарах і записувати їх відповідним товарам на сайті. Цей варіант зручніший для періодичної повної звірки залишків;
  2. Отримувати інформацію про зміну залишків: для цього можна налаштувати відправку вебхука з keyCRM на сайт. Так ви отримаєте саме оновлений залишок товару відразу після його зміни в CRM. 
Зверніть увагу! Для реалізації цих методів потрібен програміст, який напише скрипт для вашого сайту, що виконує необхідні операції для обміну даними.

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

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

  • Фільтр за ідентифікатором варіанту товару — при вказанні «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    // загальна кількість зарезервованих залишків
        }
      ]  

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

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

Теги: залишки, передача залишків на сайт, лендінг, конструктор сайтів, оновлення залишку, оновити кількість, товари по апі, залишки апі, синхронізація товарів, синхронізація залишків, скрипт отримання залишків на сайті
Did this answer your question?