Поиск по сайту

API
Главная / API - Order search by shipping details

Order search by shipping details

Обновлено 04.10.2021
103 кб

General information

The service allows searching orders in case the order number is unknown, in this case the following data is used: TIN (for legal entities), type and document number (for individuals), route and order dispatch date. Passing non-required parameters allows refining the search. 

Use Orders list method to search the order by the order number.

Order search by shipping details

Method request

Request example

Method address: https://api.dellin.ru/v2/tracker_advanced.json

{
   "appkey":"00000000-0000-0000-0000-000000000000",
   "sender":{
      "inn":"7122963715",
      "docType":"passport",
      "docSeries":"4007",
      "docNumber":"451735",
      "terminal":"7800000000000000000000000"
   },
   "receiver":{
      "inn":"4516374515",
      "docType":"foreignPassport",
      "docSeries":"4008",
      "docNumber":"236782",
      "terminal":"7700000000000000000000000"
   },
   "dateStart":"2015-08-10",
   "dateEnd":"2015-08-17"
}

Method address:: https://api.dellin.ru/v2/tracker_advanced.xml

<request>
   <appkey>00000000-0000-0000-0000-000000000000</appkey>
   <sender>
      <inn>7122963715</inn>
      <docType>passport</docType>
      <docSeries>4007</docSeries>
      <docNumber>451735</docNumber>
      <terminal>7800000000000000000000000</terminal>
   </sender>
   <receiver>
      <inn>4516374515</inn>
      <docType>foreignPassport</docType>
      <docSeries>4008</docSeries>
      <docNumber>236782</docNumber>
      <terminal>7700000000000000000000000</terminal>
   </receiver>
   <dateStart>2015-08-10</dateStart>
   <dateEnd>2015-08-17</dateEnd>
</request>

Описание параметров

Request
Request
ParameterRequiredTypeDescription
appkeyYesstringApplication key. To get the key, register

sender

No
Member

Sender data

receiver

No
Member

Receiver data

dateStartYesstring

Period start date (the parameter is used to filter search results by order dispatch period).

Format: YYYY-MM-DD

The interval between the start and the end dates must not exceed 7 days.
dateEndYesstring

Period end date (the parameter is used to filter search results by order dispatch period).

Format: YYYY-MM-DD

The interval between the start and the end dates must not exceed 7 days.

Member
Member
ParameterRequiredTypeDescription
inn
Nostring

TIN - taxpayer identification number (for legal entities). Allowed number of characters may vary depending on country and legal form of organization

docType
Nostring

ID type (for individuals)

Possible values:

  • "passport" -  passport;
  • "foreignPassport" - international passport (for some countries this value is not available);
  • "drivingLicence" - driving license
docSeriesNostring

ID type (for individuals)

docNumberNostringID number (for individuals). Number format may vary depending on the country
terminalNostring

CLADR* code of point of departure (request.sender object) or delivery (for request.receiver object). To get CLADR code use the services listed on "CLADR search" page

(CLADR - Classifier of Addresses of the Russian Federation)

Method response

Response example

{
   "metadata":{
      "status":200,
      "generated_at":"2015-06-18 12:37:28"
   },
   "data":{
      "orderNumbers":[
         "19-00395029101",
         "19-00395029585",
         "19-0039514523"
      ]
   }
}
<response>
   <metadata>
      <status>200</status>
      <generated_at>2015-06-18 12:37:28</generated_at>
   </metadata>
   <data>
      <orderNumbers>19-00395029101</orderNumbers>
      <orderNumbers>19-00395029585</orderNumbers>
      <orderNumbers>19-0039514523</orderNumbers>
   </data>
</response>

Description of parameters

Response
Response
ParameterTypeDescription
metadataobjectSystem information
metadata.statusinteger

Emulated status http-code. If successful, code 200 is returned

metadata.generated_atstring

Server response date and time.

Format: YYYY-MM-DD HH:MM:SS

dataobjectOrders data
data.orderNumbersarray of strings

Orders numbers found

Error handling

Except for common API errors the method response may contain the following errors:

Error numberhttp-codeError titleError description
TitleTranslationDescriptionTranslation

714001

400Ничего не найденоNo orders found--

714002

400Уточните параметры поиска. Количество найденных заказов превышает лимитPlease, refine your search. The number of orders found exceeds the limit--

714003

400Данные участника перевозки введены неверноTransportation participant data are incorrect--

714004

400Не найден участник перевозки по указанным данным (sender)Transportation participant (sender) with the specified data is not found--

714005

400Не найден участник перевозки по указанным данным (receiver)
Transportation participant (receiver) with the specified data is not found--

714006

400Найдено более 5 накладныхMore than 5 waybills found--

714007

400Период указан неверноThe interval is not correctДиапазон дат выполнения заказа не должен превышать 7 днейThe interval between the start and the end dates must not exceed 7 days