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