Versions Compared

Key

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

...

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

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

Note

ОБРАТИТЕ ВНИМАНИЕ

При редактировании коллбэков доступна возможность протестировать отправку, чтобы было удобнее настраивать интеграцию. Однако, из соображений безопасности необходимо сначала добавить принимающий адрес в белый список.

Поэтому перед настройкой и тестированием коллбэков следует обратиться к агенту и указать ссылку, на которую будут отправляться запросы.

Агент в свою очередь ставит задачу в Okdesk на вайтлистинг данного адреса. Support Corteos добавит адрес в соответствующий раздел.

Если адрес не завайтлистен в Corteos система будет выдавать ошибку:

image-20240530-131201.pngImage Added

Статья о том, как протестировать отправку callbackов https://corteos-platform.atlassian.net/wiki/x/7ekM

Отправки Callback

Коллбек из Кортеос отправляется в принимающие систему каждые 5 минут, но не более 10 раз. Прекращается отправка при получении статуса 200

Note

Важно! Support Corteos (по запросам) не выполняет повторную отправку Callback, ни в единичном случае, ни за период. Callback отправляется только согласно описанию выше, вынужденные повторные отправки невозможны.

Callback  по  заказам

...

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

  • заказ создан (@EventType=NewOrder);

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

  • заказ отменен (@EventType=OrderCanceled);

  • в заказ добавлен файл (@EventType=OrderPushStaticFile) (доступен при активации мода "Уведомление клиента о добавлении файла к заказу"(ModMailToClientAfterAddedFiles) ) ;

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

  • у заказа изменилась стоимость (@EventType=OrderPriceChanged);

  • в заказ добавлен файл (@EventType = OrderPushStaticFile).

Info

Когда происходит изменение статуса командировки без изменения при этом статуса заказа, также отправляется callback, поля с информацией о заказе (номер заказа и статус заказа) при этом не заполнены.
Если изменение заказа влечет за собой изменение статуса командировки, то будет отправлен callback о изменении командировки с данными о заказе.

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

...

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

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

  • @OuterId - Внешний идентификатор командировки;

  • @EventType – тип события (см. выше доступные типы);

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

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

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

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

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

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

    • canceled – отменен;

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

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

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

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

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

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

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

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

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

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

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

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

  • @CallbackId – timestamp  – это количество тиков текущих даты и времени (timestamp сервера, сформированный на момент отправки сообщения;)

Info

CallbackId - не уникальное значение и иногда (могут) совпадать для разных заказов. Это будет означать что CallbackId были сформированы в одно и тоже мгновение.

  • @DIC:DictionaryName - Значение кода из указанного справочника.

...