概述
消费者通过扫描销货方(商户)提供的二维码,进行发票信息填写与开具。
时序图
sequenceDiagram
participant S as 销售方
participant N as 诺e票
participant C as 消费者
S->>C:生成二维码
C-->>N:扫描二维码
N-->>C:开票H5页面
C-->>N:发票信息填写并开票
N-->>C:开票结果展示
二维码规范
二维码内容需要按照规定的格式进行组织,格式:url?bm=编码&mw=密文
参数说明
字段 | 名称 | 说明 |
---|---|---|
url | url | 包含域名、端口等的二维码链接的公共组成部分 测试环境:http://122.112.255.28:15007/app/pdf/proUrl |
bm | 编码 | 企业唯一标识,由诺e票平台提供。 |
mw | 密文 | 对订单信息的明文内容进行加密并Base64编码后的内容。 |
订单信息
订单信息需要按照规定的格式进行组织。
格式:税号;开票点编码;发票请求流水号;订单号;订单日期;商品编码,数量,金额(含税)* 商品编码,数量,金额(含税);备注;数电标志。
各数据项之间以”;“分隔,每条明细项包含:商品编码、数量、金额(含税),且以”,“分隔,支持多明细,多明细行以”*“分隔。
明文部分必须加密且Base64编码,支持3DES或者AES加密。
当订单信息存在折扣行时,折扣行必须紧邻被折扣行之后,商品编码与被折扣行商品编码保持一致,被折扣行不支持多行折扣,折扣行与被折扣行金额之和不小于0。
字段说明
字段 | 类型 | 长度 | 必须 | 说明 |
---|---|---|---|---|
税号 | varchar | 20 | 是 | 销售方纳税人识别号 |
开票点编码 | varchar | 20 | 否 | 门店编号,该项对应的”;“不可省略。 |
发票请求流水号 | varchar | 50 | 是 | 发票开具的唯一标识,不可重复。 |
订单号 | varchar | 50 | 是 | 销售方业务系统对于一笔订单的交易编号。 |
订单日期 | varchar | 19 | 是 | 格式:yyyy-MM-dd HH:mm:ss |
明细信息 | List | 是 | 每项包含商品编码、数量、金额(含税) | |
商品编码 | varchar | 30 | 是 | 预先维护在诺e票平台的商品唯一标识 |
数量 | number | 4 | 是 | 商品的数量(正数) |
金额(含税) | number | 18,2 | 是 | 该条明细的含税金额,单位:元。 |
备注 | varchar | 否 | 当数电标志不为空时,该项对应的”;“不可省略。 | |
数电标志 | varchar | 否 | 61:数电专票 62:数电普票 |