Создать заявку на самопривоз

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

  1. Синтаксис запроса
  2. Пример запроса
  3. Структура ответа

Синтаксис запроса

POST /api/last/createImport
Host: delivery.yandex.ru 
Content-Type:application/x-www-form-urlencoded
... 

secret_key=<секретный ключ>
&client_id=<идентификатор аккаунта в Яндекс.Доставке>
&sender_id=<идентификатор магазина>
&requisite_id=<идентификатор реквизитов магазина>
&interval=<идентификатор интервала отгрузки>
&warehouse_from_id=<идентификатор склада отправления>
&warehouse_to_id=<идентификатор склада назначения>
&volume=<объем заказов>
&weight=<вес заказов>
&shipment_date=<дата самопривоза>
&delivery_name=<название службы доставки или единого склада>
&import_type=<способ передвижения курьера>
&name=<имя курьера>
&car_number=<номер машины курьера>
&car_model=<марка машины курьера>
&sort=<сортировка на едином складе>
[&comment=<дополнительное описание>]

Параметры:

Параметр Тип Значение
Обязательные
secret_key Строка

Секретный ключ.

client_id Число

Идентификатор аккаунта в Яндекс.Доставке.

Значение можно получить в личном кабинете Яндекс.Доставки, в разделе Настройки, на вкладке Интеграция → API.

sender_id Число

Идентификатор магазина.

Значение можно получить в личном кабинете Яндекс.Доставки, в разделе Настройки, на вкладке Интеграция → API.

requisite_id Число

Идентификатор реквизитов магазина.

Значение можно получить в личном кабинете Яндекс.Доставки, в разделе Настройки, на вкладке Интеграция → API.

interval Число

Идентификатор интервала отгрузки.

warehouse_from_id Число

Идентификатор склада магазина.

warehouse_to_id Число

Идентификатор склада, на который нужно отгрузить заказы.

volume Число

Общий объем заказов (в метрах кубических).

weight Строка

Общий вес заказов (в килограммах).

shipment_date Строка

Дата отгрузки.

Должна быть указана в формате «YYYY-MM-DD».

delivery_name Строка

Кодовое название службы доставки.

import_type Строка

Способ передвижения курьера.

Допустимые значения:
  • car — на машине.
  • courier — пешком.
name Строка

Фамилия, имя и отчество курьера.

car_number Строка

Номер машины курьера.

Параметр обязателен, если import_type принимает значение car.

car_model Строка

Марка машины курьера.

Параметр обязателен, если import_type принимает значение car.

sort Строка

Необходимость сортировки на едином складе.

Допустимые значения:
  • 1 — сортировка нужна.
  • 0 — сортировка не нужна.

Параметр обязателен, если delivery_name принимает значение fulfillment_Strizh.

Необязательные
comment Строка

Дополнительное описание.

Параметр Тип Значение
Обязательные
secret_key Строка

Секретный ключ.

client_id Число

Идентификатор аккаунта в Яндекс.Доставке.

Значение можно получить в личном кабинете Яндекс.Доставки, в разделе Настройки, на вкладке Интеграция → API.

sender_id Число

Идентификатор магазина.

Значение можно получить в личном кабинете Яндекс.Доставки, в разделе Настройки, на вкладке Интеграция → API.

requisite_id Число

Идентификатор реквизитов магазина.

Значение можно получить в личном кабинете Яндекс.Доставки, в разделе Настройки, на вкладке Интеграция → API.

interval Число

Идентификатор интервала отгрузки.

warehouse_from_id Число

Идентификатор склада магазина.

warehouse_to_id Число

Идентификатор склада, на который нужно отгрузить заказы.

volume Число

Общий объем заказов (в метрах кубических).

weight Строка

Общий вес заказов (в килограммах).

shipment_date Строка

Дата отгрузки.

Должна быть указана в формате «YYYY-MM-DD».

delivery_name Строка

Кодовое название службы доставки.

import_type Строка

Способ передвижения курьера.

Допустимые значения:
  • car — на машине.
  • courier — пешком.
name Строка

Фамилия, имя и отчество курьера.

car_number Строка

Номер машины курьера.

Параметр обязателен, если import_type принимает значение car.

car_model Строка

Марка машины курьера.

Параметр обязателен, если import_type принимает значение car.

sort Строка

Необходимость сортировки на едином складе.

Допустимые значения:
  • 1 — сортировка нужна.
  • 0 — сортировка не нужна.

Параметр обязателен, если delivery_name принимает значение fulfillment_Strizh.

Необязательные
comment Строка

Дополнительное описание.

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

POST /api/last/createImport HTTP/1.1
Host: delivery.yandex.ru
Content-Type:application/x-www-form-urlencoded
...

secret_key=6f08ebd49a996fcb6666fc130f491a2d&client_id=215000001&sender_id=8098&requisite_id=23&warehouse_from_id=4450&weight=50&volume=0.6&delivery_name=Axiomus&shipment_date=2016-06-22&interval=25984&import_type=courier&courier_id=78&name%5B%5D=asdf&warehouse_to_id=1081
cURL
curl  -d 'secret_key=6f08ebd49a996fcb6666fc130f491a2d&client_id=215000001&sender_id=8098&requisite_id=23&warehouse_from_id=4450&weight=50&volume=0.6&delivery_name=Axiomus&shipment_date=2016-06-22&interval=25984&import_type=courier&courier_id=78&name%5B%5D=asdf&warehouse_to_id=1081' 'https://delivery.yandex.ru/api/last/createImport'

Структура ответа

{
  "status":"ok",
  "data":
    {
      "parcel":
        { 
          "id":"178257",
          "import_id":"22644",
          "external_id":null,
          "status":"1",
          "requisite_id":"9",
          "created":"2017-01-26 18:35:04",
          "shipment_date":"2017-01-29",
          "warehouse_from_id":"2872",
          "warehouse_to_id":"9805",
          "volume":"10.000000",
          "weight":"10.00",
          "delivery":"delivery_Strizh",
          "to_yd_warehouse":0
        }
    }
}
Ключ Тип значения Описание
status Строка

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

Возможные значения:
  • ok — запрос выполнен успешно.
  • error — запрос выполнен с ошибкой.
data Объект Данные ответа.
Ключи объекта data
parcel Объект Данные об отгрузке.
Ключи объекта parcel
id Строка Идентификатор отгрузки.
import_id Строка

Идентификатор заявки на отгрузку.

external_id Строка Номер заявки на отгрузку в службе доставки.
status Строка

Служебное поле.

requisite_id Строка Идентификатор реквизитов магазина.
created Строка

Дата создания заявки на отгрузку.

Указана в формате «YYYY-MM-DD hh:mm:ss».

shipment_date Строка

Дата отгрузки.

Формат: «YYYY-MM-DD».

warehouse_from_id Строка

Идентификатор склада магазина.

warehouse_to_id Строка

Идентификатор склада, на который нужно отгрузить заказы.

volume Строка Общий объем заказов (в метрах кубических).
weight Строка Общий вес заказов (в килограммах).
delivery Строка

Кодовое название службы доставки.

to_yd_warehouse Число

Склад, на который осуществляется отгрузка.

Возможные значения:
  • 0 — склад службы доставки.
  • 1 — единый склад.
Ключ Тип значения Описание
status Строка

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

Возможные значения:
  • ok — запрос выполнен успешно.
  • error — запрос выполнен с ошибкой.
data Объект Данные ответа.
Ключи объекта data
parcel Объект Данные об отгрузке.
Ключи объекта parcel
id Строка Идентификатор отгрузки.
import_id Строка

Идентификатор заявки на отгрузку.

external_id Строка Номер заявки на отгрузку в службе доставки.
status Строка

Служебное поле.

requisite_id Строка Идентификатор реквизитов магазина.
created Строка

Дата создания заявки на отгрузку.

Указана в формате «YYYY-MM-DD hh:mm:ss».

shipment_date Строка

Дата отгрузки.

Формат: «YYYY-MM-DD».

warehouse_from_id Строка

Идентификатор склада магазина.

warehouse_to_id Строка

Идентификатор склада, на который нужно отгрузить заказы.

volume Строка Общий объем заказов (в метрах кубических).
weight Строка Общий вес заказов (в килограммах).
delivery Строка

Кодовое название службы доставки.

to_yd_warehouse Число

Склад, на который осуществляется отгрузка.

Возможные значения:
  • 0 — склад службы доставки.
  • 1 — единый склад.