1.常规接口

1.发票单列表获取

1.1入参

字段 说明 是否必填
invoiceFrom 发票申请来源:1:电商2:全员营销 3:X6
applyId 发票申请编号

1.2出参

  1. {
  2. "code": 200,
  3. "msg": null,
  4. "data": {
  5. "invoiceRecordOutDtoList": [
  6. {
  7. "invoiceSerialNo": "发票流水号",
  8. "invoiceNo": "发票号",
  9. "invoiceCode": "发票代码",
  10. "invoiceUrl": "发票链接",
  11. "invoiceStatus": "发票状态:1:未开票 2:已开票 3:已下载"
  12. }
  13. ]
  14. }
  15. }

2.电子发票手动下载

2.1入参

字段 说明 是否必填
invoiceSerialNo 发票流水号

2.2出参

成功的情况

  1. {
  2. "code": 200,
  3. "msg": null,
  4. "data": {
  5. "invoiceRecordOutDto": {
  6. "invoiceSerialNo": "发票流水号",
  7. "invoiceNo": "发票号",
  8. "invoiceCode": "发票代码",
  9. "invoiceUrl": "发票地址",
  10. "invoiceStatus": "发票状态:1:未开票 2:已开票 3:已下载"
  11. }
  12. }
  13. }

失败的情况

  1. #流水号有误
  2. {
  3. "code": 501,
  4. "msg": "发票流水号有误,无发票信息",
  5. "data": null
  6. }
  7. #未开具不可下载
  8. {
  9. "code": 501,
  10. "msg": "发票未开具成功,无法下载",
  11. "data": null
  12. }
  13. #未下载成功
  14. {
  15. "code": 501,
  16. "msg": "发票下载链接努力准备中,请稍后重试",
  17. "data": null
  18. }

3.发票红冲

3.1入参

  1. {
  2. "invoiceFrom":"发票来源:1:电商 2:全员营销 3:X6",
  3. "applyId":"发票申请编号",
  4. "invoiceNo":"发票号",
  5. "invoiceOrderDetailInDtoList": [{
  6. *"id":"订单明细编号"
  7. *"name": "商品名称",
  8. "unit": "商品单位",
  9. "specificationModel": "商品规格型号",
  10. *"num": "数量",
  11. *"price": "单价",
  12. *"taxCode": "商品税码",
  13. *"amount": "商品明细小计"
  14. },....],
  15. "buyerInfoInDto": {
  16. *"name": "开票名称(个人名称或公司名称)",
  17. *"taxpayerId": "公司税号",
  18. *"phone": "开票方手机号",
  19. "address": "开票方公司地址",
  20. "fixedTel": "开票方公司固定电话",
  21. "email": "开票方邮箱",
  22. "bankInfoAddress":"开票方银行地址信息",
  23. "bankInfoAccount":"开票方银行账号信息",
  24. *"enterpriseType": "企业类型:01:企业 02:.. 03:..."
  25. }
  26. }

3.2出参

成功返回

  1. {
  2. "code": 200,
  3. "msg": null,
  4. "data": null
  5. }

错误返回

  1. {
  2. "code": 501,
  3. "msg": "发票信息不存在",
  4. "data": null
  5. }
  6. {
  7. "code": 501,
  8. "msg": "发票暂未开具成功,无法红冲",
  9. "data": null
  10. }
  11. {
  12. "code": 501,
  13. "msg": "发票已经被红冲",
  14. "data": null
  15. }

4.纸质发票单号回填

4.1入参

字段 说明 是否必填
invoiceFrom 发票来源
orderNo 订单号
applyId 发票申请编号
invoiceNo 发票单号

4.2出参

成功返回

  1. {
  2. "code": 200,
  3. "msg": null,
  4. "data": null
  5. }

失败返回

  1. {
  2. "code": 501,
  3. "msg": "发票号重复",
  4. "data": null
  5. }

2.队列消费者接口

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. *"id":"订单明细编号",
  13. *"name": "商品名称",
  14. "unit": "商品单位",
  15. "specificationModel": "商品规格型号",
  16. *"num": "数量",
  17. *"price": "单价",
  18. *"taxCode": "商品税码",
  19. *"amount": "商品明细小计"
  20. },....],
  21. "buyerInfoInDto": {
  22. *"name": "开票名称(个人名称或公司名称)",
  23. *"taxpayerId": "公司税号",
  24. *"phone": "开票方手机号",
  25. "address": "开票方公司地址",
  26. "fixedTel": "开票方公司固定电话",
  27. "email": "开票方邮箱",
  28. "bankInfoAddress":"开票方银行地址信息",
  29. "bankInfoAccount":"开票方银行账号信息",
  30. *"enterpriseType": "企业类型:01:企业 02:.. 03:..."
  31. }
  32. }

1.2出参(放入响应队列中)

字段 说明 一定存在?
returnCode 响应码:
1:开具成功
2:购货方信息错误
3:发票业务异常,请联系客服人员
returnMsg 开具成功
购货方信息错误
发票业务异常,请联系客服人员
applyId 发票申请编号

2.发票下载

2.1入参(放入下载队列)

字段 说明 必填
invoiceSerialNo 发票流水号

2.2出参