Получить заказ

API конечная точка «Получить заказ» используется для получения данных завершённого заказа в системе Zonos. Ответ содержит объект JSON со всей доступной информацией о заказе, включая адреса выставления счёта и доставки, метод доставки, итоги заказа и статус.

Конечные точки 

Номера заказов

Получает список номеров заказов.

Детали заказа

Получает подробную информацию о заказе.

Использование API конечной точки «Получить заказ»

Есть два распространённых способа использования этих конечных точек.

1. (Часть 1 + Часть 2) – Используйте пользовательскую страницу подтверждения/успеха заказа в своём домене, чтобы запустить вызов конечной точки orderDetail, и импортируйте завершённый заказ. Кроме того, регулярно вызывайте конечную точку orderNumbers, чтобы согласовать любые заказы в системе Zonos, которые не были импортированы в вашу систему.
2. (Только часть 2) – Используйте основную страницу подтверждения/успеха заказа Zonos или статическую страницу в своём домене, чтобы указать покупателю на завершение заказа. Запланируйте, чтобы ваша система регулярно вызывала конечную точку orderNumbers, чтобы определить, когда новый заказ готов к импорту в вашу систему. При обнаружении невыполненного заказа вызовите конечную точку orderDetail для получения данных по этим заказам.

Часть 1: Страница успеха в вашем домене

Каждый раз, когда покупатель завершает заказ в Zonos Checkout, он сразу перенаправляется на URL страницы успеха заказа. Идентификатор завершённого заказа добавляется к URL перенаправления как строка запроса. URL страницы успеха должен быть предоставлен Zonos. URL также может быть передан как параметр в конечной точке createTempCart при создании временной корзины в системе Zonos.

Example: http://www.examplestore.com/internationalThankYou?orderId=999-99999

Когда покупатель перенаправляется на эту страницу, ваша система должна разобрать значение orderId из URL. Затем вы будете использовать orderId для вызова конечной точки orderDetail, чтобы получить данные заказа.

Часть 2: Используйте запланированное задание

В дополнение к запросу деталей заказа при срабатывании страницы успеха мы рекомендуем установить запланированный вызов для всех заказов и их деталей в качестве защиты. Таким образом, вы можете получить любые завершённые заказы в системе Zonos, которые ещё не были импортированы в вашу систему.

Этот процесс должен быть запланированным заданием/скриптом, например, задание Cron, запускаемым один раз в час/смену/день и т.д. (планируйте так часто, как это необходимо для ваших бизнес-процессов). Скрипт должен вызывать все заказы и их детали, которые произошли с момента последнего вызова заказов. Конечная точка orderNumbers позволяет вам получать заказы по sinceOrderId или sinceDate, как показано в GUI тестирования API, находящемся здесь. Все заказы, полученные через этот запланированный вызов, затем должны быть согласованы с заказами, вставленными в вашу систему каждый раз при срабатывании страницы успеха. Любые заказы, которые ещё не находятся в вашей системе, должны быть вставлены в вашу систему и рассматриваться как законные заказы.

Начальный статус заказа

IGLOBAL_ORDER_IN_PROCESS или IGLOBAL_FRAUD_REVIEW

При вызове конечной точки orderDetail мы рекомендуем, чтобы ваша система сначала проверила свойство orderStatus данных заказа.

Заказы, которые не требуют проверки на мошенничество, инициализируются с помощью orderStatus: IGLOBAL_ORDER_IN_PROCESS. Заказ с таким статусом готов к обработке и отправке.

Заказы, которые требуют проверки на мошенничество, инициализируются с помощью orderStatus: IGLOBAL_FRAUD_REVIEW. Заказ с таким статусом в настоящее время проходит проверку и проверяется на предмет предполагаемого мошенничества. Мы рекомендуем поместить этот заказ на статус проверки или удержания в вашей системе и продолжить вызывать конечную точку orderDetail, пока заказ не пройдёт процесс проверки на мошенничество Zonos.

После завершения процесса проверки на мошенничество Zonos заказ переместится в одно из следующих состояний:

• Заказ прошёл проверку на мошенничество

  • Заказ переместится на orderStatus: IGLOBAL_ORDER_IN_PROCESS и может продолжить работу в направлении отправки.

• Заказ не прошёл проверку на мошенничество

  • Заказ переместится на orderStatus: IGLOBAL_ORDER_CANCELLED и должен быть отменён в вашей системе.

GUI тестирования API

Пожалуйста, свяжитесь с поддержкой для получения учётных данных вашей учётной записи.