WebAPI. Руководство по интеграции

Аннотация

Документ содержит описание API методов, необходимых для интеграции с отправителями. Версия 2.33

Список изменений

Версия	Дата	Изменение	Автор
0.1	12.02.2018	Документ создан.	Маишев П.Ю.
1.0	20.04.2018	Первая версия.	Маишев П.Ю.
1.1	21.05.2018	Добавлен метод HWB.Validate	Маишев П.Ю.
1.1	21.06.2018	Добавлены методы обновления информации о HWB	Маишев П.Ю.
2.0	16.07.2018	Стандартизированы названия методов	Маишев П.Ю.
2.1	28.08.2018	Добавлен метод LOC.GetLockers для получения списка постаматов и пунктов выдачи	Маишев П.Ю.
2.2	11.10.2018	Исправлена ошибка в описании HWB/Parcels/Items/UnitWeight (в описании было кг вместо грамм)	Маишев П.Ю.
2.3	15.10.2018	Убран протокол http	Маишев П.Ю.
2.4	15.11.2018	Изменен метод AUTH.Info	Маишев П.Ю.
2.5	15.01.2019	Дополнен метод LOC.GetLockers1) Вывод и возможность фильтрации по региону 2) Возможность фильтрации по нескольким состояниям постамата/пункта выдачи одновременно.	Маишев П.Ю.
2.6	08.02.2019	Исправлена ошибка в тексте с названием метода получения списка постаматов (было HWB.GetLockers вместо LOC.GetLockers)	Маишев П.Ю.
2.7	16.04.2019	Добавлен атрибут MaxSize для метода LOC.GetLockers	Маишев П.Ю.
2.8	17.04.2019	Добавлен новый код события (PCD)	Маишев П.Ю.
2.9	01.05.2019	Добавлены параметры подключения к тестовому серверу.	Маишев П.Ю.
2.10	08.05.2019	Добавлены новые коды событий (IDOK, IDCE, RIC, RPR)	Маишев П.Ю.
2.11	30.05.2019	Добавлен новый код событий (PDA)	Маишев П.Ю.
2.12	01.11.2019	Добавлены новые коды событий (CR2, CR3, HBA41, HBA42, HBA43, HBA44, HBA45, HBA46)	Маишев П.Ю.
2.13	06.11.2019	Добавлена информация по последней миле в HWB	Маишев П.Ю.
2.14	09.01.2020	В методы работы с манифестами добавлено поле ContractNumber.	Маишев П.Ю.
2.15	15.04.2021	Добавлены новые коды событий (CSW, ASF4, DOCOK, NWC, OH, SIR)Полностью обновлен метод получения списка постоматов и пунктов выдачи LOC.GetLockers
2.16	08.02.2022	Исправлены опечатки в названии статуса и номере ISO для кодов стран	Маишев П.Ю.
2.17	28.02.2022	Добавлен метод по печати этикеток	Маишев П.Ю.
2.18	05.03.2022	Добавлен ConsigmentNumber в передачу манифеста	Маишев П.Ю.
2.19	06.06.2022	Добавлен RewriteAll в метод HWB.UpdateSKUInfo	Маишев П.Ю.
2.20	30.06.2022	Добавлен атрибут Files в описание структуры JSON HWB, секция PersonalID	Маишев П.Ю.
2.21	11.07.2022	Добавлен почтовый индекс в вывод постаматов	Маишев П.Ю.
2.22	07.10.2022	Исправлено название поля для веса манифеста	Маишев П.Ю.
2.23	13.10.2022	Добавлен атрибут Files в описание структуры JSON HWB	Маишев П.Ю.
2.24	04.10.2023	Добавлено правило использования Без ограничения доступа методов обновления данных	Маишев П.Ю.
2.25	05.10.2023	Убраны лишние атрибуты из структуры HWB	Маишев П.Ю.
2.26	17.10.2023	Добавлены новые коды событий (ASF1, ASF2, ASF3, ASF5, CF1, CF3, CNP5, DS, NWCFG, NWCFM, NWCHM, OH, PIB, RPC, RPI, RSW, SPD, UT, WD, WFR)	Маишев П.Ю.
2.27	22.11.2023	Добавлен новый метод - HWB.GetWeight	Маишев П.Ю.
2.28	29.01.2024	Добавлен новый аттрибут для Items (HTSCodeExport)	Маишев П.Ю.
2.29	04.06.2024	Добавлен новый аттрибут для HWB - Incoterms	Маишев П.Ю.
2.30	30.09.2024	Добавлен новый аттрибут для HWB - DeliveryValue	Маишев П.Ю.
2.31	27.11.2024	Изменено значение по умолчанию для Incoterms	Маишев П.Ю.
2.32	29.11.2024	Добавлен атрибут CatalogTypes в описание структуры JSON HWB, секция Items	Маишев П.Ю.
2.33	24.12.2024	Обновлена структура API-Guide. Обновлен список терминов и сокращений. Обновлен список событий. Добавлено описание к полям ReceiverInfo.ReceiverAddress:Street and Building. Обновлена схема последовательности вызова запросов WebAPI. Добавлена сводная информация по функционалу методов. Обновлена информация по геометкам. Добавлены рекомендованные языки к items.Description\Items.DetailedDescription в приложении 3. Добавлены описание и схема к MNF.UploadNumbers и MNF.UploadFull. Добавлены ограничения по формату и размеру загружаемых файлов.	Агупова Ж.А.

Используемые термины и сокращения

Термин	Определение
JSON	Java Script Object Notation. Представляет собой формат, который использует текст, понятный человеку, для передачи данных, состоящих из пар атрибут – значение.
HWB	Home Waybill, товаросопроводительный документ, в котором указаны отправитель и получатель, маршрут следования, описание товара, стоимость доставки и вес отправления.
MAWB	Master Air Waybill. Документ, Назначается авиакомпанией и содержит адреса и названия агентов тех стран, куда направляется груз и откуда отправляется
Манифест	Документ, по которому передаются HWB. От отправителя принимаются входящие манифесты.
Токен (JWT)	JSON Web Token. Текстовый ключ, который на время дает возможность вызвать методы API от имени получившего этот ключ пользователя. “Срок жизни” токена равен 60 минутам.
–>	Данные отсылаемые на сервер. (data sent to service)
<–	Данные приходящие с сервера. (data coming from service)
Запрос	Вызов определённого метода, предоставляемого WebAPI
WebAPI	Web-сервис Parcel Engine 2.0, с которой возможно произвести интеграцию для передачи и получения данных по отправлениям.

Тип данных	Формат данных	Пример
Date	Дата в формате YYYY-MM-DD	2024-05-21
DateTime	Дата и время в формате YYYY-MM-DDTHH:mm:ss или YYYY-MM-DDTHH:mm:ssTZ (“T” разграничивает часть с датой и временем)	2023-03-08T02:00:00 или 2024-05-21T14:13:27+02:00

Общее описание

Для клиентов существует возможность интеграции с web-сервисом «Parcel Engine» для передачи данных по отправлениям (манифесты и пре-манифесты), а также для получения состояния отправлений и иной информации. Для этого используется web-сервис Parcel Engine 2.0

WebAPI работает по протоколу https посредством POST запросов с данными в формате JSON. В данном руководстве все примеры приведены для поbranch дключения по протоколу http.

Сервер для доступа к функциям WebAPI:

Тестовый сервер: apitest.spsr.tech.

Адрес запросов к тестовому серверу: https://apitest.spsr.tech/

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

Логин: test

Пароль: test

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

ServiceCode: tst

ContractNumber: 9900000000

Для тестирования эти учетные данные и параметры одинаковы Без ограничения доступа клиентов.

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

Общее описание. Запрос к серверу

Запрос выполняется к серверу для получения определенных данных. Запрос выполняется в кодировке UTF-8.

В заголовке HTTP-запроса в параметре Content-Type необходимо указывать значение “application/json”.

Все передаваемые данные — простые объекты, сериализованные в JSON. Запрос должен содержать четыре обязательных свойства:

jsonrpc — Всегда “2.0”;
method — Строка с именем вызываемого метода.
params — Массив объектов, которые должны быть переданы методу, как параметры.
id — Значение типа GUID, которое используется для установки соответствия между запросом и ответом.

В “params” передается необходимая информация для вызываемого метода. Например, номер договора, номер отправления и другая информация, необходимая для успешной обработки запроса.

Для передачи информации необходимо послать запрос на специальный адрес (по протоколу https).

Общее описание. Ответ сервера

WebAPI должна отослать правильный ответ на каждый полученный запрос. Ответ должен содержать следующие свойства:

jsonrpc — всегда “2.0”.
result — Данные, которые вернул метод при корректном выполнении запроса. Если произошла ошибка во время выполнения метода, это свойство должно быть установлено в null.
error – объект содержащий ошибку при ошибочном результате обработки запроса. Если запрос был выполнен корректно, это свойство должно быть установлено в null.
id — То же значение, что и в запросе, к которому относится данный ответ.

Объект error:

code — Код ошибки. Коды ошибок перечислены в Приложении 2.
message — Текстовое сообщение об ошибке, если произошла ошибка во время выполнения метода, иначе null. Необязательное поле.
data — необязательное поле

Перед обработкой данные проверяются на наличие обязательных параметров.

Пример вызова метода

Успешный:

Направление	Запрос/ответ
–>	{“jsonrpc”:“2.0”, “method”: “AUTH.Login”, “params”:{“username”:“test”,“password”:“test”}, “id”: “c52f1b33-b0d9-41a6-ae54-57f0e4aef17b”}
<–	{“jsonrpc”:“2.0”, “error”: null, “result”: { “token”:“eyJleHAiOjE1MTMwMDQ0NTUsImlhdCI6MTUxMjk5ODQ1NSwiYWxnIjoiSFMyNTYifQ .eyJpZCI6NX0.OMxJDVWtQjdtqTv_GzxC0KQK1BcH8asJy9a7sgaPt0c”}, “id”: “c52f1b33-b0d9-41a6-ae54-57f0e4aef17b”}

Не успешный:

Направление	Запрос/ответ
–>	{“jsonrpc”:“2.0”, “method”: “AUTH.Login”, “params”:{“username”:“test”,“password”:“tst”}, “id”: “dcff7921-7070-4318-b215-a54f77486101”}
<–	{“jsonrpc”:“2.0”, “error”: {“code”: -32003},“id”: “dcff7921-7070-4318-b215-a54f77486101”, “result”: null}

Последовательность вызова запросов WebAPI

Общая схема работы:

Общая информация по функционалу методов:

Функционал	Описание	Метод	Доступность метода
Авторизация	Получение токена	AUTH.Login	Без ограничения доступа
Информация о сессии	Получение информации о пользователе, для которого выдан токен (опционально)	AUTH.Info	Без ограничения доступа
Завершение сессии	Завершение сессии	AUTH.Logout	Без ограничения доступа
Передача информации по HWB	Метод предназначен для проверки (необязательной) HWB перед загрузкой (опционально)	HWB.Validate	Без ограничения доступа
Передача информации по HWB	Метод предназначен загрузки HWB	HWB.Upload	Без ограничения доступа
Передача информации по HWB	Метод предназначен обновления информации о получателе	HWB.UpdateReceiverInfo	Ограниченный доступ
Передача информации по HWB	Метод предназначен обновления информации о паспортных данных получателя	HWB.UpdateReceiverID	Ограниченный доступ
Передача информации по HWB	Метод предназначен обновления информации о посылках	HWB.UpdateParcelInfo	Ограниченный доступ
Передача информации по HWB	Метод предназначен обновления информации о содержимом посылки	HWB.UpdateSKUInfo	Ограниченный доступ
Передача информации манифестом	Передача информации манифестом	MNF.UploadNumbers	Без ограничения доступа
Передача информации манифестом	Передача информации манифестом	MNF.UploadFull	Без ограничения доступа
Получение информации	Получение событий в формате json	HWB.GetEvents	Без ограничения доступа
Получение информации	Получение списка постаматов и пунктов выдачи в формате json	LOC.GetLockers	Без ограничения доступа
Получение информации	Получение веса и габаритов отправления в формате json	HWB.GetWeight	Ограниченный доступ
Печать этикеток	Печать этикеток	печать этикеток	Без ограничения доступа

Авторизация. Запрос и получение токена. AUTH.Login

Название метода: AUTH.Login.

Функционал: Метод предназначен для получения токена для дальнейших запросов.

Входные параметры:“username” – имя пользователя, “password” - пароль.

Пример успешного вызова ниже.В результате успешного вызова сервер возвращает данные в поле result.token:

Направление	Запрос/ответ
–>	{“jsonrpc”:“2.0”, “method”: “AUTH.Login “, “params”:{“username”:“test”,“password”:“test”}, “id”: “c52f1b33-b0d9-41a6-ae54-57f0e4aef17b”}
<–	{“jsonrpc”:“2.0”, “result”: { “token”:“eyJleHAiOjE1MTMwMDQ0NTUsImlhdCI6MTUxMjk5ODQ1NSwiYWxnIjoiSFMyNTYifQ .eyJpZCI6NX0.OMxJDVWtQjdtqTv_GzxC0KQK1BcH8asJy9a7sgaPt0c”}, “id”: “c52f1b33-b0d9-41a6-ae54-57f0e4aef17b”}

Пример неуспешного вызова:

Направление	Запрос/ответ
–>	{“jsonrpc”:“2.0”, “method”: “AUTH.Login”, “params”:{“username”:“test”,“password”:“tst”}, “id”: “dcff7921-7070-4318-b215-a54f77486101”}
<–	{“jsonrpc”:“2.0”, “error”:{“code”: -32003},“id”: “dcff7921-7070-4318-b215-a54f77486101”, “result”: null}

Пример https запроса получения сессии при помощи curl.

curl -X POST -H “Content-Type: application/json” -d ‘{“jsonrpc”:“2.0”, “method”: “AUTH.Login”, “params”:{“username”:“test”,“password”:“test”}, “id”:“dcff7921-7070-4318-b215-a54f77486101”}’ https://apitest.spsr.tech/

Срок действия полученного токена 60 минут от момента получения.

При использовании функций, требующих авторизации, результат работы будет зависеть от прав владельца токена.

При неправильном логине или пароле, токен получен не будет, метод вернет ошибку code 32003.

При вызове методов, требующих авторизации, токен используется в Authorization header используя Bearer schema.

Authorization: Bearer

Информация о сессии. Метод AUTH.Info

Название метода: AUTH.Info.

Функционал: Метод возвращает json с информацией о пользователе, для которого выдан токен.При некорректном или просроченном токене возвращается ошибка.

Дополнительная информация: Требуется авторизация токеном (см.пункт Авторизация).

Пример вызова:

Направление	Запрос/ответ
–>	{“jsonrpc”:“2.0”, “method”: “AUTH.Info”, “params”:{}, “id”: “c52f1b33-b0d9-41a6-ae54-57f0e4aef17b”}
<–	{“jsonrpc”:“2.0”, “result”: { “email”:“test”, “id”: 519136, “username”: “API Test”}, “id”: “c52f1b33-b0d9-41a6-ae54-57f0e4aef17b”}

Завершение сессии. Метод AUTH.Logout

Название метода: AUTH.Logout.

Функционал: Метод прекращает действие переданного токена, далее этот токен не может использоваться при вызове функций с ограниченным доступом.

Дополнительная информация: Требуется авторизация токеном (см.пункт Авторизация).

Пример успешного вызова:

Направление	Запрос/ответ
–>	{“jsonrpc”:“2.0”, “method”: “AUTH.Logout”, “params”:{}, “id”: “c52f1b33-b0d9-41a6-ae54-57f0e4aef17b”}
<–	{“jsonrpc”:“2.0”, “result”: null, “id”: “c52f1b33-b0d9-41a6-ae54-57f0e4aef17b”}

API передачи информации по HWB и манифестам

Данные можно передавать по HWB или манифестами. Ниже описаны все методы передачи данных. Без ограничения доступа методов загрузки информации требуется авторизация токеном (см.пункт Авторизация).

Загрузка данных по HWB. Метод HWB.Validate

Название метода: HWB.Validate.

Функционал: Метод предназначен для проверки (необязательной) HWB перед загрузкой.

Дополнительная информация: Требуется авторизация токеном (см.пункт Авторизация).

Пример вызова:

Направление	Запрос/ответ
–>	{“jsonrpc”:“2.0”, “method”: “HWB.Validate”, “params”:{<Параметры>}, “id”: “c52f1b33-b0d9-41a6-ae54-57f0e4aef17b”}

Параметры содержат следующие аргументы:

Параметр	Описание	Обязательный	Тип
{
HWB:[]	Список проверяемых HWB. Формат JSON для HWB описан в приложении 3.	Да	JSON
}

Загрузка данных по HWB. Метод HWB.Upload

Название метода: Метод HWB.Upload.

Функционал: Метод предназначен загрузки HWB.

Дополнительная информация: Требуется авторизация токеном (см.пункт Авторизация).

Пример вызова:

Направление	Запрос/ответ
–>	{“jsonrpc”:“2.0”, “method”: “HWB.Upload”, “params”:{<Параметры>}, “id”: “c52f1b33-b0d9-41a6-ae54-57f0e4aef17b”}
Параметры содержат следующие аргументы:

Параметр	Описание	Обязательность	Тип
{
Synch	False - асинхронная обработка. Возвращается только информация (id документа, md5) по входному JSON. Дальше по id документа можно получить состояние обработки.True – Синхронная обработка. Возвращается сразу вся информацию (включая трек-номер и его соответствие номеру клиента). При синхронной обработке существует ограничение на количество HWB – не более 50000.	Да	Bool
ContractNumber	Индивидуальный номер договора.	Да	Char(20)
Author	Автор запроса.	Нет	Char(128)
TotalWeigth	Общий вес HWB, грамм	Да	Int
TotalVolume	Общий объем HWB, м3	Да	Float
TotalCOD	Общая сумма HWB, RUB	Да	Numeric(10,3)
HWBQty	Количество HWB.	Да	Int
Sender	Отправитель груза.	Нет	Char(128)
Receiver	Получатель груза.	Нет	Char(128)
HWB:[]	Список загружаемых HWB. Формат JSON для HWB описан в приложении 3	Да	JSON
}

Ответ на асинхронный запрос:

Направление	Запрос/ответ
<–	{“jsonrpc”:“2.0”, “result”: { “DocId”:“5”, “md5”:” 8928d0a9e0f5d9fcd2a4b466707f0b11”}, “id”: " c52f1b33-b0d9-41a6-ae54-57f0e4aef17b"}

DocId - служит для последующего запроса состояния обработки.

md5 - хеш JSON params. Хеш рассчитывается по очищенному JSON и служит, в том числе для исключения дублирования информации.

Ответ на синхронный запрос:

Направление	Запрос/ответ
<–	{“jsonrpc”:“2.0”, “result”: { “DocId”:“5”, “md5”:“8928d0a9e0f5d9fcd2a4b466707f0b11”, “HWB”:[{“HWBNumber”: “GBS000000000001”, “HWBRefNumber”: “XXXXXX” }, ….]}, “id”: “c52f1b33-b0d9-41a6-ae54-57f0e4aef17b”}

HWB - служит для передачи соответствия между HWBRefNumber и HWBNumber.

При загрузке информации по HWB возможны следующие ошибки:TBD. Ошибка означает To Be Determined, т.е значение будет определено позже.

Загрузка данных по HWB. Метод HWB.UpdateReceiverInfo

Название метода: HWB.UpdateReceiverInfo.

Функционал: Метод предназначен обновления информации о получателе.

Дополнительная информация: Требуется авторизация токеном (см.пункт Авторизация).

Важно: Для использования данного метода необходимо согласование с менеджером по сопровождению.

Пример вызова:

Направление	Запрос/ответ
–>	{“jsonrpc”:“2.0”, “method”: “HWB.UpdateReceiverInfo”, “params”:{<Параметры>}, “id”: “c52f1b33-b0d9-41a6-ae54-57f0e4aef17b”}

Параметры содержат следующие аргументы:

Параметр	Описание	Обязательный	Тип
{
HWB:[]	Список HWB для обновления информации. Формат JSON для HWB описан в приложении 3. В данном методе используется секция ReceiverInfo.	Да	JSON
}

Загрузка данных по HWB. Метод HWB.UpdateReceiverID

Название метода: HWB.UpdateReceiverID.

Функционал: Метод предназначен обновления информации о паспортных данных получателя.

Дополнительная информация: Требуется авторизация токеном (см.пункт Авторизация).

Важно: Для использования данного метода необходимо согласование с менеджером по сопровождению.

Пример вызова:

Направление	Запрос/ответ
–>	{“jsonrpc”:“2.0”, “method”: “HWB.UpdateReceiverID”, “params”:{<Параметры>}, “id”: “c52f1b33-b0d9-41a6-ae54-57f0e4aef17b”}

Параметры содержат следующие аргументы:

Параметр	Описание	Обязательный	Тип
{
HWB:[]	Список HWB для обновления информации. Формат JSON для HWB описан в приложении 3. В данном методе используется секция ReceiverInfo/PersonalData.	Да	JSON
}

Загрузка данных по HWB. Метод HWB.UpdateParcelInfo

Название метода: HWB.UpdateParcelInfo.

Функционал: Метод предназначен обновления информации о посылках.

Дополнительная информация: Требуется авторизация токеном (см.пункт Авторизация).

Важно: Для использования данного метода необходимо согласование с менеджером по сопровождению.

Пример вызова:

Направление	Запрос/ответ
–>	{“jsonrpc”:“2.0”, “method”: “HWB.UpdateParcelInfo”, “params”:{<Параметры>}, “id”: “c52f1b33-b0d9-41a6-ae54-57f0e4aef17b”}

Параметры содержат следующие аргументы:

Параметр	Описание	Обязательный	Тип
{
HWB:[]	Список HWB для обновления информации. Формат JSON для HWB описан в приложении 3. В данном методе используется секция Parcels.	Да	JSON
}

Загрузка данных по HWB. Метод HWB.UpdateSKUInfo

Название метода: HWB.UpdateSKUInfo.

Функционал: Метод предназначен обновления информации о содержимом посылки.

Дополнительная информация: Требуется авторизация токеном (см.пункт Авторизация).

Важно: Для использования данного метода необходимо согласование с менеджером по сопровождению.

Пример вызова:

Направление	Запрос/ответ
–>	{“jsonrpc”:“2.0”, “method”: “HWB.UpdateSKUInfo”, “params”:{<Параметры>}, “id”: “c52f1b33-b0d9-41a6-ae54-57f0e4aef17b”}

Параметры содержат следующие аргументы:

Параметр	Описание	Обязательный	Тип
{
RewriteAll	Если true - все старые товары удаляются и создаются новые. Если false - то обновляются товары с таким же Description. По умолчанию - false	Нет	Bool
HWB:[]	Список HWB для обновления информации. Формат JSON для HWB описан в приложении 3. В данном методе используется секция Parcels/Items.	Да	JSON
}

Загрузка манифеста. Метод MNF.UploadNumbers

Название метода: Метод MNF.UploadNumbers или метод последовательной загрузки HWB и манифеста. Данный метод явялется предпочтительным

Функционал: Метод позволяет объединить в один манифест ранее загруженные в WebApi отправления.

Дополнительная информация: Требуется авторизация токеном (см.пункт Авторизация).

Важно: Все HWB должны быть загружены в систему до вызова данного метода.

Описание метода: Как только HWB (один или несколько) создаётся в системе клиента, посылки загружаются методом HWB.Upload в WebApi. Далее созданный клиентом канифест по методу MNF.UploadNumbers загружается в WebApi.

Схема метода:

Пример вызова:

Направление	Запрос/ответ
–>	{“jsonrpc”:“2.0”, “method”: “”, “params”:{<Параметры>}, “id”: “c52f1b33-b0d9-41a6-ae54-57f0e4aef17b”}

Параметры для метода MNF.UploadNumbers содержат следующие аргументы:

Параметр		Описание	Обязательный	Тип
{
ManifestDate		Дата создания манифеста	Да	DateTime
ManifestNumber		Номер манифеста. Для MAWB – номер MAWB.	Да	Char(128)
HaulNumber		Номер рейса. Для MAWB – Flight Number.	Нет	Char(50)
ContractNumber		Индивидуальный номер договора.	Да	Char(20)
Author		Автор манифеста.	Нет	Char(128)
ManifestWeight		Общий вес манифеста, грамм	Да	Int
ManifestVolume		Общий объем манифеста, м3	Да	Float
HWBQty		Количество HWB	Да	Int
Sender		Отправитель груза	Нет	Char(128)
Receiver		Получатель груза	Нет	Char(128)
HWB:[		Список номеров HWB, включенных в манифест. Должен быть заполнен один из параметров HWBNumber или HWBRefNumber.	Да	JSON
	{		Да
	HWBNumber	Номер HWB	Да*	Char(20)
	HWBRefNumber	Клиентский номер HWB	Да*	Char(50)
	ConsigmentNumber	Номер консолидированного места	Нет	Char(128)
	}, …
]
}

*Все HWB должны быть загружены в систему до вызова данного метода.

Загрузка манифеста. Метод MNF.UploadFull

Название метода: Метод MNF.UploadFul.

Функционал: Метод позволяет загружать в WebApi отправления (HWB), которые сразу имеют привязку к манифесту.

Дополнительная информация: Требуется авторизация токеном (см.пункт Авторизация).

Описание метода: После создания в системе клиента HWB (одного или нескольких), посылки не загружаются в WebApi. Загрузка в WebApi происходит методом MNF.UploadFull после создания манифеста с HBW в системе клиента.

Схема метода:

Пример вызова:

Направление	Запрос/ответ
–>	{“jsonrpc”:“2.0”, “method”: “”, “params”:{<Параметры>}, “id”: “c52f1b33-b0d9-41a6-ae54-57f0e4aef17b”}

Параметры для метода MNF.UploadFull содержат следующие аргументы:

Параметр	Описание	Обязательный	Тип
{
Synch	False - асинхронная обработка. Возвращается только информация (id документа, md5) по входному JSON. Дальше по id документа можно получить состояние обработки.True – Синхронная обработка. Возвращается сразу вся информацию (включая трек-номер и его соответствие номеру клиента)	Да	Bool
ContractNumber	Индивидуальный номер договора.	Да	Char(20)
ManifestDate	Дата создания манифеста	Да	DateTime
ManifestNumber	Номер манифеста. Для MAWB – номер MAWB.	Да	Char(128)
HaulNumber	Номер рейса. Для MAWB – Flight Number.	Нет	Char(50)
Author	Автор манифеста.	Нет	Char(128)
ManifestWeight	Общий вес манифеста, грамм	Да	Int
ManifestVolume	Общий объем манифеста, м3	Да	Float
TotalCOD	Общая сумма HWB по манифесту, RUB	Да	Numeric(10,3)
HWBQty	Количество HWB	Да	Int
HWB:[]	Список HWB, включенных в манифест. Формат JSON для HWB описан в Приложении 3.	Да	JSON
}

Синхронная и асинхронная обработка для method MNF.UploadFull происходит аналогично Загрузке информации по HWB.

Метод получения получения событий по HWB. Метод HWB.GetEvents

Название метода: Метод HWB.GetEvents.

Функционал: Метод позволяет получить событий в формате json.

Дополнительная информация: Требуется авторизация токеном (см.пункт Авторизация).

Пример вызова:

Направление	Запрос/ответ
–>	{“jsonrpc”:“2.0”, “method”: “HWB.GetEvents”, “params”:{<Параметры>}, “id”: “c52f1b33-b0d9-41a6-ae54-57f0e4aef17b”}

Параметры содержат следующие аргументы:

Параметр			Описание	Обязательный	Тип
{
ContractNumber			ContractNumber по которому запрашиваются события. Если пусто, то запрос происходит по всем ContractNumber, доступным владельцу логина.	Нет	Char(12)
Filters:{				Да
	UseDates		Использовать или не использовать даты. Если “true” – то промежуток времени берется из параметров StartDate и EndDate. Если “false” – то выводятся события, полученные с последнего запроса с параметром “false”.	Да	Bool
	StartDate		Минимальная дата/время события.	Нет	Date
	EndDate		Максимальная дата/время события.	Нет	Date
	HWB:[		Список HWB, по которым запрашивается события. Если заполнено, то параметры UseDates и *Date игнорируются. Должен быть заполнен один из параметров HWBNumber или HWBRefNumber.	Нет	JSON
		{
		HWBNumber	Номер HWB	Да	Char(20)
		HWBRefNumber	Клиентский номер HWB	Да	Char(50)
		}, …
	]
}
TextLang			Язык на котором возвращается описание событий (ru или en). По умолчанию ru	Нет	Char(3)
TZ			Включать/не включать временные зоны в формат выходных дат	Нет	Bool
}

Ответ на запрос:

Направление	Запрос/ответ
<–	{“jsonrpc”:“2.0”, “result”: { [<список событий>]}, “id”: “c52f1b33-b0d9-41a6-ae54-57f0e4aef17b”}

Формат списка событий:

Параметр	Описание	Тип
[
HWBNumber	Номер HWB	Char(20)
HWBRefNumber	Клиентский номер HWB	Char(50)
EventCode	Код события (см. Приложение 1)	Char(8)
EventComment	Комментарий к событию	Char(128)
EventText	Текст события на русском или английском языке.	Char(512)
EventPlace	Место события	Char(128)
Partner	Партнер, от которого получено событие	Char(128)
EventTime	Дата/время события.	DateTime
]

Метод для получения списка постаматов и пунктов выдачи. LOC.GetLockers

Название метода: Метод LOC.GetLockers.

Функционал: Получение списка постаматов и пунктов выдачи в формате json.

Дополнительная информация: Требуется авторизация токеном (см.пункт Авторизация).

Пример вызова:

Направление	Запрос/ответ
–>	{“jsonrpc”:“2.0”, “method”: “LOC.GetLockers”, “params”:{<Параметры>}, “id”: “c52f1b33-b0d9-41a6-ae54-57f0e4aef17b”}

Параметры содержат следующие аргументы:

Параметр		Описание	Обязательный	Тип
{
Filters:{			Нет
	City	Город	Нет	Char() List
	CountryCode	Код Страны	Нет	Char() List
	LockerContractorICN	ИКН провайдера постомата или пункта выдачи	Нет	Char() List
	LockerNumber	Номер постамата или пункта выдачи	Нет	Char() List
	LockerOwner	Владелец постамата или пункта выдачи	Нет	Char() List
	LockerType	Постамат или пункт выдачи	Нет	Char() List
	MaxBoxSize	Максимальный размер коробки	Нет	Char() List
	RegionCode	Код региона	Нет	Char() List
	Status	Статус (доступные: New, Open, Closed, Full)	Нет	Char() List
}
}

Параметры могут передаваться как отдельной строкой, так и списком строк в квадратных скобках. Пример JSON с заполненным фильтром, ниже:

Направление	Запрос/ответ
–>	{ “id”: " c52f1b33-b0d9-41a6-ae54-57f0e4aef17b", “method”: “LOC.GetLockers”, “params”: { “Filters”: { “Status”: “Open”, “City”: [“Белгород”, “Балашиха”], “LockerType”: “ПВЗ” } }}
Ответ на запрос:

Направление	Запрос/ответ
<–	{“jsonrpc”:“2.0”, “result”: [<список постаматов>], “id”: “c52f1b33-b0d9-41a6-ae54-57f0e4aef17b”}

Формат списка постаматов или пунктов выдачи:

Параметр		Описание	Обязательный	Тип
{
	LockerNumber	Номер постамата или пункта выдачи	Нет	Char()
	Address	Адрес	Нет	Char()
	PostalCode	Почтовый индекс	Нет	Char()
	City	Город	Нет	Char()
	Country	Страна	Нет	Char()
	CountryCode	Код Страны	Нет	Char()
	Region	Регион	Нет	Char()
	RegionCode	Код региона	Нет	Char()
	LockerContractor	Провайдер постомата или пункта выдачи	Нет	Char()
	LockerContractorICN	ИКН провайдера постомата или пункта выдачи	Нет	Char()
	LockerOwner	Владелец постамата или пункта выдачи	Нет	Char()
	LockerType	Постамат или пункт выдачи	Нет	Char()
	Latitude	Широта	Нет	Char()
	Longitude	Долгота	Нет	Char()
	MaxBoxSize	Максимальный размер коробки	Нет	Char()
	MaxSize	Максимальный размер ячейки в формате сумма измерений или “длина x ширина x глубина”	Нет	Char()
	Payments	Возможность COD	Нет	Char()
	Schedule:	Расписания работы точки	Нет	Char()
	[
	{
	Close At	Время закрытия	Нет	Char()
	Day	День недели (1- понедельник, 7- воскресенье)	Нет	Char()
	OpenAt	Время открытия	Нет	Char()
	}, …
	]
	Status	Статус (доступные: New, Open, Closed, Full)	Нет	Char()
}

При использовании данного АПИ для вывода постаматов и точек выдачи на карте необходимо руководствоваться приложением 4 по стилю вывода геометок партнеров в соответствии с LockerContractorICN партнера.

Печать этикеток. label

Функционал: Получение этикеток.

Дополнительная информация: Требуется авторизация токеном (см.пункт Авторизация).

Для печати этикеток используется GET запрос со следующими параметрами:

<base URL>/label?hwbRefNumber=<HWB Ref Number>&template=label_hwb.html

Где:

<base URL> - базовый адрес для вызова АПИ (тестового или рабочего)
<HWB Ref Number> - номер ранее загруженного отправления.

Получение веса и габаритов отправления в формате json. Метод HWB.GetWeight

Название метода: HWB.GetWeight.

Функционал: Получение веса и габаритов отправления. Запрос метода может быть выполнен в любой момент времени в соответствии с согласованным процессом.

Дополнительная информация: Требуется авторизация токеном (см.пункт Авторизация).

Важно: Для использования данного метода необходимо согласование с менеджером по сопровождению.

Пример вызова:

Направление	Запрос/ответ
–>	{“jsonrpc”:“2.0”, “method”: “HWB.GetWeight”, “params”:{“HWB”: [{“HWBRefNumber”: “refnumber1”}, {“HWBRefNumber”: “refnumber2”}]}, “id”: “c52f1b33-b0d9-41a6-ae54-57f0e4aef17b”}

Параметры содержат массив объектов с отправлениями, по которым надо получить вес и габариты. Элемент массива имеет вид: {"HWBRefNumber": "refnumber"}

Направление	Запрос/ответ
<–	{“jsonrpc”:“2.0”, “result”: {“HWB”: [<список отправлений>]}, “id”: “c52f1b33-b0d9-41a6-ae54-57f0e4aef17b”}

Формат элемента списка отправлений с весами:

Параметр			Описание	Обязательный	Тип
{
	HWBRefNumber		Клиентский номер отправки	Да	Char()
	HWBNumber		Номер отправки	Да	Char()
	Parcels: [			Да	Object() List
		{
		RefBarCode	Штрих код места отправления	Да	Char(50)
		Weight	Вес, грамм	Да	Int
		Width	Ширина, мм	Да	Int
		Depth	Высота, мм	Да	Int
		Length	Длина, мм	Да	Int
		}, …
	]
}

Приложение 1. Список возможных событий с отправлением

Event place	Code	Описание RUS	Description ENG
IN	NW	Получена информация об отправлении	Waybill’s information accepted.
FM	WA	Принято на складе 1-й мили.	Accepted in stock of first mile
FM	CSW	Отправлено на склад 1-ой мили	Sended to the 1st mile warehouse
FM	WD	Убыло со склада 1-й мили.	Departured from 1-st mile warehouse.
FM	AW	Принято на склад	Accepted to the warehouse
FM	LW	Покинуло склад	Left the warehouse
FF	ZC	Готово к вылету в страну получателя.	Ready for air shipment to the destination country
FF	RS	Покинуло страну происхождения	Departed country of origin
FF	PL	Посылка потеряна.	Sending is lost
FF	NWC	Отменен	Cancelled
FF	UT	Утилизировано	Utilized
FF	SH	Не найдено при сканировании	Not found when scanning
FF	SPD	Посылка подлежит уничтожению/утилизации по причине сильного повреждения	The parcel is subject to destruction/disposal due to severe damage
FF	NWCFM	Отменен на первой миле	Canceled on a first mile
FF	NWCHM	Посылка отклонена перевозчиком, так как содержит опасные материалы	Parcel rejected by carrier due to Hazard Materials.
FF	NWCFG	Посылка отклонена перевозчиком, так как содержит запрещённые товары	Parcel rejected by carrier due to forbidden goods.
IN	WP	Проблема. Некорректный телефон.	Problem. Phone number incorrect
IN	ZZ	Направлено повторное оповещение клиенту	Repeated notification sent to the client
CC	AI	Прибыло в страну назначения.	Arrival at destination country
CC	CT	Таможенный транзит	Customs transit
CC	CI	Прибыло на таможню.	Arrived at the customs
CC	CR	Выпущено таможенным органом.	Customs clearance complete
CC	CO	Убыло из таможни.	Released by customs
CC	ASF	Запрет от таможни или секюрити.	Prohibition from customs or security
CC	HBA	Проблема. Задержано таможней.	Problem. Detained by customs
CC	IDOK	Паспортные данные собраны	ID data collected
CC	IDCE	Время для сбора паспортных данных истекло	Time for ID data collecting expired
CC	RIC	Квитанция выставлена таможенным органом	Receipt Issued by the Customs
CC	RPR	Квитанция оплачена получателем	Receipt Paid by Recipient
CC	PBA	Одобрено таможенным представителем	Broker Approved
CC	HBA41	Отказ в выпуске. Не для личного пользования.	Refusal to release. Not for personal use.
CC	HBA42	Отказ в выпуске. Не предоставлены документы.	Refusal to release. No necessary documents.
CC	HBA43	Отказ в выпуске технического характера.	Refusal to release. Technical reason.
CC	HBA44	Отказ в выпуске. Некорректные ПД.	Refusal to release. Incorrect ID.
CC	HBA45	Отказ в выпуске. Недействительные ПД.	Refusal to release. Invalid ID.
CC	HBA46	Отказ в выпуске. Иное.	Refusal to release. In another cases.
CC	CR2	Выпущено таможенным органом без платежей.	Customs clearance complete without payments.
CC	CR3	Выпущено таможенным органом с платежом.	Customs clearance complete with payments.
CC	ARN	Передано на оформление в таможню.	Declared to customs.
CC	DOCOK	Документы для подачи в ТО предоставлены	Documents for the Customs were submitted
CC	SIR	Передано на индивидуальное оформление клиенту	Submitted for Individual Registration
CC	ERT	Продление срока выпуска	Extension of release dates
CC	REGTO	Присвоен регистрационный таможенный номер	Customs registration number assigned
CC	ASF4	Проблема. Необходимо подтверждение паспортных данных для таможни	Problem. Passport data confirmation required for custom
CC	CNP5	Сбой информационной системы таможенных органов	Failure of the customs information system
CC	RSW	Отправление готово к отгрузке со склада	The shipment is ready for departure from the warehouse
CC	ASF1	Товары не для личного пользования	Products are not for personal usage
CC	ASF2	Ссылка на товар не рабочая	The URL to the product is incorrect
CC	ASF3	Стоимость товара некорректна	The product price is incorrect
CC	ASF5	Запрос документов и сведений от таможенных органов	Request for documents and information from Customs
CC	RPI	Отказ от предоставления информации получателем	Refusal to provide information by the recipient
CC	RPC	Отказ или истекло время уплаты таможенных платежей	Refusal or time for payment of customs duties has expired
CC	PIB	Товар поврежден (повреждение упаковки груза)	The item is damaged(the outer packaging is broken)
CC	CF1	Отправление не прилетело	The package didn’t arrive
CC	CF3	Товары изъяты таможенными органами	Goods seized by customs authorities
CC	HBA46-2	Отказ в выпуске. Иное. Некорректные ПД.	Refusal to release. In another cases. Incorrect ID.
CC	DS	Задержка вылета.	Departure delay.
CC	ARNE	Начато таможенное оформление в стране отправления	Customs clearance has begun in the country of departure
CC	CRE	Завершено таможенное оформление в стране отправления	Customs clearance in the country of departure has been completed
LM	OK	Доставлено.	Delivered
LM	CL	Принято контрагентом.	Accepted by the counterpart
LM	LI	Передано на linehaul	Shipped by linehaul
LM	RB	Прибыло в пункт назначения.	Delivered at the destination
LM	DC	Выдано в доставку.	Issued for delivery
LM	BA	Не доставлено. Неправильный адрес	Undelivered. Wrong address
LM	CA	Не доставлено. Офис закрыт.	Undelivered. The office is closed
LM	CM	Не доставлено. Получатель переехал.	Undelivered. The recipient has moved
LM	DD	Доставлено с повреждением.	Delivered with damage
LM	LL	Отправление в пункте выдачи.	Sending is in the pickup point or in the locker
LM	ND	Не доставлено.	Undelivered
LM	NH	Не доставлено. Получателя нет дома	Undelivered. The recipient is not at home
LM	RD	Отказ от отправления.	Refusal from the sending
LM	SC	Передано для доставки контрагенту.	Handed to counterparty for the delivery
LM	UC	Не востребовано в пункте выдачи.	Unclaimed at the pickup office or at the locker
LM	LC	В процессе транспортировки	In transit
LM	RC	В процессе возврата отправителю	Return in process
LM	RT	Возвращено отправителю	Returned to sender
LM	WFR	Ожидается согласование повторной доставки.	Waiting for repickup.

Приложение 2. Список кодов ошибок

Код	Сообщение	Описание
32700	Ошибка парсинга	Получен некорректный JSON.
32600	Ошибка запроса	Неправильный формат JSON.
32601	Метод не найден	Указанного метода не существует.
32602	Неправильные параметры	Неправильные параметры указанного метода.
32603	Внутренняя ошибка.	Внутренняя ошибка JSON-RPC.
32001	Токен просрочен	В запросе используется просроченный токен.
32002	Неизвестный токен	В запросе используется неизвестный токен.
32003	Неправильный логин/пароль	AUTH.Login: Неправильный логин/пароль

Приложение 3. Вид JSON HWB

Структура JSON				Описание	M	Тип
{
HWBRefNumber				Клиентский номер HWB	Да	Char(50)
OrderDate				Дата заказа/HWB	Нет	DateTime
ConsigmentNumber				Номер консолидированного места (только для method MNF.UploadFull)	Нет	Char(128)
DeliveryComments				Комментарии по доставке	Нет	Char(512)
ContractNumber				Клиентский номер договора HWB	Да	Char(12)
CODIndicator				Есть(1)/нет(0) COD	Нет	Int
ChargeableSum				Сумма COD в валюте страны получателя. Для России всегда в RUB	Нет	Numeric(10,3)
ServiceCode				Код основной услуги	Да	Char(8)
ParcelQty				Количество посылок в HWB	Да	Int
HWBWeight				Вес HWB, грамм	Да	Int
GoodsCurrency				Валюта стоимости товара HWB ISO4217	Да	Char(3)
DeliveryValue				Стоимость доставки HWB в валюте GoodsCurrency.Если доставка беслатна,то указывается 0	Да	Numeric(10,3)
DeclaredValue				Оценочная стоимость HWB	Да	Numeric(10,3)
DeclaredCurrency				Валюта оценочной стоимости ISO4217	Да	Char(3)
LastMileInfo: {				Информация по последней миле	Нет	JSON
	Contractor			Наименование контрагента	Да	Char(128)
	ContractorICN			Номер договора контрагента	Нет	Char(12)
}
Incoterms				Incoterms - EXW, FCA, FAS, FOB, CFR, CIF, CPT, CIP, DAP, DPU, DDP. По умолчанию DAP	Нет	Char(3)
AdditionalServices:[				Дополнительные сервисы (массив значений)	Нет	JSON
	ServiceCode			Код дополнительного сервиса	Нет	Char(8)
]
HWBExtras:[				Дополнительные параметры в формате: [{ExtraKey:key, ExtraValue:value},…]	Нет	JSON
	ExtraKey				Да	Char(64)
	ExtraValue				Да	Char(128)
]
Files :[				Изображения документов.Макс.размер: 5МбФормат:pdf или любой формат изображений	Нет	List
	{
		Data		Стандартный Base64 с изображениями	Да	Char
		FileName		Наиметование файла	Да	Char(512)
		Metadata :{		Дополнительная информация	Да	JSON
			Description	Описание документа	Да	Char(512)
			Source	Должно быть “External”	Да	Char
		}
	}
]
SenderInfo: {				Информация об отправителе	Да	JSON
	Name			ФИО отправителя	Да	Char(128)
	Phone			Телефон	Нет	Char(20)
	MobilePhone			Мобильный телефон	Нет	Char(20)
	Email			Email	Нет	Char(50)
	AddressRB			Справочник, из которого получен код адреса	Нет	Char(8)
	AddressCode			Код адреса отправителя	Нет	Char(20)
	ExtraContact: [			Дополнительные контакты. Мессенджеры, соцсети и т.д.	Нет	JSON
		{
		ContactType		Тип контакта	Да	Char(32)
		ContactNumber		Номер контакта	Да	Char(128)
		}, …
	]
	SenderAddress : {			Адрес отправителя	Да	JSON
		CountryCode		Код страны ISO3166 alpha2	Да	Char(2)
		RegionCode		Код региона ISO3166-2	Нет	Char(8)
		City		Город	Да	Char(100)
		PostCode		Индекс	Нет	Char(16)
		District		Район	Нет	Char(100)
		Street		Улица	Да	Char(256)
		Building		Номер дома	Да	Char(20)
		Company		Компания	Нет	Char(128)
		Latitude		Широта	Нет	Float
		Longitude		Долгота	Нет	Float
		LockerID		ID пункта сбора/постамата	Нет	Char(16)
	}
}
ReceiverInfo: {				Информация о получателя	Да	JSON
	Name			ФИО получателя, В случае предоставления ПД получателя (Personal Data.FullName) данные должны быть идентичными	Да	Char(128)
	Phone			Телефон	Нет	Char(20)
	MobilePhone			Мобильный телефон	Да	Char(20)
	Email			Email	Нет	Char(50)
	AddressRB			Справочник, из которого получен код адреса	Нет	Char(5)
	AddressCode			Код адреса получателя	Нет	Char(20)
	ReceiverCode			Код получателя	Нет	Char(20)
	ExtraContact: [			Дополнительные контакты. Мессенджеры, соцсети и т.д.	Нет	List
		{
		ContactType		Тип контакта	Да	Char(32)
		ContactNumber		Номер контакта	Да	Char(128)
		}, …
	]
	ReceiverAddress : {			Адрес получателя	Да	JSON
		CountryCode		Код страны ISO3166 alpha2	Да	Char(2)
		RegionCode		Код региона ISO3166-2	Нет	Char(8)
		City		Город	Да	Char(100)
		PostCode		Индекс	Нет	Char(16)
		District		Район	Нет	Char(100)
		Street		УлицаПолностью указывается адрес:улица, дом, корпус(если есть),квартира(если требуется доставка до двери).В случае отсутствия улицы, она может быть пропущена, остальные данные адерса заполняются согласно очередности. Заполняется либо поле Building, либо Street	Да	Char(256)
		Building		Номер домаВ случае отсутствия улицы, она может быть пропущена, остальные данные адерса заполняются согласно очередности (дом, корпус(если есть), квартира).Заполняется либо поле Building, либо Street	Да	Char(20)
		Company		Компания	Нет	Char(128)
		Latitude		Широта	Нет	Float
		Longitude		Долгота	Нет	Float
		LockerID		ID пункта выдачи/постамата	Нет	Char(16)
	}
	PersonalData : {			Персональные данные для таможенного оформления	Нет	JSON
		IDNumber		Серия и номер документа	Да	Char(16)
		IDDocType		Тип документа	Да	Char(50)
		IDIssueDate		Дата выдачи документа	Да	Date
		FullName		Полное имя (как в документе). Данные должны быть идентичными с ReceiverInfo.Name	Да	Char(128)
		IdentityCardGiven		Кем выдан документ	Да	Char(512)
		TaxNumber		ИНН	Да	Char(16)
		BirthDate		Дата рождения	Нет	Date
		Gender		Пол	Нет	Char(1)
		Files :[		Изображения документов.Макс.размер: 5МбФормат:pdf или любой формат изображений	Нет	List
			{
			Data	Стандартный Base64 с изображениями	Да	Char
			FileName	Наиметование файла	Да	Char(512)
			Metadata :{	Дополнительная информация	Да	JSON
			Picid	1 для паспорта, 2 для остальных докуметов	Да	Char
			Doctype	21 для российского паспорта, 10 для остальных документов	Да	Char
			Source	Должно быть “External”	Да	Char
			}
			}
	}
}
Parcels: [				Посылки по HWB	Да	List
	{
	BarCode			Штрих код посылки	Нет	Char(20)
	RefBarCode			Штрих код отправителя посылки	Да	Char(64)
	Weight			Вес, грамм	Да	Int
	ParcelNo			Номер по порядку	Нет	Int
	Width			Ширина, мм	Нет	Int
	Depth			Высота, мм	Нет	Int
	Length			Длина, мм	Нет	Int
	Description			Описание	Да	Char(512)
	ParcelExtras:{			Дополнительные параметры в формате	Нет	JSON
	}
	Items:[			Содержимое посылки	Нет	List
		{
		Description		Описание товара	Да	Char(128)
		UnitValue		Стоимость единицы товара	Да	Numeric(10,3)
		CountryOfOrigin		Страна происхождения в формате ISO 3166 alpha2	Да	Char(2)
		UnitWeight		Вес одной единицы товара, грамм	Да	Int
		Quantity		Количество единиц товара	Да	Int
		DetailedDescription		Детальное описание товара	Нет	Char(1024)
		ConstructionComposition		Состав изделия	Нет	Char(1024)
		URL		Ссылка на товар в интернет-магазине	Да	Char(1024)
		HTSCode		Коды ТНВЭД	Нет	Char(32)
		HTSCodeExport		HS Код для экспорта	Нет	Char(32)
		VATRate		Величина налога	Нет	Int
		SKUBarcode		Штрихкод товара	Нет	Char(50)
		CatalogTypes:{		Категория на разный языках.	Нет	JSON
			CN	Китайский	Нет	Key value
			EN	Английский	Нет	Key value
			RU	Русский	Нет	Key value
		}		Пример: “CatalogTypes”: {“CN”:“Cat1”, “EN”: “Cat2”, “RU”: “Кат3”}
		ItemExtras:{		Дополнительные параметры в формате	Нет	JSON
		}
		}, …
	]
}, …
]
}

Пример json с данными HWB можно посмотреть здесь

Приложение 4. Использование геометок партнеров

5Post

Местонахождение всех пунктов выдачи (постаматы и выдача на кассе) посылок «5post» должны быть отмечены фирменной иконкой геолокации(см.таблицу ниже).

Таблица. Геометки партнера 5Post

Описание геометки	Геометка
Все постаматы 5post должны быть отмечены иконкой геолокации в форме капли в фирменном сером цвете
Все пункты выдачи посылок 5post на кассе в магазине «Пятерочка» должны быть отмечены иконкой геолокации в форме капли в белом цвете с серым обводом
Все пункты выдачи заказов компании 5post должны быть отмечены иконкой геолокации в форме капли в зеленом цвете с серым обводом

В случае если вариант формы «капля» противоречит общей стилистике карты, можно использовать круглые иконки геолокации – в фирменном сером цвете для постаматов, в белом цвете с серым обводом для пунктов выдачи посылок 5Post на кассе в магазине «Пятерочка». Примеры представлены ниже:

Пример json с данными HWB

{
    "jsonrpc": "2.0",
    "method": "HWB.Upload",
    "params": {
        "Synch": true,
        "TotalWeight": 7800,
        "TotalVolume": 0,
        "TotalCOD": 0,
        "HWBQty": 5,
        "ContractNumber": "9900000000",
        "HWB": [
            {
                "OrderDate": "2022-11-11 11:11:11+03:00",
                "HWBRefNumber": "SPSR01RU",
                "DeclaredValue": 210.77,
                "DeclaredCurrency": "USD",
                "ServiceCode": "tst",
                "ParcelQty": 1,
                "Files": [
                    {
                        "FileName": "invoice.pdf",
                        "Data": "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CmVuZG9iagoKOSAwIG9iago8PC9UeXBlL0ZvbnQvU3VidHlwZS9UcnVlVHlwZS9CYXNlRm9udC9CQUFBQUErQXJpYWwtQm9sZE1UCi9GaXJzdENoYXIgMAovTGFzdENoYXIgMTEKL1dpZHRoc1s3NTAgNzIyIDYxMCA4ODkgNTU2IDI3NyA2NjYgNjEwIDMzMyAyNzcgMjc3IDU1NiBdCi9Gb250RGVzY3JpcHRvciA3IDAgUgovVG9Vbmljb2RlIDggMCBSCj4+CmVuZG9iagoKMTAgMCBvYmoKPDwKL0YxIDkgMCBSCj4+CmVuZG9iagoKMTEgMCBvYmoKPDwvRm9udCAxMCAwIFIKL1Byb2NTZXRbL1BERi9UZXh0XT4+CmVuZG9iagoKMSAwIG9iago8PC9UeXBlL1BhZ2UvUGFyZW50IDQgMCBSL1Jlc291cmNlcyAxMSAwIFIvTWVkaWFCb3hbMCAwIDU5NSA4NDJdL0dyb3VwPDwvUy9UcmFuc3BhcmVuY3kvQ1MvRGV2aWNlUkdCL0kgdHJ1ZT4+L0NvbnRlbnRzIDIgMCBSPj4KZW5kb2JqCgoxMiAwIG9iago8PC9Db3VudCAxL0ZpcnN0IDEzIDAgUi9MYXN0IDEzIDAgUgo+PgplbmRvYmoKCjEzIDAgb2JqCjw8L1RpdGxlPEZFRkYwMDQ0MDA3NTAwNkQwMDZEMDA3OTAwMjAwMDUwMDA0NDAwNDYwMDIwMDA2NjAwNjkwMDZDMDA2NT4KL0Rlc3RbMSAwIFIvWFlaIDU2LjcgNzczLjMgMF0vUGFyZW50IDEyIDAgUj4+CmVuZG9iagoKNCAwIG9iago8PC9UeXBlL1BhZ2VzCi9SZXNvdXJjZXMgMTEgMCBSCi9NZWRpYUJveFsgMCAwIDU5NSA4NDIgXQovS2lkc1sgMSAwIFIgXQovQ291bnQgMT4+CmVuZG9iagoKMTQgMCBvYmoKPDwvVHlwZS9DYXRhbG9nL1BhZ2VzIDQgMCBSCi9PdXRsaW5lcyAxMiAwIFIKPj4KZW5kb2JqCgoxNSAwIG9iago8PC9BdXRob3I8RkVGRjAwNDUwMDc2MDA2MTAwNkUwMDY3MDA2NTAwNkMwMDZGMDA3MzAwMjAwMDU2MDA2QzAwNjEwMDYzMDA2ODAwNkYwMDY3MDA2OTAwNjEwMDZFMDA2RTAwNjkwMDczPgovQ3JlYXRvcjxGRUZGMDA1NzAwNzIwMDY5MDA3NDAwNjUwMDcyPgovUHJvZHVjZXI8RkVGRjAwNEYwMDcwMDA2NTAwNkUwMDRGMDA2NjAwNjYwMDY5MDA2MzAwNjUwMDJFMDA2RjAwNzIwMDY3MDAyMDAwMzIwMDJFMDAzMT4KL0NyZWF0aW9uRGF0ZShEOjIwMDcwMjIzMTc1NjM3KzAyJzAwJyk+PgplbmRvYmoKCnhyZWYKMCAxNgowMDAwMDAwMDAwIDY1NTM1IGYgCjAwMDAwMTE5OTcgMDAwMDAgbiAKMDAwMDAwMDAxOSAwMDAwMCBuIAowMDAwMDAwMjI0IDAwMDAwIG4gCjAwMDAwMTIzMzAgMDAwMDAgbiAKMDAwMDAwMDI0NCAwMDAwMCBuIAowMDAwMDExMTU0IDAwMDAwIG4gCjAwMDAwMTExNzYgMDAwMDAgbiAKMDAwMDAxMTM2OCAwMDAwMCBuIAowMDAwMDExNzA5IDAwMDAwIG4gCjAwMDAwMTE5MTAgMDAwMDAgbiAKMDAwMDAxMTk0MyAwMDAwMCBuIAowMDAwMDEyMTQwIDAwMDAwIG4gCjAwMDAwMTIxOTYgMDAwMDAgbiAKMDAwMDAxMjQyOSAwMDAwMCBuIAowMDAwMDEyNDk0IDAwMDAwIG4gCnRyYWlsZXIKPDwvU2l6ZSAxNi9Sb290IDE0IDAgUgovSW5mbyAxNSAwIFIKL0lEIFsgPEY3RDc3QjNEMjJCOUY5MjgyOUQ0OUZGNUQ3OEI4RjI4Pgo8RjdENzdCM0QyMkI5RjkyODI5RDQ5RkY1RDc4QjhGMjg+IF0KPj4Kc3RhcnR4cmVmCjEyNzg3CiUlRU9GCgAA",
                        "Metadata": {
                            "Source": "External",
                            "Test": "Тест"
                        }
                    },
                    {
                        "FileName": "hello.txt",
                        "Data": "aGVsbG8gd29ybGQK",
                        "Metadata": {
                            "Description": "hello.txt",
                            "Source": "External"
                        }
                    }
                ],
                "SenderInfo": {
                    "Name": "Test LLC",
                    "SenderAddress": {
                        "Company": "Test LLC",
                        "CountryCode": "US"
                    }
                },
                "ReceiverInfo": {
                    "Name": "Сидоров Сидор Сидорович",
                    "MobilePhone": "+71111111111",
                    "Phone": "",
                    "Email": "info@spsr.tech",
                    "PersonalData": {
                        "FullName": "Сидоров Сидор Сидорович",
                        "IDDocType": "Паспорт",
                        "IDIssueDate": "2004-08-31",
                        "IDNumber": "1111 111111",
                        "IdentityCardGiven": "ОТДЕЛЕНИЕМ МИЛИЦИИ ГОРОДА Москвы",
                        "TaxNumber": "111111111130",
                        "BirthDate": ""
                    },
                    "ReceiverAddress": {
                        "Building": "",
                        "City": "Москва",
                        "Street": "Партийный проезд, д.1, кор. 11",
                        "District": "",
                        "Company": "",
                        "CountryCode": "RU",
                        "LockerID": "",
                        "PostCode": "",
                        "Region": ""
                    }
                },
                "Parcels": [
                    {
                        "Weight": 1560,
                        "ParcelNo": 1,
                        "RefBarCode": "SPSR01RU",
                        "Items": [
                            {
                                "Quantity": 1,
                                "UnitValue": 26.79,
                                "Description": "Детские джинсы, для девочки. Размер: 10 лет, Цвет: Голубой",
                                "DetailedDescription": "Детские джинсы, для девочки. Размер: 10 лет, Цвет: Голубой",
                                "URL": "https://www.amazon.com/gp/product/B07J5Q4KJN/ref=ppx_od_dt_b_asin_title_s00?ie=UTF8&psc=1",
                                "HTSCode": "",
                                "UnitWeight": 310,
                                "CountryOfOrigin": "US",
                                "CatalogTypes": {
                                    "CN": "Test1",
                                    "EN": "Test2",
                                    "RU": "Test3"
                                }
                            },
                            {
                                "Quantity": 1,
                                "UnitValue": 10.99,
                                "Description": "Защитное стекло для мобильного телефона iPhone 11 / iPhone XR. Упаковка из 2 шт.",
                                "DetailedDescription": "Защитное стекло для мобильного телефона iPhone 11 / iPhone XR. Упаковка из 2 шт.",
                                "URL": "https://www.amazon.com/gp/product/B07GX33WVR/ref=ppx_od_dt_b_asin_title_s00?ie=UTF8&psc=1",
                                "HTSCode": "",
                                "UnitWeight": 320,
                                "CountryOfOrigin": "US",
                                "CatalogTypes": {
                                    "CN": "Test1",
                                    "EN": "Test2",
                                    "RU": "Test3"
                                }
                            },
                            {
                                "Quantity": 1,
                                "UnitValue": 7.99,
                                "Description": "Защитное стекло для мобильного телефона iPhone 11 Pro / iPhone Xs / iPhone X. Упаковка из 2 шт.",
                                "DetailedDescription": "Защитное стекло для мобильного телефона iPhone 11 Pro / iPhone Xs / iPhone X. Упаковка из 2 шт.",
                                "URL": "https://www.amazon.com/gp/product/B07HRYZFN3/ref=ppx_od_dt_b_asin_title_s00?ie=UTF8&psc=1",
                                "HTSCode": "",
                                "UnitWeight": 330,
                                "CountryOfOrigin": "US",
                                "CatalogTypes": {
                                    "CN": "Test1",
                                    "EN": "Test2",
                                    "RU": "Test3"
                                }
                            },
                            {
                                "Quantity": 1,
                                "UnitValue": 90,
                                "Description": "Смарт часы Apple watch Series 1, 38 mm, Цвет: Серебристый, комплект ремешков, бывшие в употреблении. +пакетик фруктового мармелада +магнит на холодильник в подарок к заказу",
                                "DetailedDescription": "Смарт часы Apple watch Series 1, 38 mm, Цвет: Серебристый, комплект ремешков, бывшие в употреблении. +пакетик фруктового мармелада +магнит на холодильник в подарок к заказу",
                                "URL": "http://www.ebay.com/itm/293217815646",
                                "HTSCode": "",
                                "UnitWeight": 290,
                                "CountryOfOrigin": "US",
                                "CatalogTypes": {
                                    "CN": "Test1",
                                    "EN": "Test2",
                                    "RU": "Test3"
                                }
                            },
                            {
                                "Quantity": 1,
                                "UnitValue": 75,
                                "Description": "Смарт часы Apple watch Series 1, 44 mm, Цвет: Розовый, бывшие в употреблении",
                                "DetailedDescription": "Смарт часы Apple watch Series 1, 44 mm, Цвет: Розовый, бывшие в употреблении",
                                "URL": "https://www.ebay.com/itm/254342810565",
                                "HTSCode": "",
                                "UnitWeight": 310,
                                "CountryOfOrigin": "US",
                                "CatalogTypes": {
                                    "CN": "Test1",
                                    "EN": "Test2",
                                    "RU": "Test3"
                                }
                            }
                        ]
                    }
                ],
                "ContractNumber": "9900000000",
                "HWBWeight": 1560
            },
            {
                "OrderDate": "2022-11-11 11:11:11+03:00",
                "HWBRefNumber": "SPSR02RU",
                "DeclaredValue": 210.77,
                "DeclaredCurrency": "USD",
                "ServiceCode": "tst",
                "ParcelQty": 1,
                "SenderInfo": {
                    "Name": "Test LLC",
                    "SenderAddress": {
                        "Company": "Test LLC",
                        "CountryCode": "US"
                    }
                },
                "ReceiverInfo": {
                    "Name": "Иванов Иван Иванович",
                    "MobilePhone": "+71111111111",
                    "Phone": "",
                    "Email": "info@spsr.tech",
                    "PersonalData": {
                        "FullName": "Иванов Иван Иванович",
                        "IDDocType": "Паспорт",
                        "IDIssueDate": "2004-08-31",
                        "IDNumber": "1234 567890",
                        "IdentityCardGiven": "ОТДЕЛЕНИЕМ МИЛИЦИИ ГОРОДА Москвы",
                        "TaxNumber": "111111111111",
                        "BirthDate": ""
                    },
                    "ReceiverAddress": {
                        "Building": "",
                        "City": "Москва",
                        "Street": "Партийный проезд, д.1, кор. 11",
                        "District": "",
                        "Company": "",
                        "CountryCode": "RU",
                        "LockerID": "",
                        "PostCode": "",
                        "Region": ""
                    }
                },
                "Parcels": [
                    {
                        "Weight": 1560,
                        "ParcelNo": 1,
                        "RefBarCode": "SPSR02RU",
                        "Items": [
                            {
                                "Quantity": 1,
                                "UnitValue": 26.79,
                                "Description": "Детские джинсы, для девочки. Размер: 10 лет, Цвет: Голубой",
                                "DetailedDescription": "Детские джинсы, для девочки. Размер: 10 лет, Цвет: Голубой",
                                "URL": "https://www.amazon.com/gp/product/B07J5Q4KJN/ref=ppx_od_dt_b_asin_title_s00?ie=UTF8&psc=1",
                                "HTSCode": "",
                                "UnitWeight": 310,
                                "CountryOfOrigin": "US",
                                "CatalogTypes": {
                                    "CN": "Test1",
                                    "EN": "Test2",
                                    "RU": "Test3"
                                }
                            },
                            {
                                "Quantity": 1,
                                "UnitValue": 10.99,
                                "Description": "Защитное стекло для мобильного телефона iPhone 11 / iPhone XR. Упаковка из 2 шт.",
                                "DetailedDescription": "Защитное стекло для мобильного телефона iPhone 11 / iPhone XR. Упаковка из 2 шт.",
                                "URL": "https://www.amazon.com/gp/product/B07GX33WVR/ref=ppx_od_dt_b_asin_title_s00?ie=UTF8&psc=1",
                                "HTSCode": "",
                                "UnitWeight": 320,
                                "CountryOfOrigin": "US",
                                "CatalogTypes": {
                                    "CN": "Test1",
                                    "EN": "Test2",
                                    "RU": "Test3"
                                }
                            },
                            {
                                "Quantity": 1,
                                "UnitValue": 7.99,
                                "Description": "Защитное стекло для мобильного телефона iPhone 11 Pro / iPhone Xs / iPhone X. Упаковка из 2 шт.",
                                "DetailedDescription": "Защитное стекло для мобильного телефона iPhone 11 Pro / iPhone Xs / iPhone X. Упаковка из 2 шт.",
                                "URL": "https://www.amazon.com/gp/product/B07HRYZFN3/ref=ppx_od_dt_b_asin_title_s00?ie=UTF8&psc=1",
                                "HTSCode": "",
                                "UnitWeight": 330,
                                "CountryOfOrigin": "US",
                                "CatalogTypes": {
                                    "CN": "Test1",
                                    "EN": "Test2",
                                    "RU": "Test3"
                                }
                            },
                            {
                                "Quantity": 1,
                                "UnitValue": 90,
                                "Description": "Смарт часы Apple watch Series 1, 38 mm, Цвет: Серебристый, комплект ремешков, бывшие в употреблении. +пакетик фруктового мармелада +магнит на холодильник в подарок к заказу",
                                "DetailedDescription": "Смарт часы Apple watch Series 1, 38 mm, Цвет: Серебристый, комплект ремешков, бывшие в употреблении. +пакетик фруктового мармелада +магнит на холодильник в подарок к заказу",
                                "URL": "http://www.ebay.com/itm/293217815646",
                                "HTSCode": "",
                                "UnitWeight": 290,
                                "CountryOfOrigin": "US",
                                "CatalogTypes": {
                                    "CN": "Test1",
                                    "EN": "Test2",
                                    "RU": "Test3"
                                }
                            },
                            {
                                "Quantity": 1,
                                "UnitValue": 75,
                                "Description": "Смарт часы Apple watch Series 1, 44 mm, Цвет: Розовый, бывшие в употреблении",
                                "DetailedDescription": "Смарт часы Apple watch Series 1, 44 mm, Цвет: Розовый, бывшие в употреблении",
                                "URL": "https://www.ebay.com/itm/254342810565",
                                "HTSCode": "",
                                "UnitWeight": 310,
                                "CountryOfOrigin": "US",
                                "CatalogTypes": {
                                    "CN": "Test1",
                                    "EN": "Test2",
                                    "RU": "Test3"
                                }
                            }
                        ]
                    }
                ],
                "ContractNumber": "9900000000",
                "HWBWeight": 1560
            },
            {
                "OrderDate": "2022-11-11 11:11:11+03:00",
                "HWBRefNumber": "SPSR03RU",
                "DeclaredValue": 210.77,
                "DeclaredCurrency": "USD",
                "ServiceCode": "tst",
                "ParcelQty": 1,
                "SenderInfo": {
                    "Name": "Test LLC",
                    "SenderAddress": {
                        "Company": "Test LLC",
                        "CountryCode": "US"
                    }
                },
                "ReceiverInfo": {
                    "Name": "Петров Петр Петрович",
                    "MobilePhone": "",
                    "Phone": "",
                    "Email": "ceo@spsr.tech",
                    "PersonalData": {
                        "FullName": "Петров Петр Петрович",
                        "IDDocType": "Паспорт",
                        "IDIssueDate": "2004-08-31",
                        "IDNumber": "1111 111111",
                        "IdentityCardGiven": "ОТДЕЛЕНИЕМ МИЛИЦИИ ГОРОДА Москвы",
                        "TaxNumber": "111111111111",
                        "BirthDate": ""
                    },
                    "ReceiverAddress": {
                        "Building": "",
                        "City": "Москва",
                        "Street": "Партийный проезд, д.1, кор. 11",
                        "District": "",
                        "Company": "",
                        "CountryCode": "RU",
                        "LockerID": "",
                        "PostCode": "",
                        "Region": ""
                    }
                },
                "Parcels": [
                    {
                        "Weight": 1560,
                        "ParcelNo": 1,
                        "RefBarCode": "SPSR03RU",
                        "Items": [
                            {
                                "Quantity": 1,
                                "UnitValue": 26.79,
                                "Description": "Детские джинсы, для девочки. Размер: 10 лет, Цвет: Голубой",
                                "DetailedDescription": "Детские джинсы, для девочки. Размер: 10 лет, Цвет: Голубой",
                                "URL": "https://www.amazon.com/gp/product/B07J5Q4KJN/ref=ppx_od_dt_b_asin_title_s00?ie=UTF8&psc=1",
                                "HTSCode": "",
                                "UnitWeight": 310,
                                "CountryOfOrigin": "US",
                                "CatalogTypes": {
                                    "CN": "Test1",
                                    "EN": "Test2",
                                    "RU": "Test3"
                                }
                            },
                            {
                                "Quantity": 1,
                                "UnitValue": 10.99,
                                "Description": "Защитное стекло для мобильного телефона iPhone 11 / iPhone XR. Упаковка из 2 шт.",
                                "DetailedDescription": "Защитное стекло для мобильного телефона iPhone 11 / iPhone XR. Упаковка из 2 шт.",
                                "URL": "https://www.amazon.com/gp/product/B07GX33WVR/ref=ppx_od_dt_b_asin_title_s00?ie=UTF8&psc=1",
                                "HTSCode": "",
                                "UnitWeight": 320,
                                "CountryOfOrigin": "US",
                                "CatalogTypes": {
                                    "CN": "Test1",
                                    "EN": "Test2",
                                    "RU": "Test3"
                                }
                            },
                            {
                                "Quantity": 1,
                                "UnitValue": 7.99,
                                "Description": "Защитное стекло для мобильного телефона iPhone 11 Pro / iPhone Xs / iPhone X. Упаковка из 2 шт.",
                                "DetailedDescription": "Защитное стекло для мобильного телефона iPhone 11 Pro / iPhone Xs / iPhone X. Упаковка из 2 шт.",
                                "URL": "https://www.amazon.com/gp/product/B07HRYZFN3/ref=ppx_od_dt_b_asin_title_s00?ie=UTF8&psc=1",
                                "HTSCode": "",
                                "UnitWeight": 330,
                                "CountryOfOrigin": "US",
                                "CatalogTypes": {
                                    "CN": "Test1",
                                    "EN": "Test2",
                                    "RU": "Test3"
                                }
                            },
                            {
                                "Quantity": 1,
                                "UnitValue": 90,
                                "Description": "Смарт часы Apple watch Series 1, 38 mm, Цвет: Серебристый, комплект ремешков, бывшие в употреблении. +пакетик фруктового мармелада +магнит на холодильник в подарок к заказу",
                                "DetailedDescription": "Смарт часы Apple watch Series 1, 38 mm, Цвет: Серебристый, комплект ремешков, бывшие в употреблении. +пакетик фруктового мармелада +магнит на холодильник в подарок к заказу",
                                "URL": "http://www.ebay.com/itm/293217815646",
                                "HTSCode": "",
                                "UnitWeight": 290,
                                "CountryOfOrigin": "US",
                                "CatalogTypes": {
                                    "CN": "Test1",
                                    "EN": "Test2",
                                    "RU": "Test3"
                                }
                            },
                            {
                                "Quantity": 1,
                                "UnitValue": 75,
                                "Description": "Смарт часы Apple watch Series 1, 44 mm, Цвет: Розовый, бывшие в употреблении",
                                "DetailedDescription": "Смарт часы Apple watch Series 1, 44 mm, Цвет: Розовый, бывшие в употреблении",
                                "URL": "https://www.ebay.com/itm/254342810565",
                                "HTSCode": "",
                                "UnitWeight": 310,
                                "CountryOfOrigin": "US",
                                "CatalogTypes": {
                                    "CN": "Test1",
                                    "EN": "Test2",
                                    "RU": "Test3"
                                }
                            }
                        ]
                    }
                ],
                "ContractNumber": "9900000000",
                "HWBWeight": 1560
            },
            {
                "OrderDate": "2022-11-11 11:11:11+03:00",
                "HWBRefNumber": "SPSR04RU",
                "DeclaredValue": 210.77,
                "DeclaredCurrency": "USD",
                "ServiceCode": "tst",
                "ParcelQty": 1,
                "SenderInfo": {
                    "Name": "Test LLC",
                    "SenderAddress": {
                        "Company": "Test LLC",
                        "CountryCode": "US"
                    }
                },
                "ReceiverInfo": {
                    "Name": "Сидоров Сидор Сидорович",
                    "MobilePhone": "+71111111111",
                    "Phone": "",
                    "Email": "info@spsr.tech",
                    "PersonalData": {
                        "FullName": "Сидоров Сидор Сидорович",
                        "IDDocType": "Паспорт",
                        "IDIssueDate": "2004-08-31",
                        "IDNumber": "1111 111111",
                        "IdentityCardGiven": "ОТДЕЛЕНИЕМ МИЛИЦИИ ГОРОДА Москвы",
                        "TaxNumber": "111111111130",
                        "BirthDate": ""
                    },
                    "ReceiverAddress": {
                        "Building": "",
                        "City": "Москва",
                        "Street": "Партийный проезд, д.1, кор. 11",
                        "District": "",
                        "Company": "",
                        "CountryCode": "RU",
                        "LockerID": "",
                        "PostCode": "",
                        "Region": ""
                    }
                },
                "Parcels": [
                    {
                        "Weight": 1560,
                        "ParcelNo": 1,
                        "RefBarCode": "SPSR04RU",
                        "Items": [
                            {
                                "Quantity": 1,
                                "UnitValue": 26.79,
                                "Description": "Детские джинсы, для девочки. Размер: 10 лет, Цвет: Голубой",
                                "DetailedDescription": "Детские джинсы, для девочки. Размер: 10 лет, Цвет: Голубой",
                                "URL": "https://www.amazon.com/gp/product/B07J5Q4KJN/ref=ppx_od_dt_b_asin_title_s00?ie=UTF8&psc=1",
                                "HTSCode": "",
                                "UnitWeight": 310,
                                "CountryOfOrigin": "US",
                                "CatalogTypes": {
                                    "CN": "Test1",
                                    "EN": "Test2",
                                    "RU": "Test3"
                                }
                            },
                            {
                                "Quantity": 1,
                                "UnitValue": 10.99,
                                "Description": "Защитное стекло для мобильного телефона iPhone 11 / iPhone XR. Упаковка из 2 шт.",
                                "DetailedDescription": "Защитное стекло для мобильного телефона iPhone 11 / iPhone XR. Упаковка из 2 шт.",
                                "URL": "https://www.amazon.com/gp/product/B07GX33WVR/ref=ppx_od_dt_b_asin_title_s00?ie=UTF8&psc=1",
                                "HTSCode": "",
                                "UnitWeight": 320,
                                "CountryOfOrigin": "US",
                                "CatalogTypes": {
                                    "CN": "Test1",
                                    "EN": "Test2",
                                    "RU": "Test3"
                                }
                            },
                            {
                                "Quantity": 1,
                                "UnitValue": 7.99,
                                "Description": "Защитное стекло для мобильного телефона iPhone 11 Pro / iPhone Xs / iPhone X. Упаковка из 2 шт.",
                                "DetailedDescription": "Защитное стекло для мобильного телефона iPhone 11 Pro / iPhone Xs / iPhone X. Упаковка из 2 шт.",
                                "URL": "https://www.amazon.com/gp/product/B07HRYZFN3/ref=ppx_od_dt_b_asin_title_s00?ie=UTF8&psc=1",
                                "HTSCode": "",
                                "UnitWeight": 330,
                                "CountryOfOrigin": "US",
                                "CatalogTypes": {
                                    "CN": "Test1",
                                    "EN": "Test2",
                                    "RU": "Test3"
                                }
                            },
                            {
                                "Quantity": 1,
                                "UnitValue": 90,
                                "Description": "Смарт часы Apple watch Series 1, 38 mm, Цвет: Серебристый, комплект ремешков, бывшие в употреблении. +пакетик фруктового мармелада +магнит на холодильник в подарок к заказу",
                                "DetailedDescription": "Смарт часы Apple watch Series 1, 38 mm, Цвет: Серебристый, комплект ремешков, бывшие в употреблении. +пакетик фруктового мармелада +магнит на холодильник в подарок к заказу",
                                "URL": "http://www.ebay.com/itm/293217815646",
                                "HTSCode": "",
                                "UnitWeight": 290,
                                "CountryOfOrigin": "US",
                                "CatalogTypes": {
                                    "CN": "Test1",
                                    "EN": "Test2",
                                    "RU": "Test3"
                                }
                            },
                            {
                                "Quantity": 1,
                                "UnitValue": 75,
                                "Description": "Смарт часы Apple watch Series 1, 44 mm, Цвет: Розовый, бывшие в употреблении",
                                "DetailedDescription": "Смарт часы Apple watch Series 1, 44 mm, Цвет: Розовый, бывшие в употреблении",
                                "URL": "https://www.ebay.com/itm/254342810565",
                                "HTSCode": "",
                                "UnitWeight": 310,
                                "CountryOfOrigin": "US",
                                "CatalogTypes": {
                                    "CN": "Test1",
                                    "EN": "Test2",
                                    "RU": "Test3"
                                }
                            }
                        ]
                    }
                ],
                "ContractNumber": "9900000000",
                "HWBWeight": 1560
            },
            {
                "OrderDate": "2022-11-11 11:11:11+03:00",
                "HWBRefNumber": "SPSR05RU",
                "DeclaredValue": 210.77,
                "DeclaredCurrency": "USD",
                "ServiceCode": "tst",
                "ParcelQty": 1,
                "SenderInfo": {
                    "Name": "Test LLC",
                    "SenderAddress": {
                        "Company": "Test LLC",
                        "CountryCode": "US"
                    }
                },
                "ReceiverInfo": {
                    "Name": "Васильев Василий Васильевич",
                    "MobilePhone": "",
                    "Phone": "",
                    "Email": "integrator@spsr.tech",
                    "PersonalData": {
                        "FullName": "Васильев Василий Васильевич",
                        "IDDocType": "Паспорт",
                        "IDIssueDate": "2004-08-31",
                        "IDNumber": "1111 111111",
                        "IdentityCardGiven": "ОТДЕЛЕНИЕМ МИЛИЦИИ ГОРОДА Москвы",
                        "TaxNumber": "000000000000",
                        "BirthDate": ""
                    },
                    "ReceiverAddress": {
                        "Building": "",
                        "City": "Москва",
                        "Street": "Партийный проезд, д.1, кор. 11",
                        "District": "",
                        "Company": "",
                        "CountryCode": "RU",
                        "LockerID": "",
                        "PostCode": "",
                        "Region": ""
                    }
                },
                "Parcels": [
                    {
                        "Weight": 1560,
                        "ParcelNo": 1,
                        "RefBarCode": "SPSR05RU",
                        "Items": [
                            {
                                "Quantity": 1,
                                "UnitValue": 26.79,
                                "Description": "Детские джинсы, для девочки. Размер: 10 лет, Цвет: Голубой",
                                "DetailedDescription": "Детские джинсы, для девочки. Размер: 10 лет, Цвет: Голубой",
                                "URL": "https://www.amazon.com/gp/product/B07J5Q4KJN/ref=ppx_od_dt_b_asin_title_s00?ie=UTF8&psc=1",
                                "HTSCode": "",
                                "UnitWeight": 310,
                                "CountryOfOrigin": "US",
                                "CatalogTypes": {
                                    "CN": "Test1",
                                    "EN": "Test2",
                                    "RU": "Test3"
                                }
                            },
                            {
                                "Quantity": 1,
                                "UnitValue": 10.99,
                                "Description": "Защитное стекло для мобильного телефона iPhone 11 / iPhone XR. Упаковка из 2 шт.",
                                "DetailedDescription": "Защитное стекло для мобильного телефона iPhone 11 / iPhone XR. Упаковка из 2 шт.",
                                "URL": "https://www.amazon.com/gp/product/B07GX33WVR/ref=ppx_od_dt_b_asin_title_s00?ie=UTF8&psc=1",
                                "HTSCode": "",
                                "UnitWeight": 320,
                                "CountryOfOrigin": "US",
                                "CatalogTypes": {
                                    "CN": "Test1",
                                    "EN": "Test2",
                                    "RU": "Test3"
                                }
                            },
                            {
                                "Quantity": 1,
                                "UnitValue": 7.99,
                                "Description": "Защитное стекло для мобильного телефона iPhone 11 Pro / iPhone Xs / iPhone X. Упаковка из 2 шт.",
                                "DetailedDescription": "Защитное стекло для мобильного телефона iPhone 11 Pro / iPhone Xs / iPhone X. Упаковка из 2 шт.",
                                "URL": "https://www.amazon.com/gp/product/B07HRYZFN3/ref=ppx_od_dt_b_asin_title_s00?ie=UTF8&psc=1",
                                "HTSCode": "",
                                "UnitWeight": 330,
                                "CountryOfOrigin": "US",
                                "CatalogTypes": {
                                    "CN": "Test1",
                                    "EN": "Test2",
                                    "RU": "Test3"
                                }
                            },
                            {
                                "Quantity": 1,
                                "UnitValue": 90,
                                "Description": "Смарт часы Apple watch Series 1, 38 mm, Цвет: Серебристый, комплект ремешков, бывшие в употреблении. +пакетик фруктового мармелада +магнит на холодильник в подарок к заказу",
                                "DetailedDescription": "Смарт часы Apple watch Series 1, 38 mm, Цвет: Серебристый, комплект ремешков, бывшие в употреблении. +пакетик фруктового мармелада +магнит на холодильник в подарок к заказу",
                                "URL": "http://www.ebay.com/itm/293217815646",
                                "HTSCode": "",
                                "UnitWeight": 290,
                                "CountryOfOrigin": "US",
                                "CatalogTypes": {
                                    "CN": "Test1",
                                    "EN": "Test2",
                                    "RU": "Test3"
                                }
                            },
                            {
                                "Quantity": 1,
                                "UnitValue": 75,
                                "Description": "Смарт часы Apple watch Series 1, 44 mm, Цвет: Розовый, бывшие в употреблении",
                                "DetailedDescription": "Смарт часы Apple watch Series 1, 44 mm, Цвет: Розовый, бывшие в употреблении",
                                "URL": "https://www.ebay.com/itm/254342810565",
                                "HTSCode": "",
                                "UnitWeight": 310,
                                "CountryOfOrigin": "US",
                                "CatalogTypes": {
                                    "CN": "Test1",
                                    "EN": "Test2",
                                    "RU": "Test3"
                                }
                            }
                        ]
                    }
                ],
                "ContractNumber": "9900000000",
                "HWBWeight": 1560
            }
        ]
    },
    "id": "019e416c-f9c9-4fd7-47bc-8c668d78"
}

WebAPI. Руководство по интеграции

Оглавление

Аннотация

Список изменений

Используемые термины и сокращения

Общее описание

Общее описание. Запрос к серверу

Общее описание. Ответ сервера

Пример вызова метода

Последовательность вызова запросов WebAPI

Авторизация. Запрос и получение токена. AUTH.Login

Информация о сессии. Метод AUTH.Info

Завершение сессии. Метод AUTH.Logout

API передачи информации по HWB и манифестам

Загрузка данных по HWB. Метод HWB.Validate

Загрузка данных по HWB. Метод HWB.Upload

Загрузка данных по HWB. Метод HWB.UpdateReceiverInfo

Загрузка данных по HWB. Метод HWB.UpdateReceiverID

Загрузка данных по HWB. Метод HWB.UpdateParcelInfo

Загрузка данных по HWB. Метод HWB.UpdateSKUInfo

Загрузка манифеста. Метод MNF.UploadNumbers

Загрузка манифеста. Метод MNF.UploadFull

Метод получения получения событий по HWB. Метод HWB.GetEvents

Метод для получения списка постаматов и пунктов выдачи. LOC.GetLockers

Печать этикеток. label

Получение веса и габаритов отправления в формате json. Метод HWB.GetWeight

Приложение 1. Список возможных событий с отправлением

Приложение 2. Список кодов ошибок

Приложение 3. Вид JSON HWB

Приложение 4. Использование геометок партнеров

5Post

Пример json с данными HWB