Same-day delivery
The method returns a list of services available at the point, taking into account their options.
The response contains two objects:
- express_delivery — contains available rates and options for "Express delivery".
- same_day_delivery — contains available intervals for "Same-day delivery".
Each object contains the field ''allowed'' that indicates whether this option is available for the specified rate.
Request
POST
b2b.taxi.yandex.net/b2b/cargo/integration/v2/delivery-methods
Service URL
Headers
Name |
Description |
Accept-Language* |
Type: string Preferred response language. Examples: "en" — English |
Body
application/json
{
"start_point": [
0.1,
0.1
],
"fullname": "One Central Building 5, Trade Center Second, Dubai"
}
Name |
Description |
fullname |
Type: string Full address with an indication of the city, street, and house number. Example: |
start_point |
Type: number[] Coordinates of points in the form of an array of two real numbers: longitude and latitude — exactly in that order. Example: Max items: Min items: |
Responses
200 OK
OK
Body
application/json
{
"express_delivery": {
"allowed": false,
"available_tariffs": [
{
"name": "cargo",
"title": "Express",
"text": "Express rate",
"minimal_price": 213,
"supported_requirements": [
{
"name": "cargo_type",
"title": "Body type",
"text": "Vehicle dimension requirement",
"type": "select",
"required": false,
"options": [
{
"title": "Small body",
"text": "170 cm long, 100 cm wide, 90 cm high",
"value": "van"
}
]
},
{
"name": "string",
"title": "string",
"text": "string",
"type": "bool",
"default": false,
"required": false
}
],
"delivery_options": [
{
"description": "string"
}
]
}
]
},
"same_day_delivery": {
"allowed": false,
"available_intervals": [
{
"from": "2020-01-01T00:00:00+00:00",
"to": "2020-01-02T00:00:00+00:00"
}
]
}
}
Name |
Description |
express_delivery* |
Type: ExpressDeliveryInfo Information about the available "Express delivery" rates |
same_day_delivery* |
Type: SameDayDeliveryInfo Information about the available "Same-day delivery" intervals |
ExpressDeliveryInfo
Information about the available "Express delivery" rates
Name |
Description |
allowed* |
Type: boolean "Express delivery" is available |
available_tariffs* |
Type: B2BTariff[] Available "Express delivery" rates |
SameDayDeliveryInfo
Information about the available "Same-day delivery" intervals
Name |
Description |
allowed* |
Type: boolean "Same-day delivery" is available |
available_intervals* |
Type: TimeInterval[] Available "Same-day delivery" intervals |
B2BTariff
Name |
Description |
minimal_price* |
Type: number Minimum cost Example: |
name* |
Type: string Rate Example: |
supported_requirements* |
Type: (SelectRequirement Supported delivery requirements |
text* |
Type: string Rate description Example: |
title* |
Type: string Rate name Example: |
delivery_options |
Type: DeliveryOption[] |
TimeInterval
Time interval
Name |
Description |
from* |
Type: string<date-time> Interval start Example: |
to* |
Type: string<date-time> Interval end (date and time) Example: |
SelectRequirement
Requirement with a few options
Name |
Description |
name* |
Type: string Requirement type Example: |
options* |
Type: CargoRequirementChoice[] Possible selection options Min items: |
required* |
Type: boolean Mandatory requirement for creating an order |
text* |
Type: string Localized description of the requirement type Example: |
title* |
Type: string Localized requirement name Example: |
type* |
Type: SelectType Selection type: single or multiple Example: Enum: |
BoolRequirement
"Yes/no" requirement format
Name |
Description |
default* |
Type: boolean Default value |
name* |
Type: string Requirement type |
required* |
Type: boolean You must select a field |
text* |
Type: string Localized description of the requirement type |
title* |
Type: string Localized name of the requirement type |
type* |
Type: string Selection type: yes or no Enum: |
DeliveryOption
Name |
Description |
description* |
Type: string Localized description |
CargoRequirementChoice
Name |
Description |
text* |
Type: string Localized requirement description Example: |
title* |
Type: string Localized requirement name Example: |
value* |
Type: string The value that needs to be entered to take into account the requirement when creating an order Example: |
SelectType
Selection type: single or multiple
Type |
Description |
Example: Enum: |
400 Bad Request
Invalid request
Body
application/json
{
"code": "bad_request",
"message": "bad request"
}
Name |
Description |
code* |
Type: string Error code Example: Enum: |
message* |
Type: string Error description Example: |