- 蔬东坡开放平台API文档
- 什么是蔬东坡开放平台
- 开发入门
- 基础数据接口
- 库房
- 商品
- 订单
- 采购单
- 客户协议价
- 客户
- 异步通知
- 订单-退货单
- 商品-溯源
- 出、入库单查询
- 客户类型
- 现有库存查询
- 库房-分拣
- 采购-退货单
- 财务
采购单查询
GET
/openApi/provider/purchase
请求参数
Query 参数
appid
string
必需
timestamp
integer
当前时间戳
示例值:
{{timestamp}}
sign
string
签名参数(32位)
示例值:
{{sign}}
notice
string
可选
site_id
string
站点
page
integer
页码
page_size
integer
每页大小 <=5
示例值:
1
store_id
integer
仓库ID
increment
string
增量查询根据ID
no
string
采购单号
status
integer
可选
provider
string
供应商ID
nos
string
多个采购单号,分割
start_time
string
创建开始时间
end_time
string
创建结束时间
delivery_start_time
string
计划交货开始时间
delivery_end_time
string
计划交货结束时间
agent
integer
采购员ID
commodity_id
integer
商品ID
author
string
制单人名称
start_update_time
string
可选
end_update_time
string
可选
示例代码
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/provider/purchase?appid×tamp={{timestamp}}&sign={{sign}}¬ice&site_id&page&page_size=1&store_id&increment&no&status&provider&nos&start_time&end_time&delivery_start_time&delivery_end_time&agent&commodity_id&author&start_update_time&end_update_time'返回响应
🟢200成功
application/json
Body
status
integer
必需
data
object
必需
list
array [object {26}]
必需
pageParams
object
必需
sum
object
必需
message
string | null
必需
示例
{
"status": 1,
"data": {
"list": [
{
"id": "451",
"pur_no": "CGS24112800004",
"purchase_status": "全部收货",
"storage_name": "默认库房岳麓区中电软件园",
"purchase_type": "2",
"agent_id": "0",
"agent_code": "",
"provider_id": "3",
"provider_code": "asas111",
"provider_supervisor": "3",
"provider_supervisor_code": "002",
"provider_supervisor_name": "王秀春",
"purchase_num": "1",
"purchase_price": "20.00",
"author": "movee",
"storage_id": "1001",
"source": "2",
"procured_num": "1",
"purchase_time": "2024-11-28 14:40:15",
"plan_date": "2024-11-29",
"send_date": null,
"invoice_number": "",
"order_commodity_tag_id": "0",
"order_commodity_tag_name": "",
"update_time": "2025-04-01 16:47:41",
"commoditys": [
{
"id": "867",
"name": "入库价商品",
"unit": "斤",
"unit_num": "1.00",
"unit_convert": "N",
"base_unit": "斤",
"commodity_code": "RKJSP5352",
"logo": "http://base-image.sdongpo.com/base_1550/upload_pic/default_2x_com_thumb_2024101816421846e865ff67121f6a2d06e.png",
"summary": "",
"last_in_price": "1.00",
"category_id": "1",
"category_id2": "3",
"category_id3": "0",
"pinyin": "RUKUJIASHANGPIN,RKJSP",
"is_batch": "0",
"shelf_life": "0",
"is_rough": "N",
"central_purchase_flag": "0",
"tax_class_code": "",
"brand": "",
"product_place": "",
"durability_period": "",
"purchase_num": "5.00",
"stock_price": null,
"stock": "15.00",
"num": "5.00",
"in_num": "5.00",
"in_sub_price": "20.00",
"purchase_price": "4.00",
"purchase_total_price": "20.00",
"market_price": "3.00",
"remark": "",
"sort_num": "1",
"reference_price": "3.0000",
"bar_code": [],
"bar_code_text": "",
"unreceive": 0,
"price": "4.00",
"in_store_price": "4.00",
"in_total_price": "20.00",
"in_store_num": "5.00",
"total_price": "20.00",
"commodity_id": "2846",
"purchase_status": "2",
"status": "全部收货",
"in_price": "1.00",
"inquiry_price": "0.00",
"return_num": 0,
"return_price": 0,
"real_price": "20.00",
"real_num": "5.00",
"purchase_agreement_price": 0,
"price_type": 0,
"last_receipt_price": "20.0000",
"this_price": "4.00",
"this_num": 0,
"this_total_price": "0.00",
"sum_price": "20.00",
"is_stage": "0",
"pur_id": "451",
"stage_price": "0.00",
"stage_num": "0.00",
"input_tax_rate": "-",
"input_tax": "-",
"tax_exclusive": "20.0000",
"edit_num": 0,
"purchase_receipt_price": [
{
"receipt_price": "4.00",
"created_at": "2024.11.28"
},
{
"receipt_price": "3.00",
"created_at": "2024.11.28"
},
{
"receipt_price": "1.00",
"created_at": "2024.11.28"
},
{
"receipt_price": "2.00",
"created_at": "2024.11.28"
}
],
"area_location": "-",
"default_area_id": "0",
"area_id": "0",
"default_location_id": "0",
"location_id": "0",
"batch_no": "",
"production_date": "",
"expired_date": "",
"cost_before_this_price": "0.00",
"cost_before_this_total_price": "0.00",
"is_updated": true,
"real_in_num": "5.00",
"real_in_price": "20.00",
"real_in_unit_price": "4.00",
"total_in_num": "5.00",
"total_in_price": "20.00",
"total_in_unit_price": "4.00",
"unit_convert_text": "1斤=1.00斤",
"customize_field_35": "",
"category_sequence_1": "10",
"category_sequence_2": "60",
"category_code1": "01",
"category_code2": "01001",
"category_name": "叶菜大类/生菜",
"cate_code": "01001",
"category1": "叶菜大类",
"category2": "生菜",
"category3": "",
"cloud_reference_price": "0.00",
"logs": {
"main": {
"this_un_received_total": "0",
"this_received_total": "5.00",
"this_total": "5.00"
},
"un_received_items": [],
"received_items": [
{
"id": "447",
"purchase_commodity_id": "867",
"status": "1",
"number": "5.00",
"delete": "0",
"op_id": "1",
"op_user": "movee",
"op_user_type": "1",
"create_time": "2024-11-28 14:40:19",
"order_commodity_code": ""
}
]
},
"curr_stock": "22.00",
"stock_unit": "斤",
"curr_stock_desc": "22.00斤",
"sorting_occupy_inventory": "0.00",
"available_stock": "22.00",
"budget_batch_no": "",
"index": 0,
"is_purchase_type_pool": 0,
"is_show_order_item": 0
}
]
}
],
"pageParams": {
"page": "1",
"total_page": 420,
"page_size": "1",
"count": 420
},
"sum": {
"in_total_price": "200008815.92",
"purchase_total_price": "14024.40",
"count": 420
}
},
"message": null
}