Перейти до змісту

Синхронізація через API

Ця настройка потрібна, щоб ця база забирала дані з бази компанії-партнера: службова операція синхронізації компаній (CompaniesSync) за її параметрами тягне з партнера картки товарів і залишки його складу (синхронізацію контактів і об'єктів прибрано 21 жовтня 2026 року). Назовні ця настройка нічого не відкриває: інтернет-магазин чи мобільний застосунок через неї дані не беруть.

Саму службу CompaniesSync у меню модулів не виведено: відкрити її чи поставити в розклад з інтерфейсу не можна, тож заповнена настройка сама по собі нічого не запускає.

Де шукати: Модулі → Система → Налаштування → Синхронізація через API

Розбір на прикладі

Налаштування синхронізації реєстрів

Чотири поля:

  • Ключ компанії — ключ, який видала компанія-партнер; за ним служба синхронізації отримує в партнера токен. Ключ — секрет: зберігається зашифрованим, у вікні заданий ключ показується крапками, назовні (API, MCP) не віддається;
  • Токен — пропуск до бази партнера. Вписувати його руками не треба: служба отримує його сама за ключем компанії й оновлює, коли до кінця його дії лишається менше години;
  • Діє до — довідкове поле: дату, до якої діє токен, служба записує сама, коли отримує новий; а щоб вирішити, чи оновлювати токен, вона бере строк дії з самого токена, а не звідси;
  • Назва зовнішнього складу — під яким кодом складу лягають у цій базі залишки партнера (порожньо — EXTERNAL); повна синхронізація залишків спершу стирає залишки цього складу, а потім пише їх заново. Склад у базі партнера, з якого беруться залишки, закладено в коді — «СКЛ».

Де ці залишки враховуються: у колонці «Доступно» вікна вибору товарів документа і у звіті «Прайс-листи комерційної пропозиції» з позначкою «Додати залишки зовнішнього складу». Порожню назву звіт читає як EXTERNAL, а вікно вибору товарів — як відсутність зовнішнього складу, тож щоб «Доступно» враховувало залишки партнера, впишіть назву явно.

База партнера в цій версії має працювати на тому самому сервері.

У демонстраційній компанії поля порожні: синхронізація не увімкнена.

Про ключ і токен

Ключ компанії — це пароль до даних партнера:

  • не пересилайте ключ поштою чи месенджером — передавайте його тим самим шляхом, яким передаєте паролі;
  • припинили співпрацю — попросіть партнера відкликати ключ.

Типові ситуації

Служба відповідає «Не вдалося отримати токен API синхронізації від партнера (HTTP …)». Партнер не видав токен за цим ключем: ключ відкликано чи введено з помилкою, або база партнера недоступна.

Залишки партнера не видно. Перевірте назву зовнішнього складу: залишки лягають саме під цим кодом складу — шукайте їх за ним у статусах товару.

Треба вимкнути синхронізацію. Зніміть службу з розкладу, очистіть поле «Ключ компанії» і збережіть — ключ зітреться. Одного лише очищеного токена мало: служба отримає його за ключем знову.

Куди дивитися далі