Информация о договоренности о доставке


 

Метод используется для получения информации об оговоренных с клиентом дате и времени доставки (приезда курьера), а так же возможном новом адресе доставки.

Запрос на получение информации о договоренности о доставке

Для использования необходимо отправить GET-запрос на URL:

Среда

URL

тестоваяhttps://api.edu.cdek.ru/v2/delivery/{uuid}
боеваяhttps://api.cdek.ru/v2/delivery/{uuid}

{uuid} - идентификатор договоренности о доставке в ИС СДЭК.

Ответ на получение информации о договоренности о доставке 

Ответ возвращается в формате JSON:

Тэг/Атрибут

Описание

Тип поля

Обяз. для заполн.

1entityИнформация о договоренностиentityнет
1.1uuidИдентификатор договоренности о дате доставки в ИС СДЭКUUIDда

1.2

cdek_numberНомер заказа СДЭКstringнет
1.3order_uuidИдентификатор заказа в ИС СДЭКUUIDда
1.4dateДата доставки, согласованная с получателем
(Если заказ "До склада", эта дата не влияет на сроки доставки и может быть произвольной)
При прозвоне дата доставки до склада устанавливается в автоматическом режиме (дата создания прозвона +19 дней)
dateда
1.5time_fromВремя начала ожидания курьера (согласованное с получателем)timeда
1.6time_toВремя окончания ожидания курьера (согласованное с получателем)timeда
1.7

comment

Комментарий

stringнет
1.8delivery_pointНовый код ПВЗ СДЭК, на который будет доставлена посылка (если требовалось изменить).string()

нет

1.9

to_location

Новый адрес доставки (если требовалось изменить).

location

нет

1.9.1codeКод населенного пункта СДЭК (метод "Список населенных пунктов")integerнет
1.9.2fias_guidУникальный идентификатор ФИАСUUIDнет
1.9.3postal_codeПочтовый индексstring(255)нет
1.9.4longitudeДолготаfloatнет
1.9.5latitudeШиротаfloatнет
1.9.6country_codeКод страны в формате  ISO_3166-1_alpha-2string(2)нет
1.9.7regionНазвание регионаstring(255)нет
1.9.8region_codeКод региона (справочник СДЭК)integerнет
1.9.9sub_regionНазвание района регионаstring(255)нет
1.9.10cityНазвание городаstring(255)нет
1.9.11kladr_code

Код КЛАДР

Устаревшее поле

string(255)нет
1.9.12addressСтрока адресаstring(255)нет
1.10statusesСтатус договоренности о доставкеstatus[]да
1.10.1codeКод статуса (подробнее см. приложение 1)string()да
1.10.2nameНазвание статусаstring()да
1.10.3date_timeДата и время установки статуса (формат yyyy-MM-dd'T'HH:mm:ssZ)datetimeда
2requestsИнформация о запросе/запросах над заказомrequest[]да
2.1request_uuidИдентификатор запроса в ИС СДЭКUUIDнет
2.2typeТип запроса
Может принимать значения: CREATE, UPDATE, DELETE, AUTH, GET
string()да
2.3date_timeДата и время установки текущего состояния запроса (формат yyyy-MM-dd'T'HH:mm:ssZ)datetimeда
2.4state

Текущее состояние запроса
Может принимать значения: 

ACCEPTED - пройдена предварительная валидация и запрос принят
WAITING - запрос ожидает обработки (зависит от выполнения другого запроса)
SUCCESSFUL - запрос обработан успешно
INVALID - запрос обработался с ошибкой

string()да
2.5errorsОшибки, возникшие в ходе выполнения запросаerror[]нет
2.5.1codeКод ошибкиstring()да
2.5.2messageОписание ошибкиstring()да
2.6warningsПредупреждения, возникшие в ходе выполнения запросаwarning[]нет
2.6.1codeКод предупрежденияstring()да
2.6.2messageОписание предупреждения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, Курьерская компания СДЭК