Курьерские нотификации

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

Request

POST

/notifications/{placeId}

Path parameters

Name

Description

placeId

Type: string

Уникальный идентификатор магазина в системе Партнёра.

Example: ``

Headers

Name

Description

Authorization

Type: string

Токен, полученный в ответе на запрос /security/oauth/token

Example: ``

Body

application/json
{
  "courierName": "Иван",
  "courierPhone": "+74732006745,12099",
  "orderId": "03d3b69b-331c-4f84-b2c4-888b30320e63",
  "type": "courier_assigned"
}

Name

Description

orderId

Type: OrderId

Идентификатор заказа в системе Партнёра. Формат свободный. Рекомендуется UUID4.

Example: 03d3b69b-331c-4f84-b2c4-888b30320e63

type

Type: NotificationType

Тип нотификации.

Enum: courier_assigned, courier_arrived_to_place

courierName

Type: string

Имя курьера. При назначении робота-курьера будет передаваться значение "Робот-курьер [номер]".

Example: Иван

courierPhone

Type: string

Телефонный номер курьера. При назначении робота-курьера поле будет пустым.

Example: +74732006745,12099

OrderId

Идентификатор заказа в системе Партнёра. Формат свободный. Рекомендуется UUID4.

Type: string

Example: 03d3b69b-331c-4f84-b2c4-888b30320e63

NotificationType

Тип нотификации.

Type: string

Enum: courier_assigned, courier_arrived_to_place

Responses

200 OK

OK

Body

application/json
{
  "id": "example",
  "orderId": "03d3b69b-331c-4f84-b2c4-888b30320e63",
  "type": "courier_assigned"
}

Name

Description

id

Type: string

Идентификатор нотификации.

Example: example

orderId

Type: OrderId

Идентификатор заказа в системе Партнёра. Формат свободный. Рекомендуется UUID4.

Example: 03d3b69b-331c-4f84-b2c4-888b30320e63

type

Type: NotificationType

Тип нотификации.

Enum: courier_assigned, courier_arrived_to_place

400 Bad Request

Ошибка в запросе. В ответе ожидается массив с объектом списка ошибок.

Body

application/json
[
  {
    "code": 400,
    "description": "Description of error"
  }
]

Type: ErrorItem[]

ErrorItem

Name

Description

code

Type: integer

Согласованный с Яндекс Едой числовой код ошибки.

description

Type: string

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

Example: Description of error

Example
{
  "code": 400,
  "description": "Description of error"
}

No longer supported, please use an alternative and newer version.