1.常规接口
1.发票单列表获取
1.1入参
字段 | 说明 | 是否必填 |
---|---|---|
invoiceFrom | 发票申请来源:1:电商2:全员营销 3:X6 | 是 |
applyId | 发票申请编号 | 是 |
1.2出参
{
"code": 200,
"msg": null,
"data": {
"invoiceRecordOutDtoList": [
{
"invoiceSerialNo": "发票流水号",
"invoiceNo": "发票号",
"invoiceCode": "发票代码",
"invoiceUrl": "发票链接",
"invoiceStatus": "发票状态:1:未开票 2:已开票 3:已下载"
}
]
}
}
2.电子发票手动下载
2.1入参
字段 | 说明 | 是否必填 |
---|---|---|
invoiceSerialNo | 发票流水号 | 是 |
2.2出参
成功的情况
{
"code": 200,
"msg": null,
"data": {
"invoiceRecordOutDto": {
"invoiceSerialNo": "发票流水号",
"invoiceNo": "发票号",
"invoiceCode": "发票代码",
"invoiceUrl": "发票地址",
"invoiceStatus": "发票状态:1:未开票 2:已开票 3:已下载"
}
}
}
失败的情况
#流水号有误
{
"code": 501,
"msg": "发票流水号有误,无发票信息",
"data": null
}
#未开具不可下载
{
"code": 501,
"msg": "发票未开具成功,无法下载",
"data": null
}
#未下载成功
{
"code": 501,
"msg": "发票下载链接努力准备中,请稍后重试",
"data": null
}
3.发票红冲
3.1入参
{
"invoiceFrom":"发票来源:1:电商 2:全员营销 3:X6",
"applyId":"发票申请编号",
"invoiceNo":"发票号",
"invoiceOrderDetailInDtoList": [{
*"id":"订单明细编号"
*"name": "商品名称",
"unit": "商品单位",
"specificationModel": "商品规格型号",
*"num": "数量",
*"price": "单价",
*"taxCode": "商品税码",
*"amount": "商品明细小计"
},....],
"buyerInfoInDto": {
*"name": "开票名称(个人名称或公司名称)",
*"taxpayerId": "公司税号",
*"phone": "开票方手机号",
"address": "开票方公司地址",
"fixedTel": "开票方公司固定电话",
"email": "开票方邮箱",
"bankInfoAddress":"开票方银行地址信息",
"bankInfoAccount":"开票方银行账号信息",
*"enterpriseType": "企业类型:01:企业 02:.. 03:..."
}
}
3.2出参
成功返回
{
"code": 200,
"msg": null,
"data": null
}
错误返回
{
"code": 501,
"msg": "发票信息不存在",
"data": null
}
{
"code": 501,
"msg": "发票暂未开具成功,无法红冲",
"data": null
}
{
"code": 501,
"msg": "发票已经被红冲",
"data": null
}
4.纸质发票单号回填
4.1入参
字段 | 说明 | 是否必填 |
---|---|---|
invoiceFrom | 发票来源 | 是 |
orderNo | 订单号 | 是 |
applyId | 发票申请编号 | 是 |
invoiceNo | 发票单号 | 是 |
4.2出参
成功返回
{
"code": 200,
"msg": null,
"data": null
}
失败返回
{
"code": 501,
"msg": "发票号重复",
"data": null
}
2.队列消费者接口
1.发票初次开具或购货方修改信息后开具
1.1入参(放入申请队列中)
{
"invoiceOrderInfoInDto": {
*"orderNo": "订单号",
*"orderSource": "订单来源:1:电商 2:全员营销 3:X6",
*"totalAmount": "订单总金额",
*"orderIssuer": "发票开票人姓名",
"orderPayee": "发票收款人姓名",
"orderReviewer": "发票复核人姓名",
*"invoiceConfigId": "配置编号"
},
"invoiceOrderDetailInDtoList": [{
*"id":"订单明细编号",
*"name": "商品名称",
"unit": "商品单位",
"specificationModel": "商品规格型号",
*"num": "数量",
*"price": "单价",
*"taxCode": "商品税码",
*"amount": "商品明细小计"
},....],
"buyerInfoInDto": {
*"name": "开票名称(个人名称或公司名称)",
*"taxpayerId": "公司税号",
*"phone": "开票方手机号",
"address": "开票方公司地址",
"fixedTel": "开票方公司固定电话",
"email": "开票方邮箱",
"bankInfoAddress":"开票方银行地址信息",
"bankInfoAccount":"开票方银行账号信息",
*"enterpriseType": "企业类型:01:企业 02:.. 03:..."
}
}
1.2出参(放入响应队列中)
字段 | 说明 | 一定存在? |
---|---|---|
returnCode | 响应码: 1:开具成功 2:购货方信息错误 3:发票业务异常,请联系客服人员 |
是 |
returnMsg | 开具成功 购货方信息错误 发票业务异常,请联系客服人员 |
是 |
applyId | 发票申请编号 | 是 |
2.发票下载
2.1入参(放入下载队列)
字段 | 说明 | 必填 |
---|---|---|
invoiceSerialNo | 发票流水号 | 是 |
2.2出参
无