727
правок
Изменения
Перейти к навигации
Перейти к поиску
<syntaxhighlight lang="xml" line enclose="div" style="font-size:9pt;background: #F9F9F9; border: 1px dashed #2F6FAB; padding: 10px 5px; margin: 10px 0;"><?xml version="1.0" encoding="UTF-8"?><PNR> <Common> <id>263462</id> <Type>HOTELS</Type> <Service>ACADEM</Service> <Locator>3028655</Locator> <BeginDateTime>2014.04.15-00:00</BeginDateTime> <EndDateTime>2014.04.16-00:00</EndDateTime> <TotalPrice> <Amount>1950</Amount> <CurrencyCode>RUB</CurrencyCode> </TotalPrice> <UserId>123</UserId> <EEUserId /> <UserLogin>userLogin</UserLogin> <GroupId>332</GroupId> <UserStatus>Менеджер</UserStatus> <DateCreate>2014.03.21-16:11</DateCreate> </Common> <Payment> <Status>booked</Status> <PenaltyDate>2014.04.13-00:00</PenaltyDate> <Timelimit>2014-04-13 00:00:00</Timelimit> <Charge> <Amount>0</Amount> <CurrencyCode>RUB</CurrencyCode> </Charge> <Book> <Amount>1950</Amount> <CurrencyCode>RUB</CurrencyCode> </Book> <Penalty> <Amount>0</Amount> <CurrencyCode>RUB</CurrencyCode> </Penalty> <Total> <Amount>1950</Amount> <CurrencyCode>RUB</CurrencyCode> </Total> <Commission> <Amount>112</Amount> <CurrencyCode>RUB</CurrencyCode> </Commission> <PaidValue> <Amount>0</Amount> <CurrencyCode>RUB</CurrencyCode> </PaidValue> </Payment> <Client> <LastName>Сидоров</LastName> <Name>Владимир</Name> <MiddleName>Константинович</MiddleName> <Number>1806326598</Number> <Birth>1987-05-20</Birth> <Email>mail@hostсм.com</Email> <Phone>+79871234567</Phone> </Client> <Passengers> <Passenger> <nationality>RU</nationality> <lastname>IVANOV</lastname> <name>IVAN</name> </Passenger> </Passengers> <Info> <Name>Интурист</Name> <City> <Code>34</Code> <Name>Великий Новгород</Name> </City> <Location /> <StarRating>3</StarRating> <Days>2</Days> <Nights>1</Nights> <CheckInDate>2014.04.15</CheckInDate> <CheckOutDate>2014.04.16</CheckOutDate> <CheckInTime>14https:00</CheckInTime> <CheckOutTime>12:00</CheckOutTime> <OnRequest>false</OnRequest> </Info> <Rooms> <Room> <Name>Двухместный стандарт (две кровати)</Name> <Type>SNGL</Type> <FareId>1</FareId> </Room> </Rooms> <Fares> <Fare> <Id>1</Id> <Price> <Amount>1950</Amount> <CurrencyCode>RUB</CurrencyCode> </Price> <Meals>Завтрак "Шведский стол",Отсутствует</Meals> <Description>Одноместный</Description> </Fare> </Fares> <CancelCharges> <Charge> <DateFrom>2014.04docs.13-00:00</DateFrom> <DateTo>2014nemo.04.15-00:00</DateTo> <Amount>1488</Amount> <CurrencyCode>RUB</CurrencyCode> </Charge> </CancelCharges> <ModifyCharges /> <ModificationMethods> <Method>MOD_PASS_NAMES</Method> <Method>MOD_DATES</Method> <travel/ModificationMethods><ru/PNR><hotels/syntaxhighlight>hotelsbackoffice
→Настройки
** '''''Nemo Backoffice''''' — возможность экспорта заказов в формате JSON, который предоставляет более полный и актуальный объем данных, использует международные стандарты формата данных, является усовершенствованной версией протокола экспорта данных в формате Nemo.
<!--* '''Url скрипта для выгрузки в выбранном формате''' — URL, на который будет производиться выгрузка данных. -->
* '''Адрес для отправки нотификаций об изменении заказа''' — если задан, то при получении изменений в ходе актуализации отправляется GET-запрос на данный адрес ('''Пример''' ''http://127.0.0.1/?booking_id=ORDER_ID&nemo_id=NEMO_CONNECT_ORDER_ID&locator=LOCATOR''). Формат значения поддерживает переменные '''LOCATOR''', '''ORDER_ID''', '''NEMO_CONNECT_ORDER_ID''' - ('''LOCATOR''' - идентификатор услуги в системе поставщика услуг, '''ORDER_ID''' - идентификатор заказа в системе NEMO, '''NEMO_CONNECT_ORDER_ID''' - идентификатор заказа в системе NEMO Connect).
* '''Url скрипта для выгрузки в формате Nemo''' — URL, на который будет производиться выгрузка данных.
* '''Url скрипта для выгрузки в формате СОФИ''' — URL, на который будет производиться выгрузка данных.
Cистема {{NameSystem}} отправляет файлы выгрузки на указанный в этом поле http-адрес через POST-запрос (см. https://ru.wikipedia.org/wiki/POST_(HTTP) ). Скрипт для обработки получаемых данных должен быть написан на стороне самого клиента. Задача скрипта — принять данные и корректно их обработать. Все данные, которые можно получить через браузер, также можно получить и альтернативными программными средствами (автоматизируя процесс выгрузки). Рекомендуется к использованию библиотека CURL (см. https://ru.wikipedia.org/wiki/CURL) Готовые примеры скриптов сотрудники {{NameSystem}} не предоставляют.<br>Если у субагента указан свой Url скрипта для выгрузки, отличный от URL корневого агенства, то выгрузка по заказам этого субагента будет идти на оба адреса. Главный агент получает информацию по всем заказам всех субагентов, субагент получает выгрузку только своих заказов.<br/> <!-- <span style="background-color:#fff0f5;">'''<span style="color:#ff0000;">Внимание!</span>''' Указание отдельного URL скрипта для выгрузки для субагентов доступно только для формата Nemo.</span> -->
* '''Адрес для выгрузки в Nemo Backoffice''' — URL, на который будет производиться выгрузка данных.
* '''Код сайта в системе Софи''' — идентификатор агентства на стороне СОФИ. Код нужен для связки агентства в СОФИ и в {{NameSystem}}. Если агентство заведено в СОФИ, то его код указывается в этом поле. Тогда в выгрузке СОФИ будет идентифицировать заказы от указанного агентства. <!-- <br/><span style="background-color:#fff0f5;">'''<span style="color:#ff0000;">Внимание!</span>''' Необходимо заполнить поля '''"Url стороннего скрипта для XML уведомлений"''' и '''"Код сайта в системе Софи"''', которые становятся доступными только при переключении '''"Типа выгрузки"''' в значение '''"Выгрузка заказов Софи"''', а также поле '''"Url стороннего скрипта для XML уведомлений"''' для типа выгрузки '''"Nemo"'''.</span>-->
* '''Повторная отправка в случае неудачи''' — настройка позволяет производить повторные попытки экспорта заказа через определенный интервал времени (максимум 3 попытки).
* '''Список адресов для уведомлений (разделяется запятыми)''' — настройка позволяет определить один или более адресов электронной почты, на которые будет отправлено уведомление о проблемном заказе, в случае, если все попытки выгрузки заказа закончатся неудачно.
* '''Экспортировать после оплаты''' — настройка позволяет дополнительно производить выгрузку заказов после события оплаты заказа.<br/><span style="background-color:#fff0f5;">'''<span style="color:#ff0000;">Внимание!</span>''' Доступно только (поддерживается для формата выгрузки в формате Nemoи Backoffice).</span>
* '''Экспортировать код доступа к заказу''' — настройка включает отображение кода доступа в выгрузке.
* '''Отправлять нотификацию о необходимости установки кода валидатора в реквизитах''' — настройка позволяет автоматически отправлять нотификацию при выгрузке заказа в Софи без кода валидатора.
== Форматы выгрузки заказов ==
Система поддерживает выгрузку заказов в форматах '''''Nemo''''', '''''Софи''''' и '''''СофиJSON'''''. Рекомендуется использовать функционал выгрузки JSON.
=== Компоненты, поддерживающие выгрузку заказов ===
! style="font-weight: bold;" | Формат Nemo
! style="background-color: #99FF66;" | +
! style="background-color: #99FF66FF6666;" | +−
! style="background-color: #99FF66;" | +
|-
! style="font-weight: bold;" | Формат JSON
! style="background-color: #99FF66;" | +
! style="background-color: #FF666699FF66;" | −+
! style="background-color: #99FF66;" | +
|}
! scope="col" style="width: 100px;" | Аннуляция<sup>***</sup>
! scope="col" style="width: 100px;" | Обмен/Возврат<sup>****</sup>
! scope="col" style="width: 100px;" | Импорт PNR<sup>*****</sup>
|-
! style="font-weight: bold;" | Формат Nemo
! style="background-color: #99FF66;" | +
! style="background-color: #99FF66;" | +
! style="background-color: #99FF66;" | +
! style="background-color: #99FF66;" | +
! style="background-color: #99FF66;" | +
! style="background-color: #FF6666;" | −
|-
! style="font-weight: bold;" | Формат JSON
! style="background-color: #99FF66;" | +
! style="background-color: #99FF66;" | +
! style="background-color: #99FF66;" | +
! scope="col" style="width: 100px;" | Аннуляция
|-
! style="font-weight: bold;" | Формат NemoJSON
! style="background-color: #99FF66;" | +
! style="background-color: #99FF66;" | +
** Выгрузка заказа при синхронизации произойдет только если в заказе произошли изменения.<br/>
***  Выгрузка заказа в формате СОФИ при аннуляции произойдет только в том случае, если в заказе имеются аннулированные допуслуги.<br/>
****  Выгрузка заказа при обмене или возврате произойдет при завершении работы с заявкой (при пропуске импорта PNR).<br/>*****  Выгрузка заказа при импорте PNR в рамках работы модуля [[Импорт PNR]].
=== Статусы выгрузки заказа ===
<br/><span style="background-color:#fff0f5;">'''<span style="color:#ff0000;">Внимание!</span>''' В том случае, если выбранный клиентом Сервисный пакет имеет нулевую стоимость - в выгрузке он отображаться не будет.</span>
Ремарка ''<Remarks>Debit</Remarks>'' является не обязательной, означает что заказ был оплачен с помощью способа оплаты «Депозит»«Баланс компании»;если же заказ был оплачен с использованием депозитного кредита, и депозит баланс ушел в минус даже на 1 руб., то будет ''<Remarks>Credit</Remarks>''.
Элемент ''<TotalFare>'' возвращает стоимость уже оплаченного заказа. Если же заказ забронирован, но не оплачен, то значение будет 0 RUB.
=== Выгрузка заказа для компонента «Отели» ===
Для компонента '''«Отели»''' доступна выгрузка заказов в формате форматах Nemoи/или JSON.
<div class="toccolours mw-collapsible mw-collapsed" style="width:1000px">
==== Формат Nemo JSON ====
<div class="mw-collapsible-content">
</div>
</div>