U8C API中心

API中心

采购管理
采购发票

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

采购发票新增

接口所在U8C版本:U8 cloud3.1以及更高版本

详细描述:用于采购发票新增

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

接口地址

请求方式

请求参数header

请求参数body

返回类型参数

代码示例

请求参数示例

正确返回示例

错误返回示例

接口地址:http://ip:port/u8cloud/api/pu/invoice/insert

参数填写指南

请求方式:POST

请求参数(header):

参数填写指南

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

请求参数(body):

全量参数最简示例来源采购订单关联上游采购入库单传参示例来源库存委外加工入库单带统计型自定义项带备注型自定义项

参数名	类型	是否数组	必填	描述
invoicevo		否	是	采购发票新增
childrenvo		是	是	采购发票表体vo
cassistunit	string	否	否	辅单位ID
cbaseid	string	否	否	存货基础ID
ccostsubjid	string	否	否	收支项目ID
ccurrencytypeid	string	否	否	原币币种ID
cinvoice_bid	string	否	否	发票行ID主键
cinvoiceid	string	否	否	发票ID外键
cmangid	string	否	否	存货管理ID
corder_bid	string	否	否	采购订单行ID
corderid	string	否	否	采购订单ID
cprojectid	string	否	否	项目ID
cprojectphaseid	string	否	否	项目阶段ID
crowno	string	否	否	行号
csourcebillid	string	否	否	来源单据ID
csourcebillrowid	string	否	否	来源单据行ID
csourcebilltype	string	否	否	来源单据类型
cupsourcebillid	string	否	否	上层来源单据ID
cupsourcebillrowid	string	否	否	上层来源单据行ID
cupsourcebilltype	string	否	否	上层单据类型
cusedeptid	string	否	否	使用部门ID
cwarehouseid	string	否	否	仓库ID
idiscounttaxtype	string	否	否	扣税类别
naccumsettmny	string	否	否	累计本币结算金额
naccumsettnum	string	否	否	累计结算数量
nassistnum	string	否	否	辅数量
nexchangeotobrate	string	否	否	折本汇率
nexchangerate	string	否	否	换算率
ninvoicenum	string	否	是	发票数量
nmoney	string	否	否	本币无税金额
norgnettaxprice	string	否	否	原币净含税单价
noriginalcurmny	string	否	是	原币无税金额
noriginalcurprice	string	否	否	原币无税净单价
noriginalpaymentmny	string	否	否	原币累计付款
noriginalsummny	string	否	是	原币价税合计
noriginaltaxmny	string	否	否	原币税额
npaymentmny	string	否	否	本币累计付款
nreasonwastenum	string	否	否	合理损耗数量
nsummny	string	否	否	本币价税合计
ntaxmny	string	否	否	本币税额
ntaxrate	string	否	否	税率（调用修改接口的时候必传）
pk_corp	string	否	否	公司主键
pk_defdoc1	string	否	否	自定义项主键1
pk_defdoc10	string	否	否	自定义项主键10
pk_defdoc11	string	否	否	自定义项主键11
pk_defdoc12	string	否	否	自定义项主键12
pk_defdoc13	string	否	否	自定义项主键13
pk_defdoc14	string	否	否	自定义项主键14
pk_defdoc15	string	否	否	自定义项主键15
pk_defdoc16	string	否	否	自定义项主键16
pk_defdoc17	string	否	否	自定义项主键17
pk_defdoc18	string	否	否	自定义项主键18
pk_defdoc19	string	否	否	自定义项主键19
pk_defdoc2	string	否	否	自定义项主键2
pk_defdoc20	string	否	否	自定义项主键20
pk_defdoc3	string	否	否	自定义项主键3
pk_defdoc4	string	否	否	自定义项主键4
pk_defdoc5	string	否	否	自定义项主键5
pk_defdoc6	string	否	否	自定义项主键6
pk_defdoc7	string	否	否	自定义项主键7
pk_defdoc8	string	否	否	自定义项主键8
pk_defdoc9	string	否	否	自定义项主键9
pk_upsrccorp	string	否	否	上层来源单据公司
vdef1	string	否	否	自定义项1
vdef10	string	否	否	自定义项10
vdef11	string	否	否	自定义项11
vdef12	string	否	否	自定义项12
vdef13	string	否	否	自定义项13
vdef14	string	否	否	自定义项14
vdef15	string	否	否	自定义项15
vdef16	string	否	否	自定义项16
vdef17	string	否	否	自定义项17
vdef18	string	否	否	自定义项18
vdef19	string	否	否	自定义项19
vdef2	string	否	否	自定义项2
vdef20	string	否	否	自定义项20
vdef3	string	否	否	自定义项3
vdef4	string	否	否	自定义项4
vdef5	string	否	否	自定义项5
vdef6	string	否	否	自定义项6
vdef7	string	否	否	自定义项7
vdef8	string	否	否	自定义项8
vdef9	string	否	否	自定义项9
vfree1	string	否	否	自由项1
vfree2	string	否	否	自由项2
vfree3	string	否	否	自由项3
vfree4	string	否	否	自由项4
vfree5	string	否	否	自由项5
vmemo	string	否	否	备注
vproducenum	string	否	否	批次号
parentvo		否	是	采购发票表头vo
cbiztype	string	否	否	业务类型
cdeptid	string	否	否	采购部门
cemployeeid	string	否	否	业务员
coperator	string	否	是	制单人
cvendorbaseid	string	否	否	供应商基础（入参不传这个）
cvendormangid	string	否	否	供应商管理（入参传这个）
darrivedate	string	否	否	票到日期
dauditdate	string	否	否	审批日期
dinvoicedate	string	否	否	发票日期
idiscounttaxtype	string	否	否	整单扣税类别
iinvoicetype	string	否	否	发票类型
nexchangeotobrate	string	否	否	整单折本汇率
ntaxrate	string	否	否	整单税率
ntotalmny	string	否	否	合计金额
ntotalnum	string	否	否	合计数量
pk_arrvcorp	string	否	否	收货公司
pk_corp	string	否	是	公司主键
pk_defdoc1	string	否	否	自定义项主键1
pk_defdoc10	string	否	否	自定义项主键10
pk_defdoc11	string	否	否	自定义项主键11
pk_defdoc12	string	否	否	自定义项主键12
pk_defdoc13	string	否	否	自定义项主键13
pk_defdoc14	string	否	否	自定义项主键14
pk_defdoc15	string	否	否	自定义项主键15
pk_defdoc16	string	否	否	自定义项主键16
pk_defdoc17	string	否	否	自定义项主键17
pk_defdoc18	string	否	否	自定义项主键18
pk_defdoc19	string	否	否	自定义项主键19
pk_defdoc2	string	否	否	自定义项主键2
pk_defdoc20	string	否	否	自定义项主键20
pk_defdoc3	string	否	否	自定义项主键3
pk_defdoc4	string	否	否	自定义项主键4
pk_defdoc5	string	否	否	自定义项主键5
pk_defdoc6	string	否	否	自定义项主键6
pk_defdoc7	string	否	否	自定义项主键7
pk_defdoc8	string	否	否	自定义项主键8
pk_defdoc9	string	否	否	自定义项主键9
tmaketime	string	否	否	制单时间
vdef1	string	否	否	自定义项1
vdef10	string	否	否	自定义项10
vdef11	string	否	否	自定义项11
vdef12	string	否	否	自定义项12
vdef13	string	否	否	自定义项13
vdef14	string	否	否	自定义项14
vdef15	string	否	否	自定义项15
vdef16	string	否	否	自定义项16
vdef17	string	否	否	自定义项17
vdef18	string	否	否	自定义项18
vdef19	string	否	否	自定义项19
vdef2	string	否	否	自定义项2
vdef20	string	否	否	自定义项20
vdef3	string	否	否	自定义项3
vdef4	string	否	否	自定义项4
vdef5	string	否	否	自定义项5
vdef6	string	否	否	自定义项6
vdef7	string	否	否	自定义项7
vdef8	string	否	否	自定义项8
vdef9	string	否	否	自定义项9
vinvoicecode	string	否	否	发票号
vmemo	string	否	否	备注

返回类型参数:

参数名	类型	是否数组	必填	描述
invoicevo				采购发票_返回
childrenvo		是	否	采购发票表体
cassistunit	string	否	否	辅单位ID
cinvoice_bid	string	否	否	发票行ID主键
cinvoiceid	string	否	否	发票ID外键
cmang_name	string	否	否	存货名称
cmangid	string	否	否	存货管理ID
corder_bid	string	否	否	采购订单行ID
corderid	string	否	否	采购订单ID
corp_code	string	否	否	公司编码
corp_name	string	否	否	公司名称
csourcebillid	string	否	否	源头单据ID
csourcebillrowid	string	否	否	源头单据行ID
csourcebilltype	string	否	否	源头单据类型
cupsourcebillid	string	否	否	上层来源单据ID
cupsourcebillrowid	string	否	否	上层来源单据行ID
cupsourcebilltype	string	否	否	上层单据类型
cusedept_code	string	否	否	使用部门编码
cusedept_name cusedeptid	string	否	否	使用部门名称
cusedeptid	string	否	否	使用部门ID
cwarehouse_code	string	否	否	仓库编码
cwarehouse_name	string	否	否	仓库名称
cwarehouseid	string	否	否	仓库ID
invcode	string	否	否	存货编码
invspec	string	否	否	存货规格（V5.1开始支持）
invtype	string	否	否	存货型号（V5.1开始支持）
naccumsettnum	string	否	否	累计结算数量
nassistnum	string	否	否	辅数量
nexchangeotobrate	string	否	否	折本汇率
nexchangerate	string	否	否	换算率
ninvoicenum	string	否	否	发票数量
nmoney	string	否	否	本币无税金额
norgnettaxprice	string	否	否	原币净含税单价
noriginalcurmny	string	否	否	原币无税金额
noriginalcurprice	string	否	否	原币无税净单价
noriginalpaymentmny	string	否	否	原币累计付款
noriginalsummny	string	否	否	原币价税合计
noriginaltaxmny	string	否	否	原币税额
nreasonwastenum	string	否	否	合理损耗数量
nsummny	string	否	否	本币价税合计
ntaxmny	string	否	否	本币税额
ntaxrate	string	否	否	税率
pk_corp	string	否	否	公司主键
pk_defdoc1	string	否	否	自定义项主键1(pk_defdoc1-20)
vdef1	string	否	否	自定义项1(vdef1-20)
vfree1	string	否	否	自由项1（vfree1-5）
vmemo	string	否	否	备注
vproducenum	string	否	否	批次号
parentvo		否	否	采购发票表头
arrvcorp_code	string	否	否	收货公司编码
arrvcorp_name	string	否	否	收货公司名称
biztype_code	string	否	否	业务类型编码
biztype_name	string	否	否	业务类型名称
caccountbank_code caccountbank_name	string	否	否	开户银行编码
caccountbank_name	string	否	否	开户银行名称
caccountbankid	string	否	否	开户银行主键
caccountyear	string	否	否	会计年度
cauditpsn	string	否	否	审批人主键
cauditpsn_code	string	否	否	审批人编码
cauditpsn_name	string	否	否	审批人名称
cbiztype	string	否	否	业务类型主键
cdept_code	string	否	否	采购部门编码
cdept_name	string	否	否	采购部门名称
cdeptid	string	否	否	采购部门主键
cemployee_code	string	否	否	业务员编码
cemployee_name	string	否	否	业务员名称
cemployeeid	string	否	否	业务员主键
cfreecust_code	string	否	否	散户编码
cfreecust_name	string	否	否	散户名称
cfreecustid	string	否	否	散户主键
cinvoiceid	string	否	否	发票主键
coperator	string	否	否	制单人主键
corp_code	string	否	否	公司编码
corp_name	string	否	否	公司名称
cpayunit	string	否	否	付款单位主键
cpayunit_code	string	否	否	付款单位编码
cpayunit_name	string	否	否	付款单位名称
cstoreorg_code	string	否	否	库存组织编码
cstoreorg_name	string	否	否	库存组织名称
cstoreorganization	string	否	否	库存组织主键
ctermprotocolid	string	否	否	付款协议
cvendormang_code	string	否	否	供应商编码
cvendormang_name	string	否	否	供应商名称
cvendormangid	string	否	否	供应商主键
cvoucherid	string	否	否	凭证号
darrivedate	string	否	否	票到日期
dauditdate	string	否	否	审批日期
dinvoicedate	string	否	否	发票日期
finitflag	string	否	否	发票标志
ibillstatus	string	否	否	单据状态
iinvoicetype	string	否	否	发票类型
nexchangeotobrate	string	否	否	整单折本汇率
ntaxrate	string	否	否	整单税率
ntotalmny	string	否	否	合计金额
ntotalnum	string	否	否	合计数量
operator_code	string	否	否	制单人编码
operator_name	string	否	否	制单人名称
pk_arrvcorp	string	否	否	收货公司主键
pk_corp	string	否	否	公司主键
pk_defdoc1	string	否	否	自定义项主键1
pk_defdoc10	string	否	否	自定义项主键10
pk_defdoc11	string	否	否	自定义项主键11
pk_defdoc12	string	否	否	自定义项主键12
pk_defdoc13	string	否	否	自定义项主键13
pk_defdoc14	string	否	否	自定义项主键14
pk_defdoc15	string	否	否	自定义项主键15
pk_defdoc16	string	否	否	自定义项主键16
pk_defdoc17	string	否	否	自定义项主键17
pk_defdoc18	string	否	否	自定义项主键18
pk_defdoc19	string	否	否	自定义项主键19
pk_defdoc2	string	否	否	自定义项主键2
pk_defdoc20	string	否	否	自定义项主键20
pk_defdoc3	string	否	否	自定义项主键3
pk_defdoc4	string	否	否	自定义项主键4
pk_defdoc5	string	否	否	自定义项主键5
pk_defdoc6	string	否	否	自定义项主键6
pk_defdoc7	string	否	否	自定义项主键7
pk_defdoc8	string	否	否	自定义项主键8
pk_defdoc9	string	否	否	自定义项主键9
pk_purcorp	string	否	否	采购公司主键
purcorp_code	string	否	否	采购公司编码
purcorp_name	string	否	否	采购公司名称
tmaketime	string	否	否	制单时间
vdef1	string	否	否	自定义项1
vdef10	string	否	否	自定义项10
vdef11	string	否	否	自定义项11
vdef12	string	否	否	自定义项12
vdef13	string	否	否	自定义项13
vdef14	string	否	否	自定义项14
vdef15	string	否	否	自定义项15
vdef16	string	否	否	自定义项16
vdef17	string	否	否	自定义项17
vdef18	string	否	否	自定义项18
vdef19	string	否	否	自定义项19
vdef2	string	否	否	自定义项2
vdef20	string	否	否	自定义项20
vdef3	string	否	否	自定义项3
vdef4	string	否	否	自定义项4
vdef5	string	否	否	自定义项5
vdef6	string	否	否	自定义项6
vdef7	string	否	否	自定义项7
vdef8	string	否	否	自定义项8
vdef9	string	否	否	自定义项9
vinvoicecode	string	否	否	发票号
vmemo	string	否	否	备注

代码示例:

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

请求参数示例:

最简示例来源采购订单关联上游采购入库单传参示例来源库存委外加工入库单带统计型自定义项带备注型自定义项

复制代码

{"invoicevo":{"childrenvo":[{"cmangid":"IN0007","noriginalsummny":"1","ninvoicenum":"1"}],"parentvo":{"coperator":"apilym","pk_corp":"2901"}}}

正确返回示例:

复制代码

{
  "status": "success",
  "data": "[{\"parentvo\":{\"cinvoiceid\":\"1001ZZ1000000001PK29\",\"pk_corp\":\"1001\",\"corp_code\":\"1000\",\"corp_name\":\"天海总公司\",\"vinvoicecode\":\"CF**2008240036\",\"dinvoicedate\":\"2020-08-24\",\"darrivedate\":\"2020-08-24\",\"finitflag\":\"0\",\"coperator\":\"000111100000000000RV\",\"operator_code\":\"18242366050\",\"operator_name\":\"刘云祥\",\"caccountyear\":\"2020\",\"cbilltype\":\"25\",\"ibillstatus\":\"0\",\"tmaketime\":\"2020-08-24 17:03:17\",\"tlastmaketime\":\"2020-08-24 17:03:17\",\"bapflag\":false,\"ntaxrate\":0.13636364,\"ntotalnum\":2,\"ntotalmny\":25},\"childrenvo\":[{\"cinvoice_bid\":\"1001ZZ1000000001PK2A\",\"cinvoiceid\":\"1001ZZ1000000001PK29\",\"pk_corp\":\"1001\",\"corp_code\":\"1000\",\"corp_name\":\"天海总公司\",\"ninvoicenum\":2,\"naccumsettnum\":0,\"ccurrencytypeid\":\"00010000000000000001\",\"ccurr_code\":\"CNY\",\"ccurr_name\":\"人民币\",\"noriginalcurprice\":12.482978,\"idiscounttaxtype\":\"1\",\"ntaxrate\":0.13636364,\"noriginalcurmny\":24.965956,\"noriginaltaxmny\":0.03404458,\"norgnettaxprice\":12.5,\"noriginalsummny\":25,\"noriginalpaymentmny\":0,\"nexchangeotobrate\":1,\"nmoney\":24.965956,\"ntaxmny\":0.03404458,\"nsummny\":25,\"npaymentmny\":0,\"naccumsettmny\":0,\"crowno\":\"10\",\"nreasonwastenum\":0}]}]",
  "taskNumber": "202008240065"
}

错误返回示例:

复制代码

{
  "status": "falied",
  "errorcode": "",
  "errormsg": "java.lang.IllegalArgumentException: Can't generate primary key with null pk_corp",
  "taskNumber": "202008240064"
}