Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

Технология Callbacks

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

...

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

  • Callback body – тело сообщения.


Callback  по  заказам

...


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

  • заказ создан;

  • заказ оформлен (выписан билет или сформирован ваучер);

  • заказ отменен;

  • в заказ добавлен файл;

  • у заказа изменился статус.
    Актуально для отелей, когда статус "У поставщика" меняется на "Выполнен" или "Отказано в размещении" = "Отменен";

  • у заказа изменилась стоимость.

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

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

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

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

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

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

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

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

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

  • @id_Reserve – уникальный системный номер заказа, по которому произошло событие;

  • @id_ComplexReserve – идентификатор командировки;

  • @EventType – тип события. В настоящее время используется только orderstatechanged;

  • @ReserveState – текущее состояние заказа, значение из набора:

    • creating – создается;

    • draft – черновик;

    • readyforissuance – готов к оформлению;

    • inprocess – в обработке;

    • finished – выполнен;

    • canceled – отменен;

    • queued – ожидает реакции агента;

    • onconfirmation – у поставщика;

    • needswork – ожидает реакции клиента;

    • error – ошибка обработки заказа.

  • @ComplexState – текущее состояние командировки, значение из набора:

    • draft – черновик;

    • authorizing – идет авторизация;

    • cleancopy – чистовик;

    • forexecution – на исполнении;

    • canceled – отменена;

    • finished – завершена.

  • @EventDescription – текстовое описание события;

  • @CallbackId – timestamp сервера, сформированный на момент отправки сообщения.

____

Callback по статике

...

MetaDictionaryOnReserveTypeDependency - MetaDictionaryOnReserveTypeDependency

...

  • @Type

    • название типа объекта;

  • @Before

    • предыдущее состояние объекта;

  • @After

    • актуальное состояние объекта.

Callback  по  заказам

...

  • заказ создан;

  • заказ оформлен (выписан билет или сформирован ваучер);

  • заказ отменен;

  • в заказ добавлен файл;

  • у заказа изменился статус.
    Актуально для отелей, когда статус "У поставщика" меняется на "Выполнен" или "Отказано в размещении" = "Отменен";

  • у заказа изменилась стоимость
    • .

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

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

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

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

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

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

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

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

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

  • @id_Reserve – уникальный системный номер заказа, по которому произошло событие;

  • @id_ComplexReserve – идентификатор командировки;

  • @EventType – тип события. В настоящее время используется только orderstatechanged;

  • @ReserveState – текущее состояние заказа, значение из набора:

    • creating – создается;

    • draft – черновик;

    • readyforissuance – готов к оформлению;

    • inprocess – в обработке;

    • finished – выполнен;

    • canceled – отменен;

    • queued – ожидает реакции агента;

    • onconfirmation – у поставщика;

    • needswork – ожидает реакции клиента;

    • error – ошибка обработки заказа.

  • @ComplexState – текущее состояние командировки, значение из набора:

    • draft – черновик;

    • authorizing – идет авторизация;

    • cleancopy – чистовик;

    • forexecution – на исполнении;

    • canceled – отменена;

    • finished – завершена.

  • @EventDescription – текстовое описание события;

  • @CallbackId – timestamp сервера, сформированный на момент отправки сообщения.