1.电子发票申请接口
作用:用于接收电子发票的开票订单信息、订单明细和开票人相关的信息
1.1入参
说明:用 * 标记的为必填字段
{"invoiceOrderInfoInDto": {*"orderNo": "订单号",*"orderSource": "订单来源:1:电商 2:全员营销 3:X6",*"totalAmount": "订单总金额",*"orderIssuer": "发票开票人姓名","orderPayee": "发票收款人姓名","orderReviewer": "发票复核人姓名",*"invoiceConfigId": "配置编号"},"invoiceOrderDetailInDtoList": [{*"name": "商品名称","unit": "商品单位","specificationModel": "商品规格型号",*"num": "数量",*"taxIncludedLogo": "含税标志",*"price": "单价",*"taxCode": "商品税码",*"discountLogo": "优惠标识",*"zeroTaxLogo": "零税率标识",*"vatManage": "增值税特殊管理",*"taxRate": "税率(小数:如 0.09)",*"amount": "商品明细小计"},....],"buyerInfoInDto": {*"name": "开票名称(个人名称或公司名称)",*"taxpayerId": "公司税号",*"phone": "开票方手机号","address": "开票方公司地址","fixedTel": "开票方公司固定电话","email": "开票方邮箱","bankInfo": "开票方银行信息(格式:'xxxxx行 12xxx223')",*"enterpriseType": "企业类型:01:企业 02:.. 03:..."}}
1.2出参
| 出参 | 说明 | 
|---|---|
| true | 数据保存成功 | 
| false | 数据保存失败(可能的原因:1.订单已提交过发票申请信息,2.系统内部异常:数据库崩了) | 
2.发票获取接口
2.1入参
| 字段 | 必填 | 说明 | 
|---|---|---|
| orderSource | 是 | 订单来源:1:电商 2:全员营销 3:X6 | 
| orderNo | 是 | 订单号 | 
2.2出参
| 字段 | 一定有值? | 说明 | 
|---|---|---|
| invoicingStatus | 是 | 开票状态:0:开票中 1:开票失败 2:开票成功 | 
| promptMsg | 否 | 当第一个字段为2:开票成功时此字段无值,其他情况均有消息,可直接返回给前端 | 
| invoiceRecordOutDtoList | 否 | 只有当第一个字段为2:开票成功时才会有值,值为该订单的发票信息列表 | 
json展示:
①状态为开票中的返回
{"invoicingStatus": "0","promptMsg": "努力开票中,长时间未成功开票请求联系客服人员","invoiceRecordOutDtoList": null}
②状态为开票失败的返回
用户信息填写错误:
{"invoicingStatus": "1","promptMsg": "购货方纳税号不合法!","invoiceRecordOutDtoList": null}
系统错误:
{"invoicingStatus": "1","promptMsg": "发票业务异常,请联系客服人员","invoiceRecordOutDtoList": null}
③开票成功返回:
 电子票:
{"invoicingStatus": "2","promptMsg": null,"invoiceRecordOutDtoList": [{"invoiceSerialNo": "发票流水号","invoiceNo": "发票号","invoiceCode": "发票代码","invoiceUrl": "发票url","invoiceStatus": "发票状态 0:未请求 1:请求未响应 2:开具失败 3:已开具 4:已下载"},{"invoiceSerialNo": "MALL76666666666666489mu7mba","invoiceNo": "05572754","invoiceCode": "150000020026","invoiceUrl": "http://218.2.192.212:9000/aisino_cms/testpdf/150300201007206301/2020/09/24/4/MALL76666666666666489mu7mba_1600999827927.pdf","invoiceStatus": "4"},........]}
纸质票:
{"invoicingStatus": "2","promptMsg": null,"invoiceRecordOutDtoList": [{"invoiceSerialNo": null,"invoiceNo": "6568658","invoiceCode": null,"invoiceUrl": null,"invoiceStatus": "4"}]}
3.电子发票购货方信息修改接口
作用:发票开具失败,若是用户信息填写错误,允许其重新回填自己的开票信息
3.1入参
| 字段 | 必填? | 说明 | 
|---|---|---|
| orderSource | 是 | 订单来源:1:电商 2:全员 3:X6 | 
| orderNo | 是 | 订单号 | 
| buyerInfoInDto | 是 | 购货方信息 | 
json:
{"orderSource":"订单来源","orderNo":"订单号","buyerInfoInDto": {*"name": "开票名称(个人名称或公司名称)",*"taxpayerId": "公司税号",*"phone": "开票方手机号","address": "开票方公司地址","fixedTel": "开票方公司固定电话","email": "开票方邮箱","bankInfo": "开票方银行信息(格式:'xxxxx行 12xxx223')",*"enterpriseType": "企业类型:01:企业 02:.. 03:..."}}
3.2出参
| 出参 | 说明 | 
|---|---|
| true | 修改成功 | 
| false | 修改失败 | 
4.电子发票手动开具下载接口
作用:当一个订单中存在未下载的发票,用户点击下载按钮,可以手动调用发票接口进行发票的开具和下载
4.1入参
| 字段 | 必填? | 说明 | 
|---|---|---|
| invoiceSerialNo | 是 | 发票流水号:此接口一定是在第2个接口调用完后才可以被调用的,此时字段已获取到 | 
4.2出参
| 字段 | 一定存在? | 说明 | 
|---|---|---|
| returnCode | 是 | 返回码 | 
| returnMsg | 是 | 与返回码的对应关系:0:下载发票失败,请联系管理员 1:已开具成功,发票链接准备中请稍后重试 2:下载成功 | 
| invoiceRecordOutDto | 否 | 发票单信息 | 
json:
{"returnCode": "2","returnMsg": "下载成功","invoiceRecordOutDto": {"invoiceSerialNo": "MALL76666666666666489li2udo","invoiceNo": "05572775","invoiceCode": "150000020026","invoiceUrl": "http://218.2.192.212:9000/aisino_cms/testpdf/150300201007206301/2020/09/24/5/MALL76666666666666489li2udo_1601017828770.pdf","invoiceStatus": "4"}}
5.电子发票红冲接口
5.1入参
| 字段 | 必填 | 说明 | 
|---|---|---|
| orderSource | 是 | 订单来源 | 
| orderNo | 是 | 订单号 | 
| invoiceNo | 是 | 发票单号 | 
5.2出参
| 出参 | 说明 | 
|---|---|
| true | 红冲请求成功 | 
| false | 红冲请求失败 | 
6.纸质发票回填接口
6.1入参
| 字段 | 必填 | 说明 | 
|---|---|---|
| orderSource | 是 | 订单来源 | 
| orderNo | 是 | 订单号 | 
| invoiceNo | 是 | 发票单号 | 
6.2出参
| 出参 | 说明 | 
|---|---|
| true | 回填成功 | 
| false | 回填失败 | 
