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

API
Главная / API - Order search by incomplete data

Order search by incomplete data

Обновлено 02.07.2020
90 кб

General information

The service allows to search orders using following data: TIN (for legal entities), type and document number (for individuals), route and order dispatch date.

Order search by incomplete data

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 (for object) or delivery (for request.receiver object). To get CLADR code use the services listed on Using CLADR codes 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