API中心

  1. 应收应付
  2. 收款单
返回

收款单新增

接口所在U8C版本:U8 cloud2.7以及更高版本
详细描述:用于收款单新增
API视频讲解API详情补丁列表常见问题参考
接口地址
请求方式
请求参数header
请求参数body
返回类型参数
代码示例
请求参数示例
正确返回示例
错误返回示例
接口地址:http://ip:port/u8cloud/api/arap/sk/insert

参数填写指南

请求方式:POST

请求参数(header):

参数填写指南
参数名必填描述默认值
Content-Type是请求体数据类型application/json
usercode是用户
password是密码
trantype否翻译类型，按编码为code，不需要翻译为pkcode
system是系统参数
uniquekey否幂等唯一key

请求参数(body):

全量参数最简示例收款单新增全属性示例销售收款单新增示例红冲参照销售订单
参数名类型是否数组必填描述默认值示例值
billvo是是单据主表VO
children是是辅表VO
bankrollprojetstring否否计划项目编码（5.1开始支持）
bfyhzhstring否否本方银行帐号
cashitemstring否否现金流量项目
cinventoryidstring否否存货
cksqshstring否否源头单据表体主键参照上游单据时必填
ddhstring否否订单号
ddhhstring否否上层来源单据表体主键参照上游单据时必填
ddlxstring否否上层来源单据表头主键参照上游单据时必填
deptidstring否否部门
dfbbjestring否否贷方本币金额金额是字符串类型的，记得加双引号
dfbbsjstring否否贷方本币税金金额是字符串类型的，记得加双引号
dfbbwsjestring否否贷方本币无税金额金额是字符串类型的，记得加双引号
dfshlstring否否贷方数量
dfybjestring否否贷方原币金额(应付、收款时必填）应收单和付款单的请求参数中【借方原币金额 jfybje】不能是0或者空，应付单和收款单的请求参数中【贷方原币金额 dfybje】不能是0或者空。金额是字符串类型的，记得加双引号
dfybsjstring否否贷方原币税金金额是字符串类型的，记得加双引号
dfybwsjestring否否贷方原币无税金额金额是字符串类型的，记得加双引号;传了单价数量时，无税金额也要传
dfyhzhstring否否对方银行帐号
djstring否否单价金额是字符串类型的，记得加双引号
fb_oidstring否否表体主键(修改必填)
fphstring否否发票号
hbbmstring否否合作伙伴（客商编码）
hsdjstring否否含税单价金额是字符串类型的，记得加双引号
item_bill_pkstring否否事项审批单PK参照上游事项审批单(如：付款申请单)时必传，传对应单据的表头主键
jfbbjestring否否借方本币金额金额是字符串类型的，记得加双引号
jfbbsjstring否否借方本币税金金额是字符串类型的，记得加双引号
jfshlstring否否借方数量
jfybjestring否否借方原币金额（应收、付款时必填，注意传参时加双引号）应收单和付款单的请求参数中【借方原币金额 jfybje】不能是0或者空，应付单和收款单的请求参数中【贷方原币金额 dfybje】不能是0或者空。
jfybsjstring否否借方原币税金金额是字符串类型的，记得加双引号
jfybwsjestring否否借方原币无税金额金额是字符串类型的，记得加双引号
jobidstring否否专项
jsfsbmstring否否上层来源单据类型（应付单类型：D1，应收单类型：D0）参照上游单据时必填
kmbmstring否否科目编码（v5.1开始传科目编码，之前只能传主键）
kslbint否否扣税类别
notetypestring否否票据类型（5.0sp添加）
occupationmnystring否否预占用核销原币余额参照上游单据时必填
ordercusmandocstring否否订单客商
phstring否否源头单据类型参照上游单据时必填
sfkxyhstring否否收付款协议
slstring否否税率
szxmidstring否否收支项目
wbfbbjestring否否借方本币无税金额金额是字符串类型的，记得加双引号
wldxstring否否往来对象标识(0 客户 1供应商 2部门 3业务员 )
xyzhstring否否源头单据表头主键参照上游单据时必填
ywybmstring否否业务员编码（5.0及以上支持）
zystring否否摘要
zyx1string否否自定义项1（档案类型的传pk）
zyx10string否否自定义项10（档案类型的传pk）
zyx11string否否自定义项11（档案类型的传pk）
zyx12string否否自定义项12（档案类型的传pk）
zyx13string否否自定义项13（档案类型的传pk）
zyx14string否否自定义项14（档案类型的传pk）
zyx15string否否自定义项15（档案类型的传pk）
zyx16string否否自定义项16（档案类型的传pk）
zyx17string否否自定义项17（档案类型的传pk）
zyx18string否否自定义项18（档案类型的传pk）
zyx19string否否自定义项19（档案类型的传pk）
zyx2string否否自定义项2（档案类型的传pk）
zyx20string否否自定义项20（档案类型的传pk）
zyx21string否否自定义项21（档案类型的传pk）
zyx22string否否自定义项22（档案类型的传pk）
zyx23string否否自定义项23（档案类型的传pk）
zyx24string否否自定义项24（档案类型的传pk）
zyx25string否否自定义项25（档案类型的传pk）
zyx26string否否自定义项26（档案类型的传pk）
zyx27string否否自定义项27（档案类型的传pk）
zyx28string否否自定义项28（档案类型的传pk）
zyx29string否否自定义项29（档案类型的传pk）
zyx3string否否自定义项3（档案类型的传pk）
zyx30string否否自定义项30（档案类型的传pk）
zyx4string否否自定义项4（档案类型的传pk）
zyx5string否否自定义项5（档案类型的传pk）
zyx6string否否自定义项6（档案类型的传pk）
zyx7string否否自定义项7（档案类型的传pk）
zyx8string否否自定义项8（档案类型的传pk）
zyx9string否否自定义项9（档案类型的传pk）
parentvo否是主表VO
bfyhzhstring否否本方银行帐号（付结单:付款银行账号;收结单:收款银行账号）
bzbmstring否否币种
deinvdatestring否否开票日期
deptidstring否否部门
dfyhzhstring否否对方银行账号（付结单:收款银行账号;收结单:付款银行账号）
djbhstring否否单据号
djlxbmstring否否单据类型编码（交易类型编码使用此字段，如D0、D1、D2）为空时默认值为【2347 其他收款单】，目前只支持自制收款单，不支持上游为应收单的收款单
djrqstring否是单据日期
dwbmstring否是公司
effectdatestring否否起算日期
feinvstatusstring否否开票状态
finvoicetypestring否否发票类型（0 增值税专用发票 1 增值税普通发票 2 营业税发票 3 收据 4 其他发票 5 增值税电子普通发票）
hbbmstring否否客商
isrededstring否否是否红冲
isselectedpaystring否否选择付款(1选择付款 0非选择付款)
kmbmstring否否科目编码（v5.1开始传科目编码，之前只能传主键）
lrrstring否是录入人
lybzstring否否来源标志（0 应收系统 1应付系统 3 销售系统 4 采购系统 5 资金结算 6 网上银行 8 票据管理 9 协同单据 10 信贷系统 11 汇兑损益系统 12 项目管理 13 全面预算 14 签字确认 15 发运管理 16 内部交易 17 外部交换平台 18 资金计息 19 库存管理）
pj_jsfsstring否否结算方式
pj_numstring否否票据号
pk_glorgbookstring否否账簿编码（v5.1开始支持）
prepaystring否否预收付款标志
qcbzstring否否是否期初
scommentstring否否备注
shrstring否否审核人（审批时必填）
shrqstring否否审核日期（审批时必填）
szxmidstring否否收支项目
tradertypestring否否交易对象类型（0 客商 1 部门 2 人员 3 散户）单据类型编码[djlxbm]为[D6]时，交易对象类型[tradertype]不是必填
veinvcodestring否否发票代码
veinvnumberstring否否发票号码
vouchidstring否否表头主键(修改必填)
wldxstring否否往来对象标识(0 客户 1供应商 2部门 3业务员 )
xslxbmstring否否业务流程业务流程编码需要和交易类型成对儿出现，目前只支持单据类型为主收款单的自制单据的业务流程，例如预制的：arap
ywybmstring否否业务员编码当[往来对象标识 wldx]为3时，或者当[交易对象类型 tradertype]为[人员 2]时，该字段必传
zgyfstring否否暂估应付标志0正常 1暂估 2回冲
zyx1string否否自定义项1（档案类型的传pk）
zyx10string否否自定义项10（档案类型的传pk）
zyx11string否否自定义11（档案类型的传pk）
zyx12string否否自定义12（档案类型的传pk）
zyx13string否否自定义13（档案类型的传pk）
zyx14string否否自定义14（档案类型的传pk）
zyx15string否否自定义15（档案类型的传pk）
zyx16string否否自定义16（档案类型的传pk）
zyx17string否否自定义17（档案类型的传pk）
zyx18string否否自定义18（档案类型的传pk）
zyx19string否否自定义19（档案类型的传pk）
zyx2string否否自定义项2（档案类型的传pk）
zyx20string否否自定义20（档案类型的传pk）
zyx21string否否自定义项21（档案类型的传pk）
zyx22string否否自定义项22（档案类型的传pk）
zyx23string否否自定义项23（档案类型的传pk）
zyx24string否否自定义项24（档案类型的传pk）
zyx25string否否自定义项25（档案类型的传pk）
zyx26string否否自定义项26（档案类型的传pk）
zyx27string否否自定义项27（档案类型的传pk）
zyx28string否否自定义项28（档案类型的传pk）
zyx29string否否自定义项29（档案类型的传pk）
zyx3string否否自定义项3（档案类型的传pk）
zyx30string否否自定义项30（档案类型的传pk）
zyx4string否否自定义项4（档案类型的传pk）
zyx5string否否自定义项5（档案类型的传pk）
zyx6string否否自定义项6（档案类型的传pk）
zyx7string否否自定义项7（档案类型的传pk）
zyx8string否否自定义项8（档案类型的传pk）
zyx9string否否自定义项9（档案类型的传pk）

返回类型参数:

参数名类型是否数组必填描述默认值
djzbvo收款单_返回
children是是表体
bbhldouble否否本币汇率
bfyhzhstring否否本方银行帐号主键
bzbmstring否否币种主键
bzbm_codestring否否币种编码
bzbm_namestring否否币种名称
cinventoryidstring否否存货主键
cinventoryid_codestring否否存货编码
cinventoryid_namestring否否存货名称
contractnostring否否采购合同号5.1开始支持
ddhstring否否订单号5.0sp开始支持
def1string否否自定义项名称1
def10string否否自定义项名称10
def11string否否自定义项名称11
def12string否否自定义项名称12
def13string否否自定义项名称13
def14string否否自定义项名称14
def15string否否自定义项名称15
def16string否否自定义项名称16
def17string否否自定义项名称17
def18string否否自定义项名称18
def19string否否自定义项名称19
def2string否否自定义项名称2
def20string否否自定义项名称20
def21string否否自定义项名称21
def22string否否自定义项名称22
def23string否否自定义项名称23
def24string否否自定义项名称24
def25string否否自定义项名称25
def26string否否自定义项名称26
def27string否否自定义项名称27
def28string否否自定义项名称28
def29string否否自定义项名称29
def3string否否自定义项名称3
def30string否否自定义项名称30
def4string否否自定义项名称4
def5string否否自定义项名称5
def6string否否自定义项名称6
def7string否否自定义项名称7
def8string否否自定义项名称8
def9string否否自定义项名称9
deptidstring否否部门主键
deptid_codestring否否部门编码
deptid_namestring否否部门名称
dfbbjedouble否否贷方本币金额
dfbbsjdouble否否贷方本币税金
dfbbwsjedouble否否贷方本币无税金额
dfybjedouble否否贷方原币金额
dfybsjdouble否否贷方原币税金
dfybwsjedouble否否贷方原币无税金额
dfyhzhstring否否对方银行帐号主键
djdouble否否单价
djlxbmstring否否单据类型编码
fb_oidstring否否子表主键
fkyhmcstring否否付款银行帐号名称
fkyhzhstring否否付款银行帐号编码
fphstring否否发票号5.0sp开始支持
hbbmstring否否客商主键
hbbm_codestring否否客商编码
hbbm_namestring否否客商名称
hsdjdouble否否含税单价
jfbbjedouble否否借方本币金额
jfbbsjdouble否否借方本币税金
jfshldouble否否借方数量
jfybjedouble否否借方原币金额
jfybsjdouble否否借方原币税金
jfybwsjedouble否否借方原币无税金额
jobidstring否否专项基本档案id(项目)
kslbstring否否扣税类别
skyhmcstring否否收款银行帐号名称
skyhzhstring否否收款银行帐号编码
sldouble否否税率
szxmidstring否否收支项目主键
szxmid_codestring否否收支项目编码
szxmid_namestring否否收支项目名称
tsstring否否时间戳（V5.1开始支持）
vouchidstring否否主表主键
wbfbbjedouble否否借方本币无税金额
wldxint否否往来对象标识 0：客户；1：供应商；2：部门；3：业务员
ywybmstring否否业务员主键
ywybm_codestring否否业务员编码
ywybm_namestring否否业务员名称
zystring否否摘要
zyx1string否否自定义项1
zyx10string否否自定义项10
zyx11string否否自定义项11
zyx12string否否自定义项12
zyx13string否否自定义项13
zyx14string否否自定义项14
zyx15string否否自定义项15
zyx16string否否自定义项16
zyx17string否否自定义项17
zyx18string否否自定义项18
zyx19string否否自定义项19
zyx2string否否自定义项2
zyx20string否否自定义项20
zyx21string否否自定义项21
zyx22string否否自定义项22
zyx23string否否自定义项23
zyx24string否否自定义项24
zyx25string否否自定义项25
zyx26string否否自定义项26
zyx27string否否自定义项27
zyx28string否否自定义项28
zyx29string否否自定义项29
zyx3string否否自定义项3
zyx30string否否自定义项30
zyx4string否否自定义项4
zyx5string否否自定义项5
zyx6string否否自定义项6
zyx7string否否自定义项7
zyx8string否否自定义项8
zyx9string否否自定义项9
parentvo否是表头
bbjedouble否否本币金额合计
bzbmstring否否币种主键
bzbm_codestring否否币种编码
bzbm_namestring否否币种名称
def1string否否自定义项名称1
def10string否否自定义项名称10
def11string否否自定义项名称11
def12string否否自定义项名称12
def13string否否自定义项名称13
def14string否否自定义项名称14
def15string否否自定义项名称15
def16string否否自定义项名称16
def17string否否自定义项名称17
def18string否否自定义项名称18
def19string否否自定义项名称19
def2string否否自定义项名称2
def20string否否自定义项名称20
def21string否否自定义项名称21
def22string否否自定义项名称22
def23string否否自定义项名称23
def24string否否自定义项名称24
def25string否否自定义项名称25
def26string否否自定义项名称26
def27string否否自定义项名称27
def28string否否自定义项名称28
def29string否否自定义项名称29
def3string否否自定义项名称3
def30string否否自定义项名称30
def4string否否自定义项名称4
def5string否否自定义项名称5
def6string否否自定义项名称6
def7string否否自定义项名称7
def8string否否自定义项名称8
def9string否否自定义项名称9
deptidstring否否部门主键
deptid_codestring否否部门编码
deptid_namestring否否部门名称
dfyhzhstring否否付款银行帐号
djbhstring否否单据编号
djdlstring否否单据大类
djkjndstring否否会计年度
djkjqjstring否否会计期间
djrqstring否否单据日期
djztstring否否单据状态
dwbmstring否否公司主键
dwbm_codestring否否公司编码
dwbm_namestring否否公司名称
dzrqstring否否对帐日期
enduserstring否否最终修改人（5.1开始支持）
hbbmstring否否客商主键
hbbm_codestring否否客商编码
hbbm_namestring否否客商名称
lrrstring否否录入人主键
lrr_codestring否否录入人编码
lrr_namestring否否录入人名称
paydatestring否否支付日期（5.1及以后版本支持）
prepaystring否否预收付标志
qcbzstring否否是否期初
qrrstring否否确认人主键
qrr_codestring否否确认人编码
qrr_namestring否否确认人名称
scommentstring否否备注
shrstring否否审核人主键
shr_codestring否否审核人编码
shr_namestring否否审核人名称
shrqstring否否审核日期
spztstring否否审批状态
szxmidstring否否收支项目主键
szxmid_codestring否否收支项目编码
szxmid_namestring否否收支项目名称
tsstring否否时间戳（V5.1开始支持）
vouchidstring否否主表主键
wldxstring否否往来对象标识
xslxbmstring否否业务流程主键
xslxbm_codestring否否业务流程编码
xslxbm_namestring否否业务流程名称
ybjedouble否否原币金额合计
ywbmstring否否交易类型主键
ywbm_codestring否否交易类型编码
ywbm_namestring否否交易类型名称
ywybmstring否否业务员主键
ywybm_codestring否否业务员编码
ywybm_namestring否否业务员名称
zdrstring否否制单人主键
zdr_codestring否否制单人编码
zdr_namestring否否制单人名称
zdrqstring否否制单日期
zyx1string否否自定义项1
zyx10string否否自定义项10
zyx11string否否自定义项11
zyx12string否否自定义项12
zyx13string否否自定义项13
zyx14string否否自定义项14
zyx15string否否自定义项15
zyx16string否否自定义项16
zyx17string否否自定义项17
zyx18string否否自定义项18
zyx19string否否自定义项19
zyx2string否否自定义项2
zyx20string否否自定义项20
zyx21string否否自定义项21
zyx22string否否自定义项22
zyx23string否否自定义项23
zyx24string否否自定义项24
zyx25string否否自定义项25
zyx26string否否自定义项26
zyx27string否否自定义项27
zyx28string否否自定义项28
zyx29string否否自定义项29
zyx3string否否自定义项3
zyx30string否否自定义项30
zyx4string否否自定义项4
zyx5string否否自定义项5
zyx6string否否自定义项6
zyx7string否否自定义项7
zyx8string否否自定义项8
zyx9string否否自定义项9
zzztstring否否支付状态

代码示例:

Java模板示例下载C#模板示例下载

请求参数示例:

最简示例收款单新增全属性示例销售收款单新增示例红冲参照销售订单

复制代码

{"billvo":[{"children":[{"dfybje":"1"}],"parentvo":{"djrq":"2020-09-03","dwbm":"1000","hbbm":"C1014","lrr":"13837384590"}}]}

正确返回示例:

复制代码

{
    "status": "success",
    "data": "[{\"parentvo\":{\"vouchid\":\"0001131000000002T1K3\",\"dwbm\":\"1001\",\"dwbm_code\":\"1000\",\"dwbm_name\":\"天海总公司\",\"djbh\":\"SKTH2009030003\",\"djrq\":\"2018-04-09\",\"wldx\":\"0\",\"hbbm\":\"000111100000000006JK\",\"hbbm_code\":\"C1014\",\"hbbm_name\":\"测试25\",\"bzbm\":\"00010000000000000001\",\"bzbm_code\":\"CNY\",\"bzbm_name\":\"人民币\",\"qcbz\":false,\"lrr\":\"0001131000000002KQ3L\",\"lrr_code\":\"13837384590\",\"lrr_name\":\"刘天威\",\"djzt\":\"1\",\"zdrq\":\"2020-09-03\",\"ybje\":1,\"bbje\":1,\"djkjnd\":\"2018\",\"djkjqj\":\"04\",\"djdl\":\"sk\",\"zzzt\":\"0\",\"ywbm\":\"0001111000000000094F\",\"ywbm_code\":\"2347\",\"ywbm_name\":\"其他收款单\",\"xslxbm\":\"00011110000000002RGT\",\"xslxbm_code\":\"arap\",\"xslxbm_name\":\"收付通用流程\",\"djlxbm\":\"2347\"},\"childrenvo\":[{\"fb_oid\":\"0001131000000002T1K4\",\"vouchid\":\"0001131000000002T1K3\",\"sl\":0,\"dfybje\":1,\"dfbbje\":1,\"bbhl\":1,\"dfybsj\":0,\"dfbbsj\":0,\"jfybwsje\":0,\"dfbbwsje\":1,\"dj\":0,\"hsdj\":0,\"jfshl\":0,\"kslb\":\"1\",\"hbbm\":\"000111100000000006JK\",\"hbbm_code\":\"C1014\",\"hbbm_name\":\"测试25\",\"djlxbm\":\"2347\",\"wldx\":\"0\",\"bzbm\":\"00010000000000000001\",\"bzbm_code\":\"CNY\",\"bzbm_name\":\"人民币\",\"dfshl\":0}]}]",
    "taskNumber": "202009030011"
}

错误返回示例:

复制代码

{"status":"falied","errorcode":"-32000","errormsg":"下面的档案无法翻译：档案类型：外币档案,档案编码：CN,可能的原因是当前单据使用的公司没有启用单据所在的模块或者档案没有分配到当前使用的公司！"}