销售管理类

    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
    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=全部发货)

    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" : "此应用未上线"
    } 

    4.API测试

    API测试 SDK下载