概述

销货方(商户)将订单信息推送到诺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": "车牌号"
        }
    ],
    "ylmzfw": {
        "ylywlsh": "医疗业务流水号",
        "hzxm": "患者姓名",
        "hzsfzjlxDm": "患者身份证件类型代码",
        "hzsfzjhm": "患者身份证件号码",
        "mzh": "门诊号",
        "mzjzsj": "门诊就诊时间",
        "yljglxDm": "医疗机构类型代码",
        "qtyljglx": "其他医疗机构类型",
        "yblxDm": "医保类型代码",
        "qtyblx": "其他医保类型",
        "ybbh": "医保编号",
        "xbDm": "性别",
        "ybtcjjzfje": "医保统筹基金支付金额",
        "qtzfje": "其他支付金额",
        "grzhzfje": "个人账户支付金额",
        "grxjzfje": "个人现金支付金额",
        "grzfje": "个人自付金额",
        "grzfje1": "个人自费金额",
        "sszdyyssl": "省市自定义要素数量",
        "sszdyysList": [
            {
                "sszdyysxh": "省市自定义要素序号",
                "sszdyysmc": "省市自定义要素名称",
                "sszdyysnr": "省市自定义要素内容"
            }
        ],
        "sfmxList": [
            {
                "mxxh": "明细序号",
                "fymx": "费用明细",
                "ylfwgbm": "医疗服务贯标码",
                "qt": "其他"
            }
        ]
    }

}

字段说明

数据项 名称 类型 长度 必填 说明
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:不动产租赁服务发票
11:医疗服务(门诊)发票
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,仅当是停车费业务时,该字段有值。
ylmzfw 医疗门诊服务 Object tdys是11时必填。
ylywlsh 医疗业务流水号 varchar 40
hzxm 患者姓名 varchar 150 1个汉字占用3个字符,最多可以上传50个汉字。
hzsfzjlxDm 患者身份证件类型代码 varchar 3 详见证件类型代码
hzsfzjhm 患者身份证件号码 varchar 30
yljglxDm 医疗机构类型代码 varchar 4 详见医疗机构类型代码
qtyljglx 其他医疗机构类型 varchar 100 填写上述医疗机构类型代码没有的类型,“医疗机构类型代码”和“其他医疗机构类型”只能填写一个。1个汉字占用3个字符,最多可以上传33个汉字。
yblxDm 医保类型代码 varchar 2 01:职工基本医疗保险;
02:城乡居民基本医疗保险;
03:离休;
04:其他医疗保险;
05:自费
qtyblx 其他医保类型 varchar 100 填写上述医保类型代码没有的类型,“医保类型代码”和“其他医保类型”只能填写一个。1个汉字占用3个字符,最多可以上传33个汉字。
ybbh 医保编号 varchar 30
xbDm 性别 varchar 1 1:男
2:女
ybtcjjzfje 医保统筹基金支付金额 number 18,4
qtzfje 其他支付金额 number 18,4
grzhzfje 个人账户支付金额 number 18,4
grxjzfje 个人现金支付金额 number 18,4
grzfje 个人自付金额 number 18,4
grzfje1 个人自费金额 number 18,4
mzh 门诊号 varchar 30
mzjzsj 门诊就诊时间 datetime - 格式必须为“yyyy-MM-dd HH:mm:ss”
sszdyyssl 省市自定义要素数量 number 2 省市自定义要素数量,大于等于0的正整数
sszdyysList 省市自定义要素集合 array -
sszdyysxh 省市自定义要素序号 number 2 从“1”开始的连续正整数
sszdyysmc 省市自定义要素名称 String 100 若“省市自定义要素内容”栏次非空,则本栏次必须非空;中文、英文字符、数字。
1个汉字占用3个字符,最多可以上传33个汉字。
sszdyysnr 省市自定义要素内容 String 100 若“省市自定义要素名称”栏次非空,则本栏次必须非空。
1个汉字占用3个字符,最多可以上传33个汉字。
sfmxList 收费明细集合 array -
mxxh 明细序号 int - 发票明细(detail)的行号(hh),
当fymx或ylfwgbm或qt有值时,mxxh必填。
fymx 费用明细 String 200 1个汉字占用3个字符,最多可以上传66个汉字。
ylfwgbm 医疗服务贯标码 String 50
qt 其他 String 100 1个汉字占用3个字符,最多可以上传33个汉字。

响应参数

响应参数是经过3DES加密的json格式报文。

{
  "status": "返回代码",
  "msg": "返回描述",
  "QRCodeUrl": "二维码链接"
}
数据项 名称 类型 长度 必填 说明
status 返回代码 varchar 4 0000表示成功,其他表示失败。
msg 返回描述 varchar status不是0000时,返回的失败原因描述。
QRCodeUrl 二维码链接 varchar status是0000时有值,其他则为空。
Copyright © Shanghai Aisino Co.,Ltd 版权所有 侵权必究该文件修订时间: 2026-05-09 15:34:00

results matching ""

    No results matching ""