API中心

  1. 采购管理
  2. 采购发票
返回

采购发票保存即审批

接口所在U8C版本:U8 cloud3.1以及更高版本
详细描述:用于采购发票保存即审批
API视频讲解API详情补丁列表常见问题参考
接口地址
请求方式
请求参数header
请求参数body
返回类型参数
代码示例
请求参数示例
正确返回示例
错误返回示例
接口地址:http://ip:port/u8cloud/api/pu/invoice/saveapprove

参数填写指南

请求方式:POST

请求参数(header):

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

请求参数(body):

全量参数最简示例来源采购订单上层来源采购入库示例来源库存委外加工入库单来源库存期初采购统计类型自定义项带备注型自定义项
参数名类型是否数组必填描述默认值示例值
invoicevo否是采购发票信息
childrenvo是是采购发票表体vo
cassistunitstring否否辅单位ID
cbaseidstring否否存货基础ID
ccostsubjidstring否否收支项目ID
ccurrencytypeidstring否否原币币种ID
cinvoice_bidstring否否发票行ID主键
cinvoiceidstring否否发票ID外键
cmangidstring否否存货管理ID
corder_bidstring否否采购订单行ID
corderidstring否否采购订单ID
cprojectidstring否否项目ID
cprojectphaseidstring否否项目阶段ID
crownostring否否行号
csourcebillidstring否否来源单据ID
csourcebillrowidstring否否来源单据行ID
csourcebilltypestring否否来源单据类型
cupsourcebillidstring否否上层来源单据ID
cupsourcebillrowidstring否否上层来源单据行ID
cupsourcebilltypestring否否上层单据类型
cusedeptidstring否否使用部门ID
cwarehouseidstring否否仓库ID
idiscounttaxtypestring否否扣税类别
naccumsettmnystring否否累计本币结算金额
naccumsettnumstring否否累计结算数量
nassistnumstring否否辅数量
nexchangeotobratestring否否折本汇率
nexchangeratestring否否换算率
ninvoicenumstring否是发票数量
nmoneystring否否本币无税金额
norgnettaxpricestring否否原币净含税单价
noriginalcurmnystring否是原币无税金额
noriginalcurpricestring否否原币无税净单价
noriginalpaymentmnystring否否原币累计付款
noriginalsummnystring否是原币价税合计
noriginaltaxmnystring否否原币税额
npaymentmnystring否否本币累计付款
nreasonwastenumstring否否合理损耗数量
nsummnystring否否本币价税合计
ntaxmnystring否否本币税额
ntaxratestring否否税率（调用修改接口的时候必传）
pk_corpstring否否公司主键
pk_defdoc1string否否自定义项主键1
pk_defdoc10string否否自定义项主键10
pk_defdoc11string否否自定义项主键11
pk_defdoc12string否否自定义项主键12
pk_defdoc13string否否自定义项主键13
pk_defdoc14string否否自定义项主键14
pk_defdoc15string否否自定义项主键15
pk_defdoc16string否否自定义项主键16
pk_defdoc17string否否自定义项主键17
pk_defdoc18string否否自定义项主键18
pk_defdoc19string否否自定义项主键19
pk_defdoc2string否否自定义项主键2
pk_defdoc20string否否自定义项主键20
pk_defdoc3string否否自定义项主键3
pk_defdoc4string否否自定义项主键4
pk_defdoc5string否否自定义项主键5
pk_defdoc6string否否自定义项主键6
pk_defdoc7string否否自定义项主键7
pk_defdoc8string否否自定义项主键8
pk_defdoc9string否否自定义项主键9
pk_upsrccorpstring否否上层来源单据公司
vdef1string否否自定义项1
vdef10string否否自定义项10
vdef11string否否自定义项11
vdef12string否否自定义项12
vdef13string否否自定义项13
vdef14string否否自定义项14
vdef15string否否自定义项15
vdef16string否否自定义项16
vdef17string否否自定义项17
vdef18string否否自定义项18
vdef19string否否自定义项19
vdef2string否否自定义项2
vdef20string否否自定义项20
vdef3string否否自定义项3
vdef4string否否自定义项4
vdef5string否否自定义项5
vdef6string否否自定义项6
vdef7string否否自定义项7
vdef8string否否自定义项8
vdef9string否否自定义项9
vfree1string否否自由项1
vfree2string否否自由项2
vfree3string否否自由项3
vfree4string否否自由项4
vfree5string否否自由项5
vmemostring否否备注
vproducenumstring否否批次号
parentvo否是采购发票表头vo
cbiztypestring否否业务类型
cdeptidstring否否采购部门
cemployeeidstring否否业务员
coperatorstring否是制单人
cvendorbaseidstring否否供应商基础（入参不传这个）
cvendormangidstring否否供应商管理（入参传这个）
darrivedatestring否否票到日期
dauditdatestring否否审批日期
dinvoicedatestring否否发票日期
idiscounttaxtypestring否否整单扣税类别
iinvoicetypestring否否发票类型
nexchangeotobratestring否否整单折本汇率
ntaxratestring否否整单税率
ntotalmnystring否否合计金额
ntotalnumstring否否合计数量
pk_arrvcorpstring否否收货公司
pk_corpstring否是公司主键
pk_defdoc1string否否自定义项主键1
pk_defdoc10string否否自定义项主键10
pk_defdoc11string否否自定义项主键11
pk_defdoc12string否否自定义项主键12
pk_defdoc13string否否自定义项主键13
pk_defdoc14string否否自定义项主键14
pk_defdoc15string否否自定义项主键15
pk_defdoc16string否否自定义项主键16
pk_defdoc17string否否自定义项主键17
pk_defdoc18string否否自定义项主键18
pk_defdoc19string否否自定义项主键19
pk_defdoc2string否否自定义项主键2
pk_defdoc20string否否自定义项主键20
pk_defdoc3string否否自定义项主键3
pk_defdoc4string否否自定义项主键4
pk_defdoc5string否否自定义项主键5
pk_defdoc6string否否自定义项主键6
pk_defdoc7string否否自定义项主键7
pk_defdoc8string否否自定义项主键8
pk_defdoc9string否否自定义项主键9
tmaketimestring否否制单时间
vdef1string否否自定义项1
vdef10string否否自定义项10
vdef11string否否自定义项11
vdef12string否否自定义项12
vdef13string否否自定义项13
vdef14string否否自定义项14
vdef15string否否自定义项15
vdef16string否否自定义项16
vdef17string否否自定义项17
vdef18string否否自定义项18
vdef19string否否自定义项19
vdef2string否否自定义项2
vdef20string否否自定义项20
vdef3string否否自定义项3
vdef4string否否自定义项4
vdef5string否否自定义项5
vdef6string否否自定义项6
vdef7string否否自定义项7
vdef8string否否自定义项8
vdef9string否否自定义项9
vinvoicecodestring否否发票号
vmemostring否否备注

返回类型参数:

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

代码示例:

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

请求参数示例:

最简示例来源采购订单上层来源采购入库示例来源库存委外加工入库单来源库存期初采购统计类型自定义项带备注型自定义项

复制代码

{"invoicevo":{"childrenvo":[{"cmangid":"IN0007","noriginalsummny":"100","ninvoicenum":"100"}],"parentvo":{"cdeptid":"2901-_-1001","cvendormangid":"CU0025","coperator":"apilym","pk_corp":"2901","dorderdate":"2023-09-12","cbiztype":"c001"}}}

正确返回示例:

复制代码

{
    "status": "success",
    "data": "[{\"parentvo\":{\"cinvoiceid\":\"1007ZZ10000000000DWJ\",\"pk_corp\":\"1007\",\"corp_code\":\"8888\",\"corp_name\":\"刘云祥集团\",\"pk_purcorp\":\"1007\",\"purcorp_code\":\"8888\",\"purcorp_name\":\"刘云祥集团\",\"vinvoicecode\":\"CF2010230011\",\"cdeptid\":\"10071210000000000393\",\"cdept_code\":\"3000\",\"cdept_name\":\"零星采购部\",\"cvendormangid\":\"00011210000000003L1J\",\"cvendormang_code\":\"CU2100002\",\"cvendormang_name\":\"北京肯德基有限公司\",\"cvendorbaseid\":\"00011210000000003L1A\",\"dinvoicedate\":\"2020-10-23\",\"darrivedate\":\"2020-10-23\",\"cbiztype\":\"100712100000000000Q4\",\"biztype_code\":\"po01\",\"biztype_name\":\"21-45-25\",\"finitflag\":\"0\",\"coperator\":\"000132100000000000UO\",\"operator_code\":\"18242366050\",\"operator_name\":\"刘云祥\",\"caccountyear\":\"2020\",\"cbilltype\":\"25\",\"ibillstatus\":\"0\",\"cstoreorganization\":\"1007121000000000008R\",\"cstoreorg_code\":\"1000\",\"cstoreorg_name\":\"集团组织01\",\"tmaketime\":\"2020-10-23 15:59:10\",\"tlastmaketime\":\"2020-10-23 15:59:10\",\"bapflag\":false,\"ntaxrate\":18.918919,\"ntotalnum\":20,\"ntotalmny\":66},\"childrenvo\":[{\"cinvoice_bid\":\"1007ZZ10000000000DWK\",\"cinvoiceid\":\"1007ZZ10000000000DWJ\",\"pk_corp\":\"1007\",\"corp_code\":\"8888\",\"corp_name\":\"刘云祥集团\",\"corder_bid\":\"100712100000000006IB\",\"corderid\":\"100712100000000006IA\",\"csourcebilltype\":\"21\",\"csourcebillid\":\"100712100000000006IA\",\"csourcebillrowid\":\"100712100000000006IB\",\"cupsourcebilltype\":\"45\",\"cupsourcebillid\":\"100712100000000006IF\",\"cupsourcebillrowid\":\"100712100000000006IG\",\"cmangid\":\"00011210000000003L1P\",\"invcode\":\"IN0003\",\"cmang_name\":\"草莓\",\"cbaseid\":\"000132100000000002VQ\",\"ninvoicenum\":20,\"naccumsettnum\":0,\"ccurrencytypeid\":\"00010000000000000001\",\"ccurr_code\":\"CNY\",\"ccurr_name\":\"人民币\",\"noriginalcurprice\":2.775,\"idiscounttaxtype\":\"1\",\"ntaxrate\":18.918919,\"noriginalcurmny\":55.5,\"noriginaltaxmny\":10.5,\"norgnettaxprice\":3.3,\"noriginalsummny\":66,\"noriginalpaymentmny\":0,\"nexchangeotobrate\":1,\"nmoney\":55.5,\"ntaxmny\":10.5,\"nsummny\":66,\"npaymentmny\":0,\"naccumsettmny\":0,\"cwarehouseid\":\"1007121000000000009R\",\"cwarehouse_code\":\"2000\",\"cwarehouse_name\":\"小仓库\",\"crowno\":\"10\",\"nreasonwastenum\":0}]}]",
    "taskNumber": "202010230044"
}

错误返回示例:

复制代码

{
    "status": "falied",
    "errorcode": "",
    "errormsg": "java.lang.IndexOutOfBoundsException: Index: 0, Size: 0",
    "taskNumber": "202010230045"
}