吉客云·奇门旺店通查询采购单V3.0API接口文档
旺店通查询采购单V3.0
接口地址:purchase_order_query
请求方法: POST
加工厂: {"operation":{"method":"none"}}
接口请求参数
序号 | 字段 | 名称 | 类型 | 默认值 | 描述 | 是否必要 |
---|---|---|---|---|---|---|
1 | start_time | 开始时间 | string | {{LAST_SYNC_TIME|datetime}} | 开始时间 | 是 |
2 | outer_no | 外部单号 | string | 外部创建采购单推送的单号,传该字段可以不传开始时间和结束时间 | 否 | |
3 | purchase_no | 采购单号 | string | ERP系统采购单编号,传该字段可以不传开始时间和结束时间 | 否 | |
4 | status | 采购单状态 | string | 10 已取消,20 编辑中,30 待审核,35 待财审,40 已审核,43 待推送,45 推送失败,48 待收货,50 部分到货,60已到货,70 待结算,80 部分结算,90 已完成(不传默认查询全部状态采购单) | 否 | |
5 | warehouse_no | 仓库编码 | string | 仓库编码 | 否 | |
6 | purchase_no | 采购单号 | string | ERP系统采购单编号,传该字段可以不传开始时间和结束时间 | 否 | |
7 | end_time | 结束时间 | string | {{CURRENT_TIME|datetime}} | 结束时间 | 是 |
接口响应参数
序号 | 字段 | 名称 | 类型 | 默认值 | 描述 | 是否必要 |
---|---|---|---|---|---|---|
1 | purchase_id | 采购单id | string | 采购单id,采购单表主键 | 否 | |
2 | purchase_no | 采购单号 | string | ERP系统采购单编号 | 否 | |
3 | purchase_outer_no | 外部单号 | string | ERP推送采购单外部返回单号(对应外部仓储单号)。 | 否 | |
4 | outer_no | api单号 | string | 通过接口创建采购单时传的api单号 | 否 | |
5 | warehouse_name | 仓库 | string | 仓库名称 | 否 | |
6 | warehouse_no | 仓库编号 | string | 代表仓库所有属性的唯一编码,用于仓库区分,ERP内支持自定义(ERP仓库界面设置) | 否 | |
7 | status | 采购单状态 | string | 采购单状态:10已取消,20编辑中,30待审核,35待财审,40已审核,43待推送,45推送失败,48待收货,50部分到货,60已到货,70待结算,80部分结算,90已完成 | 否 | |
8 | provider_no | 供应商编号 | string | 供应商编号 | 否 | |
9 | provider_name | 供应商名称 | string | 供应商名称 | 否 | |
10 | contact | 联系人 | string | 联系人 | 否 | |
11 | telno | 电话 | string | 电话 | 否 | |
12 | purchaser_name | 采购员 | string | 采购员 | 否 | |
13 | receive_address | 收货地址 | string | 收货地址 | 否 | |
14 | logistics_type | 货运方式 | string | 货运方式 | 否 | |
15 | check_time | 审核时间 | string | 审核时间,格式:yyyy-MM-dd HH:mm:ss | 否 | |
16 | goods_amount | 货款 | string | 货款 | 否 | |
17 | post_fee | 邮资 | string | 邮资 | 否 | |
18 | other_fee | 其他费用 | string | 其他费用 | 否 | |
19 | tax_goods_amount | 税后货品总金额 | string | 税后货品总金额 | 否 | |
20 | remark | 备注 | string | 采购单备注 | 否 | |
21 | modified | 最后修改时间 | string | 单据的最后修改时间,格式:yyyy-MM-dd HH:mm:ss | 否 | |
22 | expect_arrive_time | 预计到货时间 | string | 采购预计到货时间,格式:yyyy-MM-dd HH:mm:ss | 否 | |
23 | prop1 | 自定义属性1 | string | 自定义属性1 | 否 | |
24 | prop2 | 自定义属性2 | string | 自定义属性2 | 否 | |
25 | created | 创建时间 | string | 单据创建时间,格式:yyyy-MM-dd HH:mm:ss | 否 | |
26 | creator_id | 创建人id | string | 默认为'0',创建人id | 否 | |
27 | creator_name | 创建人姓名 | string | 默认为'0',创建人姓名 | 否 | |
28 | warehouse_id | 仓库id | string | 仓库id | 否 | |
29 | api_outer_no | api外部单号 | string | 默认为'',接口创建的单据的外部单号,同outer_no | 否 | |
30 | wms_outer_no | 外部仓库单号 | string | 默认为'',对应外部仓库的单号,同purchase_outer_no字段 | 否 | |
31 | wms_status | 外部状态 | string | 默认为'0',外部状态,与wms对接使用0初始化1失败2成功 | 否 | |
32 | error_info | 错误信息 | string | 默认为'',返回错误信息 | 否 | |
33 | purchaser_id | 采购员id | string | 默认为'0',采购员id | 否 | |
34 | order_type | 采购单类型 | string | 默认为'0',0普通采购单,1档口采购单,2APP档口采购单 | 否 | |
35 | flag_id | 颜色标记 | string | 默认为'0',颜色标记 | 否 | |
36 | provider_id | 供应商 | string | 默认为'0',供应商 | 否 | |
37 | check_operator_id | 审核人 | string | 默认为'0',审核人 | 否 | |
38 | facheck_operator_id | 财审人 | string | 默认为'0',财审人 | 否 | |
39 | facheck_time | 财审人 | string | 默认为'0000-00-00',财审时间 | 否 | |
40 | goods_fee | 货品总价 | string | 默认为'0.0000',货品总价 | 否 | |
41 | goods_count | 货品数量 | string | 默认为'0.0000',货品数量 | 否 | |
42 | tax_fee | 税后总价 | string | 默认为'0',税后总价 | 否 | |
43 | goods_type_count | 货品种类 | string | 默认为'0',货品种类 | 否 | |
44 | goods_arrive_count | 到货总量 | string | 默认为'0.0000',到货总量 | 否 | |
45 | revert_reason | 驳回原因 | string | 默认为'0',驳回原因 | 否 | |
46 | version_id | 版本号 | string | 默认为'0',版本号 | 否 | |
47 | note_count | 便签条数 | string | 默认为'0',便签条数 | 否 | |
48 | prop_time1 | 自定义属性时间1 | string | 默认为'0000-00-0000:00:00',自定义属性时间1 | 否 | |
49 | details_list | 采购单明细节点 | array | 响应参数的2级数据节点,,节点下数据字段详见下述“details_list” | 否 | |
49.1 | rec_id | 主键 | string | 采购明细表主键id | 否 | |
49.2 | purchase_id | 采购单id | string | 采购单id | 否 | |
49.3 | spec_no | 商家编码 | string | 代表单品(sku)所有属性的编码,SKU概念介绍,单击这里 | 否 | |
49.4 | brand_name | 品牌 | string | 品牌名称,推送此字段前需将版本升级至V2.3.9.1及以上的稳定版本 | 否 | |
49.5 | num | 数量 | string | 数量 | 否 | |
49.6 | price | 税前单价 | string | 税前单价 | 否 | |
49.7 | discount | 折扣 | string | 折扣 | 否 | |
49.8 | tax | 税率 | string | 税率 | 否 | |
49.9 | tax_price | 税后单价 | string | 税后单价 | 否 | |
49.10 | tax_amount | 税后金额 | string | 税后金额 | 否 | |
49.11 | amount | 税前金额 | string | 税前金额 | 否 | |
49.12 | stockin_amount | 采购到货入库总金额 | string | 采购到货入库总金额 | 否 | |
49.13 | stockin_num | 采购到货入库数量 | string | 采购到货入库数量 | 否 | |
49.14 | prop1 | 自定义属性1 | string | 自定义属性1 | 否 | |
49.15 | prop2 | 自定义属性2 | string | 自定义属性2 | 否 | |
49.16 | remark | 备注 | string | 明细备注 | 否 | |
49.17 | modified | 修改时间 | string | 修改时间,格式:yyyy-MM-dd HH:mm:ss | 否 | |
49.18 | provider_goods_no | 供应商货品编号 | string | 供应商货品编号 | 否 | |
49.19 | goods_no | 货品编号 | string | 货品编号 | 否 | |
49.20 | goods_name | 货品名称 | string | 货品名称 | 否 | |
49.21 | short_name | 货品简称 | string | 货品简称 | 否 | |
49.22 | spec_name | 规格名称 | string | 规格名称 | 否 | |
49.23 | spec_code | 规格码 | string | 规格码 | 否 | |
49.24 | base_unit | 基本单位 | string | 基本单位 | 否 | |
49.25 | purchase_unit | 采购单位 | string | 采购单位 | 否 | |
49.26 | arrive_num | 采购到货未入库数量 | string | 采购到货未入库数量 | 否 | |
49.27 | stopwait_num | 停止等待数量 | string | 停止等待数量 | 否 | |
49.28 | purchase_price | 采购价 | string | 采购价 | 否 | |
49.29 | last_price | 最后采购价 | string | 最后采购价 | 否 | |
49.30 | last_second_price | 上一次采购价 | string | 上一次采购价 | 否 | |
49.31 | lowest_price | 最低采购价 | string | 最低采购价 | 否 | |
49.32 | weight | 重量 | string | 重量 | 否 | |
49.33 | arrive_more_num | 多到货量 | string | 多到货量 | 否 | |
49.34 | lack_num | 未到货量 | string | 未到货量 | 否 | |
49.35 | spec_id | 规格id | string | 规格id | 否 | |
49.36 | warehouse_id | 仓库id | string | 默认为'0',仓库id | 否 | |
49.37 | tag | 标签 | string | 默认为'0', tag=0表示默认采购 | 否 | |
49.38 | num2 | 数量2 | string | 默认为'0.0000',辅助单位数量 | 否 | |
49.39 | unit_ratio | 单位比率 | string | 默认为'1.0000',基本单位和辅助单位的换算系数 | 否 | |
49.40 | unit_id | 辅助单位 | string | 辅助单位/采购单位 | 否 | |
49.41 | base_unit_id | 基本单位 | string | 基本单位 | 否 | |
49.42 | created | 创建时间 | string | 单据创建时间,格式:yyyy-MM-dd HH:mm:ss | 否 |
吉客云·奇门的接口:旺店通查询采购单V3.0(purchase_order_query),由轻易云数据集成平台API资产管理模块整理收纳,并且根据吉客云·奇门版本更新同步实时更新。API资产管理平台提供了丰富的API开发和测试工具,支持API的快速迭代和创新,加速产品的上市速度,提升企业的市场竞争力。