邮箱发送API
API说明：将受票方(购货方)的邮箱推送给电子发票服务平台，平台可通过邮箱把发票信息推送给受票方
调用方式：HTTP协议
API编码：ECXML.EMAILPHONEFPTS.TS.E.INV
调用方法：POST(XML文件流)
请求报文规范
<REQUEST_EMAILPHONEFPTS class="REQUEST_EMAILPHONEFPTS">
<TSFSXX class="TSFSXX">
<COMMON_NODES class="COMMON_NODE;" size="4">
<COMMON_NODE>
<NAME>TSFS</NAME>
<VALUE>推送方式</VALUE>
</COMMON_NODE>
<COMMON_NODE>
<NAME>SJ</NAME>
<VALUE>手机</VALUE>
</COMMON_NODE>
<COMMON_NODE>
<NAME>EMAIL</NAME>
<VALUE>邮箱</VALUE>
</COMMON_NODE>
<COMMON_NODE>
<NAME>扩展字段名称</NAME>
<VALUE>扩展字段值</VALUE>
</COMMON_NODE>
</COMMON_NODES>
</TSFSXX>
<FPXXS class="FPXX;" size="1">
<FPXX>
<COMMON_NODES class="COMMON_NODE;" size="5">
<COMMON_NODE>
<NAME>FPQQLSH</NAME>
<VALUE>发票请求唯一流水号</VALUE>
</COMMON_NODE>
<COMMON_NODE>
<NAME>NSRSBH</NAME>
<VALUE>开票方识别号</VALUE>
</COMMON_NODE>
<COMMON_NODE>
<NAME>FP_DM</NAME>
<VALUE>发票代码</VALUE>
</COMMON_NODE>
<COMMON_NODE>
<NAME>FP_HM</NAME>
<VALUE>发票号码</VALUE>
</COMMON_NODE>
<COMMON_NODE>
<NAME>扩展字段名称</NAME>
<VALUE>扩展字段值</VALUE>
</COMMON_NODE>
</COMMON_NODES>
</FPXX>
</FPXXS>
</REQUEST_EMAILPHONEFPTS>
字段说明
| 数据项 | 名称 | 类型 | 长度 | 必须 | 说明 |
|---|---|---|---|---|---|
| TSFS | 推送方式 | varchar | 20 | 是 | 0-邮箱推送， 若填写了正确的手机号码，手机端也会推送 |
| SJ | 手机 | varchar | 15 | 否 | |
| 邮箱 | varchar | 50 | 是 | ||
| 扩展字段 | 扩展字段名称 | varchar | 不定 | 否 | |
| FPXX | 发票信息 | ||||
| FPQQLSH | 发票请求流水号 | varchar | 50 | 是 | |
| NSRSBH | 开票方识别号 | varchar | 20 | 是 | |
| FP_DM | 发票代码 | varchar | 12 | 是 | |
| FP_HM | 发票号码 | varchar | 8 | 是 | |
| 扩展字段 | 扩展字段名称 | varchar | 不定 | 是 |
返回报文规范
<RESPONSE_EMAILPHONEFPTS class="RESPONSE_EMAILPHONEFPTS">
<COMMON_NODES class="COMMON_NODE;" size="2">
<COMMON_NODE>
<NAME>FPTSLSH</NAME>
<VALUE>发票推送流水号</VALUE>
</COMMON_NODE>
<COMMON_NODE>
<NAME>扩展字段名称</NAME>
<VALUE>扩展字段值</VALUE>
</COMMON_NODE>
</COMMON_NODES>
</RESPONSE_EMAILPHONEFPTS>
字段说明
| 数据项 | 名称 | 类型 | 长度 | 必须 | 说明 |
|---|---|---|---|---|---|
| FPTSLSH | 发票推送流水号 | varchar | 50 | 是 | 电子发票服务平台为每个发票推送请求分配一个唯一流水号。 |
| 扩展字段 | 扩展字段名称 | varchar | 不定 | 否 |
示例报文
请求报文示例
<?xml version='1.0' encoding='utf-8'?>
<interface
xmlns:xsi='http://www.w3.org/2001/XMLSchema-instance'
xsi:schemaLocation='http://www.chinatax.gov.cn/tirip/dataspec/interfaces.xsd'
version='DZFP1.0'>
<globalInfo>
<terminalCode>0</terminalCode>
<appId>ZZS_PT_DZFP</appId>
<version>2.0</version>
<interfaceCode>ECXML.EMAILPHONEFPTS.TS.E.INV</interfaceCode>
<requestCode>P1000001</requestCode>
<requestTime>2019-04-18 10:30:42</requestTime>
<responseCode>121</responseCode>
<dataExchangeId>P100000120160801000000001</dataExchangeId>
<userName>P1000001</userName>
<passWord />
<taxpayerId>913101010000000090</taxpayerId>
<authorizationCode>NH873FG4KW</authorizationCode>
</globalInfo>
<returnStateInfo>
<returnCode />
<returnMessage />
</returnStateInfo>
<Data>
<dataDescription>
<zipCode>0</zipCode>
<encryptCode>1</encryptCode>
<codeType>3DES</codeType>
</dataDescription>
<content>
<REQUEST_EMAILPHONEFPTS class="REQUEST_EMAILPHONEFPTS">
<TSFSXX class='TSFSXX'>
<COMMON_NODES class='COMMON_NODE;' size='3'>
<COMMON_NODE>
<NAME>TSFS</NAME>
<VALUE>0</VALUE>
</COMMON_NODE>
<COMMON_NODE>
<NAME>EMAIL</NAME>
<VALUE>test_001@qq.com</VALUE>
</COMMON_NODE>
<COMMON_NODE>
<NAME>SJ</NAME>
<VALUE>17612163812</VALUE>
</COMMON_NODE>
</COMMON_NODES>
</TSFSXX>
<FPXXS class='FPXX;' size='1'>
<FPXX>
<COMMON_NODES class='COMMON_NODE;' size='4'>
<COMMON_NODE>
<NAME>FPQQLSH</NAME>
<VALUE>P1000001test_000000001</VALUE>
</COMMON_NODE>
<COMMON_NODE>
<NAME>NSRSBH</NAME>
<VALUE>913101010000000090</VALUE>
</COMMON_NODE>
<COMMON_NODE>
<NAME>FP_DM</NAME>
<VALUE>031001600211</VALUE>
</COMMON_NODE>
<COMMON_NODE>
<NAME>FP_HM</NAME>
<VALUE>21221340</VALUE>
</COMMON_NODE>
</COMMON_NODES>
</FPXX>
</FPXXS>
</REQUEST_EMAILPHONEFPTS>
</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.E.INV</interfaceCode>
<requestCode>P1000001</requestCode>
<requestTime>2019-04-18 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>6YKu5Lu25o6o6YCB5oiQ5Yqf</returnMessage>
</returnStateInfo>
<Data>
<dataDescription>
<zipCode>0</zipCode>
<encryptCode>1</encryptCode>
<codeType>3DES</codeType>
</dataDescription>
<content>
<RESPONSE_EMAILPHONEFPTS class="RESPONSE_EMAILPHONEFPTS">
<COMMON_NODES class="COMMON_NODE;" size="1">
<COMMON_NODE>
<NAME>FPTSLSH</NAME>
<VALUE>e685c63700934a47bc4db2996562ec7a</VALUE>
</COMMON_NODE>
</COMMON_NODES>
</RESPONSE_EMAILPHONEFPTS>
</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.E.INV</interfaceCode>
<requestCode>P1000001</requestCode>
<requestTime>2019-04-18 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>1</encryptCode>
<codeType>3DES</codeType>
</dataDescription>
<content/>
</Data>
</interface>