电子发票邮件再推送

一、概述

1.1 业务介绍

此接口主要用于开票企业调用百望邮箱服务器进行已开具完成的电子发票邮件发送，商 家可根据消费者开具的电子发票，进行二次发送邮件请求，可以由商家发起，也可以由消费 者发起。邮件模板内容如下(不可改):

1.2 目的

此文档为开票企业调用百望邮箱服务器进行已开具完成的电子发票邮件发送接入技术 规范，第三方按此文档就接口内容、接口格式、交互模式等技术达成一致，并以此进行对接 程序的开发。对第三方开发、实现技术和实现方式等均无要求，由第三方自行决定，但需要 满足此文档的技术接入规范。

应业务要求，业务过程中涉及到的两个系统之间的数据交互方式及交互内容进行规范， 制定统一的协议，形成技术文档。

1.3 接入方式

接入主要采取 Oauth2.0 接入技术规范，认证成功后发票通平台提供相关服务业务功能， 业务参数和报文基于 XML/JSON 报文格式，采用 http 或 https 方式。

1、XML 格式规范

请求规范(HEAD 节点中的子节点根据实际业务自定义):

XML 格式返回报文

<?xml version="1.0" encoding="utf-8"?>
<REQUEST>
  <HEAD></HEAD>
  <BODY></BODY> 
</REQUEST>

响应规范:

<?xml version="1.0" encoding="utf-8"?>
<ROOT>
  <HEAD>
    <SERVICE>
      <REPLYCODE>0</REPLYCODE>
      <REPLYMSG>success</REPLYMSG> 
    </SERVICE>
  </HEAD>
  <BODY></BODY>
</ROOT>

2、JSON 格式规范

请求规范(HEAD 节点中的子节点根据实际业务自定义):

{
  "REQUEST": {
    "HEAD": {
    }, 
    "BODY": {
    } 
  }
}

响应规范:

{
  "ROOT": {
    "HEAD": {
      "SERVICE": {
        "REPLYCODE": "0",
        "REPLYMSG": "success"
      }
    }, 
    "BODY": {
    } 
  }
}

1.4 接入流程图

接入流程图
OAuth 2.0 认证流程

术语

注意:对 client_id 和 client_secret 信息进行保密，不要随意泄漏。

二、业务接口说明

1、企业第三方邮件推送接口服务

1.1、请求报文

接口说明:用于企业给自己用户再次推送电子发票邮件接口服务

调用方式:HTTPS 请求方式 POST 请求

测试环境 URL: https://IP:PORT/Entoauth/thirdApi?sign=send&client_id=应用 ID&access_token=访问 Token&openID=&sqm=授权码&busiType=SQM_YJFS&data=报文数据(Base64 过后的数据)&dataType=data 报 文数据类型(0:json/1:xml)

正式环境 URL: https://IP:PORT/Entoauth/thirdApi?sign=send&client_id=应用 ID&access_token=访问 Token&openID=&sqm=&busiType=SQM_YJFS&data=报文数据(Base64 过后的数据)&dataType=data 报文数据 类型(0:json/1:xml)

参数说明

序号 参数 含义
参数 1 client_id 应用 ID
参数 2 access_token 二.1 接口获取到
参数 3 openID 二.2 接口获取到
参数 4 sqm 企业邮件发送授权码
参数 5 busiType 固定值 SQM_KPJL
参数 6 data 报文数据(Base64 编码)
参数 7 dataType data 报文数据类型(0:json/1:xml)

data 不同格式报文数据样例:

XML 格式数据:

<REQUEST>
  <HEAD> 
    <NSRSBH>开发者平台注册时填写的纳税人识别号</NSRSBH>
  </HEAD> 
  <BODY>
    <XSF_NSRSBH>发票销售方纳税人识别号</XSF_NSRSBH> 
    <JYM>发票校验码</JYM>
    <FPDM>发票代码</FPDM>
    <FPHM>发票号码</FPHM> 
    <EMAIL>接收者邮箱</EMAIL>
  </BODY> 
</REQUEST>

JSON 格式数据:

{
  "REQUEST": {
    "HEAD": {"NSRSBH":"开发者平台注册时填写的纳税人识别号"},
    "BODY": {"XSF_NSRSBH":"销售方纳税人识别号","JYM":"发票校验码","FPDM":"发票
              代码","FPHM":"发票号码","EMAIL":"接收者邮箱"
    } 
  }
}

请求参数:

序号 字段 名称 长度 必须 说明
1 client_id 应用 ID 是 应用 ID
2 access_token 访问 Token 是 二.1 接口获取
3 openID 是 二.2 接口获取到的
4 sqm 企业邮件发送授权码 是 在开发者平台进行申请
5 dataType 报文数据类型 是 0:json, 1:xml
6 busiType 业务类型 是 SQM_YJFS: 表示企业邮件发送业务
7 data Json/xml 格式 业务报文 是 需要进行 Base64 编码
8 NSRSBH 开发者平台注册时填写的纳税人识别号 是 开发者平台注册时填写的纳税人识别号
9 XSF_NSRSBH 发票销售方纳税人识别号 是 发票销售方纳税人识别号
10 JYM 发票校验码 是
11 FPDM 发票代码 是
12 FPHM 发票号码 是
13 EMAIL 接收者邮箱 是

1.2、返回报文

XML 格式返回报文

<ROOT>
  <HEAD> 
  	<SERVICE>
      <REPLYCODE>0000</REPLYCODE>
      <REPLYMSG>success</REPLYMSG> 
    </SERVICE>
  </HEAD> 
  <BODY>
    <TTQQLSH>抬头请求流水号</TTQQLSH> 
  </BODY>
</ROOT>

JSON 格式返回报文

{
  "head": { 
    "service": {
      "replyCode": "0000",
      "replyMsg": "success" 
    }
  }, 
  "body": {
  }
}

返回参数说明

序号 字段 名称 长度 必须 说明
1 REPLYCODE 返回代码 是 0000 为成功,其它为失败
2 REPLYMSG 返回信息 否 详细信息描述