Page tree
Skip to end of metadata
Go to start of metadata

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

Запрос на регистрацию договоренности о доставке

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

Тело запроса 

Необходимо передавать в формате JSON (Content-Type: application/json).

Поддерживаются следующие поля:

Тэг/Атрибут

Описание

Тип поля

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

1

cdek_numberНомер заказа СДЭКstring

да, если не переданorder_uuid 

2order_uuidИдентификатор заказа в ИС СДЭКUUID

да, если не передан cdek_number 

3dateДата доставки, согласованная с получателемdateда
4time_fromВремя доставки С, согласованное с получателемtime

да, если заказ "до двери"

5time_toВремя доставки ПО, согласованное с получателемtime

да, если заказ "до двери"

6

comment

Комментарий

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

нет

8

to_location

Новый адрес доставки (если требуется изменить)
Не может быть заполнено одновременно с delivery_point

location

нет

8.1

codeКод локации (справочник СДЭК)integerнет

8.2

fias_guidУникальный идентификатор ФИАСUUIDнет

8.3

postal_codeПочтовый индексstring(255)нет

8.4

longitudeДолготаfloatнет
8.5latitudeШиротаfloatнет
8.6country_codeКод страны в формате  ISO_3166-1_alpha-2string(2)нет

8.7

regionНазвание регионаstring(255)нет
8.8region_codeКод региона (справочник СДЭК)integerнет
8.9sub_regionНазвание района регионаstring(255)нет
8.10cityНазвание городаstring(255)нет
8.11kladr_code

Код КЛАДР

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

string(255)нет
8.12addressСтрока адресаstring(255)нет

Ответ на регистрацию договоренности о доставке

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

Тэг/Атрибут

Описание

Тип поля

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

1entityИнформация о договоренностиentityнет
1.1uuidИдентификатор договоренности о дате доставки в системе СДЭКUUIDда
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()да
Пример запроса
{
	"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",
		"fias_guid" : "c2deb16a-0330-4f05-821f-1d09c93331e6",
		"postal_code" : "190000",
		"longitude" : "30.3159",
		"latitude" : "59.9391",
		"country_code" : "RU",
		"region" : "Санкт-Петербург",
		"region_code" : "82",
		"sub_region" : "Санкт-Петербург",
		"city" : "Санкт-Петербург",
		"kladr_code" : "78",
		"address" : "г.Бердск ул.Ленина 16"
	}
}
Пример ответа
{
  "entity": {
    "uuid": "72753031-3d4b-42c4-8a87-53ecae1881e3"
  },
  "requests": [
    {
      "request_uuid": "72753031-8ab1-4ed2-ab9c-363cce859817",
      "type": "CREATE",
      "state": "ACCEPTED",
      "date_time": "2020-02-26T14:46:17+0700",
      "errors": [],
      "warnings": []
    }
  ]
}




  • No labels