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

API
Главная / API - Order tracker

Order tracker

Обновлено 13.09.2018
107 кб

General information

This service allows you to get information about the order by its number or number of the waybill or claim.

Searching the order by number of the order, waybill or claim

Method request

Request example

Method address: https://api.dellin.ru/v2/public/tracker.json

{  
   "appkey":"00000000-0000-0000-000000000000",
   "docid":"63763576"
}

Method address: https://api.dellin.ru/v2/public/tracker.xml

<request>
   <appkey>00000000-0000-0000-000000000000</appkey>
   <docid>63763576</docid>
</request>

Description of parameters

Request
ParameterR*TypeDescription
appkeyYesstring

Application key. To get the key, register

docidYesstringNumber of the order, waybill or claim

Method response

Example below contains a complete list of parameters, regardless of the order status. The last column of the table with description of parameters (below) contains infrormation about the statuses of the order for which corresponding parameters are actually displayed.

Response example

{  
   "order_id":123456,
   "ordered_at":"2017-01-16 11:20:05",
   "is_container":true,
   "state":"processing",
   "state_name":"В обработке",
   "derival_city":"Омск",
   "arrival_city":"Самара",
   "decline_reason":"Опасный груз",
   "sf_request_ordered":false,
   "sfrequest":{  
      "price":"500",
      "cityID":234,
      "docNumber":"16-123456789"
   },
   "derival_city_id":8,
   "derival_terminal_id":53,
   "arrival_contact_id":15,
   "arrival_city_id":21,
   "arrival_cc_phones":"8-800-100-8000",
   "arrival_terminal_address":"Внуковская, д.2",
   "arrival_terminal_phones":"7 (812) 448-88-88",
   "arrival_terminal_email":"pismo@dellin.ru",
   "arrival_terminal_coordinates":["30.311464","59.805924"],
   "worktables":{  
      "mon":"9:00-18:00",
      "tue":"9:00-18:00",
      "wed":"9:00-18:00",
      "thu":"9:00-18:00",
      "fri":"9:00-18:00",
      "sat":"9:00-15:00",
      "sun":"-"
   },
   "air_order_id":123456,
   "is_air":false,
   "comment":"комментарий",
   "blocked_by_payment":false,
   "blocked_by_blacklist":false,
   "order_dates":{  
      "finish":"2017-03-30",
      "arrival_to_receiver":"2017-03-30",
      "arrival_to_osp_sender":"2017-03-30",
      "arrival_to_osp_receiver_accdoc":"2017-03-30",
      "first_document_created_date":"2017-03-30",
      "draft_last_update":"2017-03-30",
      "derival_from_osp_sender":"2017-03-29",
      "derival_from_osp_receiver_accdoc":"2017-03-30",
      "arrival_to_osp_receiver":"2017-03-30",
      "processing_date":"2017-03-25",
      "derival_from_osp_receiver":"2017-03-30",
      "warehousing":"2017-03-30",
      "decline_date":"2017-03-30",
      "pickup":"2017-03-28"
   },
   "order_time_in_days":{  
      "delivery":0,
      "delivery_accdoc":null
   }
}
<response>
   <order_id>123456</order_id>
   <ordered_at>2017-01-16 11:20:05</ordered_at>
   <is_container>true</is_container>
   <state>processing</state>
   <state_name>В обработке</state_name>
   <derival_city>Омск</derival_city>
   <arrival_city>Самара</arrival_city>
   <decline_reason>Опасный груз</decline_reason>
   <sf_request_ordered>false</sf_request_ordered>
   <sfrequest>
      <price>500</price>
      <cityID>234</cityID>
      <docNumber>16-123456789</docNumber>
   </sfrequest>
   <derival_city_id>8</derival_city_id>
   <derival_terminal_id>53</derival_terminal_id>
   <arrival_contact_id>15</arrival_contact_id>
   <arrival_city_id>21</arrival_city_id>
   <arrival_cc_phones>8-800-100-8000</arrival_cc_phones>
   <arrival_terminal_address>Внуковская, д.2</arrival_terminal_address>
   <arrival_terminal_phones>7 (812) 448-88-88</arrival_terminal_phones>
   <arrival_terminal_email>pismo@dellin.ru</arrival_terminal_email>
   <arrival_terminal_coordinates>30.311464</arrival_terminal_coordinates>
   <arrival_terminal_coordinates>59.805924</arrival_terminal_coordinates>
   <worktables>
      <mon>9:00-18:00</mon>
      <tue>9:00-18:00</tue>
      <wed>9:00-18:00</wed>
      <thu>9:00-18:00</thu>
      <fri>9:00-18:00</fri>
      <sat>9:00-15:00</sat>
      <sun>-</sun>
   </worktables>
   <air_order_id>123456</air_order_id>
   <is_air>false</is_air>
   <comment>комментарий</comment>
   <blocked_by_payment>false</blocked_by_payment>
   <blocked_by_blacklist>false</blocked_by_blacklist>
   <order_dates>
      <finish>2017-03-30</finish>
      <arrival_to_receiver>2017-03-30</arrival_to_receiver>
      <arrival_to_osp_sender>2017-03-30</arrival_to_osp_sender>
      <arrival_to_osp_receiver_accdoc>2017-03-30</arrival_to_osp_receiver_accdoc>
      <first_document_created_date>2017-03-30</first_document_created_date>
      <draft_last_update>2017-03-30</draft_last_update>
      <derival_from_osp_sender>2017-03-29</derival_from_osp_sender>
      <derival_from_osp_receiver_accdoc>2017-03-30</derival_from_osp_receiver_accdoc>
      <arrival_to_osp_receiver>2017-03-30</arrival_to_osp_receiver>
      <processing_date>2017-03-25</processing_date>
      <derival_from_osp_receiver>2017-03-30</derival_from_osp_receiver>
      <warehousing>2017-03-30</warehousing>
      <decline_date>2017-03-30</decline_date>
      <pickup>2017-03-28</pickup>
   </order_dates>
   <order_time_in_days>
      <delivery>0</delivery>
      <delivery_accdoc />
   </order_time_in_days>
</response>

Description of parameters

Response
ParameterTypeDescriptionOrder statuses
order_idstringOrder numberAll
ordered_atstringDate of issue of the orderAll
is_containerbooleanFlag of container shippingAll
statestring

Status (in English)

All
state_namestringStatus (in Russian)All
derival_citystringCity of the senderAll, except "draft"
arrival_citystringCity of the receiverAll, except "draft"
decline_reasonstringReason for rejection"declined"
sf_request_orderedboolean

Flag meaning that delivery to the address is ordered

  • "pickup"
  • "waiting"
  • "received"
  • "received_warehousing"
  • "inway"
  • "arrived"
  • "warehousing"

sfrequest

object

Information about the order of delivery to the receiver's address

  • "pickup" *
  • "received" *
  • "received_warehousing" *
  • "inway" *
  • "arrived" *
  • "warehousing" *

* if the waybill exists and delivery to the address is available

sfrequest.pricestringCostSee object "sfrequest"
sfrequest.cityIDstringCity ID from the "Terminals" directorySee object "sfrequest"
sfrequest.docNumberstringWaybill numberSee object "sfrequest"
derival_city_idinteger

ID of the city of departure from the "Places" directory

"waiting"

derival_terminal_idinteger

ID of the terminal of departure from the "Terminals" directory

"waiting"

arrival_contact_id
integer

ID of the contact person at the terminal of arrival from the "Terminals" directory

  • "received"
  • "received_warehousing"
  • "arrived"
  • "warehousing"
arrival_city_idinteger

ID of the city of arrival from the "Places" directory

Similar to the parameter "arrival_contact_id"
arrival_cc_phonesstringCall center phone numberSimilar to the parameter "arrival_contact_id"
arrival_terminal_addressstringAddress of the storage terminalSimilar to the parameter "arrival_contact_id"
arrival_terminal_phonesstringPhone number of the storage terminalSimilar to the parameter "arrival_contact_id"
arrival_terminal_emailstringE-mail of the storage terminalSimilar to the parameter "arrival_contact_id"
arrival_terminal_coordinatesarray of stringLongitude and latitude of the storage terminalSimilar to the parameter "arrival_contact_id"
worktablesobjectTimetable of the storage terminalSimilar to the parameter "arrival_contact_id"
worktables.monstringMonday timetableSimilar to the parameter "arrival_contact_id"
worktables.tuestringTuesday timetableSimilar to the parameter "arrival_contact_id"
worktables.wedstringWednesday timetableSimilar to the parameter "arrival_contact_id"
worktables.thustringThursday timetableSimilar to the parameter "arrival_contact_id"
worktables.fristringFriday timetableSimilar to the parameter "arrival_contact_id"
worktables.satstringSatureday timetableSimilar to the parameter "arrival_contact_id"
worktables.sunstringSunday timetableSimilar to the parameter "arrival_contact_id"
air_order_idintegerAir waybill number
  • "arrived_to_airport"
  • "airport_warehousing"
is_airbooleanFlag of air transportationAll
commentstringComment
  • "arrived_to_airport"
  • "airport_warehousing"
blocked_by_paymentbooleanFlag of blocking the cargo because of payment problems

All, except:

  • "draft"
  • "processing"
  • "finished"
blocked_by_blacklistboolean

Flag of unpreparedness the cargo to delivery. If the value is "true" then you need to consult with the specialists

  • "arrived"
  • "warehousing"
order_datesobjectThe estimated schedule of cargo movement (only if parameter "is_air" = "false". Otherwise, values of all parameters of this object will contain "null")All
order_dates.finishstringDate of order executionAll
order_dates.arrival_to_receiverstring

Date of the cargo delivery to the address

All
order_dates.arrival_to_osp_senderstring

Date of the cargo arrival at a separate structural subdivision of departure

All
order_dates.arrival_to_osp_receiver_accdocstring

Date of the shipping documents arrival at the terminal of arrival

All
order_dates.first_document_created_datestring

Date of creation of the first document by the order

All
order_dates.draft_last_updatestringDate of the draft last updateAll
order_dates.derival_from_osp_senderstring

Date of the cargo departure from the terminal of departure

All
order_dates.derival_from_osp_receiver_accdocstring

Date of the shipping documents departure from the terminal of arrival

All
order_dates.arrival_to_osp_receiverstring

Date of the cargo arrival at the terminal of arrival

All
order_dates.processing_datestring

Order processing start date

All
order_dates.derival_from_osp_receiverstring

Date of the cargo departure from the terminal of arrival

All
order_dates.warehousingstringPaid storage start dateAll
order_dates.decline_datestringRejection dateAll
order_dates.pickupstring

Date of cargo pickup from the sender's address

All
order_time_in_daysobject

Estimated delivery time (in days) (only if parameter "is_air" = "false". Otherwise, values of all parameters of this object will contain "null")

All
order_time_in_days.deliveryinteger

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

All
order_time_in_days.delivery_accdocinteger

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

All

There are the following order statuses in the system:

Order statuses
In EnglishIn Russian
draftЧерновик
processingВ обработке
pickupЗабор груза от адреса
waitingОжидает сдачи на терминал
declinedОтклонен

received

received_warehousing

Груз принят к перевозке
inwayГруз в пути

arrived

warehousing

Груз прибыл на терминал

arrived_to_airport

airport_warehousing

Груз прибыл в аэропорт
deliveryДоставка груза до адреса
accompanying_documents_returnВозврат сопроводительных документов
finishedЗаказ завершен

Error handling

If the number of the order or the waybill is not passed, then response will be the following. (Error description in example below: "required".)

Response example

{  
   "errors":{  
      "docid":"Требуется"
   }
}
<response>
   <errors>
      <docid>Требуется</docid>
   </errors>
</response>

If the order is not fount, the message will be the following. (Error description in example below: "The order is not found".)

{  
   "errors":{  
      "docid":"Заказ не найден"
   }
}
<response>
   <errors>
      <docid>Заказ не найден</docid>
   </errors>
</response>