"Интеграция с СОФИ" (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)
В моде можно задать любое название тега, привязать к типу заказа и выбрать значение.
Для реализации передачи доп. атрибутов СОФИ необходимо активировать соответствующий мод “Дополнительные атрибуты для передачи в СОФИ” в разделе “Управление модами клиента” для каждого используемого договора.
Далее в разделе “Меню” - “Расширения” нужно выбрать пункт “Дополнительные атрибуты для передачи в СОФИ”
В открывшемся меню, необходимо добавить правила, для передачи нужных атрибутов и услуг.
Каждый атрибут в настройках имеет следующие параметры:
Раздел - блок в файле СОФИ, куда будет добавляться атрибут.
Название атрибута - текстовое поле для заведение названия атрибута в том виде, как он будет передаваться в файле СОФИ.
Значение атрибута - то, каким образом и откуда он будет заполняться.
Постоянное значение - если атрибут имеет неизменное значение (прописывается неизменное значение)
Значение из справочника кодов - справочник, который будет использоваться для передачи данных атрибутов.
Тип услуги - один или несколько видов услуг, для которых необходимо передавать этот атрибут.
После настройки атрибут будет передаваться в запросе СОФИ в соответствующем настройке разделе.
Доработки МОДа СОФИ
Разделение по пассажирам при оформлении ж/д билетов в одном заказе. (релиз от 16.10.2024)
Переработан метод отправки данных по заказам ж/д билетов туда-обратно в СОФИ в заказах с несколькими пассажирами.
Доработка включает в себя разделение данных по каждому пассажиру в заказе и отправку их в таком виде в файле xml в СОФИ.
В разделение входят:
fare (стоимость);
prod_id.
Рассмотрим на примере заказа билетов RT на двоих пассажиров — итого 4 билета в одной транзакции:
В логе это выглядит следующим образом: