Изменение заказа


 

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

Условием возможности изменения заказа является отсутствие движения груза на складе СДЭК (т.е. статус заказа «Создан»).

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

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

Среда

URL

тестоваяhttps://api.edu.cdek.ru/v2/orders
боеваяhttps://api.cdek.ru/v2/orders

Тело запроса 

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

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

Тэг/Атрибут

Описание

Тип поля

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

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

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

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

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

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

threshold[]

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

Эл. адрес

Должен соответствовать RFC 2822

string(255)нет
9.4passport_seriesСерия паспортаstring(4)нет
9.5passport_numberНомер паспортаstring(30)нет
9.6passport_date_of_issueДата выдачи паспортаdate (yyyy-MM-dd)нет
9.7passport_organizationОрган выдачи паспортаstring(255)нет
9.8tin

ИНН

Может содержать 10, либо 12 символов

string(12)нет
9.9passport_date_of_birthДата рожденияdate (yyyy-MM-dd)нет
9.10phones

Список телефонов

Не более 10 номеров

phone[]нет
9.10.1number*

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

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

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

sellerнет
10.1nameНаименование истинного продавцаstring(255)нет
10.2innИНН истинного продавцаstring(12)нет
10.3phone*Телефон истинного продавцаstring(255)нет
10.4ownership_formКод формы собственностиintegerнет
11recipientПолучательcontactнет
11.1companyНазвание компанииstring(255)нет
11.2nameФИО контактного лицаstring(255)нет
11.3passport_seriesСерия паспортаstring(4)нет
11.4passport_numberНомер паспортаstring(30)нет
11.5passport_date_of_issueДата выдачи паспортаdate (yyyy-MM-dd)нет
11.6passport_organizationОрган выдачи паспортаstring(255)нет
11.7tin

ИНН

Может содержать 10, либо 12 символов

string(12)нет
11.8passport_date_of_birthДата рожденияdate (yyyy-MM-dd)нет
11.9email

Эл. адрес

Должен соответствовать RFC 2822

string(255)нет
11.10phonesСписок телефоновphone[]нет
11.10.1number*Номер телефона
Должен передаваться в международном формате: код страны (для России +7) и сам номер (10 и более цифр)
string(255)да
11.10.2additionalДополнительная информация (доп. номер)string(255)нет
12to_location2Адрес получения
Не может использоваться одновременно с delivery_point
locationнет
12.1codeКод населенного пункта СДЭК (метод "Список населенных пунктов")integerнет
12.2fias_guidУникальный идентификатор ФИАСUUIDнет
12.3postal_codeПочтовый индексstring(255)нет
12.4longitudeДолготаfloatнет
12.5latitudeШиротаfloatнет
12.6country_codeКод страны в формате  ISO_3166-1_alpha-2 (по умолчанию RU)string(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Адрес отправки
Не может использоваться одновременно с shipment_point
locationнет
13.1addressСтрока адресаstring(255)нет
14services2Дополнительные услугиservice[]нет
14.1codeТип дополнительной услугиintegerда
14.2parameterПараметр дополнительной услуги:
  • количество упаковок для услуг "Упаковка 1", "Пакет курьерский А2", "Сейф пакет А2", "Сейф пакет А3", "Сейф пакет А4", "Сейф пакет А5" (для всех типов заказа)
  • объявленная стоимость заказа для услуги "Страхование" (только для заказов с типом "доставка")
  • длина для услуг "Воздушно-пузырчатая пленка", "Макулатурная бумага"
  • номер телефона для услуги "Уведомление о вручении заказа"
integerнет
15packages2

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

Не переданные упаковки будут удалены
Количество мест в заказе может быть от 1 до 255.

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

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

Только для заказов "интернет-магазин"
Не более 126 уникальных строк в одном заказе
Общее количество товаров в заказе может быть от 1 до 10000

item[]да
15.8.1nameНаименование товара (может также содержать описание товара: размер, цвет)string(255)да
15.8.2ware_key

Идентификатор/артикул товара

Артикул товара может содержать только символы: [A-z А-я 0-9 ! @ " # № $ ; % ^ : & ? * () _ - + = ? < > , .{ } [ ] \ / , пробел]

При передаче одинаковых артикулов в рамках одной упаковки, артикул будет заменяться на:

{ware_key}_1, {ware_key}_2 и так далее.

string(50)да
15.8.3marking

Маркировка товара
Если для товара/вложения указана маркировка, Amount не может быть больше 1.

Для корректного отображения маркировки товара в чеке требуется передавать
НЕ
РАЗОБРАННЫЙ тип маркировки, который может выглядеть следующим образом: 

1) Код товара в формате GS1

Пример: 010468008549838921AAA0005255832GS91EE06GS92VTwGVc7wKCc2tqRncUZ1RU5LeUKSXjWbfNQOpQjKK+A

2) Последовательность допустимых символов общей длиной в 29 символов. 

Пример: 00000046198488X?io+qCABm8wAYa

3) Меховые изделия. Имеют собственный формат.

Пример: RU-430302-AAA7582720

string()нет
15.8.4paymentОплата за товар при получении (за единицу товара в указанной валюте, значение >=0) — наложенный платеж, в случае предоплаты значение = 0moneyда
15.8.4.1valueСумма наложенного платежа (в случае предоплаты = 0)floatда
15.8.4.2vat_sumСумма НДСfloatнет
15.8.4.3vat_rateСтавка НДС (значение - 0, 10, 12, 20, null - нет НДС)integerнет
15.8.5costОбъявленная стоимость товара (за единицу товара в указанной валюте, значение >=0). С данного значения рассчитывается страховкаfloatда
15.8.6weightВес (за единицу товара, в граммах)integerда
15.8.7weight_gross

Вес брутто

integerда, если заказ - международный
15.8.8amount

Количество единиц товара (в штуках)

Количество одного товара в заказе может быть от 1 до 999

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

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

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

(*)    • Номер телефона отправителя (9.10.1) валидируется на соответствие формату телефонов в стране отправителя (телефонный код, количество символов).
Исключение: если телефон не соответствует формату страны отправителя, но соответствует формату телефонов России, Казахстана, Китая или Малазии, заказ будет зарегистрирован успешно.

     • Номер телефона получателя (11.10.1) валидируется на соответствие формату телефонов в стране получателя (телефонный код, количество символов).
Исключение: если телефон не соответствует формату страны отправителя, но соответствует формату телефонов России, Казахстана, Китая или Малазии, заказ будет зарегистрирован успешно.

     • Номер телефона продавца (10.3) валидируется на соответствие формату телефонов в стране получателя (телефонный код, количество символов), а также соответствие кода оператора пулу номеров активных телефонных операторов.

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

Ответ возвращается в формате 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"
        }
      ]
    }
  ]
}


 

© 2000—2024, Курьерская компания СДЭК