Передача залишків на Хорошоп

Зміст

Загальна інформація

Створення Webhook

Додаткова інформація

Загальна інформація

За допомогою вихідного Webhook можна автоматично відправляти залишки товарів з KeepinCRM в Хорошоп при:

• Списанні
• Приході
• Поверненні

Тобто, в KeepinCRM є товар А, в якому залишки - 10 шт., при продажі (списанні) 2 шт. система автоматично відправить запит в Хорошоп з актуальною інформацією - 8 шт.

Важливо!

1. Відправка залишків тільки при руху товару (списанні/приході/поверненні)
2. Перевірка товару на Хорошоп проводиться по артикулу, якщо артикул не знайдено - товар не створиться

Створення Webhook

Щоб налаштувати передачу залишків потрібно створити тригер як на фото, змінивши тільки URL з url сайту

• Таблиця з даними - Журнал операцій
• Дія - Webhook
• URL - https://site.com/api/catalog/importResidues/ (замість site.com вказати свій сайт, все інше залишити)
• Метод відправки - POST
• Успішний статус запиту - 200
• Content-Type - application/json
• Тіло запиту:

{
 "token": "{{horoshop_access_token}}",
 "products": [
  {"article": "{{material.sku}}", "warehouse": "office", "quantity": {{material.available}}}
 ]
}

• Умова виконання - created_at

На фото приклад налаштованого тригера

Щоб протестувати коректність роботи, достатньо створити тригер, увімкнути його, далі перейти на будь-який товар і додати прихід або списати певну к-сть товару, далі перейти на товар в Хорошоп - к-сть повинна змінитись на ту, яка в KeepinCRM.

Додаткова інформація

• Обов'язково повинна бути активна інтеграція з Хорошоп
• Якщо увімкнено бронювання, то можна відправляти к-сть з поля "Доступно" (замість поля "В наявності"), для цього потрібно замінити material.available на material.stock_available
• Залишки по комплектації не передаються, оскільки списання виконується саме з товарів, які входять в комплект
• Ціни на товар по цьому Webhook оновлювати не можна, вони оновлюються через XML-файл
• Якщо потрібно відправляти залишки по певному складу (тільки якщо увімкнено об'єднаний склад), то в умові запуску тригера додається змінна stock_rest.office.name == 'Точна назва складу', а в тілі запиту потрібно змінити змінну з {{material.available}} на {{stock_rest.stock_available}}
• Якщо потрібно відправляти артикул товару (тільки якщо увімкнено об'єднаний склад), то використовується змінна {{offer.sku}}