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

单张发票修复

POST
OperationId：dzfpxf

1、接口及场景描述#

接口描述： 从电子税务局修复发票；
关于纸质发票代码、纸质发票号码、数电发票号码：仅传入纸质发票代码、纸质发票号码时为查询税控发票； 仅传入数电发票号码时，为查询数电发票； 传入数电发票号码、纸质发票代码、纸质发票号码时，为查询数电纸质发票

2、请求参数#

字段名称必选类型长度字段含义及备注
method是string请求方法名
object是object请求数据
zzfpdm是string12纸质发票代码
zzfphm是string8纸质发票号码
fphm是string20数电发票号码
fplxdm是string381 数电票（增值税专用发票）
82 数电票（普通发票）
85 数电票纸质发票（增值税专用发票）
86 数电票纸质发票（普通发票）
004 增值税专用发票
007 增值税普通发票
026 增值税电子普通发票
kprq是string格式：yyyy-MM-dd

3.1、返回参数（数电）#

字段名称是否必返回类型长度字段含义及备注
code是string0:成功；-911:没有可以修复的发票，请检查参数是否正确
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是string10验签结果
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岗位名称

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

字段名称是否必返回类型长度字段含义及备注
code是string0:成功；-911:没有可以修复的发票，请检查参数是否正确
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岗位名称

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

字段名称是否必返回类型长度字段含义及备注
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": "dzfpxf",
    "object": {
        "kprq": "2024-06-14",
        "fphm": "24127000000043737502",
        "zzfpdm": "",
        "zzfphm": "",
        "fplxdm": "81"
    }
}

返回响应

🟢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": [
            {
                "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": "岗位名称"
    },
    "msg": "成功"
}
🟢200成功（全电）
上一页
抬头联想
Built with