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

API
Главная / API - Журнал заказов

Журнал заказов

Обновлено 25.01.2024
315 кб

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

Сервис позволяет получать актуальную информацию о заказах, используя номер заказа компании "Деловые Линии", номер накладной или заявки, внутренний номер заказа интернет-магазина или штрих-код документа. Авторизованные пользователи при помощи данного метода также могут получить журнал отправок личного кабинета, в том числе актуальные статусы заказов, заявок и накладных.

Для идентификации состава ответа используется входящий параметр "request.sessionID". Если в запросе присутствует параметр, то в ответе будут переданы подробные данные, если нет - краткая информация. Таким образом, подробная информация по заказам доступна только для авторизованных пользователей. 

Журнал заказов

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

Структура запроса

Адрес метода: 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",
   "cargoPlaces":[
      "3252235"
   ], 
   "shipmentLabelCargoPlace":"Артикул1223657",
   "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
}

Адрес метода: 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>
   <cargoPlaces>3252235</cargoPlaces>
   <shipmentLabelCargoPlace>Артикул1223657</shipmentLabelCargoPlace>
   <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>

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

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

sessionID

Нет*string

ID сессии. Для получения сессии необходимо воспользоваться сервисом "Авторизация пользователя".

*Если запрос содержит параметр, то в ответе будут переданы подробные данные, если нет - краткая информация

docIdsНет*array of strings

Номер заказа, накладной или заявки. Возможна передача нескольких параметров. Максимум может быть передано 5 значений.

*Параметр используется для поиска заказа. Если в запросе отсутствует параметр "sessionID", то в нём должен присутствовать один из следующих параметров: "docIds", "orderNumber" или "barcode"

В запросе может быть передан только один из параметров: "docIds", "orderNumber", "barcode", "cargoPlaces", "shipmentLabelCargoPlace"
orderNumberНет*string

Номер заказа интернет-магазина (внутренний номер заказа, ВНЗ).

*Параметр используется для поиска заказа. Если в запросе отсутствует параметр "sessionID", то в нём должен присутствовать один из следующих параметров: "docIds", "orderNumber" или "barcode"

В запросе может быть передан только один из параметров: "docIds", "orderNumber", "barcode", "cargoPlaces", "shipmentLabelCargoPlace"
orderDateНетstring

Дата заказа интернет-магазина.

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

barcode

Нет*string

Штрих-код, считанный сканером.

Для поиска заказа могут быть использованы следующие штрих-коды:

  • штрих-код накладной;
  • штрих-код накладной экспедитора (документ используется водителем-экспедитором при получении груза на адресе отправителя);
  • штрих-код заявки на доставку груза, оформленной при размещении предзаказа;
  • штрих-код, считанный с этикетки на грузе (код документа "Накладная" с указанием грузоместа).

*Параметр используется для поиска заказа. Если в запросе отсутствует параметр "sessionID", то в нём должен присутствовать один из следующих параметров: "docIds", "orderNumber" или "barcode"

В запросе может быть передан только один из параметров: "docIds", "orderNumber", "barcode", "cargoPlaces", "shipmentLabelCargoPlace"
cargoPlacesНет*array of strings

Массив номеров грузовых мест.

*Параметр используется для поиска заказа авторизованными пользователями (может быть передан, только если в запросе присутствует параметр "sessionID").

В запросе может быть передан только один из параметров: "docIds", "orderNumber", "barcode", "cargoPlaces", "shipmentLabelCargoPlace"
Поиск производится только по первому значению, переданному в массиве
shipmentLabelCargoPlaceНет*string

Артикул грузового места.

*Параметр используется для поиска заказа авторизованными пользователями (может быть передан, только если в запросе присутствует параметр "sessionID").

Чтобы иметь возможность искать заказы по артикулу грузового места, необходимо сначала передать информацию о грузовых местах при помощи метода "Передача артикулов грузовых мест".

Пользователи с ограниченным доступом могут осуществлять поиск только по тем заказам, где они выступают в роли заказчика, пользователи с полным доступом - по всем заказам, независимо от роли (подробнее о доступе см. метод "Список контрагентов", описание параметра ответа "info.accessLevel").

Если заказана доставка груза от адреса отправителя и груз ещё не был принят к перевозке на терминале компании, то информация по грузу доступна только тому пользователю, который оформил заказ

В запросе может быть передан только один из параметров: "docIds", "orderNumber", "barcode", "cargoPlaces", "shipmentLabelCargoPlace"
dateStartНетstring

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

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

Значение параметра учитывается, только если в запросе есть параметр "sessionID", но нет параметров "docIds", "orderNumber", "barcode", "cargoPlaces" или "shipmentLabelCargoPlace"

dateEndНетstring

Конечная дата и время периода (для фильтрации результатов поиска по периоду создания заказа. Учитывается при указании параметра "dateStart").

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

Значение параметра учитывается, только если в запросе есть параметр "sessionID", но нет параметров "docIds", "orderNumber", "barcode", "cargoPlaces" или "shipmentLabelCargoPlace"

statesНетarray of strings

Список статусов, заказы с которыми надо получить в ответе. Статусы указываются на основании "Справочника статусов заказа груза".

Значение параметра учитывается, только если в запросе есть параметр "sessionID", но нет параметров "docIds", "orderNumber", "barcode", "cargoPlaces" или "shipmentLabelCargoPlace"

pageНетintegerНомер запрашиваемой страницы ответа
lastUpdateНетstring

Фильтр для поиска заказов, изменившихся в период, начиная с указанного в данном параметре момента времени.

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

Значение параметра учитывается, только если в запросе есть параметр "sessionID", но нет параметров "docIds", "orderNumber", "barcode", "cargoPlaces" или "shipmentLabelCargoPlace".

Если в запросе передан параметр "states" со значением "inway", то в ответ будут включены все заказы в статусе "inway", не зависимо от значения параметра "lastUpdate" (для прочих статусов действует иная логика - в ответ включаются заказы в указанных статусах, обновлённые после даты, переданной в параметре "lastUpdate")

orderByНетstring

Сортировка заказов.

Возможные значения:

  • ordered_at - по дате заказа;
  • updated_at - по дате обновления.

Значение параметра учитывается, только если в запросе есть параметр "sessionID", но нет параметров "docIds", "orderNumber", "barcode", "cargoPlaces" или "shipmentLabelCargoPlace"

orderDatesAdditional

НетbooleanФлаг, обозначающий, что необходима информация о промежуточных точках маршрута перевозки

Ответ метода

Структура ответа

{
   "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",
         "returnState":true,
         "returnReason":"Отказ после выдачи",
         "returnDate":"2020-10-15 12:30:17",
         "progressPercent":15,
         "derival":{
            "city":"г. Санкт-Петербург",
            "cityId":1,
            "cityCode":"7800000000000000000000000",
            "address":"190000, Санкт-Петербург г, Заневский пр-кт, дом № 1",
            "addressCode":"7800000000004380000000000",
            "terminalName":"Санкт-Петербург Парнас",
            "terminalAddress":"194292, Санкт-Петербург г, 1-й Верхний пер, дом № 12, Литера Б",
            "terminalId":1,
            "timeEnd":"19:22:22",
            "timeStart":"10:11:11",
            "driver":{
               "driverName":"Иванов Иван Иванович",
               "driverPhone": "+7 (988) 988-88-88"
            },
            "vehicle":{
               "vehicleType":"Газель",
               "vehicleLicencePlate": "О 532 УК 199"
            }
         },
         "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",
            "timeEnd":"18:01:01",
            "timeStart":"09:01:01",
            "driver":{
               "driverName":"Петров Петр Петрович",
               "driverPhone": "+7 (999) 999-88-88"
            },
            "vehicle":{
               "vehicleType":"Газель",
               "vehicleLicencePlate": "Р 285 УМ 199"
            },
            "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"
            },
            "specialWorktable":{
               "receive":[
                  "27 ноября — выходной",
                  "28 ноября — с 10:00 до 15:00",
                  "29–30 ноября — выходные"
               ],
               "giveout":[
                  "27 ноября — выходной",
                  "28 ноября — с 10:00 до 15:00",
                  "29–30 ноября — выходные"
               ]
            }
         },
         "brandUID":"0xa6a926848ff680ac4c33255c700a6383",
         "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"
         },
         "cargoPlaces":[
            {
               "number": "3252235",
               "amount": 1
            }
         ],
         "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
            }
         ],
         "webOrderItemsSum":null,
         "withWebOrder":true,
         "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",
               "freightDirection":"straight",
               "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"
               ]
            }
         ],
         "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,
         "note":null,
         "documentsReturnDate":null,
         "priceComment":"",
         "customerUid":"00000000-0000-0000-0000-000000000000",
         "acceptanceActs":[
            {
               "acceptanceActNumber":"5775757575",
               "acceptanceActDate":"2020-10-01",
               "acceptanceActType":""
            },
            {
               "acceptanceActNumber":"5775757575/111",
               "acceptanceActDate":"2020-10-02",
               "acceptanceActType":"Исправленный"
            }
         ],
         "shipmentLabelCargoPlace":"Артикул1223657"
      }
   ],
   "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>
      <returnState>true</returnState>
      <returnReason>Отказ после выдачи</returnReason>
      <returnDate>2020-10-15 12:30:17</returnDate>
      <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>
         <timeEnd>19:22:22</timeEnd>
         <timeStart>10:11:11</timeStart>
         <driver>
            <driverName>Иванов Иван Иванович</driverName>
            <driverPhone>+7 (988) 988-88-88</driverPhone>
         </driver>
         <vehicle>
            <vehicleType>Газель</vehicleType>
            <vehicleLicencePlate>О 532 УК 199</vehicleLicencePlate>
         </vehicle>
      </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>
         <timeEnd>18:01:01</timeEnd>
         <timeStart>09:01:01</timeStart>
         <driver>
            <driverName>Петров Петр Петрович</driverName>
            <driverPhone>+7 (999) 999-88-88</driverPhone>
         </driver>
         <vehicle>
            <vehicleType>Газель</vehicleType>
            <vehicleLicencePlate>Р 285 УМ 199</vehicleLicencePlate>
         </vehicle>
         <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>
         <specialWorktable>
            <receive>27 ноября — выходной</receive>
            <receive>28 ноября — с 10:00 до 15:00</receive>
            <receive>29–30 ноября — выходные</receive>
            <giveout>27 ноября — выходной</giveout>
            <giveout>28 ноября — с 10:00 до 15:00</giveout>
            <giveout>29–30 ноября — выходные</giveout>
         </specialWorktable>
      </arrival>
      <brandUID>0xa6a926848ff680ac4c33255c700a6383"</brandUID>
      <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>
      <cargoPlaces>
         <number>3252235</number>
         <amount>1</amount>
      </cargoPlaces>
      <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>
      <webOrderItemsSum />
      <withWebOrder>true</withWebOrder>
      <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>
         <freightDirection>straight</freightDirection>
         <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>
      </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 />
      <note />
      <documentsReturnDate />
      <priceComment></priceComment>
      <customerUid>00000000-0000-0000-0000-000000000000</customerUid>
      <acceptanceActs>
         <acceptanceActNumber>5775757575</acceptanceActNumber>
         <acceptanceActDate>2020-10-01</acceptanceActDate>
         <acceptanceActType></acceptanceActType>
      </acceptanceActs>
      <acceptanceActs>
         <acceptanceActNumber>5775757575/111</acceptanceActNumber>
         <acceptanceActDate>2020-10-02</acceptanceActDate>
         <acceptanceActType>Исправленный</acceptanceActType>
      </acceptanceActs>
      <shipmentLabelCargoPlace>Артикул1223657</shipmentLabelCargoPlace>
   </orders>
   <deleted />
</response>

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

Если данные недоступны (например, в запросе не был передан параметр "request.sessionID" или же информация не предоставляется для выбранного вида перевозки, типа документа и т. д.), то в ответе для соответствующего параметра будет передано значение "null".
Response
Response
ПараметрТипДанные доступны неавторизованным пользователям
Описание
metadataobjectДаСистемная информация
metadata.statusintegerДаЭмуляция http-кода состояния. В случае успешного выполнения возвращается код "200" (OK)
metadata.currentPageintegerДаНомер текущей страницы ответа
metadata.nextPageintegerДа

Номер следующей страницы ответа

metadata.prevPageintegerДа

Номер предыдущей страницы ответа.

Если номер текущей страницы ответа - "1", то значение данного параметра - "null"

metadata.totalPagesintegerДаСтраниц всего
metadata.generatedAtstringДа

Дата и время генерации ответа сервера.

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

ordersarray of OrdersДаИнформация о заказах
deletedarray of stringsДаСписок удалённых заказов (при передаче в запросе параметра "request.lastUpdate")

Orders

Orders

ПараметрТипДанные доступны неавторизованным пользователямОписание
orderNumberstringДаНомер заказа интернет-магазина (внутренний номер заказа, ВНЗ)
orderDatestringДаДата заказа интернет-магазина
orderIdstringДаНомер заказа
orderedAtstringДаДата создания заказа

state

stringДа

Статус заказа на английском языке (см. "Справочник статусов заказа груза")

stateNamestringДаСтатус заказа на русском языке (см. "Справочник статусов заказа груза")
stateDatestringДа

Дата установки текущего статуса.

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

Если статус заказа - "Черновик" или "В обработке" (значение параметра ответа "orders.state" - "draft" или "processing"), то значение параметра - null

returnStatebooleanДаПризнак возвратного груза
returnReasonstringДаПричина возврата груза
returnDatestringДаДата и время установки признака возвратного груза
progressPercentintegerДаСтепень выполнения заказа (в процентах). Значение параметра может быть использовано для визуализации хода выполнения заказа 
derivalDerivalArrivalЧастично

Информация о месте отправки

arrivalDerivalArrivalЧастично

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

brandUidstringДаUID бренда в заказе
senderMemberНетИнформация об отправителе
receiverMemberНет

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

payerMemberНет

Информация о плательщике

freightFreightНет

Информация о грузе

cargoPlacesarray of CargoPlacesНетИнформация о грузовых местах
cargoPlaces.numberstringНетНомер грузового места
cargoPlaces.amountintegerНетКоличество грузовых мест с идентичным номером
isAirbooleanДаПризнак авиаперевозки
airobjectДа

Информация о доставке авиатранспортом

Если значение параметра "isAir" - "false", то вложенные параметры переданы не будут
air.arrivalDatestringДа

Фактическая дата прибытия груза при доставке авиатранспортом

air.giveoutDatestringДа

Дата выдачи груза при доставке авиатранспортом

air.warehousingDatestringДа

Дата начала платного хранения при доставке авиатранспортом

air.deliveryDatestringДа

Ориентировочная дата прибытия груза при доставке авиатранспортом

air.commentstringНетКомментарий
air.orderIdstringДаНомер авианакладной
locks

array of Locks

НетМассив блокировок по заказу
webOrderItemsSumfloatНет

Сумма наложенного платежа

Данные доступны только в том случае, если у текущей учётной записи есть полный доступ к контрагенту (см. метод "Список контрагентов", описание параметра ответа "info.accessLevel")
withWebOrderbooleanНетПризнак наложенного платежа
totalSumstringДаОбщая сумма заказа
vatstringНетНДС
isPaidbooleanДаСтатус оплаты заказа
isPreorderbooleanНетФлаг, обозначающий что заказ является предзаказом
produceDatestringДа

Дата выполнения заказа

Данные недоступны при заказе услуги "Мультиотправка"
declineReasonstringДа

Причина отклонения

Данные доступны, только если заказ был отклонён
orderDatesobjectДаРасчетный график движения груза
orderDates.arrivalToOspReceiverstringДаДата прибытия груза на терминал-получатель
orderDates.arrivalToOspReceiverMaxstringДа

Максимальная дата прибытия груза на терминал-получатель (в случае, если возможно увеличение срока прибытия)

orderDates.arrivalToOspReceiverAccdocstringДаДата прибытия сопроводительных документов на терминал-получатель
orderDates.arrivalToOspSenderstringДаДата прибытия груза на терминал-отправитель
orderDates.arrivalToReceiverstringДа

Дата доставки груза до адреса:

  • фактическая - для доcтавленных заказов (значение параметра ответа "orders.stateName" - "Заказ завершен", "Груз выдан. Возврат СД");
  • расчётная - для заказов, принятых к перевозке, но ещё не доставленных.

При отсутствии расчётной даты доставки, в ответе метода содержится расчётный срок доставки см. описание параметра ответа "orders.orderTimeInDays.delivery"

orderDates.declineDatestringДа

Дата отклонения

В отдельных случаях данные могут отсутствовать
orderDates.derivalFromOspReceiverstringДаДата отправки с терминала-получателя
orderDates.derivalFromOspReceiverMaxstringДаМаксимальная дата отправки с терминала-получателя (в случае, если возможно увеличение срока отправки)
orderDates.derivalFromOspReceiverAccdocstringДаДата отправки сопроводительных документов с терминала-получателя
orderDates.giveoutFromOspReceiverstringДаОриентировочная дата готовности груза к выдаче на терминале-получателе
orderDates.giveoutFromOspReceiverMaxstringДаМаксимальная дата готовности груза к выдаче на терминале-получателе (в случае, если возможно увеличение срока готовности)
orderDates.derivalFromOspSenderstringДаДата отправления груза с терминала-отправителя
orderDates.draftLastUpdatestringДаДата последнего сохранения черновика
orderDates.finishstringДаДата исполнения заказа
orderDates.firstDocumentCreatedDatestringДаДата создания первого документа по заказу
orderDates.pickupstringДаДата передачи груза на адресе отправителя
orderDates.processingDatestringДаДата отправки заявки в обработку
orderDates.warehousingstringДаДата начала платного хранения
orderTimeInDaysobjectДа

Расчетные сроки доставки от терминала до адреса в днях

Данные доступны, если значение параметра "isAir" = "false". В противном случае значения всех вложенных параметров данного объекта будут содержать "null"
orderTimeInDays.deliveryintegerДа

Срок доставки груза.

Отсчитывается от даты, пришедшей в параметре "orderDates.derivalFromOspReceiver".

Информация присутствует в ответе, если заказана доставка до адреса и отсутствует дата доставки груза до адреса (см. описание параметра ответа "orders.orderDates.arrivalToReceiver")

orderTimeInDays.deliveryAccdocintegerДа

Срок доставки сопроводительных документов.

Отсчитывается от даты, пришедшей в параметре "orderDates.derivalFromOspReceiverAccdoc"

orderedDeliveryFromAddressbooleanДаФлаг, обозначающий что заказана доставка от адреса отправителя
availableDeliveryFromAddressbooleanНетФлаг, обозначающий что возможна доставка от адреса отправителя
orderedDeliveryToAddressbooleanДаФлаг, обозначающий что заказана доставка до адреса получателя
availableDeliveryToAddressbooleanНетФлаг, обозначающий что возможна доставка до адреса получателя
isFavoritebooleanНетПризнак избранного заказа
isContainerbooleanДаФлаг контейнерной перевозки
sfrequestobjectДа

Информация по заявке на доставку до адреса получателя

sfrequest.cityIDintegerДа

ID города доставки, см. метод "Поиск населённых пунктов"

sfrequest.docNumberstringДаНомер накладной доставки
sfrequest.pricestringДаСтоимость доставки
documentsDocumentsЧастичноМассив документов заказа
orderDatesAdditionalOrderDatesAdditionalДа

Информация о промежуточных точках маршрута перевозки

Параметр отсутствует в ответе, если заказ отклонён или с момента завершения заказа прошло более 24 часов (значение параметра "response.state" - "declined" или же значение параметра "response.state" изменилось на "finished" более 24 часов назад)
detailedStatusstringДа

Дополнительный статус заказа на английском языке.

Возможные значения (порядок соответствует порядку возможных значений параметра "detailedStatusRus"):

  • "pickup_waiting_pickup";
  • "pickup_departed";
  • "pickup_arrived";
  • "pickup_arrived_at_first";
  • "pickup_arrived_at_last";
  • "pickup_finished";
  • "delivery_waiting_delivery";
  • "delivery_departed";
  • "delivery_arrived";
  • "delivery_finished";
  • "delivery_delivered"
detailedStatusRusstringДа

Дополнительный статус заказа на русском языке.

Возможные значения (порядок соответствует порядку возможных значений параметра "detailedStatus"):

  • "Ожидается забор" - водитель ещё не выехал на адрес отправителя;
  • "Машина едет на адрес";
  • "Машина на адресе";
  • "Прибыл на первый адрес";
  • "Прибыл на последний адрес";
  • "Груз забран. Едет на терминал";
  • "Ожидается доставка" - водитель ещё не выехал на адрес получателя;
  • "Машина едет на адрес";
  • "Машина на адресе";
  • "Груз доставлен" (соответствует значениям "delivery_finished" и "delivery_delivered" параметра "detailedStatus")
notestringНет

Комментарий к заказу.

Пользователь может оставить комментарий к заказу в личном кабинете на сайте компании "Деловые Линии

documentsReturnDatestringНет

Ориентировочная дата возврата сопроводительных документов.

priceCommentstringДаКомментарий, свидетельствующий о том, что информация о стоимости заказа недоступна текущему пользователю
customerUidstringНет

UID заказчика по заявке

Данные присутствуют в ответе, только если у пользователя есть полный доступ к контрагенту (см. метод "Список контрагентов", описание параметра ответа "info.accessLevel")

acceptanceActs

array of acceptanceActsДаДанные счёта-фактуры

acceptanceActs.acceptanceActNumber

stringДа

Номер.

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

acceptanceActs.acceptanceActDate

stringДаДата 

acceptanceActs.acceptanceActType

stringДа

Тип.

Возможные значения:

  • Корректировочный;
  • Исправленный

В случае обычного счёта-фактуры параметр приходит пустым

shipmentLabelCargoPlacestringНет

Артикул грузового места

DerivalArrival

DerivalArrival

ПараметрТипДанные доступны неавторизованным пользователямОписание
response.orders.derivalresponse.orders.arrival
citystringНетДа

Город отправки/доставки груза

cityIdintegerДаДаID города отправления/прибытия
cityCodestringДаДа

Код КЛАДР города, см. "Поиск населённых пунктов"

addressstringНетНет

Адрес отправки/доставки груза

addressCodestringНетНет

Код КЛАДР улицы, см. "Поиск улиц"

terminalNamestringНетНет

Наименование терминала хранения

terminalAddressstringНетДа

Адрес терминала хранения

terminalIdintegerДаДаID терминала-отправителя/получателя из "Справочника терминалов"
terminalCitystring-Да

Город терминала хранения (1)

terminalCoordinatesarray of floats-Да

Долгота и широта терминала хранения (1)

terminalEmailstring-Да

Email терминала хранения (1)

terminalPhonesstring-Да

Телефон терминала хранения (1)

callCenterPhonesstring-Да

Телефон кол-центра (1)

timeEndstringНетНет

Время окончания доставки от/до адреса (2)

timeStartstringНетНет

Время начала доставки от/до адреса (2)

driverobjectНетНетИнформация о водителе (2)

driver.driverName

stringНетНетФИО водителя

driver.driverPhone

stringНетНетТелефон водителя
vehicleobjectНетНетИнформация о транспортном средстве водителя (2)

vehicle.vehicleType

stringНетНетТип транспортного средства

vehicle.vehicleLicencePlate

stringНетНетНомер транспортного средства
terminalWorktablesobject-Да

График работы терминала хранения (график выдачи груза) (1)

terminalWorktables.sunstring-ДаГрафик работы терминала хранения в воскресенье
terminalWorktables.monstring-ДаГрафик работы терминала хранения в понедельник      
terminalWorktables.tuestring-ДаГрафик работы терминала хранения во вторник    
terminalWorktables.wedstring-ДаГрафик работы терминала хранения в среду
terminalWorktables.thustring-ДаГрафик работы терминала хранения в четверг 
terminalWorktables.fristring-ДаГрафик работы терминала хранения в пятницу 
terminalWorktables.satstring-ДаГрафик работы терминала хранения в субботу
specialWorktableobject-ДаГрафик работы терминала хранения в праздничные дни (1)
specialWorktable.receivearray of strings-ДаГрафик работы терминала хранения на прием груза (в праздничные дни)
specialWorktable.giveoutarray of strings-ДаГрафик работы терминала хранения на выдачу груза (в праздничные дни)

Примечания:

  1. Данный параметр используется только для объекта "response.orders.arrival".
  2. Данный параметр выводится в ответе, только если статус заказа - "Забор груза от адреса" или "Доставка груза до адреса" (значение параметра "orders.state" = "pickup" или "delivery"), при этом дополнительный статус заказа ("orders.detailedStatusRus") не равен "Груз забран. Едет на терминал" или "Груз доставлен" (значение параметра "detailedStatus" не равно "pickup_finished", "delivery_delivered" или "delivery_finished")

Member
Данные доступны, только если в запросе был передан параметр "sessionID".

Member

ПараметрТипОписание
opfstring

Организационно-правовая форма ОПФ (1)

Параметр используется только для объектов "response.orders.documents.sender", "response.orders.documents.receiver", "response.orders.documents.payer"
opfobject

ОПФ

Параметр используется только для объектов "response.orders.sender", "response.orders.receiver", "response.orders.payer"
opf.namestringСокращённое наименование ОПФ
opf.fullNamestringПолное наименование ОПФ
opf.countryCodeintegerКод страны
opfUidstring

UID ОПФ, см. метод "Поиск ОПФ" (1)

namestringНаименование контрагента
addressstring

Адрес контрагента

Параметр используется только для объектов "response.orders.sender", "response.orders.receiver"
isPhysicalboolean

Флаг "Физическое лицо" (1)

innstring

ИНН юр. лица  (1)

documentTypestring

Вид документа физ. лица (1)

Возможные значения:

  • "Паспорт РФ";
  • "Загранпаспорт";
  • "Водительское удостоверение"
documentSeriesstring

Серия документа физ. лица (1)

documentNumberstring

Номер документа физ. лица (1)

сounteragentUidstring

UID контрагента (2)

contactsstring

ФИО контактного лица отправителя (2)

phonesstring

Телефон контрагента

Параметр используется только для объекта "response.orders.sender"
anonymboolean

Признак контрагента с минимальным набором данных - "анонимного" получателя (3)

anonymEmailstring

Email "анонимного" получателя (3)

anonymPhonestring

Телефон "анонимного" получателя (3)

Примечания:

  1. Для объекта "response.orders.documents.payer": данные недоступны для заявок на перевозку выделенной еврофурой (значение параметра "response.orders.documents.type" - "request_ftl").
  2. Данные доступны, если у пользователя есть доступ хотя бы одному участнику перевозки отправителю/получателю/плательщику или учётной записи, в которой был создан участник перевозки. Подробнее о полном доступе см. в методе "Список контрагентов".
  3. "Анонимный" получатель - получатель, о котором предоставлен минимум информации (см. описание услуги "Упрощённая отправка груза" на сайте компании "Деловые Линии"). Параметр используется только для объекта "response.orders.receiver"

Freight
Данные доступны, только если в запросе был передан параметр "sessionID"

Freight

ПараметрТипОписание
response.orders.freightresponse.orders.documents.freightresponse.orders.freightresponse.orders.documents.freight
namenamestringstringХарактер груза
weightweight

string

floatВес груза, кг
oversizedWeightoversizedWeight

string

float
Вес негабаритных грузовых мест, кг (1)
volumevolume

string

floatОбъем груза, м3
oversizedVolumeoversizedVolume

string

floatОбъем негабаритных грузовых мест, м3 (1)
places-integer-

Количество грузовых мест

oversizedPlaces-integer-

Количество негабаритных грузовых мест (1)

lengthmaxLengthstringfloat

Длина груза, м

widthmaxWidthstringfloat

Ширина груза, м

heightmaxHeightstringfloat

Высота груза, м

Примечания:

  1. Негабаритное грузовое место - это грузовое место, вес которого больше либо равен 100 кг (80 кг в случае перевозки авиатранспортом) или одно из измерений (Д*Ш*В) которого больше либо равно 3 м (80 см в случае перевозки авиатранспортом)

Locks
Данные доступны, только если в запросе был передан параметр "sessionID"

Locks

ПараметрТипОписание
namestringНаименование блокировки
typestringТип блокировки
setDatestringДата установки блокировки
endDatestringДата снятия блокировки

Documents

Documents

ПараметрТипДанные доступны неавторизованным пользователямОписание
idintegerДаНомер документа
uidstringДа

UID накладной (1)

typestringДа

Тип документа.

Возможные значения:

  • "shipping" - накладная;
  • "request" - заявка на доставку груза (от адреса отправителя или от терминала);
  • "request_sf" - заявка на доставку до адреса получателя (от терминала);
  • "request_ftl" - заявка на междугороднюю перевозку выделенной еврофурой
createDatestringДа

Дата создания документа

statestringДа

Статус документа

У заявки на доставку от адреса отправителя/до адреса получателя/на междугороднюю перевозку выделенной еврофурой (значение параметра "response.orders.documents.type" - "request"/"request_sf"/"request_ftl") могут быть следующие статусы:

  • "temporary" - заявка не заполнена;
  • "saved" - черновик;
  • "ordered" - заявка в очереди на обработку;
  • "loaded" - заявка взята на обработку;
  • "processed" - заявка обработана;
  • "declined" - заявка отклонена;
  • "accepted" - заявка принята;
  • "canceled" - заявка отменена.

Для накладной (значение параметра "response.orders.documents.type" - "shipping") статус присутствует в ответе, но не используется (всегда имеет значение "in_way")

freightDirectionstringДа

Направление перевозки груза (1).

Возможные значения:

  • straight - прямое направление;
  • return - возврат груза отправителю;
  • null - отсутствие данных.

Значение "null" возвращается:

  • для накладной, не являющейся основной накладной по заказу, для которого инициирован процесс возврата;
  • для накладных по заказу без возврата груза
senderMemberНет

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

receiverMemberНет

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

payerMemberНетИнформация о плательщике
produceDatestringДа

Дата исполнения заявки (3)

forwarderIdstringНет

Номер заявки экспедитора (3)

commentstringНет

Комментарии к документам (3)

fullDocumentIdstringДа

Полный номер документа (3)

freightFreightНет

Информация о грузе (4)

derivalobjectДа

Информация о месте отправки (4)

derival.namestringДа

Город (4)

derival.codestringДа

Код КЛАДР города, см. метод "Поиск населённых пунктов" (4)

arrivalobjectДа

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

arrival.namestringДа

Город (4)

arrival.codestringДа

Код КЛАДР города, см. метод "Поиск населённых пунктов" (4)

barcodestringНет

Barcode для формирования штрих-кода по алгоритму Code 128 (для заявки на предзаказ)

paymentbooleanДа

Статус оплаты (1)

totalSumstringДа

Общая сумма по накладной (1)

vatstringНетНДС (1)
serviceKindstringДа

Тип перевозки (1)

organizationstringНет

ID организации (1)

servicesarray of ServicesЧастично

Перечень услуг по накладной (1)

accompanyingDocumentsarray of AcDocsНет

Перечень сопроводительных документов (1)

availableDocsarray of stringsНет

Перечень документов, по которым можно получить печатные формы (1)

Примечания:

  1. Данные доступны только для накладной (значение параметра "response.orders.documents.type" - "shipping").
  2. Данные недоступны для заявок на междугороднюю перевозку выделенной еврофурой (значение параметра "response.orders.documents.type" - "request_ftl").
  3. Данные доступны только для заявок на доставку груза (в случае, если заказан доставка от адреса отправителя/до адреса получателя)/заявок на доставку груза от терминала до адреса получателя (значение параметра "response.orders.documents.type" - "request"/"request_sf").
  4. Данные доступны только для заявок на доставку груза (от адреса отправителя или от терминала) и накладных (значение параметра "response.orders.documents.type" - "request"/"shipping")

Services
Неавторизованному пользователю доступен только параметр "response.orders.documents.services.name". Прочие данные доступны, только если в запросе был передан параметр "sessionID"
Services
ПараметрТипОписание
namestringНаименование услуги
serviceUidstringUID услуги
createdAtstringДата создания
quantityintegerКоличество
sumstringСумма
totalSumstringСумма итого
vatstringНДС
vatRatestringСтавка НДС, если НДС не применяется, то выводится значение "БЕЗ НДС"
discountSumstringСумма скидки

AcDocs
AcDocs
ПараметрТипОписание
documentDatestringДата создания сопроводительного документа
documentNumberstringНомер сопроводительного документа
documentKindstringКомментарий (тип документа)

OrderDatesAdditional

OrderDatesAdditional

ПараметрТипОписание

tracing

array of TracingСписок промежуточных точек маршрута перевозки. Максимальное число элементов массива - 10. Если промежуточных точек больше 10, то в ответе метода будет представлена информация по 10 последним точкам маршрута

tracing.title

stringСобытие, дата которого передаётся в параметре "tracing.date". Значение всегда "Отбытие из ОСП"

tracing.date

string

Дата прохождения точки маршрута.

Формат даты: ГГГГ-ММ-ДД

tracing.cityUID

stringUID города (промежуточной точки маршрута)

tracing.cityName

stringГород (промежуточная точка маршрута)

tracing.status

string

Статус заказа на момент прохождения точки маршрута. Значение всегда "inway" (см. "Справочник статусов заказа груза")

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

Помимо общих ошибок API, в ответе метода могут присутствовать следующие ошибки:

Номер ошибки

http-код

Краткое описание ошибки

Детальное описание ошибки

718001

400

Найдено более одного заказа

Воспользуйтесь расширенным поиском

717001

400

Заказ не найден

Заказ [номер заказа] не найден

717002

400

Неизвестный статус заказа

Детальное описание ошибки содержит номера заказов с неизвестным статусом