仅“已办理”状态的订单可以删除，已经入仓过的订单无法通过该接口取消。

请求内容格式为 JSON (Content-Type: application/json) 字符编码 UTF-8.

为了取消订单需要发送 DELETE-请求， 请求URL:

测试环境 https://api.edu.cdek.ru/v2/orders/{uuid}
正式环境 https://api.cdek.ru/v2/orders/{uuid}
中国的环境 https://int.cdek-express.cn/v2/orders/{uuid}

返回的内容

返回的内容为 JSON 格式:

序号 属性 名称 属性类型 必填的
1 entity 订单信息 entity 否
1.1 uuid CDEK订单识别码 UUID 否
2 requests 订单对应的请求列表 request[] 是
2.1 request_uuid 请求识别码（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, WAITING, SUCCESSFUL, INVALID		 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() 是

请求例子：

  1. # encoding: utf-8
  2. import requests
  3. import urllib.parse
  4. import sys
  6. entity_uuid = '72753033-db0e-4042-9392-c5a077e24669'
  7. access_token = "....." #- 访问令牌
  9. url = f'https://api.cdek.ru/v2/orders/{entity_uuid}'
  10. headers = {'Authorization': 'Bearer '+access_token, 'Content-type': 'application/json'}
  11. responce = requests.delete(url, headers=headers) 
  12. print(responce) # <Response [200]>
  13. print(responce.text)

返回的数据

  1. {
  2.     "entity": {
  3.         "uuid": "72753033-db0e-4042-9392-c5a077e24669"
  4.     },
  5.     "requests": [{
  6.         "request_uuid": "72753033-fafa-46a5-81a4-c7dab856a408",
  7.         "type": "DELETE",
  8.         "date_time": "2020-03-27T17:26:10+0700",
  9.         "state": "ACCEPTED"
  10.     }]
  11. }

申请删除之后可以获取订单状态：

  1. responce = requests.get(f'https://api.cdek.ru/v2/orders/{entity_uuid}', headers=headers)
  2. print(responce.text)
  3. print(responce)
  1. {
  2.     "entity": {
  3.         "uuid": "72753033-35da-44aa-8eb0-005f09dec68a",
  4.         "type": 1,
  5.         "is_return": false,
  6.         "cdek_number": "1169343879",
  7.         "number": "TEST7-CT789435359CN",
  8.         "tariff_code": 246,
  9.         "comment": "",
  10.         "date_invoice": "2020-03-26",
  11.         "shipper_name": "CDEK",
  12.         "shipper_address": "Novosibirsk",
  13.         "delivery_recipient_cost": {
  14.             "value": 0
  15.         },
  16.         "sender": {
  17.             "name": "Zhang san"
  18.         },
  19.         "seller": {
  20.             "name": "Zhang san",
  21.             "address": "Shanghai, Changning District"
  22.         },
  23.         "recipient": {
  24.             "name": "Ivanov Sergei Petrovich",
  25.             "phones": [{
  26.                 "number": "9990003456"
  27.             }, {
  28.                 "number": "9990001234"
  29.             }]
  30.         },
  31.         "from_location": {
  32.             "code": "12683",
  33.             "postal_code": "200050",
  34.             "longitude": 121.470462,
  35.             "latitude": 31.230863,
  36.             "country_code": "CN",
  37.             "region": "Шанхай",
  38.             "region_code": "906",
  39.             "sub_region": "",
  40.             "city": "Шанхай",
  41.             "address": "",
  42.             "country": "Китай (КНР)"
  43.         },
  44.         "to_location": {
  45.             "code": "430",
  46.             "fias_guid": "bb035cc3-1dc2-4627-9d25-a1bf2d4b936b",
  47.             "postal_code": "443034",
  48.             "longitude": 50.1018,
  49.             "latitude": 53.1955,
  50.             "country_code": "RU",
  51.             "region": "Самарская",
  52.             "region_code": "57",
  53.             "sub_region": "Самара",
  54.             "city": "Самара",
  55.             "kladr_code": "6300000100000",
  56.             "address": "Lenina ulitsa, 35 28;Samara;Samarskaya oblast",
  57.             "country": "Россия"
  58.         },
  59.         "packages": [{
  60.             "number": "TEST7-CT789435359CN",
  61.             "weight": 120,
  62.             "length": 0,
  63.             "width": 0,
  64.             "height": 0,
  65.             "comment": "приложена опись",
  66.             "items": [{
  67.                 "name": "Measuring tools",
  68.                 "ware_key": "WELRV0086000627YQ",
  69.                 "payment": {
  70.                     "value": 0
  71.                 },
  72.                 "weight": 120,
  73.                 "weight_gross": 120,
  74.                 "amount": 1,
  75.                 "url": "",
  76.                 "cost": 0
  77.             }, {
  78.                 "name": "Measuring tools",
  79.                 "ware_key": "WELRV0086000627YQ",
  80.                 "payment": {
  81.                     "value": 0.0,
  82.                     "vat_sum": 0.0
  83.                 },
  84.                 "weight": 120,
  85.                 "weight_gross": 120,
  86.                 "amount": 1,
  87.                 "cost": 0.0
  88.             }]
  89.         }],
  90.         "statuses": [{
  91.             "code": "ACCEPTED",
  92.             "name": "Принят",
  93.             "date_time": "2020-03-27T17:34:42+0700",
  94.             "city": "Офис СДЭК"
  95.         }, {
  96.             "code": "CREATED",
  97.             "name": "Создан",
  98.             "date_time": "2020-03-27T17:34:43+0700",
  99.             "city": "Офис СДЭК"
  100.         }, {
  101.             "code": "CREATED",
  102.             "name": "Создан",
  103.             "date_time": "2020-03-27T17:34:44+0700",
  104.             "city": "Шанхай"
  105.         }, {
  106.             "code": "REMOVED",
  107.             "name": "Удален",
  108.             "date_time": "2020-03-27T17:38:46+0700",
  109.             "city": "Офис СДЭК"
  110.         }],
  111.         "shop_seller_name": "Zhang san",
  112.         "shop_seller_address": "Shanghai, Changning District"
  113.     },
  114.     "requests": [{
  115.         "request_uuid": "72753033-6f26-4cbc-9daf-7d44f04e50f9",
  116.         "type": "CREATE",
  117.         "date_time": "2020-03-27T17:34:43+0700",
  118.         "state": "SUCCESSFUL" //CREATE SUCCESSFUL 成功下单了
  119.     }, {
  120.         "request_uuid": "72753033-d0aa-4c65-a20e-ebe3970ba368",
  121.         "type": "DELETE", 
  122.         "date_time": "2020-03-27T17:38:47+0700",
  123.         "state": "SUCCESSFUL" //type DELETE SUCCESSFUL订单已经成功被删除了
  124.     }]
  125. }