概述
销货方（商户）将订单信息推送到诺e票的订单接受服务，获取一个包含开票链接的响应，销货方将此链接或者用其生成的二维码提供给消费者后，消费者进行发票开具。
时序图
sequenceDiagram
participant S as 销售方
participant N as 诺e票
participant C as 消费者
S-->>N:推送订单信息
N-->>S:包含开票链接的响应
S->>C:生成二维码
C-->>N:扫描二维码
N-->>C:开票H5页面
C-->>N:发票信息填写并开票
N-->>C:开票结果展示
接口说明
请求URL（测试环境）：http://122.112.255.28:15003/invoice/simpleScan
请求方式：HTTP Post
数据格式：plain
请求参数
请求参数是由企业标识（code）和加密后的订单信息（order）前后拼接而成的纯文本信息。
企业标识：由诺e票平台提供
加密方式：3DES
加密密钥：由诺e票平台提供
参数说明
| 数据项 | 名称 | 类型 | 长度 | 必填 | 说明 |
|---|---|---|---|---|---|
| code | 企业标识 | varchar | 6 | 是 | 企业唯一标识 |
| order | 订单信息密文 | varchar | 是 | 加密后的订单信息。 |
订单信息
请求规范
{
"kptype": "开票类型",
"orderno": "发票请求流水号",
"saletaxnum": "销方纳税人识别号",
"saleaddress": "销方地址",
"salephone": "销方电话",
"saleaccount": "销方银行、账号",
"clerk": "开票员",
"payee": "收款人",
"checker": "复核人",
"invoicedate": "订单日期",
"ordertotal": "价税合计金额",
"yfp_dm": "原发票代码",
"yfp_hm": "原发票号码",
"chyy": "冲红原因",
"bz": "备注",
"fjh": "分机号",
"lsh": "订单号",
"ver": "编码表版本号",
"cpy": "成品油标识",
"qdbz": "数电标志",
"tdys": "特定要素",
"detail": [
{
"hh": "行号",
"goodsname": "商品名称",
"spec": "规格型号",
"unit": "单位",
"hsbz": "含税标志",
"num": "数量",
"price": "单价",
"spbm": "税收分类编码",
"zxbm": "自行编码",
"yhzcbs": "优惠政策标识",
"lslbs": "零税率标识",
"zzstsgl": "增值税特殊管理",
"taxrate": "税率",
"xmje": "项目金额",
"se": "税额",
"zkje": "折扣金额",
"zkse": "折扣税额"
}
],
"bdczlList": [
{
"xh": "序号",
"bdczldzS": "不动产坐落地址（省）",
"bdczldzS1": "不动产坐落地址（市）",
"bdczldz": "不动产坐落地址（详细地址）",
"zlqq": "租赁期起",
"zlqz": "租赁期止",
"kdsbz": "跨地（市）标志",
"cqzsbh": "产权证书/不动产权证号",
"cph": "车牌号"
}
]
}
字段说明
| 数据项 | 名称 | 类型 | 长度 | 必填 | 说明 |
|---|---|---|---|---|---|
| kptype | 开票类型 | number | 1 | 是 | 1：蓝字发票 2：红字发票 暂不支持2：红字发票 |
| orderno | 发票请求流水号 | varchar | 50 | 是 | 发票开具的唯一标识，建议以企业标识开头。 |
| saletaxnum | 销售方纳税人识别号 | varchar | 20 | 是 | |
| saleaddress | 销方地址 | varchar | 80 | 是 | |
| salephone | 销方电话 | varchar | 20 | 是 | 电话必须为固定电话，其格式是：区号-号码，如：021-12345678 |
| saleaccount | 销方银行、账号 | varchar | 100 | 否 | qdbz为61或62时必传，且销方银行名称和账号以1个英文空格分隔。 |
| clerk | 开票员 | varchar | 8 | 是 | |
| payee | 收款人 | varchar | 8 | 否 | |
| checker | 复核人 | varchar | 8 | 否 | |
| invoicedate | 订单日期 | varchar | 19 | 是 | 格式：yyyy-MM-dd HH:mm:ss |
| ordertotal | 价税合计金额 | number | 18,2 | 是 | 单位：元。 |
| yfp_dm | 原发票代码 | varchar | 12 | 否 | kptype为2时必填。 |
| yfp_hm | 原发票号码 | varchar | 8 | 否 | kptype为2时必填。 |
| chyy | 冲红原因 | varchar | 200 | 否 | kptype为2时必填。 |
| bz | 备注 | varchar | 200 | 否 | |
| fjh | 分机号 | varchar | 10 | 否 | |
| lsh | 订单号 | varchar | 50 | 是 | 销售方业务系统对于一笔订单的交易编号。 |
| ver | 编码表版本号 | varchar | 20 | 否 | |
| cpy | 成品油标识 | varchar | 1 | 是 | 0：非成品油发票。 1：成品油发票 开具成品油发票需注意： ①、商品明细不可传成品油和非成品油混合项目； ②、成品油发票不可开清单发票，最多8行商品； ③、明细项单位必填，为“升”或者“吨”。 |
| qdbz | 发票类型 | varchar | 2 | 否 | 51：电子普票 4：电子专票 61：数电发票（增值税专用发票） 62：数电发票（增值税普通发票）。 为空时表示51：电子普票， tdys不为空时必填，且值为61或者62。 |
| tdys | 特定要素 | varchar | 2 | 否 | 06：不动产租赁服务发票 |
| detail | 项目明细 | List | 是 | ||
| hh | 行号 | number | 8 | 是 | 从1开始递增。 |
| goodsname | 商品名称 | varchar | 90 | 是 | tdys（特定要素）为06且spbm是3040502020200000000时，视为停车费业务，商品名称必须为“车辆停放服务”。 |
| spec | 规格型号 | varchar | 20 | 否 | |
| unit | 单位 | varchar | 20 | 否 | tdys为06时必填，单位只能是平方米、平方千米、公顷、亩、h㎡、k㎡、㎡，当spbm是3040502020200000000时，视为停车费业务，单位必须是“平方米”。 |
| hsbz | 含税标志 | number | 1 | 是 | 0：不含税 1：含税 表示单价、项目金额、折扣金额都含税与否。 |
| num | 数量 | number | 16,2 | 否 | tdys（特定要素）为6时必填，为租赁的不动产面积。 |
| price | 单价 | number | 18,2 | 否 | tdys（特定要素）为06时必填。 |
| spbm | 税收分类编码 | varchar | 19 | 是 | |
| zxbm | 自行编码 | varchar | 10 | 否 | |
| yhzcbs | 优惠政策标识 | varchar | 7 | 否 | 0：不使用； 1：使用。 为空表示不使用 lslbs为0、1或者2时，yhzcbs为1，lslbs为3时，yhzcbs为0。 |
| lslbs | 零税率标识 | varchar | 1 | 否 | 空：非零税率； 0：出口零税； 1：免税； 2：不征税； 3：普通零税率 税率为0时必填。 |
| zzstsgl | 增值税特殊管理 | varchar | 50 | 否 | 当yhzcbs为1且lslbs为1或者2时必填 lslbs为1值为：免税 lslbs为2值为：不征税 |
| taxrate | 税率 | number | 16,6 | 是 | 如：0.06 |
| xmje | 项目金额 | number | 18,2 | 是 | 项目金额=单价*数量，单位：元。 |
| se | 税额 | number | 18,2 | 否 | 当hsbz为0时必填，单位：元。 |
| zkje | 折扣金额 | number | 18,2 | 否 | 非空时表示该商品明细行存在折扣行，值为正数。 |
| zkse | 折扣税额 | number | 18,2 | 否 | 当hsbz为0且zkje非空时必填，值为正数。 |
| bdczlList | 不动产租赁 | array | 否 | tdys是06时必填。 | |
| xh | 序号 | 必须和项目明细中的hh一一对应。 | |||
| bdczldzS | 不动产坐落地址（省） | varchar | 20 | 是 | 必须以省、自治区、特别行政区、北京市、天津市、上海市、重庆市任意一个关键词结尾。 |
| bdczldzS1 | 不动产坐落地址（市） | varchar | 20 | 是 | 当“不动产坐落地址（省）”为香港特别行政区、澳门特别行政区、台湾省时，“不动产坐落地址（市）”可为空，其他情况必填。必须以市、盟、自治州、地区、区、县任意一个关键词结尾，且仅当“不动产坐落地址（省）”为海南省或重庆市时，“不动产坐落地址（市）”可以由关键词“县”结尾。。 |
| bdczldz | 不动产坐落地址（详细地址） | varchar | 80 | 是 | 必须包含街、路、村、乡、镇、道、巷、号等任意一个关键词。 |
| zlqq | 租赁期起 | varchar | 10 | 是 | 格式：yyyy-MM-dd 当spbm（税收分类编码）是3040502020200000000时， 格式为：yyyy-MM-dd hh:mm。 |
| zlqz | 租赁期止 | varchar | 10 | 是 | 格式：yyyy-MM-dd 当spbm（税收分类编码）是3040502020200000000时， 格式为：yyyy-MM-dd hh:mm。 |
| kdsbz | 跨地（市）标志 | char | 1 | 是 | Y：是 N：否 |
| cqzsbh | 产权证书/不动产权证号 | varchar | 40 | 是 | 无“产权证书/不动产权证号”时，填写“无”。 |
| cph | 车牌号 | varchar | 80 | 否 | 最多3个车牌号，多个车牌号之间以英文逗号分隔，每个车牌号最大长度不能超过20，仅当是停车费业务时，该字段有值。 |
响应参数
响应参数是经过3DES加密的json格式报文。
{
"status": "返回代码",
"msg": "返回描述",
"QRCodeUrl": "二维码链接"
}
| 数据项 | 名称 | 类型 | 长度 | 必填 | 说明 |
|---|---|---|---|---|---|
| status | 返回代码 | varchar | 4 | 是 | 0000表示成功，其他表示失败。 |
| msg | 返回描述 | varchar | 是 | status不是0000时，返回的失败原因描述。 | |
| QRCodeUrl | 二维码链接 | varchar | 否 | status是0000时有值，其他则为空。 |