purchasereturn/get
目录 |
1.接口说明
1.1接口描述
获取单张采购退货单
1.2适用版本
支持U8V12.0 及更高版本
2.使用场景
办公用品领用
3.接口调用说明
3.1请求说明
| url | https://api.yonyouup.com/api/purchasereturn/get |
| 格式 | JSON |
| https请求方式 | GET |
| 编码类型 | UTF-8 |
3.2url参数说明
| 参数 | 是否必填 | 类型 | 描述 |
|---|---|---|---|
| from_account | 是 | string | 调用方id |
| to_account | 是 | string | 提供方id |
| app_key | 是 | string | 应用编码 |
| token | 是 | string | 全局访问唯一识别码 |
| ds_sequence | 否 | number | 数据源序号（默认取应用的第一个数据源） |
| id | 否 | string | 采购退货单编号 |
3.3请求示例
GET https://api.yonyouup.com/api/purchasereturn/get?from_account=openapi_dev&to_account=openapi_ent&app_key=opa6fdd4bea98b95ad7&token=843d03f66e6544e19707ccec11030296&id=0000000017&ds_sequence=1
3.4返回参数说明
| 参数说明 | 类型 | 参数路径 | 描述 |
|---|---|---|---|
| errcode | string | 错误码，0 为正常。 | |
| errmsg | string | 错误信息。 | |
| 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 | 运输方式 | |
| ibilltype | int | (0到货单,1退货单,2拒收单) | |
| 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.5正确返回示例
JSON示例:
application/json;charset=UTF-8
{
"errcode":"0",
"errmsg":"",
"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.6错误返回示例
application/json;charset=UTF-8
{
"errcode" : "30021",
"errmsg" : "此应用未上线"
}