SAP Cloud for Customer

В интерфейсе эта интеграция называется «Интеграция с С4С». Внешняя система — SAP Cloud for Customer (SAP C4C), CRM-модуль пакета SAP Customer Experience.

Это односторонний импорт, который запускают вручную. Записи клиентов переходят из SAP в Deals.

Эта интеграция специфична для тенанта. Если она не включена для вашей организации, в интерфейсе её может не быть.

Предварительные условия

Прежде чем настраивать интеграцию, в типе сущности «Клиент» должно быть пользовательское поле, которое SAP будет использовать как ключ сопоставления.

  1. Откройте раздел администрирования типов сущностей (Настройки или Администрирование → Типы сущностей → Клиент).

  2. Добавьте новое поле типа Строка с машинным именем accountId (с учётом регистра, точное совпадение).

  3. Сохраните тип сущности.

Если этого поля нет или у него неверный тип, при запуске синхронизация завершится ошибкой валидации. В сообщении об ошибке названо недостающее поле.

Настройка

  1. Откройте Настройки → Настройки синхронизации → Интеграция с С4С.

  2. Введите базовый URL OData для вашего тенанта SAP C4C.

  3. Введите имя пользователя и пароль (интеграция использует HTTP Basic-аутентификацию).

  4. Включите интеграцию и сохраните.

Настраивает её администратор с правом Настройки синхронизации.

Запуск синхронизации

Нажмите Синхронизировать в разделе «Интеграция с С4С». Импорт выполняется при каждом нажатии Синхронизировать.

После запуска синхронизация делает следующее:

  1. Читает клиентов из SAP C4C постранично.

  2. Проверяет каждую входящую запись.

  3. Сопоставляет каждую запись с существующими клиентами Deals по значению пользовательского поля accountId.

  4. Для совпадений — перезаписывает сопоставленные пользовательские поля значениями из SAP и обновляет признак архивации.

  5. Для несовпадений (клиентов, которые активны в SAP, но не имеют пары в Deals) — создаёт новую запись клиента.

Клиенты, у которых статус жизненного цикла в SAP не «Active», архивируются в Deals. Клиенты, активные в SAP, возвращаются из архива, если ранее были архивированы.

Если для той же организации уже идёт другая синхронизация, она отменяется до начала новой.

Сопоставление полей

Синхронизация записывает поля SAP в пользовательские поля записи клиента в Deals. Чтобы сопоставление их заполнило, перечисленные ниже поля должны существовать в типе сущности «Клиент» с указанными машинными именами.

Поле SAP Пользовательское поле Deals (машинное имя)

ID аккаунта

accountId

Роль

role

Отрасль

industry

Подотрасль

subIndustry

Адрес, строка 1

addressLine1

Адрес, строка 2

addressLine2

Город

city

Почтовый индекс

postalCode

Код региона

stateCode

Телефон

phone

Код клиента

clientCode

Название клиента

clientNameExtKut

Категория

category

TIN (идентификационный номер налогоплательщика)

tin

BRN (регистрационный номер бизнеса)

brn

Новый BRN

newBrn

Признак освобождения от GST

gstExempt

Регистрационный номер GST

gstRegistrationNumber

Признак освобождения от SST

sstExempt

Регистрационный номер SST

sstRegistrationNumber

Электронная почта для электронных счетов

eInvoiceEmail

Признак агентской комиссии

agencyCommission

Признак «Beware»

beware

Признак чёрного списка

blacklist

Налоговые поля этого сопоставления — TIN, BRN, GST, SST — рассчитаны на один рынок. Организации в других юрисдикциях будут использовать не все из них.

Когда новый клиент создаётся из данных SAP, в качестве названия клиента используется значение clientNameExtKut.

Журнал синхронизации

После каждого запуска результат виден в разделе Настройки → Настройки синхронизации → Логи синхронизации. В журнале показаны время начала и окончания, успешно ли прошёл запуск, число созданных и обновлённых клиентов и текст ошибки, если она была.

Сохраняется только последний запуск.

Права

  • Для настройки интеграции с С4С нужно право Настройки синхронизации с доступом на редактирование.