# Хорошоп + Krokul CRM

Так, нативно. Krokul CRM приймає замовлення інтернет-магазину на Хорошопі вебхуком або опитуванням API. Замовлення стає угодою з товарами вашого каталогу, а покупець стає контактом. Статус замовлення синхронізується в обидва боки, а наявність і ціни зі складу Krokul повертаються в магазин.

**Статус:** Нативна. **Платформи автоматизації:** Zapier.

## Що отримує команда

### Нове замовлення одразу в угоді

Хорошоп надсилає замовлення на адресу підключення Krokul, щойно покупець його оформив. Krokul створює угоду «Хорошоп #…» у вибраній воронці, а кожен товар замовлення зіставляє з товаром каталогу Krokul за артикулом. Резерв ставиться на склад так само, як для угоди менеджера.

### Статус замовлення однаковий у магазині й у Krokul

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

### Наявність і ціни з одного складу

Krokul передає в Хорошоп залишок і ціну товару, коли вони змінюються на складі чи в прайсі Krokul. Магазин не продає товар, якого фізично немає, а менеджер оновлює ціну в одному місці.

### Повторний покупець без дубля

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

### Магазин без вебхуків на тарифі

Якщо тариф не дає вебхуків, Krokul опитує замовлення через API Хорошопу логіном і паролем API. Перший прохід лише запам’ятовує останнє замовлення, щоб у свіжу воронку не прийшла вся історія магазину; історію можна забрати окремим перемикачем.

## Що передається між системами

| Хорошоп | Krokul | Напрям | Коли |
|---|---|---|---|
| Замовлення (номер, сума) | Угода «Хорошоп #…» із зовнішнім ключем | Хорошоп → Krokul | Вебхук магазину або опитування API |
| Товари замовлення (артикул, кількість, ціна) | Рядки угоди з товарами каталогу | Хорошоп → Krokul | Разом з угодою |
| Покупець (ім’я, телефон, email) | Контакт: знайдений або новий | Хорошоп → Krokul | Разом з угодою і за вебхуком оновлення клієнта |
| Статус замовлення | Етап угоди | Хорошоп ↔ Krokul | Зміна етапу в Krokul або вебхук зміни статусу |
| Коментар до замовлення | Запис у стрічці угоди | Хорошоп → Krokul | Вебхук нового коментаря |
| Залишок і ціна товару | Склад і прайс Krokul | Krokul → Хорошоп | Зміна залишку чи ціни |

## Як підключити сьогодні

### Підключення в «Маркетплейсі»

1. У Krokul відкрийте «Маркетплейс» → «Хорошоп» і натисніть «Підключити». Krokul покаже адресу виду https://app.krokul.com/ingress/horoshop/<токен>.
2. Тариф Pro: у кабінеті Хорошопу додайте цю адресу у вебхуки на зміну статусу замовлення, оновлення клієнта й коментар. Нові замовлення Krokul забирає опитуванням API.
3. Для зворотного боку й тарифів без вебхуків заповніть у Krokul адресу магазину, логін і пароль API Хорошопу. Пароль зберігається зашифрованим.
4. Виберіть воронку, джерело, відповідального, склад для наявності і зіставте етапи угоди зі статусами замовлень. Кожне прийняте замовлення й кожне оновлення магазину видно в журналі підключення.

### Через Zapier

1. Тригер Хорошопу New Order або New User у Zapier.
2. Дія застосунку Krokul: створити угоду чи контакт, з пошуком контакту за телефоном або поштою перед створенням.
3. Нативне підключення робить те саме без Zapier і додає зворотний бік, тож Zapier підходить, коли замовлення треба ще й розіслати в інші сервіси.

**Тригери:** New Order; New User.

### Для інтеграторів

Угоди з Хорошопу запускають ті самі автоматизації й вебхуки Krokul, що й ручні. Події `card.created` і `card.statusChanged` приходять підписаними HMAC-SHA256 з журналом доставок. Товари зіставляються через зовнішні ключі `externalRef`, а для перевірки зв’язки є пісочниця з демо-даними й окремим ключем API.

[Документація API](https://app.krokul.com/api/v1/docs)

## Питання й відповіді

### Чи є в Krokul інтеграція з Хорошопом?

Так, нативна. Krokul приймає замовлення в угоди з товарами каталогу, синхронізує статус замовлення в обидва боки й повертає в магазин наявність і ціни.

### Який спосіб підключення Хорошопу вибрати?

На тарифі Pro вебхуки доставляють зміни статусу, оновлення клієнта й коментарі одразу. Нові замовлення Krokul забирає опитуванням API, тож вони з’являються з невеликою затримкою; на інших тарифах опитування покриває все.

### Чи потрапить у Krokul стара історія замовлень?

Типово ні. Перший прохід лише запам’ятовує останнє замовлення. Якщо історія потрібна, увімкніть «Забрати наявні замовлення на першому проході».

### Чи є Хорошоп у Zapier?

Так, з тригерами New Order і New User. Для зв’язки з Krokul він не обов’язковий, бо нативне підключення приймає замовлення напряму.

## Обмеження

Вебхуки Хорошоп дає на тарифі Pro; на інших тарифах Krokul забирає замовлення опитуванням API логіном і паролем, тобто з затримкою до наступного проходу. Вітрину, оформлення замовлення й оплату на сайті веде Хорошоп, Krokul веде продаж після замовлення.

## Пов’язані сервіси

- [Rozetka](https://krokul.com/uk/integrations/rozetka/index.md)
- [Prom.ua](https://krokul.com/uk/integrations/prom-ua/index.md)
- [Нова пошта](https://krokul.com/uk/integrations/nova-poshta/index.md)
- [Checkbox](https://krokul.com/uk/integrations/checkbox/index.md)
- [WooCommerce](https://krokul.com/uk/integrations/woocommerce/index.md)
- [Shopify](https://krokul.com/uk/integrations/shopify/index.md)

[Маркетплейси й магазини (Україна)](https://krokul.com/uk/integrations/category/marketplaces-ua/index.md)

Хорошоп є торговою маркою її власника. Krokul не афілійований з Хорошопом.

Оновлено: 2026-10-12

---

Застосунок: https://app.krokul.com/ · API: https://app.krokul.com/api/v1/docs