SalesDrive

SalesDrive — підключення до CRM SalesDrive для роботи із замовленнями на відправку. Додаток завантажує заявки (замовлення) із CRM через REST, а після збирання й пакування повертає в SalesDrive номер ТТН і статус замовлення. Каталог товарів підтягується окремо — з YML-експорту.

Як обрати

Налаштування → Загальне → Інтеграція → поле Метод синхронізації → SalesDrive.

Де взяти ключі в SalesDrive

Form-Api-Key — у кабінеті SalesDrive: Установки → Web-форми та джерела → API-ключ бази заявок (потрібне право читання замовлень). Цей ключ передається у заголовку запиту.
Публічний ключ YML (необов'язковий) — Установки → Товари/Послуги → Експорт YML. Потрібен лише щоб завантажувати каталог товарів у додаток. Це окремий ключ, не той самий, що Form-Api-Key.
id статусів — список статусів і їхні числові id дивіться у налаштуваннях воронки SalesDrive (роздiл статусів замовлень).

Параметри

Поле	Опис	Обов'язкове	Приклад
Домен акаунта SalesDrive	Адреса вашого кабінету SalesDrive. Можна вказати лише піддомен — додаток нормалізує до повного https-адреса.	Так	`https://example.salesdrive.me`
Form-Api-Key бази заявок	Ключ доступу до заявок (право читання замовлень). Іконка ока — показати/сховати.	Так	—
Фільтр за статусом	id статусу, заявки з яким завантажувати (напр. «На відправку»). Кілька статусів — через кому. Порожньо = усі заявки, окрім видалених.	Ні	`3`
id статусу «Зібрано»	Статус, який виставляється замовленню в SalesDrive під час Завершити документа.	Ні	`11`
Змінювати товари (кількості) при «Завершити»	Якщо увімкнено — на Завершити в SalesDrive оновлюються ще й зібрані кількості товарів, а не лише статус.	Ні	—
id статусу «Передано кур'єру»	Статус, який виставляється замовленню під час Відправити дані (разом із номером ТТН).	Ні	`24`
Публічний ключ YML-експорту товарів	Токен YML-фіда для завантаження каталогу товарів (фото, властивості, комплекти). Потрібен для імпорту номенклатури й розкриття комплектів.	Ні	—
Не змінювати тип наявного товару при імпорті	YML SalesDrive не несе типу товару. Без цього прапорця повторний імпорт скидав локальний тип Комплект назад на Товар. Увімкніть, щоб зберегти тип наявних товарів.	Ні	—

поля SalesDrive — Домен акаунта, Form-Api-Key, Фільтр за статусом, статуси «Зібрано»/«Передано кур'єру», перемикачі «Змінювати товари» і «Не змінювати тип наявного товару», Публічний ключ YML

Особливості

Завантаження: заявки на відправку (замовлення) через REST (GET /api/order/list/, заголовок Form-Api-Key) і каталог товарів — окремо з YML-фіда. Позиції заявки зіставляються з номенклатурою за штрихкодом або артикулом.
Розкриття комплектів: якщо в YML товар описаний як комплект, у заявці його рядок автоматично розкривається на комплектуючі. Без підключеного YML-фіда комплекти в заявках не розкриваються (з'явиться попередження).
Вивантаження (двоетапне, керується статусами):
- Завершити документа → замовленню в SalesDrive виставляється статус «Зібрано» (і, за увімкненим перемикачем, оновлюються кількості товарів).
- Відправити дані → у замовлення записується номер ТТН і виставляється статус «Передано кур'єру».
Якщо для замовлення не заповнено id статусів у налаштуваннях — статус у SalesDrive не оновлюється (додаток повідомить про це).

Перевірка

Натисніть Підключити — додаток спробує завантажити заявки із SalesDrive. Кнопка Демо підставляє демонстраційні значення. Далі отримайте документи через Завантаження документів.

екран методу синхронізації SalesDrive з кнопками Демо / Підключити / Очистити

Що далі

Інтеграція — огляд методів.
Завантаження документів · Замовлення (скан ТТН перед відправкою).