文档
测试

发票信息接口

POST
/ykapi/invoice/newInvoice

接口描述

发票信息接口

请求头

参数名
类型
描述
必填

请求参数

参数名
类型
描述
必填
appKey
String
唯一标识
必填
sign
String
唯一标识
必填
settlementBatchnumber
String
结算批次号,与结算单新增接口结算批次号一致
必填
invoiceAmount
BigDecimal
发票金额
必填
tenantId
String
企业ID,接口提供
必填
invoiceDate
Date
开票日期
必填
invoiceNumber
String
发票号
必填
invoiceAmountN
BigDecimal
不含税金额
必填
invoiceRate
BigDecimal
税率(小数:比如0.07)
必填
invoiceAttachAttr
文件流
发票附件(文件大小不应超过20M)
必填
invoiceAttachExt
String
发票附件扩展名
可选
invoiceServiceitem
String
发票服务项目
必填

响应参数

参数名
类型
描述
必填
retCode
String
返回状态码(详情参数见下面的状态码)
必填
retMsg
String
返回描述
必填
data
String
返回结果
必填

状态码

参数名
类型
描述
必填
0000
成功
必填
1001
appKey不能为空
必填
1002
sign不能为空
必填
1003
tenantId不能为空
必填
1004
settlementBatchnumber不能为空
必填
1005
发票服务项目不能为空
必填
1006
发票号不能为空
必填
1007
不含税金额不能为空
必填
1008
发票金额不能为空
必填
1009
税率不能为空
必填
1010
开票日期不能为空
必填
1012
appAppsecret未分配
必填
1013
appAppsecret未分配
必填
1014
无对应应收信息数据
必填
1015
无对应合同信息数据
必填
1018
发票附件上传异常
必填
1098
文件格式不正确
必填
1099
文件大小不应超过20M
必填
9999
签名验证失败
必填
1111
发票新增异常
必填