Интеграция с СОФИ · (ModSofiIntegration)

Позволяет настроить на платформе интеграцию с СОФИ.

Подключение мода:

Для подключения мода необходимо перейти в раздел “Marketplace” и активировать данный мод

Настройка МОДа:

Для перехода к настройке интеграции необходимо перейти в раздел меню - расширения - редактор настроек интеграции с СОФИ

При нажатии система переведет пользователя в администрирование мода, где будут доступны разделы:

Адрес скрипта
Логин и пароль

Адрес скрипта - Адрес, куда отправится сформированный для СОФИ xml. По этому адресу находится сервер, который принимает post запрос с HTTP Basic Authorization. Адрес предоставляет тот, кто планирует получать данные файлы и заносит его в данный раздел. Пример вида адреса скрипта можно увидеть на скрине выше.

Логин\Пароль: Как описано выше - по адресу находится сервер, который принимает post запрос с HTTP Basic Authorization, именно для авторизации на данном сервере нужны данные логин\пароль, которые будут использоваться в запросе.

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

После всех настроек мод будет передавать информацию в СОФИ по всем выполненным (онлайн заказам = авиа, отели, жд).

В логе можно будет увидеть информацию о передаче запроса в СОФИ.

Запрос начинается с order_snapshot и в журнале логирования выглядит вот так (на примере заказа авиа билета)

<order_snapshot xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance">
  <header currency="RUB" time_gmt="2024-02-09 10:43:07" time="2024-02-09 13:43:07" ord_id="1804235" site="https://stage9.corteos.ru" psl="Corteos" />
  <customer name="Ухты тест A." corp_code="999990001/0000000000" email="usr7996@corteos.ru" phone="" />
  <products>
    <product>
      <air_ticket_prod prod_id="0" validating_carrier="SU" origin="VKO" destination="LED" psg_type="A" form_owner="ТКП" supplier="ТКП" fare="8875" taxes="528" service_fee="150">
        <air_seg segment_id="0" departure_airport="VKO" arrival_airport="LED" flight_number="6024" carrier="SU" op_carrier="SU" departure_datetime="2024-03-15 23:45" departure_term="A" arrival_datetime="2024-03-16 01:05" arrival_term="1" rbd="G" />
      </air_ticket_prod>
      <dop_info>
        <dop>
          <code>НОМЕР_КОМАНДИРОВКИ</code>
          <value>790690</value>
        </dop>
        <dop>
          <code>НОМЕР_ЗАКАЗА</code>
          <value>1804235</value>
        </dop>
        <dop>
          <code>ДАТА_ВВОДА_КОМАНД</code>
          <value>2024-02-09</value>
        </dop>
        <dop>
          <code>КОЛВО_ОТКЛ_ОТ_ТП</code>
          <value>1</value>
        </dop>
        <dop>
          <code>ВРЕМЯ_В_ПУТИ</code>
          <value>80</value>
        </dop>
        <dop>
          <code>ВОЗВРАТНЫЙ</code>
          <value>True</value>
        </dop>
        <dop>
          <code>С_БАГАЖОМ</code>
          <value>True</value>
        </dop>
        <dop>
          <code>ОТМ_ИЗМ</code>
          <value>True</value>
        </dop>
        <dop>
          <code>АК_ДЕШ_ВАР</code>
          <value>5N</value>
        </dop>
        <dop>
          <code>РЕЙС_ДЕШ_ВАР</code>
          <value>5N-295</value>
        </dop>
        <dop>
          <code>КОД_БРОН_ДЕШ_ВАР</code>
          <value>ISTOW</value>
        </dop>
        <dop>
          <code>СТОИМ_БИЛ_ДЕШ_ВАР</code>
          <value>9553</value>
        </dop>
      </dop_info>
    </product>
  </products>
  <reservations>
    <reservation rloc="246WTX" crs="Mixvel" rsrv_id="1804235" crs_name="Mixvel" />
  </reservations>
  <passengers>
    <passenger psgr_id="0" psgr_type="Adult" name="Кокошник" first_name="Лукас" birth_date="1988-12-12" gender="M" doc_type="Паспорт" doc_number="4017909068" />
  </passengers>
  <travel_docs>
    <travel_doc>
      <air_ticket_doc tkt_oper="TKT" prod_id="0" psgr_id="0" tkt_number="5556110092578" tkt_date="2024-02-09 13:42:00" rsrv_id="1804235" issuingAgent="Авиабилеты" />
    </travel_doc>
  </travel_docs>
  <payments>
    <payment pay_id="0" amount="9553" pay_oper="PAY" pay_time="2024-02-09 13:43:07" tkt_fop="INVOICE" psp_code="INVOICE" />
  </payments>
</order_snapshot>

Дополнительные атрибуты для передачи в СОФИ (ModSofiIntegrationAdditionalAttributes)

Используется только совместно с модом Интеграция с СОФИ · (ModSofiIntegration)

В моде можно задать любое название тега, привязать к типу заказа и выбрать значение.

Для реализации передачи доп. атрибутов СОФИ необходимо активировать соответствующий мод “Дополнительные атрибуты для передачи в СОФИ” в разделе “Управление модами клиента” для каждого используемого договора.

Далее в разделе “Меню” - “Расширения” нужно выбрать пункт “Дополнительные атрибуты для передачи в СОФИ”

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

Каждый атрибут в настройках имеет следующие параметры:

Раздел - блок в файле СОФИ, куда будет добавляться атрибут.

Название атрибута - текстовое поле для заведение названия атрибута в том виде, как он будет передаваться в файле СОФИ.

Значение атрибута - то, каким образом и откуда он будет заполняться.

Постоянное значение - если атрибут имеет неизменное значение (прописывается неизменное значение)

Значение из справочника кодов - справочник, который будет использоваться для передачи данных атрибутов.

Тип услуги - один или несколько видов услуг, для которых необходимо передавать этот атрибут.

После настройки атрибут будет передаваться в запросе СОФИ в соответствующем настройке разделе.