3.11. Создание заказа

Создание заказа на ближайшее доступное время.

Request

POST

b2b.taxi.tst.yandex.net/api/b2b/platform/request/create

Тестовое окружение

POST

b2b-authproxy.taxi.yandex.net/api/b2b/platform/request/create

Продакшен-окружение

Query parameters

Name

Description

send_unix

Type: boolean

Формат времени, в котором нужно отправить интервалы доставки (true - unix, false - utc)

Headers

Name

Description

Accept-Language*

Type: string

Язык ответа

Body

application/json

{
    "info": {
        "operator_request_id": "string",
        "comment": "string"
    },
    "source": {
        "platform_station": {
            "platform_id": "string"
        },
        "interval": {
            "from": 1635174000,
            "to": 1635174000
        },
        "interval_utc": {
            "from": "2021-10-25T15:00:00.000000Z",
            "to": "2021-10-25T15:00:00.000000Z"
        }
    },
    "destination": {
        "type": "platform_station",
        "platform_station": {
            "platform_id": "string"
        },
        "custom_location": {
            "latitude": 0,
            "longitude": 0,
            "details": {
                "geoId": "213",
                "country": "Россия",
                "region": "Москва",
                "subRegion": "string",
                "locality": "Москва",
                "street": "Пролетарский проспект",
                "house": "19",
                "housing": "string",
                "apartment": "string",
                "building": "string",
                "comment": "string",
                "full_address": "Москва, Пролетарский проспект, 19",
                "postal_code": "string"
            }
        },
        "interval": {
            "from": 1635174000,
            "to": 1635174000
        },
        "interval_utc": {
            "from": "2021-10-25T15:00:00.000000Z",
            "to": "2021-10-25T15:00:00.000000Z"
        }
    },
    "items": [
        {
            "count": 0,
            "name": "string",
            "article": "string",
            "marking_code": "string",
            "uin": "string",
            "billing_details": {
                "inn": "string",
                "nds": 0,
                "unit_price": 0,
                "assessed_unit_price": 0
            },
            "physical_dims": {
                "dx": 0,
                "dy": 0,
                "dz": 0,
                "predefined_volume": 0
            },
            "place_barcode": "string"
        }
    ],
    "places": [
        {
            "physical_dims": {
                "weight_gross": 0,
                "dx": 0,
                "dy": 0,
                "dz": 0,
                "predefined_volume": 0
            },
            "barcode": "string",
            "description": "string"
        }
    ],
    "billing_info": {
        "payment_method": "already_paid",
        "delivery_cost": 0
    },
    "recipient_info": {
        "first_name": "string",
        "last_name": "string",
        "partonymic": "string",
        "phone": "string",
        "email": "string"
    },
    "last_mile_policy": "time_interval",
    "particular_items_refuse": false
}

Name	Description
billing_info*	Type: BillingInfo Данные для биллинга
destination*	Type: DestinationRequestNode Информация о точке получения заказа
info*	Type: RequestInfo Базовый набор метаданных по запросу
items*	Type: RequestResourceItem[] Информация о предметах в заказе Min items: `1`
last_mile_policy*	Type: LastMilePolicy Требуемый способ доставки Enum: `time_interval`, `self_pickup`
places*	Type: ResourcePlace[] Информация о местах в заказе Min items: `1`
recipient_info*	Type: Contact Данные о получателе
source*	Type: SourceRequestNode Информация о точке отправления заказа
particular_items_refuse	Type: boolean Разрешен ли частичный выкуп `true` — разрешен частичный выкуп заказа `false` — частичный выкуп заказа недоступен Значение по умолчанию: false Default: `false`

BillingInfo

Name

Description

payment_method*

Type: PaymentMethod

Метод оплаты

Enum: already_paid, cash_on_receipt, card_on_receipt

delivery_cost

Type: integer

Сумма, которую нужно взять с получателя за доставку. Актуально только для заказов с постоплатой (типы оплаты cash_on_receipt и card_on_receipt)

DestinationRequestNode

Name	Description
type*	Type: string Тип целевой точки. Для доставки до двери — `custom_location` (2), для доставки до ПВЗ — `platform_station` (1) Enum: `platform_station`, `custom_location`
custom_location	Type: CustomLocation Полное описание целевого адреса доставки
interval	Type: TimeInterval Временной интервал (в UNIX)
interval_utc	Type: TimeIntervalUTC Временной интервал (в UTC)
platform_station	Type: PlatformStation Описание целевой станции в случае, если она зарегистрирована в платформе

RequestInfo

Name

Description

operator_request_id*

Type: string

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

comment

Type: string

Опциональный коментарий

RequestResourceItem

Name	Description
article*	Type: string Артикул
billing_details*	Type: ItemBillingDetails Данные по биллингу для предмета
count*	Type: integer Количество
name*	Type: string Название
place_barcode*	Type: string Штрихкод коробки, к которой относится товар
marking_code	Type: string Код для маркировки
physical_dims	Type: ItemPhysicalDimensions Физические параметры объекта
uin	Type: string Уникальный идентификатор

LastMilePolicy

Типы полиси доставки последней мили. Может принимать значение только из enum.
time_interval: Доставка до двери в указанный интервал
self_pickup: Доставка до пункта выдачи

Type	Description
LastMilePolicy	Enum: `time_interval`, `self_pickup`

ResourcePlace

Name	Description
barcode*	Type: string Штрихкод коробки. По умолчанию штрихкод грузоместа подменяется на уникальный на стороне Яндекс Доставки. Чтобы использовать собственные штрихкоды или работать с кастомными маркировками, обратитесь к менеджеру. Для получения актуальных штрихкодов возмользуйтесь методом 3.03. Получение информации о заявке.
physical_dims*	Type: PlacePhysicalDimensions Физические параметры места
description	Type: string Описание коробки

Contact

Name	Description
first_name*	Type: string Имя
phone*	Type: string Номер телефона
email	Type: string Адрес электронной почты
last_name	Type: string Фамилия
partonymic	Type: string Отчество

SourceRequestNode

Name	Description
platform_station*	Type: PlatformStation Описание целевой станции в случае, если она зарегистрирована в платформе
interval	Type: TimeInterval Временной интервал (в UNIX)
interval_utc	Type: TimeIntervalUTC Временной интервал (в UTC)

PaymentMethod

Type	Description
PaymentMethod	Enum: `already_paid`, `cash_on_receipt`, `card_on_receipt`

CustomLocation

Информация о произвольной точке. Точка может быть задана либо своими координатами — пара (latitude, longitude), либо адресом

Name	Description
details	Type: LocationDetails Дополнительная информация о расположении станции
latitude	Type: number Широта
longitude	Type: number Долгота

TimeInterval

Интервал времени в формате UNIX

Name

Description

from

Type: integer

UNIX timestamp для нижней границы интервала

Example: 1635174000

Type: integer

UNIX timetamp для верхней границы интервала

Example: 1635174000

TimeIntervalUTC

Интервал времени в формате UTC.

Name

Description

from

Type: string

UTC timestamp для нижней границы интервала

Example: 2021-10-25T15:00:00.000000Z

Type: string

UTC timetamp для верхней границы интервала

Example: 2021-10-25T15:00:00.000000Z

PlatformStation

Name

Description

platform_id

Type: string

Идентификатор станции в Логистической платформе (например, склад отгрузки или ПВЗ)

ItemBillingDetails

Name	Description
assessed_unit_price*	Type: integer Оценочная цена за единицу товара (передается в копейках)
unit_price*	Type: integer Цена за единицу товара (передается в копейках)
inn	Type: string ИНН
nds	Type: integer Значение НДС. Допустимые значения — `0`, `5`, `7`, `10`, `20`. Если заказ `без НДС`, передавайте значение `-1`

ItemPhysicalDimensions

Указываются либо габариты (dx, dy, dz), либо объем в см3 (predefined_volume)

Name	Description
dx	Type: integer Длина, сантиметры
dy	Type: integer Высота, сантиметры
dz	Type: integer Ширина, сантиметры
predefined_volume	Type: integer Объем (в см3)

PlacePhysicalDimensions

Весогабаритные характеристики грузомест

Name	Description
dx*	Type: integer Длина, сантиметры
dy*	Type: integer Высота, сантиметры
dz*	Type: integer Ширина, сантиметры
weight_gross*	Type: integer Вес брутто, граммы
predefined_volume	Type: integer Объем (в см3)

LocationDetails

Адрес квартиры обязателен при наличии

Name	Description
apartment	Type: string Номер квартиры
building	Type: string Строение
comment	Type: string Комментарий
country	Type: string Страна Example: `Россия`
full_address	Type: string Полный адрес с указанием города, улицы и номера дома Example: `Москва, Пролетарский проспект, 19`
geoId	Type: number Идентификатор города Example: `213`
house	Type: string Номер дома Example: `19`
housing	Type: string Корпус
locality	Type: string Населенный пункт Example: `Москва`
postal_code	Type: string Индекс
region	Type: string Регион Example: `Москва`
street	Type: string Улица Example: `Пролетарский проспект`
subRegion	Type: string Область

Responses

200 OK

Body

application/json

{
    "request_id": "string"
}

Name

Description

request_id

Type: string

Идентификатор только что созданного заказа

400 Bad Request

Ошибка в данных пользователя

Body

application/json

{
    "code": "bad_request",
    "message": "Missing field request_id"
}

Name

Description

code*

Type: string

Код ошибки

Example: bad_request

message*

Type: string

Человекочитаемые детали ошибки

Example: Missing field request_id

404 Not Found

Нет доступных вариантов доставки

Body

application/json

{
    "code": "no_delivery_options",
    "message": "No delivery options for interval"
}

Name

Description

code*

Type: string

Код ошибки

Example: no_delivery_options

message*

Type: string

Человекочитаемые детали ошибки

Example: No delivery options for interval

Была ли статья полезна?

3.10. Отмена заявки

3.12. Редактирование грузомест заказа