邮件发送结果查询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>
Copyright © Shanghai Aisino Co.,Ltd 版权所有 侵权必究该文件修订时间: 2025-03-31 16:08:29

results matching ""

    No results matching ""