采购管理类

    purchaseorderlist/batch_get


    目录

    1.接口说明

    1.1接口描述

         获取采购订单列表信息

    1.2适用版本

         支持U8V12.0 及更高版本

    2.使用场景

    订购应用

    3.接口调用说明

    3.1请求说明

    url https://api.yonyouup.com/api/purchaseorderlist/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
    state string 订单状态
    vendorcode string 供应商编码,可以通过 api/vendor 获取
    vendorname string 供应商名称关键字,可以通过 api/vendor 获取
    personcode string 业务员编码,可以通过 api/person 获取
    personname string 业务员名称关键字,可以通过 api/person 获取
    deptcode string 部门编码,可以通过 api/department 获取
    deptname string 部门名称关键字,可以通过 api/department 获取
    remark string 备注关键字
    maker string 制单人
    verifier string 审核人
    closer string 关闭人

    3.3请求示例

    GET https://api.yonyouup.com/api/purchaseorderlist/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 订单日期
    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 备注
    currency_name string 外币名称
    currency_rate number 汇率
    maker string 制单人
    verifier string 审核人
    closer string 关闭人
    sum number 原币价税合计

    3.5正确返回示例

    JSON示例:

    application/json;charset=UTF-8
    {
    	"page_index":"1",
    	"rows_per_page":"20",
    	"row_count":"46",
    	"errmsg":"",
    	"errcode":"0",
    	"page_count":"3",
    	"purchaseorderlist":[
    		{
    			"purchase_type_name":"委外采购",
    			"operation_type_code":"普通采购",
    			"vendorname":"苏州光明处理器厂",
    			"remark":null,
    			"vendorabbname":"光明处理",
    			"state":"开立",
    			"sum":null,
    			"code":"0000000055",
    			"date":"2015-11-13",
    			"vendorcode":"01003",
    			"purchase_type_code":"01",
    			"personcode":null,
    			"deptcode":null,
    			"money":null,
    			"personname":null,
    			"deptname":null,
    			"maker":"demo",
    			"verifier":"demo",
    			"closer":"demo"
    		},
    		{
    			"purchase_type_name":"委外采购",
    			"operation_type_code":"普通采购",
    			"vendorname":"苏州光明处理器厂",
    			"remark":null,
    			"vendorabbname":"光明处理",
    			"state":"开立",
    			"sum":null,
    			"code":"0000000054",
    			"date":"2015-11-13",
    			"vendorcode":"01003",
    			"purchase_type_code":"01",
    			"personcode":null,
    			"deptcode":null,
    			"money":null,
    			"personname":null,
    			"deptname":null,
    			"maker":"demo",
    			"verifier":"demo",
    			"closer":"demo"
    		}
    	]
    }
    

    3.6错误返回示例

    application/json;charset=UTF-8
    {
    	"errcode" : "30021",
    	"errmsg" : "此应用未上线"
    } 

    4.API测试

    API测试 SDK下载