Перейти к содержанию

Синхронизация по API

Эта настройка нужна, чтобы эта база забирала данные из базы компании-партнёра: служебная операция синхронизации компаний (CompaniesSync) по её параметрам тянет из партнёра карточки товаров и остатки его склада (синхронизацию контактов и объектов убрали 21 октября 2026 года). Наружу эта настройка ничего не открывает: интернет-магазин или мобильное приложение через неё данные не берут.

Сама служба CompaniesSync в меню модулей не выведена: открыть её или поставить в расписание из интерфейса нельзя, поэтому заполненная настройка сама по себе ничего не запускает.

Где искать: Модули → Система → Настройки → Синхронизация по API

Разбор на примере

Настройка синхронизации реестров

Четыре поля:

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

Где эти остатки учитываются: в колонке «Доступно» окна выбора товаров документа и в отчёте «Прайс-листы коммерческого предложения» с отметкой «Добавить остатки внешнего склада». Пустое имя отчёт читает как EXTERNAL, а окно выбора товаров — как отсутствие внешнего склада, поэтому чтобы «Доступно» учитывало остатки партнёра, впишите имя явно.

База партнёра в этой версии должна работать на том же сервере.

В демонстрационной компании поля пустые: синхронизация не включена.

О ключе и токене

Ключ компании — это пароль к данным партнёра:

  • не пересылайте ключ почтой или в мессенджере — передавайте его тем же путём, каким передаёте пароли;
  • прекратили сотрудничество — попросите партнёра отозвать ключ.

Типичные ситуации

Служба отвечает «Не удалось получить токен API синхронизации от партнёра (HTTP …)». Партнёр не выдал токен по этому ключу: ключ отозван или введён с ошибкой, либо база партнёра недоступна.

Остатков партнёра не видно. Проверьте имя внешнего склада: остатки ложатся именно под этим кодом склада — ищите их по нему в статусах товара.

Нужно выключить синхронизацию. Снимите службу с расписания, очистите поле «Ключ компании» и сохраните — ключ сотрётся. Одного лишь очищенного токена мало: служба получит его по ключу снова.

Куда смотреть дальше