WebAPI. Integration guide

Annotation

The document contains a description of the API for customer’s integration.

Version 2.33

Version history

Version	Date	Description	Author
0.1	12.02.2018	Document created.	Petr Maishev
1.0	20.04.2018	First version.	Petr Maishev
1.1	21.05.2018	HWB.Validate added.	Petr Maishev
1.1	21.06.2018	Added methods for update HWB information.	Petr Maishev
2.0	16.07.2018	Methods names were standardized.	Petr Maishev
2.1	28.08.2018	New method LOC.GetLockers for receiving lockers list was added.	Petr Maishev
2.2	11.10.2018	It was gotten rid of the error in description HWB/Parcels/Items/UnitWeight. (It was kg instead of gram)	Petr Maishev
2.3	15.10.2018	It was gotten rid of http protocol.	Petr Maishev
2.4	15.11.2018	AUTH.Info was changed	Petr Maishev
2.5	15.01.2019	Expanded method LOC.GetLockers.1)Filter by region was added.2)Complex filters by list of parameters were added.	Petr Maishev
2.6	08.02.2019	Misprint with method name for receiving lockers was fixed. Method was named HWB.GetLockers instead of LOC.GetLockers	Petr Maishev
2.7	16.04.2019	MaxSize attribute was added for LOC.GetLockers method	Petr Maishev
2.8	17.04.2019	New event code (PCD) was added	Petr Maishev
2.9	01.05.2019	Params for test environment were added	Petr Maishev
2.10	08.05.2019	New event codes (IDOK, IDCE, RIC, RPR) were added	Petr Maishev
2.11	30.05.2019	New event code (PBA) was added	Petr Maishev
2.12	01.11.2019	New event codes (CR2, CR3, HBA41, HBA42, HBA43, HBA44, HBA45, HBA46) were added	Petr Maishev
2.13	06.11.2019	Last Mile information was added to HWB	Petr Maishev
2.14	09.01.2020	ContractNumber added to manifest methods.	Petr Maishev
2.15	15.04.2021	New event code (CSW, ASF4, DOCOK, NWC, OH, SIR) were added. Method LOC.GetLockers was updated.	Petr Maishev
2.16	08.02.2022	A few misprintings were corrected.	Petr Maishev
2.17	28.02.2022	Labeling description was added.	Petr Maishev
2.18	05.03.2022	Added new attribute ConsigmentNumber for manifests transfer	Petr Maishev
2.19	06.06.2022	Added new attribute RewriteAll in HWB.UpdateSKUInfo method	Petr Maishev
2.20	30.06.2022	Added new attributes Files to the structure JSON HWB, PersonalID section	Petr Maishev
2.21	11.07.2022	Added PostalCode to LOC.GetLockers	Petr Maishev
2.22	07.10.2022	Fixed field name for Manifest Weight	Petr Maishev
2.23	13.10.2022	Added new attributes Files to the structure for JSON HWB	Petr Maishev
2.24	04.10.2023	Added rule of use for all Update methods	Petr Maishev
2.25	05.10.2023	Removed unnecessary attributes from the HWB structure	Petr Maishev
2.26	17.10.2023	New event codes (ASF1, ASF2, ASF3, ASF5, CF1, CF3, CNP5, DS, NWCFG, NWCFM, NWCHM, OH, PIB, RPC, RPI, RSW, SPD, UT, WD, WFR) were added	Petr Maishev
2.27	22.11.2023	New API method was added - HWB.GetWeight	Petr Maishev
2.28	29.01.2024	New attribute for Items (HTSCodeExport) added	Petr Maishev
2.29	04.06.2024	New attribute for HWB (Incoterms) added	Petr Maishev
2.30	30.09.2024	New attribute for HWB (DeliveryValue) added	Petr Maishev
2.31	27.11.2024	Changed default value for Incoterms	Petr Maishev
2.32	29.11.2024	Added new attribute CatalogTypes to the structure JSON HWB, Items section	Маишев П.Ю.
2.33	24.12.2024	The API Guide structure has been updated. The list of terms and abbreviations has been updated. The list of events has been updated. Added a description to the Receiver Info.Receiver Address fields.:Street and Building. The WebAPI query sequence scheme has been updated. Added summary information on the functionality of the methods. Updated information on geometries. Recommended languages have been added to items.Description\Items.DetailedDescription in Appendix 3. Added description and schema to MNF.UploadNumbers and MNF.UploadFull. Added restrictions on the format and size of uploaded files.	Agupova Janna

Terms and abbreviations

Terms	Description
JSON	Java Script Object Notation. It is a format that uses human–readable text to transmit data consisting of attribute-value pairs.
HWB	Home waybill, a shipping document that identifies shipper and consignee, routing, description of goods, cost of shipment and weight of shipment.
MAWB	Master Air Waybill, The document is assigned by the airline and contains the addresses and names of agents of those countries where the cargo is sent and from where it is sent
COD	Cash on delivery. Payment is made on delivery rather than in advance.
Manifest	The document with the details of the HWBs loaded. Details like number, destination, origin and value of the products, etc. are contained in a manifest.
Token (JWT)	An access token contains the security credentials for a login session and identifies the user.
Request	Calling a specific method provided by WebAPI
WebAPI	The Parcel Engine 2.0 web service, with which it is possible to integrate for transmitting and receiving data on shipments
–>	Data sent to API.
<–	Data coming from API

Data Type	Data form	Example
Date	Date in the format YYYY-MM-DD	2024-05-21
DateTime	Date and time in the format YYYY-MM-DDTHH:mm or YYYY-MM-DDTHH:mm:ssTZ (“T” demarcates date and time parts)	2023-03-08T02:00:00 or 2024-05-21T14:13:27+02:00

Common description

For customers it is possible to integrate with the «Parcel Engine» information system, which allows to transmit the data about planned waybills and to collect the data about waybills status. For this, the web service Parcel Engine 2.0 (or WebAPI) is used.

WebAPI uses https protocols via POST or GET requests with data in JSON format. All the examples in this guide are for connection via the https protocol.

Server for WebAPI access:

Test server: apitest.spsr.tech.

WebURL for the test server requests: https://apitest.spsr.tech/

To test, you must use a test server WebURL and the following data for authorization:

UserName: test

Password: test

For the test uploading HWB and manifest you must use the following data:

ServiceCode: tst

ContractNumber: 9900000000

For testing, these credentials are the same for all clients.

After testing, to get the login, password, ServiceCode and ContractNumber for the production server, you need to contact with the personal support manager.

Common description. Server’s request

The transmitted data must be encoded UTF-8.

HTTP header must have “application/json” in the Content-Type parameter.

All transmitted data are simple objects serialized in JSON. Request is the call to a particular method provided by WebAPI. It must contain four required properties, according to JSONRPC 2.0 specification:

jsonrpc — always “2.0”.
method — String with method name.
params — Object array for method.
id — GUID, which is used to set the correspondence between the request and the response.thod

“params” contains all the necessary information for the called method, such as the contract number, the number of the shipment and other information necessary for the successful processing of the request.

You must send a request to a special address (via the http or https protocol).

Common description. Server’s response

WebAPI should send the correct answer to every request received. The response should contain the following properties:

jsonrpc — always “2.0”.
result — The data returned by the method when the request is executed correctly. If an error occurs during the execution of the method, this property will be set to null.
error – an object containing an error when the result of the request processing was erroneous. If the request was executed correctly, this property must be set to null.
id — The same value as in the request.

Object error:

code — Error code. The error codes are listed in the appendix 2.
message — Error text. Optional field
data — Optional field.

Before processing, the data was checked for mandatory parameters.

Example of a method request

As a result of a successful request, the server returns data in the result.token field.

Correct:

Direction	Request/response
–>	{“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”}

Incorrect:

Direction	Request/response
–>	{“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 requests sequence

Common requests schema:

General information on the functionality of the methods:

Function	Description	Method	Access
Authorization	The method for getting a token	AUTH.Login	Without access restrictions
Session Information	Method for getting information about current token user	AUTH.Info	Without access restrictions
End of the session	End of the session	AUTH.Logout	Without access restrictions
Data transmission on HWB	The method is designed to check the (optional) HWB before downloading	HWB.Validate	Without access restrictions
Data transmission on HWB	The method is designed to load HWB	HWB.Upload	Without access restrictions
Data transmission on HWB	The method to update information about the recipient	HWB.UpdateReceiverInfo	Limited access
Data transmission on HWB	The method to update information about the recipient’s passport data	HWB.UpdateReceiverID	Limited access
Data transmission on HWB	The method to update information about parcels	HWB.UpdateParcelInfo	Limited access
Data transmission on HWB	The method is designed to update information about the contents of the parcel	HWB.UpdateSKUInfo	Limited access
Data transmission on manifest	Transmission of the manifest	MNF.UploadNumbers	Without access restrictions
Data transmission on manifest	Transmission of the manifest	MNF.UploadFull	Without access restrictions
Getting information	Receiving events in json format	HWB.GetEvents	Without access restrictions
Getting information	Getting a list of postamates and pick-up points in json format	LOC.GetLockers	Without access restrictions
Getting information	Getting the weight and dimensions of the shipment in json format	HWB.GetWeight	Limited access
Labeling	Labeling	label printing method	Without access restrictions

Authorization. Token requesting and receiving. AUTH.Login

Method name: AUTH.Login

This method is designed to obtain a JWT for further requests.

Input parametrs:“username” – login, “password” – user password.

Example of the correct request:

Direction	Request/response
–>	{“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”}

server returned the data to the result.token parameter.

Example of the incorrect request:

Direction	Request/response
–>	{“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}

Example of a session request using 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/

The lifetime of the token is 60 minutes from the moment of receipt. When using functions that require authorization, the result of the work will depend on the rights of the owner of the token.

If the username or password is incorrect, the token will not be received, the method returns an error code -32003.

When you call methods that require authorization, the token is used in the Authorization header using the Bearer schema.

Authorization: Bearer

Session information. Method AUTH.Info

Method name: AUTH.Info

Function: Method returns the JSON with information about current token user. If token is invalid or expired the error is returned.

Require token authorization (see AUTH.Login).

Example of the request:

Direction	Request/response
–>	{“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”}

Session close. Method AUTH.Logout

Method name: AUTH.Logout

Function: Close the session.

Additional information: Method requires token authorization (see AUTH.Login).

Example of the correct request:

Direction	Request/response
–>	{“jsonrpc”:“2.0”, “method”: “AUTH.Logout”, “params”:{}, “id”: “c52f1b33-b0d9-41a6-ae54-57f0e4aef17b”}
<–	{“jsonrpc”:“2.0”, “result”: null, “id”: “c52f1b33-b0d9-41a6-ae54-57f0e4aef17b”}

The method revoke the token, and then this token can’t be used while calling functions with restricted access.

Api methods for transmission HWB and manifests information

Data can be transmitted by HWB or manifests. All data transfer methods are described below. All methods of uploading information require token authorization (see AUTH.Login).

Upload HWB information. Method HWB.Validate

Method name: HWB.Validate method.

Function: Method for HWBs data validation before uploading.

Additional information: Method requires token authorization (see AUTH.Login).

Example of the request:

Direction	Request/response
–>	{“jsonrpc”:“2.0”, “method”: “HWB.Validate”, “params”:{<Parameters>}, “id”: “c52f1b33-b0d9-41a6-ae54-57f0e4aef17b”}

*Parameters contains the following arguments:

Parameter	Description	Mandatory	Type
{
HWB:[]	List of HWBs. The JSON format for one HWB is described in appendix 3	Y	JSON
}

Upload HWB information. Method HWB.Upload

Method name: Method HWB.Upload.

Function: Method for HWBs uploading.

Additional information: Method requires token authorization (see AUTH.Login).

Example of the request:

Direction	Request/response
–>	{“jsonrpc”:“2.0”, “method”: “HWB.Upload”, “params”:{<Parameters>}, “id”: “c52f1b33-b0d9-41a6-ae54-57f0e4aef17b”}

*Parameters contains the following arguments:

Parameter	Description	Mandatory	Type
{
Synch	If “False” then asynchronous processing. Only the information (document id, md5 of the input JSON) JSON is returned. Further you can get the processing status by using the document id. If “True” then synchronous processing. All information (including the track number and its correspondence to the reference number) is returned at once. In the synchronous processing, there is a limit on the quantity of HWB - no more than 500.	Y	Bool
ContractNumber	Contract number.	Y	Char(20)
Author	Request auther.	N	Char(128)
TotalWeight	Total weight of HWBs, gram	Y	Int
TotalVolume	Total volume of HWBs, м3	Y	Float
TotalCOD	Total COD sum of HWBs, RUB	Y	Numeric(10,3)
HWBQty	Quantity of HWBs.	Y	Int
Sender	Sender.	N	Char(128)
Receiver	Receiver.	N	Char(128)
HWB:[]	List of HWBs. The JSON format for one HWB is described in appendix 3.	Y	JSON
}

Response to an asynchronous request:

Direction	Request/response
<–	{“jsonrpc”:“2.0”, “result”: { “DocId”:“5”, “md5”:” 8928d0a9e0f5d9fcd2a4b466707f0b11”}, “id”: " c52f1b33-b0d9-41a6-ae54-57f0e4aef17b"}

DocId - used for further requests processing state.

md5 - hash of the JSON “params”. The hash is calculated by the cleared JSON and used for avoid duplication of information.

Response to a synchronous request:

Direction	Request/response
<–	{“jsonrpc”:“2.0”, “result”: { “DocId”:“5”, “md5”:“8928d0a9e0f5d9fcd2a4b466707f0b11”, “HWB”:[{“HWBNumber”: “GBS000000000001”, “HWBRefNumber”: “XXXXXX” }, ….]}, “id”: “c52f1b33-b0d9-41a6-ae54-57f0e4aef17b”}

HWB array – used to transfer the correspondence between HWBRefNumber and HWBNumber.

In the waybills_json_upload method the following errors are possible:TBD (To be determined)

Upload HWB information. Method HWB.UpdateReceiverInfo

Method name: HWB.UpdateReceiverInfo.

Function: Method is used for updating information about receiver.

Additional information: Method requires token authorization (see AUTH.Login).

Important: To use this method, it is necessary to agreed it with the support manager.

Example of the request:

Direction	Request/response
–>	{“jsonrpc”:“2.0”, “method”: “HWB.UpdateReceiverInfo”, “params”:{<Parameters>}, “id”: “c52f1b33-b0d9-41a6-ae54-57f0e4aef17b”}

Parameters contains the following arguments:

Parameter	Description	Mandatory	Type
{
HWB:[]	List of HWBs. The JSON format for one HWB is described in appendix 3. This method uses ReceiverInfo section.	Y	JSON
}

Upload HWB information. Method HWB.UpdateReceiverID

Method name: WB.UpdateReceiverID.

Function: The method is used for updating information about receiver ID.

Additional information: Method requires token authorization (see AUTH.Login).

Important: To use this method, it is necessary to agreed it with the support manager.

Example of the request:

Direction	Request/response
–>	{“jsonrpc”:“2.0”, “method”: “HWB.UpdateReceiverID”, “params”:{<Parameters>}, “id”: “c52f1b33-b0d9-41a6-ae54-57f0e4aef17b”}

Parameters contains the following arguments:

Parameter	Description	Mandatory	Type
{
HWB:[]	List of HWBs. The JSON format for one HWB is described in appendix 3. This method uses ReceiverInfo/PersonalData section.	Y	JSON
}

Upload HWB information. Method HWB.UpdateParcelInfo

Method name: HWB.UpdateParcelInfo.

Function: The method is used for updating information about parcels.

Additional information: Method requires token authorization (see AUTH.Login).

Important: To use this method, it is necessary to agreed it with the support manager.

Example of the request:

Direction	Request/response
–>	{“jsonrpc”:“2.0”, “method”: “HWB.UpdateParcelInfo”, “params”:{<Parameters>}, “id”: “c52f1b33-b0d9-41a6-ae54-57f0e4aef17b”}

Parameters contains the following arguments:

Parameter	Description	Mandatory	Type
{
HWB:[]	List of HWBs. The JSON format for one HWB is described in appendix 3. This method uses Parcels section.	Y	JSON
}

Upload HWB information. Method HWB.UpdateSKUInfo

Method name: HWB.UpdateSKUInfo.

Function: The method is used for updating information about SKU in the parcel.

Additional information: Method requires token authorization (see AUTH.Login).

Important: To use this method, it is necessary to agreed it with the support manager.

Example of the request:

Direction	Request/response
–>	{“jsonrpc”:“2.0”, “method”: “HWB.UpdateSKUInfo”, “params”:{<Parameters>}, “id”: “c52f1b33-b0d9-41a6-ae54-57f0e4aef17b”}

Parameters contains the following arguments:

Parameter	Description	Mandatory	Type
{
RewriteAll	Delete all goods and create new if flag is true. If the flag is false then goods are updatetd according to Description field. Default - false	N	Bool
HWB:[]	List of HWBs. The JSON format for one HWB is described in appendix 3. This method uses Parcels/Items section.	Y	JSON
}

Manifest upload. Method MNF.UploadNumbers

Method name: MNF.UploadNumbers,the method of sequentially transmission the HWB and manifest. This method is preferred

Function: The method allows to combine HWBs previously uploaded to the WebAPI into one manifest.

Additional information: Method requires token authorization (see AUTH.Login).

Method description: After HWBs (one or more) is created in the client’s system, HWBs are transmitted using the HWB.Upload method to the WebAPI. Next, the manifest created by the client will uploaded to the Web Api.using the MNF.Upload Numbers method.

Method scheme:

Important: All HWBs must be uploaded before this request.

Example of the request:

Direction	Request/response
–>	{“jsonrpc”:“2.0”, “method”: “”, “params”:{<Parameters>}, “id”: “c52f1b33-b0d9-41a6-ae54-57f0e4aef17b”}

Parameters for method MNF.UploadNumbers contains the following arguments:

Parameter		Description	Mandatory	Type
{
ManifestDate		Manifest date.	Y	DateTime
ManifestNumber		Manifest number. For MAWB – MAWB number.	Y	Char(128)
HaulNumber		Haul number. For MAWB – Flight Number.	N	Char(50)
ContractNumber		Contract number.	Y	Char(20)
Author		Request auther.	N	Char(128)
ManifestWeight		Total weight of HWBs, gram	Y	Int
ManifestVolume		Total volume of HWBs, м3	Y	Float
HWBQty		Quantity of HWBs.	Y	Int
Sender		Sender	N	Char(128)
Receiver		Receiver	N	Char(128)
HWB:[		List of HWB numbers included in the manifest. One of the HWBNumber or HWBRefNumber parameters is mandatory.	Y	JSON
	{		Y
	HWBNumber	HWB number	Y*	Char(20)
	HWBRefNumber	HWB reference number	Y*	Char(50)
	ConsigmentNumber	Consigment number	N	Char(128)
	}, …
]
}

*All HWBs must be uploaded before this request.

Manifest upload. Method MNF.UploadFull

Method name: MNF.UploadNumbers.

Function: The method allows to transmit manifest, which contain HWBs, to WebApi.

Additional information: Method requires token authorization (see AUTH.Login).

Method description: After HWBs (one or more) is created in the client’s system, HWBs are Not transmitted to the WebAPI. Transmission to the WebApi takes place using the MNF.Upload Full method after creating a manifest with HWBs in the client’s system.

Method scheme:

Parameters for method MNF.UploadFull contains the following arguments:

Parameter	Description	Mandatory	Type
{
Synch	If “False” then asynchronous processing. Only the information (document id, md5 of the input JSON) JSON is returned. Further you can get the processing status by using the document id.If “True” then synchronous processing. All information (including the track number and its correspondence to the reference number) is returned at once. In the synchronous processing, there is a limit on the quantity of HWB - no more than 500.
Y	Bool
ManifestDate		Manifest date.	Y
ManifestNumber		Manifest number. For MAWB – MAWB number.	Y
HaulNumber		Haul number. For MAWB – Flight Number.	N
ContractNumber		Contract number.	Y
Author		Request auther.	N
ManifestWeight		Total weight of HWBs, gram	Y
ManifestVolume		Total volume of HWBs, м3	Y
Sender		Sender	N
Receiver		Receiver	N
TotalCOD	Total COD sum of HWBs in the manifest, RUB	Y	Numeric(10,3)
HWBQty	Quantity of HWBs.	Y	Int
HWB:[]	List of HWBs in the manifest. The JSON format for one HWB is described in appendix 3.	Y	JSON
}

Synchronous and asynchronous processing for method MNF.UploadFull occurs in the same way as HWB.Upload method.

Methods for receiving events by HWBs. Method HWB.GetEvents

Method name: HWB.GetEvents.

Additional information: Method requires token authorization (see AUTH.Login).

Example of the request:

Direction	Request/response
–>	{“jsonrpc”:“2.0”, “method”: “HWB.GetEvents”, “params”:{<Parameters>}, “id”: “c52f1b33-b0d9-41a6-ae54-57f0e4aef17b”}

Parameters contains the following arguments:

Parameter			Description	Mandatory	Type
{
ContractNumber			Contract Number for HWBs which events are requested. If empty, then the request occurs for all Contract Numbers, accessible to the owner of the login.	N	Char(12)
Filters:{				Y
	UseDates		Use or don’t use dates filter. If “True” - then the time interval is taken from the parameters StartDate and EndDate. If “False”, then the events received from the last request with the parameter “False”.	Y	Bool
	StartDate		Minimum date/time for events.	N	DateTime
	EndDate		Maximum date/time for events.	N	DateTime
	HWB:[		List of HWBs for which events are requested. If filled, then the UseDates and * Date parameters are ignored. One of the HWBNumber or HWBRefNumber parameters must be filled.	N	JSON
		{
		HWBNumber	HWB number	Y	Char(20)
		HWBRefNumber	HWB reference number	Y	Char(50)
		}, …
	]
}
TextLang			Language for events description (ru ru en). Default value ru	N	Char(3)
TZ			Output datetime format with time zones.	N	Bool
}

Direction	Request/response
<–	{“jsonrpc”:“2.0”, “result”: { [<список событий>]}, “id”: “c52f1b33-b0d9-41a6-ae54-57f0e4aef17b”}

Format of the events list:

Parameter	Description	Type
[
HWBNumber	HWB number	Char(20)
HWBRefNumber	HWB reference number	Char(50)
EventCode	Event code check in appendix 1	Char(8)
EventComment	Event comment.	Char(128)
EventText	Event text.	Char(512)
EventPlace	Event place.	Char(128)
Partner	Contractor processed HWB.	Char(128)
EventTime	Event date/time.	DateTime
]

Method for receiving lockers or pickup points list. Method LOC.GetLockers

Method name: LOC.GetLockers

Additional information: Method requires token authorization (see AUTH.Login).

Example of the request:

Direction	Request/response
–>	{“jsonrpc”:“2.0”, “method”: “LOC.GetLockers”, “params”:{<Parameters>}, “id”: “c52f1b33-b0d9-41a6-ae54-57f0e4aef17b”}

Parameters contains the following arguments:

Parameter		Description	Mandatory	Type
{
Filters:{			N
	City	City	N	Char() List
	CountryCode	Country code. Alpha ISO3166	N	Char() List
	LockerContractorICN	Contract number of the contractor of the locker or the pickup point.	N	Char() List
	LockerNumber	Locker or delivery point number	N	Char() List
	LockerOwner	The owner of the locker or the pickup point.	N	Char() List
	LockerType	Locker or pickup point	N	Char() List
	MaxBoxSize	Maximum parcel size	N	Char() List
	RegionCode	Region code	N	Char() List
	Status	Locker or pickup point status (New, Open, Closed)	N	Char() List
}
}

Parameters can be either a single string or a list of strings in square brackets. Example of the request JSON, below:

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

Response:

Direction	Request/response
<–	{“jsonrpc”:“2.0”, “result”: [<список постаматов>], “id”: “c52f1b33-b0d9-41a6-ae54-57f0e4aef17b”}

Format of the lockers and delivery points list:

Parameter		Description	Mandatory	Type
{
	LockerNumber	Locker or delivery point number.	N	Char()
	Adress	Address	N	Char()
	PostalCode	Postal code	N	Char()
	City	City	N	Char()
	Country	Country	N	Char()
	CountryCode	Country code	N	Char()
	Region	Region	N	Char()
	RegionCode	Region code	N	Char()
	LockerContractor	Contractor of the locker or the pickup point.	N	Char()
	LockerContractorICN	Contract number of the contractor of the locker or the pickup point.	N	Char()
	LockerOwner	The owner of the locker or the pickup point.	N	Char()
	LockerType	Locker or pickup point	N	Char()
	Latitude	Latitude	N	Char()
	Longitude	Longitude	N	Char()
	MaxBoxSize	Maximum parcel size	N	Char()
	MaxSize	Maximum parcel size	N	Char()
	Payments	Is COD available	N	Char()
	Schedule:	Working hours	N	Char()
	[
	{
	CloseAt	Close At	N	Char()
	Day	Week day (1- Monday, 7- Sunday)	N	Char()
	OpenAt	Open At	N	Char()
	}, …
	]
	Status	Locker or pickup point status (New, Open, Closed)	N	Char()
}

When using this API to display postamates and pick-up points on the map, it is necessary to follow Appendix 4 in the style of displaying partner geometries in accordance with the partner’s LockerContractorICN.

Labeling

Function: Getting labels for print.

Additional information: Method requires token authorization (see AUTH.Login).

To receive the labels the GET request with following parameters is used:

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

<base URL> - base API URL (production or test)
<HWB Ref Number> - HWBRefNumber of previously uploaded HWB.

Receiving weights and dimensions. Method HWB.GetWeight

Method name: HWB.GetWeight.

Function: Receiving weights and dimensions.

Additional information: Method requires token authorization (see AUTH.Login).

Important: To use this method, it is necessary to agree with the manager an access to this method

Example of the request:

Direction	Request/response
–>	{“jsonrpc”:“2.0”, “method”: “HWB.GetWeight”, “params”:{“HWB”: [{“HWBRefNumber”: “refnumber1”}, {“HWBRefNumber”: “refnumber2”}]}, “id”: “c52f1b33-b0d9-41a6-ae54-57f0e4aef17b”}

Parameters contains list ot objects with HWBRefNumber, from which you need to get the weight and dimensions. The array element looks like: {"HWBRefNumber": "refnumber"}

Direction	Request/response
<–	{“jsonrpc”:“2.0”, “result”: {“HWB”: []}, “id”: “c52f1b33-b0d9-41a6-ae54-57f0e4aef17b”}

Format of each waybill in the list with dimentions and weights:

Parameter			Description	Mandatory	Type
{
	HWBRefNumber		HWB reference number	Y	Char()
	HWBNumber		HWB number	Y	Char()
	Parcels: [			Y	Object() List
		{
		RefBarCode	Parcel reference barcode	Y	Char(50)
		Weight	Weight, gramm	Y	Int
		Width	Width, mm	Y	Int
		Depth	Depth, mm	Y	Int
		Length	Length, mm	Y	Int
		}, …
	]
}

Appendix 1. Event type list

Event place	Code	Description ENG
IN	NW	Waybill’s information accepted.
FM	WA	Accepted in stock of first mile
FM	CSW	Sended to the 1st mile warehouse
FM	WD	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	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.

Appendix 2. Error code list

Code	Message	Description
32700	Parse error.	Invalid JSON was received by the server.An error occurred on the server while parsing the JSON text.
32600	Invalid request.	The JSON sent is not a valid Request object.
32601	Method not found.	The method does not exist / is not available.
32602	Invalid params.	Invalid method parameter(s).
32603	Internal error.	Internal JSON-RPC error.
32001	Token expired.	Expired token in the request.
32002	Invalid token.	Invalid token in the request.
32003	Invalid login/password	AUTH.Login: Invalid login/password.

Appendix 3. Structure for JSON HWB

JSON structure

Parameter				Description	M	Type
{
HWBRefNumber				HWB reference number	Y	Char(50)
OrderDate				Order/HWB creation date and time	N	DateTime
ConsigmentNumber				Consigment number (only for method MNF.UploadFull)	N	Char(128)
DeliveryComments				Comments for delivery reason	N	Char(512)
ContractNumber				HWB’s contract number	Y	Char(12)
CODIndicator				Yes(1)/No(0) COD	N	Int
ChargeableSum				COD in the receiver country currency. For Russia always RUB.	N	Numeric(10,3)
ServiceCode				Main service code	Y	Char(8)
ParcelQty				Parcels quantity in the HWB	Y	Int
HWBWeight				Weight of the HWB, gram	Y	Int
GoodsCurrency				Goods currency of the HWB. ISO4217 code	Y	Char(3)
DeliveryValue				Delivery value of the HWB. Currency id equal GoodsCurrencyIf the delivery is free, please put 0	Y	Numeric(10,3)
DeclaredValue				Declared value of the HWB	Y	Numeric(10,3)
DeclaredCurrency				Declared value currency. ISO4217 code	Y	Char(3)
LastMileInfo: {				Information about last mile agent.	N	JSON
	Contractor			Name last mile agent	Y	Char(128)
	ContractorICN			Name last mile agent contract number	Y	Char(12)
}
Incoterms				Incoterms - EXW, FCA, FAS, FOB, CFR, CIF, CPT, CIP, DAP, DPU, DDP. Default DAP	N	Char(3)
AdditionalServices:[				Additional services	N	List
	ServiceCode			Additional service code	Y	Char(8)
]
HWBExtras:[				Additional parameters: [{ExtraKey:key, ExtraValue:value},…]	N	List
	ExtraKey				Y	Char(64)
	ExtraValue				Y	Char(128)
]
Files :[				Documents.Max.size: 5MbFormat:pdf or any image format	N	List
	{
		Data		Standard Base64 with scans	Y	Char
		FileName		File name	Y	Char(512)
		Metadata :{		File metadata	Y	JSON
			Description	File description	Y	Char(512)
			Source	Must be “External”	Y	Char
		}
	}
]
SenderInfo: {				Information about sender	Y	JSON
	Name			Name of the sender	Y	Char(128)
	Phone			Phone number	N	Char(20)
	MobilePhone			Mobile phone	N	Char(20)
	Email			Email	N	Char(50)
	AddressRB			Reference book for address code (KLADR, FIAS for Russia)	N	Char(8)
	AddressCode			Address code	N	Char(20)
	ExtraContact: [			Additional contacts. Messengers, social networks, etc.	N	List
		{
		ContactType		Contact type	Y	Char(32)
		ContactNumber		Contact number	Y	Char(128)
		}, …
	]
	SenderAddress : {			Sender address	Y	JSON
		CountryCode		Country code ISO3166 alpha2	Y	Char(2)
		RegionCode		Region code ISO3166-2	N	Char(8)
		City		City	Y	Char(100)
		PostCode		Postal code	N	Char(16)
		District		District	N	Char(100)
		Street		Street	Y	Char(256)
		Building		Building number	Y	Char(20)
		Company		Company	N	Char(128)
		Latitude		Latitude	N	Float
		Longitude		Longtitude	N	Float
		LockerID		ID for lockers or pickup point	N	Char(16)
	}
}
ReceiverInfo: {				Information about consignee	Y	JSON
	Name			Name of the receiver	Y	Char(128)
	Phone			Phone number	N	Char(20)
	MobilePhone			Mobile phone	Y	Char(20)
	Email			Email	N	Char(50)
	AddressRB			Reference book for address code (KLADR, FIAS for Russia)	N	Char(5)
	AddressCode			Address code	N	Char(20)
	ReceiverCode			Receiver code	N	Char(20)
	ExtraContact: [			Additional contacts. Messengers, social networks, etc.	N	List
		{
		ContactType		Contact type	Y	Char(32)
		ContactNumber		Contact number	Y	Char(128)
		}, …
	]
	ReceiverAddress : {			Receiver address	Y	JSON
		CountryCode		Country code ISO3166 alpha2	Y	Char(2)
		RegionCode		Region code ISO3166-2	N	Char(8)
		City		City	Y	Char(100)
		PostCode		Postal code	N	Char(16)
		District		District	N	Char(100)
		Street		StreetStreetThe full address: street, house, building (if any),apartment (if door delivery is required).If there is no street, it can be skipped, the rest of the aders data is filled in according to the order.Either the Building or Street field is filled	Y	Char(256)
		Building		Building numberIf there is no street, it can be skipped, the rest of the address data is filled in according to the order (house, building (if any), apartment).Either the Building or Street field is filled	Y	Char(20)
		Company		Company	N	Char(128)
		Latitude		Latitude	N	Float
		Longitude		Longtitude	N	Float
		LockerID		ID for lockers or pickup point	N	Char(16)
	}
	PersonalData : {			Personal data for customs reason	N	JSON
		IDNumber		Document number	Y	Char(16)
		IDDocType		Document type	Y	Char(50)
		IDIssueDate		Issue date	Y	Date
		FullName		Full name (same as in the document)	Y	Char(128)
		IdentityCardGiven		Authority issued the document	Y	Char(512)
		TaxNumber		Tax number	Y	Char(16)
		BirthDate		Birth date	N	Date
		Gender		Gender	N	Char(1)
		Files :[		Documents scans.Max.size: 5MbFormat:pdf or any image format	N	List
			{
			Data	Standard Base64 with scans	Y	Char
			FileName	File Name	Y	Char(512)
			Metadata :{	File metadata	Y	JSON
			Picid	1 for ID, 2 for other scans	Y	Char
			Doctype	21 Russian passport, 10 Foreign passports	Y	Char
			Source	Always “External”	Y	Char
			}
			}
}
Parcels: {				Parcels in the HWB	Y	List
	}
	{
	BarCode			Barcode of the parcel	N	Char(20)
	RefBarCode			Reference barcode of the parcel	Y	Char(64)
	Weight			Parcel weight, gram	Y	Int
	ParcelNo			Sequence number	N	Int
	Width			Width, mm	N	Int
	Depth			Depth, mm	N	Int
	Length			Length, mm	N	Int
	Description			Parcel description	Y	Char(512)
	ParcelExtras:[			Additional parameters	N	JSON
	Items:{			Goods in the parcel	N	List
		}
		{
		Description		Goods description	Y	Char(128)
		UnitValue		Value of the unit	Y	Numeric(10,3)
		CountryOfOrigin		Country of origin. ISO 3166 alpha2	Y	Char(2)
		UnitWeight		Weight of the unit, gram	Y	Int
		Quantity		Quantity of the goods	Y	Int
		DetailedDescription		Detiled description of the goods	N	Char(1024)
		ConstructionComposition		Construction composition	N	Char(1024)
		URL		Goods URL in the Internet shop	Y	Char(1024)
		HTSCode		HTS codes	N	Char(32)
		HTSCodeExport		HTS code export	N	Char(32)
		VATRate		VAT Rate	N	Int
		SKUBarcode		SKU barcode	N	Char(50)
		CatalogTypes:{		Item catalog in the different language.	N	JSON
			CN	Chinese	N	Key value
			EN	English	N	Key value
			RU	Russian	N	Key value
		}		Example: “CatalogTypes”: {“CN”:“Cat1”, “EN”: “Cat2”, “RU”: “Кат3”}
		ItemExtras:{		Additional parameters	N	JSON
		}
		}, …
	]
}, …
]
}

Click to see json HWB example

Appendix 4. Partner geotagging

5Post

The location of all “5post” pick-up points (lockers and points at the checkout) should t be marked with a proprietary geolocation icon (see the table below).

Table. The geometries of the 5Post partner

Description of the geotag	Geotag
All 5post lockers should be marked with a drop-shaped geolocation icon in the company’s gray color
All 5post points at the checkout in the Pyaterochka store should be marked with a drop-shaped geolocation icon in white with a gray outline
All 5post pick-up points should be marked with a drop-shaped geolocation icon in green with a gray outline

If the variant of the “drop” shape contradicts the general style of the map, you can use round geolocation icons: in gray color for lockers, in white with a gray outline for 5Post parcel pick-up points at the checkout in the Pyaterochka store, in green with a gray outline for all 5post pick-up points Examples are provided below:

HWB.JSON Upload example

{
    "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": "JVBERi0xLjQKJcOkw7zDtsOfCjIgMCBvYmoKPDwvTGVuZ3RoIDMgMCBSL0ZpbHRlci9GbGF0ZURlY29kZT4+CnN0cmVhbQp4nD2OywoCMQxF9/mKu3YRk7bptDAIDuh+oOAP+AAXgrOZ37etjmSTe3ISIljpDYGwwrKxRwrKGcsNlx1e31mt5UFTIYucMFiqcrlif1ZobP0do6g48eIPKE+ydk6aM0roJG/RegwcNhDr5tChd+z+miTJnWqoT/3oUabOToVmmvEBy5IoCgplbmRzdHJlYW0KZW5kb2JqCgozIDAgb2JqCjEzNAplbmRvYmoKCjUgMCBvYmoKPDwvTGVuZ3RoIDYgMCBSL0ZpbHRlci9GbGF0ZURlY29kZS9MZW5ndGgxIDIzMTY0Pj4Kc3RyZWFtCnic7Xx5fFvVlf+59z0tdrzIu7xFz1G8Kl7i2HEWE8vxQlI3iRM71A6ksSwrsYptKZYUE9omYStgloZhaSlMMbTsbSPLAZwEGgNlusxQ0mHa0k4Z8muhlJb8ynQoZVpi/b736nkjgWlnfn/8Pp9fpNx3zz33bPecc899T4oVHA55KIEOkUJO96DLvyQxM5WI/omIpbr3BbU/3J61FPBpItOa3f49g1948t/vI4rLIzL8dM/A/t3vn77ZSpT0LlH8e/0eV98jn3k0mSj7bchY2Q/EpdNXm4hyIIOW9g8Gr+gyrq3EeAPGVQM+t+uw5VrQ51yBcc6g6wr/DywvGAHegbE25Br0bFR/ezPGR4kq6/y+QPCnVBYl2ijka/5hjz95S8kmok8kEFl8wDG8xQtjZhRjrqgGo8kcF7+I/r98GY5TnmwPU55aRIhb9PWZNu2Nvi7mRM9/C2flx5r+itA36KeshGk0wf5MWfQ+y2bLaSOp9CdkyxE6S3dSOnXSXSyVllImbaeNTAWNg25m90T3Rd+ii+jv6IHoU+zq6GOY/yL9A70PC/5NZVRHm0G/nTz0lvIGdUe/Qma6nhbRWtrGMslFP8H7j7DhdrqDvs0+F30fWtPpasirp0ZqjD4b/YDK6Gb1sOGVuCfoNjrBjFF31EuLaQmNckf0J9HXqIi66Wv0DdjkYFPqBiqgy+k6+jLLVv4B0J30dZpmCXyn0mQ4CU0b6RIaohEapcfoByyVtRteMbwT/Wz0TTJSGpXAJi+9xWrZJv6gmhBdF/05XUrH6HtYr3hPqZeqDxsunW6I/n30Ocqgp1g8e5o9a6g23Hr2quj90W8hI4toOTyyGXp66Rp6lr5P/05/4AejB2kDdUDzCyyfaawIHv8Jz+YH+AHlZarAanfC2hDdR2FE5DidoGfgm3+l0/QGS2e57BOsl93G/sATeB9/SblHOar8i8rUR+FvOxXCR0F6kJ7Efn6RXmIGyK9i7ewzzMe+xP6eneZh/jb/k2pWr1H/op41FE2fnv5LdHP0j2SlHPokXUkH4duv0QQdpR/Sj+kP9B/0HrOwVayf3c/C7DR7m8fxJXwL9/O7+IP8m8pm5TblWbVWXa9err6o/tzwBcNNJpdp+oOHpm+f/ub0j6JPRX+E3EmC/CJqhUevQlY8SCfpZUj/Gb1KvxT5A/lr2Q72aWgJsBvYHeyb7AX2I/ZbrJLkewlfy5uh1ceH4aer+e38Dmh/Ce9T/Of8Vf47/kfFoCxRVip7lfuVsDKpnFJ+rVrUIrVCXa5uUXeoUUSm2nCxocPwiOFxw3OGd4z1xj6j3/gb09Wma83/dLbs7L9N03T/dHh6ArlrRiZdCU98lR5A3h9FDH4Aj/4QFp+mdxGFHFbAimH3atbK2tgm9il2GfOwq9n17O/Yl9k97AH2LawAa+Am2O7gjbyDu7iHX8uv57fwo3gf59/nP+Gv8DOwPEuxKw5lubJR2aFcqgxhDUHlgHItPHub8pjykvKy8qbyG+UMopalLlZD6pXq3erD6lH1R4ZPGgbxfsBw0jBl+JHhA8MHRm7MMeYZK42fMT5i/KXJaFppajfdaPoX03+Y/SyPlcFybX614NnYg4v5YzxdPcjOAJHPVErGyh2IQwd2xX9QgzKNuCSJediWwbPVNMFpdKph8AfZCaplL9BBI1dQidXTFGG/4KfV5/lF9GPWw7LVh5Uhww94AT2OanSYP81PsPV0lNfzS/i9CrE32CP0BvL9CrqDXc4C9Dg7w9awz7M6dpD+hWcqHexaqo8+wFUWxzaydwgW0FVqH33646sgW02/oLemv6omqp9DfZqkuxDRb9Br7FH6MzNE30Z1U1CNXKgyNyPfryNR9XZinx3EfsxGBRkwvkRHxYliqjOuU6+kd+g/6S3DcWTUelTSN6e96lfVX0XrouXYYdhl9Aj2XT9djB3zBrLkGYzF6DLs9HjUkmrs6nbaQX30eVS926Lh6L3Ra6L7oz76R/D+mS1jf2Zj2BGT4Kin7+H9RfoZuwn78OL/3ikw3UdT9FtmZYWsGvvhjGGf4bDhMcNRw7cNLxqXw9vX0j3I6F8im+OxAjf9iH5Lf2JmxCabllEN7F0F27togHcrz1ATyyE/9mwJ6vh6fSUBSLka3rsX+/kZ7I13UCcuo2/TK4yzLKzIDf1myGmDn3eB+iFE8Bo2AUwfqnYZ/Q7rTmKreBD6nJB0F6rWFGz6Bf0a3o5Ku5ahLjSzSyDrT/Qp6oOGldTOxhGBJ2k1Kmuz8k/w91JmofVsCfs6+HqwQ5Mon1YbfsU4LZveHF3FvcozOGOiwI/h9Mqli9heWJGMdZylDLaFaqe3wYaXiZyNnc6GdRfVr12zelVdbc2K6uVVlRXlyxxlpSXFRYVL7UsKNNvi/LzcnGxrVmZGelpqiiU5KTFhUXyc2WQ0qApntKzF3tqjhYt6wmqRfcOGcjG2u4BwzUP0hDWgWhfShLUeSaYtpHSCcveHKJ0xSucsJbNo9VRfvkxrsWvhF5vt2iTbsbUL8C3N9m4tfEbCmyR8WMKJgAsKwKC1WPubtTDr0VrCrfv6R1t6miFufFF8k73JE1++jMbjFwFcBCicZfePs6x1TAI8q2XNOCdzIowK59ibW8LZ9mZhQVgpbHH1hdu3drU05xYUdJcvC7Mmt703TPb14WSHJKEmqSZsbAqbpBrNK1ZDN2njy6ZGb560UG+PI6HP3ue6rCusuLqFjhQH9DaHs6583To3hPDUpq7r58/mKqMtVq8mhqOj12vhqa1d82cLxLW7GzLAywtbe0ZbofpmOLGtQ4M2fl13V5hdB5WaWIlYVWx9HnuLwPR8RgvH2dfb+0c/04PQ5IyGadv+gkhOjvNY9DTltGijnV32gnBDrr3b1Zw3nk6j2/ZPZDu17IUz5cvGLSkxx44nJetAQuJ8wDM7JyFJLqC2bbOeZcIi+0YkRFhza7Cky441rRIXzyoada8CGV7dDFzhPkTEG45r6hm1rBF4wR82FFrs2ugfCRlgP/P2QoxLxxgLLX8kAYo8mU01zM/AYYcjXFYmUsTUhJjCxnVyXFu+bN8kX2n3WzR0cB+1w7eu7jWVcH9BgQjwTZNO6sUgfGhrV2ysUW9uhJyVju4w7xEzUzMzGdvFzKGZmVn2Hjsy+ah8EMgIm4tm/yVbMtNa+teEWebHTHti820d9ratO7q0ltEe3bdtnQtGsflVs3M6FE5r6lJyuQ7xXEXOIikvmyUWg66EsFqIf0aZ1H1hBUkpEUxrDVt6NsSu3fEFBR/JM2kyz2OajL4juGQ3x6ZbGV7jWDheu2C8wLqEUQX2qkW8rXPH6Gj8grlWFKDR0Va71jraM+qajB7qtWsW++gx/jB/eNTf0jMT0Mno8Ztyw603d2MR/WwNkpXT+nE7u2HruJPd0LGj65gFT283dHZFOONNPeu7x5dirusYbkWcEstnsWKkiRG1MSR6hJvlVO4xJ9EhOatKhBy7JxlJnHkGx8g9yWM4i8ThVY7bFBF8A9449U20/ihn00bTJG9wppFBnVYo3qROM8o2Gw3TXHmaFVEcbnatZHVY3qs/W7/Z8m79prP11ADY8gEuy6sKUgpSCnFhuIH4QFOmPnAa6C+kqVPQhScYMrjwnGUhGx10rigxlMRfnOVRPQmGsqzVWRsyuzP7Mw2rs1bmXp97t+GuRQZbSiEjnpZamGwxZxcfMTHTZHRqIm5RDUy82Zl2qIBpBVUFvCAlVSPNUmXhlkl+04S2vMPqgGk7hW2bLDv3vufYu+mMNLJB2kg797KdaQXVWZmZqRnpuBfE217AUlZU163jtTVFRcVF9jt4/lM9V032lNft3nRN79fPvsxKXv1c3YZd9fUDHeueMBzPK3pu+s0fPnHNmLutzKY+90FtUuolLzz22JO7U5PEs/ct0d+oHbivy6R7nVmfStmTcpdBiTNmG+t5fUobb0t5k5uSJ3nQmaIuyqT4jPT0+DhjWnpRRgZNslJnUqZTW1pzJJNFM1lmjhWLdmYuWVpz2Dpm5X7rO1b+eyuzxi8qijOLqWTQjpnZO2Zmzs5qqJdr3zvsEKvfjNUPO95D23Sm3iIjVW+BFxrOCC+wnQW1RqN9SVFRLaKWnpm5onrlSgEqm9c84738sU+ybNu2hg3DZSz7vu29n37sLj42bT3tWbsl9Dqb+svPxToP4H73y+o6KmZrj1EpjNmZEt9gMBoTMoyZCTVKjbnGWmNv5i3mFmuzPUFTKks74npKD5XeV/p148OmhxKeMD6REC49VXq6NIlKK0vbMXGy9LVSY6kzJ6+mAeNDctJgKlBNOfmZcFkk3lQgPLdYNVlSUopz8/KKiuMZGZMtRakpzh21PSnMl8JSJnmrMzkntyg/DzhfHuvJY3nAHS1EdBl8HCEqFsmUHNcgeudK2F0M0mJnI1o92tLimmLnmotqKotfKn6tWEkuthUfKlaoWCuuKo4Wq8XZJb+K+Vq4OPZCtp2Bl9/budeBRHtv707RwefS6+LdcKbhDEtJXU1oy6vYsGPvToTBkVaQsXJFdWbWSnnNzEAIapCDS4xGCRbNgAeYctPU7ruqWh+4LPRASf70m/nFW9f2V0y/ubhhZWN/+fSbatFtj3Zu396567LmL5/t5ru+WlG/4aa7pjlvvWfHstZr7z77AWKWNL1V3YbcTGM1R1NLDCxtMnraaU1IrjFnJibXmMTFKC6GTOC4cI4tZ00NgqomLkoyWjilGdU0rioKg9vTeizMMsmOOFMXJSdWJpWQllGV0ZOhvJPBMoR/lxTViN6Zmre4JiMrK0ddrTit2TUHFaZMsmJnHJcjVD8xSsXTiTNvZY1GVagW2enfGYs52LHpbDau+Gc9u7nF0/xrh2Pv8CbLu69Tw5mdlQ3StSx1dYr0a+pqAKYki9joDibjsrMtbOloC69BxY+oFjoefYdY9J1xBc/veHXjRDlGhuhvnEmJKQ1plrRsXFKtDQacIRMYiD6CcUxWd1pBWloBMyUp9iXFxWLL1CUxx/T7zD59Y1Nh06cOtm/dnL2+tvfT2WrR2ST+hw/4sZ29Fy1J+UVioFvUwDvxLPg+amAy7rdHnIVGw7H0Y1blYgPbY/iJgaemFCYmJVGupRAuSSZz5jlVL9OWX5Xfk+/PP5RvyLckayzmLFH48hYWvtm6J6pe6urKudq3IqVAQ/HLSDeKymfP5nLj14i6dyf7V5a07cBjvV/a/JnvP/vAkX1Nn95QO2Y4nlnw6pHrJ70pGWd/qj433VPR29jenxiPbPoS1nMt1hNHw84Gs0E1GgpNmrnKfNL8mlmtNB82c7OZFFWsJ47MpgbjFjyKb1Nw8vAcbVHVIr5IjZu/iPj5i0D9eg8ABnPL2LkXvWKw1GM1WEhGgWxfUs6cXcv7zt5rOP7+9IPvn71NVCcrHP5rw8uowpPO6pUqK1M1i5bSrR6yGszqSSvPyEzh6amZKUlpyWRJSmNk4elx5uRFbNeiKAwTZSbeyFKSY4VYVh2c13jYFomPkr2iwbzF3G5WzCWWypRdKTxlkqnOxKS0Ip6+i8YypzJ5JkL3ZFxCTWZ21hXHuJfk0hx76zeJ0/KDnfXv7sx+naxYm1gVWgMuq6uT8UJ5EMUhbUVtjSgLWSZRBDIyVmTYURLs1ntX3x26IlDUtO6i2n/+5+k371WL2r9wbcfS71hWb2179YOnlI0i126Hsd9AbMTZPnKM4rAPG1DnnHHtcfxQXDhuKu5U3O/jDLa4nriDcWNAGBSjCQe/kkzMSafwxKjQTtwiGA1GkxrPTUVMFXs5rmBpjZpt1o8ah34LIAOEJcjQyOhgAcOONJjL0G5n2dNvsmz1SaZOf/CXT6hFOEDYPAs7xBaccpYK+wztBn7IEDZMGU4Zfm8w2Aw9hoOGMSAMMAY3JVwpYjRjCWWr51ii614R02s4/udWeKMRZ3Ixzqp0ymNfO0aW6PvO1kWr7477SuJdlkcMD8efiDuROJljNqezDfxiY2v8lsWPJD5pfDLnu/HfS/hJ/CsJ75v+lJiYl5yX4czNr8lwJqXUJGeczHgpQ5GFLnlxg+yTstDzW5wJyUmp7Uk9STzJmspEFmTn1rAVqcLsiXytRvZLSmO9ozzWW/Nk70xOSq4ZE/flFpi9KzUVmTehLkq1igxcushEBawyo2BLEkvKqVy8a7Fv8X2L1cXJBWYnirY5O9/bGPPGpjNy+2w68y6KwBkUOWe61VmS3mB1Lk7GJdeCS15KgyxqDWdlEUyFEaBIFcaASPagE31khhTnnSyEkoEwgeNMzGeJLjwRF79ODhsLGhwk6F93oCjvlOqTnPBSklCaJNQnOeEskkJRnBwOHKP1uAtD8HbupZ0OhiPHrhUX1VpoRTUpBfL+JE0chiZjFv8zs65868j0767zsvSXz7BU41mncrVr/Y5i5YpLLquvZ2xb5Vfuf+K2V5kZ1fm70898/qYNbODKg01NAfkxmPiI79d7nvlx/8ldyfV/NGeb5adDD/yqfu5Tf5reavwyqgdDbWMzH58RmdZNb6amuQ/UPvQBU4IRKMN36Q71V3SLKZ8OqAFK4qtx53sJ3Qncl/hjZMX4dtEw1wielfQ4s7H/5JN8UtGUIeV/qw1qyPBZXXoClSANxIsjISppO+65Nlt82AgCu0u9ksTduzRYXhXJFy9HiuTCnaEOK9TFLDqsUjrr12EDWdnndNgI+A4dNtF32Dd02ExF3K/DcTTK79LhePU5RdPhRdRr+qUOJ9Buc7MOJxqPmh/T4SS6LPnTs347mHxch+E2y2od5qRa1umwQsss63VYpXjLkA4bKMFyhQ4bAV+rwybqtRzWYTOlWf6gw3HUkmLQ4XjuSvmEDi+i5WmPz35btiLtFzqcqOxIT9bhJKrI8sISpgqvJ2V9SYdVysl6UMIG4OOzTuqwSplZ35ewEXhj1ms6rFJq1hsSNom4ZP1JhxGLrKiEzcAnWNN0WCWr1SbhOBFfa50OI77ZtToMOdkNOoz4Zl+sw5CZfZ8OI77ZEzqM+Gb/ow4jvtm/0mHEN+dhHUZ8c17UYcQ391M6jPhq2TqM+Gqf1WHEV/tfOoz4Ft8p4Xjhq+J/12H4qji2xkXAp5Zk67BKi0scEk4QaynZqMOwv2SrhJNE5pd4dFilvJKQhC1Szm06LOR8TcJpwuclz+owfF7yXQmnC3tKfqbDsKfkTQlnAJ9eynRYJa00Q8KZgr60VodBX9ok4WxJv1OHBf1eCeeKHCi9TYeRA6X3SDhf2FM6rsOwp/QpCdsk/fd1WNC/LOGlIgdK39Jh5EDpHyVcJvxTlqjD8E9ZzM5yUQnKSnVYnYHN0v+zMOwvk/ljlusq26rDAr9LwAkx+v06LPDXS1jGpex+HRZ6H6VO2k9+8tBucpEbvUaPonVSv4Q3kY+G0II6lYaK6aNhwOLqAt4rKTRgBsBfAahZ4l3/Q0mVs5Zp1IGZAQrN0gSA24g+pm85rca7isp1qFpiG8ExgH4bePbAhqDk2gZ5AbRh2odrH6iGMe8C5Xqpo+8cO9fMo9FmqdbQJVJKYNbqFdBahbeGKr8JWDdmfZj3wbNBKj2vlI+SMUdbPs+uznn4b0nPCr/1QcYg+mG6HDih7b/vcw1YD7zlhU1BaZvwkYaxoAnqUrcjHhq1S36NiqS+Tbhuge7d0vcu0As+D6QKb49ITiGt4jw2xeLsg15hkx+0+z+SyiPzS9CNSKv2zOr16tlbLqPso17d6s1ypl960QVrls3aPixnvDJTO3ANSatjEYll1SrkUpO0JCi9POO3Ydiigcql52Iso7zS930yw0TODUld8+Pu1mW5pG2Cc1BKFHb3Q/+glBjzviatdkl9bj0asRlhdUCPh0uuMca3fzb+Xj3b/XoEPdI3AZmNsdXNRMil2x+S2jSpYb5VM5EXvhHjESm7f142CFqflBXTPYOPeTuoe8StZ2rgHLogZHqkV7zoY7LdOiYkPS0yai6nfXLnDkuPDkh+YamI56DONaPBLfn36Vq9+kpj+1FImPPCblAKaTHsnF+9und9+kq8kj4kR3NRDcgsHZDWnT8nZmprYHYtYm5QypuTIerF5bq1Lt3/bln1NH2XzvisT+reI7ExfrHDvHoM++W+8+s54sNV7Oh9urdjEuaqvUvGKpYdmvShW1+/V0ZtQNL45d6LZeOQ5IytZH52e2czS+z8K/TIDEprRG7u0/dWrO4MzNoxKEdz2Rv80IkU+ND63LqOXikhJD3dtyA3PbQX+BnPitx2z65wt8xtTebAFdK3AZl3wdl6Eou6sD2234N61YjtpoCeZXPVMzY7KCPioislf8xqIdctZ+cyLaa9T3rLL3fJ/tlVzOgekjVTzLukJ4Z1HWIPxbwYlPwzFs9I98scGpR1c8a2Cnn2BTG3BmdqJeSKd4Wkml9hK2R1GgRFv9xLA4AGAQ3JCHnkKEC7ZA7EIl4xS/l/V8OIzJgYrWeels2o9J0491vRmpB5At4CrDgBWnH9pMS3ANOBq8jNi3EStOC9SWI7KRFPU6J1ymwKnCfXtFl8bJ/EPOrXfT6Xo3/dKTYXmZmKPBPnXjm7H/ShWZ3u2doWy+e582h+tYxVjrk6Gtu/Xr1mBvQ9vUdK8czWRLFbu3VtYnfv02tp7+xpFNMZ/BjPzNTOkdnq5NF3nGc2p4dl/Qjq+3m3no/n89fMLhQe88yTMreLz9XXp5+AIgN7ZWWMWd2rR2ZIl3y+CBXLVS30VKwin5sV52qeqW2iirnkvagLWgd0bwf0GvJRuoX3twMzV2f3nxMLj36XMf+eK1a9XdIiv/SsV7/T+Wtirum5ODSvts3oFZWkT3raO+8UGZ53r7xslnp4Xt7Ond0f7ylh3aCUP5NXvgXyRmT8L5fRnH8fOlMf5yh9oI3doYakx4X8/tn1xOyan92DekWN+T+2q/x6fsxV3oU59HErmsuPjXLt50Zu5t5LnDke/Q4ttprY/Z5bRnXoQzEY/pC/5yQH5N1qSN71x86hffLeaITm313919GfkTes3/959Wee893FnRvHmLfm7ljdUua5+3gmYq4P+Xr332TtnJfP1bDwvF9okUe/iw3i7JmRIJ5PGin2JFCCe/gaqsPzl4brcozK8XxVI5+yxKcj26lNp6zC7HLM1OhwHZ7G6iTXSqrFs4BoQvrfdtb990/GmbnKD3lv9jzs3O/37Ha5PdqjWme/R9vkG/IFgdKafMN+37Ar6PUNaf4Bd4XW7Aq6/guiSiFM6/ANhAQmoG0cAt/y1aurynGprtAaBwa0bd49/cGAts0T8Azv8/Q1DntdA+t9A30zMtdIjCZQay7xDAeE6BUVVVVaySave9gX8O0Ols6RzKeQ2HIpq1PCj2idw64+z6Br+HLNt/tjLdeGPXu8gaBn2NOneYe0IEi3d2jtrqBWpHVu0rbs3l2huYb6NM9AwDPSD7KKWUlYs2/PsMvfv38+yqM1D7tGvEN7BK8X7i3Xtvl6IXqz193vG3AFlgnpw16316V1uEJDfVgIXLWqusk3FPQMCtuG92sBF7wIR3l3a32egHfP0DIttnY3qFxeTA76hj1af2jQNQTzNXe/a9jlxjIw8LoDWIdrSMPcfrF+L9zuxwI9bk8g4IM6sSAX5Ifc/ZpXFyUWHxryaCPeYL90w6DP1ye4BQyzgzDEDacGZnDBEc9Q0OsBtRtAaHh/hSY97dvnGXYh3sFhjys4iCnB4A4h5gGhTMTRMyxN2B0aGAAobYX6QR+UeIf6QoGgXGoguH/AM98TIlsDQotneNA7JCmGfZdDrAv2u0NQFAtgn9e1xyfmR/rhc63fM+CHR3zaHu8+jySQae/SBuAObdAD3w153SB3+f0euHHI7YGSmLu9wlma5wosZtAzsF/D2gLInQEhY9A7IN0b1DdSQNfnBkevRwsFkFLSm569IWFsyC38r+32YcmQiEUFgyJPsPRhD+IeRGogTAG4TKYnhoOuPa4rvUMQ7Qm6l8WcBvY+b8A/4NovVAjuIc9IwO/ywzSQ9MHEoDcgBAty/7Bv0CelVfQHg/41lZUjIyMVg3rCVrh9g5X9wcGBysGg+NuSysHALpdYeIVA/pUMI54BYD2SZfOWzo2tG5saOzdu2axtadU+ubGpZXNHi9Z48baWlk0tmzsT4xPjO/vh1hmvCReLmMBQrCAoPXqeLSYXIxJZrLl3v7bfFxKcbpFt8LPcR7G0RHLIHEV8sf2GQO7aM+zxiEys0LrB1u9CGvh6xTYCZ3CBMSI7R0Q6eRA4j/D0sMcdRJx3w49zdokQ+vZ4JIkM8SwfQoPs7Q0FIRpm+rCj5i2oODBjFBJ51hWzzCLbtH2ugZCrFxnmCiBD5nNXaNuHZM7un1kF1qRXLqS3Swv4PW4vis65K9fgxSGZbYLX1dfnFTmBrByWVXmZQA9L38rd/SGjBryDXrEgKJF0I77hywOxJJX5KJG+ERTUUO+AN9Av9EBWzN2DSFTYj1D592ux5NU9tFCR9MfG3XOLE9Vrb8gTkGpQ99ye4SF9BcO63ZI40O8LDfRhD+3zekZi5eqc5Qs6RNKDCtA3V+Jm1wizZGF1B+diLBbm0q3efX6x0uRZBn3f64KgxxVcIwi2dzTiEChZVVNXqtUtX1VeVVNVFRe3vQ3IquXLa2pwrVtRp9WtrF1duzox/iN23cduRjGq1M2T+xCPqx79Jknc6sz/mGXhTJBCLBG3Bm8toJnD7qaFH3NrOqZV/9Bj/oyOU25QnlG+o5zEdXz+/AL8ha8NLnxtcOFrgwtfG1z42uDC1wYXvja48LXBha8NLnxtcOFrgwtfG1z42uDC1wYXvjb4f/hrg9nPD7z0UZ8sxGY+iT6WrT6JCS2gPXf2Ylk1AguoZnCt9BbGl9N7oH8LuIWfOiycm+GZub/ynVfi3OwlEppPE8NskKN98vOOhfMLZ9r10zckn/18clfOpz7f/HxP+T7Shz7Vpq5T16pN6kp1lepUL1Lb1NXzqc8733neT3TmsK3nrCeGaRMjthw08+fmsG36venlH7J4Hp6l0C8VO7Jk3vws7q/Nm7/SN3+1vI/LK/3/y1O0mH5K53l9mzqVr1AyY2SLTilfnrCkVzsnlbsnktOqnY0W5U5qR+MUVjbRFBonn3IbHUTjIG+LlC+vPiaAifikagvobyIN7RCaQmO4Mjl2ogn6mybSMoX4ayLJKZLvs5GqmhgwYbFWtzemK1cQUzzKENnJphxAvxi9G30++l6lD5VC2OmcSLZUH4K+BpA3KBkoQzalUcmkavTNSg7lSrJQJCmmJxQpKatujFeaFKskSVYSUY9silkxRapt2glF/NmwU7lhIm6RsO+GiCWj+hnlOsVE6aA6BKosW/IzSjxVoomVdE7EJVYfbkxQOrHMTrjFpoj/rH+fvDqVoQgEQV+LkkeZmLtcyacM9K3K4kiGbeqEcrsk+zshBfrWRcwrRDeRmFQ91RiniL8HCCu3wuO3Sm2HJ4pWVVNjkVJCVYr4EwlNOQjooPjP4soooFGEaRShGUVoRmHFKBkR+RsxcyNoKpUrya+M0GG0+wCrEJkRgQePSWBpSfUxJVuxwhOWE/AdAzZnIi5JWGaNpKZJMutEQlJ1wzNKgLagcRgfnMiyVvtOKGVyKcsmrLmCwR+JS4DrsmKxAGOmiMEzSp6yWHoiX3og3GjDmFGyYiPGf8BPCe/wl/mPRXzFT/rI/h/1/kW9/2Gsj07xUxPQ4pzk/yz60415/A0I28VfpfsAcX6CP4+jxsZ/zieFFfxn/Bg1oH8F4z70x9CvQH88UvA92ySfnEAH2++JJGaKxfLnI45KHbAV6kBWrg6kZlY3FvLn+LOUBxE/Rb8U/bN8ipagP4nein6KB+l76J/gtbQW/VG9/w5/WuQ0f4o/iTPTxiciScKEcMQkuiMRo+i+FaHYqL3S9jT/Fn+cckD6zUhRDrCPTBQttSWfgDzGH+TBSL4ttTGe38+62LsgGqNXRE+p/IFInRByOPK0ZjvGD/PDTmuds9BZ7nxIqSqsKq96SNEKtXKtTntIa7TwW8kA52HD8ptwxfnMkT1oTrTD/MaIWhduPIs1iXVxOoTrmIR6cPVLiHC1zM6+I6EGfh1tQeOQcQDtINohtKtIxfVKtM+ifQ7t8xITRAuhjaB8+MHhB4cfHH7J4QeHHxx+cPglh19qD6EJjh5w9ICjBxw9kqMHHD3g6AFHj+QQ9vaAo0dytIOjHRzt4GiXHO3gaAdHOzjaJUc7ONrB0S45nOBwgsMJDqfkcILDCQ4nOJySwwkOJzickqMKHFXgqAJHleSoAkcVOKrAUSU5qsBRBY4qyaGBQwOHBg5Ncmjg0MChgUOTHBo4NHBoksMCDgs4LOCwSA4LOCzgsIDDIjksMj4hNMFxGhynwXEaHKclx2lwnAbHaXCclhynwXEaHKf5yLhyqvEFsJwCyymwnJIsp8ByCiynwHJKspwCyymwnNKXHpTO4EibA2gH0Q6hCd4p8E6Bdwq8U5J3SqZXCE3whsERBkcYHGHJEQZHGBxhcIQlRxgcYXCEJccYOMbAMQaOMckxBo4xcIyBY0xyjMnEDaEJjr89Kf/m0PCrWJcZhys/xEplf5Delv0BekX2n6dx2X+OHpL9Z+lq2V9JdbIfoSLZQ57sg2Qzs4itLrkxEyVgC9ouNB/afWhH0E6imST0EtpraFFe61yiJpu2mO4zHTGdNBmOmE6beLJxi/E+4xHjSaPhiPG0kWuNuTxR1lGUFvqivB7E9fdoOERwbZBQA6+B3hrU2Vq8a3iNM+WM9vsy9lIZO1nGjpSxL5axxjh+MVNlpcOdPofhrMuZULTO9gpaXVHxOlSmW598O8sWKVppm2RPx7pSpwP922jjaA+hXY1Wh1aNVo5WiGaTuDLQdzmX6CKfRitGK0DThArKzMTdTWqK2XmMJ7KHJl5IpDihp7gEfCcixVXoJiPFW9A9FSnutTXGsSepWNwGsScQucfRH4nYXsf0N2PdNyK2E+geidhq0O2MFFeguzRS/KKtMZFtJ5sqWDv1vgPrFv22iO0SkG2N2ErROSLFRYK6DIoKMVvKuuh19IU619KYJnvEthbdkohttaA2U7EIPDNSuTTPgCZ6ZQIG/f4Y61KZc5HtjO1229tg/x0ci/T4mTaponupcJJd4oy3PV3+VRA32iKN8YIe58O43odF/4TtocIbbfdAFit80na3rcJ2a/mkGehbYPeNUkXEdrU2yR93ptkO2apswfLXbQHbJ2wu2zbbzkLgI7bLbE8LM6mbdfHHn7S1Q+BGrKIwYru4cFKa2Grbb3Paim2rtaeFf2lVTG5d+dPCA1Qd074M/i0rnBQ5vr1ukqU4y0zvmA6bLjWtN6012U1LTItN+aZ0c6rZYk4yJ5jjzWaz0ayauZnM6eLnHRzizyvTjeKv18moiqsqYQsXVx77S1POzJw+QeE0pY23daxnbeEpN7X1auH3OuyTLH7rjrDBvp6FU9uorXN9eJWjbdIU3Rauc7SFTe2Xdo0zdms3sGF+wySjzq5JFhWo63LFD1GNM7rultxjxFj2dbd0d5M1c1+DtSF1Xcrq1ubzXHr0q2PuZZ0P5ofvauvoCj+W3x2uFkA0v7stfJX4mapjPJkntjQf40mi6+46pvp5css2gVf9zd0ge12SIZuTQEbFogOZeT1pggz1ZL0gQ4xidEVgB12B6EAXn0hFkq4oPlHSqUzQjb+itTSPa5qkKSR6RdK8UkjzaJAx4G0eLyqSVHaNdQkq1mXXpGGlUpDNBpJymyTBk5tNCrIxqSxcOUdSqJPUzpLUSl0Km6OxxWjSS2Zo0ktA4/gfvjzrHWxieejA8+KXv3rsLR60nvBN+/qt4UO9mjZ+IKT/JFhRT6+7X/QuTzhk9zSHD9ibtfHlz59n+nkxvdzePE7Pt3R2jT/v9DRHljuXt9hdzd0TDfVdjQt03Tirq6v+PMLqhbAuoauh8TzTjWK6QehqFLoaha4GZ4PU1eIVed/eNW6m9eJ3QWQ/wRfFI4d7cgu612da/OtEQh9bW2A9kHtcJfYILXJ0hxPs68OJaGKqvLG8UUxhn4mpJPHzbvqU9cDagtzj7BF9ygJ0in09zbiWBFFbuHZrW7igY0eXSJWw03X+mAXES05bqcXbjH8YB2XDez4lBc77Cp7vFQqFAuIScuApuS1c1tEWXrkVlphMUNXT3A1cxQxOUSRuPC6uZTI6hUkHjGBBoU5ADiZ+I8AZj6cuEx8zjpm4eFQITuTkV/uewQl+EA3PcXwkUimfl/nIxJJC8fwSnKisjfV4PhV9JKegWvwUQR1YRV8Y650p5QAOFx4uP1w3VjhWPlZnFD+08BCQtofEURqpfEihoCMw4wiAwW6K/XQB9N0fycuXiscE4HB0OwLyN17ow6526L8jA6fPOjagSw1I8cGZgMTwAYoRxyYdoRmmkM4iJ0OSRSr8P1jbNhMKZW5kc3RyZWFtCmVuZG9iagoKNiAwIG9iagoxMDgyNQplbmRvYmoKCjcgMCBvYmoKPDwvVHlwZS9Gb250RGVzY3JpcHRvci9Gb250TmFtZS9CQUFBQUErQXJpYWwtQm9sZE1UCi9GbGFncyA0Ci9Gb250QkJveFstNjI3IC0zNzYgMjAwMCAxMDExXS9JdGFsaWNBbmdsZSAwCi9Bc2NlbnQgOTA1Ci9EZXNjZW50IDIxMQovQ2FwSGVpZ2h0IDEwMTAKL1N0ZW1WIDgwCi9Gb250RmlsZTIgNSAwIFI+PgplbmRvYmoKCjggMCBvYmoKPDwvTGVuZ3RoIDI3Mi9GaWx0ZXIvRmxhdGVEZWNvZGU+PgpzdHJlYW0KeJxdkc9uhCAQxu88BcftYQNadbuJMdm62cRD/6S2D6AwWpKKBPHg2xcG2yY9QH7DzDf5ZmB1c220cuzVzqIFRwelpYVlXq0A2sOoNElSKpVwe4S3mDpDmNe22+JgavQwlyVhbz63OLvRw0XOPdwR9mIlWKVHevioWx+3qzFfMIF2lJOqohIG3+epM8/dBAxVx0b6tHLb0Uv+Ct43AzTFOIlWxCxhMZ0A2+kRSMl5RcvbrSKg5b9cskv6QXx21pcmvpTzLKs8p8inPPA9cnENnMX3c+AcOeWBC+Qc+RT7FIEfohb5HBm1l8h14MfIOZrc3QS7YZ8/a6BitdavAJeOs4eplYbffzGzCSo83zuVhO0KZW5kc3RyZWFtCmVuZG9iagoKOSAwIG9iago8PC9UeXBlL0ZvbnQvU3VidHlwZS9UcnVlVHlwZS9CYXNlRm9udC9CQUFBQUErQXJpYWwtQm9sZE1UCi9GaXJzdENoYXIgMAovTGFzdENoYXIgMTEKL1dpZHRoc1s3NTAgNzIyIDYxMCA4ODkgNTU2IDI3NyA2NjYgNjEwIDMzMyAyNzcgMjc3IDU1NiBdCi9Gb250RGVzY3JpcHRvciA3IDAgUgovVG9Vbmljb2RlIDggMCBSCj4+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. Integration guide

Table of contents

Annotation

Version history

Terms and abbreviations

Common description

Common description. Server’s request

Common description. Server’s response

Example of a method request

WebAPI requests sequence

Authorization. Token requesting and receiving. AUTH.Login

Session information. Method AUTH.Info

Session close. Method AUTH.Logout

Api methods for transmission HWB and manifests information

Upload HWB information. Method HWB.Validate

Upload HWB information. Method HWB.Upload

Upload HWB information. Method HWB.UpdateReceiverInfo

Upload HWB information. Method HWB.UpdateReceiverID

Upload HWB information. Method HWB.UpdateParcelInfo

Upload HWB information. Method HWB.UpdateSKUInfo

Manifest upload. Method MNF.UploadNumbers

Manifest upload. Method MNF.UploadFull

Methods for receiving events by HWBs. Method HWB.GetEvents

Method for receiving lockers or pickup points list. Method LOC.GetLockers

Labeling

Receiving weights and dimensions. Method HWB.GetWeight

Appendix 1. Event type list

Appendix 2. Error code list

Appendix 3. Structure for JSON HWB

Appendix 4. Partner geotagging

5Post

HWB.JSON Upload example