Обмен данными о сделках (обновление сделок из XML файла)

Основная задача импорта — это получить и сохранить в системе все данные об оплатах, сделках, попытавшись понять к какому именно лиду относится оплата. Кроме того, дать возможность обновлять статус сделок и создавать клиентов и сделки на основании выгрузки данных из других систем.

Требования к файлам выгрузки описаны в документации разработчикам.

Предварительно необходимо настроить импорт в разделе Обмен данными, обязательно указать ссылку на файл выгрузки, который будет обновляться. После этого, каждый день, 2 раза в сутки происходит импорт данных из файла.

Система обрабатывает файл и в первую очередь смотрит, не импортировали ли мы записи с такими идентификаторами. Если импортировали — пропускает. Если запись не была ранее импортирована, то процесс обработки записи такой:

  • В первую очередь ищем клиента и привязываем оплату к нему, если клиент с такими данными есть.
    • Если в выгрузке в записи нет ид сделки, то суммы передаются по логике, описано ниже.
    • Если не найден клиента, то создаем клиента из тех данных что мы получаем в выгрузке. Причем система обязательно должна получить его идентификатор из куки, чтобы записать его в параметры клиента. После создания клиента к нему создается сделка. Во всех новых сделках, созданных по импорту указывается дата создания из выгрузки.
  • Если клиент найден, то:
    • Сначала система проверяет и сопоставляет записи по ID конверсии (если есть)
    • Если по ID конверсии не удалось найти сделку, то система пытается найти ее по найти по ID сделки (если он есть)
    • Если по ID сделки не удалось найти сделку, то система пытается искать сделку по такому принципу:
      • Система ориентируется на дату совершения оплаты и ищет самую ближайшую сделку от этой даты в прошлое у этого клиента. 
      • Система ищет сделку со статусом который соответствует Новой сделке. Если такая сделка была найдена, то полата привяжется к ней. Если записей в импорте с суммами оплат несколько, то все они привяжутся к одной подходящей сделке с данным статусом. 
      • Система не привязывает оплаты к сделкам со статусом Повторное обращение.

Дополнительные примечания по импорту:

  • При создании и клиента и сделки в лентку клиента добавляются события, с указанием что было создано и где. Если к сделке привязана хоть одна симпортированная сумма, то блокируется возможность редактировать фактическую сумму.
  • У всех симпортированных созданных сделок в примечании добавляется текст Сделка создана из импорта
  • Если в выгрузку передано значение из куки __tsuid которое было присвоено пользователю в момент посещения сайта, то это поможет более точно определить как клиента так и его источники.
  • Клиент для сделки ищется по совпадению указанной выше куки, номера телефона или электронной почты.
  • Если в записи импорта по сделке не передана фактическая сумма, запись будет проигнорирована.
  • Если в записи по сделке передана потенциальная сумма, то она будет передана в сделку только, если сделки не было в системе и она добавляется на основании файла импорта. Последующее обновление потенциальной суммы не предусмотрено.

Чтобы импорт более точно работал, очень желательна настройка передачи сделок о заказах в Leadexpert.

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

Обновление уже симпортированных данных

Несмотря на то, что записи с идентификаторами, которые были обработаны ранее, не обрабатываются системой, при повторных импортах, обновляются значения фактических сумм и статусов сделок которые импортировались ранее. Если текущее значение записи в выгрузке содержит такой же идентификатор что и ранее, но при этом в данных записи по сделке в экспорте значение фактической суммы или статуса отличается от предыдущего, то данные будут перезаписаны, а в логе обновления факт перезаписи зафиксируется отдельным событием.

 

При импорте, дата сделки влияет на параметр «дата последней сделки», которая фиксируется в карточке посетителя. Если при импорте, дата сделки будет ближе к текущей дате, чем текущая дата последней сделки, зафиксированная по клиенту, то она обновится на более последнюю.