Так. Krokul CRM інтегрується з маркетплейсом Епіцентр через Merchant API продавця. Замовлення з кабінету Епіцентру стає угодою з товарами вашого каталогу, а покупець стає контактом. Назад в Епіцентр ідуть статус замовлення, номер ТТН і коментарі менеджера, а ціни й наявність оферів оновлюються зі складу Krokul.
Krokul запитує /v4/oms/orders з фільтром filter[updatedAt][from] і проходить сторінки курсором. Кожне нове замовлення стає угодою «Епіцентр № …» у воронці підключення, а номер замовлення стає її зовнішнім ключем. Позиції замовлення зіставляються з товарами каталогу Krokul за артикулом продавця, тому резерв на складі ставиться одразу. Повторне читання дубля не створює.
Менеджер підтверджує замовлення в Krokul, і угода переходить на етап «Підтверджено». Krokul читає дозволені переходи з /v2/oms/orders/{orderId}/allowed-statuses і викликає change-status з кодом confirmed_by_merchant. Для скасування Krokul передає причину з довідника Епіцентру, наприклад product_not_available, і закриває угоду як програну з тією самою причиною.
Відправлення Новою поштою чи Укрпоштою менеджер створює в угоді. Номер ТТН Krokul записує в замовлення методом PATCH /v1/oms/orders/{orderId}/shipment-number. За документацією Епіцентру цей номер вмикає трекінг і завершує замовлення, коли посилку забрано, а статус completed закриває угоду як виграну.
Коли змінюється залишок чи ціна товару, Krokul надсилає пакет у POST /v1/offers з полями availability і prices.price за артикулом. Епіцентр приймає до 1000 позицій в одному запиті й повертає requestId. За ним Krokul читає результат кожної позиції, а позиції зі статусом skipped чи forbidden показує в журналі з кодом помилки.
Коментарі до замовлення з /v2/oms/orders/{orderId}/comments з’являються в стрічці угоди поруч із листуванням. Нотатку для Епіцентру менеджер пише в угоді, і Krokul додає її до коментарів замовлення в кабінеті продавця.
| Епіцентр | Напрям | Krokul | Коли |
|---|---|---|---|
| Замовлення (/v4/oms/orders) | Епіцентр → Krokul | Угода «Епіцентр № …» із зовнішнім ключем | Опитування за часом останньої зміни |
| Позиції замовлення | Епіцентр → Krokul | Рядки угоди з товарами каталогу | Разом з угодою |
| Дані клієнта (ПІБ, телефон) | Епіцентр ↔ Krokul | Контакт угоди | Нове замовлення або правка контакту |
| Статус замовлення (change-status) | Епіцентр ↔ Krokul | Етап угоди | Зміна етапу в Krokul чи статусу в кабінеті |
| Причина скасування | Епіцентр ↔ Krokul | Причина втрати угоди | Скасування замовлення |
| Номер ТТН (shipment-number) | Krokul → Епіцентр | Відправлення угоди | Після створення ТТН |
| Коментарі замовлення | Епіцентр ↔ Krokul | Записи в стрічці угоди | Новий коментар з будь-якого боку |
| Офер: ціна й наявність (/v1/offers) | Krokul → Епіцентр | Товар і залишок на складі | Зміна ціни чи залишку |
card/api-create і зберігайте номер замовлення через externalRef/api-upsert.card.statusChanged з фільтром за воронкою, перевіряйте заголовок x-crm-signature і переводьте замовлення в Епіцентрі методом change-status.activity/api-create.Так. Замовлення Епіцентру стають угодами з товарами каталогу, а статус, ТТН, коментарі, ціни й наявність повертаються в кабінет продавця.
У кабінеті продавця, на вкладці API в налаштуваннях компанії. Вкладку відкриває категорійний менеджер, бо API працює в закритому бета-тесті для частини компаній.
Після наступного опитування. Епіцентр не шле подій, тож Krokul за розкладом читає замовлення, змінені після попереднього проходу.
Так. Менеджер закриває угоду як програну й вибирає причину, а Krokul передає скасування з відповідною причиною з довідника Епіцентру.
Епіцентр не надсилає подій про нові замовлення, тому Krokul читає список замовлень за розкладом і бере ті, що змінились після попереднього проходу. Merchant API працює в закритому бета-тесті для частини компаній, і вкладку API в налаштуваннях компанії відкриває ваш категорійний менеджер.
Напишіть, яким сервісом ви користуєтесь і що має ходити між ним і Krokul. Ми відповімо способом і строком.
Запит отримано. Відповімо на вашу пошту.
Епіцентр є торговою маркою її власника. Krokul не афілійований з Епіцентром.