transvouch/add


目录

[隐藏]

1.接口说明

1.1接口描述

     添加一个新调拨单

1.2适用版本

     支持U8V12.0 及更高版本

2.使用场景

物流应用

3.接口调用说明

3.1请求说明

url https://api.yonyouup.com/api/transvouch/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请求体参数说明

参数 类型 参数路径 是否必填 描述
idepcode string 转入部门编码
idepname string 转入部门名称
odepcode string 转出部门编码
odepname string 转出部门名称
irdcode string 入库类别编码
irdname string 入库类别名称
ordcode string 出库类别编码
ordname string 出库类别名称
iwhcode string 转入仓库编码
iwhname string 转入仓库名称
owhcode string 转出仓库编码
owhname string 转出仓库名称
personcode string 业务员编码
personname string 业务员名称
tvcode string 调拨单据号
date date 单据日期
memory string 备注
auditperson string 审核人
auditdate date 审核日期
maker string 制单人
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
free1 string 自由项1
free2 string 自由项2
free3 string 自由项3
free4 string 自由项4
free5 string 自由项5
free6 string 自由项6
free7 string 自由项7
free8 string 自由项8
free9 string 自由项9
free10 string 自由项10
ordertype string 订单类型
transappcode string 调拨申请单号
csource string 自由项10
barcode string entry 条形码
inventorycode string entry 存货编码
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
quantity number entry 数量
cmassunitname string entry 主计量单位名称
assitantunit string entry 辅计量单位
assitantunitname string entry 辅计量单位名称
irate number entry 换算率
number number entry 件数
actualcost number entry 价格
actualprice number entry 金额
inposcode number entry 调入货位
outposcode number entry 调出货位
define22 string entry 表体自定义项22
define23 string entry 表体自定义项23
define24 string entry 表体自定义项24
define25 string entry 表体自定义项25
define26 number entry 表体自定义项26
define27 number entry 表体自定义项27
define28 string entry 表体自定义项28
define29 string entry 表体自定义项29
define30 string entry 表体自定义项30
define31 string entry 表体自定义项31
define32 string entry 表体自定义项32
define33 string entry 表体自定义项33
define34 number entry 表体自定义项34
define35 number entry 表体自定义项35
define36 date entry 表体自定义项36
define37 date entry 表体自定义项37
irowno number entry 行号
inventoryname string entry 存货名称

3.4请求示例

POST https://api.yonyouup.com/api/transvouch/add?from_account=openapi_dev&to_account=openapi_ent&app_key=opa6fdd4bea98b95ad7&token=843d03f66e6544e19707ccec11030296&biz_id=0971&ds_sequence=1

POST 内容:
{
	"transvouch":{
		"idepcode":"0501",
		"odepcode":"0402",
		"irdcode":"19",
		"ordcode":"2a",
		"iwhcode":"30",
		"owhcode":"02",
		"tvcode":"0000000012",
		"entry":[
			{
				"inventorycode":"010204",
				"quantity":"5",
				"quotedprice":"200",
				"irate":"1",
				"money":"3000",
				"irowno":"1",
				"dpredate":"2015-10-23"
			}
		]
	}
}


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