Tracking shipments

Parameters for the test client:

LOGIN: public

PASSWORD: PUBLIC

AgentsIDREF: 0xA79E003048D2B47311E26B7D4A430FFC

Sends XML by POST to the address::

https://apii.meest-group.com/T/1C_Query.php

<?xml version="1.0" encoding="UTF-8"?>
<param>
<login>login</login>
<function>function</function>
<where>where</where>
<order>order</order>
<sign>sign</sign>
</param>

To test the features of the search function, you can use the web solution ("sandbox"):

https://apii.meest-group.com/T/test/test_q.php
Д
ля прикладу:
https://t.meest-group.com/ua/

The description of the field is presented in Table 4.1.

Table 4.1. Description of form fields

Field 

Field

login  

Username, assigned to me after entering the Contractor into the system

function 

The name of the function we use to enter the record.

where

Search terms.

The result returns the first 100 entries, unless filtered in the "Where" field.

The fields in which the user can perform filtering are marked "yes" in the tables 'Description of the contents of the XML code tags'.

order

Sort entries.

If no fields and conditions for sorting were entered, the result - in an arbitrary order.

sign 

 = md5 ( login + password + function + where + order)

Errors code is shown in Table 4.2.

 

Table 4.2. Error codes

Код помилки
ErrorsCode

Опис

Description

000

Успішне виконання

ОК

100

Помилка з’єднання

Connection Error

101

Помилка авторизації

Аuthorization Error

102

Функція не знайдена

Function is not found

103

Документ не знайдено

Document not found

104

Каталог не знайдено

Directory not found

105

Не вдалося обробити запит

Failed to parse request

106

Внутрішня помилка 1С

Internal error 1C

107

Внутрішня помилка

Internal error

108

Помилка запиту

Error request

109

Помилка структури XML

Error XML structure

110

З'єднання розірвано

Disconnected

111

Запит обробляється

The request is processed

113

Люба помилка при створенні

Any error 

Example of using FUNCTION: SHIPMENTS_TRACK

http://wiki.meest-group.com/images/api/SHIPMENTS_TRACK.jpg

 Таблиця 4.3. Приклад використання

Examples of using the f-tion

Example of completing the query

<?xml version="1.0" encoding="UTF-8"?>

<param>

<login> LOGIN </login>

  <function> SHIPMENTS_TRACK

</function>

<where> 0xA79E003048D2B47311E26B7D4A430FFC, 'TESTIK11'

</where>

 <order> </order>

<sign>sign*</sign>

</param> 

*sign = md5 ( login + password + function + where + order)

<return>

<api>API-1C </api>

<apiversion>1 </apiversion>

<result_table>

<items>

< 0xa969003048d2b47311e3fc6109445fb1 </ShipmentIdRef>

<DocumentIdRef> 0xa969003048d2b47311e3fc6109445fb4 </DocumentIdRef>

<AgentsIdRef> 0xb95653547d06ad014b2580d2c4be55b2 </AgentsIdRef>

<ShipmentNumberSender> 001-0255371 </ShipmentNumberSender>

<ShipmentNumberTransit/>

<ShipmentClientID/>

<DateTimeAction>2016-06-25 15:05:53 </DateTimeAction>

<Country>УКРАЇНА </Country>

<City>Дніпродзержинськ </City>

<ActionId>6 </ActionId>

<StatusCode>606 </StatusCode>

<ActionMessages> Поступлення відправлення на відділення </ActionMessages>

<ActionMessages_RU> Поступление отправления на отделение </ActionMessages_RU>

<ActionMessages_EN> Accepted by the branch </ActionMessages_EN>

<DetailMessages> Дніпродзержинськ </DetailMessages>

<DetailMessages_RU> Дніпродзержинськ </DetailMessages_RU>

<DetailMessages_EN> Дніпродзержинськ  </DetailMessages_EN>

<DetailPlacesAction>1/1 </DetailPlacesAction>

 </items>

<items>

<ShipmentIdRef> 0xa969003048d2b47311e3fc6109445fb1 </ShipmentIdRef>

<DocumentIdRef> 0xa969003048d2b47311e3fd1122373886 </DocumentIdRef>

<AgentsIdRef> 0xb95653547d06ad014b2580d2c4be55b2 </AgentsIdRef>

<ShipmentNumberSender> 001-0255371 </ShipmentNumberSender>

<ShipmentNumberTransit/>

<ShipmentClientID/>

<DateTimeAction> 2016-06-26 12:06:19 </DateTimeAction>

<Country>УКРАЇНА </Country>

<City>Дніпродзержинськ </City>

<ActionId>20 </ActionId>

<StatusCode>2028 </StatusCode>

<ActionMessages>

Відправлення було згруповане для переміщення на сортувальний центр

 </ActionMessages>

<ActionMessages_RU>

Отправление было сгруппировано для перемещения на сортировочный центр

 </ActionMessages_RU>

<ActionMessages_EN> Sending been grouped to move to the sorting center </ActionMessages_EN>

<DetailMessages> Рівне-Орлова </DetailMessages>

<DetailMessages_RU> Рівне-Орлова </DetailMessages_RU>

<DetailMessages_EN> Рівне-Орлова </DetailMessages_EN>

<DetailPlacesAction>1/1 </DetailPlacesAction>

 </items>

<items>

<ShipmentIdRef> 0xa969003048d2b47311e3fc6109445fb1 </ShipmentIdRef>

<DocumentIdRef> 0xa969003048d2b47311e3fd3817200b40 </DocumentIdRef>

<AgentsIdRef> 0xb95653547d06ad014b2580d2c4be55b2 </AgentsIdRef>

<ShipmentNumberSender> 001-0255371 </ShipmentNumberSender>

<ShipmentNumberTransit/>

<ShipmentClientID/>

<DateTimeAction>2014-06-26 16:45:13 </DateTimeAction>

<Country>УКРАЇНА </Country>

<City>Дніпропетровськ </City>

<ActionId>21 </ActionId>

<StatusCode>2129 </StatusCode>

<ActionMessages> Розгрупування відправлення для сортування </ActionMessages>

<ActionMessages_RU> Разгруппирование отправления для сортировки </ActionMessages_RU>

<ActionMessages_EN>Ungroup sendings for sorting </ActionMessages_EN>

<DetailMessages> Рівне-Орлова </DetailMessages>

<DetailMessages_RU> Рівне-Орлова </DetailMessages_RU>

<DetailMessages_EN> Рівне-Орлова </DetailMessages_EN>

<DetailPlacesAction>1/1 </DetailPlacesAction>

 </items>

<items>

<ShipmentIdRef> 0xa969003048d2b47311e3fc6109445fb1 </ShipmentIdRef>

<DocumentIdRef> 0xa969003048d2b47311e3fd281624df62 </DocumentIdRef>

<AgentsIdRef> 0xb95653547d06ad014b2580d2c4be55b2 </AgentsIdRef>

<ShipmentNumberSender> 001-0255371 </ShipmentNumberSender>

<ShipmentNumberTransit/>

<ShipmentClientID/>

<DateTimeAction> 2016-06-26 19:40:24 </DateTimeAction>

<Country>УКРАЇНА </Country>

<City>Дніпропетровськ </City>

<ActionId>8 </ActionId>

<StatusCode>808 </StatusCode>

<ActionMessages>

Відправлення залишило сортувальний центр у напрямку

 </ActionMessages>

<ActionMessages_RU>

Отправление оставило сортировочный центр в направлении

 </ActionMessages_RU>

<ActionMessages_EN>

The sending has left the sorting center in the direction of

 </ActionMessages_EN>

<DetailMessages>Рівне-Орлова </DetailMessages>

<DetailMessages_RU>Рівне-Орлова </DetailMessages_RU>

<DetailMessages_EN>Рівне-Орлова </DetailMessages_EN>

<DetailPlacesAction>1/1 </DetailPlacesAction>

 </items>

<items>

<ShipmentIdRef> 0xa969003048d2b47311e3fc6109445fb1 </ShipmentIdRef>

<DocumentIdRef> 0xa969003048d2b47311e3fdd02038f378 </DocumentIdRef>

<AgentsIdRef> 0xb95653547d06ad014b2580d2c4be55b2 </AgentsIdRef>

<ShipmentNumberSender> 001-0255371 </ShipmentNumberSender>

<ShipmentNumberTransit/>

<ShipmentClientID/>

<DateTimeAction> 2016-06-27 10:53:29 </DateTimeAction>

<Country>УКРАЇНА </Country>

<City>Рівне </City>

<ActionId>12 </ActionId>

<StatusCode>1214 </StatusCode>

<ActionMessages> Відправлення прибуло на сортувальний центр </ActionMessages>

<ActionMessages_RU> Отправление прибыло на сортировочный центр </ActionMessages_RU>

<ActionMessages_EN> Sending arrived at the sorting center </ActionMessages_EN>

<DetailMessages>Рівне </DetailMessages>

<DetailMessages_RU>Ровно </DetailMessages_RU>

<DetailMessages_EN>Рівне </DetailMessages_EN>

<DetailPlacesAction>1/1 </DetailPlacesAction>

 </items>

<items>

<ShipmentIdRef> 0xa969003048d2b47311e3fc6109445fb1 </ShipmentIdRef>

<DocumentIdRef> 0xa969003048d2b47311e4004330588938 </DocumentIdRef>

<AgentsIdRef> 0xb95653547d06ad014b2580d2c4be55b2 </AgentsIdRef>

<ShipmentNumberSender>001-0255371 </ShipmentNumberSender>

<ShipmentNumberTransit/>

<ShipmentClientID/>

<DateTimeAction>2016-06-30 13:42:11 </DateTimeAction>

<Country>УКРАЇНА </Country>

<City>Рівне </City>

<ActionId>8 </ActionId>

<StatusCode>808 </StatusCode>

<ActionMessages>

Відправлення залишило сортувальний центр у напрямку

 </ActionMessages>

<ActionMessages_RU>

Отправление оставило сортировочный центр в направлении

 </ActionMessages_RU>

<ActionMessages_EN>

The sending has left the sorting center in the direction of

 </ActionMessages_EN>

<DetailMessages> Рівне-Орлова </DetailMessages>

<DetailMessages_RU> Рівне-Орлова </DetailMessages_RU>

<DetailMessages_EN> Рівне-Орлова </DetailMessages_EN>

<DetailPlacesAction>1/1 </DetailPlacesAction>

 </items>

<items>

<ShipmentIdRef> 0xa969003048d2b47311e3fc6109445fb1 </ShipmentIdRef>

<DocumentIdRef> 0xa969003048d2b47311e400488fed8bb8 </DocumentIdRef>

<AgentsIdRef> 0xb95653547d06ad014b2580d2c4be55b2 </AgentsIdRef>

<ShipmentNumberSender> 001-0255371 </ShipmentNumberSender>

<ShipmentNumberTransit/>

<ShipmentClientID/>

<DateTimeAction>2014-06-30 14:20:43 </DateTimeAction>

<Country>УКРАЇНА </Country>

<City>Рівне </City>

<ActionId>12 </ActionId>

<StatusCode>1214 </StatusCode>

<ActionMessages> Відправлення прибуло на сортувальний центр </ActionMessages>

<ActionMessages_RU> Отправление прибыло на сортировочный центр </ActionMessages_RU>

<ActionMessages_EN> Sending arrived at the sorting center </ActionMessages_EN>

<DetailMessages>Рівне </DetailMessages>

<DetailMessages_RU>Ровно </DetailMessages_RU>

<DetailMessages_EN>Рівне </DetailMessages_EN>

<DetailPlacesAction>1/1 </DetailPlacesAction>

 </items>

<items>

<ShipmentIdRef> 0xa969003048d2b47311e3fc6109445fb1 </ShipmentIdRef> 

<DocumentIdRef> 0xa969003048d2b47311e4005a09440c8e </DocumentIdRef> 

<AgentsIdRef> 0xb95653547d06ad014b2580d2c4be55b2 </AgentsIdRef>

<ShipmentNumberSender>001-0255371 </ShipmentNumberSender>

<ShipmentNumberTransit/>

<ShipmentClientID/>

<DateTimeAction>2014-06-30 16:25:43 </DateTimeAction>

<Country>УКРАЇНА </Country>

<City>Рівне </City>

<ActionId>17 </ActionId>

<StatusCode>1724 </StatusCode>

<ActionMessages> Відправлення видано зі складу отримувачу </ActionMessages>

<ActionMessages_RU> Выдано из склада получателю </ActionMessages_RU>

<ActionMessages_EN> Picked up by recipient at the warehouse </ActionMessages_EN>

<DetailMessages/>

<DetailMessages_RU/>

<DetailMessages_EN/>

<DetailPlacesAction>1/1 </DetailPlacesAction>

 </items>

 </result_table>

<result_uuid/>

<errors>

<code>000 </code>

<name> </name>

 </errors>

 </return>

<name> </name>

 </errors>

 </return>

 

 

Table 4.4. Description of the contents of the XML code

Field

Description

Type

ShipmentIDRef

Unique shipping ID

Text

ShipmentIDRef

Shipment’s ID(in Rosan system)

Text

DocumentIDRef

Document’s ID(in Rosan system), which generates this status

Text

AgentsIdRef

Unique agent identifier

Text

ShipmentNumberSender

Shipment number, track number

Text

ShipmentNumberTransit

Transit number

Text

ShipmentClientID

Sender’s client ID

Text

DateTimeAction

Status datetime

dateTime

Country

Country where this status was set

Text

City

City where this status was set

Text

ActionId

Status ID

Text

StatusCode

Status Code

Text

ActionMessages_UA

Status name in ukrainian

Text

ActionMessages_RU

Status name in russian

Text

ActionMessages_EN

Status name in english

Text

DetailMessages_UA

Status deteils in ukrainian: city,country,date etc

Text

DetailMessages_RU

Status deteils in russian: city,country,date etc

Text

DetailMessages_EN

Status deteils in english: city,country,date etc

Text

DetailPlacesAction

Quantity places received/

Quantuty places sent

Text

 

Table4.5. Description 

Code

Name

Name EN

International postal code

0

ВІДПРАВКА З МІЖНАРОДНОГО СОРТУВАЛЬНОГО ЦЕНТРУ

DEPARTED THE INTERNATIONAL SORTING CENTER

EMK

101

ОФОРМЛЕНО ДЛЯ ВІДПРАВКИ

POSTING / COLLECTION

EMA

202

НАДХОДЖЕННЯ ДО МІЖНАРОДНОГО СОРТУВАЛЬНОГО ЦЕНТРУ

ARRIVED AT INTERNATIONAL SORTING CENTER

EMB

303

ВІДПРАВКА З МІЖНАРОДНОГО СОРТУВАЛЬНОГО ЦЕНТРУ

DEPARTED THE INTERNATIONAL SORTING CENTER

EMC

404

НАДХОДЖЕННЯ ДО МІЖНАРОДНОГО СОРТУВАЛЬНОГО ЦЕНТРУ

ARRIVED AT INTERNATIONAL SORTING CENTER

EMJ

505

НАДХОДЖЕННЯ ДО МІЖНАРОДНОГО СОРТУВАЛЬНОГО ЦЕНТРУ

ARRIVED AT INTERNATIONAL SORTING CENTER

EMD

606

НАДХОДЖЕННЯ НА ПІДРОЗДІЛ ВІДПРАВНИКА

ARRIVAL AT SENDER OFFICE

 

808

ВІДПРАВКА З МІЖНАРОДНОГО СОРТУВАЛЬНОГО ЦЕНТРУ У НАПРЯМКУ МІСТА ДОСТАВКИ

LEFT THE INTERNATIONAL SORTING CENTERFOR FINAL DESTINATION

EMF

1 214

НАДХОДЖЕННЯ НА ПІДРОЗДІЛ ARRIVED AT LOCAL DELIVERY OFFICE

ARRIVED AT LOCAL DELIVERY OFFICE

EMG

1 315

ВИДАНО КУР`ЄРУ

OUT FOR DELIVERY

 

1 521

ЗМІНА НАПРЯМКУ ПОСИЛКИ

ROUTE HAS BEEN CHANGED

 

1 620

ВІДМОВА

DELIVERY REFUSED

 

1 621

ПЕРЕАДРЕСАЦІЯ

DELIVERY REDIRECTED

EMH

1 622

ДОРУЧЕНО

DELIVERED

EMI

1 623

ПОВЕРНУТО НА СКЛАД / НЕВДАЛА СПРОБА ДОСТАВКИ

RETURNED TO THE WAREHOUSE

 EMH

1 624

НЕ КОРЕКТНІ ДАНІ ПРО ДОРУЧЕННЯ

UNABLE TO VERIFY DELIVERY INFORMATION

 EMH

1 625

 ВІДСУТНІЙ КОНТАКТ З ОТРИМУВАЧЕМ

RECEIPIENT NOT AVALIABLE

EMH 

1 626

ОТРИМУВАЧ ПЕРЕНІС ДАТУ ДОРУЧЕННЯ

DELIVERY DATE HAS BEEN CHANGED

EMH 

1 627

НЕ ВСТИГ ДОСТАВИТИ

NOT DELIVERED

EMH 

1 628

НЕ КОРЕКТНІ ДАНІ ОТРИМУВАЧА

UNABLE TO VERIFYRECEIPIENT

EMH 

1 825

ВІДПРАВЛЕННЯ ПОВЕРНУТЕ ВІДПРАВНИКОВІ

SHIPMENT RETURNED TO SENDER

 

2 230

МИТНЕ ОФОРМЛЕННЯ

PENDING CUSTOMS CLEARANCE

EME

2 331

ДОРУЧЕННЯ ПРИЗУПИНЕНО

DELIVERY STOPPED

 

2 432

ЗНЯТО ОБМЕЖЕННЯ В ДОСТАВЦІ

RESTRICTION REMOVED

 

2 533

УТОЧНЕНО РЕКВІЗИТИ ОТРИМУВАЧА

RECIPIENT WAS VERIFIED

 

5 051

ВІДПРАВЛЕННЯ НЕ ПРИБУЛО

PARCEL HAS NOT ARRIVED

 

8 081

ВІДПРАВКА З ПІДРОЗДІЛУ ВІДПРАВНИКА

PARCEL HAS NOT ARRIVED