API-протокол по выгрузке заказов из AliExpress

API – выгрузка заказов из AliExpress (xml)
Структура API реализована по архитектуре REST. Коммуникация осуществляется посредством
сообщений JSON, по адресам:
Тестирования
http://e-solution.pickpoint.ru/apitest/
Логин:
apitest
Пароль:
apitest
ИКН:
9990003041
Продуктив
http://e-solution.pickpoint.ru/api/
Для корректной работы необходимо:
 в запросе указывать Contenttype равным “application/json”,
 таймаут ожидания выполнения запроса 60 секунд.
Выгрузка заказов из AliExpress ...................................................................................................................... 1
Начало сессии (Login) ................................................................................................................................... 3
Завершение сессии (Logout) ..................................................................................................................... 3
Выгрузка заказов из AliExpress
Получение оплаченных заказов на AliExpress. Формат JSON
Необходимо от поставщика предоставить логин и пароль. В логине и пароли допустимы только
латинские буквы и специальные символы. UTF-8 кодировка не поддерживается.
Принцип работы.
Логин и пароль отправляются в незашифрованном в виде в заголовке(header) Authorization
после получения от сервера кода возврата «401 UNAUTHORIZED»
Метод запроса: POST
Content type: application/x-www-form-urlencoded
Формат выгрузки: JSON стандартного вида.
При получении ответа сервера «200 OK» выгрузка считается успешной.
Содержание файла:
"order":
{
"id": findOrderListQuery ->ordered Идентификатор заказа Ali
"status": findOrderListQuery ->orderStatus Статус заказа Ali
"creationDate": findOrderListQuery ->gmtCreate Дата оформления заказа
"currency": findOrderListQuery ->payAmount ->currencyCode Валюта заказа
"itemsTotal": findOrderListQuery ->productList.Count Количество товаров
"total": findOrderListQuery ->payAmount -> amount Сумма заказа
"vendor": Имя бренда
"fake":{boolean} Тестовый заказ
1
"items":
[
{
"feedId": findOrderById ->childOrderList ->productId Product Id Ali
"offerId": findOrderById ->childOrderList ->skuCode SKU Code Ali– это номер товара клиента, тот
который нам давали в файлах закачки
"offerName":findOrderById ->childOrderList ->productName Название товара
"price": findOrderById ->childOrderList ->productPrice -> amount Цена товара
"count": findOrderById ->childOrderList ->productCount Количество заказанного
}
...
]
"delivery":
{
"type": findOrderListQuery ->productList ->logisticsType Тип доставки
“amount": findOrderListQuery ->productList->logisticsAmount->amount Сумма за доставку
"address":
{
"region" : findOrderById ->receiptAddress -> province Регион доставки
"country": findOrderById ->receiptAddress -> country Страна доставки
"postcode": findOrderById ->receiptAddress -> zip Индекс
"city": findOrderById ->receiptAddress -> city Город
"address": findOrderById ->receiptAddress ->detailAddress Общий адрес
"PTNumber": НомерПТ (при доставке через PickPoint)
"recipient": findOrderById ->receiptAddress ->contactPerson Получатель
"phone":findOrderById ->receiptAddress ->phoneNumber Телефон получателя
"email": findOrderById ->buyerInfo -> email
"regionru": "АлтайскийКраи",province Регион доставки по-русски
"countryru": "РУ", ->countryСтрана доставки
"cityru": "Банжли", ->cityГород текст по-русски (не проверяется на соответствие)
"addressru": "аккепт" ->Общий адрес текст по-русски (текстовое поле, без соответствия)
}
"buyer":
{
"id": findOrderById ->buyerloginid – ИД пользователя в Али
"lastName": findOrderById ->buyerInfo ->lastName Фамилия покупателя Али
"firstName": findOrderById ->buyerInfo ->firstName Имя покупателя Али
"phone": findOrderById ->buyerInfo ->indOrderById ->receiptAddress ->mobileNo Мобильный телефон
получателя
}
}
}
2
Начало сессии (Login)
URL: /login
Метод: POST
Описание
Команда предназначена для начала сеанса работы. В запросе отправляемся логин и пароль, в
случае правильности, возвращается уникальный номер сессии, который действителен в течении
установленного времени. Вся дальнейшая работа ведется на основании номера сессии.
Структура запроса
{
“Login”:”<логин>”,
“Password”:”<пароль>”
}
Структура ответа
{
“SessionId”:”<уникальный идентификатор сессии>”,
“ErrorMessage”:”<текстовое сообщение об ошибке>”
}
Завершение сессии (Logout)
URL: /logout
Метод: POST
Описание
Команда предназначена для завершения сеанса работы. В запросе отправляется
идентификатор сессии. В ответ возвращается признак успешности выполнения.
Структура запроса
{
“SessionId”:
”<уникальный идентификатор сессии>”
}
Структура ответа
{
“Success”:
<true/false>
}
3