税务数字化管理平台
  1. 销项
税务数字化管理平台
  • 对外接口
    • 文档概览
    • 如何调用接口
    • 更新记录
    • 常见问题
    • 接口码表
    • 证件种类代码
    • 报废产品收购票确认提示
    • 自然人、销售方国籍代码
    • 行政区划代码
    • 行政区划代码表
    • 销项
      • 乐企
        • 获取批量预赋码信息
        • 查询授信额度
        • 查询成品油库存
        • 上传发票汇总确认信息
        • 查询发票汇总确认信息
        • 下载/退回授信额度
        • 下载或退回成品油库存
        • 调整授信额度有效期
        • 查询纳税人风险信息
        • 查询纳税人基本信息
        • 查询可用税率信息
        • 查询数字化电子红字确认单列表信息
        • 数字化电子红字确认单确认
        • 查询数字化电子红字确认单明细信息
        • 数字化电子红字确认单申请
        • 快捷全额红冲
        • 数电发票开具
        • 废弃乐企异常发票
        • 数电发票开具（实时开票）
        • 删除乐企发票
        • 再次上传数电发票
      • 税控
        • 发票领购查询
        • 发票作废
        • 空白发票作废
        • 红字信息表申请
        • 红字信息表查询
        • 红字信息表撤销
        • 发票开具（专、普、电）
        • 红字信息表准备信息查询
      • 数电
        • 红字确认单申请准备信息查询
        • 红字确认单申请
        • 数电快捷全额红冲
        • 查询红字确认单详细信息
        • 红字确认单撤销
        • 红字确认单查询
        • 红字确认单确认
        • 异常红字确认单下载
        • 全电发票开具
        • 人脸识别二维码
        • 获取全电开票结果
        • 获取全电全票面数据
        • 全电认证
        • 短信认证
        • 全电交付
        • 成品油库存台账查询
        • 全电纸质发票作废
        • 获取人脸识别结果
        • 获取红字确认单申请结果
        • 获取数电发票下载地址
        • 红字全电发票开具
        • 获取纸质发票打印XML
        • 发送发票数据到控件
        • 开启打印窗口
        • 蓝字发票数据统计
        • 版式文件下载
        • 批量红字确认单下载
        • 获取当前发票代码号码(数电纸票)
        • 查询跨区域涉税事项报验管理编码
        • 检查账号在线状态
        • 查询身份授权（用户是否需要人脸认证）状态
        • 查询行政区划信息
        • 红字确认单下载PDF文件
      • 扫码开票
        • 二维码生成规则
        • 扫码开票订单导入
        • 扫码开票订单查询
        • 扫码开票订单作废
      • 发票查询
        POST
      • 单张发票查询
        POST
      • 商品导入
        POST
      • 商品分页查询
        POST
      • 客户导入
        POST
      • 批量待开导入
        POST
      • 待开分页查询
        POST
      • 批量单据导入
        POST
      • 单据分页查询
        POST
      • 账号注册
        POST
      • 全票种开具
        POST
      • 抬头联想
        POST
      • 单张发票修复
        POST
  1. 销项

单张发票查询

POST
OperationId：dzfpcx

1、接口及场景描述#

接口描述： 为企业提供单张发票查询功能
是否支持数电及税控发票：全部支持
场景描述：
01:当查询数电发票时,系统内部会校验当前数据是否具有完整性，若不具有内部进行数据补充,并返回数据,失败则返回具体的失败原因
02:此接口根据发票请求流水号进行查询时,数电发票默认仅可以查询到正数发票（可以通过传入fpType查询负数）；税控发票可查询出正数、负数发票

2、请求参数#

字段名称必选类型长度字段含义及备注
method是string请求方法名
object是object请求数据
fpdm是string12发票代码（全电发票不需要传发票代码）
fphm是string20发票号码
fpqqlsh是string32发票请求流水号
Fpdm，fphm，fpqqlsh值都不为空，则按照发票请求流水号进行查询。
优先级如下：1、fpqqlsh2、fpdm+fphm3、fphm
fpType否string20查询数电发票 正数/负数发票标识，不传默认正数
0：查询正数发票 1：查询负数发票

3.1、返回参数（数电）#

字段名称是否必返回类型长度字段含义及备注
code是string返回代码
返回为-65,代表未查询到数据，msg对应返回：未查询到发票数据
data是object[]返回数据
msg是string返回消息
fpdm否string12发票代码
fphm否string20发票号码
sdfphm否string20数电发票号码
kprq否string开票日期 格式：yyyyMMddHHmmss
fpzt是string4发票状态
00：已开具的正数发票 、
01：已开具的负数发票、
02：未开具发票的作废发票、
03：已开具正数发票的作废发票、
04：已开具负数发票的作废发票
-1：正数发票，数据缺失
fplxdm是string4发票类型代码
004：专票、
007：普票、
026：电子发票
81：全电专
82：全电普
85 纸质专票(全电)
86纸质普票(全电)
qdzzfpzldm否string发票类型代码为85、86时必返回
1130:增值税专用发票（中文三联无金额限制版）;
1160:增值税专用发票（中文六联无金额限制版）；
04:2016版增值税普通发票（二联折叠票）
05:2016版增值税普通发票（五联折叠票）
kplx是string1开票类型0：正数 1：负数
bbh否string12版本号
tspz否string4特殊票种
00：不是
01：农产品销售
02：农产品收购
06：抵扣通行费
07：其它通行费
08：成品油销售
18：成品油红字专票
xhdwsbh是string26销货单位识别号
xhdwmc是string300销货单位名称
xhdwdzdh否string300销货单位地址电话
xhdwyhzh否string200销货银行银行账号
ghdwsbh是string26购货单位识别号
ghdwmc是string300购货单位名称
ghdwdzdh是string300购货单位地址电话
ghdwyhzh是string200购货单位银行帐号
gmfdz否string300数电-地址
gmflxdh否string60数电-电话
gmfkhh否string120数电-开户行
gmfyhzh否string100数电-银行账号
zsfs是string1征税方式 0：普通征税 2：差额征税
kce否string16差额扣除额zsfs为2时此项必返回
hjje是string16合计金额
hjse是string16合计税额
jshj是string16价税合计
bz否string460备注
skr是string收款人
fhr是string复核人
kpr是string开票人
kpsqr否string开票申请人
yfpdm否string12原发票代码
yfphm否string20原发票号码
ewm否string二维码
url否string电票返回
pdfurl否stringpdf地址（全电返回）
ofdurl否string国税OFD地址（全电返回）
ewmurl否string二维码url（全电返回）
xmlurl否stringxml数据下载地址（全电返回）
yqjg是string验签结果
0：验签失败
1：验签成功
2：待验签
99：无需验签
00: 乐企上传成功
01: 乐企上传中
02: 乐企上传失败（上传失败状态的发票数据）
03: 乐企未上传
04: 乐企重复上传
fyxm是object[]费用项目 详见：3.3、返回参数（fyxm数据信息）
zfrq否string作废日期 格式yyyyMMddHHmmss
zfr否string50作废人
sjh否string11推送手机号
yx否string40推送邮箱
djlsh否string200单据流水号
sjly否string数据来源
tdyslxdm否string5特定要素类型代码
"01"："成品油发票“,
"02"："稀土发票",
"03"："建筑服务发票",
"04"："货物运输服务发票",
"05"："不动产销售服务发票",
"06"："不动产经营租赁服务",
"07"："代收车船税",
"08"："通行费",
"09"："旅客运输服务发票",
"10"："医疗服务（住院）发票",
"11"："医疗服务（门诊）发票",
"12"："自产农产品销售发票",
"13"："拖拉机和联合收割机发票",
"14"："机动车",
"15"："二手车",
"16"："农产品收购发票",
"17"："光伏收购发票",
"18"："卷烟发票",
"19"："出口发票",
"20"："农产品"
tdywxx否object特定业务信息特定要素类型代码不为空时必返回
详见 3.4、返回参数（tdywxx数据信息）
cwxx否string200开具失败对应的错误信息
gwmc是string200岗位名称
tszt否string推送状态
0:未推送
1:已推送

3.2、返回参数（税控发票）#

字段名称是否必返回类型长度字段含义及备注
code是string返回代码
返回为-65,代表未查询到数据，msg对应返回： 未查询到发票数据
data是object[]返回数据
msg是string返回信息
bbh否string20版本号
bmbbbh否string100编码表版本号
bz否string460备注
ewm否string二维码
fhr否string复核人
fpcbh否string开票池
fpdm否string12发票代码
fphm否string20发票号码
fplxdm是string4发票类型代码
fpqqlsh否string32发票请求流水号
fpzt是string2发票状态
00：已开具的正数发票 、
01：已开具的负数发票、
02：未开具发票的作废发票、
03：已开具正数发票的作废发票、
04：已开具负数发票的作废发票
fwqdkh否string服务器端口号
fwqdz否string服务端地址
pdfurl否stringpdf地址（全电返回）
url否string电票返回url
ofdurl否string国税OFD地址（全电返回）
ewmurl否string二维码url（全电返回）
xmlurl否stringxml数据下载地址（全电返回）
fyxm是object[]费用项目 详见：3.3、返回参数（fyxm数据信息）
ghdwdzdh否string300购货单位地址电话
ghdwmc是string300购货单位名称
ghdwsbh是string26购货单位识别号
ghdwyhzh否string200购货单位银行帐号
hjje是string16合计金额
hjse是string16合计税额
jmbbh否string加密版本号
jqbh否string机器编号
jshj是string16价税合计
jym否string校验码
kpjh否string开票机号
kplx是string1开票类型0：正数 1：负数
kpr是string50开票人
kprq否string开票日期格式：yyyyMMddHHmmss
kpzdbs否string开票终端标识
qdbz是string2清单标志
qmcs否string签名参数
skm否string税控码
skr否string收款人
ssyf否string所属月份 格式：YYYYMM
tspz否string5特殊票种00：不是 01：农产品销售 02：农产品收购 06：抵扣通行费 07：其它通行费 08：成品油销售 18：成品油红字专票
tzdbh否string
xhdwdzdh是string300销货单位地址电话
xhdwmc是string300销货单位名称
xhdwsbh是string26销货单位识别号
xhdwyhzh是string200销货银行银行账号
zhsl否string10综合税率
zsfs是string1征税方式 0：普通征税 2：差额征税
zyspmc否string50主要商品名称
sjly否string50数据来源
cwxx否string开具失败对应的错误信息
gwmc是string200岗位名称
tszt否string推送状态
0:未推送
1:已推送
yx否string推送邮箱
sjh否string推送手机号

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

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

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

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

请求参数

Body 参数application/json

示例
{
    "method": "dzfpcx",
    "object": {
        "fpdm": "发票代码",
        "fphm": "发票号码",
        "fpqqlsh": "发票请求流水号",
        "fpType":"查询正数/负数发票标识"
    }
}

返回响应

🟢200成功（专、普、电）
application/json
Body

示例
{
    "code": 0,
    "data": {
        "bz": "备注",
        "ewm": "二维码",
        "jym": "校验码",
        "bbh": "版本号",
        "bmbbbh": "编码表版本号 ",
        "jqbh": "机器编号",
        "zyspmc": "主要商品名称",
        "fhr": "复核人",
        "fpdm": "发票代码",
        "fphm": "发票号码",
        "fplxdm": "发票类型代码",
        "fpqqlsh": "发票请求流水号",
        "fpzt": "发票状态",
        "pdfurl": "pdf地址",
        "url": "电票返回url",
        "ofdurl": "国税OFD地址",
        "ewmurl": "二维码url",
        "xmlurl": "xml数据下载地址",
        "fyxm": [
            {
                "xh": "序号",
                "dj": "单价",
                "dw": "单位",
                "fphxz": "发票行性质",
                "ggxh": "规格型号",
                "hsbz": "含税标志",
                "je": "金额",
                "lslbs": "零税率标识",
                "se": "税额",
                "sl": "税率",
                "spbm": "商品编码",
                "spmc": "商品名称",
                "spsl": "商品数量",
                "spsm": "商品税目",
                "yhzcbs": "优惠政策标识",
                "zxbm": "自行编码",
                "zzstsgl": "增值税特殊管理"
            }
        ],
        "ghdwdzdh": "购货单位地址电话",
        "ghdwmc": "购货单位名称",
        "ghdwsbh": "购货单位识别号",
        "ghdwyhzh": "购货单位银行帐号",
        "hjje": "合计金额",
        "hjse": "合计税额",
        "jshj": "价税合计",
        "kplx": "开票类型",
        "kpr": "开票人",
        "kprq": "开票日期",
        "qdbz": "清单标志",
        "skr": "收款人",
        "tspz": "特殊票种",
        "tzdbh": "通知单编号",
        "xhdwdzdh": "销货单位地址电话",
        "xhdwmc": "销货单位名称",
        "xhdwsbh": "销货单位识别号",
        "xhdwyhzh": "销货银行银行账号",
        "zsfs": "征税方式",
        "sjly": "数据来源",
        "gwmc": "岗位名称",
        "tszt": "推送状态",
        "yx": "推送邮箱",
        "sjh": "推送手机号"
    },
    "msg": "成功"
}
🟢200成功（全电）
上一页
发票查询
下一页
商品导入
Built with