采购管理类

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

    4.API测试

    API测试 SDK下载