概述
平台销项服务提供发票开具、发票信息下载、发票信息邮箱推送等功能。
流程图
sequenceDiagram
participant S as 销售方
participant N as 诺e票
participant C as 消费者
S-->>+N:请求：发票开具
N->>N:发票开具处理
N-->>-S:响应：发票开具
alt 存在邮箱或手机
N->>C: 发票信息推送
else 不存在邮箱或手机
note over N,C:通过邮箱发送接口推送
end
opt 推送地址
N-->>S:请求：发票信息推送
S-->>N:响应：发票信息推送
end
S-->>N:请求：发票信息下载
N-->>S:响应：发票信息下载
S->>N:请求：邮箱推送
N->>C:推送发票信息
S-->>N:请求：邮箱推送结果查询
N-->>S:响应：邮箱推送结果查询
通用报文
<?xml version="1.0" encoding="utf-8"?>
<interface
xmlns=""
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:B/S请求来源;1:C/S请求来源)</terminalCode>
<appId>DZFP</appId>
<version>API版本</version>
<interfaceCode>API编码</interfaceCode>
<userName>平台编码</userName>
<passWord/>
<taxpayerId>纳税人识别号</taxpayerId>
<authorizationCode>接入系统平台授权码（由平台提供）</authorizationCode>
<requestCode>数据交换请求发出方代码</requestCode>
<requestTime>数据交换请求发出时间</requestTime>
<responseCode>数据交换请求接受方代码</responseCode>
<dataExchangeId>数据交换流水号</dataExchangeId>
</globalInfo>
<returnStateInfo>
<returnCode>返回代码</returnCode>
<returnMessage>base64返回描述</returnMessage>
</returnStateInfo>
<Data>
<dataDescription>
<zipCode>0,1</zipCode> (0,1根据数据包大小判断是否进行压缩)
<encryptCode>1,2,3</encryptCode>
<codeType>3DES,CA,SMS</codeType>
</dataDescription>
<content>base64请求数据内容或返回数据内容</content>
</Data>
</interface>
字段说明
| 数据项 | 名称 | 类型 | 长度 | 必填 | 说明 |
|---|---|---|---|---|---|
| globalInfo | 全局信息 | 是 | |||
| terminalCode | 终端标识 | varchar | 1 | 是 | 0：B/S请求来源 1：C/S请求来源 |
| appId | 应用标识 | varchar | 4 | 是 | DZFP：普通发票 ZZS_PT_DZFP：增值税普通电子发票 QDFP：数电发票 |
| version | API版本 | varchar | 4 | 是 | API版本，当前为1.1。 |
| interfaceCode | API编码 | varchar | 50 | 是 | 详见：1.0 销项服务API列表 |
| userName | 平台编码 | varchar | 8 | 是 | 由诺e票平台提供，生产环境详见《交付表》。 |
| passWord | 密码 | varchar | 50 | 否 | 由诺e票平台提供，可传空。 |
| requestCode | 数据交换请求发起方代码 | varchar | 8 | 是 | 同userName |
| requestTime | 数据交换请求发出时间 | varchar | 19 | 是 | 格式：YYYY-MM-DD HH:MI:SS SS |
| taxpayerId | 纳税人识别号 | varchar | 20 | 是 | 销方纳税人识别号，测试环境由诺e票平台提供。 |
| authorizationCode | 纳税人授权码 | varchar | 10 | 是 | 由诺e票平台提供，生产环境详见《交付表》。 |
| responseCode | 数据交换请求接受方代码 | varchar | 3 | 是 | 默认值：121。 |
| dataExchangeId | 数据交换流水号 | varchar | 50 | 是 | 唯一值，格式：requestCode+8位日期(yyyyMMdd)+9位序列号 |
| returnStateInfo | 数据交换请求返回状态信息 | 是 | |||
| returnCode | 返回代码 | varchar | 4 | 是 | 0000为成功，其他为错误。 |
| returnMessage | 返回描述 | varchar | 是 | 0000返回成功、其他返回错误描述，base64编码。 | |
| dataDescription | 交换数据属性 | 是 | |||
| zipCode | 压缩标识 | varchar | 1 | 是 | 0：不压缩 1：压缩（用 GZip 压缩） 数据包大于10k要求自动压缩，平台返回时压缩标志为1时企业需要自行解压缩。 |
| encryptCode | 加密标识 | varchar | 1 | 是 | 1：3DES 2：CA 3：SMS4 生产环境要求必须加密。 |
| codeType | 加密方式描述 | varchar | 10 | 否 | 根据encryptCode的不同分别为3DES加密 、CA加密、SMS4加密。 |
| content | 数据包 | varchar | 是 | 根据interfaceCode的不同，为对应的加密后的业务报文 加密流程： BASE64.encode(GZIP压缩(CA加密(xml明文))) 解密流程：CA解密(GZIP解压缩(BASE64.decode(xml密文))) 加、解密过程中，是否解压缩与CA加解密，参照dataDescription中的zipCode与encryptCode。 |