訂單管理

新增訂單

• API 地址：salesorder/add
• HTTP 方法：POST
• 授權(quán)方式：通用授權(quán)

請(qǐng)求參數(shù)

參數(shù)	類型	是否必須	參數(shù)說(shuō)明
op_user	string(40)	是	操作用戶ID。可通過(guò) 用戶列表 接口獲取
POST流	json(map)	是	POST 方法提交的流數(shù)據(jù)，字段與值的鍵值對(duì)，例如 { "subject":"WiseCRM365標(biāo)準(zhǔn)版 100用戶" } 字段可通過(guò) 元數(shù)據(jù) 接口獲取

返回?cái)?shù)據(jù)示例

{
  "error_code": 0,
  "error_msg": "調(diào)用成功",
  "data": {
    "salesorder_id": "xxx"
  }
}

返回?cái)?shù)據(jù)說(shuō)明

字段	類型	字段說(shuō)明
salesorder_id	string(40)	新增訂單的唯一ID，為 40 位 hash 字符串

獲取單條訂單

• API 地址：salesorder/get
• HTTP 方法：GET
• 授權(quán)方式：通用授權(quán)

請(qǐng)求參數(shù)

參數(shù)	類型	是否必須	參數(shù)說(shuō)明
op_user	string(40)	是	操作用戶ID。可通過(guò) 用戶列表 接口獲取
salesorder_id	string(40)	是	要獲取的訂單ID
fields	string	是	要獲取的字段列表，多個(gè)字段以逗號(hào)（,）分隔 字段可通過(guò) 元數(shù)據(jù) 接口獲取

返回?cái)?shù)據(jù)示例

{
  "error_code": 0,
  "error_msg": "調(diào)用成功",
  "data": {
    "subject": "WiseCRM365標(biāo)準(zhǔn)版 100用戶",
    "amount": 99999.00
  }
}

返回?cái)?shù)據(jù)說(shuō)明

字段	類型	字段說(shuō)明
data	json(map)	數(shù)據(jù)以鍵值對(duì)的形式放置在此字段

查詢訂單列表

• API 地址：salesorder/list
• HTTP 方法：GET
• 授權(quán)方式：通用授權(quán)

請(qǐng)求參數(shù)

參數(shù)	類型	是否必須	參數(shù)說(shuō)明
op_user	string(40)	是	操作用戶。可通過(guò) 用戶列表 接口獲取
fields	string	是	要查詢的字段列表，多個(gè)字段以逗號(hào)（,）分隔 字段請(qǐng)通過(guò) 元數(shù)據(jù) 接口獲取
qname	string	否	查詢主顯字段（name_field），支持使用星號(hào)模糊匹配，如 *企能軟件 將查詢以企能軟件結(jié)尾的訂單。如需更復(fù)雜的查詢請(qǐng)參考 高級(jí)查詢接口
page_no	int	否	頁(yè)碼，默認(rèn) 1
page_size	int	否	頁(yè)大小，默認(rèn) 20，最大 200

此接口暫不支持排序參數(shù)，默認(rèn)順序?yàn)橛涗泟?chuàng)建時(shí)間由近到遠(yuǎn)，如需使用排序請(qǐng)參考 高級(jí)查詢接口

返回?cái)?shù)據(jù)示例

{
  "error_code": 0,
  "error_msg": "調(diào)用成功",
  "total_size": 10000,
  "page_size": 20,
  "page_no": 1,
  "data": [
    { "salesorderId": "xxx", "subject": "WiseCRM365標(biāo)準(zhǔn)版 100用戶", "amount": 99999.00 },
    { "salesorderId": "xxx", "subject": "WiseCRM365標(biāo)準(zhǔn)版 100用戶", "amount": 99999.00 }
  ]
}

返回?cái)?shù)據(jù)說(shuō)明

字段	類型	字段說(shuō)明
total_size	int	總記錄數(shù)
page_size	int	查詢的頁(yè)大小
page_no	int	查詢的頁(yè)碼
data	json(array)	數(shù)據(jù)以 數(shù)組->鍵值對(duì) 的形式放置在此字段

修改訂單

• API 地址：salesorder/update
• HTTP 方法：POST
• 授權(quán)方式：通用授權(quán)

請(qǐng)求參數(shù)

參數(shù)	類型	是否必須	參數(shù)說(shuō)明
op_user	string(40)	是	操作用戶ID。可通過(guò) 用戶列表 接口獲取
salesorder_id	string(40)	是	要修改的訂單ID
POST流	json(map)	是	POST 方法提交的流數(shù)據(jù)，字段與值的鍵值對(duì)，例如 { "unit":"021-54590135" } 字段請(qǐng)通過(guò) 元數(shù)據(jù) 接口獲取

返回?cái)?shù)據(jù)示例

{
  "error_code": 0,
  "error_msg": "調(diào)用成功",
  "data": {
    "salesorder_id": "xxx"
  }
}

返回?cái)?shù)據(jù)說(shuō)明

字段	類型	字段說(shuō)明
salesorder_id	string(40)	被修改的訂單ID

刪除訂單

• API 地址：salesorder/delete
• HTTP 方法：POST
• 授權(quán)方式：通用授權(quán)

請(qǐng)求參數(shù)

參數(shù)	類型	是否必須	參數(shù)說(shuō)明
op_user	string(40)	是	操作用戶ID。可通過(guò) 用戶列表 接口獲取
salesorder_id	string(40)	是	要?jiǎng)h除的訂單ID
cascade_delete	string	否	級(jí)聯(lián)刪除選項(xiàng)，詳情參照 級(jí)聯(lián)刪除

返回?cái)?shù)據(jù)示例

{
  "error_code": 0,
  "error_msg": "調(diào)用成功",
  "data": {
    "salesorder_id": "xxx"
  }
}

返回?cái)?shù)據(jù)說(shuō)明

字段	類型	字段說(shuō)明
salesorder_id	string(40)	被刪除的訂單ID