文档
测试

新开具发票接口

POST
/ykapi/invoiceNew/invoicing

接口描述

新开具发票对外接口

请求头

参数名
类型
描述
必填

请求参数

参数名
类型
描述
必填
appKey
String
唯一标识
必填
sign
String
唯一标识
必填
invoiceAmount
BigDecimal
含税金额(总包服务费)
必填
invoicingType
String
开具发票类型:0纸质专票,1电子普票,2电子专票(测试环境不支持)
必填
createUser
String
开票人
必填
projectName
String
开具发票对应的项目名称
必填
tenantId
String
入园企业id
必填
invoiceServiceitem
String
服务名称(单条服务内容:市场营销推广众包服务 合并开票:市场营销推广众包服务、培训外包服务......)
必填
remark
String
备注
可选
orderName
String
收件人名字
必填
orderAddress
String
收件人地址
必填
orderPhone
String
收件人电话
必填
invoiceAmountS
String
合并开票时使用(例如:2000、3000......)
可选

响应参数

参数名
类型
描述
必填
retCode
String
返回状态码(详情参数见下面的状态码)
必填
retMsg
String
返回描述
必填
data
String
返回结果(成功则是个发票流水号,用于查询开具发票的附件使用)
必填

状态码

参数名
类型
描述
必填
0000
请求成功
必填
1001
appKey不能为空
必填
1002
sign不能为空
必填
1003
tenantId不能为空
必填
1004
projectName不能为空
必填
1005
invoiceAmount不能为空
必填
1006
invoicingType不能为空
必填
1007
createUser不能为空
必填
1008
invoiceServiceitem不能为空
必填
1009
orderName不能为空
必填
1010
orderAddress不能为空
必填
1011
orderPhone不能为空
必填
1012
orderPhone收件人电话格式不对
必填
2001
appAppsecret未分配
必填
2002
查询发票限额出错
必填
3000
本日开票金额已达上限,请明日再开或者本企业发票票数不够
必填
3001
诺诺发票开具失败原因
必填
3002
所选服务对应的结算单不存在,请确认是否创建过
必填
7777
发票开具中
必填
9999
签名验证失败
必填

说明 / 示例

projectName 开具发票对应的项目名称 (必须是你上传结算单上的那个项目名称) 例如: 你上传了A合同的结算单 (项目名称 A) B合同的结算单 (项目名称 B) 那你这个可以根据你需要给那个合同签署的公司选择开那个合同下结算单中的票 invoiceServiceitem 服务名称(单条服务内容:市场营销推广众包服务 合并开票:市场营销推广众包服务、培训外包服务......) 这个需要和你结算单中那个serviceContent(服务内容(这条结算单的开票项目,例:互联网营销推广))一致即可,可以在上传的多个服务内容中选择一个