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

API
Главная / API - Orders search

Orders search

Обновлено 06.11.2020
290 кб

General information

The service allows tracking orders using Delovye Linii order number or waybill number or number of order for shipping, as well as internal online store order number or document barcode. Authorized users may use the method to get the list of orders that have been created in the personal account as well as information about the actual statuses of orders, orders for shipping and waybills

The request parameter request.sessionID is used to differentiate whether to provide short or detailed information. If а request contains the parameter, then detailed information will be provided, if not - short. Thus, only authorized users have access to detailed orders information. 

Orders search

Method request

Request example

Method address: https://api.dellin.ru/v3/orders.json

{
   "appkey":"00000000-0000-0000-0000-000000000000",
   "sessionID":"00000000-0000-0000-0000-000000000000",
   "docIds":[
      "19-00085281151",
      "19-00085281152"
   ],
   "orderNumber":"1234567889",
   "orderDate":"2019-11-02",
   "barcode":"1345678",
   "dateStart":"2019-11-11 10:10",
   "dateEnd":"2019-11-12 10:10",
   "states":"pickup",
   "page":1,
   "lastUpdate":"2019-11-12 10:10",
   "orderBy":"ordered_at",
   "orderDatesAdditional":true
}

Method address: https://api.dellin.ru/v3/orders.xml

<request>
   <appkey>00000000-0000-0000-0000-000000000000</appkey>
   <sessionID>A00000000-0000-0000-0000-000000000000</sessionID>
   <docIds>19-00085281151</docIds>
   <docIds>19-00085281152</docIds>
   <orderNumber>1234567889</orderNumber>
   <orderDate>2019-11-02</orderDate>
   <barcode>1345678</barcode>
   <dateStart>2019-11-11 10:10</dateStart>
   <dateEnd>2019-11-12 10:10</dateEnd>
   <states>pickup</states>
   <page>1</page>
   <lastUpdate>2019-11-12 10:10</lastUpdate>
   <orderBy>ordered_at</orderBy>
   <orderDatesAdditional>true</orderDatesAdditional>
</request>

Description of parameters

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

sessionID

No*string

Session ID. To get the session ID, use User authorization service.

*If sessionID parameter is passed in a request, then detailed information will be provided, if not - short

docIdsNo*array of strings

Number of order, waybill or order for shipping from address/delivery to address. More than one parameter can be passed (5 parameters maximum).

*The parameter is used to search for orders. If sessionID parameter is not passed in a request, then one of the following parameters must be passed: docid, barcode or orderNumber

Only one of the following parameters can be passed in a request: docid, barcode, orderNumber
orderNumberNo*string

Online store order number (internal order number).

*The parameter is used to search for orders. If sessionID parameter is not passed in the request, then one of the following parameters must be passed: docid, barcode or orderNumber

Only one of the following parameters can be passed in a request: docid, barcode, orderNumber
orderDateNostring

Online store order date.

Format: YYYY-MM-DD

barcode

No*string

Barcode read by a scanner.

The following barcodes can be used to search for the order:

  • barcode on the waybill (the first three symbols of the code - 128);
  • barcode on the forwarder's bill of lading (the document is used by the forwarding driver when picking up the cargo at the sender's address, the first three symbols of the code - 098);
  • barcode on the order for shipping created in case of pre-order, see below (the first three symbols of the code - 415);
  • barcode on the cargo packaging label (waybill code with cargo place indicated, the first three symbols of the code - 728).

In case of cargo packaging label the field length is 29 characters, in other cases - 25 characters.

*The parameter is used to search for orders. If sessionID parameter is not passed in a request, then one of the following parameters must be passed: docid, barcode or orderNumber

Only one of the following parameters can be passed in a request: docid, barcode, orderNumber

Pre-orderIf a client wants to bring the cargo to the company terminal, they may place an order online, print the paper and bring it to the terminal. Thus they will be able to save time since the clients who placed a pre-order are served out of turn. For more information see Delovye Linii company website.
dateStartNostring

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

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

The parameter is ignored if the request does not contain sessionID parameter or contains one of the following parameters: docid, barcode or orderNumber

dateEndNostring

Period end date and time (the parameter is used to filter search results by the period of order creation, the parameter is ignored if a request does not contain dateStart).

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

The parameter is ignored if a request does not contain sessionID parameter or contains one of the following parameters: docid, barcode or orderNumber

statesNoarray of strings

Array of the requested order statutes. For the complete list of statuses, see Directory of order statuses.

The parameter is ignored if a request does not contain sessionID parameter or contains one of the following parameters: docid, barcode or orderNumber

pageNointegerNumber of the requested page
lastUpdateNostring

The parameter is used to filter orders updated after the indicated date.

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

The parameter is ignored if а request does not contain sessionID parameter or contains one of the following parameters: docid, barcode or orderNumber.

If the "states" parameter with the "inway" value is passed in the request, then the response contains all the orders with the "inway" status. Thus the "lastUpdate" parameter is ignored in this case. For other statuses the logic is different - the response contains only orders with the indicated status that were updated after the date passed in the "lastUpdate" parameter

orderByNostring

Orders sorting.

Possible values:

  • ordered_at - by order date;
  • updated_at - by update.

The parameter is ignored if а request does not contain sessionID parameter or contains one of the following parameters: docid, barcode or orderNumber

orderDatesAdditionalNobooleanFlag indicating that information on intermediate route points is required

Method respose

Response example

{
   "metadata":{
      "status":200,
      "currentPage":1,
      "nextPage":null,
      "prevPage":null,
      "totalPages":1,
      "generatedAt":"2020-10-01 13:24:54"
   },
   "orders":[
      {
         "orderNumber":null,
         "orderDate":null,
         "orderId":"400275691",
         "orderedAt":"2020-10-01 08:36:27",
         "state":"inway",
         "stateName":"Груз в пути",
         "stateDate":"2020-10-01",
         "progressPercent":15,
         "derival":{
            "city":"г. Санкт-Петербург",
            "cityId":1,
            "cityCode":"7800000000000000000000000",
            "address":"190000, Санкт-Петербург г, Заневский пр-кт, дом № 1",
            "addressCode":"7800000000004380000000000",
            "terminalName":"Санкт-Петербург Парнас",
            "terminalAddress":"194292, Санкт-Петербург г, 1-й Верхний пер, дом № 12, Литера Б",
            "terminalId":1
         },
         "arrival":{
            "city":"г. Москва",
            "cityId":3,
            "cityCode":"7700000000000000000000000",
            "address":"127411, Москва г, Лобненская ул, дом № 18, стр 2",
            "addressCode":"7700000000017250000000000",
            "terminalName":"Москва Север 2",
            "terminalAddress":"127411, Москва г, Лобненская ул, дом № 18, стр 2",
            "terminalId":36,
            "terminalCity":"Москва",
            "terminalCoordinates":[
               37.5192,
               55.8967
            ],
            "terminalEmail":"pismo@dellin.ru ",
            "terminalPhones":"7 (495) 775-55-30",
            "callCenterPhones":"8-800-100-8000",
            "terminalWorktables":{
               "sun":"11:00-16:00",
               "mon":"08:00-22:00",
               "tue":"08:00-22:00",
               "wed":"08:00-22:00",
               "thu":"08:00-22:00",
               "fri":"08:00-22:00",
               "sat":"11:00-16:00"
            }
         },
         "sender":{
            "opf": {
               "name": "ООО",
               "fullName": "Общество с Ограниченной Ответственностью",
               "countryCode": 643
            },
            "opfUid":"0xa8123a457e644fe7435605b8f632f9d3",
            "name":"ООО \"Анкоррес Электро\"",
            "address":"190000, Санкт-Петербург г, Заневский пр-кт, дом № 2",
            "isPhysical":false,
            "inn":"192644882",
            "documentType":null,
            "documentSeries":null,
            "documentNumber":null,
            "counteragentUid":"e0a79552-bcf4-4ca2-bb5b-961bd2c0f9a2",
            "contacts":"Валерий",
            "phones":"+7 (921) 333-22-22"
         },
         "receiver":{
            "opf": {
               "name": "ООО",
               "fullName": "Общество с Ограниченной Ответственностью",
               "countryCode": 643
            },
            "opfUid":"0xa8123a457e644fe7435605b8f632f9d3",
            "name":"ООО \"ДД МЕДИКА\"",
            "address":"127411, Москва г, Лобненская ул, дом № 12, стр 2",
            "isPhysical":false,
            "inn":"7710647612",
            "documentType":null,
            "documentSeries":null,
            "documentNumber":null,
            "counteragentUid":"b2763d61-e1b3-4c26-b46a-b3c95875a9c2",
            "anonym":false,
            "anonymPhone":null,
            "anonymEmail":null
         },
         "payer":{
            "opf": {
               "name": "ООО",
               "fullName": "Общество с Ограниченной Ответственностью",
               "countryCode": 643
            },
            "opfUid":"0xa8123a457e644fe7435605b8f632f9d3",
            "name":"ООО \"Анкоррес Электро\"",
            "isPhysical":false,
            "inn":"192644882",
            "documentType":null,
            "documentSeries":null,
            "documentNumber":null,
            "counteragentUid":"e0a79552-bcf4-4ca2-bb5b-961bd2c0f9a2"
         },
         "freight":{
            "name":"Мебель",
            "weight":"2.0",
            "oversizedWeight":"0.0",
            "volume":"2.0",
            "oversizedVolume":"0.0",
            "places":1,
            "oversizedPlaces":0,
            "length":"0.0",
            "width":"0.0",
            "height":"0.0"
         },
         "isAir":false,
         "air":{
            "arrivalDate":"2020-10-01",
            "giveoutDate":"2020-10-01",
            "warehousingDate":"2020-10-06",
            "deliveryDate":"2020-10-01",
            "comment":"комментарий",
            "orderId":"123-12312323"
         },
         "locks":[
            {
               "name":"Долг",
               "type":"by_payment",
               "setDate":"2020-10-01 11:51:47",
               "endDate":null
            }
         ],
         "totalSum":"7644.0",
         "vat":"1171.33",
         "isPaid":false,
         "isPreorder":false,
         "produceDate":"2020-10-10",
         "declineReason":null,
         "orderDates":{
            "arrivalToOspReceiver":"2020-10-14",
            "arrivalToOspReceiverMax":null,
            "arrivalToOspReceiverAccdoc":null,
            "arrivalToOspSender":null,
            "arrivalToReceiver":null,
            "declineDate":null,
            "derivalFromOspReceiver":null,
            "derivalFromOspReceiverMax":null,
            "derivalFromOspReceiverAccdoc":null,
            "giveoutFromOspReceiver":null,
            "giveoutFromOspReceiverMax":null,
            "derivalFromOspSender":"2020-10-13 00:00:00",
            "draftLastUpdate":null,
            "finish":null,
            "firstDocumentCreatedDate":"2020-10-01",
            "pickup":"2020-10-10 00:00:00",
            "processingDate":null,
            "warehousing":null
         },
         "orderTimeInDays":{
            "delivery":null,
            "deliveryAccdoc":null
         },
         "orderedDeliveryFromAddress":true,
         "availableDeliveryFromAddress":false,
         "orderedDeliveryToAddress":true,
         "availableDeliveryToAddress":false,
         "isFavorite":false,
         "isContainer":false,
         "sfrequest":{
            "cityID":200555,
            "docNumber":"20-00015100302",
            "price":"1490.0"
         },
         "documents":[
            {
               "id":400275691,
               "uid":null,
               "type":"request",
               "createDate":"2020-10-01 11:36:27",
               "state":"accepted",
               "sender":{
                  "opf":"ООО",
                  "opfUid":"0xa8123a457e644fe7435605b8f632f9d3",
                  "name":"Анкоррес Электро",
                  "isPhysical":false,
                  "inn":"192644883",
                  "documentType":null,
                  "documentSeries":null,
                  "documentNumber":null,
                  "counteragentUid":null
               },
               "receiver":{
                  "opf":"ОАО",
                  "opfUid":"0x8390b2048d37e0154b845fb22793e865",
                  "name":"ДД-Мед",
                  "isPhysical":false,
                  "inn":"7710647613",
                  "documentType":null,
                  "documentSeries":null,
                  "documentNumber":null,
                  "counteragentUid":null
               },
               "payer":{
                  "opf":null,
                  "opfUid":"",
                  "name":"Анкоррес Электро",
                  "isPhysical":null,
                  "inn":"192644882",
                  "documentType":null,
                  "documentSeries":null,
                  "documentNumber":null,
                  "counteragentUid":null
               },
               "produceDate":"2020-10-10",
               "forwarderId":"00860733921",
               "comment":"комментарий к отправке",
               "fullDocumentId":"K-400275691",
               "freight":{
                  "name":"Мебель",
                  "weight":0.1,
                  "oversizedWeight":null,
                  "volume":0.1,
                  "oversizedVolume":null,
                  "maxLength":0.1,
                  "maxWidth":0.1,
                  "maxHeight":0.1
               },
               "derival":{
                  "name":"Санкт-Петербург",
                  "code":"7800000000000000000000000"
               },
               "arrival":{
                  "name":"Москва",
                  "code":"7700000000000000000000000"
               },
               "barcode":null,
               "payment":null,
               "totalSum":null,
               "vat":null,
               "serviceKind":null,
               "organization":null,
               "services":[
                  
               ],
               "accompanyingDocuments":[
                  
               ],
               "availableDocs":[
                  
               ]
            },
            {
               "id":"20-00015100302",
               "uid":"0x81f400505683df3d11eb03c3460a5915",
               "type":"shipping",
               "createDate":"2020-10-01 14:51:09",
               "state":"in way",
               "sender":{
                  "opf":null,
                  "opfUid":"0xa8123a457e644fe7435605b8f632f9d3",
                  "name":"ООО \"Анкоррес Электро\"",
                  "isPhysical":false,
                  "inn":"192644882",
                  "documentType":null,
                  "documentSeries":null,
                  "documentNumber":null,
                  "counteragentUid":"e0a79552-bcf4-4ca2-bb5b-961bd2c0f9a2"
               },
               "receiver":{
                  "opf":"ООО",
                  "opfUid":"0x92ee03691f25a9fe4be9910cd87ca9ca",
                  "name":"ООО \"ДД МЕДИКА\"",
                  "isPhysical":false,
                  "inn":"7710647612",
                  "documentType":null,
                  "documentSeries":null,
                  "documentNumber":null,
                  "counteragentUid":"b2763d61-e1b3-4c26-b46a-b3c95875a9c2"
               },
               "payer":{
                  "opf":null,
                  "opfUid":"0xa8123a457e644fe7435605b8f632f9d3",
                  "name":"ООО \"Анкоррес Электро\"",
                  "isPhysical":false,
                  "inn":"192644882",
                  "documentType":null,
                  "documentSeries":null,
                  "documentNumber":null,
                  "counteragentUid":"e0a79552-bcf4-4ca2-bb5b-961bd2c0f9a2"
               },
               "produceDate":null,
               "forwarderId":null,
               "comment":null,
               "fullDocumentId":null,
               "freight":{
                  "name":"Мебель",
                  "weight":2,
                  "oversizedWeight":0,
                  "volume":2.0,
                  "oversizedVolume":0.0,
                  "maxLength":0.0,
                  "maxWidth":0.0,
                  "maxHeight":0.0
               },
               "derival":{
                  "name":"Санкт-Петербург",
                  "code":"7800000000000000000000000"
               },
               "arrival":{
                  "name":"Москва",
                  "code":"7700000000000000000000000"
               },
               "barcode":null,
               "payment":false,
               "totalSum":"7644.0",
               "vat":"1171.33",
               "serviceKind":"Авто",
               "organization":"0x9efb0013cea09f3311dcd80f7091a6d0",
               "services":[
                  {
                     "name":"Экспедирование до клиента",
                     "serviceUid":"0xa191584309b83a6a4b5c253d4d6ec797",
                     "createdAt":"2020-10-01 11:52:05",
                     "quantity":1,
                     "sum":"1490.0",
                     "totalSum":"1490.0",
                     "vat":"248.30",
                     "vatRate":"20%",
                     "discountSum":"0.0"
                  }
               ],
               "accompanyingDocuments":[
                  
               ],
               "availableDocs":[
                  "order",
                  "bill"
               ],
               "paymentState":"not_paid"
            }
         ],
         "orderDatesAdditional": {
            "tracing": [
               {
                  "title": "Отбытие из ОСП",
                  "date": "2020-10-01",
                  "cityUID": "0x834f00112fdd658311da4c6326ef0e0e",
                  "cityName": "Волгоград",
                  "status": "inway"
               },
               {
                  "title": "Отбытие из ОСП",
                  "date": "2019-10-01",
                  "cityUID": "0x834f00112fdd658311da4c6326ef0e19",
                  "cityName": "Уфа",
                  "status": "inway"
               }
            ]
         },
         "detailedStatus":null,
         "detailedStatusRus":null,
         "paymentState":"not_paid",
         "note":null,
         "documentsReturnDate":null,
         "priceComment":"",
         "customerUid":"00000000-0000-0000-0000-000000000000"
      }
   ],
   "deleted":null
}
<response>
   <metadata>
      <status>200</status>
      <currentPage>1</currentPage>
      <nextPage />
      <prevPage />
      <totalPages>1</totalPages>
      <generatedAt>2020-10-01 13:24:54</generatedAt>
   </metadata>
   <orders>
      <orderNumber />
      <orderDate />
      <orderId>400275691</orderId>
      <orderedAt>2020-10-01 08:36:27</orderedAt>
      <state>inway</state>
      <stateName>Груз в пути</stateName>
      <stateDate>2020-10-01</stateDate>
      <progressPercent>15</progressPercent>
      <derival>
         <city>г. Санкт-Петербург</city>
         <cityId>1</cityId>
         <cityCode>7800000000000000000000000</cityCode>
         <address>190000, Санкт-Петербург г, Заневский пр-кт, дом № 1</address>
         <addressCode>7800000000004380000000000</addressCode>
         <terminalName>Санкт-Петербург Парнас</terminalName>
         <terminalAddress>194292, Санкт-Петербург г, 1-й Верхний пер, дом № 12, Литера Б</terminalAddress>
         <terminalId>1</terminalId>
      </derival>
      <arrival>
         <city>г. Москва</city>
         <cityId>3</cityId>
         <cityCode>7700000000000000000000000</cityCode>
         <address>127411, Москва г, Лобненская ул, дом № 18, стр 2</address>
         <addressCode>7700000000017250000000000</addressCode>
         <terminalName>Москва Север 2</terminalName>
         <terminalAddress>127411, Москва г, Лобненская ул, дом № 18, стр 2</terminalAddress>
         <terminalId>36</terminalId>
         <terminalCity>Москва</terminalCity>
         <terminalCoordinates>37.5192</terminalCoordinates>
         <terminalCoordinates>55.8967</terminalCoordinates>
         <terminalEmail>pismo@dellin.ru </terminalEmail>
         <terminalPhones>7 (495) 775-55-30</terminalPhones>
         <callCenterPhones>8-800-100-8000</callCenterPhones>
         <terminalWorktables>
            <sun>11:00-16:00</sun>
            <mon>08:00-22:00</mon>
            <tue>08:00-22:00</tue>
            <wed>08:00-22:00</wed>
            <thu>08:00-22:00</thu>
            <fri>08:00-22:00</fri>
            <sat>11:00-16:00</sat>
         </terminalWorktables>
      </arrival>
      <sender>
         <opf>
            <name>ООО</name>
            <fullName>Общество с Ограниченной Ответственностью</fullName>
            <countryCode>643</countryCode>
         </opf>
         <opfUid>0xa8123a457e644fe7435605b8f632f9d3</opfUid>
         <name>ООО "Анкоррес Электро"</name>
         <address>190000, Санкт-Петербург г, Заневский пр-кт, дом № 2</address>
         <isPhysical>false</isPhysical>
         <inn>192644882</inn>
         <documentType />
         <documentSeries />
         <documentNumber />
         <counteragentUid>e0a79552-bcf4-4ca2-bb5b-961bd2c0f9a2</counteragentUid>
         <contacts>Валерий</contacts>
         <phones>+7 (921) 333-22-22</phones>
      </sender>
      <receiver>
         <opf>
            <name>ООО</name>
            <fullName>Общество с Ограниченной Ответственностью</fullName>
            <countryCode>643</countryCode>
         </opf>
         <opfUid>0xa8123a457e644fe7435605b8f632f9d3</opfUid>
         <name>ООО "ДД МЕДИКА"</name>
         <address>127411, Москва г, Лобненская ул, дом № 12, стр 2</address>
         <isPhysical>false</isPhysical>
         <inn>7710647612</inn>
         <documentType />
         <documentSeries />
         <documentNumber />
         <counteragentUid>b2763d61-e1b3-4c26-b46a-b3c95875a9c2</counteragentUid>
         <anonym>false</anonym>
         <anonymPhone />
         <anonymEmail />
      </receiver>
      <payer>
         <opf>
            <name>ООО</name>
            <fullName>Общество с Ограниченной Ответственностью</fullName>
            <countryCode>643</countryCode>
         </opf>
         <opfUid>0xa8123a457e644fe7435605b8f632f9d3</opfUid>
         <name>ООО "Анкоррес Электро"</name>
         <isPhysical>false</isPhysical>
         <inn>192644882</inn>
         <documentType />
         <documentSeries />
         <documentNumber />
         <counteragentUid>e0a79552-bcf4-4ca2-bb5b-961bd2c0f9a2</counteragentUid>
      </payer>
      <freight>
         <name>Мебель</name>
         <weight>2.0</weight>
         <oversizedWeight>0.0</oversizedWeight>
         <volume>2.0</volume>
         <oversizedVolume>0.0</oversizedVolume>
         <places>1</places>
         <oversizedPlaces>0</oversizedPlaces>
         <length>0.0</length>
         <width>0.0</width>
         <height>0.0</height>
      </freight>
      <isAir>false</isAir>
      <air>
         <arrivalDate>2020-10-01</arrivalDate>
         <giveoutDate>2020-10-01</giveoutDate>
         <warehousingDate>2020-10-06</warehousingDate>
         <deliveryDate>2020-10-01</deliveryDate>
         <comment>комментарий</comment>
         <orderId>123-12312323</orderId>
      </air>
      <locks>
         <name>Долг</name>
         <type>by_payment</type>
         <setDate>2020-10-01 11:51:47</setDate>
         <endDate />
      </locks>
      <totalSum>7644.0</totalSum>
      <vat>1171.33</vat>
      <isPaid>false</isPaid>
      <isPreorder>false</isPreorder>
      <produceDate>2020-10-10</produceDate>
      <declineReason />
      <orderDates>
         <arrivalToOspReceiver>2020-10-14</arrivalToOspReceiver>
         <arrivalToOspReceiverMax />
         <arrivalToOspReceiverAccdoc />
         <arrivalToOspSender />
         <arrivalToReceiver />
         <declineDate />
         <derivalFromOspReceiver />
         <derivalFromOspReceiverMax />
         <derivalFromOspReceiverAccdoc />
         <giveoutFromOspReceiver />
         <giveoutFromOspReceiverMax />
         <derivalFromOspSender>2020-10-13 00:00:00</derivalFromOspSender>
         <draftLastUpdate />
         <finish />
         <firstDocumentCreatedDate>2020-10-01</firstDocumentCreatedDate>
         <pickup>2020-10-10 00:00:00</pickup>
         <processingDate />
         <warehousing />
      </orderDates>
      <orderTimeInDays>
         <delivery />
         <deliveryAccdoc />
      </orderTimeInDays>
      <orderedDeliveryFromAddress>true</orderedDeliveryFromAddress>
      <availableDeliveryFromAddress>false</availableDeliveryFromAddress>
      <orderedDeliveryToAddress>true</orderedDeliveryToAddress>
      <availableDeliveryToAddress>false</availableDeliveryToAddress>
      <isFavorite>false</isFavorite>
      <isContainer>false</isContainer>
      <sfrequest>
         <cityID>200555</cityID>
         <docNumber>20-00015100302</docNumber>
         <price>1490.0</price>
      </sfrequest>
      <documents>
         <id>400275691</id>
         <uid />
         <type>request</type>
         <createDate>2020-10-01 11:36:27</createDate>
         <state>accepted</state>
         <sender>
            <opf>ООО</opf>
            <opfUid>0xa8123a457e644fe7435605b8f632f9d3</opfUid>
            <name>Анкоррес Электро</name>
            <isPhysical>false</isPhysical>
            <inn>192644883</inn>
            <documentType />
            <documentSeries />
            <documentNumber />
            <counteragentUid />
         </sender>
         <receiver>
            <opf>ОАО</opf>
            <opfUid>0x8390b2048d37e0154b845fb22793e865</opfUid>
            <name>ДД-Мед</name>
            <isPhysical>false</isPhysical>
            <inn>7710647613</inn>
            <documentType />
            <documentSeries />
            <documentNumber />
            <counteragentUid />
         </receiver>
         <payer>
            <opf />
            <opfUid></opfUid>
            <name>Анкоррес Электро</name>
            <isPhysical />
            <inn>192644882</inn>
            <documentType />
            <documentSeries />
            <documentNumber />
            <counteragentUid />
         </payer>
         <produceDate>2020-10-10</produceDate>
         <forwarderId>00860733921</forwarderId>
         <comment>комментарий к отправке</comment>
         <fullDocumentId>K-400275691</fullDocumentId>
         <freight>
            <name>Мебель</name>
            <weight>0.1</weight>
            <oversizedWeight />
            <volume>0.1</volume>
            <oversizedVolume />
            <maxLength>0.1</maxLength>
            <maxWidth>0.1</maxWidth>
            <maxHeight>0.1</maxHeight>
         </freight>
         <derival>
            <name>Санкт-Петербург</name>
            <code>7800000000000000000000000</code>
         </derival>
         <arrival>
            <name>Москва</name>
            <code>7700000000000000000000000</code>
         </arrival>
         <barcode />
         <payment />
         <totalSum />
         <vat />
         <serviceKind />
         <organization />
      </documents>
      <documents>
         <id>20-00015100302</id>
         <uid>0x81f400505683df3d11eb03c3460a5915</uid>
         <type>shipping</type>
         <createDate>2020-10-01 14:51:09</createDate>
         <state>in way</state>
         <sender>
            <opf />
            <opfUid>0xa8123a457e644fe7435605b8f632f9d3</opfUid>
            <name>ООО "Анкоррес Электро"</name>
            <isPhysical>false</isPhysical>
            <inn>192644882</inn>
            <documentType />
            <documentSeries />
            <documentNumber />
            <counteragentUid>e0a79552-bcf4-4ca2-bb5b-961bd2c0f9a2</counteragentUid>
         </sender>
         <receiver>
            <opf>ООО</opf>
            <opfUid>0x92ee03691f25a9fe4be9910cd87ca9ca</opfUid>
            <name>ООО "ДД МЕДИКА"</name>
            <isPhysical>false</isPhysical>
            <inn>7710647612</inn>
            <documentType />
            <documentSeries />
            <documentNumber />
            <counteragentUid>b2763d61-e1b3-4c26-b46a-b3c95875a9c2</counteragentUid>
         </receiver>
         <payer>
            <opf />
            <opfUid>0xa8123a457e644fe7435605b8f632f9d3</opfUid>
            <name>ООО "Анкоррес Электро"</name>
            <isPhysical>false</isPhysical>
            <inn>192644882</inn>
            <documentType />
            <documentSeries />
            <documentNumber />
            <counteragentUid>e0a79552-bcf4-4ca2-bb5b-961bd2c0f9a2</counteragentUid>
         </payer>
         <produceDate />
         <forwarderId />
         <comment />
         <fullDocumentId />
         <freight>
            <name>Мебель</name>
            <weight>2</weight>
            <oversizedWeight>0</oversizedWeight>
            <volume>2</volume>
            <oversizedVolume>0</oversizedVolume>
            <maxLength>0</maxLength>
            <maxWidth>0</maxWidth>
            <maxHeight>0</maxHeight>
         </freight>
         <derival>
            <name>Санкт-Петербург</name>
            <code>7800000000000000000000000</code>
         </derival>
         <arrival>
            <name>Москва</name>
            <code>7700000000000000000000000</code>
         </arrival>
         <barcode />
         <payment>false</payment>
         <totalSum>7644</totalSum>
         <vat>1171.33</vat>
         <serviceKind>Авто</serviceKind>
         <organization>0x9efb0013cea09f3311dcd80f7091a6d0</organization>
         <services>
            <name>Экспедирование до клиента</name>
            <serviceUid>0xa191584309b83a6a4b5c253d4d6ec797</serviceUid>
            <createdAt>2020-10-01 11:52:05</createdAt>
            <quantity>1</quantity>
            <sum>1490.0</sum>
            <totalSum>1490.0</totalSum>
            <vat>248.30</vat>
            <vatRate>20%</vatRate>
            <discountSum>0.0</discountSum>
         </services>
         <availableDocs>order</availableDocs>
         <availableDocs>bill</availableDocs>
         <paymentState>not_paid</paymentState>
      </documents>
      <orderDatesAdditional>
         <tracing>
            <title>Отбытие из ОСП</title>
            <date>2020-10-01</date>
            <cityUID>0x834f00112fdd658311da4c6326ef0e0e</cityUID>
            <cityName>Волгоград</cityName>
            <status>inway</status>
         </tracing>
         <tracing>
            <title>Отбытие из ОСП</title>
            <date>2019-10-01</date>
            <cityUID>0x834f00112fdd658311da4c6326ef0e19</cityUID>
            <cityName>Уфа</cityName>
            <status>inway</status>
         </tracing>
      </orderDatesAdditional>
      <detailedStatus />
      <detailedStatusRus />
      <paymentState>not_paid</paymentState>
      <note />
      <documentsReturnDate />
      <priceComment>""</priceComment>
      <customerUid>00000000-0000-0000-0000-000000000000</customerUid>
   </orders>
   <deleted />
</response>

Description of parameters

If the data is not available (for example request.sessionID parameter is not passed in a request or the information is not available for the transportation type or the document type, etc.), then the response parameter value is null
Response
Response
ParameterTypeData available to unathorised usersDescription
metadataobjectYesSystem information
metadata.statusintegerYes

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

metadata.currentPageintegerYesNumber of the current page of the response
metadata.nextPageintegerYes

Number of the next page of the response

metadata.prevPageintegerYes

Number of the previous page of the response.

If the current page number is 1, then the parameter value is null

metadata.totalPagesintegerYesTotal amount of pages
metadata.generatedAtstringYes

Server response date and time.

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

ordersarray of OrdersYesArray of orders found
deletedarray of stringsYes

Array of deleted orders (the data is available if request.lastUpdate parameter is passed in a request)

Orders

Orders

ParameterType
Data available to unauthorized users
Description
orderNumberstringYesOnline store order number (internal order number)
orderDatestringYesOnline store order date
orderIDstringYesOrder number
orderedAtstringYesDate of order creation

state

stringYes

Order status in English, see Directory of order statuses

stateNamestringYesOrder status in Russian, see Directory of order statuses
stateDatestringYes

Date when the current status was set.

Format: YYYY-MM-DD.

If the order status is draft (the response parameter orders.state value is draft), then the parameter value is null

progressPercentintegerYesOrder completion (in percent). The parameter value can be used to visualize the progress of the order.
derivalDerivalArrivalPartially

Departure details

arrivalDerivalArrivalPartially

Arrival details

senderMemberNoSender details
receiverMemberNo

Receiver details

payerMemberNo

Payer details

freightFreightNo

Cargo details

isAirbooleanYesAir freight indicator
airobjectYes

Air freight details

If isAir parameter value is false, then the object parameters will not be passed in the response
air.arrivalDatestringYes

Cargo arrival date for air freight

air.giveoutDatestringYes

Cargo release date for air freight

air.warehousingDatestringYes

Paid storage start date for air freight

air.deliveryDatestringYes

Estimated cargo arrival date for air freight

air.commentstringNoAdditional information
air.orderIdstringYesAirway bill number
locksarray of LocksNoArray of lockouts
totalSumstringYesTotal amount
vatstringNoVAT
isPaidbooleanYesOrder payment status
isPreorderbooleanNoPre-order indicator
produceDatestringYes

Order completion date

The data is not available for Multishipping
declineReasonstringYes

Rejection reason

The data is available only if the order has been declined
orderDatesobjectYesEstimated cargo transportation schedule
orderDates.arrivalToOspReceiverstringYes

Date of cargo arrival at the terminal of arrival

orderDates.arrivalToOspReceiverMaxstringYes

The latest possible date of cargo arrival at the terminal of arrival (if cargo arrival can be delayed)

orderDates.arrivalToOspReceiverAccdocstringYes

Date of shipping documents arrival at the terminal of arrival

orderDates.arrivalToOspSenderstringYesDate of cargo arrival at the terminal of departure
orderDates.arrivalToReceiverstringYesDate of cargo delivery to the receiver's address
orderDates.declineDatestringYes

Rejection date

In some cases data may not be available
orderDates.derivalFromOspReceiverstringYesDate of cargo departure from the terminal of arrival
orderDates.derivalFromOspReceiverMaxstringYesThe latest possible date of cargo departure from the terminal of arrival (if cargo departure can be delayed)
orderDates.derivalFromOspReceiverAccdocstringYesDate of shipping documents departure from the terminal of arrival
orderDates.giveoutFromOspReceiverstringYes

Date when cargo is ready to be handed out at the terminal of arrival

orderDates.giveoutFromOspReceiverMaxstringYesThe latest possible date when cargo is ready to be handed out at the terminal of arrival (if the date can be delayed)
orderDates.derivalFromOspSenderstringYesDate of cargo departure from the terminal of departure
orderDates.draftLastUpdatestringYesDate of draft last update
orderDates.finishstringYesOrder completion date
orderDates.firstDocumentCreatedDatestringYes

Date when the first document was created

orderDates.pickupstringYes

Date of cargo pickup from the sender's address

orderDates.processingDatestringYes

Order processing start date

orderDates.warehousingstringYes

Paid storage start date

orderTimeInDaysobjectYes

Estimated delivery time (in days)

The data is available only if is_air parameter value is false. Otherwise, values of all the object parameters is null
orderTimeInDays.deliveryintegerYes

Estimated time of cargo delivery to the address (in days)

orderTimeInDays.deliveryAccdocintegerYes

Estimated time of shipping documents delivery to the address (in days)

orderedDeliveryFromAddressbooleanYes

Flag indicating that shipping from the sender's address is ordered

availableDeliveryFromAddressbooleanNoFlag indicating that shipping from the sender's address is available
orderedDeliveryToAddressbooleanYesFlag indicating that delivery to the receiver's address is ordered
availableDeliveryToAddressbooleanNoFlag indicating that delivery to the receiver's address is available
isFavoritebooleanNoFlag indicating that order is added to favorites
isContainerbooleanYesFlag indicating container shipping
sfrequestobjectYes

Details of order for delivery to the receiver's address

sfrequest.cityIDintegerYes

City ID, see Terminals directory

sfrequest.docNumberstringYesWaybill number
sfrequest.pricestringYesShipping cost
documentsDocumentsЧастичноArray of order documents
orderDatesAdditionalOrderDatesAdditionalYes

Information on the intermediate route points

The parameter is missing in the response if the order is declined or has been finished more that 24 hours ago (that is when "request.state" parameter value is "declined" or has changed to "finished" more that 24 ago)
detailedStatusstringYes

Detailed order status in English.

Possible values (the statuses order corresponds to the order of the possible values of "detailedStatusRus" parameter):

  • "pickup_waiting_pickup" - the driver has not yet departed to the sender's address;
  • "pickup_departed" - the driver departed to the sender's address;
  • "pickup_arrived" - the driver arrived to the sender's address;
  • "pickup_arrived_at_first" - the driver arrived to the first sender's address;
  • "pickup_arrived_at_last" - the driver arrived to the last sender's address;
  • "pickup_finished" - the driver has picked up the cargo from the sender's address and is heading to the terminal;
  • "delivery_waiting_delivery" - the driver has not yet departed to the receiver's address;
  • "delivery_departed" - the driver departed to the receiver's address;
  • "delivery_arrived"- the driver arrived to the receiver's address;
  • "delivery_finished" - the driver handed over the cargo at the receiver address
detailedStatusRusstringYes

Detailed order status in Russian.

Possible values (the statuses order corresponds to the order of the possible values of "detailedStatus" parameter):

  • "Ожидается забор";
  • "Машина едет на адрес";
  • "Машина на адресе";
  • "Прибыл на первый адрес";
  • "Прибыл на последний адрес";
  • "Груз забран. Едет на терминал";
  • "Ожидается доставка";
  • "Машина едет на адрес";
  • "Машина на адресе";
  • "Груз доставлен"
paymentStatestringYes

Payment status

Possible values:

  • paid;
  • not_paid;
  • in_process
notestringNoAdditional infromation
documentsReturnDatestringNoEstimated date of shipping documents return
priceCommentstringYes

A comment indicating that information about the order price is not available to the current user

customerUIDstringNo

UID of the requester on the order

The data is present in the response only if the user has full access to the counterparty (see Available counterparties method, response parameter "info.accessLevel")

DerivalArrival

DerivalArrival

ParameterTypeData available to unathorised users
Description
response.orders.derivalresponse.orders.arrival
citystringNoYes

City of cargo departure/arrival

cityIdintegerYesYesID of the city of departure/arrival
cityСodestringNoNo

City CLADR code (CLADR - Classifier of Addresses of the Russian Federation), see Places directory

addressstringNoNo

Address of the city of departure/arrival

addressCodestringNoNo

Street CLADR code, see Streets directory

terminalNamestringNoYes

Terminal name

terminalAddressstringNoYes

Terminal address

terminalIdintegerYesNoTerminal ID, see Terminals directory
terminalCitystring-Yes

City of storage terminal (1)

terminalCoordinatesarray of floats-Yes

Longitude and latitude of the storage terminal (1)

terminalEmailstring-Yes

Email of the storage terminal (1)

terminalPhonesstring-Yes

Storage terminal phone number (1)

callCenterPhonesstring-Yes

Call center phone number (1)

terminalWorktablesobject-Yes

Storage terminal workhours (1)

terminalWorktables.sunstringSunday workhours
terminalWorktables.monstringMonday workhours   
terminalWorktables.tuestringTuesday workhours
terminalWorktables.wedstringWednesday workhours
terminalWorktables.thustringThursday workhours
terminalWorktables.fristringFriday workhours 
terminalWorktables.satstringSaturday workhours

Notes:

  1. The parameter is used only for response.orders.arrival object

Member
The data is available only if sessionID parameter is passed in a request

Member

Parameter
Type
Description
opfobject

Organization legal form

The parameter is used only for "response.orders.sender", "response.orders.receiver" and "response.orders.payer" objects
opf.namestringShort legal form name
opf.fullNamestringFull legal form name
opf.countryCodeintegerCountry code
opfstring

Organization legal form (1)

The parameter is used only for "response.orders.documents.sender", "response.orders.documents.receiver" and "response.orders.documents.payer" objects
opfUidstring

UID of legal form of organization form, see Directory of legal forms of organization (1)

namestringCounterparty name 
addressstring

Counterparty address 

The parameter is used only for response.orders.sender, response.orders.receiver objects
isPhysicalboolean

Flag indicating individual (1)

innstring

TIN - taxpayer identification number (1)

documentTypestring

Personal ID for the individuals (1)

Possible values:

  • "Паспорт РФ" - passport of the Russian Federation;
  • "Загранпаспорт" - international passport;
  • "Водительское удостоверение" - driving license
documentSeriesstring

Individuals personal ID series (1)

documentNumberstring

Individuals personal ID number (1)

сounteragentUidstring

Counterparty UID

For response.orders.documents.sender, response.orders.documents.receiver, response.orders.documents.payer objects: the data is available only for waybills (response.orders.documents.type parameter value is shipping)
contactsstring

Sender's contact person name

The parameter is used only for response.orders.sender and response.orders.documents.sender objects.Note for response.orders.documents.sender object: data is available only for orders for shipping (response.orders.documents.type parameter value is request) and only in case of pre-order
phonesstring

Counterparty phone number

The parameter is used only for response.orders.sender object
anonymboolean

Indicator of an "anonymous" receiver (2)

anonymEmailstring

"Anonymous" receiver email (2)

anonymPhonestring

"Anonymous" receiver phone number (2)

Notes:

  1. Note for response.orders.documents.payer object: data is available only for orders for intercity transportation by dedicated truck (response.orders.documents.type parameter value is request_ftl).
  2. "Anonymous" receiver - a receiver on whom minimum info was provided.

    Delovye Linii company allows providing minimum information on the receiver - only name and phone number. In this case SMS with a code is sent to the phone number. The code is used to receive the goods. For more information see the description of Simplified Shipping service on Delovye Linii company website.

    The parameter is used only for response.orders.receiver object

Freight
The data is available only if sessionID parameter is passed in a request

Freight

ParameterTypeDescription
response.orders.freightresponse.orders.documents.freightresponse.orders.freightresponse.orders.documents.freight
namenamestringstringCargo name
weightweight

string

floatCargo weight, kg
oversizedWeightoversizedWeight

string

float
Weight of the oversized cargo places, kg
volumevolume

string

floatCargo volume, m3
oversizedVolumeoversizedVolume

string

floatVolume of oversized cargo places, m3
places-integer-

Qantity of cargo places

oversizedPlaces-integer-

Qantity of oversized cargo places

lengthmaxLengthstringfloat

Cargo length, m

widthmaxWidthstringfloat

Cargo width, m

heightmaxHeightstringfloat

Cargo height, m

Notes:

  1. An oversized cargo place is a cargo place with weight greater than or equal to 100 kg (80 kg in case of air transportation) or with at least one of the dimensions (LWH) greater than or equal to 3 m (80 сm in case of air transportation)

Locks
The data is available only if sessionID parameter is passed in a request

Locks

Parameter
Type
Description
namestringLockout name
typestringLockout name
setDatestringLockout start date
endDatestringLockout end date

Documents

Documents

Parameter
Type
Data available to unathorised users
Description
idintegerYesDocument number
uidstringYes

Waybill UID (1)

typestringYes

Document type

Possible values:

  • shipping - waybill;
  • request - order for shipping (from the sender's address or from the terminal);
  • request_sf - order for delivery to the receiver's address (from the terminal);
  • "request_ftl" - order for intercity transportation by dedicated truck
createDatestringYes

Date of document creation

statestringYes

Document status

Order for shipping from the sender's address/delivery to the receiver's address/intercity transportation by dedicated truck (response.orders.documents.type parameter value is request/request_sf/request_ftl) statuses:

  • "temporary" - the document is not filled;
  • "saved" - draft;
  • "ordered" - the order is in queue for processing;
  • "loaded" - the order is being processed;
  • "processed" - the order has been processed;
  • "declined" - the order has been declined;
  • "accepted" - the order has been accepted;
  • "canceled" - the order has been accepted.

Waybill (response.orders.documents.type parameter value is shipping) statuses:

  • "in_way" - the cargo is on the way;
  • "arrival" - the cargo is has arrived;
  • "give_out" - the cargo is given out
senderMemberNo

Sender details (2)

receiverMemberNo

Receiver details (2)

payerMemberNoPayer details
produceDatestringYes

Order completion date (3)

forwarderIdstringNo

Forwarding agent order number (3)

commentstringNo

Additional information on the documents (3)

fullDocumentIdstringYes

Full document number (3)

freightFreightNo

Cargo details (4)

derivalobjectYes

Information about the place of departure (4)

derival.namestringYes

City (4)

derival.codestringYes

City CLADR code, see Places directory (4)

arrivalobjectYes

Information about the place of arrival (4)

arrival.namestringYes

City (4)

arrival.codestringYes

City CLADR code, see Places directory (4)

barcodestringNo

Barcode according to Code 128 algorithm (for pre-order)

paymentbooleanYes

Payment status (1)

totalSumstringYes

Total amount on the waybill (1)

vatstringNoVAT (1)
serviceKindstringYes

Transportation type (1)

organizationstringNo

Organization ID (1)

servicesarray of ServicesPartially

List of services as per the waybill (1)

accompanyingDocumentsarray of AcDocsNo

List of the shipping documents (1)

availableDocsarray of stringsNo

List of the documents for which printable versions are available (1)

paymentStatestringYes

Shipping documents payment status in English (1)

Possible values:

  • paid;
  • not_paid;
  • in_process

Notes:

  1. The data is available only for waybills (response.orders.documents.type parameter value is shipping).
  2. The data is not available for orders for intercity transportation by dedicated truck (response.orders.documents.type parameter value is request_ftl).
  3. The data is available only for orders for shipping (in case delivery from the sender's address/to the receiver's address is ordered)/orders for delivery to the receiver's address from the terminal (response.orders.documents.type parameter value is request/request_sf).
  4. The data is available only for orders for shipping (from the sender's address/from the terminal)/waybills (response.orders.documents.type parameter value is request/shipping)

Services
All the data except for the response.orders.documents.services.name parameter is available only if sessionID parameter is passed in a request
Services
Parameter
Type
Description
namestringService name
serviceUidstringService UID
createdAtstringCreation date
quantityintegerQuantity
sumstringAmount
totalSumstringTotal amount
vatstringVAT
vatRatestringVAT rate, if VAT is not applied, then the paramter value is "БЕЗ НДС" (VAT excempt)
discountSumstringDiscount

AcDocs
AcDocs
ParameterType
Description
documentDatestringShipping document creation date
documentNumberstringShipping document number
documentKindstringComment (document type)

OrderDatesAdditional

OrderDatesAdditional

ParameterTypeDescription

tracing

array of TracingList of intermediate route points. 10 elements in the array maximum. If more than 10 points are found, data of the 10 latest points is passed in the response

tracing.title

stringThe event the date of which is passed in the "tracing.date" parameter. The value is always "Отбытие из ОСП" (leaving the terminal)

tracing.date

string

Date when the cargo passes the route point.

Date format: YYYY-MM-DD

tracing.cityUID

stringUID of the City (intermediate route point)

tracing.cityName

stringCity (intermediate route point)

tracing.status

string

The status of the order when cargo passes the route point. The value is always "inway" (see "Directory of order statuses")

Error handling

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

Error numberhttp-codeError titleError description
TitleTranslationDescriptionTranslation

718001

400Найдено более одного заказаMore than one order foundВоспользуйтесь расширенным поискомUse advanced search

717001

400Заказ не найденOrder not foundЗаказ [номер заказа] не найденOrder [order number] not found

717002

400Неизвестный статус заказаUnknown order statusДетальное описание ошибки содержит номера заказов с неизвестным статусомDetailed error description contains the list of numbers of orders with unknown status