采购管理类

    purchasereturn/add


    目录

    1.接口说明

    1.1接口描述

         新增一张采购退货单

    1.2适用版本

         支持U8V12.0 及更高版本

    2.使用场景

    办公用品领用

    3.接口调用说明

    3.1请求说明

    url https://api.yonyouup.com/api/purchasereturn/add
    格式 JSON
    https请求方式 POST
    编码类型 UTF-8


    3.2url参数说明

    参数 类型 是否必填 描述
    from_account string 调用方id
    to_account string 提供方id
    app_key string 应用编码
    token string api调用唯一识别码
    tradeid string 交易唯一识别码,tradeid与biz_id只能传入一个
    ds_sequence number 数据源序号(默认取应用的第一个数据源)
    biz_id string 上游id,需要保证biz_id与ERP主键唯一对应关系,tradeid与biz_id只能传入一个
    sync number 0=异步新增(默认);1=同步新增;


    3.3请求体参数说明

    参数 类型 参数路径 是否必填 描述
    code string 单据号
    purchasetypecode string 采购类型编码
    purchasetypename string 采购类型
    vendorcode string 供货单位编号
    vendorabbname string 供应商
    vendorname string 供应商全称
    departmentcode string 部门编号
    departmentname string 部门
    personcode string 业务员编码
    personname string 业务员
    payconditioncode string 付款条件编码
    payconditionname string 付款条件
    foreigncurrency string 币种
    cexch_code string 币种编码
    foreigncurrencyrate number 汇率
    memory string 备注
    businesstype string 业务类型
    maker string 制单人
    ccloser string 关闭人
    idiscounttaxtype number 扣税类别
    define1 string 表头自定义项1
    define2 string 表头自定义项2
    define3 string 表头自定义项3
    define4 date 表头自定义项4
    define5 number 表头自定义项5
    define6 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
    shipcode string 运输方式编码
    shipname string 运输方式
    billtype int (0到货单,1退货单)
    cvouchtype string 单据类型
    cmodifydate date 修改日期
    creviser string 修改人
    cauditdate date 审核日期
    cverifier string 审核人
    cvenpuomprotocol string 收付款协议编码
    cvenpuomprotocolname string 收付款协议名称
    csysbarcode string 单据条码
    warehousecode string entry 仓库编码
    warehousename string entry 仓库名称
    inventorycode string entry 存货编码
    inventoryaddcode string entry 存货代码
    inventoryname string entry 存货名称
    inventorystd string entry 规格型号
    inventoryclasscode string entry 存货分类编码
    unitid string entry 单位编码
    ccomunitcode string entry 单位编码
    cinvm_unit string entry 主计量
    cinva_unit string entry 采购单位
    iinvexchrate number entry 换算率
    serial string entry 批号
    closer string entry 关闭人
    originaltaxedprice number entry 含税单价
    quantity number entry 主计量数量
    number number entry 件数
    originalprice number entry 原币单价
    originalmoney number entry 原币金额
    originaltax number entry 原币税额
    originalsum number entry 原币价税合计
    price number entry 本币单价
    money number entry 本币金额
    tax number entry 本币税额
    sum number entry 本币价税合计
    cbcloser string entry 行关闭人
    free1 string entry 自由项1
    free2 string entry 自由项2
    define22 string entry 表体自定义项1
    define23 string entry 表体自定义项2
    define24 string entry 表体自定义项3
    define25 string entry 表体自定义项4
    define26 number entry 表体自定义项5
    define27 number entry 表体自定义项6
    define28 string entry 表体自定义项7
    define29 string entry 表体自定义项8
    define30 string entry 表体自定义项9
    define31 string entry 表体自定义项10
    define32 string entry 表体自定义项11
    define33 string entry 表体自定义项12
    define34 number entry 表体自定义项13
    define35 number entry 表体自定义项14
    define36 date entry 表体自定义项15
    define37 date entry 表体自定义项16
    taxrate number entry 税率
    iposid number entry 订单子表ID
    free3 string entry 自由项3
    free4 string entry 自由项4
    free5 string entry 自由项5
    free6 string entry 自由项6
    free7 string entry 自由项7
    free8 string entry 自由项8
    free9 string entry 自由项9
    free10 string entry 自由项10
    taxrate int entry 税率
    iposid string entry 订单子表ID
    cordercode string entry 订单号
    vouchstate number entry 单据状态
    ivouchrowno number entry 行号
    cbmemo string entry 表体备注
    cbsysbarcode string entry 行条码

    3.4请求示例

    POST https://api.yonyouup.com/api/purchasereturn/add?from_account=openapi_dev&to_account=openapi_ent&app_key=opa6fdd4bea98b95ad7&token=843d03f66e6544e19707ccec11030296&biz_id=0971&ds_sequence=1
    
    POST 内容:
    {
    	"purchasereturn":{
    		"businesstype":"普通采购",
    		"cauditdate":"2014-12-0400:00:00.0",
    		"cmodifydate":"2014-12-0400:00:00.0",
    		"code":"0000000014",
    		"creviser":"demo3",
    		"csysbarcode":"||pudh|0000000014",
    		"cverifier":"demo3",
    		"date":"2014-12-0400:00:00.0",
    		"define1":"傅奇",
    		"departmentcode":"0401",
    		"departmentname":"采购部",
    		"entry":[
    			{
    				"cbcloser":"",
    				"cbsysbarcode":"||pudh|0000000014|1",
    				"ccomunitcode":"0108",
    				"cinvm_unit":"PCS",
    				"cordercode":"0000000026",
    				"inventoryclasscode":"0101",
    				"inventorycode":"01019002082",
    				"inventoryname":"包装材料",
    				"inventorystd":"中性鼠标线盒/215*170*45",
    				"iposid":"1000000053",
    				"ivouchrowno":"1",
    				"money":"341.8800",
    				"originalmoney":"341.8800",
    				"originalprice":"3.420000",
    				"originalsum":"400.0000",
    				"originaltax":"58.1200",
    				"originaltaxedprice":"4.000000",
    				"price":"3.420000",
    				"quantity":"100.000000",
    				"sum":"400.0000",
    				"tax":"58.1200",
    				"taxrate":"17.000000",
    				"vouchstate":"0",
    				"warehousecode":"30",
    				"warehousename":"PC原材料仓"
    			},
    			{
    				"cbcloser":"",
    				"cbsysbarcode":"||pudh|0000000014|2",
    				"ccomunitcode":"0108",
    				"cinvm_unit":"PCS",
    				"cordercode":"0000000026",
    				"inventoryclasscode":"0101",
    				"inventorycode":"01019002082",
    				"inventoryname":"包装材料",
    				"inventorystd":"中性鼠标线盒/215*170*45",
    				"iposid":"1000000054",
    				"ivouchrowno":"2",
    				"money":"256.4100",
    				"originalmoney":"256.4100",
    				"originalprice":"12.820000",
    				"originalsum":"300.0000",
    				"originaltax":"43.5900",
    				"originaltaxedprice":"15.000000",
    				"price":"12.820000",
    				"quantity":"20.000000",
    				"sum":"300.0000",
    				"tax":"43.5900",
    				"taxrate":"17.000000",
    				"vouchstate":"0",
    				"warehousecode":"30",
    				"warehousename":"PC原材料仓"
    			}
    		],
    		"foreigncurrency":"人民币",
    		"idiscounttaxtype":"0",
    		"maker":"demo3",
    		"personcode":"00044",
    		"personname":"傅奇",
    		"purchasetypecode":"03",
    		"purchasetypename":"普通采购",
    		"vendorabbname":"威盛电子",
    		"vendorcode":"03003",
    		"vendorname":"威盛电子股份有限公司"
    	}
    }
    


    3.5返回参数说明

    参数说明 类型 描述
    errcode string 错误码,0 为正常。
    errmsg string 错误信息。
    id string 新增成功后返回新单据编号。
    tradeid string 新增成功后返回交易唯一识别码

    3.6正确返回示例

    JSON示例:

    {
        "tradeid": "158f3f05730711e591c702004c4f4f50",
        "ping_after": "3",
        "url": "https://api.yonyouup.com/result?requestid=158f3f05730711e591c702004c4f4f50"
    }
    上述 api 请求返回信息表示建议客户端 3 秒钟后向 https://api.yonyouup.com/result?requestid=158f3f05730711e591c702004c4f4f50 发送 GET 请求获取真正的 api 调用结果,结果格式如下:
    {
      "errcode" : "0", 
      "errmsg" : "", 
      "id" : "883",
      "tradeid" : "158f3f05730711e591c702004c4f4f50"
    }  
    

    3.7错误返回示例

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

    4.API测试

    API测试 SDK下载