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出参
无
