Информация о договоренности о доставке
Метод используется для получения информации об оговоренных с клиентом дате и времени доставки (приезда курьера), а так же возможном новом адресе доставки.
Запрос на получение информации о договоренности о доставке
Для использования необходимо отправить GET-запрос на URL:
Среда | URL |
---|---|
тестовая | https://api.edu.cdek.ru/v2/delivery/{uuid} |
боевая | https://api.cdek.ru/v2/delivery/{uuid} |
{uuid} - идентификатор договоренности о доставке в ИС СДЭК.
Ответ на получение информации о договоренности о доставке
Ответ возвращается в формате JSON:
№ | Тэг/Атрибут | Описание | Тип поля | Обяз. для заполн. |
---|---|---|---|---|
1 | entity | Информация о договоренности | entity | нет |
1.1 | uuid | Идентификатор договоренности о дате доставки в ИС СДЭК | UUID | да |
1.2 | cdek_number | Номер заказа СДЭК | string | нет |
1.3 | order_uuid | Идентификатор заказа в ИС СДЭК | UUID | да |
1.4 | date | Дата доставки, согласованная с получателем (Если заказ "До склада", эта дата не влияет на сроки доставки и может быть произвольной) При прозвоне дата доставки до склада устанавливается в автоматическом режиме (дата создания прозвона +19 дней) | date | да |
1.5 | time_from | Время начала ожидания курьера (согласованное с получателем) | time | да |
1.6 | time_to | Время окончания ожидания курьера (согласованное с получателем) | time | да |
1.7 | comment | Комментарий | string | нет |
1.8 | delivery_point | Новый код ПВЗ СДЭК, на который будет доставлена посылка (если требовалось изменить). | string() | нет |
1.9 | to_location | Новый адрес доставки (если требовалось изменить). | location | нет |
1.9.1 | code | Код населенного пункта СДЭК (метод "Список населенных пунктов") | integer | нет |
1.9.2 | fias_guid | Уникальный идентификатор ФИАС | UUID | нет |
1.9.3 | postal_code | Почтовый индекс | string(255) | нет |
1.9.4 | longitude | Долгота | float | нет |
1.9.5 | latitude | Широта | float | нет |
1.9.6 | country_code | Код страны в формате ISO_3166-1_alpha-2 | string(2) | нет |
1.9.7 | region | Название региона | string(255) | нет |
1.9.8 | region_code | Код региона (справочник СДЭК) | integer | нет |
1.9.9 | sub_region | Название района региона | string(255) | нет |
1.9.10 | city | Название города | string(255) | нет |
1.9.11 | kladr_code | Код КЛАДР Устаревшее поле | string(255) | нет |
1.9.12 | address | Строка адреса | string(255) | нет |
1.10 | statuses | Статус договоренности о доставке | status[] | да |
1.10.1 | code | Код статуса (подробнее см. приложение 1) | string() | да |
1.10.2 | name | Название статуса | string() | да |
1.10.3 | date_time | Дата и время установки статуса (формат yyyy-MM-dd'T'HH:mm:ssZ) | datetime | да |
2 | requests | Информация о запросе/запросах над заказом | request[] | да |
2.1 | request_uuid | Идентификатор запроса в ИС СДЭК | UUID | нет |
2.2 | type | Тип запроса Может принимать значения: CREATE, UPDATE, DELETE, AUTH, GET | string() | да |
2.3 | date_time | Дата и время установки текущего состояния запроса (формат yyyy-MM-dd'T'HH:mm:ssZ) | datetime | да |
2.4 | state | Текущее состояние запроса ACCEPTED - пройдена предварительная валидация и запрос принят | string() | да |
2.5 | errors | Ошибки, возникшие в ходе выполнения запроса | error[] | нет |
2.5.1 | code | Код ошибки | string() | да |
2.5.2 | message | Описание ошибки | string() | да |
2.6 | warnings | Предупреждения, возникшие в ходе выполнения запроса | warning[] | нет |
2.6.1 | code | Код предупреждения | string() | да |
2.6.2 | message | Описание предупреждения | string() | да |
http://api.cdek.ru/v2/delivery/72753031-3d4b-42c4-8a87-53ecae1881e3 |
{ "entity": { "uuid": "72753031-3d4b-42c4-8a87-53ecae1881e3", "cdek_number": "1106207236", "order_uuid": "72753031-df04-44a4-bc60-11e8b5253b1d", "date": "2020-02-27", "time_from": "10:00", "time_to": "15:00", "comment": "Офис группы компаний Ланит ?", "delivery_point": "", "to_location": { "code": "137", "postal_code": "190000", "country_code": "RU", "fias_guid": "c2deb16a-0330-4f05-821f-1d09c93331e6", "kladr_code": "7800000000000", "country": "Россия", "region": "Санкт-Петербург", "region_code": "82", "sub_region": "Санкт-Петербург", "city": "Санкт-Петербург", "address": "г.Бердск ул.Ленина 16", "longitude": 30.3159, "latitude": 59.9391 }, "statuses": [ { "code": "ACCEPTED", "name": "Принята", "date_time": "2020-02-26T14:46:17.532+0700" }, { "code": "REGISTERED", "name": "Зарегистрирована", "date_time": "2020-02-26T14:46:19.281+0700" } ] }, "requests": [ { "request_uuid": "72753031-8ab1-4ed2-ab9c-363cce859817", "type": "CREATE", "state": "SUCCESSFUL", "date_time": "2020-02-26T14:46:19+0700", "errors": [], "warnings": [] } ] } |
Приложение 1. Статусы договоренности о доставке
Код статуса | Название статуса | Комментарий |
---|---|---|
ACCEPTED | Принята | Договоренность создана в информационной системе СДЭК, но требуются дополнительные проверки |
REGISTERED | Зарегистрирована | Договоренность прошла необходимые проверки на возможность осуществления доставки в оговоренное время, место |
INVALID | Некорректна | Договоренность содержит некорректные данные |
CANCEL | Аннулирована | Договоренность аннулирована в силу появления новой договоренности |
© 2000—2024, Курьерская компания СДЭК