saleorderlist/batch_get
目录 |
1.接口说明
1.1接口描述
获取销售订单列表信息
1.2适用版本
支持U8V12.0 及更高版本
2.使用场景
销售应用
3.接口调用说明
3.1请求说明
| url | https://api.yonyouup.com/api/saleorderlist/batch_get |
| 格式 | JSON |
| https请求方式 | GET |
| 编码类型 | UTF-8 |
3.2url参数说明
| 参数 | 是否必填 | 类型 | 描述 |
|---|---|---|---|
| from_account | 是 | string | 调用方id |
| to_account | 是 | string | 提供方id |
| app_key | 是 | string | 应用编码 |
| token | 是 | string | 全局访问唯一识别码 |
| ds_sequence | 否 | number | 数据源序号（默认取应用的第一个数据源） |
| page_index | 否 | string | 页号 |
| rows_per_page | 否 | string | 每页行数 |
| code_begin | 否 | string | 起始订单编号 |
| code_end | 否 | string | 结束订单编号 |
| date_begin | 否 | date | 起始订单日期，格式:yyyy-MM-dd |
| date_end | 否 | date | 结束订单日期，格式:yyyy-MM-dd |
| dpremodatebt_begin | 否 | date | 起始预完工日期，格式:yyyy-MM-dd |
| dpremodatebt_end | 否 | date | 结束预完工日期，格式:yyyy-MM-dd |
| dpredatebt_begin | 否 | date | 起始预发货日期，格式:yyyy-MM-dd |
| dpredatebt_end | 否 | date | 结束预发货日期，格式:yyyy-MM-dd |
| state | 否 | string | 订单状态 |
| custcode | 否 | string | 客户编码，可以通过 api/customer 获取 |
| cusname | 否 | string | 客户名称关键字，可以通过 api/customer 获取 |
| personcode | 否 | string | 业务员编码，可以通过 api/person 获取 |
| personname | 否 | string | 业务员名称关键字，可以通过 api/person 获取 |
| deptcode | 否 | string | 部门编码，可以通过 api/department 获取 |
| deptname | 否 | string | 部门名称关键字，可以通过 api/department 获取 |
| memo | 否 | string | 备注关键字 |
| maker | 否 | string | 制单人 |
| verifier | 否 | string | 审核人 |
| closer | 否 | string | 关闭人 |
| define1 | 否 | string | 自定义项1 |
| define2 | 否 | string | 自定义项2 |
| define3 | 否 | string | 自定义项3 |
| define4_begin | 否 | date | 起始自定义项4 |
| define4_end | 否 | date | 结束自定义项4 |
| define5 | 否 | number | 自定义项5 |
| define6_begin | 否 | date | 起始自定义项6 |
| define6_end | 否 | date | 结束自定义项6 |
| define7 | 否 | number | 自定义项7 |
| define8 | 否 | string | 自定义项8 |
| define9 | 否 | string | 自定义项9 |
| define10 | 否 | string | 自定义项10 |
| define11 | 否 | string | 自定义项11 |
| define12 | 否 | string | 自定义项12 |
| define13 | 否 | string | 自定义项13 |
| define14 | 否 | string | 自定义项14 |
| define15 | 否 | number | 自定义项15 |
| define16 | 否 | number | 自定义项16 |
| timestamp_begin | 否 | number | 起始时间戳 |
| timestamp_end | 否 | number | 结束时间戳 |
| fhstatus | 否 | number | 发货状态(0=未发货;1=部分发货;2=全部发货) |
3.3请求示例
GET https://api.yonyouup.com/api/saleorderlist/batch_get?from_account=openapi_dev&to_account=openapi_ent&app_key=opa6fdd4bea98b95ad7&token=843d03f66e6544e19707ccec11030296&page_index=1&rows_per_page=20&ds_sequence=1
3.4返回参数说明
| 参数说明 | 类型 | 参数路径 | 描述 |
|---|---|---|---|
| errcode | string | 错误码，0 为正常。 | |
| errmsg | string | 错误信息。 | |
| page_index | string | 页号 | |
| rows_per_page | string | 每页行数 | |
| row_count | string | 总行数 | |
| page_count | string | 页数 | |
| code | string | 订单号 | |
| date | date | 日期 | |
| businesstype | string | 业务类型 | |
| typecode | string | 销售类型编码 | |
| typename | string | 销售类型 | |
| state | string | 单据状态 | |
| custcode | string | 客户编码 | |
| cusname | string | 客户名称 | |
| cusabbname | string | 客户简称 | |
| deptcode | string | 部门编码 | |
| deptname | string | 部门名称 | |
| personcode | string | 人员编码 | |
| personname | string | 人员 | |
| dpremodatebt | date | 预完工日期 | |
| dpredatebt | date | 预发货日期 | |
| sendaddress | string | 发货地址 | |
| ccusperson | string | 联系人 | |
| ccuspersoncode | string | 联系人编码 | |
| caddcode | string | 收货地址编码 | |
| memo | string | 备注 | |
| money | number | 无税金额 | |
| sum | number | 价税合计 | |
| maker | string | 制单人 | |
| verifier | string | 审核人 | |
| closer | string | 关闭人 | |
| define1 | string | 自定义项1 | |
| define2 | string | 自定义项2 | |
| define3 | string | 自定义项3 | |
| define4_begin | date | 起始自定义项4 | |
| define4_end | date | 结束自定义项4 | |
| define5 | number | 自定义项5 | |
| define6_begin | date | 起始自定义项6 | |
| define6_end | date | 结束自定义项6 | |
| define7 | number | 自定义项7 | |
| define8 | string | 自定义项8 | |
| define9 | string | 自定义项9 | |
| define10 | string | 自定义项10 | |
| define11 | string | 自定义项11 | |
| define12 | string | 自定义项12 | |
| define13 | string | 自定义项13 | |
| define14 | string | 自定义项14 | |
| define15 | number | 自定义项15 | |
| define16 | number | 自定义项16 | |
| fhstatus | number | 发货状态(0=未发货;1=部分发货;2=全部发货) | |
| timestamp | number | 时间戳 |
3.5正确返回示例
JSON示例:
application/json;charset=UTF-8
{
"page_index":"1",
"rows_per_page":"20",
"row_count":"225",
"errmsg":"",
"errcode":"0",
"page_count":"12",
"saleorderlist":[
{
"typecode":"01",
"memo":null,
"businesstype":"普通销售",
"state":"Opening",
"sum":null,
"dpremodatebt":"2015-10-21",
"code":"0000000242",
"date":"2015-10-21",
"cusabbname":"淘宝",
"dpredatebt":"2015-10-21",
"personcode":null,
"custcode":"0901",
"cusname":"淘宝网",
"deptcode":"0302",
"typename":"普通销售",
"money":"3600.0000",
"personname":null,
"deptname":"销售部",
"maker":"demo",
"verifier":"demo",
"closer":"demo"
},
{
"typecode":"01",
"memo":null,
"businesstype":"普通销售",
"state":"Opening",
"sum":null,
"dpremodatebt":"2015-10-14",
"code":"0000000241",
"date":"2015-10-14",
"cusabbname":"淘宝",
"dpredatebt":"2015-10-14",
"personcode":null,
"custcode":"0901",
"cusname":"淘宝网",
"deptcode":"0302",
"typename":"普通销售",
"money":"3600.0000",
"personname":null,
"deptname":"销售部",
"maker":"demo",
"verifier":"demo",
"closer":"demo"
}
]
}
3.6错误返回示例
application/json;charset=UTF-8
{
"errcode" : "30021",
"errmsg" : "此应用未上线"
}