1.电子发票申请接口

作用:用于接收电子发票的开票订单信息、订单明细和开票人相关的信息

1.1入参

说明:用 * 标记的为必填字段

  1. {
  2. "invoiceOrderInfoInDto": {
  3. *"orderNo": "订单号",
  4. *"orderSource": "订单来源:1:电商 2:全员营销 3:X6",
  5. *"totalAmount": "订单总金额",
  6. *"orderIssuer": "发票开票人姓名",
  7. "orderPayee": "发票收款人姓名",
  8. "orderReviewer": "发票复核人姓名",
  9. *"invoiceConfigId": "配置编号"
  10. },
  11. "invoiceOrderDetailInDtoList": [{
  12. *"name": "商品名称",
  13. "unit": "商品单位",
  14. "specificationModel": "商品规格型号",
  15. *"num": "数量",
  16. *"taxIncludedLogo": "含税标志",
  17. *"price": "单价",
  18. *"taxCode": "商品税码",
  19. *"discountLogo": "优惠标识",
  20. *"zeroTaxLogo": "零税率标识",
  21. *"vatManage": "增值税特殊管理",
  22. *"taxRate": "税率(小数:如 0.09)",
  23. *"amount": "商品明细小计"
  24. },....],
  25. "buyerInfoInDto": {
  26. *"name": "开票名称(个人名称或公司名称)",
  27. *"taxpayerId": "公司税号",
  28. *"phone": "开票方手机号",
  29. "address": "开票方公司地址",
  30. "fixedTel": "开票方公司固定电话",
  31. "email": "开票方邮箱",
  32. "bankInfo": "开票方银行信息(格式:'xxxxx行 12xxx223')",
  33. *"enterpriseType": "企业类型:01:企业 02:.. 03:..."
  34. }
  35. }

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展示:
①状态为开票中的返回

  1. {
  2. "invoicingStatus": "0",
  3. "promptMsg": "努力开票中,长时间未成功开票请求联系客服人员",
  4. "invoiceRecordOutDtoList": null
  5. }

②状态为开票失败的返回
用户信息填写错误:

  1. {
  2. "invoicingStatus": "1",
  3. "promptMsg": "购货方纳税号不合法!",
  4. "invoiceRecordOutDtoList": null
  5. }

系统错误:

  1. {
  2. "invoicingStatus": "1",
  3. "promptMsg": "发票业务异常,请联系客服人员",
  4. "invoiceRecordOutDtoList": null
  5. }

③开票成功返回:
电子票:

  1. {
  2. "invoicingStatus": "2",
  3. "promptMsg": null,
  4. "invoiceRecordOutDtoList": [
  5. {
  6. "invoiceSerialNo": "发票流水号",
  7. "invoiceNo": "发票号",
  8. "invoiceCode": "发票代码",
  9. "invoiceUrl": "发票url",
  10. "invoiceStatus": "发票状态 0:未请求 1:请求未响应 2:开具失败 3:已开具 4:已下载"
  11. },
  12. {
  13. "invoiceSerialNo": "MALL76666666666666489mu7mba",
  14. "invoiceNo": "05572754",
  15. "invoiceCode": "150000020026",
  16. "invoiceUrl": "http://218.2.192.212:9000/aisino_cms/testpdf/150300201007206301/2020/09/24/4/MALL76666666666666489mu7mba_1600999827927.pdf",
  17. "invoiceStatus": "4"
  18. },
  19. ........
  20. ]
  21. }

纸质票:

  1. {
  2. "invoicingStatus": "2",
  3. "promptMsg": null,
  4. "invoiceRecordOutDtoList": [
  5. {
  6. "invoiceSerialNo": null,
  7. "invoiceNo": "6568658",
  8. "invoiceCode": null,
  9. "invoiceUrl": null,
  10. "invoiceStatus": "4"
  11. }
  12. ]
  13. }

3.电子发票购货方信息修改接口

作用:发票开具失败,若是用户信息填写错误,允许其重新回填自己的开票信息

3.1入参

字段 必填? 说明
orderSource 订单来源:1:电商 2:全员 3:X6
orderNo 订单号
buyerInfoInDto 购货方信息

json:

  1. {
  2. "orderSource":"订单来源",
  3. "orderNo":"订单号",
  4. "buyerInfoInDto": {
  5. *"name": "开票名称(个人名称或公司名称)",
  6. *"taxpayerId": "公司税号",
  7. *"phone": "开票方手机号",
  8. "address": "开票方公司地址",
  9. "fixedTel": "开票方公司固定电话",
  10. "email": "开票方邮箱",
  11. "bankInfo": "开票方银行信息(格式:'xxxxx行 12xxx223')",
  12. *"enterpriseType": "企业类型:01:企业 02:.. 03:..."
  13. }
  14. }

3.2出参

出参 说明
true 修改成功
false 修改失败

4.电子发票手动开具下载接口

作用:当一个订单中存在未下载的发票,用户点击下载按钮,可以手动调用发票接口进行发票的开具和下载

4.1入参

字段 必填? 说明
invoiceSerialNo 发票流水号:此接口一定是在第2个接口调用完后才可以被调用的,此时字段已获取到

4.2出参

字段 一定存在? 说明
returnCode 返回码
returnMsg 与返回码的对应关系:0:下载发票失败,请联系管理员 1:已开具成功,发票链接准备中请稍后重试 2:下载成功
invoiceRecordOutDto 发票单信息

json:

  1. {
  2. "returnCode": "2",
  3. "returnMsg": "下载成功",
  4. "invoiceRecordOutDto": {
  5. "invoiceSerialNo": "MALL76666666666666489li2udo",
  6. "invoiceNo": "05572775",
  7. "invoiceCode": "150000020026",
  8. "invoiceUrl": "http://218.2.192.212:9000/aisino_cms/testpdf/150300201007206301/2020/09/24/5/MALL76666666666666489li2udo_1601017828770.pdf",
  9. "invoiceStatus": "4"
  10. }
  11. }

5.电子发票红冲接口

作用:用于红冲开错的发票单

5.1入参

字段 必填 说明
orderSource 订单来源
orderNo 订单号
invoiceNo 发票单号

5.2出参

出参 说明
true 红冲请求成功
false 红冲请求失败

6.纸质发票回填接口

作用:保存纸质发票单信息

6.1入参

字段 必填 说明
orderSource 订单来源
orderNo 订单号
invoiceNo 发票单号

6.2出参

出参 说明
true 回填成功
false 回填失败