- 蔬东坡开放平台API文档
- 什么是蔬东坡开放平台
- 开发入门
- 基础数据接口
- 库房
- 商品
- 订单
- 采购单
- 客户协议价
- 客户
- 异步通知
- 订单-退货单
- 商品-溯源
- 出、入库单查询
- 客户类型
- 现有库存查询
- 库房-分拣
- 采购-退货单
- 财务
协议价详情
GET
/openApi/protocolPrice/detail
请求参数
Query 参数
appid
string
必需
timestamp
integer
当前时间戳
示例值:
{{timestamp}}
sign
string
签名参数(32位)
示例值:
{{sign}}
notice
string
可选
site_id
string
站点
id
integer
协议价ID
示例代码
Shell
JavaScript
Java
Swift
Go
PHP
Python
HTTP
C
C#
Objective-C
Ruby
OCaml
Dart
R
请求示例请求示例
Shell
JavaScript
Java
Swift
curl --location -g --request GET 'https://basesfpstest.sdongpo.com/openApi/protocolPrice/detail?appid×tamp={{timestamp}}&sign={{sign}}&id'返回响应
🟢200成功
application/json
Body
status
integer
必需
data
object
必需
no
string
单号
status
string
状态
start_time
string
生效时间
end_time
string
结束时间
remark
string
备注
no_name
string
协议单名称
field_set
string
必需
market_price_type
string
必需
logs
array [object {8}]
必需
isCanUpdate
boolean
必需
user_relation
array [object {7}]
必需
user_relation_desc
string
用户协议价描述
user_name_desc
string
用户名称描述
user_code_desc
string
用户编码描述
pp_id
string
协议单号ID
commoditys
array [object {48}]
商品
id
string
必需
message
string | null
必需
示例
{
"status": 1,
"data": {
"no": "XY24101215502751",
"status": "3",
"start_time": "2024-10-01",
"end_time": "2024-10-10",
"remark": "",
"no_name": "冒烟",
"field_set": "{\"price\":{\"bit\":\"2\",\"logic\":\"1\"},\"discount\":{\"bit\":\"0\",\"logic\":\"1\"},\"org_price\":{\"bit\":\"2\",\"logic\":\"1\"}}",
"market_price_type": "0",
"logs": [
{
"operator": "movee",
"time": "2024-10-17 16:28:20",
"content": "新增商品湖北长阳直采二级粉果番茄（小果）(件)：2元",
"refer_no": null,
"opr_type": "update",
"module_id": "111",
"module": "协议价",
"opr_type_detail": "编辑"
},
{
"operator": "movee",
"time": "2024-10-17 16:26:58",
"content": "云南直发一级生菜20斤（大利）。9(斤)：启用状态由未启用改为已启用 ",
"refer_no": null,
"opr_type": "update",
"module_id": "111",
"module": "协议价",
"opr_type_detail": "编辑"
},
{
"operator": "movee",
"time": "2024-10-17 16:26:57",
"content": "云南直发一级生菜20斤（大利）。9(斤)：启用状态由已启用改为未启用 ",
"refer_no": null,
"opr_type": "update",
"module_id": "111",
"module": "协议价",
"opr_type_detail": "编辑"
},
{
"operator": "movee",
"time": "2024-10-17 16:26:53",
"content": "云南直发一级生菜20斤（大利）。9(斤)：协议价格由3.50改为11 市场价由3.50改为11 ",
"refer_no": null,
"opr_type": "update",
"module_id": "111",
"module": "协议价",
"opr_type_detail": "编辑"
},
{
"operator": "shudongpo",
"time": "2024-10-17 16:23:11",
"content": "云南直发一级生菜20斤（大利）。9(斤)：协议价格由3.50改为2.5 市场价由3.50改为2.5 ",
"refer_no": null,
"opr_type": "update",
"module_id": "111",
"module": "协议价",
"opr_type_detail": "编辑"
},
{
"operator": "shudongpo",
"time": "2024-10-17 16:22:40",
"content": "云南直发一级生菜20斤（大利）。9(斤)：协议价格由2.50改为3.5 市场价由2.50改为3.5 ",
"refer_no": null,
"opr_type": "update",
"module_id": "111",
"module": "协议价",
"opr_type_detail": "编辑"
},
{
"operator": "movee",
"time": "2024-10-17 16:21:24",
"content": "云南直发一级生菜20斤（大利）。9(斤)：协议价格由2.50改为12 市场价由2.50改为12 ",
"refer_no": null,
"opr_type": "update",
"module_id": "111",
"module": "协议价",
"opr_type_detail": "编辑"
},
{
"operator": "movee",
"time": "2024-10-17 16:20:32",
"content": "云南直发一级生菜20斤（大利）。9(斤)：协议价格由2.50改为12 市场价由2.50改为12 ",
"refer_no": null,
"opr_type": "update",
"module_id": "111",
"module": "协议价",
"opr_type_detail": "编辑"
},
{
"operator": "movee",
"time": "2024-10-17 16:20:09",
"content": "云南直发一级生菜20斤（大利）。9(斤)：协议价格由2.50改为12 市场价由2.50改为12 ",
"refer_no": null,
"opr_type": "update",
"module_id": "111",
"module": "协议价",
"opr_type_detail": "编辑"
},
{
"operator": "movee",
"time": "2024-10-17 16:19:11",
"content": "-",
"refer_no": null,
"opr_type": "update",
"module_id": "111",
"module": "协议价",
"opr_type_detail": "编辑"
},
{
"operator": "movee",
"time": "2024-10-17 16:19:09",
"content": "云南直发一级生菜20斤（大利）。9(斤)：启用状态由未启用改为已启用 ",
"refer_no": null,
"opr_type": "update",
"module_id": "111",
"module": "协议价",
"opr_type_detail": "编辑"
},
{
"operator": "movee",
"time": "2024-10-17 16:19:05",
"content": "-",
"refer_no": null,
"opr_type": "update",
"module_id": "111",
"module": "协议价",
"opr_type_detail": "编辑"
},
{
"operator": "movee",
"time": "2024-10-17 16:19:01",
"content": "云南直发一级生菜20斤（大利）。9(斤)：启用状态由已启用改为未启用 ",
"refer_no": null,
"opr_type": "update",
"module_id": "111",
"module": "协议价",
"opr_type_detail": "编辑"
},
{
"operator": "movee",
"time": "2024-10-17 16:17:50",
"content": "云南直发一级生菜20斤（大利）。9(斤)：协议价格由2.50改为11 市场价由2.50改为11 ",
"refer_no": null,
"opr_type": "update",
"module_id": "111",
"module": "协议价",
"opr_type_detail": "编辑"
},
{
"operator": "movee",
"time": "2024-10-17 15:32:14",
"content": "-",
"refer_no": null,
"opr_type": "update",
"module_id": "111",
"module": "协议价",
"opr_type_detail": "编辑"
},
{
"operator": "movee",
"time": "2024-10-17 15:32:00",
"content": "-",
"refer_no": null,
"opr_type": "update",
"module_id": "111",
"module": "协议价",
"opr_type_detail": "编辑"
},
{
"operator": "movee",
"time": "2024-10-17 15:31:48",
"content": "新增商品云南直发一级生菜20斤（大利）。9(斤)：2.5元",
"refer_no": null,
"opr_type": "update",
"module_id": "111",
"module": "协议价",
"opr_type_detail": "编辑"
},
{
"operator": "movee",
"time": "2024-10-17 15:31:25",
"content": "删除零/寿光精品黄瓜（李家）。7(斤)：2.10元",
"refer_no": null,
"opr_type": "delete",
"module_id": "111",
"module": "协议价",
"opr_type_detail": "删除"
},
{
"operator": "movee",
"time": "2024-10-17 15:30:06",
"content": "-",
"refer_no": null,
"opr_type": "update",
"module_id": "111",
"module": "协议价",
"opr_type_detail": "编辑"
},
{
"operator": "shudongpo",
"time": "2024-10-12 19:09:04",
"content": "-",
"refer_no": null,
"opr_type": "update",
"module_id": "111",
"module": "协议价",
"opr_type_detail": "编辑"
},
{
"operator": "shudongpo",
"time": "2024-10-12 19:08:27",
"content": "零/内蒙一级无根菠菜(斤)：协议价格由10.20改为10.5 市场价由10.20改为10.5 ",
"refer_no": null,
"opr_type": "update",
"module_id": "111",
"module": "协议价",
"opr_type_detail": "编辑"
},
{
"operator": "shudongpo",
"time": "2024-10-12 19:08:18",
"content": "新增商品零/寿光精品黄瓜（李家）。7(斤)：2.1元",
"refer_no": null,
"opr_type": "update",
"module_id": "111",
"module": "协议价",
"opr_type_detail": "编辑"
},
{
"operator": "shudongpo",
"time": "2024-10-12 19:07:34",
"content": "-",
"refer_no": null,
"opr_type": "update",
"module_id": "111",
"module": "协议价",
"opr_type_detail": "编辑"
},
{
"operator": "movee",
"time": "2024-10-12 16:26:31",
"content": "删除零/云南直发一级生菜（大利）。9(斤)：2.95元",
"refer_no": null,
"opr_type": "delete",
"module_id": "111",
"module": "协议价",
"opr_type_detail": "删除"
},
{
"operator": "movee",
"time": "2024-10-12 16:25:11",
"content": "删除兰州水果百合碗装拆包（10盒）(件)：120.00元",
"refer_no": null,
"opr_type": "delete",
"module_id": "111",
"module": "协议价",
"opr_type_detail": "删除"
},
{
"operator": "movee",
"time": "2024-10-12 16:24:59",
"content": "新增商品零/内蒙一级无根菠菜(斤)：10.2元\n新增商品兰州水果百合碗装拆包（10盒）(件)：120元",
"refer_no": null,
"opr_type": "update",
"module_id": "111",
"module": "协议价",
"opr_type_detail": "编辑"
},
{
"operator": "movee",
"time": "2024-10-12 16:24:33",
"content": "删除寿光精品黄瓜30斤（李家）。7(件)：20.00元",
"refer_no": null,
"opr_type": "delete",
"module_id": "111",
"module": "协议价",
"opr_type_detail": "删除"
},
{
"operator": "movee",
"time": "2024-10-12 16:24:00",
"content": "新增商品零/云南直发一级生菜（大利）。9(斤)：2.95元\n新增商品甘肃一级箱装大娃46斤(沃农)(箱)(件)：84.4元",
"refer_no": null,
"opr_type": "update",
"module_id": "111",
"module": "协议价",
"opr_type_detail": "编辑"
},
{
"operator": "movee",
"time": "2024-10-12 16:02:16",
"content": "删除兰州一级西葫芦22斤。(件)：19.00元",
"refer_no": null,
"opr_type": "delete",
"module_id": "111",
"module": "协议价",
"opr_type_detail": "删除"
},
{
"operator": "movee",
"time": "2024-10-12 16:01:25",
"content": "生效时间由”2024-10-09到2024-10-11“调整至”2024-10-12到2024-10-19“\n新增商品兰州一级西葫芦22斤。(件)：19元",
"refer_no": null,
"opr_type": "update",
"module_id": "111",
"module": "协议价",
"opr_type_detail": "编辑"
},
{
"operator": "movee",
"time": "2024-10-12 16:00:08",
"content": "操作审核了协议单",
"refer_no": null,
"opr_type": "update",
"module_id": "111",
"module": "协议价",
"opr_type_detail": "编辑"
},
{
"operator": "movee",
"time": "2024-10-12 15:59:53",
"content": "生效时间由”2024-10-09到2024-10-12“调整至”2024-10-09到2024-10-11“",
"refer_no": null,
"opr_type": "update",
"module_id": "111",
"module": "协议价",
"opr_type_detail": "编辑"
},
{
"operator": "movee",
"time": "2024-10-12 15:50:35",
"content": "寿光精品黄瓜30斤（李家）。7(件)：协议价格由57.00改为20 市场价由57.00改为20 ",
"refer_no": null,
"opr_type": "update",
"module_id": "111",
"module": "协议价",
"opr_type_detail": "编辑"
},
{
"operator": "movee",
"time": "2024-10-12 15:50:28",
"content": "寿光精品黄瓜30斤（李家）。7(件)：57元",
"refer_no": null,
"opr_type": "add",
"module_id": "111",
"module": "协议价",
"opr_type_detail": "新增"
}
],
"isCanUpdate": false,
"user_relation": [
{
"pp_id": "1",
"user_id": "237",
"user_name": "pnw1中国逾50个城市和600所学校为庆祝世界儿童日而",
"user_code": "200",
"line_id": "94",
"line_name": "客户导入线路g老解",
"id": "1"
}
],
"user_relation_desc": "pnw1中国逾50个城市和600所学校为庆祝世界儿童日而",
"user_name_desc": "pnw1中国逾50个城市和600所学校为庆祝世界儿童日而",
"user_code_desc": "200",
"pp_id": "1",
"commoditys": [
{
"id": "14",
"name": "甘肃一级箱装大娃46斤(沃农)(箱)",
"parent_id": "13",
"summary": "毛重50斤 净重46斤 浮动0.5斤",
"unit": "件",
"category_id": "1",
"category_id2": "7",
"commodity_code": "GSYJXZDWJWNX8986",
"in_price": "0.00",
"in_price_update_time": "-",
"default_provider_id": "1",
"bargain_price": "84.40",
"pp_price": "84.40",
"price": "84.40",
"discount": "0.00",
"formula_type": "0",
"formula_value": "0.00",
"pp_detail_id": "4",
"is_enabled": "1",
"market_price": "2.00",
"sort_num": "2",
"is_protocol_price_by_base_unit": "0",
"unit_num": "46.00",
"unit_convert": "N",
"remark": "",
"ppd_is_sell_stock": "-1",
"ppd_sell_stock": "0.00",
"logoPath": "http://base-image.sdongpo.com/base_1530/upload_pic/u=2716549510,3481261388&fm=253&fmt=auto&app=138&f=JPEG_com_thumb_202409021452077d526b3466d56097b2671.webp",
"logoPath1": "http://base-image.sdongpo.com/base_1530/upload_pic/u=2716549510,3481261388&fm=253&fmt=auto&app=138&f=JPEG_com_thumb_202409021452077d526b3466d56097b2671.webp!800x800",
"category_sequence_1": "10",
"category_sequence_2": "50",
"category_code1": "01",
"category_code2": "01011",
"category1": "叶菜大类",
"category2": "大娃娃菜",
"category3": "",
"category_name": "叶菜大类",
"category_name2": "大娃娃菜",
"default_provider_name": "测试供应商-1",
"provider_float_rate": "0.00",
"unit_convert_text": "1件=46.00斤",
"category_code": "01",
"formula_type_list": [
{
"id": 1,
"name": "加价值"
},
{
"id": 2,
"name": "成本加价率"
},
{
"id": 3,
"name": "销售加价率"
},
{
"id": 5,
"name": "自定义公式"
},
{
"id": 7,
"name": "成本降价率"
}
],
"formula_desc": [
{
"id": 1,
"name": "进价 + 加价值"
},
{
"id": 2,
"name": "进价 + 进价*加价率"
},
{
"id": 3,
"name": "成本 ÷（1 - 销售加价率）"
},
{
"id": 5,
"name": ""
},
{
"id": 7,
"name": "参考价 - 参考价*降价率"
}
],
"is_protocol_price_by_base_unit_desc": "否",
"is_base_unit_desc": "否",
"org_price": "",
"user_commodity_alias_desc": "--"
},
{
"id": "563",
"name": "零/内蒙一级无根菠菜",
"parent_id": "563",
"summary": "拆零商品 16:00后不可下单",
"unit": "斤",
"category_id": "1",
"category_id2": "144",
"commodity_code": "LNMYJWGBC1220",
"in_price": "0.00",
"in_price_update_time": "-",
"default_provider_id": "1",
"bargain_price": "10.20",
"pp_price": "10.20",
"price": "10.20",
"discount": "0.00",
"formula_type": "0",
"formula_value": "0.00",
"pp_detail_id": "5",
"is_enabled": "1",
"market_price": "2.00",
"sort_num": "2",
"is_protocol_price_by_base_unit": "0",
"unit_num": "1.00",
"unit_convert": "N",
"remark": "",
"ppd_is_sell_stock": "-1",
"ppd_sell_stock": "0.00",
"logoPath": "http://base-image.sdongpo.com/base_1530/upload_pic/1725780970300_com_thumb_202409081541498e39b4a166dd553dc08fd.png",
"logoPath1": "http://base-image.sdongpo.com/base_1530/upload_pic/1725780970300_com_thumb_202409081541498e39b4a166dd553dc08fd.png!800x800",
"category_sequence_1": "10",
"category_sequence_2": "31",
"category_code1": "01",
"category_code2": "01030",
"category1": "叶菜大类",
"category2": "0.菠菜",
"category3": "",
"category_name": "叶菜大类",
"category_name2": "0.菠菜",
"default_provider_name": "测试供应商-1",
"provider_float_rate": "0.00",
"unit_convert_text": "1斤=1.00斤",
"category_code": "01",
"formula_type_list": [
{
"id": 1,
"name": "加价值"
},
{
"id": 2,
"name": "成本加价率"
},
{
"id": 3,
"name": "销售加价率"
},
{
"id": 5,
"name": "自定义公式"
},
{
"id": 7,
"name": "成本降价率"
}
],
"formula_desc": [
{
"id": 1,
"name": "进价 + 加价值"
},
{
"id": 2,
"name": "进价 + 进价*加价率"
},
{
"id": 3,
"name": "成本 ÷（1 - 销售加价率）"
},
{
"id": 5,
"name": ""
},
{
"id": 7,
"name": "参考价 - 参考价*降价率"
}
],
"is_protocol_price_by_base_unit_desc": "否",
"is_base_unit_desc": "是",
"org_price": "",
"user_commodity_alias_desc": "--"
},
{
"id": "1",
"name": "云南直发一级生菜20斤（大利）。9",
"parent_id": "1",
"summary": "",
"unit": "斤",
"category_id": "1",
"category_id2": "3",
"commodity_code": "YNZFYJSCGJDL0123",
"in_price": "3.30",
"in_price_update_time": "2024-11-18 17:16:47",
"default_provider_id": "1",
"bargain_price": "2.50",
"pp_price": "3.50",
"price": "3.50",
"discount": "100.00",
"formula_type": "0",
"formula_value": "0.00",
"pp_detail_id": "23",
"is_enabled": "1",
"market_price": "2.50",
"sort_num": "2",
"is_protocol_price_by_base_unit": "0",
"unit_num": "1.00",
"unit_convert": "N",
"remark": "",
"ppd_is_sell_stock": "-1",
"ppd_sell_stock": "0.00",
"logoPath": "http://base-image.sdongpo.com/sdpcloud/upload_pic/com_thumb_2018061216191887528dbd5b1f820664fb8.jpg",
"logoPath1": "http://base-image.sdongpo.com/sdpcloud/upload_pic/com_thumb_2018061216191887528dbd5b1f820664fb8.jpg!800x800",
"category_sequence_1": "10",
"category_sequence_2": "60",
"category_code1": "01",
"category_code2": "01001",
"category1": "叶菜大类",
"category2": "生菜",
"category3": "",
"category_name": "叶菜大类",
"category_name2": "生菜",
"default_provider_name": "测试供应商-1",
"provider_float_rate": "0.00",
"unit_convert_text": "1斤=1.00斤",
"category_code": "01",
"formula_type_list": [
{
"id": 1,
"name": "加价值"
},
{
"id": 2,
"name": "成本加价率"
},
{
"id": 3,
"name": "销售加价率"
},
{
"id": 5,
"name": "自定义公式"
},
{
"id": 7,
"name": "成本降价率"
}
],
"formula_desc": [
{
"id": 1,
"name": "进价 + 加价值"
},
{
"id": 2,
"name": "进价 + 进价*加价率"
},
{
"id": 3,
"name": "成本 ÷（1 - 销售加价率）"
},
{
"id": 5,
"name": ""
},
{
"id": 7,
"name": "参考价 - 参考价*降价率"
}
],
"is_protocol_price_by_base_unit_desc": "否",
"is_base_unit_desc": "是",
"org_price": "",
"user_commodity_alias_desc": "生菜"
},
{
"id": "142",
"name": "湖北长阳直采二级粉果番茄（小果）",
"parent_id": "141",
"summary": "",
"unit": "件",
"category_id": "10",
"category_id2": "50",
"commodity_code": "HBCYZCEJFGFQXG8297",
"in_price": "0.00",
"in_price_update_time": "-",
"default_provider_id": "1",
"bargain_price": "2.00",
"pp_price": "2.00",
"price": "2.00",
"discount": "0.00",
"formula_type": "0",
"formula_value": "0.00",
"pp_detail_id": "26",
"is_enabled": "1",
"market_price": "2.00",
"sort_num": "3",
"is_protocol_price_by_base_unit": "0",
"unit_num": "35.00",
"unit_convert": "N",
"remark": "",
"ppd_is_sell_stock": "-1",
"ppd_sell_stock": "0.00",
"logoPath": "http://base-image.sdongpo.com/sdpcloud/upload_pic/com_thumb_20180613155740e32e92115b20ce74678fb.jpg",
"logoPath1": "http://base-image.sdongpo.com/sdpcloud/upload_pic/com_thumb_20180613155740e32e92115b20ce74678fb.jpg!800x800",
"category_sequence_1": "7",
"category_sequence_2": "38",
"category_code1": "02",
"category_code2": "02023",
"category1": "瓜果茄",
"category2": "西红柿",
"category3": "",
"category_name": "瓜果茄",
"category_name2": "西红柿",
"default_provider_name": "测试供应商-1",
"provider_float_rate": "0.00",
"unit_convert_text": "1件=35.00斤",
"category_code": "02",
"formula_type_list": [
{
"id": 1,
"name": "加价值"
},
{
"id": 2,
"name": "成本加价率"
},
{
"id": 3,
"name": "销售加价率"
},
{
"id": 5,
"name": "自定义公式"
},
{
"id": 7,
"name": "成本降价率"
}
],
"formula_desc": [
{
"id": 1,
"name": "进价 + 加价值"
},
{
"id": 2,
"name": "进价 + 进价*加价率"
},
{
"id": 3,
"name": "成本 ÷（1 - 销售加价率）"
},
{
"id": 5,
"name": ""
},
{
"id": 7,
"name": "参考价 - 参考价*降价率"
}
],
"is_protocol_price_by_base_unit_desc": "否",
"is_base_unit_desc": "否",
"org_price": "",
"user_commodity_alias_desc": "--"
}
],
"id": "1"
},
"message": null
}