# KeyCRM: які дані передаються — ціни, залишки, фото, доставка

URL: https://bimpsoft.com/help/integrations/keycrm-data-sync/
Updated: 2026-11-06

> Інтеграція передає з KeyCRM у Bimp замовлення, покупців, товари (назви, артикули) і місто доставки, а з Bimp у KeyCRM — залишки та ціни. Фото товарів не передаються. Який саме залишок піде в KeyCRM, визначає перемикач «По вільних залишках»: увімкнений — вільний залишок, вимкнений — загальний. Нижче — налаштування вкладок «Залишки» й «Ціни» та розбір типових проблем.

## Які дані передає інтеграція з KeyCRM

Інтеграція передає дані в обидва боки. Які саме — залежить від напрямку.

| Напрямок | Що передається |
|---|---|
| KeyCRM → Bimp | замовлення, оплати, продажі, повернення; покупці; товари (назва, артикул); місто доставки |
| Bimp → KeyCRM | залишки товарів; ціни з прайс-листа; нові товари (за відповідними опціями) |
| Не передається | фото товарів; подальші зміни назви товару чи картки покупця, створених інтеграцією |

Налаштування підключення та замовлень описано в статті [Налаштування інтеграції з KeyCRM](https://bimpsoft.com/help/integrations/keycrm-setup/).

## Чи передається місто доставки з KeyCRM у Bimp

Так, місто доставки передається. Під час створення або оновлення замовлення з KeyCRM населений пункт автоматично потрапляє в поле на вкладці **Доставка** документа «[Замовлення покупця](https://bimpsoft.com/help/sales/customer-order/)» в Bimp.

## Чи передаються фото товарів

Ні, фото по інтеграції не передаються. Синхронізуються лише текстові та числові дані: назви, артикули, ціни, залишки. Зображення додавайте безпосередньо в картці товару в Bimp.

## Який залишок передається в KeyCRM: вільний чи загальний

Вид залишку визначає перемикач **«По вільних залишках»** на вкладці «Залишки».

| Перемикач | Що передається в поле залишків KeyCRM | Формула | Коли обирати |
|---|---|---|---|
| Увімкнено | вільний залишок | загальна кількість мінус резерв | коли в CRM потрібно бачити лише те, що можна продати зараз |
| Вимкнено | загальний залишок | уся кількість на складі, включно із зарезервованою | коли важлива повна фізична наявність |

Про резерви в Bimp див. [Резервування товарів](https://bimpsoft.com/help/sales/reserves/).

## Як налаштувати передачу залишків

Налаштування залишків знаходяться на вкладці «Залишки» вікна інтеграції.

![Вкладка «Залишки» вікна інтеграції KeyCRM: перемикачі «Дозволити вивантаження залишків» і «Вивантаження через вебхук» увімкнені, поле «Частота вивантаження (хв)» дорівнює 5](https://bimpsoft.com/help/_img/88a14b84-b3d5-4390-9bad-19b7d76d2a14.webp)

1. Увімкніть **«Дозволити вивантаження залишків»**.
2. За потреби увімкніть **«Вивантаження через вебхук»**, щоб залишки оновлювалися через вебхук.
3. Вкажіть «Частота вивантаження (хв)». Значення за замовчуванням — 15 хвилин.
4. У таблиці «Склади (мапінг)» навпроти [кожного складу](https://bimpsoft.com/help/inventory/warehouses/) Bimp пропишіть ID складу в KeyCRM. Щоб знайти ID, відкрийте в KeyCRM **Налаштування → Товари → Склади** і наведіть курсор на значок інформації біля назви складу.
5. Налаштуйте додаткові опції з таблиці нижче.
6. Збережіть інтеграцію.

| Опція | Що робить |
|---|---|
| «Створювати товари у KeyCRM» | дозволяє створювати в KeyCRM товари, яких там не знайдено; якщо в Bimp є штрихкод, товар створюється зі штрихкодом |
| «Створювати лише наявні товари» | перед вивантаженням перевіряє залишки і створює в KeyCRM лише товари, які є на складі |
| «Не передавати пусті залишки» | не надсилає оновлення для товарів із нульовим залишком (див. нижче, чому це ризиковано) |
| «По вільних залишках» | передає вільний залишок замість загального |
| «Оновлювати залишки для всіх складів» | для складів, де товару немає, примусово встановлює 0 |

## Перший запуск: чому не можна вмикати передачу залишків при нульових залишках у Bimp

Якщо в Bimp ще не внесено прихід товару (залишок 0), а в KeyCRM відображаються актуальні залишки, передачу залишків вмикати не можна. Облікова система має пріоритет: Bimp побачить 0 і надішле це в KeyCRM, тож реальні залишки в CRM перезапишуться нулями.

Правильний порядок:

1. Залиште «Дозволити вивантаження залишків» вимкненим.
2. Введіть у Bimp початкові залишки: див. [Введення початкових залишків: запаси](https://bimpsoft.com/help/getting-started/opening-balances-inventory/).
3. Коли залишки в Bimp відповідають реальності, увімкніть передачу залишків.

## Залишок у KeyCRM не стає нулем, коли товар закінчився

Причина — увімкнена опція «Не передавати пусті залишки». Bimp пропускає товари з нульовим залишком, і KeyCRM зберігає останнє передане ненульове значення.

Приклад: у Bimp 2 шт товару «А», в KeyCRM також 2 шт. Надходить замовлення на 2 шт, Bimp списує товар, залишок стає 0. Опція ввімкнена, тому Bimp цього оновлення не надсилає. У KeyCRM лишається 2 шт, і менеджери продовжують продавати товар, якого немає.

Рішення: вимкніть «Не передавати пусті залишки», щоб CRM завжди отримувала інформацію про те, що товар закінчився.

## Залишки не оновлюються через дублі артикулів

Якщо опція «Не передавати пусті залишки» увімкнена, а залишок не передається, перевірте, чи немає в Bimp двох карток товару з однаковим артикулом.

**Причина.** Картка №1 з артикулом 023452 має залишок 0, картка №2 з тим самим артикулом — залишок 1. Під час синхронізації Bimp знаходить першу картку, бачить нуль і через заборону на пусті залишки пропускає весь артикул. Залишок із другої картки не передається.

**Як виправити.**

1. Знайдіть товари з однаковим артикулом.
2. Видаліть дубль з нульовим залишком або змініть його артикул на унікальний. Як видалити або архівувати товар: [Як видалити або архівувати документ, довідник чи товар](https://bimpsoft.com/help/basics/archive-and-delete/).
3. Дочекайтеся наступної синхронізації: залишок почне передаватися.

## Як налаштувати передачу цін

Налаштування цін знаходяться на вкладці «Ціни». Інтеграція передає з Bimp у KeyCRM ціну з обраного прайс-листа.

![Вкладка «Ціни» вікна інтеграції KeyCRM: вимкнений перемикач «Дозволити вивантаження цін», «Частота вивантаження (хв)» 60, поля «Група вивантажуваних товарів» і «Прайс лист», перемикачі «Не оновлювати ціни по відсутнім товарам» і «Створювати товари у отримувача»](https://bimpsoft.com/help/_img/adcbfbd7-6d5f-4323-ada7-21c9de02e755.webp)

| Параметр | Що означає |
|---|---|
| «Дозволити вивантаження цін» | головний перемикач передачі цін |
| «Частота вивантаження (хв)» | як часто Bimp перевіряє зміни цін і надсилає їх у KeyCRM; за замовчуванням 60 |
| «Група вивантажуваних товарів» | група товарів Bimp, для якої оновлюються ціни; якщо порожньо, вивантажуються ціни всіх товарів |
| «Прайс лист» | тип ціни з довідника Bimp («Роздрібна», «Оптова», «Акційна»), яка потрапить у картку товару в KeyCRM |
| «Не оновлювати ціни по відсутнім товарам» | якщо ввімкнено і вільний залишок дорівнює 0, ціну в KeyCRM не оновлюють, навіть якщо її змінили в Bimp |
| «Створювати товари у отримувача» | автоматично створює в KeyCRM картки товарів, якщо за артикулом збігу не знайдено |

> [!TIP] Для тесту створіть окрему групу товарів і виберіть її в «Група вивантажуваних товарів», щоб не зачепити весь каталог.

> [!WARNING] Вмикайте «Створювати товари у отримувача» обережно. Якщо в KeyCRM уже є товари, артикул яких відрізняється від артикула в Bimp хоча б на один символ, Bimp не впізнає їх і створить дублі.

Про прайс-листи: [Прайс-листи](https://bimpsoft.com/help/pricing/price-lists/).

## Чому ціни не передаються в KeyCRM або приходять нульові

Ціни не передаються, коли для обраного прайс-листа або групи у товарів ціни не заповнено. Bimp бере ціну лише з джерела, вказаного на вкладці «Ціни». Якщо налаштовано брати ціну з прайс-листа А, а в товару заповнено тільки прайс-лист Б, Bimp вважає, що ціни немає, і нічого не передає.

**Як виправити.**

1. Відкрийте вкладку «Ціни» і подивіться, який «Прайс лист» та яка «Група вивантажуваних товарів» обрані.
2. Переконайтеся, що в товарах заповнені ціни саме в цьому прайс-листі. Для перегляду цін у картці товару: [Перегляд і зміна цін у картці товару](https://bimpsoft.com/help/pricing/price-in-product-card/).
3. Заповніть потрібні ціни або виберіть той прайс-лист, у якому ви фактично ведете ціни.

## FAQ

**Який залишок передається в KeyCRM: вільний чи загальний?**

Залежить від перемикача «По вільних залишках» на вкладці «Залишки». Якщо він увімкнений, передається вільний залишок (загальна кількість мінус резерв). Якщо вимкнений — загальний залишок разом із зарезервованим.

**Чи передаються фото товарів з KeyCRM у Bimp?**

Ні. Інтеграція синхронізує лише текстові й числові дані: назви, артикули, ціни, залишки. Фото додавайте безпосередньо в Bimp.

**Чи передається місто доставки із KeyCRM у Bimp?**

Так. При створенні або оновленні замовлення місто підставляється у відповідне поле на вкладці «Доставка» замовлення покупця.

**Чому в KeyCRM нульові або відсутні ціни?**

У налаштуваннях вкладки «Ціни» обрано прайс-лист або групу товарів, для яких у картках товарів ціни не заповнено. Заповніть ціни в цьому прайс-листі або виберіть інший.