Callback

Owned by Corteos Platform (Unlicensed)

Last updated: Mar 09, 2023 by Confluence Admin

4 min read

1 Технология Callbacks
2 Callback по статике
3 Callback по заказам

Технология Callbacks

Механизм Callback используется для передачи сведений о заказе или статичных данных по договору, пассажиру, пользователю и др.

Настройка

Раздел настройки Callback находится в разделе "Настройки - Настройки Callbacks":

Отправка Callback осуществляется по HTTP методами GET или POST. Тело сообщения может иметь любой формат, а передаваемые значения подставляются на место специальных параметров-заменителей:

Параметры:

Использовать Callback – включает механизм Callback;
Адрес Callback – URL получателя сообщений (обязательный параметр);
Callback HTTP Headers – список заголовков HTTP:

Accept-Encoding: gzip,deflate

Content-Type: text/xml;charset=UTF-8

SOAPAction: http://sap.com/xi/WebService/soap1.1

User-Agent: Corteos

Cookie2: $Version=1

Authorization: Basic QsdfgSDGHFasdfSADFxaWM=

Callback method (POST/GET) – HTTP-метод (обязательный параметр). Необходимо ввести “POST” или “GET” без кавычек;
Callback body – тело сообщения.

Callback по статике

MetaDictionaryOnReserveTypeDependency - MetaDictionaryOnReserveTypeDependency

Пример xml-формата для объекта:

<SimpleMetaDictionary>
  <id_Relation />
  <Type>Relate</Type>
  <id_MetaDictionary>0</id_MetaDictionary>
  <id_RealMetaDictionary />
  <id_MetaDictionaryType>0</id_MetaDictionaryType>
  <id_BindingType>0</id_BindingType>
  <Name />
  <NameLatin />
  <id_Group>0</id_Group>
  <Tag />
  <SelectorMode>0</SelectorMode>
  <SequenceNumber>0</SequenceNumber>
  <ValidationRegex />
  <ValidationText />
  <ValidationTextLatin />
</SimpleMetaDictionary>

MetaDictionaryOnCodeDependency - MetaDictionaryOnCodeDependency

Пример xml-формата для объекта:

<SimpleMetaDictionary>
  <id_Relation />
  <Type />
  <id_MetaDictionary>0</id_MetaDictionary>
  <id_RealMetaDictionary />
  <id_MetaDictionaryType>0</id_MetaDictionaryType>
  <id_BindingType>0</id_BindingType>
  <Name />
  <NameLatin />
  <id_Group>0</id_Group>
  <Tag />
  <SelectorMode>0</SelectorMode>
  <SequenceNumber>0</SequenceNumber>
  <ValidationRegex />
  <ValidationText />
  <ValidationTextLatin />
</SimpleMetaDictionary>

MetaCodeOnCodeDependency - MetaCodeOnCodeDependency

Пример xml-формата для объекта:

<SimpleMetaCode>
  <id_MetaCode>0</id_MetaCode>
  <id_Relation />
  <Type />
  <Name />
  <NameLatin />
  <Tag />
  <CodeValue />
  <id_MetaDictionary>0</id_MetaDictionary>
</SimpleMetaCode>

MetaCodeOnReserveTypeDependency - MetaCodeOnReserveTypeDependency

Пример xml-формата для объекта:

MetaCodeOnOrganizationDependency - MetaCodeOnOrganizationDependency

Пример xml-формата для объекта:

MetaDictionaryForOrganization - MetaDictionaryForOrganization

Пример xml-формата для объекта:

MetaCodeForPerson - Персона - структурные коды

Пример xml-формата для объекта:

SimpleMetaDictionary - SimpleMetaDictionary

Пример xml-формата для объекта:

SimpleMetaCode - SimpleMetaCode

Пример xml-формата для объекта:

Person - Персона - личные данные (ФИО, дата рождения)

Пример xml-формата для объекта:

MileCard - Персона - мильные и бонусные карты

Пример xml-формата для объекта:

Document - Персона - документ

Пример xml-формата для объекта:

Contact - Персона - контактная информация

Пример xml-формата для объекта:

Сообщение может содержать в себе следующие переменные:

@Type
- название типа объекта;
@Before
- предыдущее состояние объекта;
@After
- актуальное состояние объекта.

Callback по заказам

Callbacks отправляются только по заказам для следующих событий (@EventType):

заказ создан (@EventType=NewOrder);
заказ оформлен (выписан билет или сформирован ваучер) (@EventType=OrderTicketed);
заказ отменен (@EventType=OrderCanceled);
в заказ добавлен файл (@EventType=OrderPushStaticFile);
у заказа изменился статус (@EventType=OrderStateChanged);
Актуально для отелей, когда статус "У поставщика" меняется на "Выполнен" или "Отказано в размещении" = "Отменен";
у заказа изменилась стоимость (@EventType=OrderPriceChanged);
в заказ добавлен файл (@EventType = OrderPushStaticFile).

Данное callback-сообщение отправляется по адресу, указанному в настройках, в том случае, если заказ изменил свой статус.

Формирование командировки происходит следующим образом: при бронировании любой услуги (например, перелета в город Санкт-Петербург), сначала создается командировка в статусе "Черновик" и далее в нее добавляется заказ по этой услуге (тоже в статусе "Черновик").
Бронирования при этом не происходит. По факту создания заказа придет callback.

При добавлении каждого нового заказа в командировку будет формироваться callback.

При вызове бронирования бронируются все услуги в командировке. После проставления бюджетных кодов в командировке, если они применяются, можно перевести командировку в "Чистовик". Далее командировку можно оформить – то есть выписать все автоматизированные услуги.

На каждую смену статуса заказа формируется callback.

Вы можете использовать SOAP или REST

приемник для сообщения. В 1-м случае в теле сообщения необходимо указать всю структуру SOAP-объекта – например,

Envelope, Body и так далее. Рекомендуется отправить тестовое сообщение к своему сервису при помощи SOAP UI и получить полный набор заголовков и структуру сообщения.

Ниже приведен набор переменных, которые можно использовать в данном callback:

@id_Reserve – уникальный системный номер заказа, по которому произошло событие;
@id_ComplexReserve – идентификатор командировки;
@EventType – тип события (см. выше доступные типы);
@ReserveState – текущее состояние заказа, значение из набора:
- creating – создается;
- draft – черновик;
- readyforissuance – готов к оформлению;
- inprocess – в обработке;
- finished – выполнен;
- canceled – отменен;
- queued – ожидает реакции агента;
- onconfirmation – у поставщика;
- needswork – ожидает реакции клиента;
- error – ошибка обработки заказа.
@ComplexState – текущее состояние командировки, значение из набора:
- draft – черновик;
- authorizing – идет авторизация;
- cleancopy – чистовик;
- forexecution – на исполнении;
- canceled – отменена;
- finished – завершена.
@EventDescription – текстовое описание события;
@CallbackId – timestamp сервера, сформированный на момент отправки сообщения.

____