U8C API中心

API中心

销售管理
销售发票

指导视频
对接方案模板
工具
游客

销售发票保存即审批

接口所在U8C版本:U8 cloud2.7以及更高版本

详细描述:用于销售发票保存即审批

API视频讲解API详情补丁列表常见问题参考

接口地址

请求方式

请求参数header

请求参数body

返回类型参数

代码示例

请求参数示例

正确返回示例

错误返回示例

接口地址:http://ip:port/u8cloud/api/so/saleinvoice/saveapprove

参数填写指南

请求方式:POST

请求参数(header):

参数填写指南

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

请求参数(body):

全量参数普通示例来源销售订单来源库存销售出库单带统计型自定义项带备注型自定义项

参数名	类型	是否数组	必填	描述
billvos		否	是	销售发票实体
childrenvo		是	否	表体
blargessflag	boolean	否	否	是否赠品
cinventoryid	string	否	否	存货
cpackunitid	string	否	否	辅单位
cprojectid	string	否	否	项目
cquoteunitid	string	否	否	报价单位
crowno	string	否	否	行号
cupreceipttype	string	否	否	来源单据类型（参照来源单据做单时必填）
cupsourcebillcode	string	否	否	来源单据号（参照来源单据做单时必填）
ddeliverdate	string	否	否	交货日期
frownote	string	否	否	行备注
nitemdiscountrate	double	否	否	单品折扣
nnumber	double	否	否	数量
noriginalcurmny	double	否	否	无税金额
noriginalcurnetprice	double	否	否	无税净价
noriginalcurprice	double	否	否	无税单价
noriginalcursummny	double	否	否	价税合计
noriginalcurtaxnetprice	double	否	否	含税净价
noriginalcurtaxprice	double	否	否	含税单价
npacknumber	double	否	否	辅数量
ntaxrate	double	否	否	税率
pk_defdoc1	string	否	否	自定义项主键，有20个
vdef1	string	否	否	自定义项值，有20个
vfree1	string	否	否	自由项1，有5个
vsourcerowno	string	否	是	来源单据行号（参照来源单据做单时必填）
parentvo		否	否	表头
cbiztype	string	否	是	业务流
ccalbodyid	string	否	是	库存组织
ccurrencyid	string	否	否	币种
cdeptid	string	否	否	部门
cemployeeid	string	否	否	业务员
coperatorid	string	否	是	制单人
creceiptcorpid	string	否	是	客户
csalecorpid	string	否	是	销售组织
cwarehouseid	string	否	否	仓库
dbilldate	string	否	否	单据日期：如2019-04-18
finvoicetype	int	否	否	发票类型：默认为1。 0增值税专用发票; 1增值税普通发票; 2营业税发票; 3收据; 4其它发票;5增值税电子普通发票
ndiscountrate	int	否	否	整单折扣
pk_corp	string	否	是	公司
pk_defdoc1	string	否	否	自定义项主键有20个，就不全写了。
vdef1	string	否	否	自定义项值有20个，就不全写了
vnote	string	否	否	备注
vreceiptcode	string	否	否	单据号

返回类型参数:

参数名	类型	是否数组	必填	描述	默认值

No Data

代码示例:

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

请求参数示例:

普通示例来源销售订单来源库存销售出库单带统计型自定义项带备注型自定义项

复制代码

{"billvos":[{"parentvo":{"pk_corp":"1000","cbiztype":"so02","coperatorid":"18612329914","creceiptcorpid":"1000","cdeptid":"107","csalecorpid":"1001","ccalbodyid":"1000"},"childrenvo":[{"cinventoryid":"010101","nnumber":"1","noriginalcurprice":"1","cpackunitid":"05","cupsourcebillcode":"SOTH1904180236","cupreceipttype":"30","vsourcerowno":"10"},{"cinventoryid":"010102","nnumber":"1","noriginalcurprice":"1","cpackunitid":"05","cupsourcebillcode":"SOTH1904180236","cupreceipttype":"30","vsourcerowno":"20"}]}]}

正确返回示例:

复制代码

{
 "status": "success",
 "data": "[{\"parentvo\":{\"pk_corp\":\"1001\",\"corp_code\":\"1000\",\"corp_name\":\"天海总公司\",\"cbiztype\":\"1001111000000000001W\",\"biztype_code\":\"so02\",\"biztype_name\":\"普通销售\",\"creceiptcorpid\":\"000111100000000008Z2\",\"customer_code\":\"1000\",\"customer_name\":\"天海总公司\",\"csalecorpid\":\"00011110000000000999\",\"salecorp_code\":\"1001\",\"salecorp_name\":\"天海销售总公司销售组织\",\"ccalbodyid\":\"100111100000000000OQ\",\"calbody_code\":\"1000\",\"calbody_name\":\"天海集团库存组织\",\"coperatorid\":\"00011210000000003FGM\",\"operator_code\":\"18612329914\",\"operator_name\":\"罗建伟\",\"cdeptid\":\"100111100000000000PD\",\"dept_code\":\"107\",\"dept_name\":\"销售部门\",\"vreceiptcode\":\"SITH1904180036\",\"dbilldate\":\"2019-04-18\",\"dmakedate\":\"2019-04-18\",\"dbilltime\":\"2019-04-18 15:01:46\",\"dmoditime\":\"2019-04-18 15:01:46\",\"creceiptcustomerid\":\"000111100000000008Z2\",\"receiptcustomer_code\":\"1000\",\"receiptcustomer_name\":\"天海总公司\",\"ndiscountrate\":100,\"csaleid\":\"1001ZZ1000000000A6IS\"},\"childrenvo\":[{\"cinventoryid\":\"00011110000000000ETJ\",\"inventory_code\":\"010101\",\"inventory_name\":\"米奇宝新生儿配方奶粉900g\",\"invspec\":\"1*6\",\"nnumber\":1,\"noriginalcursummny\":1.17,\"cunitid\":\"000111100000000006JA\",\"unit_code\":\"10\",\"unit_name\":\"罐\",\"csaleid\":\"1001ZZ1000000000A6IS\",\"creceiptcorpid\":\"000111100000000008Z2\",\"ccalbodyid\":\"100111100000000000OQ\",\"advisecalbody_code\":\"1000\",\"advisecalbody_name\":\"天海集团库存组织\",\"cquoteunitid\":\"000111100000000006J4\",\"cquoteunit_code\":\"05\",\"cquoteunit_name\":\"箱\",\"cpackunitid\":\"000111100000000006J4\",\"packunit_code\":\"05\",\"packunit_name\":\"箱\",\"blargessflag\":false,\"noriginalcurprice\":1,\"crowno\":\"10\",\"npacknumber\":0.17,\"ntaxrate\":17,\"noriginalcurtaxprice\":1.17,\"noriginalcurmny\":1,\"noriginalcurtaxmny\":0.17,\"ndiscountrate\":100,\"nitemdiscountrate\":100,\"noriginalcurnetprice\":1,\"noriginalcurtaxnetprice\":1.17,\"noriginalcurdiscountmny\":0,\"ccustomerid\":\"000111100000000008Z2\",\"ddeliverdate\":\"2019-04-18\"},{\"cinventoryid\":\"00011110000000000ETH\",\"inventory_code\":\"010102\",\"inventory_name\":\"米奇宝婴幼儿配方奶粉900g\",\"invspec\":\"1*6\",\"nnumber\":1,\"noriginalcursummny\":1.17,\"cunitid\":\"000111100000000006JA\",\"unit_code\":\"10\",\"unit_name\":\"罐\",\"csaleid\":\"1001ZZ1000000000A6IS\",\"creceiptcorpid\":\"000111100000000008Z2\",\"ccalbodyid\":\"100111100000000000OQ\",\"advisecalbody_code\":\"1000\",\"advisecalbody_name\":\"天海集团库存组织\",\"cquoteunitid\":\"000111100000000006J4\",\"cquoteunit_code\":\"05\",\"cquoteunit_name\":\"箱\",\"cpackunitid\":\"000111100000000006J4\",\"packunit_code\":\"05\",\"packunit_name\":\"箱\",\"blargessflag\":false,\"noriginalcurprice\":1,\"crowno\":\"20\",\"npacknumber\":0.17,\"ntaxrate\":17,\"noriginalcurtaxprice\":1.17,\"noriginalcurmny\":1,\"noriginalcurtaxmny\":0.17,\"ndiscountrate\":100,\"nitemdiscountrate\":100,\"noriginalcurnetprice\":1,\"noriginalcurtaxnetprice\":1.17,\"noriginalcurdiscountmny\":0,\"ccustomerid\":\"000111100000000008Z2\",\"ddeliverdate\":\"2019-04-18\"}]}]"
返回的数据：}

错误返回示例:

复制代码

{
status: "falied",
errorcode: "",
errormsg: "nc.vo.pub.BusinessException: 传入数据有的字段为空！第1条数据：表头：[业务流, 制单人, 客户, 公司]第1行表体：[存货, 数量]"
}