邮件发送结果查询API
API说明:邮件发送结果获取
调用方式:HTTP协议
API编码:ECXML.EMAILPHONEFPTS.TS.RESULT
调用方法:POST(XML文件流)
请求报文规范
<REQUEST_EMAILPHONEFPTS_RESULT class="REQUEST_EMAILPHONEFPTS_RESULT">
<FPQQLSH>发票请求唯一流水号</FPQQLSH>
<NSRSBH>开票方识别号</NSRSBH>
<FP_DM>发票代码</FP_DM>
<FP_HM>发票号码</FP_HM>
<TSFS>推送方式</TSFS>
<TSDZ>推送地址</TSDZ>
</REQUEST_EMAILPHONEFPTS_RESULT>
字段说明
数据项 | 名称 | 类型 | 长度 | 必须 | 说明 |
---|---|---|---|---|---|
FPQQLSH | 发票请求唯一流水号 | varchar | 50 | 是 | 开票时的发票请求流水号 |
NSRSBH | 开票方识别号 | varchar | 20 | 是 | |
FP_DM | 发票代码 | varchar | 12 | 是 | |
FP_HM | 发票号码 | varchar | 8 | 是 | |
TSFS | 推送方式 | varchar | 1 | 是 | 0-邮箱推送 1-手机推送 |
TSDZ | 推送地址 | varchar | 50 | 是 | TSFS为0:填写邮箱号 TSFS为1:填写手机号 |
返回报文规范
<RESPONSE_EMAILPHONEFPTS_RESULT class="RESPONSE_EMAILPHONEFPTS_RESULT">
<FPQQLSH>发票请求唯一流水号</FPQQLSH>
<NSRSBH>开票方识别号</NSRSBH>
<FP_DM>发票代码</FP_DM>
<FP_HM>发票号码</FP_HM>
<TSFS>推送方式</TSFS>
<TSDZ>推送地址</TSDZ>
<RETURNCODE>结果代码</RETURNCODE>
<RETURNMESSAGE>结果描述</RETURNMESSAGE>
</RESPONSE_EMAILPHONEFPTS_RESULT>
字段说明
数据项 | 名称 | 类型 | 长度 | 必须 | 说明 |
---|---|---|---|---|---|
FPQQLSH | 发票请求唯一流水号 | varchar | 50 | 是 | 开票时的发票请求流水号 |
NSRSBH | 开票方识别号 | varchar | 20 | 是 | |
FP_DM | 发票代码 | varchar | 12 | 是 | |
FP_HM | 发票号码 | varchar | 8 | 是 | |
TSFS | 推送方式 | varchar | 1 | 是 | 0-邮箱推送 1-手机推送 |
TSDZ | 推送地址 | varchar | 50 | 是 | TSFS为0:填写邮箱号 TSFS为1:填写手机号 |
RETURNCODE | 结果代码 | varchar | 4 | 是 | 0000:邮件发送成功 9999:邮件发送失败 |
RETURNMESSAGE | 结果描述 | varchar | 128 | 否 | 错误原因 |
示例报文
请求报文示例
<?xml version="1.0" encoding="UTF-8"?>
<interface
xmlns:schemaLocation="http://www.chinatax.gov.cn/tirip/dataspec/interfaces.xsd"
xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" version="WLFP1.0">
<globalInfo>
<terminalCode>0</terminalCode>
<appId>ZZS_PT_DZFP</appId>
<version>2.0</version>
<interfaceCode>ECXML.EMAILPHONEFPTS.TS.RESULT</interfaceCode>
<requestCode>P1000001</requestCode>
<requestTime>2019-04-24 10:30:42</requestTime>
<responseCode>121</responseCode>
<dataExchangeId>P100000120160801000000001</dataExchangeId>
<userName>P1000001</userName>
<passWord />
<taxpayerId>913101010000000090</taxpayerId>
<authorizationCode>NH873FG4KW</authorizationCode>
</globalInfo>
<returnStateInfo>
<returnCode></returnCode>
<returnMessage></returnMessage>
</returnStateInfo>
<Data>
<dataDescription>
<zipCode>0</zipCode>
<encryptCode>1</encryptCode>
<codeType>3DES</codeType>
</dataDescription>
<content>
<REQUEST_EMAILPHONEFPTS_RESULT class="REQUEST_EMAILPHONEFPTS_RESULT">
<FPQQLSH>P1000001test_000000001</FPQQLSH>
<NSRSBH>913101010000000090</NSRSBH>
<FP_DM>031001600211</FP_DM>
<FP_HM>21221340</FP_HM>
<TSFS>0</TSFS>
<TSDZ>test_001@qq.com</TSDZ>
</REQUEST_EMAILPHONEFPTS_RESULT>
</content>
</Data>
</interface>
返回报文示例(成功)
<?xml version="1.0" encoding="UTF-8"?>
<interface
xmlns:schemaLocation="http://www.chinatax.gov.cn/tirip/dataspec/interfaces.xsd"
xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" version="WLFP1.0">
<globalInfo>
<terminalCode>0</terminalCode>
<appId>ZZS_PT_DZFP</appId>
<version>2.0</version>
<interfaceCode>ECXML.EMAILPHONEFPTS.TS.RESULT</interfaceCode>
<requestCode>P1000001</requestCode>
<requestTime>2019-04-24 10:30:42</requestTime>
<responseCode>121</responseCode>
<dataExchangeId>P100000120160801000000001</dataExchangeId>
<userName>P1000001</userName>
<passWord />
<taxpayerId>913101010000000090</taxpayerId>
<authorizationCode>NH873FG4KW</authorizationCode>
</globalInfo>
<returnStateInfo>
<returnCode>0000</returnCode>
<returnMessage />
</returnStateInfo>
<Data>
<dataDescription>
<zipCode>0</zipCode>
<encryptCode>1</encryptCode>
<codeType>3DES</codeType>
</dataDescription>
<content>
<RESPONSE_EMAILPHONEFPTS_RESULT class="RESPONSE_EMAILPHONEFPTS_RESULT">
<FPQQLSH>P1000001test_000000001</FPQQLSH>
<NSRSBH>913101010000000090</NSRSBH>
<FP_DM>031001600211</FP_DM>
<FP_HM>21221340</FP_HM>
<TSFS>0</TSFS>
<TSDZ>test_001@qq.com</TSDZ>
<RETURNCODE>0000</RETURNCODE>
<RETURNMESSAGE>发票交付成功</RETURNMESSAGE>
</RESPONSE_EMAILPHONEFPTS_RESULT>
</content>
</Data>
</interface>
返回报文示例(失败)
<?xml version="1.0" encoding="UTF-8"?>
<interface
xmlns:schemaLocation="http://www.chinatax.gov.cn/tirip/dataspec/interfaces.xsd"
xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" version="WLFP1.0">
<globalInfo>
<terminalCode>0</terminalCode>
<appId>ZZS_PT_DZFP</appId>
<version>2.0</version>
<interfaceCode>ECXML.EMAILPHONEFPTS.TS.RESULT</interfaceCode>
<requestCode>P1000001</requestCode>
<requestTime>2019-04-24 10:30:42</requestTime>
<responseCode>121</responseCode>
<dataExchangeId>P100000120160801000000001</dataExchangeId>
<userName>P1000001</userName>
<passWord />
<taxpayerId>913101010000000090</taxpayerId>
<authorizationCode>NH873FG4KW</authorizationCode>
</globalInfo>
<returnStateInfo>
<returnCode>9999(或者是其它错误码)</returnCode>
<returnMessage>Base64(错误信息)</returnMessage>
</returnStateInfo>
<Data>
<dataDescription>
<zipCode>0</zipCode>
<encryptCode/>
<codeType/>
</dataDescription>
<content/>
</Data>
</interface>