1. H5获取发票结算单数据

1.1. 接口说明

为满足扫描二维码开票数据的传递,提供二维码开票接口规范,其中包括小票二维码的格式接口内容、接口格式、交互模式等信息,并以此进行对接程序的开发。

1.2. H5访问地址

https://invoice.youepiao.com/public/#/invoice?a=APPID&s=业务单据号

1.3. 业务接口地址

由业务系统确定

1.4. 调用方式

请求方式:GET

1.5. 返回数据格式

Content-Type : application/json

1.5.1. 返回参数示例

{
  "status": true,
  "code": 0,
  "msg": "提示信息",
  "timestamp": "2021-06-23T03:42:23.517+00:00",
  "data": {
    "lsh": "12342333",
    "tspz": "00",
    "isAuto": "0",
    "fplxdm": "026",
    "kpzdbs": "1655kpzd2",
    "ghdwmc": "成都*********有限公司",
    "ghdwsbh": "9151*********55R",
    "ghdwdz": "购货单位地址",
    "ghdwdh": "购货单位电话",
    "ghdwyh": "购货单位银行",
    "ghdwzh": "购货单位账户",
    "sfzsghdwyhzh": "0",
    "xhdwsbh": "9888*********77R",
    "xhdwmc": "北京*********有限公司",
    "xhdwdz": "销货单位地址",
    "xhdwdh": "销货单位电话",
    "xhdwyh": "销货单位银行",
    "xhdwzh": "销货单位账户",
    "sfzsxhdwyhzh": "0",
    "skr": "张三",
    "fhr": "李四",
    "kpr": "王五",
    "jshj": 4.12,
    "zkje": 0,
    "bz": "",
    "email": "",
    "phone": "",
    "xmmc": "",
    "ddly": "",
    "details": [
      {
        "fphxz": "0",
        "spmc": "软件服务",
        "ggxh": "",
        "dw": "",
        "spsl": 4,
        "dj": 1.03,
        "je": 4.12,
        "sl": 0.03,
        "spbm": "3040201030000000000",
        "yhzcbs": "0",
        "lslbs": "",
        "zzstsgl": "",
        "mxbh": "",
        "spbh": ""
      }
    ],
    "tdywxx": {
      "jzfw": {
        "fsdxxdz": "发生地详细地址",
        "jzfwfsd": "建筑服务发生地",
        "jzxmmc": "建筑项目名称",
        "kdsbz": "跨地市标志",
        "tdzzsxmbh": "土地增值税项目编号"
      },
      "hwysfw": [
        {
          "ddd": "到达地",
          "qyd": "起运地",
          "ysgjhp": "运输工具号牌",
          "ysgjzl": "运输工具种类",
          "yshwmc": "运输货物名称"
        }
      ],
      "bdcxsfw": {
        "bdcdz": "不动产地址",
        "bdcxxdz": "不动产详细地址",
        "fwcqzshm": "房屋产权证书/不动产权证号码",
        "kdsbz": "跨地市标志",
        "mjdw": "面积单位",
        "wqhtbabh": "不动产单元代码/网签合同备案编码",
        "tdzzsxmbh": "土地增值税项目编号",
        "hdjsjg": "核定计税价格",
        "sjcjhsje": "实际成交含税金额"
      },
      "bdcjyzlfw": {
        "bdcdz": "不动产地址",
        "bdcxxdz": "不动产详细地址",
        "fwcqzshm": "房屋产权证书/不动产权证号码",
        "kdsbz": "跨地市标志",
        "mjdw": "面积单位",
        "zlqq": "租赁期起",
        "zlqz": "租赁期止",
        "cph": "车牌号"
      },
      "lkysfw": [
        {
          "cfd": "出发地",
          "cxr": "出行人",
          "cxrq": "出行日期",
          "cxrzjhm": "出行人证件号码",
          "cxrzjlx": "出行人证件类型",
          "ddd": "到达地",
          "dengj": "等级",
          "jtgjlx": "交通工具类型"
        }
      ]
    }
  }
}

1.5.2. 参数说明

数据长度指的是GBK字符长度,一个中文字符占两个长度,一个英文字符占一个长度。

主要信息

参数 参数名称 类型 长度 必须 备注
lsh 开票流水号 String 50 一定要确保开票流水号唯一性.
tspz 特殊票种标识 String 10 00-正常票种
01-农产品销售
02-农产品收购
08-成品油销售
53-建筑服务
54-货物运输服务
55-不动产销售服务
56-不动产租赁服务
59-旅客运输服务
isAuto 自动开票 Int 0- 经过人工审核后手工提交开票;
1- 系统数据校验通过后自动开票
fplxdm 发票类型代码 String 3 81-数电票专票
82-数电票普票
kpzdbs 开票终端标识 String 30 当企业具有多个开票终端时,必填。
ghdwsbh 购货单位识别号 String 20
ghdwmc 购货单位名称 String 100
ghdwdz 购货单位地址 String 100
ghdwdh 购货单位电话 String 100
ghdwyh 购货单位开户行 String 100
ghdwzh 购货单位开户账号 String 100
sfzsghdwyhzh 是否展示购货单位银行账号 String 1 数电票可选项其余票种无效,不填默认为0
0-不展示
1-展示(体现在数电票板式文件备注栏中)
xhdwsbh 销货单位识别号 String 20
xhdwmc 销货单位名称 String 100
xhdwdz 销货单位地址 String 100 不填则使用系统初始化数据
xhdwdh 销货单位电话 String 100 不填则使用系统初始化数据
xhdwyh 销货单位开户行 String 100 不填则使用系统初始化数据
xhdwzh 销货单位开户账号 String 60 不填则使用系统初始化数据
sfzsxhdwyhzh 是否展示销货单位银行账号 String 1 数电票可选项其余票种无效,不填默认为0
0-不展示
1-展示(体现在数电票板式文件备注栏中)
phone 收票人手机 String 11 暂无短信推送
skr 收款人 String 16
kpr 开票人 String 16
fhr 复核人 String 16
email 收票人电子邮箱 String 50 如果需要推送邮箱,则必填;
jshj 价税合计 Decimal 单位:元(2 位小数)
zkje 折扣金额 Decimal 单位:元(2 位小数)
bz 备注 String 230
xmmc 项目名称 String 10
ddly 订单来源 String 10 目前订单来源有:天问、融易居、车场、
details 发票明细集合 请参照明细说明。
tdywxx 特定业务信息 数电票特定业务类型为53、54、55、56、59时必填,请参照特定业务信息填写

明细说明

报文 参数名称 类型 长度 必须 备注
mxbh 明细编号 String 100
fphxz 发票行性质 Integer 0-正常行
1-折扣行
2-被折扣行
3-冲差行、补差行(非标准发票行性质) 折扣行只需要填写(商品名称,金额,税率)
spbh 商品编号 String 100 如若涉及冲差,此项为必填项,并必须保证冲差行与正常行的商品编号一致。
spmc 商品名称 String 100 如果为折扣行,商 品名称须与被折扣 行的商品名称相同,不能多行折扣。
ggxh 规格型号 String 40
dw 计量单位 String 22 若 tspz 为 08,此项必填,必须为 “吨”或者“升”
spsl 商品数量 Decimal 小数点后 6 位
若 tspz 为 08,此项必填,不能为 0。
dj 商品单价 Decimal 小数点后 6 位含税,不能为0
je 金额 Decimal 含税,单位:元(2 位小数)
sl 税率 Decimal 2 位小数,例 1%为0.01;13%为0.13
spbm 商品税务编码 String 19 商品税务编码(以税局编码为准)
lslbs 特定征税方式代码 String 1 null-正常税率
1-出口免税和其他免税优惠政策
2-不征增值税
3-普通零税率
4-差额征税
5-简易征税
6-减按征税
zzstsgl 优惠政策 String 2 参考优惠政策码表

特定业务信息

报文 参数名称 类型 长度 必须 备注
jzfw 建筑服务 特殊票种为53时必填,参照建筑服务详情说明
hwysfw 货物运输服务 List 特殊票种为54时必填,参照货物运输服务详情说明
bdcxsfw 不动产销售服务 特殊票种为55时必填,参照不动产销售服务详情说明
bdcjyzlfw 不动产租赁服务 特殊票种为56时必填,参照不动产租赁服务详情说明
lkysfw 旅客运输服务 List 特殊票种为59时必填,参照旅客运输服务详情说明
建筑服务
报文 参数名称 类型 长度 必须 备注
fsdxxdz 发生地详细地址 String 发生地与详细地址合计长度不超过120
jzfwfsd 建筑服务发生地 String 发生地与详细地址合计长度不超过120
jzxmmc 建筑项目名称 String 80
kdsbz 跨地市标志 String 1 0-否
1-是
tdzzsxmbh 土地增值税项目编号 String 16
货物运输服务
报文 参数名称 类型 长度 必须 备注
ddd 到达地 String 80 按行政区划名称填写,包括县(市、区)名称,可在县(市、区)后自主增添具体地址
qyd 起运地 String 80 同起运地要求
ysgjhp 运输工具号牌 String 40 运输工具种类属于无牌号的工具种类时,需填写“无”
ysgjzl 运输工具种类 String 2 0-铁路运输
1-公路运输
2-水路运输
3-航空运输
4-管道运输
5-其他运输工具
yshwmc 运输货物名称 String 80
不动产销售服务
报文 参数名称 类型 长度 必须 备注
bdcdz 不动产地址 String 不动产地址与详细地址合计长度不超过120,按行政区划名称填写
bdcxxdz 不动产详细地址 String 不动产地址与详细地址合计长度不超过120
fwcqzshm 房屋产权证书 String 40 房屋产权证书/不动产权证号码
kdsbz 跨地市标志 String 1 0-否
1-是
mjdw 面积单位 String 2 0-平方米
1-亩
2-m²
3-平方千米
4-公顷
5-hm²
6-km²
wqhtbabh 网签合同备案编码 String 28 若为房地产开发企业标签,必填
tdzzsxmbh 土地增值税项目编号 String 18
hdjsjg 核定计税价格 Decimal 不属于核定计税不动产销售的可不填写
sjcjhsje 实际成交含税金额 Decimal 实际成交含税金额:按核定计税价格征税的,必填
不动产租赁服务
报文 参数名称 类型 长度 必须 备注
bdcdz 不动产地址 String 不动产地址与详细地址合计长度不超过120,按行政区划名称填写
bdcxxdz 不动产详细地址 String 不动产地址与详细地址合计长度不超过120
fwcqzshm 房屋产权证书 String 40 房屋产权证书/不动产权证号码
kdsbz 跨地市标志 String 1 0-否
1-是
mjdw 面积单位 String 2 0-平方米
1-亩
2-m²
3-平方千米
4-公顷
5-hm²
6-km²
zlqq 租赁期起 String 16 格式为:yyyy-MM-dd HH:mm
zlqz 租赁期止 String 16 格式为:yyyy-MM-dd HH:mm
cph 车牌号 String 10 当商品税务编码为3040502020200000000时填写有效,其他编码填写无效
旅客运输服务
报文 参数名称 类型 长度 必须 备注
cfd 出发地 String 80 按行政区划名称填写,包括县(市、区)名称,可在县(市、区)后自主增添具体地址
cxr 出行人 String 20
cxrq 出行日期 String 10 格式:yyyy-MM-dd
cxrzjhm 出行人证件号码 String 20
cxrzjlx 出行人证件类型 String 20 参考证件类型码表
ddd 到达地 String 80 同出发地要求
dengj 等级 String 8 等级:若交通工具为火车、飞机、船舶,则该要素为必填;等级类型: (交通工具-飞机:经济舱、头等舱、公务舱),(交通工具-船舶:一等舱、二等舱、三等舱),(交通工具-火车:一等座、二等座、软席(软座、软卧)、硬席(硬座、硬卧))
ysgjzl 运输工具种类 String 2 1-飞机
2-火车
3-长途汽车
4-公共交通
5-出租车
6-汽车
7-船舶
9-其他

1.5.3. 码表信息

优惠政策

[
  {
    "code": "01",
    "name": "简易征收"
  },
  {
    "code": "02",
    "name": "稀土产品"
  },
  {
    "code": "03",
    "name": "免税"
  },
  {
    "code": "04",
    "name": "不征税"
  },
  {
    "code": "05",
    "name": "先征后退"
  },
  {
    "code": "06",
    "name": "100%先征后退"
  },
  {
    "code": "07",
    "name": "50%先征后退"
  },
  {
    "code": "08",
    "name": "按3%简易征收"
  },
  {
    "code": "09",
    "name": "按5%简易征收"
  },
  {
    "code": "10",
    "name": "按5%简易征收减按1.5%计征"
  },
  {
    "code": "11",
    "name": "即征即退30%"
  },
  {
    "code": "12",
    "name": "即征即退50%"
  },
  {
    "code": "13",
    "name": "即征即退70%"
  },
  {
    "code": "14",
    "name": "即征即退100%"
  },
  {
    "code": "15",
    "name": "超税负3%即征即退"
  },
  {
    "code": "16",
    "name": "超税负8%即征即退"
  },
  {
    "code": "17",
    "name": "超税负12%即征即退"
  },
  {
    "code": "18",
    "name": "超税负6%即征即退"
  }
]

证件类型

[
  {
    "code": "101",
    "name": "组织机构代码证"
  },
  {
    "code": "102",
    "name": "营业执照"
  },
  {
    "code": "103",
    "name": "税务登记证"
  },
  {
    "code": "199",
    "name": "其他单位证件"
  },
  {
    "code": "201",
    "name": "居民身份证"
  },
  {
    "code": "202",
    "name": "军官证"
  },
  {
    "code": "203",
    "name": "武警警官证"
  },
  {
    "code": "204",
    "name": "士兵证"
  },
  {
    "code": "205",
    "name": "军队离退休干部证"
  },
  {
    "code": "206",
    "name": "残疾人证"
  },
  {
    "code": "207",
    "name": "残疾军人证(1-8级)"
  },
  {
    "code": "208",
    "name": "外国护照"
  },
  {
    "code": "210",
    "name": "港澳居民来往内地通行证"
  },
  {
    "code": "212",
    "name": "中华人民共和国往来港澳通行证"
  },
  {
    "code": "213",
    "name": "台湾居民来往大陆通行证"
  },
  {
    "code": "214",
    "name": "大陆居民往来台湾通行证"
  },
  {
    "code": "215",
    "name": "外国人居留证"
  },
  {
    "code": "216",
    "name": "外交官证"
  },
  {
    "code": "217",
    "name": "使(领事)馆证"
  },
  {
    "code": "218",
    "name": "海员证"
  },
  {
    "code": "219",
    "name": "香港永久性居民身份证"
  },
  {
    "code": "220",
    "name": "台湾身份证"
  },
  {
    "code": "221",
    "name": "澳门特别行政区永久性居民身份证"
  },
  {
    "code": "222",
    "name": "外国人身份证件"
  },
  {
    "code": "224",
    "name": "就业失业登记证"
  },
  {
    "code": "225",
    "name": "退休证"
  },
  {
    "code": "226",
    "name": "离休证"
  },
  {
    "code": "227",
    "name": "中国护照"
  },
  {
    "code": "228",
    "name": "城镇退役士兵自谋职业证"
  },
  {
    "code": "229",
    "name": "随军家属身份证明"
  },
  {
    "code": "230",
    "name": "中国人民解放军军官转业证书"
  },
  {
    "code": "231",
    "name": "中国人民解放军义务兵退出现役证"
  },
  {
    "code": "232",
    "name": "中国人民解放军士官退出现役证"
  },
  {
    "code": "233",
    "name": "外国人永久居留身份证(外国人永久居留证)"
  },
  {
    "code": "234",
    "name": "就业创业证"
  },
  {
    "code": "235",
    "name": "香港特别行政区护照"
  },
  {
    "code": "236",
    "name": "澳门特别行政区护照"
  },
  {
    "code": "237",
    "name": "中华人民共和国港澳居民居住证"
  },
  {
    "code": "238",
    "name": "中华人民共和国台湾居民居住证"
  },
  {
    "code": "239",
    "name": "《中华人民共和国外国人工作许可证》(A类)"
  },
  {
    "code": "240",
    "name": "《中华人民共和国外国人工作许可证》(B类)"
  },
  {
    "code": "241",
    "name": "《中华人民共和国外国人工作许可证》(C类)"
  },
  {
    "code": "291",
    "name": "医学出生证明"
  },
  {
    "code": "299",
    "name": "其他个人证件"
  }
]

results matching ""

    No results matching ""