采购管理类

    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下载