Orders for shipping from the personal account

To get the session ID, use the User Authorization method

If the value is "false", then the order is saved, but is not processed (is necessary in case the order will be included into a multi-request).

Default value: "true"

Delivery type for terminal-to-terminal shipping

List of required packages

Phone number for SMS-notifications.

Format: "7XXXXXXXXXX" (11 figures, starts with 7)

Comment to the order.

Maximum field length: 500 characters

Payer for the service.

Available values:

• "sender";
• "receiver";
• "third" (third party).

If parameter is not passed, then it takes the value of the parameter "Request.Payment.primaryPayer"

Payer for the service.

Available values:

• "sender";
• "receiver";
• "third" (third party).

If parameter is not passed, then it takes the value of the parameter "Request.Payment.primaryPayer"

Number of bags or boxes.

Parameter is required if the package "bag" ("Упаковка мешок") or "carton box" ("Картонная коробка") is selected

Action over accompanying documents.

Available values:

• "send";
• "return"

Payer for the service.

Available values:

• "sender";
• "receiver";
• "third" (third party).

If parameter is not passed, then it takes the value of the parameter "Request.Payment.primaryPayer"

Date of cargo transfer to the terminal of departure or date of truck arrival to the sender.

Format: YYY-MM-DD

Additional parameters of cargo delivery from the address

Shipping method.

Available values:

• "terminal" - delivery from the terminal;
• "address" - delivery from the address.

If delivery from the address is ordered, then the order is placed, if delivery from the terminal - then pre-order.

If small-size cargo delivery is ordered ("delivery.deliverуType.type" request parameter value is "small"), then delivery from the terminal is not available

Payer for the service.

Available values:

• "sender";
• "receiver";
• "third" (third party).

If parameter is not passed, then it takes the value of the parameter "Request.Payment.primaryPayer"

Terminal ID from the "Terminals" directory.

In case of express delivery ("delivery.deliverуType.type" request parameter value is "express") the terminal should accept express cargoes (there should be "Worktables.Worktable.department" parameter with "Приём груза к экспресс-перевозке" value for the selected terminal in Terminals directory).

*It's possible to pass only one of parameters: "terminalID", "addressID", "address"

Address ID from the "Address book".

*It's possible to pass only one of parameters: "terminalID", "addressID", "address"

Address as a set of parameters.

*It's possible to pass only one of parameters: "terminalID", "addressID", "address"

Address ID from the "Address book".

*It's possible to pass only one of parameters: "addressID", "address"

Address as a set of parameters.

*It's possible to pass only one of parameters: "addressID", "address"

Payer for the service.

Available values:

• "sender";
• "receiver";
• "third" (third party).

If parameter is not passed, then it takes the value of the parameter "Request.Payment.primaryPayer"

Time of cargo picking up.

*Parameter is required only if specified shipping method is "address"

Beginning of period of cargo picking up.

Format: HH:MM

End of period of cargo picking up.

Format: HH:MM

Beginning of the break.

Format: HH:MM

End of the break.

Format: HH:MM

Delivery at the exact time.

Default value: "false"

There is a freight elevator.

Default value: "false"

Number of the floor.

Maximum number of characters - 5

The distance of carrying the load manually.

Maximum number of characters - 5

Payer for the service.

Available values:

• "sender";
• "receiver";
• "third" (third party).

If parameter is not passed, then it takes the value of the parameter "Request.Payment.primaryPayer"

Array of UID's of special requirements for transport from the Directory of Special Requirements for Transport.

Special requirements include type of truck loading (side, rear, etc.) and other requirements: manipulator, tenting removal, etc.

Parameter determining the need to order a pass by the driver of DL to enter the territory of the sender and time that it takes.

Available values:

• "1" - an hour before enter the territory of the sender;
• "24" - one day before enter the territory of the sender

Parameter determining the need to make an appointment by the driver of DL to pick-up the cargo at the sender's address.

Default value: "false"

Reimbursement method.

Available values:

• "1" - by the check at the address;
• "2" - include in the bill

Parameter determining the need to provide the pick-up number by the driver of DL in order to pick-up the cargo at the sender's territory. Parameter should contain the pick-up number.

Maximum number of characters - 30

Parameter determining the need of advance call from the driver of DL to the sender before the picking-up of the cargo.

Default value: "false"

Parameter determining the need to agree the order for shipment with the sender.

Available values:

• "true" - not need to agree;
• "false" - need to agree (default value)

List of the documents that the driver of DL has to have in order to pick-up the cargo at the sender's territory. Should be specified using the "Documents for receipt of cargo" directory

CLADR code of the street. It's possible to get CLADR code using the services presented on the page "Using CLADR codes" (2)

House (2).

Maximum number of characters - 5

Building (2).

Maximum number of characters - 5

Structure (2).

Maximum number of characters - 5

Apartment/office (2).

Maximum number of characters - 5

Indicator of saving the object in the address book.

Default value: "false".

Parameter is not used in blocks "juridicalAddress" of class "Counteragent"

Notes:

1. Address information must be passed in the request therefore either "search" parameter is required or "street" and "house" parameters are required.
2. If "search" parameter is passed in the request, then "street", "house", "building", "structure" or "flat" parameters must not be passed in the request

Shipping method.

Available values:

• "terminal" - delivery to the terminal;
• "address" - delivery to the address.

If small-size cargo delivery is ordered ("delivery.deliverуType.type" request parameter value is "small"), then delivery to the terminal is not available

Payer for the service.

Available values:

• "sender";
• "receiver";
• "third" (third party).

If parameter is not passed, then it takes the value of the parameter "Request.Payment.primaryPayer"

Terminal ID from the "Terminals" directory.

*It is only possible to choose default terminal in this case (in Terminals directory "city.terminals.terminal.default" parameter value should be "true" )

If express delivery is ordered ("delivery.deliverуType.type" parameter value is "express"), the terminal should give out express cargoes (there should be "Worktables.Worktable.department" parameter with "Выдача грузов экспресс-перевозки" value for the selected terminal in Terminals directory).

*It's possible to pass only one of parameters: "terminalID", "addressID", "address", "city"

Address ID from the "Address book".

*It's possible to pass only one of parameters: "terminalID", "addressID", "address", "city"

Address as a set of parameters.

*It's possible to pass only one of parameters: "terminalID", "addressID", "address", "city"

CLADR code of the city. It's possible to get CLADR code using the services presented on the page "Using CLADR codes"

*It's possible to pass only one of parameters: "terminalID", "addressID", "address", "city"

*This parameter is allowed to be passed if parameter "variant" has the value "terminal".

When this parameter is passed the arrival terminal is determined automatically

Time of cargo delivery.

*Parameter is required only if specified shipping method is "address"

Beginning of period of cargo delivery.

Format: HH:MM

End of period of cargo delivery.

Format: HH:MM

Beginning of the break.

Format: HH:MM

End of the break.

Format: HH:MM

Delivery at the exact time.

Default value: "false"

Loading and unloading works at the address.

Such works may be ordered in case of delivery to the address (parameter "variant" has the value "address")

There is a freight elevator.

Default value: "false"

Number of the floor to which the cargo is to be lifted.

Maximum number of characters - 5

The distance of carrying the load manually.

Maximum number of characters - 5

Payer for the service.

Available values:

• "sender";
• "receiver";
• "third" (third party).

If parameter is not passed, then it takes the value of the parameter "Request.Payment.primaryPayer"

Array of UID's of special requirements for transport from the Directory of Special Requirements for Transport.

Special requirements include type of truck loading (side, rear, etc.) and other requirements: manipulator, tenting removal, etc.

Role in shipping.

Available values:

• "sender";
• "receiver";
• "payer";
• "third" (third party).

Counterparty UID from the "List of available counterparties".

*Parameter is not required and ignored in case of absence of the full access to the counterparties

E-mail of the order requester.

Maximum number of characters - 128

Counterparty ID from the "Address book".

*It's possible to pass only one of parameters: "counteragentID", "counteragent"

Counterparty as a set of parameters.

*It's possible to pass only one of parameters: "counteragentID", "counteragent"

List of ID's of contact persons from the "Address book".

Maximum number of items in array - 3.

*It's possible to pass only one of parameters: "contactIDs", "contactPersons".

*Parameter is not required and ignored for counterparty that is an "anonymous" receiver (1)

Indicator of saving the object in the address book.

Default value: "false".

Parameter is ignored for the third party

List of ID's of phone numbers from the "Address book".

Maximum number of items in array - 3.

*It's possible to pass only one of parameters: "phoneIDs", "phoneNumbers".

*Parameter is not required and ignored for counterparty that is an "anonymous" receiver (1)

Phone number.

Maximum 15 digits

Extension.

Maximum 5 digits

Indicator of saving the object in the address book.

Default value: "false".

Parameter is ignored for the third party

E-mail of the order requester.

Maximum number of characters - 128

Contact information for sending an electronic payment receipt to the payer that is a physical party

*Parameter is required for the counterparty, that is a physical party and is not an "anonymous" receiver. Otherwise, parameter is not required and ignored (1)

Consent to receive an electronic payment receipt. Available values:

• "true" - user passed "phone" and/or "email" to send payment receipt;
• "false" - user refused to provide contact information to send payment receipt

Phone number to send payment receipt.

Format: "+79XXXXXXXXX" (12 figures, starts with "+79" and then 9 digits)

*If "send" = "true", than at least one of the parameters is required: "phone" or "email"

*If "send" = "false", than parameter is ignored

E-mail to send payment receipt

*If "send" = "true", than at least one of the parameters is required: "phone" or "email"

*If "send" = "false", than parameter is ignored

Notes:

1. "Anonymous" receiver - a receiver on whom minimum info was provided.

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

UID of legal form of organization. Value from the "Directory of legal forms of organization".

When passing data about the "anonymous" (1) receiver ("isAnonym" parameter value is "true") it is necessary to pass UID of individual in Russian Federation ("0xAB91FEEA04F6D4AD48DF42161B6C2E7A").

*It's possible to pass only one of parameters: "form", "customForm"

Legal form of organization as a set of parameters.

*It's possible to pass only one of parameters: "form", "customForm"

Name of legal form of organization.

Maximum number of characters - 35

Personal identification document

*Parameter is required only if both of parameters "customForm.juridical" and "isAnonym" are passed with the value "false"

Document type.

Available values:

• "passport";
• "drivingLicence";
• "foreignPassport".

The value "foreignPassport" is unavailable for some countries

Serial of the document.

*Parameter is not required and ignored for some countries

Document number.

Format depends on the country

Flag indicating that counterparty is an "anonymous" receiver, that is minimal information about the receiver is provided, this service is called simplified shipment (1).

It's possible to pass this parameter with value "true" only for the receiver.

Default value: "false"

Phone number of counterparty that is an "anonymous" receiver (1).

Format: "7ХХХХХХХХХХ" (11 digits, starts with "7").

*Parameter is required only for counterparty that is an "anonymous" receiver

Name of counterparty

Counterparty TIN (taxpayer identification number).

Maximum number of characters depends on the country and legal form of organization

*Parameter is required only for juridical party (parameter "form" has value that is an UID of legal form or organization of juridical party or "customForm.juridical" = "true")

Juridical address.

Parameter is used only for juridical party (parameter "form" has value that is an UID of legal form or organization of juridical party or "customForm.juridical" = "true")

Indicator of saving the object in the address book.

Default value: "false"

Notes:

1. "Anonymous" receiver - a receiver on whom minimum info was provided.

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

Quantity of cargo pieces, pcs.

Default value: "1".

If delivery type is "letter" ("Request.Delivery.DeliveryType.type" = "letter"), then the passed value is ignored, parameter takes the default value ("1")

Length of the longest cargo piece, m.

*If delivery type is "letter" ("Request.Delivery.DeliveryType.type" = "letter"), then this parameter is not required, passed value is ignored, parameter takes the value "0.3"

Width of the widest cargo piece, m.

*If delivery type is "letter" ("Request.Delivery.DeliveryType.type" = "letter"), then this parameter is not required, passed value is ignored, parameter takes the value "0.21"

Height of the highest cargo piece, m.

*If delivery type is "letter" ("Request.Delivery.DeliveryType.type" = "letter"), then this parameter is not required, passed value is ignored, parameter takes the value "0.01"

Weight of the heaviest cargo piece, kg.

*If quantity of cargo pieces > 1 ("Request.Cargo.quantity" > 1), then this parameter is required. Otherwise, this parameter takes the value of the parameter "totalWeight".

*If delivery type is "letter" ("Request.Delivery.DeliveryType.type" = "letter"), then this parameter is not required, passed value is ignored, parameter takes the value "0.5"

Total cargo volume, cub. m.

*If delivery type is "letter" ("Request.Delivery.DeliveryType.type" = "letter"), then this parameter is not required, passed value is ignored, parameter takes the value "0.001"

Total cargo weight, kg.

*If delivery type is "letter" ("Request.Delivery.DeliveryType.type" = "letter"), then this parameter is not required, passed value is ignored, parameter takes the value "0.5"

oversizedWeight

Weight of oversized cargo places, kg (1).

*If delivery type is "letter" ("Request.Delivery.DeliveryType.type" = "letter"), then this parameter is ignored.

*If according to the weight-dimensional characteristics it is determined that the cargo is oversized, then this parameter is required

Volume of oversized cargo places, cub. m (1).

*If delivery type is "letter" ("Request.Delivery.DeliveryType.type" = "letter"), then this parameter is ignored.

*If according to the weight-dimensional characteristics it is determined that the cargo is oversized, then this parameter is required

Hazard class of cargo.

Default value: "0"

Declared value of the cargo, rub.

Maximum number of characters - 12

Payer for the service.

Available values:

• "sender";
• "receiver";
• "third" (third party).

If parameter is not passed, then it takes the value of the parameter "Request.Payment.primaryPayer"

Flag of insurance of delivery time.

Default value: "true"

UID of nature of cargo from the "Nature of cargo" directory. To search for UID by the name of cargo use the Cargo Type by an Input String method.

*It's possible to pass only one of parameters: "freightName", "freightUID"

Nature of cargo (textual value).

*It's possible to pass only one of parameters: "freightName", "freightUID"

Notes:

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

Payment type.

Available values:

• "cash" - by cash or credit card;
• "noncash" - by bank transfer

Default payer. Specified party pays for the main service (terminal-to-terminal shipping) and all other services, unless other payers are specified for them.

Available values:

• "sender";
• "receiver";
• "third"

CLADR code of the city. It's possible to get CLADR code using the services presented on the page "Using CLADR codes".

(CLADR - Classifier of Addresses of Russian Federation).

*If one of the payers is the third party then one of the excluding parameters - "paymentCity" or "paymentCitySearch" is required

City as a string. Minimum 2 symbols, maximum 1024. Along with the name of the city it is possible to pass the name of the country, region or district - this will allow refining the search and eliminating errors that may occur since the cities can have the identical names

Cash on delivery.

Cash on delivery is only possible if the following requirements are met:

1. The requester is a legal entity, "Cash on delivery" service is available to the requester (to make the service available, please contact Delovye Linii company manager).
2. The requester is the sender ("members.requester.role" parameter value is "sender").
3. The receiver is an individual.

In case of cash on delivery it is not possible to order the delivery to the receiver's address ("delivery.arrival.variant" parameter value should be "terminal")

It's possible to pass only one item of array currently. Other passed elements are ignored

Order date.

Format: "YYYY-MM-DD"

Payment type.

Available values:

• "cash" - by cash;
• "card" - by card

List of products

Product name

Product code

Quantity

Cost with VAT, rub.

VAT rate, %.

Available values:

• "0";
• "10";
• "20".

If the goods are not subject to VAT, then you should not transfer a zero value, but simply do not pass the parameter

Notes:

1. In case of cash on delivery the total amount must be an integer (that is the sum of the products of "costWithVAT" and "productAmount" parameters values of all the "CashOnDelivery.products" array elements should be an integer)

Emulated http-code of status. In case of success the code "200" returns

Date and time of the server response generation.

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

Information about the order

id

state

Object status. Possible Values:

• "existing" - the existing object has been edited;
• "new" - a new object has been created

value

Entered value

Address/city found