Оформление заявок на перевозку из Личного Кабинета

Обновлено 23.06.2020

278 кб

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

Сервис предназначен для оформления заказа/предзаказа на доставку грузов с использованием данных личного кабинета. Доступно использование метода без предварительного создания записей в адресной книге. Имеется возможность сохранять в адресную книгу данные, вводимые при создании заявки.

Имеется возможность использования метода для создании заявок без авторизации (из публичной части). См. описание в соответствующем разделе.

Ниже представлено описание всех параметров метода, в соответствующем разделе можно найти примеры запросов и ответов.

Оформление заявок

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

Адрес метода: https://api.dellin.ru/v2/request.json

{  
   "appkey":"00000000-0000-0000-0000-000000000000",
   "sessionID":"00000000-0000-0000-0000-000000000000",
   "inOrder":true,
   "delivery":{  
      "deliveryType":{  
         "type":"avia",
         "payer":"sender"
      },
      "packages":[  
         {  
            "uid":"0xA0A820F33B2F93FE44C8058B65C77D0F",
            "payer":"sender"
         },
         {  
            "uid":"0x947845D9BDC69EFA49630D8C080C4FBE",
            "payer":"sender",
            "count":3
         }
      ],
      "accompanyingDocuments":[  
         {  
            "action":"send",
            "payer":"sender"
         },
         {  
            "action":"return",
            "payer":"sender"
         }
      ],
      "derival":{  
         "produceDate":"2018-02-15",
         "pickupParams":{  
            "derivalDriverPass":24,
            "shipmentRegister":true,
            "paidEntry":{  
               "cost":100,
               "type":1
            },
            "shipmentDerival":"АБ1000222",
            "priorCall":true,
            "noNeedAgreement":true,
            "documentsForReceive":[  
               "0x90bc42c2d8cf7c1c47a40fc1ccfb54d5",
               "0x9c65f346435836584a8345ade132df00"
            ]
         },
         "variant":"terminal",
         "payer":"sender",
         "terminalID":"23",
         "addressID":"457824578",
         "address":{  
            "street":"7800000000004380000000000",
            "house":"4",
            "building":"3",
            "structure":"лит.А",
            "flat":"214а",
            "save":true
         },
         "additionalAddress":{  
            "addressID":"",
            "address":{  
               "street":"7800000000004380000000000",
               "house":"4",
               "building":"3",
               "structure":"лит.А",
               "flat":"214а",
               "save":true
            },
            "payer":"sender"
         },
         "time":{  
            "worktimeStart":"09:00",
            "worktimeEnd":"18:00",
            "breakStart":"12:30",
            "breakEnd":"13:30",
            "exactTime":true
         },
         "handling":{  
            "freightLift":true,
            "toFloor":10,
            "carry":50,
            "payer":"third"
         },
         "requirements":[  
            "0x9951e0ff97188f6b4b1b153dfde3cfec",
            "0xabb9c63c596b08f94c3664c930e77778"
         ]
      },
      "arrival":{  
         "variant":"terminal",
         "payer":"sender",
         "terminalID":"23",
         "addressID":"457824578",
         "city":"7700000000000000000000000",
         "address":{  
            "street":"7800000000004380000000000",
            "house":"4",
            "building":"3",
            "structure":"лит.А",
            "flat":"214а",
            "save":true
         },
         "time":{  
            "worktimeStart":"09:00",
            "worktimeEnd":"18:00",
            "breakStart":"12:30",
            "breakEnd":"13:30",
            "exactTime":true
         },
         "handling":{  
            "freightLift":true,
            "toFloor":10,
            "carry":50,
            "payer":"third"
         },
         "requirements":[  
            "0x9951e0ff97188f6b4b1b153dfde3cfec",
            "0xabb9c63c596b08f94c3664c930e77778"
         ]
      },
      "smsback":"79213332211",
      "comment":"комментарий к отправке"
   },
   "members":{  
      "requester":{  
         "role":"payer",
         "uid":"f969722a-cca3-49ed-85ff-b6be9e904b94",
         "email":"test@mail.ru"
      },
      "sender":{  
         "counteragentID":"456783515",
         "counteragent":{  
            "form":"0x8F51001438C4D49511DBD774581EDB80",
            "customForm":{  
               "formName":"ОБРУГ",
               "countryUID":"0x00000000000000000000000000000000",
               "juridical":true
            },
            "document":{  
               "type":"passport",
               "serial":"0000",
               "number":"123456"
            },
            "name":"Ромашка",
            "inn":"1234567890",
            "juridicalAddress":{  
               "street":"7800000000004380000000000",
               "house":"4",
               "building":"2",
               "structure":"3А",
               "flat":"Б-234"
            },
            "save":true
         },
         "contactIDs":[  
            "12345678",
            "78456123"
         ],
         "contactPersons":[  
            {  
               "name":"Иван Иванович",
               "save":true
            },
            {  
               "name":"Петр Петрович",
               "save":false
            }
         ],
         "phoneIDs":[  
            "98765412",
            "65478921"
         ],
         "phoneNumbers":[  
            {  
               "number":"79213332211",
               "ext":"0123",
               "save":true
            }
         ],
         "email":"test@mail.ru",
         "dataForReceipt":{
            "send":true,
            "phone":"+79999999999",
            "email":"test@mail.ru"
         }
      },
      "receiver":{  
         "counteragentID":"456783515",
         "counteragent":{  
            "form":"0x8F51001438C4D49511DBD774581EDB80",
            "customForm":{  
               "formName":"ОБРУГ",
               "countryUID":"0x00000000000000000000000000000000",
               "juridical":true
            },
            "document":{  
               "type":"passport",
               "serial":"0000",
               "number":"123456"
            },
            "isAnonym":false,
            "phone":"79998887766",
            "name":"Ромашка",
            "inn":"1234567890",
            "juridicalAddress":{  
               "street":"7800000000004380000000000",
               "house":"4",
               "building":"2",
               "structure":"3А",
               "flat":"Б-234"
            },
            "save":true
         },
         "contactIDs":[  
            "12345678",
            "78456123"
         ],
         "contactPersons":[  
            {  
               "name":"Иван Иванович",
               "save":true
            },
            {  
               "name":"Петр Петрович",
               "save":false
            }
         ],
         "phoneIDs":[  
            "98765412",
            "65478921"
         ],
         "phoneNumbers":[  
            {  
               "number":"79213332211",
               "ext":"0123",
               "save":true
            }
         ],
         "email":"test@mail.ru",
         "dataForReceipt":{
            "send":true,
            "phone":"+79999999999",
            "email":"test@mail.ru"
         }
      },
      "third":{  
         "counteragentID":"456783515",
         "counteragent":{  
            "form":"0x8F51001438C4D49511DBD774581EDB80",
            "customForm":{  
               "formName":"ОБРУГ",
               "countryUID":"0x00000000000000000000000000000000",
               "juridical":true
            },
            "document":{  
               "type":"passport",
               "serial":"0000",
               "number":"123456"
            },
            "name":"Ромашка",
            "inn":"1234567890",
            "juridicalAddress":{  
               "street":"7800000000004380000000000",
               "house":"4",
               "building":"2",
               "structure":"3А",
               "flat":"Б-234"
            },
            "save":true
         },
         "contactIDs":[  
            "12345678",
            "78456123"
         ],
         "contactPersons":[  
            {  
               "name":"Иван Иванович",
               "save":true
            },
            {  
               "name":"Петр Петрович",
               "save":false
            }
         ],
         "phoneIDs":[  
            "98765412",
            "65478921"
         ],
         "phoneNumbers":[  
            {  
               "number":"79213332211",
               "ext":"0123",
               "save":true
            }
         ],
         "email":"test@mail.ru",
         "dataForReceipt":{
            "send":true,
            "phone":"+79999999999",
            "email":"test@mail.ru"
         }
      }
   },
   "cargo":{  
      "quantity":1,
      "length":0.42,
      "width":0.18,
      "height":0.3,
      "weight":25.0,
      "totalVolume":0.02,
      "totalWeight":0.02,
      "oversizedWeight":25.0,
      "oversizedVolume":0.02,
      "hazardClass":2.1,
      "insurance":{  
         "statedValue":11220.50,
         "payer":"sender",
         "term":true
      },
      "freightUID":"0x9c2acaea110d75ba48fdc7a83c976269",
      "freightName":"Запчасти для трактора"
   },
   "payment":{  
      "cashOnDelivery":[  
         {  
            "orderNumber":"123456",
            "orderDate":"2018-04-09",
            "paymentType":"cash",
            "products":[  
               {  
                  "productName":"Кофеварка BRAUN",
                  "productCode":"K-2300",
                  "productAmount":"1",
                  "costWithVAT":"17800",
                  "VATRate":18
               }
            ]
         }
      ],
      "type":"cash",
      "primaryPayer":"sender",
      "paymentCity":"7800000000000000000000000"
   }
}

Адрес метода: https://api.dellin.ru/v2/request.xml

<request>
   <appkey>00000000-0000-0000-0000-000000000000</appkey>
   <sessionID>00000000-0000-0000-0000-000000000000</sessionID>
   <inOrder>true</inOrder>
   <delivery>
      <deliveryType>
         <type>avia</type>
         <payer>sender</payer>
      </deliveryType>
      <packages>
         <uid>0xA0A820F33B2F93FE44C8058B65C77D0F</uid>
         <payer>sender</payer>
      </packages>
      <packages>
         <uid>0x947845D9BDC69EFA49630D8C080C4FBE</uid>
         <payer>sender</payer>
         <count>3</count>
      </packages>
      <accompanyingDocuments>
         <action>send</action>
         <payer>sender</payer>
      </accompanyingDocuments>
      <accompanyingDocuments>
         <action>return</action>
         <payer>sender</payer>
      </accompanyingDocuments>
      <derival>
         <produceDate>2018-02-15</produceDate>
         <pickupParams>
            <derivalDriverPass>24</derivalDriverPass>
            <shipmentRegister>true</shipmentRegister>
            <paidEntry>
               <cost>100</cost>
               <type>1</type>
            </paidEntry>
            <shipmentDerival>АБ1000222</shipmentDerival>
            <priorCall>true</priorCall>
            <noNeedAgreement>true</noNeedAgreement>
            <documentsForReceive>0x90bc42c2d8cf7c1c47a40fc1ccfb54d5</documentsForReceive>
            <documentsForReceive>0x9c65f346435836584a8345ade132df00</documentsForReceive>
         </pickupParams>
         <variant>terminal</variant>
         <payer>sender</payer>
         <terminalID>23</terminalID>
         <addressID>457824578</addressID>
         <address>
            <street>7800000000004380000000000</street>
            <house>4</house>
            <building>3</building>
            <structure>лит.А</structure>
            <flat>214а</flat>
            <save>true</save>
         </address>
         <additionalAddress>
            <addressID></addressID>
            <address>
               <street>7800000000004380000000000</street>
               <house>4</house>
               <building>3</building>
               <structure>лит.А</structure>
               <flat>214а</flat>
               <save>true</save>
            </address>
            <payer>sender</payer>
         </additionalAddress>
         <time>
            <worktimeStart>09:00</worktimeStart>
            <worktimeEnd>18:00</worktimeEnd>
            <breakStart>12:30</breakStart>
            <breakEnd>13:30</breakEnd>
            <exactTime>true</exactTime>
         </time>
         <handling>
            <freightLift>true</freightLift>
            <toFloor>10</toFloor>
            <carry>50</carry>
            <payer>third</payer>
         </handling>
         <requirements>0x9951e0ff97188f6b4b1b153dfde3cfec</requirements>
         <requirements>0xabb9c63c596b08f94c3664c930e77778</requirements>
      </derival>
      <arrival>
         <variant>terminal</variant>
         <payer>sender</payer>
         <terminalID>23</terminalID>
         <addressID>457824578</addressID>
         <city>7700000000000000000000000</city>
         <address>
            <street>7800000000004380000000000</street>
            <house>4</house>
            <building>3</building>
            <structure>лит.А</structure>
            <flat>214а</flat>
            <save>true</save>
         </address>
         <time>
            <worktimeStart>09:00</worktimeStart>
            <worktimeEnd>18:00</worktimeEnd>
            <breakStart>12:30</breakStart>
            <breakEnd>13:30</breakEnd>
            <exactTime>true</exactTime>
         </time>
         <handling>
            <freightLift>true</freightLift>
            <toFloor>10</toFloor>
            <carry>50</carry>
            <payer>third</payer>
         </handling>
         <requirements>0x9951e0ff97188f6b4b1b153dfde3cfec</requirements>
         <requirements>0xabb9c63c596b08f94c3664c930e77778</requirements>
      </arrival>
      <smsback>79213332211</smsback>
      <comment>комментарий к отправке</comment>
   </delivery>
   <members>
      <requester>
         <role>payer</role>
         <uid>f969722a-cca3-49ed-85ff-b6be9e904b94</uid>
         <email>test@mail.ru</email>
      </requester>
      <sender>
         <counteragentID>456783515</counteragentID>
         <counteragent>
            <form>0x8F51001438C4D49511DBD774581EDB80</form>
            <customForm>
               <formName>ОБРУГ</formName>
               <countryUID>0x00000000000000000000000000000000</countryUID>
               <juridical>true</juridical>
            </customForm>
            <document>
               <type>passport</type>
               <serial>0000</serial>
               <number>123456</number>
            </document>
            <name>Ромашка</name>
            <inn>1234567890</inn>
            <juridicalAddress>
               <street>7800000000004380000000000</street>
               <house>4</house>
               <building>2</building>
               <structure>3А</structure>
               <flat>Б-234</flat>
            </juridicalAddress>
            <save>true</save>
         </counteragent>
         <contactIDs>12345678</contactIDs>
         <contactIDs>78456123</contactIDs>
         <contactPersons>
            <name>Иван Иванович</name>
            <save>true</save>
         </contactPersons>
         <contactPersons>
            <name>Петр Петрович</name>
            <save>false</save>
         </contactPersons>
         <phoneIDs>98765412</phoneIDs>
         <phoneIDs>65478921</phoneIDs>
         <phoneNumbers>
            <number>79213332211</number>
            <ext>0123</ext>
            <save>true</save>
         </phoneNumbers>
         <email>test@mail.ru</email>
         <dataForReceipt>
            <send>true</send>
            <phone>+79999999999</phone>
            <email>test@mail.ru</email>
         </dataForReceipt>
      </sender>
      <receiver>
         <counteragentID>456783515</counteragentID>
         <counteragent>
            <form>0x8F51001438C4D49511DBD774581EDB80</form>
            <customForm>
               <formName>ОБРУГ</formName>
               <countryUID>0x00000000000000000000000000000000</countryUID>
               <juridical>true</juridical>
            </customForm>
            <document>
               <type>passport</type>
               <serial>0000</serial>
               <number>123456</number>
            </document>
            <isAnonym>false</isAnonym>
            <phone>79998887766</phone>
            <name>Ромашка</name>
            <inn>1234567890</inn>
            <juridicalAddress>
               <street>7800000000004380000000000</street>
               <house>4</house>
               <building>2</building>
               <structure>3А</structure>
               <flat>Б-234</flat>
            </juridicalAddress>
            <save>true</save>
         </counteragent>
         <contactIDs>12345678</contactIDs>
         <contactIDs>78456123</contactIDs>
         <contactPersons>
            <name>Иван Иванович</name>
            <save>true</save>
         </contactPersons>
         <contactPersons>
            <name>Петр Петрович</name>
            <save>false</save>
         </contactPersons>
         <phoneIDs>98765412</phoneIDs>
         <phoneIDs>65478921</phoneIDs>
         <phoneNumbers>
            <number>79213332211</number>
            <ext>0123</ext>
            <save>true</save>
         </phoneNumbers>
         <email>test@mail.ru</email>
         <dataForReceipt>
            <send>true</send>
            <phone>+79999999999</phone>
            <email>test@mail.ru</email>
         </dataForReceipt>
      </receiver>
      <third>
         <counteragentID>456783515</counteragentID>
         <counteragent>
            <form>0x8F51001438C4D49511DBD774581EDB80</form>
            <customForm>
               <formName>ОБРУГ</formName>
               <countryUID>0x00000000000000000000000000000000</countryUID>
               <juridical>true</juridical>
            </customForm>
            <document>
               <type>passport</type>
               <serial>0000</serial>
               <number>123456</number>
            </document>
            <name>Ромашка</name>
            <inn>1234567890</inn>
            <juridicalAddress>
               <street>7800000000004380000000000</street>
               <house>4</house>
               <building>2</building>
               <structure>3А</structure>
               <flat>Б-234</flat>
            </juridicalAddress>
            <save>true</save>
         </counteragent>
         <contactIDs>12345678</contactIDs>
         <contactIDs>78456123</contactIDs>
         <contactPersons>
            <name>Иван Иванович</name>
            <save>true</save>
         </contactPersons>
         <contactPersons>
            <name>Петр Петрович</name>
            <save>false</save>
         </contactPersons>
         <phoneIDs>98765412</phoneIDs>
         <phoneIDs>65478921</phoneIDs>
         <phoneNumbers>
            <number>79213332211</number>
            <ext>0123</ext>
            <save>true</save>
         </phoneNumbers>
         <email>test@mail.ru</email>
         <dataForReceipt>
            <send>true</send>
            <phone>+79999999999</phone>
            <email>test@mail.ru</email>
         </dataForReceipt>
      </third>
   </members>
   <cargo>
      <quantity>1</quantity>
      <length>0.42</length>
      <width>0.18</width>
      <height>0.3</height>
      <weight>25</weight>
      <totalVolume>0.02</totalVolume>
      <totalWeight>0.02</totalWeight>
      <oversizedWeight>25</oversizedWeight>
      <oversizedVolume>0.02</oversizedVolume>
      <hazardClass>2.1</hazardClass>
      <insurance>
         <statedValue>11220.5</statedValue>
         <payer>sender</payer>
         <term>true</term>
      </insurance>
      <freightUID>0x9c2acaea110d75ba48fdc7a83c976269</freightUID>
      <freightName>Запчасти для трактора</freightName>
   </cargo>
   <payment>
      <cashOnDelivery>
         <orderNumber>123456</orderNumber>
         <orderDate>2018-04-09</orderDate>
         <paymentType>cash</paymentType>
         <products>
            <productName>Кофеварка BRAUN</productName>
            <productCode>K-2300</productCode>
            <productAmount>1</productAmount>
            <costWithVAT>17800</costWithVAT>
            <VATRate>18</VATRate>
         </products>
      </cashOnDelivery>
      <type>cash</type>
      <primaryPayer>sender</primaryPayer>
      <paymentCity>7800000000000000000000000</paymentCity>
   </payment>
</request>

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

Request

Request
Параметр	Обязательный	Тип	Описание
Корневые параметры
appkey	Да	string	Ключ приложения. Для получения ключа необходимо пройти регистрацию
sessionID	Да	string	ID сессии. Для получения сессии можно воспользоваться методом "Авторизация пользователя"
inOrder	Нет	boolean	Если передано значение "false", то заявка сохраняется, но не передается в дальнейшую обработку. Значение по умолчанию: "true"
delivery	Да	object	Параметры доставки
delivery.deliveryType	Да	DeliveryType	Тип доставки для межтерминальной перевозки
delivery.packages	Нет	array of Package	Список требуемых упаковок
delivery.accompanyingDocuments	Нет	array of AcDoc	Сопроводительные документы
delivery.derival	Да	Derival	Доставка от адреса
delivery.arrival	Да	Arrival	Доставка до адреса
delivery.smsback	Нет	string	Телефон для SMS-уведомлений. Формат номера: "7ХХХХХХХХХХ" (11 цифр с ведущей семёркой)
delivery.comment	Нет	string	Комментарий к заказу. Максимальная длина поля: 500 символов
members	Да	object	Участники перевозки
members.requester	Да	Requester	Заказчик перевозки
members.sender	Да	Member	Отправитель
members.receiver	Да	Member	Получатель
members.third	Нет	Member	Третье лицо
cargo	Да	Cargo	Характеристики груза
payment	Да	object	Параметры оплаты
payment.type	Да	string	Вид оплаты. Доступные значения: "cash" - оплата наличными или банковской картой; "noncash" - оплата посредством банковского перевода
payment.primaryPayer	Да	string	Плательщик по умолчанию. Указанный плательщик оплачивает основную услугу (межтерминальную перевозку) и все прочие услуги, если по ним не указаны иные плательщики. Доступные значения: "sender" - отправитель; "receiver" - получатель; "third" - третье лицо
payment.paymentCity	Нет*	string	Код КЛАДР населенного пункта. Может быть получен с помощью сервисов, представленных на странице "Использование кодов КЛАДР". *Параметр является обязательным, если один из плательщиков - третье лицо
payment.cashOnDelivery	Нет	array of CashOnDelivery	Наложенный платеж. Оформление наложенного платежа возможно только при соблюдении следующих условий: Заказчик является юридическим лицом, которому доступна услуга "Наложенный платёж"(для получения разрешения на использование услуги необходимо обратиться к менеджеру компании "Деловые Линии"). Заказчик выступает в роли отправителя (значение параметра "members.requester.role" - "sender". Получатель является физическим лицом. При оформлении наложенного платежа невозможна доставка до адреса получателя (значение параметра "" должно быть "terminal"). В настоящий момент допускается передача только одного элемента в массив "CashOnDelivery", прочие переданные элементы игнорируются

DeliveryType

Параметр

Обязательный

Тип

Описание

type

Да

string

Вид доставки.

Доступные значения:

"auto" - автодоставка;
"express" - экспресс-доставка;
"letter" - письмо;
"avia" - авиадоставка;
"small" - доставка малогабаритного груза

Малогабаритный груз - это груз, параметры которого не превышают следующие значения:

масса меньше либо равна 10 кг;
Д*Ш*В меньше либо равны 0,54*0,39*0,39 м;
объём меньше либо равен 0,1 куб. м.

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

payer

Нет

string

Плательщик по услуге.

Доступные значения:

"sender" - отправитель;
"receiver" - получатель;
"third" - третье лицо.

Если параметр не передан, то он принимает значение параметра "Request.Payment.primaryPayer"

Package

Package
Параметр	Обязательный	Тип	Описание
uid	Да	string	UID упаковки из "Справочника доп. услуг для заявки"
payer	Нет	string	Плательщик по услуге. Доступные значения: "sender" - отправитель; "receiver" - получатель; "third" - третье лицо. Если параметр не передан, то он принимает значение параметра "Request.Payment.primaryPayer"
count	Нет*	integer	Количество мешков или коробок *Если выбрана упаковка "Упаковка мешок" или "Картонная коробка", то параметр является обязательным

AcDoc

Параметр

Обязательный

Тип

Описание

action

Да

string

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

Доступные значения:

"send" - отправка;
"return" - возврат

payer

Да

string

Плательщик по услуге.

Доступные значения:

"sender" - отправитель;
"receiver" - получатель;
"third" - третье лицо.

Если параметр не передан, то он принимает значение параметра "Request.Payment.primaryPayer"

Derival

Derival
Параметр	Обязательный	Тип	Описание
produceDate	Да	string	Дата передачи груза на терминал отправления или дата приезда машины к отправителю. Формат: ГГГГ-ММ-ДД
pickupParams	Нет	PickupParams	Дополнительные параметры доставки груза от адреса
variant	Да	string	Способ отправки груза. Доступные значения: "terminal" - доставка груза от терминала; "address" - доставка груза от адреса. При выборе доставки от адреса отправителя будет оформлен заказ, при выборе доставки от терминала отправителя - предзаказ. *При заказе перевозки малогабаритного груза (значение параметра запроса "delivery.deliverуType.type" - "small") доставка от терминала невозможна
payer	Нет	string	Плательщик по услуге. Доступные значения: "sender" - отправитель; "receiver" - получатель; "third" - третье лицо. Если параметр не передан, то он принимает значение параметра "Request.Payment.primaryPayer"
terminalID	Да*	integer	ID терминала из "Справочника терминалов". При заказе экспресс-перевозки (значение параметра запроса "" - "express") необходимо передать ID терминала, который оказывает услуги по приёму экспресс-грузов (в "Справочнике терминалов" выбранный терминал должен иметь вложенный параметр "Worktables.Worktable.department" со значением "Приём груза к экспресс-перевозке"). *Допускается передача только одного из параметров: "terminalID", "addressID", "address"
addressID	Да*	integer	ID адреса из "Адресной книги". *Допускается передача только одного из параметров: "terminalID", "addressID", "address"
address	Да*	Address	Адрес в форме набора параметров. *Допускается передача только одного из параметров: "terminalID", "addressID", "address"
additionalAddress	Нет	object	Заезд на второй адрес
additionalAddress.addressID	Нет*	integer	ID адреса из "Адресной книги". *Допускается передача только одного из параметров: "addressID", "address"
additionalAddress.address	Нет*	Address	Адрес в форме набора параметров. *Допускается передача только одного из параметров: "addressID", "address"
additionalAddress.payer	Нет	string	Плательщик по услуге. Доступные значения: "sender" - отправитель; "receiver" - получатель; "third" - третье лицо. Если параметр не передан, то он принимает значение параметра "Request.Payment.primaryPayer"
time	Да*	object	Время передачи груза для перевозки (на адресе). *Только если выбран способ отправки груза "address"
time.worktimeStart	Да	string	Начало периода передачи груза. Формат: ЧЧ:ММ
time.worktimeEnd	Да	string	Окончание периода передачи груза. Формат: ЧЧ:ММ
time.breakStart	Нет	string	Начало перерыва. Формат: ЧЧ:ММ
time.breakEnd	Нет	string	Окончание перерыва. Формат: ЧЧ:ММ
time.exactTime	Нет	boolean	Передача груза в точное время. Значение по умолчанию: "false"
handling	Нет	object	Погрузо-разгрузочные работы на адресе
handling.freightLift	Нет	boolean	Есть грузовой лифт. Значение по умолчанию: "false"
handling.toFloor	Нет	integer	Номер этажа, на который требуется подъем. Максимальная длина поля: 5 символов
handling.carry	Нет	integer	Пронос в метрах. Максимальная длина поля: 5 символов
handling.payer	Нет	string	Плательщик по услуге. Доступные значения: "sender" - отправитель; "receiver" - получатель; "third" - третье лицо. Если параметр не передан, то он принимает значение параметра "Request.Payment.primaryPayer"
requirements	Нет	array of string	Дополнительные требования к транспорту. Указываются UID'ы из "Справочника специальных требований к транспорту". Дополнительные требования включают в себя вид загрузки машины (боковая, задняя и пр.), а также другие требования: манипулятор, растентовка и пр.

PickupParams

PickupParams
Параметр	Обязательный	Тип	Описание
derivalDriverPass	Нет	integer	Время заказа пропуска для въезда на территорию отправителя. Доступные значения: "1" - заказать за час; "24" - заказать за сутки
shipmentRegister	Нет	boolean	Запись на отгрузку. Значение по умолчанию: "false"
paidEntry	Нет	object	Информация о платном въезде на территорию отправителя
paidEntry.Cost	Нет	float	Сумма оплаты
paidEntry.Type	Нет	integer	Вариант возмещения произведённой оплаты. Доступные значения: "1" - по чеку на адресе; "2" - включить в счет
shipmentDerival	Нет	string	Номер отгрузки для получения груза. Максимальная длина поля: 30 символов
priorCall	Нет	boolean	Предварительный звонок. Значение по умолчанию: "false"
noNeedAgreement	Нет	boolean	Не требуется согласование с отправителем. Значение по умолчанию: "false"
documentsForReceive	Нет	array of string	Документы для получения груза. Указываются UID'ы документов из справочника "Документы для получения груза"

Address

Address
Параметр	Обязательный	Тип	Описание
street	Да	string	Код КЛАДР улицы. Может быть получен с помощью сервисов, представленных на странице "Использование кодов КЛАДР"
house	Да	string	Номер дома. Максимальная длина поля: 5 символов
building	Нет	string	Строение. Максимальная длина поля: 5 символов
structure	Нет	string	Корпус. Максимальная длина поля: 5 символов
flat	Нет	string	Квартира. Максимальная длина поля: 5 символов
save	Нет	boolean	Признак сохранения объекта в адресную книгу. Значение по умолчанию: "false". Параметр не используется в блоках "juridicalAddress" класса "Counteragent"

Arrival

Arrival
Параметр	Обязательный	Тип	Описание
variant	Да	string	Способ отправки груза. Доступные значения: "terminal" - доставка груза до терминала; "address" - доставка груза до адреса. *При заказе перевозки малогабаритного груза (значение параметра запроса "delivery.deliverуType.type" - "small") доставка до терминала невозможна
payer	Нет	string	Плательщик по услуге. Доступные значения: "sender" - отправитель; "receiver" - получатель; "third" - третье лицо. Если параметр не передан, то он принимает значение параметра "Request.Payment.primaryPayer"
terminalID	Да*	integer	ID терминала из "Справочника терминалов". Может быть передан только ID терминала по умолчанию (в "Справочнике терминалов" значение параметра "city.terminals.terminal.default" - "true" ). В случае заказа экспресс-перевозки (значение параметра запроса "delivery.deliverуType.type" - "express") терминал должен оказывать услуги по выдаче экспресс-грузов (в "Справочнике терминалов" выбранный терминал должен иметь вложенный параметр "Worktables.Worktable.department" со значением "Выдача грузов экспресс-перевозки"). *Допускается передача только одного из параметров: "terminalID", "addressID", "address", "city"
addressID	Да*	integer	ID адреса из "Адресной книги". *Допускается передача только одного из параметров: "terminalID", "addressID", "address", "city"
address	Да*	Address	Адрес в форме набора параметров. *Допускается передача только одного из параметров: "terminalID", "addressID", "address", "city"
city	Да*	string	Код КЛАДР населенного пункта из "Справочника населенных пунктов". Может быть получен с помощью сервисов, представленных на странице "Использование кодов КЛАДР" Допускается передача только одного из параметров: "terminalID", "addressID", "address", "city". Допускается передача этого параметра, только если в параметре "variant" передано значение "terminal". При передаче этого параметра терминал получения груза определяется автоматически
time	Да*	object	Время передачи груза получателю (на адресе). *Только если выбран способ отправки груза "address"
time.worktimeStart	Да	string	Начало периода передачи груза. Формат: ЧЧ:ММ
time.worktimeEnd	Да	string	Окончание периода передачи груза. Формат: ЧЧ:ММ
time.breakStart	Нет	string	Начало перерыва. Формат: ЧЧ:ММ
time.breakEnd	Нет	string	Окончание перерыва. Формат: ЧЧ:ММ
time.exactTime	Нет	boolean	Передача груза в точное время. Значение по умолчанию: "false"
handling	Нет	object	Погрузо-разгрузочные работы на адресе. ПРР могут быть заказаны только при отправке груза до адреса (в параметре "variant" передано значение "address")
handling.freightLift	Нет	boolean	Есть грузовой лифт. Значение по умолчанию: "false"
handling.toFloor	Нет	integer	Номер этажа, на который требуется подъем. Максимальная длина поля: 5 символов
handling.carry	Нет	integer	Пронос в метрах. Максимальная длина поля: 5 символов
handling.payer	Нет	string	Плательщик по услуге. Доступные значения: "sender" - отправитель; "receiver" - получатель; "third" - третье лицо. Если параметр не передан, то он принимает значение параметра "Request.Payment.primaryPayer"
requirements	Нет	array of string	Дополнительные требования к транспорту. Указываются UID'ы из "Справочника специальных требований к транспорту". Дополнительные требования включают в себя вид загрузки машины (боковая, задняя и пр.), а также другие требования: манипулятор, растентовка и пр.

Requester

Requester
Параметр	Обязательный	Тип	Описание
role	Да	string	Роль в перевозке. Доступные значения: "sender" - отправитель; "receiver" - получатель; "payer" - плательщик; "third" - третье лицо
uid	Да*	string	UID контрагента из "Списка контрагентов". *Параметр не является обязательным и игнорируется при отсутствии полного доступа к контрагентам
email	Нет	string	E-mail заказчика перевозки. Максимальная длина поля: 128 символов

Member

Member
Параметр	Обязательный	Тип	Описание
counteragentID	Да*	integer	ID контрагента из "Адресной книги". *Допускается передача только одного из параметров: "counteragentID", "counteragent"
counteragent	Да*	Counteragent	Контрагент в форме набора параметров. *Допускается передача только одного из параметров: "counteragentID", "counteragent"
contactIDs	Да*	array of integer	Список ID контактных лиц из "Адресной книги". Максимальное количество элементов в массиве: 3. Допускается передача только одного из параметров: "contactIDs", "contactPersons". Параметр не является обязательным и игнорируется для контрагента-"анонимного" получателя (1)
contactPersons	Да*	array of ContactPerson	Список контактных лиц. Максимальное количество элементов в массиве: 3. Допускается передача только одного из параметров: "contactIDs", "contactPersons". Параметр не является обязательным и игнорируется для контрагента-"анонимного" получателя (1)
phoneIDs	Да*	array of integer	Список ID телефонных номеров из "Адресной книги". Максимальное количество элементов в массиве: 3. Допускается передача только одного из параметров: "phoneIDs", "phoneNumbers". Параметр не является обязательным и игнорируется для контрагента-"анонимного" получателя (1)
phoneNumbers	Да*	array of PhoneNumber	Список телефонных номеров. Максимальное количество элементов в массиве: 3. Допускается передача только одного из параметров: "phoneIDs", "phoneNumbers". Параметр не является обязательным и игнорируется для контрагента-"анонимного" получателя (1)
email	Нет	string	E-mail заказчика перевозки. Максимальная длина поля: 128 символов
dataForReceipt	Да*	DataForReceipt	Контактные данные для отправки электронного чека плательщику-физическому лицу *Параметр обязателен для контрагента-физического лица, являющегося плательщиком и не являющегося "анонимным" получателем. Для контрагента-"анонимного" получателя и для контрагента-юридического лица параметр не является обязательным и игнорируется (1)
Примечания: "Анонимный" получатель - получатель, о котором предоставлен минимум информации (см. описание услуги "Упрощённая отправка груза" на сайте компании "Деловые Линии")

Counteragent

Counteragent
Параметр	Обязательный	Тип	Описание
form	Да*	integer	UID организационно-правовой формы (ОПФ) из "Справочника ОПФ". При передаче данных об "анонимном" (1) получателе (значение параметра "isAnonym" - "true") в качестве значения параметра необходимо передать UID физического лица РФ ("0xAB91FEEA04F6D4AD48DF42161B6C2E7A"). *Допускается передача только одного из параметров: "form", "customForm"
customForm	Да*	object	ОПФ в форме набора параметров. *Допускается передача только одного из параметров: "form", "customForm"
customForm.formName	Да	string	Название ОПФ в текстовом формате. Максимальная длина поля: 35 символов
customForm.countryUID	Да	string	UID страны из "Справочника стран"
customForm.juridical	Да	boolean	Признак юридического лица
document	Да*	object	Документ, удостоверяющий личность *Параметр является обязательным, только если оба параметра "customForm.juridical" и "isAnonym" переданы со значением "false"
document.type	Да	string	Тип документа. Доступные значения: "passport" - паспорт; "drivingLicence" - водительское удостоверение; "foreignPassport" - заграничный паспорт. Для некоторых стран значение "foreignPassport" недоступно
document.serial	Да*	string	Серия документа. *Для некоторых стран параметр не является обязательным и игнорируется
document.number	Да	string	Номер документа. Формат номера зависит от страны
isAnonym	Нет	boolean	Признак контрагента-"анонимного" получателя. Если передано значение "true", оформляется упрощенная отправка (1). Передача параметра со значением "true" доступна только для участника перевозки с ролью "Получатель" (блок "Receiver"). Значение по умолчанию: "false".
phone	Да*	string	Номер телефона контрагента-"анонимного" получателя (1). Формат номера: "7ХХХХХХХХХХ" (11 цифр с ведущей семёркой). *Параметр является обязательным только для контрагента-"анонимного" получателя
name	Да	string	Имя контрагента или название юр. лица
inn	Да*	string	ИНН. Максимальная длина поля зависит от страны и ОПФ *Параметр является обязательным только для юр. лица (в параметре "form" передан UID ОПФ юр. лица или "customForm.juridical" = "true")
juridicalAddress	Нет	Address	Юридический адрес. Параметр используется только для юр. лица (в параметре "form" передан UID ОПФ юр. лица или "customForm.juridical" = "true")
save	Нет	boolean	Признак сохранения объекта в адресную книгу. Значение по умолчанию: "false"
Примечания: "Анонимный" получатель - получатель, о котором предоставлен минимум информации (см. описание услуги "Упрощённая отправка груза" на сайте компании "Деловые Линии")

ContactPerson

Параметр

Обязательный

Тип

Описание

name

Да

string

Имя контактного лица

save

Нет

boolean

Признак сохранения объекта в адресную книгу.

Значение по умолчанию: "false".

Параметр игнорируется для третьего лица

PhoneNumber

PhoneNumber
Параметр	Обязательный	Тип	Описание
number	Да	string	Номер телефона. Максимальная длина поля: 15 цифр
ext	Нет	string	Добавочный номер. Максимальная длина поля: 5 цифр
save	Нет	boolean	Признак сохранения объекта в адресную книгу. Значение по умолчанию: "false". Параметр игнорируется для третьего лица

DataForReceipt

DataForReceipt
Параметр	Обязательный	Тип	Описание
send	Да	boolean	Согласие на получение электронного чека об оплате. Доступные значения: "true" - пользователь ввел "phone" и/или "email" для отправки чека; "false" - пользователь отказался предоставлять контактные данные для отправки чека
phone	Да*	string	Номер телефона для отправки чека. Формат номера: "+79XXXXXXXXX" (12 символов: начинается с "+79", и далее 9 цифр) Если "send" = "true", то обязательна передача хотя бы одного из параметров: "phone" или "email" Если "send" = "false", то параметр игнорируется
email	Да*	string	E-mail адрес для отправки чека Если "send" = "true", то обязательна передача хотя бы одного из параметров: "phone" или "email" Если "send" = "false", то параметр игнорируется

Cargo

Cargo
Параметр	Обязательный	Тип	Описание
quantity	Нет	integer	Количество грузовых мест, шт. Значение по умолчанию: "1". Если вид доставки - "письмо" ("Request.Delivery.DeliveryType.type" = "letter"), то переданное значение параметра игнорируется, и используется значение по умолчанию ("1").
length	Да*	float	Длина самого длинного грузового места, м. *Если вид доставки - "письмо" ("Request.Delivery.DeliveryType.type" = "letter"), то параметр не является обязательным, переданное значение параметра игнорируется, и используется значение "0.3"
width	Да*	float	Ширина самого широкого грузового места, м. *Если вид доставки - "письмо" ("Request.Delivery.DeliveryType.type" = "letter"), то параметр не является обязательным, переданное значение параметра игнорируется, и используется значение "0.21"
height	Да*	float	Высота самого высокого грузового места, м. *Если вид доставки - "письмо" ("Request.Delivery.DeliveryType.type" = "letter"), то параметр не является обязательным, переданное значение параметра игнорируется, и используется значение "0.01"
weight	Нет*	float	Вес самого тяжелого грузового места, кг. Если количество грузовых мест > 1 ("Request.Cargo.quantity" > 1), то параметр является обязательным. В противном случае значение параметра считается равным значению параметра "totalWeight" Если вид доставки - "письмо" ("Request.Delivery.DeliveryType.type" = "letter"), то параметр не является обязательным, переданное значение параметра игнорируется, и используется значение "0.5"
totalVolume	Да*	float	Общий объём груза, куб. м. *Если вид доставки - "письмо" ("Request.Delivery.DeliveryType.type" = "letter"), то параметр не является обязательным, переданное значение параметра игнорируется, и используется значение "0.001"
totalWeight	Да*	float	Общий вес груза, кг. *Если вид доставки - "письмо" ("Request.Delivery.DeliveryType.type" = "letter"), то параметр не является обязательным, переданное значение параметра игнорируется, и используется значение "0.5"
oversizedVolume	Нет*	float	Объём негабаритных грузовых мест, куб. м (1). Если вид доставки - "письмо" ("Request.Delivery.DeliveryType.type" = "letter"), то параметр игнорируется. Если по весо-габаритным характеристикам определено, что груз не является габаритным, то параметр является обязательным
oversizedWeight	Нет*	float	Вес негабаритных грузовых мест, кг (1). Если вид доставки - "письмо" ("Request.Delivery.DeliveryType.type" = "letter"), то параметр игнорируется. Если по весо-габаритным характеристикам определено, что груз не является габаритным, то параметр является обязательным
hazardClass	Нет	float	Класс опасности груза. Значение по умолчанию: "0"
insurance	Нет	object	Информация о страховании груза
insurance.statedValue	Нет	float	Объявленная стоимость груза, руб. Максимальная длина поля: 12 символов
insurance.payer	Нет	string	Плательщик по услуге. Доступные значения: "sender" - отправитель; "receiver" - получатель; "third" - третье лицо. Если параметр не передан, то он принимает значение параметра "Request.Payment.primaryPayer"
insurance.term	Нет	boolean	Признак страхования срока доставки груза. Значение по умолчанию: "true"
freightName	Да*	string	Характер груза в текстовом формате. *Допускается передача только одного из параметров: "freightName", "freightUID"
freightUID	Да*	string	UID характера груза из справочника "Характер груза". Для поиска UID по наименованию груза следует воспользоваться методом "Характер груза по введенной строке" *Допускается передача только одного из параметров: "freightName", "freightUID"
Примечания: Негабаритное грузовое место - это грузовое место, вес которого больше либо равен 100 кг (80 кг в случае перевозки авиатранспортом) или одно из измерений (ДШВ) которого больше либо равно 3 м (80 см в случае перевозки авиатранспортом)

CashOnDelivery

CashOnDelivery
Параметр	Обязательный	Тип	Описание
orderNumber	Нет	string	Внутренний номер заказа клиента (например, номер заказа интернет-магазина). Параметр может быть использован для передачи внутреннего номера заказа не только в случае оплаты наложенным платежом
orderDate	Нет	date	Дата заказа. Формат: "ГГГГ-ММ-ДД"
paymentType	Нет	string	Заявленный вид оплаты. Доступные значения: "cash" - оплата наличными; "card" - оплата картой
products	Нет	array of Product	Описание номенклатурного состава груза

Product

Product
Параметр	Обязательный	Тип	Описание
productName	Да	string	Наименование товара
productCode	Нет	string	Номенклатурный номер (артикул)
productAmount	Да	integer	Количество
costWithVAT	Да	float	Цена за ед. с НДС, руб.
VATRate	Нет	integer	Ставка НДС, %. Доступные значения: "0"; "10"; "20". Если товар не облагается НДС, то следует передавать не нулевое значение, а просто не передавать параметр
Примечания: При оформлении наложенного платежа общая сумма по заказу (то есть сумма произведений значений параметров "costWithVAT" и "productAmount" каждого из элементов массива "CashOnDelivery.products") должна быть целым числом

Ответ метода

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

JSON
XML

{  
   "metadata":{  
      "status":200,
      "generated_at":"2015-06-18 12:37:28"
   },
   "data":{  
      "state":"success",
      "requestID":"3954004",
      "barcode":"41508460D0905400400000014",
      "addressBook":{  
         "sender":{  
            "counteragent":{  
               "id":2132424,
               "state":"existed"
            },
            "address":{  
               "id":89985444,
               "state":"new"
            },
            "contactPersons":[  
               {  
                  "id":78436784,
                  "state":"existed",
                  "value":"Иван Иванович"
               },
               {  
                  "id":3778489,
                  "state":"new",
                  "value":"Петр Петрович"
               }
            ],
            "phoneNumbers":[  
               {  
                  "id":6543687564,
                  "state":"existed",
                  "value":"795545785587"
               },
               {  
                  "id":4574583767,
                  "state":"new",
                  "value":"0127588848887588"
               }
            ]
         }
      }
   }
}

<response>
   <metadata>
      <status>200</status>
      <generated_at>2015-06-18 12:37:28</generated_at>
   </metadata>
   <data>
      <state>success</state>
      <requestID>3954004</requestID>
      <barcode>41508460D0905400400000014</barcode>
      <addressBook>
         <sender>
            <counteragent>
               <id>2132424</id>
               <state>existed</state>
            </counteragent>
            <address>
               <id>89985444</id>
               <state>new</state>
            </address>
            <contactPersons>
               <id>78436784</id>
               <state>existed</state>
               <value>Иван Иванович</value>
            </contactPersons>
            <contactPersons>
               <id>3778489</id>
               <state>new</state>
               <value>Петр Петрович</value>
            </contactPersons>
            <phoneNumbers>
               <id>6543687564</id>
               <state>existed</state>
               <value>795545785587</value>
            </phoneNumbers>
            <phoneNumbers>
               <id>4574583767</id>
               <state>new</state>
               <value>0127588848887588</value>
            </phoneNumbers>
         </sender>
      </addressBook>
   </data>
</response>

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

Response

Response
Параметр	Тип	Описание
metadata	object	Системная информация
metadata.status	integer	Эмуляция http-кода состояния. В случае успешного выполнения возвращается код "200" (OK)
metadata.generated_at	string	Дата и время генерации ответа сервера. Формат: "ГГГГ-ММ-ДД ЧЧ:ММ:СС"
data	Data	Информация по итогу формирования заявки

Data

Data
Параметр	Тип	Описание
state	string	Статус обработки запроса
requestID	string	Номер созданного предзаказа или заявки
barcode	string	Barcode для формирования штрихкода по алгоритму Code 128, если оформлен предзаказ (то есть, если значение параметра запроса "delivery.derival.variant" - "terminal")
addressBook	AddressBook	Информация о сохранении данных в адресную книгу

AddressBook

AddressBook
Параметр	Тип	Описание
sender	Member	Отправитель
receiver	Member	Получатель
third	Member	Третье лицо

Member

Member
Параметр	Тип	Описание
counteragent	object	Данные контрагента
counteragent.id	integer	ID контрагента
counteragent.state	string	Статус контрагента. Возможные значения: "existed" - существующий; "new" - новый
address	object	Данные об адресе
address.id	integer	ID адреса
address.state	string	Статус адреса. Возможные значения: "existed" - существующий; "new" - новый
contactPersons	array of ContactPerson	Список контактных лиц
phoneNumbers	array of PhoneNumber	Список телефонных номеров

ContactPerson

ContactPerson
Параметр	Тип	Описание
id	integer	ID контактного лица
state	string	Статус контактного лица. Возможные значения: "existed" - существующее; "new" - новое
value	string	ФИО контактного лица

PhoneNumber

PhoneNumber
Параметр	Тип	Описание
id	integer	ID телефонного номера
state	string	Статус телефонного номера. Возможные значения: "existed" - существующий; "new" - новый
value	string	Телефонный номер

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

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

Номер ошибки	http-код	Краткое описание	Детальное описание
609013	400	Ошибка параметров оплаты	Детальное описание ошибки см. в поле "detail" ответа
609016	400	Ошибка при сохранении заявки	Невозможно сохранить заявку

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

Оформление заявок на перевозку из Личного Кабинета

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

Оформление заявок

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

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

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

Request

DeliveryType

Package

AcDoc

Derival

PickupParams

Address

Arrival

Requester

Member

Counteragent

ContactPerson

PhoneNumber

DataForReceipt

Cargo

CashOnDelivery

Product

Ответ метода

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

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

Response

Data

AddressBook

Member

ContactPerson

PhoneNumber

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