# Зовнішні ID у Krokul: звʼязки записів із кодами в джерелі

Який запис Krokul відповідає якому коду в старій чи зовнішній системі — і як прибрати хибний звʼязок.

Теги: зовнішні ID, зовнішні ідентифікатори, міграція даних, повторний імпорт, дублі

## Коротко
- **Звʼязок** — пара „код у джерелі ↔ запис Krokul“. Завдяки йому повторний імпорт оновлює запис, а не створює дубль.
- **Зовнішня система** — звідки код: стара CRM, з якої переносили дані, чи зовнішня система, що пише звʼязки через API.

## Як зробити
### Знайти запис за кодом
З яким записом CRM повʼязаний код зі старої системи.
1. У «Міграції» перейдіть на вкладку «Зовнішні ID».
2. У списку систем оберіть потрібну — поруч у дужках кількість звʼязків.
3. Введіть код у пошук за кодом у джерелі.
4. Натисніть назву запису в колонці „Наш запис“, щоб відкрити його картку.
> Порада: Список показує до 100 звʼязків обраної системи. Конкретний звʼязок шукайте за кодом.

### Прибрати хибний звʼязок
Сам запис лишається, зникає лише памʼять про його код.
1. Знайдіть рядок звʼязку.
2. Натисніть «Прибрати».
3. Підтвердьте кнопкою «Видалити звʼязок».
> Важливо: Наступний імпорт із цим кодом створить новий запис замість оновлення наявного. Синхронізація з зовнішньою системою за цим кодом зупиниться.

## Як це влаштовано
**Звідки беруться звʼязки.** Їх створює перенесення даних або зовнішня система через API, а не людина на цьому екрані. Доки нічого не переносили, видно „Звʼязків із джерелом ще немає“.

**Колонки.**
- „Система“ — назва джерела;
- „Код у джерелі“ — ідентифікатор запису в зовнішній системі;
- „Наш запис“ — вид і назва запису в CRM: контакт, контрагент, угода чи товар.

**Стан запису.** Якщо повʼязаний запис лежить у кошику, біля назви стоїть „(у кошику)“; якщо запису вже немає — „(запис зник)“.

**Окрема адреса.** Той самий перелік відкривається за адресою `/mapping` із заголовком „Зовнішні ID“. Окремого пункту меню в нього немає.

**Хто що може.** Переглядати й прибирати звʼязки можуть адміністратор і менеджер. «Міграція» доступна лише адміністратору, тож менеджер відкриває перелік за адресою `/mapping`.

Повʼязані вікна: «Міграція», «Маркетплейс».

## Питання й відповіді
### Що таке зовнішні ID у Krokul?
Зовнішні ID у Krokul — це перелік відповідностей між кодом запису в іншій системі й записом у Krokul. Завдяки зовнішнім ID повторний імпорт оновлює записи замість створення дублів.

### Чому повторний імпорт створив дубль замість оновлення?
Найімовірніше, звʼязку для цього коду не було або його прибрали. Перевірте код на вкладці «Зовнішні ID».

### Чи видаляє «Прибрати» сам контакт чи угоду?
Ні. Запис у CRM лишається недоторканим; зникає лише памʼять про його код у джерелі.

### Як виправити звʼязок, що вказує не на той запис?
Приберіть хибний звʼязок і повторіть імпорт: для цього коду буде створено новий запис. Перепривʼязати код до іншого запису вручну екран не дає.

### Чому список систем порожній?
Систем ще немає: звʼязки зʼявляються після першого перенесення в «Міграції» або підключення зовнішньої системи в «Маркетплейсі».

## Поля й елементи

### Екран «Зовнішні ID»

| Фільтр і пошук | Що це й на що впливає |
|---|---|
| Система | Звʼязки одного джерела; на «Усі системи» показано систему, де їх найбільше. |
| Пошук за кодом у джерелі | За частиною коду в джерелі; до 100 рядків. |

| Колонка | Що це й на що впливає |
|---|---|
| Код у джерелі | Ідентифікатор у сторонньому сервісі, за яким Krokul знаходить свій запис, а не створює новий. |
| Наш запис | Натиск відкриває картку; «(у кошику)» чи «(запис зник)» — запис видалено. |

| Кнопка | Що це й на що впливає |
|---|---|
| Прибрати | Видаляє лише звʼязок; наступне оновлення через API за цим кодом створить новий запис. |

| Розділ | Що це й на що впливає |
|---|---|
| Звʼязків із джерелом ще немає | Звʼязки створює перенесення; вручну їх не додають. |

---

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