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

Метод используется для изменения созданного ранее заказа.

Запрос на изменение заказа

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

Тело запроса 

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

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

Тэг/Атрибут

Описание

Тип поля

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

1uuid1Идентификатор заказа в ИС СДЭК, который нужно изменитьUUID

да, если не заполнен cdek_number

2cdek_number1Номер заказа СДЭК, который нужно изменитьlongда, если не заполнен uuid
3tariff_code2Код тарифа (режимы старого и нового тарифа должны совпадать)integerнет
4commentКомментарий к заказуstring()нет
5shipment_pointКод ПВЗ СДЭК, на который будет производится забор отправления либо самостоятельный привоз клиентомstring()нет
6delivery_pointКод ПВЗ СДЭК, на который будет доставлена посылкаstring()нет
7delivery_recipient_cost

Доп. сбор за доставку, которую ИМ берет с получателя. Валюта сбора должна совпадать с валютой наложенного платежа

moneyнет
7.1valueСумма дополнительного сбораfloatда
7.2vat_sumСумма НДСfloatнет
7.3vat_rateСтавка НДС (значение - 0, 10, 18, 20, null - нет НДС)integerнет
8delivery_recipient_cost_advДоп. сбор за доставку (которую ИМ берет с получателя), в зависимости от суммы заказа

threshold[]

нет
8.1thresholdПорог стоимости товара (действует по условию меньше или равно), в целых единицах валютыintegerда
8.2sumДоп. сбор за доставку товаров, общая стоимость которых попадает в интервалfloatда
8.3vat_sumСумма НДС включённая в доп. сбор за доставкуfloatнет
8.4vat_rateСтавка НДС (значение - 0, 10, 18, 20 и т.п. , null - нет НДС)integerнет
9senderОтправительcontactнет
9.1companyНазвание компанииstring(255)нет
9.2nameФИО контактного лицаstring(255)нет
9.3emailЭл. адресstring(255)нет
9.4phonesСписок телефоновphone[]нет
9.4.1number

Номер телефона
Должен передаваться в международном формате: код страны (для России +7) и сам номер (10 и более цифр)

string(255)да
9.4.2additionalДополнительная информация (доп. номер)string(255)нет
10seller

Реквизиты реального продавца

sellerнет
10.1nameНаименование истинного продавцаstring(255)нет
10.2innИНН истинного продавцаstring(20)нет
10.3phoneТелефон истинного продавцаstring(255)нет
10.4ownership_formКод формы собственностиintegerнет
11recipientПолучательcontactнет
11.1companyНазвание компанииstring(255)нет
11.2nameФИО контактного лицаstring(255)нет
11.3passport_seriesСерия паспортаstring(255)нет
11.4passport_numberНомер паспортаstring(255)нет
11.5passport_date_of_issueДата выдачи паспортаdate (yyyy-MM-dd)нет
11.6passport_organizationОрган выдачи паспортаstring(255)нет
11.7tinИННstring(255)нет
11.8passport_date_of_birthДата рожденияdate (yyyy-MM-dd)нет
11.9emailЭл. адресstring(255)нет
11.10phonesСписок телефоновphone[]нет
11.10.1numberНомер телефона
Должен передаваться в международном формате: код страны (для России +7) и сам номер (10 и более цифр)
string(255)да
11.10.2additionalДополнительная информация (доп. номер)string(255)нет
12to_location2Адрес полученияlocationнет
12.1codeКод локации (справочник СДЭК)string(255)нет
12.2fias_guidУникальный идентификатор ФИАСUUIDнет
12.3postal_codeПочтовый индексstring(255)нет
12.4longitudeДолготаfloatнет
12.5latitudeШиротаfloatнет
12.6country_codeКод страны в формате  ISO_3166-1_alpha-2string(2)нет
12.7regionНазвание регионаstring(255)нет
12.8region_codeКод региона (справочник СДЭК)integerнет
12.9sub_regionНазвание района регионаstring(255)нет
12.10cityНазвание городаstring(255)нет
12.11kladr_code

Код КЛАДР

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

string(255)нет
12.12addressСтрока адресаstring(255)да
13from_locationАдрес отправкиlocationнет
13.1addressСтрока адресаstring(255)да
14services2Дополнительные услугиservice[]нет
14.1codeТип дополнительной услугиintegerда
14.2parameterПараметр дополнительной услуги:
  • количество упаковок для услуги "Упаковка 1" (для всех типов заказа)
  • объявленная стоимость заказа для услуги "Страхование" (только для заказов с типом "доставка")
integerнет
15packages2

Список информации по местам (упаковкам)

Не переданные упаковки будут удалены

package[]нет
15.1package_idУникальный номер упаковки в ИС СДЭК stringнет, если передается новая упаковка (с новым number)
15.2numberНомер упаковки (можно использовать порядковый номер упаковки заказа или номер заказа), уникален в пределах заказа. Идентификатор заказа в ИС Клиентаstring(255)да
15.3weightОбщий вес (в граммах)integerда
15.4lengthГабариты упаковки. Длина (в сантиметрах)integerда, если указаны остальные габариты
15.5widthГабариты упаковки. Ширина (в сантиметрах)integerда, если указаны остальные габариты
15.6heightГабариты упаковки. Высота (в сантиметрах)integerда, если указаны остальные габариты
15.7commentКомментарий к упаковкеstring(255)да, если заказ типа "доставка"
15.8items

Позиции товаров в упаковке

Только для заказов "интернет-магазин"
Максимум 126 позиций

item[]да
15.8.1nameНаименование товара (может также содержать описание товара: размер, цвет)string(255)да
15.8.2ware_keyИдентификатор/артикул товараstring(20)да
15.8.3paymentОплата за товар при получении (за единицу товара в указанной валюте, значение >=0) — наложенный платеж, в случае предоплаты значение = 0moneyда
15.8.3.1valueСумма наложенного платежа (в случае предоплаты = 0)floatда
15.8.3.2vat_sumСумма НДСfloatнет
15.8.3.3vat_rateСтавка НДС (значение - 0, 10, 18, 20 и т.п. , null - нет НДС)integerнет
15.8.4costОбъявленная стоимость товара (за единицу товара в указанной валюте, значение >=0). С данного значения рассчитывается страховкаfloatда
15.8.5weightВес (за единицу товара, в граммах)integerда
15.8.6weight_gross

Вес брутто

integerда, если заказ - международный
15.8.7amountКоличество единиц товара (в штуках)integerда
15.8.8name_i18nНаименование на иностранном языкеstring(255)нет
15.8.9brandБренд на иностранном языкеstring(255)нет
15.8.10country_codeКод страны в формате  ISO_3166-1_alpha-2string(2)нет
15.8.11materialКод материалаstring(255)нет
15.8.12wifi_gsmСодержит wifi/gsmbooleanнет
15.8.13urlСсылка на сайт интернет-магазина с описанием товараstring(255)нет

1 Идентификация заказа происходит по указанным полям (в приоритете cdek_number).

2 Возможен пересчет стоимости заказа при передаче новых значений в указанных полях.

Ответ на изменение заказа

Ответ возвращается в формате 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()да
Пример запроса
{
   "uuid":"72753031-5427-4d1b-b1e4-7c4c26be00a0",
   "cdek_number":"1105660806",
   "tariff_code":"10",
   "sender":{
      "company":"Pogoda",
      "name":"Петров Петр",
      "email":"react@cdek.ru",
      "phones":[
         {
            "number":"+79134637228",
            "additional":"1234"
         }
      ]
   },
   "recipient":{
      "company":"NUMM",
      "name":"Константинов Константин",
      "email":"pochta@gmail.com",
      "phones":[
         {
            "number":"+79134635628",
            "additional":"123"
         }
      ]
   },
   "to_location":{
      "code":"137"
   },
   "from_location":{
      "address":"Новосибирск, Большевистская 101"
   },
   "services":[
      {
         "code":"DANGER_CARGO"
      },
      {
         "code":"PACKAGE_1",
         "parameter":"1"
      }
   ],
   "packages":[
      {
         "number":"bar-666",
         "height":20,
         "length":20,
         "weight":4000,
         "width":20,
         "items":[
            {
               "name":"Товар",
               "ware_key":"00055",
               "payment":{
                  "value":3000
               },
               "cost":300,
               "amount":1,
               "weight":700
            }
         ]
      }
   ]
}


Пример ответа
{
  "entity": {
    "uuid": "72753031-5427-4d1b-b1e4-7c4c26be00a0"
  },
  "requests": [
    {
      "request_uuid": "72753031-35cc-4ef6-a353-25a09d3a973a",
      "type": "UPDATE",
      "state": "ACCEPTED",
      "date_time": "2020-01-23T11:48:40Z",
      "errors": [],
      "warnings": [
        {
          "code": "v2_cost_change_by_tariff",
          "message": "New tariff code can trigger change order cost"
        },
        {
          "code": "v2_cost_change_by_services",
          "message": "New services can trigger change order cost"
        },
        {
          "code": "v2_cost_change_by_parameters",
          "message": "New parameters (weight, dimensions, items cost) can trigger change order cost"
        }
      ]
    }
  ]
}
  • No labels