"Интеграция с СОФИ" (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 билета в одной транзакции:
В логе это выглядит следующим образом:
