Получение доступных вариантов доставки заказов

Info

Console

Метод доступен для модели LaaS.

Пока недоступен для продавцов Market Yandex Go.

Если вы используете API-Key-токен, для вызова метода необходим один из доступов в списке

inventory-and-order-processing — Обработка заказов и учёт товаров
inventory-and-order-processing:read-only — Просмотр информации о заказах
pricing — Управление ценами
pricing:read-only — Просмотр цен
all-methods — Полное управление кабинетом
all-methods:read-only — Просмотр всех данных

Возвращает список вариантов для доставки заказов. Выберите подходящий вариант доставки из ответа и передайте его при создании заказа.

Укажите courierDelivery для курьерской доставки или pickupDelivery для доставки в пункт выдачи. Не передавайте оба параметра одновременно.

⚙️ Лимит: 1 000 запросов в минуту

Request

POST

https://api.partner.market.yandex.ru/v1/campaigns/{campaignId}/delivery-options

Path parameters

Name

Description

campaignId

Type: integer

Идентификатор кампании (магазина) — технический идентификатор, который представляет ваш магазин в системе Яндекс Маркета при работе через API. Он однозначно связывается с вашим магазином, но предназначен только для автоматизированного взаимодействия.

Его можно узнать с помощью запроса GET v2/campaigns или найти в кабинете продавца на Маркете. Нажмите на иконку вашего аккаунта → Настройки и в меню слева выберите API и модули:

блок Идентификатор кампании;
вкладка Лог запросов → выпадающий список в блоке Показывать логи.

⚠️ Не путайте его с:

идентификатором магазина, который отображается в личном кабинете продавца;
рекламными кампаниями.

Min value: 1

Body

application/json

{
  "items": [
    {
      "offerId": "example",
      "count": 1,
      "warehouseId": 1
    }
  ],
  "pickupDelivery": {
    "logisticPointsIds": [
      1
    ]
  },
  "courierDelivery": {
    "fullAddress": "example"
  }
}

Name	Description
items	Type: GetDeliveryOptionsItemDTO[] Товары на складах, для которых нужно вернуть варианты доставки. В рамках одного запроса все значения `offerId` должны быть уникальными. Не допускается передача двух объектов с одинаковым `offerId`. Min items: `1` Max items: `1000` Example `[ { "offerId": "example", "count": 1, "warehouseId": 1 } ]`
courierDelivery	Type: CourierDeliveryParametersDTO Информация о курьерской доставке. Не передавайте вместе с `pickupDelivery`. Example `{ "fullAddress": "example" }`
pickupDelivery	Type: PickupDeliveryParametersDTO Информация о доставке в пункт выдачи. Не передавайте вместе с `courierDelivery`. Example `{ "logisticPointsIds": [ 1 ] }`

ShopSku

Ваш SKU — идентификатор товара в вашей системе.

Правила использования SKU:

У каждого товара SKU должен быть свой.
Уже заданный SKU нельзя освободить и использовать заново для другого товара. Каждый товар должен получать новый идентификатор, до того никогда не использовавшийся в вашем каталоге.

SKU товара можно изменить в кабинете продавца на Маркете. О том, как это сделать, читайте в Справке Маркета для продавцов.

Важно

Пробельные символы в начале и конце значения автоматически удаляются. Например, " SKU123 " и "SKU123" будут обработаны как одинаковые значения.

Что такое SKU и как его назначать

Type: string

Min length: 1

Max length: 255

Pattern: ^(?=.*\S.*)[^\x00-\x08\x0A-\x1f\x7f]{1,255}$

Example: example

BasicOrderItemDTO

Товар в заказе или возврате.

Name

Description

count

Type: integer

Количество единиц товара.

Min value: 1

Max value: 1000

offerId

Type: ShopSku

Ваш SKU — идентификатор товара в вашей системе.

Правила использования SKU:

У каждого товара SKU должен быть свой.
Уже заданный SKU нельзя освободить и использовать заново для другого товара. Каждый товар должен получать новый идентификатор, до того никогда не использовавшийся в вашем каталоге.

Важно

Что такое SKU и как его назначать

Min length: 1

Max length: 255

Pattern: ^(?=.*\S.*)[^\x00-\x08\x0A-\x1f\x7f]{1,255}$

Example: example

Example

{
  "offerId": "example",
  "count": 1
}

GetDeliveryOptionsItemDTO

Товар, для которого нужно вернуть варианты доставки.

Type: object

All of 2 types

Type: BasicOrderItemDTO

Товар в заказе или возврате.
Example
```
{
  "offerId": "example",
  "count": 1
}
```

Type: object

warehouseId

Type: integer

Идентификатор фулфилмент-склада Маркета.

Передайте этот параметр, чтобы вернулись варианты доставки для указанного склада. Иначе Маркет сам выберет склад.

Как узнать остатки товаров на складах

Min value: 1

Example

{
  "warehouseId": 1
}

Example

{
  "offerId": "example",
  "count": 1,
  "warehouseId": 1
}

LogisticPointId

Идентификатор пункта выдачи.

Его можно узнать с помощью метода POST v1/businesses/{businessId}/logistics-points.

Type: integer

Min value: 1

PickupDeliveryParametersDTO

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

Не передавайте вместе с courierDelivery.

Name

Description

logisticPointsIds

Type: LogisticPointId[]

Идентификаторы пунктов выдачи.

Min items: 1

Max items: 20

Unique items: true

Example

[
  1
]

Example

{
  "logisticPointsIds": [
    1
  ]
}

CourierDeliveryParametersDTO

Информация о курьерской доставке.

Не передавайте вместе с pickupDelivery.

Name

Description

fullAddress

Type: string

Полный адрес с точностью до номера дома.

Min length: 1

Max length: 512

Example: example

Example

{
  "fullAddress": "example"
}

Responses

200 OK

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

Body

application/json

{
  "status": "OK",
  "result": {
    "warehousesDeliveryOptions": [
      {
        "warehouseId": 1,
        "deliveryOptions": {},
        "items": [
          null
        ]
      }
    ]
  }
}

Type: object

All of 2 types

Type: ApiResponse

Стандартная обертка для ответов сервера.
Example
```
{
  "status": "OK"
}
```

Type: object

result

Type: GetDeliveryOptionsDTO

Список доступных вариантов для разных складов.

Example

{
  "warehousesDeliveryOptions": [
    {
      "warehouseId": 1,
      "deliveryOptions": {
        "pickupDelivery": {
          "pickupOptions": [
            null
          ]
        },
        "courierDelivery": {
          "courierDeliveryOptions": [
            null
          ]
        }
      },
      "items": [
        {
          "offerId": "example",
          "count": 1
        }
      ]
    }
  ]
}

Example

{
  "result": {
    "warehousesDeliveryOptions": [
      {
        "warehouseId": 1,
        "deliveryOptions": {
          "pickupDelivery": {},
          "courierDelivery": {}
        },
        "items": [
          {}
        ]
      }
    ]
  }
}

ApiResponseStatusType

Тип ответа. Возможные значения:

OK — ошибок нет.
ERROR — при обработке запроса произошла ошибка.

Type: string

Enum: OK, ERROR

ApiResponse

Стандартная обертка для ответов сервера.

Name

Description

status

Type: ApiResponseStatusType

Тип ответа. Возможные значения:

OK — ошибок нет.
ERROR — при обработке запроса произошла ошибка.

Enum: OK, ERROR

Example

{
  "status": "OK"
}

WarehouseId

Идентификатор фулфилмент-склада Маркета.

Type: integer

Min value: 1

DeliveryDateIntervalDTO

Интервал дат доставки.

Name

Description

fromDate

Type: string<date>

Начало интервала.

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

Example: 2025-01-01

toDate

Type: string<date>

Конец интервала.

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

Example: 2025-01-01

Example

{
  "fromDate": "2025-01-01",
  "toDate": "2025-01-01"
}

CurrencyType

Коды валют:

RUR — российский рубль.
UAH — украинская гривна.
BYR — белорусский рубль.
KZT — казахстанский тенге.
UZS — узбекский сум.

Type: string

Enum: RUR, USD, EUR, UAH, AUD, GBP, BYR, BYN, DKK, ISK, KZT, CAD, CNY, NOK, XDR, SGD, TRY, SEK, CHF, JPY, AZN, ALL, DZD, AOA, ARS, AMD, AFN, BHD, BGN, BOB, BWP, BND, BRL, BIF, HUF, VEF, KPW, VND, GMD, GHS, GNF, HKD, GEL, AED, EGP, ZMK, ILS, INR, IDR, JOD, IQD, IRR, YER, QAR, KES, KGS, COP, CDF, CRC, KWD, CUP, LAK, LVL, SLL, LBP, LYD, SZL, LTL, MUR, MRO, MKD, MWK, MGA, MYR, MAD, MXN, MZN, MDL, MNT, NPR, NGN, NIO, NZD, OMR, PKR, PYG, PEN, PLN, KHR, SAR, RON, SCR, SYP, SKK, SOS, SDG, SRD, TJS, THB, TWD, BDT, TZS, TND, TMM, UGX, UZS, UYU, PHP, DJF, XAF, XOF, HRK, CZK, CLP, LKR, EEK, ETB, RSD, ZAR, KRW, NAD, TL, UE

CurrencyValueDTO

Валюта и ее значение.

Name

Description

currencyId

Type: CurrencyType

Валюта.

Коды валют:

RUR — российский рубль.
UAH — украинская гривна.
BYR — белорусский рубль.
KZT — казахстанский тенге.
UZS — узбекский сум.

value

Type: number

Значение.

Example

{
  "value": 0.5,
  "currencyId": "RUR"
}

DeliveryOptionPriceDTO

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

Type: object

All of 1 type

Type: CurrencyValueDTO

Валюта и ее значение.
Example
```
{
  "value": 0.5,
  "currencyId": "RUR"
}
```

Example

{
  "value": 0.5,
  "currencyId": "RUR"
}

PickupOptionDTO

Временной интервал и стоимость доставки.

Name

Description

deliveryDateInterval

Type: DeliveryDateIntervalDTO

Интервал дат доставки.

Example

{
  "fromDate": "2025-01-01",
  "toDate": "2025-01-01"
}

price

Type: DeliveryOptionPriceDTO

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

Example

{
  "value": 0.5,
  "currencyId": "RUR"
}

Example

{
  "deliveryDateInterval": {
    "fromDate": "2025-01-01",
    "toDate": "2025-01-01"
  },
  "price": {
    "value": 0.5,
    "currencyId": "RUR"
  }
}

DeliveryPaymentType

Тип оплаты заказа:

PREPAID — оплата при оформлении заказа.

Type: string

Const: PREPAID

Example: example

PickupOptionsDTO

Временной интервал, идентификатор пункта выдачи и способ оплаты.

Name

Description

logisticPointId

Type: LogisticPointId

Идентификатор пункта выдачи.

Его можно узнать с помощью метода POST v1/businesses/{businessId}/logistics-points.

Min value: 1

Example: 1

options

Type: PickupOptionDTO[]

Варианты доставки в ПВЗ.

Min items: 1

Example

[
  {
    "deliveryDateInterval": {
      "fromDate": "2025-01-01",
      "toDate": "2025-01-01"
    },
    "price": {
      "value": 0.5,
      "currencyId": "RUR"
    }
  }
]

Example

{
  "logisticPointId": 1,
  "options": [
    {
      "deliveryDateInterval": {
        "fromDate": "2025-01-01",
        "toDate": "2025-01-01"
      },
      "price": {
        "value": 0.5,
        "currencyId": "RUR"
      }
    }
  ]
}

PickupDeliveryOptionsDTO

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

Name

Description

pickupOptions

Type: PickupOptionsDTO[]

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

Example

[
  {
    "logisticPointId": 1,
    "options": [
      {
        "deliveryDateInterval": {
          "fromDate": "2025-01-01",
          "toDate": "2025-01-01"
        },
        "price": {}
      }
    ]
  }
]

Example

{
  "pickupOptions": [
    {
      "logisticPointId": 1,
      "options": [
        {
          "deliveryDateInterval": {},
          "price": {}
        }
      ]
    }
  ]
}

TimeIntervalDTO

Интервал времени доставки.

Name

Description

fromTime

Type: string

Начало интервала.

Формат: ЧЧ:ММ.

Pattern: ^([0-1][0-9]|2[0-3]):[0-5][0-9]$

Example: example

toTime

Type: string

Конец интервала.

Формат: ЧЧ:ММ.

Pattern: ^([0-1][0-9]|2[0-3]):[0-5][0-9]$

Example: example

Example

{
  "fromTime": "example",
  "toTime": "example"
}

CourierDeliveryOptionDTO

Временные интервалы и способ оплаты.

Name	Description
deliveryDateInterval	Type: DeliveryDateIntervalDTO Интервал дат доставки. Example `{ "fromDate": "2025-01-01", "toDate": "2025-01-01" }`
deliveryTimeInterval	Type: TimeIntervalDTO Интервал времени доставки. Example `{ "fromTime": "example", "toTime": "example" }`
price	Type: DeliveryOptionPriceDTO Стоимость, которую магазин должен заплатить за доставку с выбранным вариантом. Example `{ "value": 0.5, "currencyId": "RUR" }`

Example

{
  "deliveryDateInterval": {
    "fromDate": "2025-01-01",
    "toDate": "2025-01-01"
  },
  "deliveryTimeInterval": {
    "fromTime": "example",
    "toTime": "example"
  },
  "price": {
    "value": 0.5,
    "currencyId": "RUR"
  }
}

CourierDeliveryOptionsDTO

Информация о курьерской доставке.

Name

Description

courierDeliveryOptions

Type: CourierDeliveryOptionDTO[]

Информация о курьерской доставке.

Min items: 1

Example

[
  {
    "deliveryDateInterval": {
      "fromDate": "2025-01-01",
      "toDate": "2025-01-01"
    },
    "deliveryTimeInterval": {
      "fromTime": "example",
      "toTime": "example"
    },
    "price": {
      "value": 0.5,
      "currencyId": "RUR"
    }
  }
]

Example

{
  "courierDeliveryOptions": [
    {
      "deliveryDateInterval": {
        "fromDate": "2025-01-01",
        "toDate": "2025-01-01"
      },
      "deliveryTimeInterval": {
        "fromTime": "example",
        "toTime": "example"
      },
      "price": {
        "value": 0.5,
        "currencyId": "RUR"
      }
    }
  ]
}

WarehouseDeliveryOptionsDTO

Варианты доставки.

Name

Description

courierDelivery

Type: CourierDeliveryOptionsDTO

Информация о курьерской доставке.

Example

{
  "courierDeliveryOptions": [
    {
      "deliveryDateInterval": {
        "fromDate": "2025-01-01",
        "toDate": "2025-01-01"
      },
      "deliveryTimeInterval": {
        "fromTime": "example",
        "toTime": "example"
      },
      "price": {
        "value": 0.5,
        "currencyId": "RUR"
      }
    }
  ]
}

pickupDelivery

Type: PickupDeliveryOptionsDTO

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

Example

{
  "pickupOptions": [
    {
      "logisticPointId": 1,
      "options": [
        {
          "deliveryDateInterval": {},
          "price": {}
        }
      ]
    }
  ]
}

Example

{
  "pickupDelivery": {
    "pickupOptions": [
      {
        "logisticPointId": 1,
        "options": [
          {}
        ]
      }
    ]
  },
  "courierDelivery": {
    "courierDeliveryOptions": [
      {
        "deliveryDateInterval": {
          "fromDate": "2025-01-01",
          "toDate": "2025-01-01"
        },
        "deliveryTimeInterval": {
          "fromTime": "example",
          "toTime": "example"
        },
        "price": {}
      }
    ]
  }
}

WarehousesDeliveryOptionsDTO

Варианты доставки со склада.

Name	Description
deliveryOptions	Type: WarehouseDeliveryOptionsDTO Варианты доставки. Example `{ "pickupDelivery": { "pickupOptions": [ { "logisticPointId": 1, "options": [ {} ] } ] }, "courierDelivery": { "courierDeliveryOptions": [ { "deliveryDateInterval": { "fromDate": "2025-01-01", "toDate": "2025-01-01" }, "deliveryTimeInterval": { "fromTime": "example", "toTime": "example" }, "price": {} } ] } }`
items	Type: BasicOrderItemDTO[] Товары в заказе. Min items: `1` Example `[ { "offerId": "example", "count": 1 } ]`
warehouseId	Type: WarehouseId Идентификатор фулфилмент-склада Маркета. Min value: `1` Example: `1`

Example

{
  "warehouseId": 1,
  "deliveryOptions": {
    "pickupDelivery": {
      "pickupOptions": [
        {
          "logisticPointId": 1,
          "options": [
            null
          ]
        }
      ]
    },
    "courierDelivery": {
      "courierDeliveryOptions": [
        {
          "deliveryDateInterval": {},
          "deliveryTimeInterval": {},
          "price": {}
        }
      ]
    }
  },
  "items": [
    {
      "offerId": "example",
      "count": 1
    }
  ]
}

GetDeliveryOptionsDTO

Список доступных вариантов для разных складов.

Name

Description

warehousesDeliveryOptions

Type: WarehousesDeliveryOptionsDTO[]

Варианты доставки для разных складов.

Min items: 1

Example

[
  {
    "warehouseId": 1,
    "deliveryOptions": {
      "pickupDelivery": {
        "pickupOptions": [
          {}
        ]
      },
      "courierDelivery": {
        "courierDeliveryOptions": [
          {}
        ]
      }
    },
    "items": [
      {
        "offerId": "example",
        "count": 1
      }
    ]
  }
]

Example

{
  "warehousesDeliveryOptions": [
    {
      "warehouseId": 1,
      "deliveryOptions": {
        "pickupDelivery": {
          "pickupOptions": [
            null
          ]
        },
        "courierDelivery": {
          "courierDeliveryOptions": [
            null
          ]
        }
      },
      "items": [
        {
          "offerId": "example",
          "count": 1
        }
      ]
    }
  ]
}

400 Bad Request

Запрос содержит неправильные данные. Подробнее об ошибках при работе с заказами

Body

application/json

{
  "status": "OK",
  "errors": [
    {
      "code": "example",
      "message": "example"
    }
  ]
}

Type: object

All of 1 type

Type: ApiErrorResponse

Стандартная обертка для ошибок сервера.

Example

{
  "status": "OK",
  "errors": [
    {
      "code": "example",
      "message": "example"
    }
  ]
}

ApiErrorDTO

Общий формат ошибки.

Name

Description

code

Type: string

Код ошибки.

Example: example

message

Type: string

Описание ошибки.

Example: example

Example

{
  "code": "example",
  "message": "example"
}

ApiErrorResponse

Стандартная обертка для ошибок сервера.

Type: object

All of 2 types

Type: ApiResponse

Стандартная обертка для ответов сервера.
Example
```
{
  "status": "OK"
}
```

Type: object

errors

Type: ApiErrorDTO[] | null

Список ошибок.

Min items: 1

Example

[
  {
    "code": "example",
    "message": "example"
  }
]

Example

{
  "errors": [
    {
      "code": "example",
      "message": "example"
    }
  ]
}

Example

{
  "status": "OK",
  "errors": [
    {
      "code": "example",
      "message": "example"
    }
  ]
}

401 Unauthorized

В запросе не указаны данные для авторизации. Подробнее об ошибке

Body

application/json

{
  "status": "OK",
  "errors": [
    {
      "code": "example",
      "message": "example"
    }
  ]
}

Type: object

All of 1 type

Type: ApiErrorResponse

Стандартная обертка для ошибок сервера.

Example

{
  "status": "OK",
  "errors": [
    {
      "code": "example",
      "message": "example"
    }
  ]
}

403 Forbidden

Данные для авторизации неверны или доступ к ресурсу запрещен. Подробнее об ошибке

Body

application/json

{
  "status": "OK",
  "errors": [
    {
      "code": "example",
      "message": "example"
    }
  ]
}

Type: object

All of 1 type

Type: ApiErrorResponse

Стандартная обертка для ошибок сервера.

Example

{
  "status": "OK",
  "errors": [
    {
      "code": "example",
      "message": "example"
    }
  ]
}

420 Method Failure

Превышено ограничение на доступ к ресурсу. Подробнее об ошибке

Body

application/json

{
  "status": "OK",
  "errors": [
    {
      "code": "example",
      "message": "example"
    }
  ]
}

Type: object

All of 1 type

Type: ApiErrorResponse

Стандартная обертка для ошибок сервера.

Example

{
  "status": "OK",
  "errors": [
    {
      "code": "example",
      "message": "example"
    }
  ]
}

500 Internal Server Error

Внутренняя ошибка Маркета. Подробнее об ошибке

Body

application/json

{
  "status": "OK",
  "errors": [
    {
      "code": "example",
      "message": "example"
    }
  ]
}

Type: object

All of 1 type

Type: ApiErrorResponse

Стандартная обертка для ошибок сервера.

Example

{
  "status": "OK",
  "errors": [
    {
      "code": "example",
      "message": "example"
    }
  ]
}

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

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

Изменение заказа