purchaseorderlist2/batch_get
目录 |
1.接口说明
1.1接口描述
批量获取采购订单（以存货为单位）
1.2适用版本
支持U8V12.0 及更高版本
2.使用场景
获取采购订单列表，需要根据订单执行情况进行筛选。
3.接口调用说明
3.1请求说明
| url | https://api.yonyouup.com/api/purchaseorderlist2/batch_get |
| 格式 | JSON |
| https请求方式 | GET |
3.2url参数说明
| 参数 | 是否必填 | 类型 | 描述 |
|---|---|---|---|
| from_account | 是 | sting | 调用方id |
| to_account | 是 | string | 提供方id |
| app_key | 是 | string | 应用编码 |
| token | 是 | string | 全局访问唯一识别码 |
| ds_sequence | 否 | number | 数据源序号（默认取应用的第一个数据源） |
| code_begin | 否 | string | 起始订单编号 |
| code_end | 否 | string | 结束订单编号 |
| date_begin | 否 | string | 起始订单日期，格式:yyyy-MM-dd |
| date_end | 否 | string | 结束订单日期，格式:yyyy-MM-dd |
| state | 否 | string | 订单状态 |
| vendorcode | 否 | string | 供应商编码 |
| vendorname | 否 | string | 供应商名称关键字 |
| deptcode | 否 | string | 部门编码 |
| deptname | 否 | string | 部门名称关键字 |
| personcode | 否 | string | 业务员编码 |
| personname | 否 | string | 业务员关键字 |
| remark | 否 | string | 备注关键字 |
| maker | 否 | string | 制单人 |
| verifier | 否 | string | 审核人 |
| closer | 否 | string | 关闭人 |
| inventorycode | 否 | string | 存货编码 |
| inventoryname | 否 | string | 存货名称关键字 |
| arrivestate | 否 | string | 到货状态 |
| receivestate | 否 | string | 入库状态 |
| billstate | 否 | string | 开票状态 |
| paystate | 否 | string | 付款状态 |
3.3请求示例
GET https://api.yonyouup.com/api/purchaseorderlist2/batch_get?from_account=openapi_dev&to_account=openapi_ent&app_key=opa6fdd4bea98b95ad7&token=26d2fc4a06844448957a7f8260f3d08b&code_begin=xxxxx&code_end=xxxxx&date_begin=xxxxx& date_end=xxxxx& state =xxxxx&vendorcode=xxxxx&vendorname=xxxxx&deptcode=xxxxx&deptname=xxxxx&personcode=xxxxx&personname=xxxxx&remark=xxxxx&maker=xxxxx&verifier=xxxxx&closer=xxxxx&inventorycode=xxxxx&inventoryname=xxxxx&arrivestate=xxxxx&receivestate=xxxxx&billstate=xxxxx&paystate=xxxxx
3.4返回参数说明
| 参数说明 | 类型 | 参数路径 | 描述 |
|---|---|---|---|
| errcode | string | 错误码，0 为正常。 | |
| errmsg | string | 错误信息。 | |
| code | string | 订单编号 | |
| date | string | 订单日期 | |
| operation_type_code | string | 采购业务类型 | |
| state | string | 订单状态 | |
| purchase_type_code | string | 采购类型编码 | |
| purchase_type_name | string | 采购类型 | |
| vendorcode | string | 供应商编码 | |
| vendorname | string | 供应商名称 | |
| vendorabbname | string | 供应商简称 | |
| deptcode | string | 部门编码 | |
| deptname | string | 部门名称 | |
| personcode | string | 业务员编码 | |
| personname | string | 业务员 | |
| remark | string | 备注 | |
| maker | string | 制单人 | |
| verifier | string | 审核人 | |
| closer | string | 关闭人 | |
| currency_name | string | 外币名称 | |
| currency_rate | number | 汇率 | |
| inventorycode | string | 存货编码 | |
| inventoryname | string | 存货名称 | |
| arrivestate | string | 到货状态 | |
| receivestate | string | 入库状态 | |
| billstate | string | 开票状态 | |
| paystate | string | 付款状态 |
3.5正确返回示例
JSON示例:
application/json;charset=UTF-8
{
"page_index":"1",
"rows_per_page":"20",
"purchaseorderlist2":[
{
"arrivestate":"到货完成",
"receivestate":"入库完成",
"operation_type_code":"普通采购",
"vendorname":"深圳辰环手机配件有限公司",
"remark":"",
"currency_rate":"1.0",
"verifier":"demo9",
"closer":"asuser",
"purchase_type_code":"",
"inventoryname":"手机主板",
"deptcode":"0401",
"date":"2014-12-01",
"deptname":"采购部",
"inventorycode":"SJZB01",
"state":"关闭",
"billstate":"开票完成",
"purchase_type_name":"",
"paystate":"付款完成",
"vendorabbname":"辰环手机配件",
"maker":"demo9",
"code":"0000000001",
"vendorcode":"01002",
"currency_name":"人民币",
"personcode":"00043",
"personname":"顾潇"
},
{
"arrivestate":"到货完成",
"receivestate":"入库完成",
"operation_type_code":"普通采购",
"vendorname":"深圳辰环手机配件有限公司",
"remark":"",
"currency_rate":"1.0",
"verifier":"demo9",
"closer":"asuser",
"purchase_type_code":"",
"inventoryname":"手机电池",
"deptcode":"0401",
"date":"2014-12-01",
"deptname":"采购部",
"inventorycode":"SJDC01",
"state":"关闭",
"billstate":"开票完成",
"purchase_type_name":"",
"paystate":"付款完成",
"vendorabbname":"辰环手机配件",
"maker":"demo9",
"code":"0000000001",
"vendorcode":"01002",
"currency_name":"人民币",
"personcode":"00043",
"personname":"顾潇"
}
],
"row_count":"225",
"errmsg":"",
"page_count":"12",
"errcode":"0"
}
3.6错误返回示例
application/json;charset=UTF-8
{
"errcode":"30021",
"errmsg":"此应用未上线"
}