purchasereceipt/add
目录 |
1.接口说明
1.1接口描述
新增一张采购到货单
1.2适用版本
支持U8V12.0 及更高版本
2.使用场景
订购应用
3.接口调用说明
3.1请求说明
| url | https://api.yonyouup.com/api/purchasereceipt/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 | 否 | 采购类型编码 | |
| vendorcode | string | 是 | 供货单位编号 | |
| departmentcode | string | 否 | 部门编号 | |
| personcode | string | 否 | 业务员编码 | |
| payconditioncode | string | 否 | 付款条件编码 | |
| foreigncurrency | string | 否 | 币种 | |
| foreigncurrencyrate | number | 否 | 汇率 | |
| memory | string | 否 | 备注 | |
| businesstype | string | 否 | 业务类型 | |
| maker | 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 | 否 | 运输方式编码 | |
| cvenpuomprotocol | string | 否 | 收付款协议编码 | |
| warehousecode | string | entry | 否 | 仓库编码 |
| inventorycode | string | entry | 是 | 存货编码 |
| cinva_unit | string | entry | 否 | 采购单位 |
| iinvexchrate | number | entry | 否 | 换算率 |
| serial | string | entry | 否 | 批号 |
| originaltaxedprice | number | entry | 否 | 含税单价 |
| quantity | number | entry | 是 | 数量 |
| number | number | entry | 否 | 件数 |
| taxrate | number | entry | 否 | 税率 |
| originalprice | number | entry | 否 | 原币单价 |
| originaltaxedprice | number | entry | 否 | 原币含税单价 |
| originalmoney | number | entry | 否 | 原币金额 |
| originaltax | number | entry | 否 | 原币税额 |
| originalsum | number | entry | 否 | 原币价税合计 |
| price | number | entry | 否 | 本币单价 |
| money | number | entry | 否 | 本币金额 |
| tax | number | entry | 否 | 本币税额 |
| sum | number | entry | 否 | 本币价税合计 |
| 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 |
| free1 | string | entry | 否 | 自由项1 |
| free2 | string | entry | 否 | 自由项2 |
| 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 |
| ivouchrowno | number | entry | 否 | 行号 |
| cbmemo | string | entry | 否 | 表体备注 |
3.4请求示例
POST https://api.yonyouup.com/api/purchasereceipt/add?from_account=openapi_dev&to_account=openapi_ent&app_key=opa6fdd4bea98b95ad7&token=843d03f66e6544e19707ccec11030296&tradeid=c0f7288e77b811e591c702004c4f4f50
POST 内容:
{
"purchasereceipt":{
"cmodifydate":"",
"cvenpuomprotocolname":"",
"cauditdate":"2014-12-0300:00:00.0",
"ccloser":"",
"csysbarcode":"||pudh|0000000001",
"idiscounttaxtype":"0",
"cverifier":"demo3",
"creviser":"",
"entry":[
{
"iposid":"3",
"originalsum":"1800.0000",
"inventoryclasscode":"12",
"inventoryname":"进口配件",
"originalprice":"9.000000",
"quantity":"200.000000",
"originaltax":"",
"cbcloser":"",
"warehousename":"",
"cinva_unit":"",
"iinvexchrate":"",
"define29":"",
"define27":"",
"number":"0.000000",
"define28":"",
"originaltaxedprice":"9.000000",
"define33":"",
"define32":"",
"define31":"",
"define30":"",
"price":"9.000000",
"define37":"",
"tax":"",
"define36":"",
"define35":"",
"define34":"",
"inventorystd":"",
"originalmoney":"1800.0000",
"free1":"",
"free3":"",
"free2":"",
"free5":"",
"sum":"1800.0000",
"free4":"",
"free7":"",
"free6":"",
"free9":"",
"vouchstate":"0",
"free10":"",
"free8":"",
"closer":"",
"taxrate":"0.000000",
"define24":"",
"define23":"",
"define26":"",
"define25":"",
"unitid":"",
"define22":"",
"money":"1800.0000",
"inventoryaddcode":"",
"inventorycode":"fx01",
"cinvm_unit":"公斤",
"cbsysbarcode":"||IM25|0000000002|1",
"ivouchrowno":"",
"ccomunitcode":"0101",
"cordercode":"",
"cbmemo":"",
"serial":""
},
{
"iposid":"5",
"originalsum":"18000.0000",
"inventoryclasscode":"0107",
"inventoryname":"稳压二极管",
"originalprice":"90.000000",
"quantity":"200.000000",
"originaltax":"",
"cbcloser":"",
"warehousename":"",
"cinva_unit":"",
"iinvexchrate":"",
"define29":"",
"define27":"",
"number":"0.000000",
"define28":"",
"originaltaxedprice":"90.000000",
"define33":"",
"define32":"",
"define31":"",
"define30":"",
"price":"585.000000",
"define37":"",
"tax":"",
"define36":"",
"define35":"",
"define34":"",
"inventorystd":"wenyaerjiguan",
"originalmoney":"18000.0000",
"free1":"",
"free3":"",
"free2":"",
"free5":"",
"sum":"117000.0000",
"free4":"",
"free7":"",
"free6":"",
"free9":"",
"vouchstate":"0",
"free10":"",
"free8":"",
"closer":"",
"taxrate":"0.000000",
"define24":"",
"define23":"",
"define26":"",
"define25":"",
"unitid":"",
"define22":"",
"money":"117000.0000",
"inventoryaddcode":"",
"inventorycode":"0107001",
"cinvm_unit":"PCS",
"cbsysbarcode":"||IM25|0000000003|2",
"ivouchrowno":"",
"ccomunitcode":"0108",
"cordercode":"",
"cbmemo":"",
"serial":""
}
],
"cvenpuomprotocol":""
}
}
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" : "此应用未上线"
}