API中心

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

采购发票查询

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

参数填写指南

请求方式:POST

请求参数(header):

参数填写指南
参数名必填描述默认值
Content-Type是请求体数据类型application/json
usercode是用户
password是密码
system是系统参数

请求参数(body):

全量参数最简示例采购发票查询全属性示例
参数名类型是否数组必填描述默认值示例值
cbiztype是否业务类型
cmangid否否存货
code否否发票号
corp否否公司
date_begin否否发票日期（v3.5版本前必填）
date_end否否发票日期（v3.5版本前必填）
dauditdate否否审批日期
endTs否否结束时间戳（v3.5版本支持）
ibillstatus是否单据状态
page_now否否当前页
page_size否否每页数量
purcorp否否采购公司
startTs否否开始时间戳（v3.5版本支持）
vendor否否供应商

返回类型参数:

参数名类型是否数组必填描述默认值
invoicevo采购发票_返回
childrenvo是否采购发票表体
cassistunitstring否否辅单位ID
cinvoice_bidstring否否发票行ID主键
cinvoiceidstring否否发票ID外键
cmang_namestring否否存货名称
cmangidstring否否存货管理ID
corder_bidstring否否采购订单行ID
corderidstring否否采购订单ID
corp_codestring否否公司编码
corp_namestring否否公司名称
csourcebillidstring否否源头单据ID
csourcebillrowidstring否否源头单据行ID
csourcebilltypestring否否源头单据类型
cupsourcebillidstring否否上层来源单据ID
cupsourcebillrowidstring否否上层来源单据行ID
cupsourcebilltypestring否否上层单据类型
cusedept_codestring否否使用部门编码
cusedept_name cusedeptidstring否否使用部门名称
cusedeptidstring否否使用部门ID
cwarehouse_codestring否否仓库编码
cwarehouse_namestring否否仓库名称
cwarehouseidstring否否仓库ID
invcodestring否否存货编码
invspecstring否否存货规格（V5.1开始支持）
invtypestring否否存货型号（V5.1开始支持）
naccumsettnumstring否否累计结算数量
nassistnumstring否否辅数量
nexchangeotobratestring否否折本汇率
nexchangeratestring否否换算率
ninvoicenumstring否否发票数量
nmoneystring否否本币无税金额
norgnettaxpricestring否否原币净含税单价
noriginalcurmnystring否否原币无税金额
noriginalcurpricestring否否原币无税净单价
noriginalpaymentmnystring否否原币累计付款
noriginalsummnystring否否原币价税合计
noriginaltaxmnystring否否原币税额
nreasonwastenumstring否否合理损耗数量
nsummnystring否否本币价税合计
ntaxmnystring否否本币税额
ntaxratestring否否税率
pk_corpstring否否公司主键
pk_defdoc1string否否自定义项主键1(pk_defdoc1-20)
vdef1string否否自定义项1(vdef1-20)
vfree1string否否自由项1（vfree1-5）
vmemostring否否备注
vproducenumstring否否批次号
parentvo否否采购发票表头
arrvcorp_codestring否否收货公司编码
arrvcorp_namestring否否收货公司名称
biztype_codestring否否业务类型编码
biztype_namestring否否业务类型名称
caccountbank_code caccountbank_namestring否否开户银行编码
caccountbank_namestring否否开户银行名称
caccountbankidstring否否开户银行主键
caccountyearstring否否会计年度
cauditpsnstring否否审批人主键
cauditpsn_codestring否否审批人编码
cauditpsn_namestring否否审批人名称
cbiztypestring否否业务类型主键
cdept_codestring否否采购部门编码
cdept_namestring否否采购部门名称
cdeptidstring否否采购部门主键
cemployee_codestring否否业务员编码
cemployee_namestring否否业务员名称
cemployeeidstring否否业务员主键
cfreecust_codestring否否散户编码
cfreecust_namestring否否散户名称
cfreecustidstring否否散户主键
cinvoiceidstring否否发票主键
coperatorstring否否制单人主键
corp_codestring否否公司编码
corp_namestring否否公司名称
cpayunitstring否否付款单位主键
cpayunit_codestring否否付款单位编码
cpayunit_namestring否否付款单位名称
cstoreorg_codestring否否库存组织编码
cstoreorg_namestring否否库存组织名称
cstoreorganizationstring否否库存组织主键
ctermprotocolidstring否否付款协议
cvendormang_codestring否否供应商编码
cvendormang_namestring否否供应商名称
cvendormangidstring否否供应商主键
cvoucheridstring否否凭证号
darrivedatestring否否票到日期
dauditdatestring否否审批日期
dinvoicedatestring否否发票日期
finitflagstring否否发票标志
ibillstatusstring否否单据状态
iinvoicetypestring否否发票类型
nexchangeotobratestring否否整单折本汇率
ntaxratestring否否整单税率
ntotalmnystring否否合计金额
ntotalnumstring否否合计数量
operator_codestring否否制单人编码
operator_namestring否否制单人名称
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
pk_purcorpstring否否采购公司主键
purcorp_codestring否否采购公司编码
purcorp_namestring否否采购公司名称
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否否备注

代码示例:

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

请求参数示例:

最简示例采购发票查询全属性示例

复制代码

{"date_end":"2018-09-01","date_begin":"2010-01-01","startTs":"2021-08-09 14:32:00","endTs":"2021-08-10 14:32:00"}

正确返回示例:

复制代码

{
    "status": "success",
    "data": "{\"allcount\":1,\"retcount\":1,\"datas\":[{\"parentvo\":{\"cinvoiceid\":\"10011210000000001QON\",\"pk_corp\":\"1001\",\"corp_code\":\"1000\",\"corp_name\":\"天海总公司\",\"pk_purcorp\":\"1001\",\"purcorp_code\":\"1000\",\"purcorp_name\":\"天海总公司\",\"vinvoicecode\":\"CFTH1810190001\",\"iinvoicetype\":\"0\",\"cdeptid\":\"100111100000000000PA\",\"cdept_code\":\"106\",\"cdept_name\":\"采购部\",\"cvendormangid\":\"000111100000000008WD\",\"cvendormang_code\":\"S2003\",\"cvendormang_name\":\"北京康普乳品有限公司\",\"cvendorbaseid\":\"000111100000000006KK\",\"cemployeeid\":\"00011210000000005T6X\",\"cemployee_code\":\"HI1810190033\",\"cemployee_name\":\"魏秋水\",\"dinvoicedate\":\"2017-01-01\",\"darrivedate\":\"2017-01-01\",\"cbiztype\":\"00011110000000001GGS\",\"biztype_code\":\"YS02\",\"biztype_name\":\"演示-合同控制采购业务流程\",\"cpayunit\":\"000111100000000008WD\",\"cpayunit_code\":\"S2003\",\"cpayunit_name\":\"北京康普乳品有限公司\",\"finitflag\":\"0\",\"coperator\":\"000111100000000000YQ\",\"operator_code\":\"demo9\",\"operator_name\":\"demo9\",\"caccountyear\":\"2017\",\"cbilltype\":\"25\",\"ibillstatus\":\"3\",\"dauditdate\":\"2017-09-01\",\"cauditpsn\":\"000111100000000000YQ\",\"cauditpsn_code\":\"demo9\",\"cauditpsn_name\":\"demo9\",\"cstoreorganization\":\"100111100000000000OQ\",\"cstoreorg_code\":\"1000\",\"cstoreorg_name\":\"天海集团库存组织\",\"iprintcount\":\"0\",\"tmaketime\":\"2018-10-19 15:59:55\",\"taudittime\":\"2018-10-19 16:00:42\",\"tlastmaketime\":\"2018-10-19 15:59:55\",\"bapflag\":true,\"nexchangeotobrate\":1},\"childrenvo\":[{\"cinvoice_bid\":\"10011210000000001QOO\",\"cinvoiceid\":\"10011210000000001QON\",\"pk_corp\":\"1001\",\"corp_code\":\"1000\",\"corp_name\":\"天海总公司\",\"corder_bid\":\"10011210000000001QIJ\",\"corderid\":\"10011210000000001QII\",\"csourcebilltype\":\"21\",\"csourcebillid\":\"10011210000000001QII\",\"csourcebillrowid\":\"10011210000000001QIJ\",\"cupsourcebilltype\":\"45\",\"cupsourcebillid\":\"10011210000000001QOE\",\"cupsourcebillrowid\":\"10011210000000001QOG\",\"cmangid\":\"00011110000000000ETB\",\"invcode\":\"010202\",\"cmang_name\":\"乳清粉\",\"cbaseid\":\"00011110000000000DXC\",\"ninvoicenum\":1000,\"naccumsettnum\":1000,\"ccurrencytypeid\":\"00010000000000000001\",\"ccurr_code\":\"CNY\",\"ccurr_name\":\"人民币\",\"noriginalcurprice\":3,\"idiscounttaxtype\":\"1\",\"ntaxrate\":17,\"noriginalcurmny\":3000,\"noriginaltaxmny\":510,\"norgnettaxprice\":3.51,\"noriginalsummny\":3510,\"noriginalpaymentmny\":0,\"nexchangeotobrate\":1,\"nmoney\":3000,\"ntaxmny\":510,\"nsummny\":3510,\"npaymentmny\":0,\"naccumsettmny\":3000,\"vmemo\":\"\",\"cwarehouseid\":\"100111100000000003VH\",\"cwarehouse_code\":\"ck01\",\"cwarehouse_name\":\"天海总公司仓库\",\"crowno\":\"10\",\"nreasonwastenum\":0}]}]}",
    "taskNumber": "202009040037"
}

错误返回示例:

复制代码

error status : 500, {'status':'-1', 'msg':'errcode:300017, errormsg: Requied parameter can not be null: date_end'}
Spend Time: 3 ms