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

API
Главная / API - Поиск заказа по неполным данным

Поиск заказа по неполным данным

Обновлено 14.09.2017
94 кб

Общие сведения

Сервис позволяет осуществлять поиск накладных, используя следующие данные: ИНН (для юридических лиц), тип и номер документа (для физических лиц), маршрут перевозки и время выполнения заказа.

Поиск заказа по неполным данным

Запрос метода

Пример запроса

Адрес метода: https://api.dellin.ru/v1/public/tracker_advanced.json

{  
   "appkey":"00000000-0000-0000-000000000000",
   "sender":{  
      "inn":"7122963715",
      "doc_type":"passport",
      "doc_series":"4007",
      "doc_number":"451735",
      "terminal":"7800000000000000000000000"
   },
   "receiver":{  
      "inn":"4516374515",
      "doc_type":"foreignPassport",
      "doc_series":"4008",
      "doc_number":"236782",
      "terminal":"7700000000000000000000000"
   },
   "date_start":"2015-08-10",
   "date_end":"2015-08-17"
}

Адрес метода: https://api.dellin.ru/v1/public/tracker_advanced.xml

<request>
   <appkey>00000000-0000-0000-000000000000</appkey>
   <sender>
      <inn>7122963715</inn>
      <doc_type>passport</doc_type>
      <doc_series>4007</doc_series>
      <doc_number>451735</doc_number>
      <terminal>7800000000000000000000000</terminal>
   </sender>
   <receiver>
      <inn>4516374515</inn>
      <doc_type>foreignPassport</doc_type>
      <doc_series>4008</doc_series>
      <doc_number>236782</doc_number>
      <terminal>7700000000000000000000000</terminal>
   </receiver>
   <date_start>2015-08-10</date_start>
   <date_end>2015-08-17</date_end>
</request>

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

Request
ПараметрR*ТипОписание
appkeyДаstringКлюч приложения. Для получения ключа необходимо пройти регистрацию

sender

Нетobject

Информация об отправителе

sender.inn

Нетstring

ИНН (для юридических лиц)

sender.doc_typeНетstring

Тип документа (для физических лиц)

Доступные варианты:

  • "passport" - паспорт
  • "foreignPassport" - загран. паспорт
  • "drivingLicence" - вод. удостоверение
sender.doc_seriesНетstring

Серия документа (для физических лиц)

sender.doc_numberНетstring

Номер документа (для физических лиц)

sender.terminalНетstringКод КЛАДР пункта отправления
receiverНетobject

Информация о получателе

Параметры объекта "receiver" аналогичны параметрам объекта "".(Параметр "terminal" объекта "receiver" - Код КЛАДР пункта назначения.)
date_startНетstring

Начальная дата периода выполнения заказа.

Формат: "ГГГГ-ММ-ДД"

date_endНетstring

Конечная дата периода выполнения заказа.

Формат: "ГГГГ-ММ-ДД"

Интервал между начальной и конечной датами периода не должен превышать 7 дней.

Ответ метода

Пример ответа

{  
   "errormsg":"",
   "orders":{  
      "tracker":[  
         {  
            "availableAD":"false",
            "estimatedDeliveryDate":"2015-05-21T00:00:00",
            "terminalSender":"0x80d0001a649655bf11dd057a4f07b2de",
            "unvailableSfRequestReason":"0",
            "isSfRequestOrdered":"false",
            "citySender":"",
            "availableSfRequest":"true",
            "opf":"Юридическое лицо",
            "terminalReceiver":"0x832e001a64d37be411de7cd04f8b8b1a",
            "cityReceiver":"",
            "order":{  
               "docNumber":"15-00315007322",
               "comment":"",
               "sizedWeight":"0",
               "ordNum":"",
               "sizedVolume":"0",
               "docDate":"2015-05-18T22:01:31",
               "sqlUuid":"0x8861abd4de1048e14f9a02974fff2696",
               "height":"0",
               "width":"0",
               "length":"0",
               "aviaDeliveryType":"",
               "numAvia":"",
               "giveoutDate":"0001-01-01",
               "conditionAvia":"",
               "oversizedVolume":"0",
               "oversizedWeight":"0"
            },
            "condition":"ГРУЗ В ПУТИ"
         },
         {  
            "availableAD":"false",
            "estimatedDeliveryDate":"2015-05-21T00:00:00",
            "terminalSender":"0x80d0001a649655bf11dd057a4f07b2de",
            "unvailableSfRequestReason":"0",
            "isSfRequestOrdered":"false",
            "citySender":"",
            "availableSfRequest":"true",
            "opf":"Юридическое лицо",
            "terminalReceiver":"0x832e001a64d37be411de7cd04f8b8b1a",
            "cityReceiver":"",
            "order":{  
               "docNumber":"15-00313023545",
               "comment":"",
               "sizedWeight":"88",
               "ordNum":"",
               "sizedVolume":"0.14",
               "docDate":"2015-05-18T21:57:01",
               "sqlUuid":"0xb749d008e4373fd74b3d26f48d88eb8f",
               "height":"0",
               "width":"0",
               "length":"0",
               "aviaDeliveryType":"",
               "numAvia":"",
               "giveoutDate":"0001-01-01",
               "conditionAvia":"",
               "oversizedVolume":"0",
               "oversizedWeight":"0"
            },
            "condition":"ГРУЗ В ПУТИ"
         }
      ]
   }
}
<response>
   <errormsg></errormsg>
   <orders>
      <tracker>
         <availablead>false</availablead>
         <estimateddeliverydate>2015-05-21T00:00:00</estimateddeliverydate>
         <terminalsender>0x80d0001a649655bf11dd057a4f07b2de</terminalsender>
         <unvailablesfrequestreason>0</unvailablesfrequestreason>
         <issfrequestordered>false</issfrequestordered>
         <citysender></citysender>
         <availablesfrequest>true</availablesfrequest>
         <opf>Юридическое лицо</opf>
         <terminalreceiver>0x832e001a64d37be411de7cd04f8b8b1a</terminalreceiver>
         <cityreceiver></cityreceiver>
         <order>
            <docnumber>15-00315007322</docnumber>
            <comment></comment>
            <sizedweight>0</sizedweight>
            <ordnum></ordnum>
            <sizedvolume>0</sizedvolume>
            <docdate>2015-05-18T22:01:31</docdate>
            <sqluuid>0x8861abd4de1048e14f9a02974fff2696</sqluuid>
            <height>0</height>
            <width>0</width>
            <length>0</length>
            <aviadeliverytype></aviadeliverytype>
            <numavia></numavia>
            <giveoutdate>0001-01-01</giveoutdate>
            <conditionavia></conditionavia>
            <oversizedvolume>0</oversizedvolume>
            <oversizedweight>0</oversizedweight>
         </order>
         <condition>ГРУЗ В ПУТИ</condition>
      </tracker>
      <tracker>
         <availablead>false</availablead>
         <estimateddeliverydate>2015-05-21T00:00:00</estimateddeliverydate>
         <terminalsender>0x80d0001a649655bf11dd057a4f07b2de</terminalsender>
         <unvailablesfrequestreason>0</unvailablesfrequestreason>
         <issfrequestordered>false</issfrequestordered>
         <citysender></citysender>
         <availablesfrequest>true</availablesfrequest>
         <opf>Юридическое лицо</opf>
         <terminalreceiver>0x832e001a64d37be411de7cd04f8b8b1a</terminalreceiver>
         <cityreceiver></cityreceiver>
         <order>
            <docnumber>15-00313023545</docnumber>
            <comment></comment>
            <sizedweight>88</sizedweight>
            <ordnum></ordnum>
            <sizedvolume>0.14</sizedvolume>
            <docdate>2015-05-18T21:57:01</docdate>
            <sqluuid>0xb749d008e4373fd74b3d26f48d88eb8f</sqluuid>
            <height>0</height>
            <width>0</width>
            <length>0</length>
            <aviadeliverytype></aviadeliverytype>
            <numAvia></numAvia>
            <giveoutdate>0001-01-01</giveoutdate>
            <conditionavia></conditionavia>
            <oversizedvolume>0</oversizedvolume>
            <oversizedweight>0</oversizedweight>
         </order>
         <condition>ГРУЗ В ПУТИ</condition>
      </tracker>
   </orders>
</response>

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

Response
ПараметрТипОписание
errormsgstringСообщение об ошибке в случае неверного запроса (см. раздел "Обработка ошибок")
ordersobjectИнформация о найденных заказах
orders.trackerarray of Response.Order.TrackerМассив найденных заказов

Response.Order.Tracker
ПараметрТипОписание
availableADstring
estimatedDeliveryDatestringРасчетная дата доставки
terminalSenderstringТерминал-отправитель
unvailableSfRequestReasonstringПричина недоступности доставки до адреса получателя
isSfRequestOrderedstringФлаг, обозначающий что заказана доставка до адреса получателя
citySenderstringГород отправителя
availableSfRequeststringФлаг, обозначающий что возможна доставка до адреса получателя
opfstringОПФ
terminalReceiverstringТерминал-получатель
cityReceiverstringГород получателя
orderobjectИнформация о заказе
order.docNumberstringНомер заказа
order.commentstringКомментарий
order.sizedWeightstringВес груза
order.ordNumstringНомер заказа
order.sizedVolumestringОбъем груза
order.docDatestringДата заказа
order.sqlUuidstring
order.heightstringВысота груза
order.widthstringШирина груза
order.lengthstringДлина груза
order.aviaDeliveryTypestringТип авиадоставки
order.numAviastring
order.giveoutDatestringДата выдачи груза
order.conditionAviastring
order.oversizedVolumestringНегабаритный объем
order.oversizedWeightstringНегабаритный вес
conditionstringСтатус заказа

Обработка ошибок

Если по переданным данным найдено более 5 накладных, Вы получите следующий ответ: 

Пример ответа

{
   "errormsg": "Уточните параметры поиска",
   "orders": ""
}
<response>
   <errormsg>Уточните параметры поиска</errormsg>
   <orders></orders>
</response>

При ошибке передачи данных участника перевозки вернётся ответ:

Пример ответа

{
   "errormsg": "Данные участника перевозки введены неверно",
   "orders": ""
}
<response>
   <errormsg>Данные участника перевозки введены неверно</errormsg>
   <orders></orders>
</response>

Если данные одного из участников перевозки не найдены, ответ будет следующего вида:

Пример ответа

{
   "errormsg": "Не найден участник перевозки по указанным данным (sender)",
   "orders": ""
}
<response>
   <errormsg>Не найден участник перевозки по указанным данным (sender)</errormsg>
   <orders></orders>
</response>

При недостаточности обязательных параметров в запросе вернется ответ:

Пример ответа

{
   "errors":{
      "orders":"Ошибка в параметрах запроса"
   }
}
<response>
   <errors>
      <orders>Ошибка в параметрах запроса</orders>
   </errors>
</response>