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 | 回填失败 |