获取全电全票面数据

1、接口及场景描述

接口描述：为企业提供用于获取全电发票全票面数据的功能
是否支持数电及税控发票：仅支持数电

2、请求参数

字段名称	必选	类型	长度	字段含义及备注
method	是	string		请求方法名
object	是	object		请求数据
fphm	是	string	20	全电发票号码
kprq	是	string		开票日期格式：yyyy-MM-dd HH:mm:ss
zzfpdm	否	string		纸质发票代码查询全电纸质发票时需要同时传纸质发票代码、纸质发票号码、全电发票号码
zzfphm	否	string		纸质发票号码查询全电纸质发票时需要同时传纸质发票代码、纸质发票号码、全电发票号码

3、返回参数

字段名称	是否必返回	类型	长度	字段含义及备注
code	是	string		返回代码
data	是	object[]		返回数据
msg	是	string		返回消息
bz	否	string	460	备注
fyxm	是	object[]		费用项目详见3.1返回参数（fyxm数据信息）
fplxdm	是	string	4	发票类型代码 81：数电专 82：数电普 85：纸质专票（全电） 86：纸质普票（全电）
fpqqlsh	否	string	32	发票请求流水号
ghdwdzdh	否	string	300	购货单位地址电话
ghdwmc	是	string	300	购货单位名称
ghdwsbh	是	string	26	购货单位识别号
ghdwyhzh	否	string	200	购货单位银行账号
jqbh	否	string		机器编号
kpr	是	string		开票人
tspz	否	string	5	特殊票种
xhdwdzdh	是	string	300	销货单位地址电话
xhdwmc	是	string	300	销货单位名称
xhdwsbh	是	string	26	销货单位识别号
xhdwyhzh	是	string	200	销货单位银行证号
hjje	是	string	16	合计金额
hjse	是	string	16	合计税额
jshj	是	string	16	价税合计
ewmUrl	是	string		二维码下载地址
pdfUrl	是	string		pdf数据下载地址
ofdUrl	是	string		ofd数据下载地址
xmlUrl	是	string		xml数据下载地址
tdyslxdm	否	string	5	特定要素类型代码 "01"："成品油发票“, "02"："稀土发票", "03"："建筑服务发票", "04"："货物运输服务发票", "05"："不动产销售服务发票", "06"："不动产经营租赁服务", "07"："代收车船税", "08"："通行费", "09"："旅客运输服务发票", "10"："医疗服务（住院）发票", "11"："医疗服务（门诊）发票", "12"："自产农产品销售发票", "13"："拖拉机和联合收割机发票", "14"："机动车", "15"："二手车", "16"："农产品收购发票", "17"："光伏收购发票", "18"："卷烟发票", "19"："出口发票", "20"："农产品"
tdywxx	否	object		特定业务信息特定要素类型代码不为空时必返回详见 3.2、返回参数（tdywxx数据信息）

3.1、返回参数（fyxm数据信息）

字段名称	是否必返回	类型	长度	字段含义及备注
dj	否	string	16	单价
dw	否	string	300	单位
fphxz	是	string	1	发票行性质
ggxh	否	string	40	规格型号
hsbz	是	string	1	含税标志 0：不含税1：含税
je	是	string	16	金额
lslbs	否	string	1	零税率标识空代表无,1：出口免税和其他免税优惠政策,2：不征增值税,3：普通零税率
se	否	string	16	税额
sl	是	string	8	税率
spbm	是	string	19	商品编码
spmc	是	string	600	商品名称
spsl	否	string	16	商品数量
spsm	否	string	19	商品税目
yhzcbs	否	string	1	优惠政策标识，0：未使用1：使用
zxbm	否	string		自行编码
zzstsgl	否	string	50	增值税特殊管理如果yhzcbs为1时，此项必返回增值税特殊管理不征税、免税、按5%简易征收减按1.5%计征、按3%简易征收、按5%简易征收、简易征收、先征后退、100%先征后退、 50%先征后退、即征即退30%、即征即退50%、即征即退70%、即征即退100%、超税负3%即征即退、稀土产品、超税负8%即征即退、超税负12%即征即退、超税负6%即征即退

3.2、返回参数（tdywxx数据信息）

字段名称	是否必返回	类型	长度	字段含义及备注
tdywxx	否	object		特定业务信息特定要素类型代码不为空时必返回
hwysfw	否	object[]		货物运输服务
ddd	否	string	80	到达地
qyd	否	string	80	起运地
ysgjhp	否	string	40	运输工具号牌
ysgjzl	否	string	4	运输工具种类：（铁路运输、公路运输、水路运输、航空运输、管道运输）
yshwmc	否	string	80	运输货物名称
jzfw	否	object		建筑服务
jzfwfsd	否	string	120	建筑服务发生地
fsdxxdz	否	string	120	发生地详细地址
jzxmmc	否	string	80	建筑项目名称
kdsbz	否	string	1	跨地市标志：Y/N
tdzzsxmbh	否	string	50	土地增值税项目编号
bdcfw	否	object		不动产服务
fwcqzshm	否	string	40	房屋产权证书/不动产权证号码
bdcdz	否	string	120	不动产地址
bdcxxdz	否	string	120	不动产详细地址
zlqq	否	string		租赁期起格式：yyyyMMdd
zlqz	否	string		租赁期止格式：yyyyMMdd
kdsbz	否	string	1	跨地市标志：Y/N
mjdw	否	string	4	面积单位,亩,m²,平方千米,公顷,hm²,km²
wqhtbabh	否	string	28	网签合同备案编号
tdzzsxmbh	否	string	18	土地增值税项目编号
hdjsjg	否	string	16	核定计税价格
sjcjhsje	否	string	16	实际成交含税金额
lkysfw	否	object[]		旅客运输服务
cxr	否	string	20	出行人
cxrzjlx	否	string	3	出行人证件类型，旅客运输服务必传同经办人证件种类代码。
cxrzjhm	否	string	20	出行人证件号码
cxrq	否	string		出行日期,旅客运输服务格式：yyyy-MM-dd
cfd	否	string	80	出发地,旅客运输服务必传按行政区划名称填写，包括县（市、区）名称，可在县（市、区）后自主增添具体地址
ddd	否	string	80	到达地旅客运输服务必传按行政区划名称填写，包括县（市、区）名称，可在县（市、区）后自主增添具体地址
jtgjlx	否	string	1	交通工具类型旅客运输服务必传 "1":飞机; "2":火车; "3":长途汽车; "4":公共交通; "5":出租车; "6":汽车; "7":船舶; "9":其他
dengj	否	string	20	等级,若交通工具为火车、飞机、船舶，则该要素为必填；等级类型: (交通工具-飞机:经济舱、头等舱、公务舱), (交通工具-船舶:一等舱、二等舱、三等舱), (交通工具-火车:一等座、二等座、软席(软座、软卧)、硬席(硬座、硬卧))
tljhLhsgj	否	object		拖拉机联合收割机
sfyytljdj	否	string	1	是否用于联合机登记Y:是N:否
fdjhm	否	string	40	发动机号码\底盘合格证编号
dphgzbh	否	string	40	底盘合格证编号发动机号码\底盘合格证编号
dzccsTdys	否	object		代收车船税必返回
bxdh	否	string	40	保险单号
cphcbdjh	否	string	40	车牌号船舶登记号
skssq	否	string		税款所属期例：2023-02 2023-02
dsccsje	否	string	16	代收车船税金额
znj	否	string	16	滞纳金金额
jehj	否	string	16	合计金额
cjh	否	string	17	车架号

请求参数

Body 参数application/json

method

string

固定值qpmhq

必需

object

必需

fphm

string

发票号码

必需

返回代码

kprq

string

开票日期

必需

开票日期格式：yyyy-MM-dd HH:mm:ss

示例

{
  "method": "qpmhq",
  "object": {
    "fphm": "发票号码",
    "kprq": "开票日期"
  }
}

返回响应

🟢200成功

application/json

Body

code

integer

返回代码

必需

返回代码

data

object

返回数据

必需

返回数据

string

备注

可选

备注

fyxm

array [object {16}]

费用项目

必需

费用项目

fplxdm

string

发票类型代码

必需

发票类型代码
81：数电专
82：数电普

fpqqlsh

string

发票请求流水号

必需

发票请求流水号

ghdwdzdh

string

购货单位地址电话

可选

购货单位地址电话

ghdwmc

string

购货单位名称

必需

购货单位名称

ghdwsbh

string

购货单位识别号

必需

购货单位识别号

ghdwyhzh

string

购货单位银行账号

可选

购货单位银行账号

jqbh

string

机器编号

可选

机器编号

kpr

string

开票人

必需

开票人

tspz

string

特殊票种

可选

特殊票种

xhdwdzdh

string

销货单位地址电话

必需

销货单位地址电话

xhdwmc

string

销货单位名称

必需

销货单位名称

xhdwsbh

string

销货单位识别号

必需

销货单位识别号

xhdwyhzh

string

销货单位银行证号

必需

销货单位银行证号

hjje

string

合计金额

必需

合计金额

hjse

string

合计税额

必需

合计税额

jshj

string

价税合计

必需

价税合计

ewmUrl

string

二维码下载地址

必需

二维码下载地址

pdfUrl

string

pdf数据下载地址

必需

pdf数据下载地址

ofdUrl

string

ofd数据下载地址

必需

ofd数据下载地址

xmlUrl

string

xml数据下载地址

必需

xml数据下载地址

tdyslxdm

string | null

特定要素类型代码

可选

特定要素类型代码 "01"："成品油发票“, "02"："稀土发票", "03"："建筑服务发票", "04"："货物运输服务发票", "05"："不动产销售服务发票", "06"："不动产经营租赁服务", "07"："代收车船税", "08"："通行费", "09"："旅客运输服务发票", "10"："医疗服务（住院）发票", "11"："医疗服务（门诊）发票", "12"："自产农产品销售发票", "13"："拖拉机和联合收割机发票", "14"："机动车", "15"："二手车", "16"："农产品收购发票", "17"："光伏收购发票", "18"："卷烟发票", "19"："出口发票", "20"："农产品"

tdywxx

object | null

特定业务信息

可选

特定业务信息

msg

string

返回消息

必需

返回消息

示例

{
  "code": 0,
  "data": {
    "bz": "备注",
    "fyxm": [
      {
        "dw": "单位",
        "fphxz": "发票行性质",
        "ggxh": "规格型号",
        "hsbz": "含税标志",
        "je": "金额",
        "lslbs": "零税率标识",
        "se": "税额",
        "spsl": "商品数量",
        "dj": "单价",
        "sl": "税率",
        "spbm": "商品编码",
        "zxbm": "用户自行编码",
        "spmc": "商品名称",
        "xh": "序号",
        "yhzcbs": "优惠政策标识",
        "zzstsgl": "增值税特殊管理"
      }
    ],
    "tdyslxdm": "特定要素类型代码",
    "tdywxx": {
      "hwysfw": [
        {
          "ddd": "到达地",
          "qyd": "起运地",
          "ysgjhp": "运输工具号牌",
          "ysgjzl": "运输工具种类",
          "yshwmc": "运输货物名称"
        }
      ],
      "jzfw": {
        "jzfwfsd": "建筑服务发生地",
        "fsdxxdz": "发生地详细地址",
        "jzxmmc": "建筑项目名称",
        "kdsbz": "跨地市标志",
        "tdzzsxmbh": "土地增值税项目编号"
      },
      "bdcfw": {
        "fwcqzshm": "房屋产权证书/不动产权证号码",
        "bdcdz": "不动产地址",
        "bdcxxdz": "不动产详细地址",
        "zlqq": "租赁期起",
        "zlqz": "租赁期止",
        "kdsbz": "跨地市标志",
        "mjdw": "面积单位",
        "wqhtbabh": "网签合同备案编号",
        "tdzzsxmbh": "土地增值税项目编号",
        "hdjsjg": "核定计税价格",
        "sjcjhsje": "实际成交含税金额"
      },
      "lkysfw": [
        {
          "cxr": "出行人",
          "cxrzjlx": "出行人证件类型",
          "cxrzjhm": "出行人证件号码",
          "cxrq": "出行日期",
          "cfd": "出发地",
          "ddd": "到达地",
          "jtgjlx": "交通工具类型",
          "dengj": "等级"
        }
      ],
      "tljhLhsgj": {
        "sfyytljdj": "是否用于联合机登记",
        "fdjhm": "发动机号码",
        "dphgzbh": "底盘合格证编号"
      },
      "dzccsTdys": {
        "bxdh": "保险单号",
        "cphcbdjh": "车牌号船舶登记号",
        "skssq": "税款所属期",
        "dsccsje": "代收车船税金额",
        "znj": "滞纳金金额",
        "jehj": "合计金额",
        "cjh": "车架号"
      }
    },
    "fplxdm": "发票类型代码",
    "fpqqlsh": "发票请求流水号",
    "ghdwdzdh": "购货单位地址电话",
    "ghdwmc": "购货单位名称",
    "ghdwsbh": "购货单位识别号",
    "ghdwyhzh": "购货单位银行证号",
    "jqbh": "机器编号",
    "kpr": "开票人",
    "tspz": "特殊票种",
    "xhdwdzdh": "销货单位地址电话",
    "xhdwmc": "销货单位名称",
    "xhdwsbh": "销货单位识别号",
    "xhdwyhzh": "销货单位银行证号",
    "hjje": "合计金额",
    "hjse": "合计税额",
    "jshj": "价税合计",
    "ewmUrl": "二维码下载地址",
    "pdfUrl": "pdf数据下载地址",
    "ofdUrl": "ofd数据下载地址",
    "xmlUrl": "xml数据下载地址"
  },
  "msg": "成功"
}

1、接口及场景描述#

2、请求参数#

3、返回参数#

3.1、返回参数（fyxm数据信息）#

3.2、返回参数（tdywxx数据信息）#

请求参数

返回响应

1、接口及场景描述

2、请求参数

3、返回参数

3.1、返回参数（fyxm数据信息）

3.2、返回参数（tdywxx数据信息）