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

发票开具（专、普、电）

POST
OperationId：zpdkp

1、接口及场景描述#

接口描述： 为企业提供开具税控发票功能
是否支持数电及税控发票：仅支持税控发票

2、请求参数#

字段名称必选类型长度字段含义及备注
method是string请求方法名
object是object请求数据
bz否string240备注
fplxdm是string3发票类型代码004：专票、007：普票、026：电普
fyxm是object[]费用项目 详见4、fyxm数据
ghdwmc是string100购货单位名称
ghdwsbh否string20购货单位识别号 专票必填，普票，电票，卷票非必填
ghdwdzdh否string100购货单位地址电话 专票必填，普票，电票，卷票非必填
ghdwyhzh否string100购方开户行及账号 专票必填，普票，电票，卷票非必填
xsfdz否string300销方地址
xsflxdh否string60销方电话
xsfkhh否string120销方开户行
xsfyhzh否string100销方银行账号
hjje否string12/13合计金额
hjse否string12合计税额
jshj否string13/14价税合计
kce是string12税率 差额征税扣除额
kplx是string1开票类型0：正数发票开具、1：负数发票开具
zsfs是string1征税方式 0：普通征收、2：差额征收
yx否string200推送邮箱 支持多邮箱推送中间使用 ; 分割
sjh否string200推送手机号 支持多手机号推送中间使用 ; 分割
kpr否string20开票人
skr否string16收款人
fhr否string16复核人
fpqqlsh是string100发票请求流水号
yfpdm是string10原发票代码 当开票类型为1，专票时必填
yfphm是string8原发票号码 当开票类型为1，专票时必填
ykprq否string8原开票日期 当开票类型为1，专票时必填 格式：yyyyMMdd
yfplx否string3原发票类型 当开票类型为1，专票时必填
tzdbh是string20红字信息表编号 当开票类型为1，专票时必填
chyydm是string1冲红原因代码 当开票类型为1，普票、电票时必填
1：销货退回
2：开票有误
3：服务中止
4：销售折让
fply是string1发票来源
0：导入开票；
1：发票填开（只能填：0，不填的话：默认为0）
id否string100待开id（待开开票必传且只需要此字段，其他字段忽略）
djlsh否string100单据流水号（单据开票必传）
djType否string1单据调用标识（0：第一次调用 1：第二次调用 当djlsh不为空时此值必填）
djly否string1单据来源 ：2单据导入， 3接口对接
djlsh和djType都不为空时。此值必填
gwmc否string100岗位名称 不填默认为当前调用者默认岗位，否则使用当前填入的岗位名称
kpsqr否string16开票申请人

3、返回参数#

字段名称是否必返回类型长度描述
code是string返回代码
data是object[]返回数据
msg是string返回消息
bz否string240备注
chyydm否string1冲红原因代码
djly否string1单据来源
fhr是string16复核人
fpdm是string12发票代码
fphm是string8发票号码
kprq是string8开票日期
fwqdz否string服务器地址
fwqdkh否string服务器端口号
fpcbh是string发票池
bbh是string版本号
bmbbbh否string编码表版本号
zhsl否string综合税率
jmbbh否string加密版本号
zyspmc是string92主要商品名称
kpjh是string开票机号
qmcs是string签名参数
verify否string数据校验
skm是string320税控码
qmz否string签名值
jym否string70校验码
ewm是string二维码
url否string版式文件地址开具发票类型026，电票时返回
fplxdm是string3发票类型代码
fpqqlsh否string100发票请求流水号
fyxm是object[]费用项目 详见4、fyxm数据
ghdwdzdh是string100购货单位地址电话
ghdwmc是string100购货单位名称
ghdwsbh是string20购货单位识别号
ghdwyhzh是string100购货单位银行帐号
hjje是string12/13合计金额
hjse是string12合计税额
jqbh是string机器编号
jshj是string13/14价税合计
kce否string12差额 扣除额zsfs为2时此项必返回
kplx是string1开票类型0：正数 1：负数
kpr是string20开票人
qdbz是string1清单标志
sjh否string200手机号
skr是string16收款人
tspz否string2特殊票种
00：不是
01：农产品销售
02：农产品收购
06：抵扣通行费
07：其它通行费
08：成品油销售
18：成品油红字专票
tzdbh否string20红字信息表编号
xhdwdzdh是string100销货单位地址电话
xhdwmc是string100销货单位名称
xhdwsbh是string20销货单位识别号
xhdwyhzh是string100销货银行银行账号
yfpdm否string10原发票代码 当开票类型为1，专票时必填
yfphm否string8原发票号码 当开票类型为1，专票时必填
yfplx否string3原发票类型 当开票类型为1，专票时必填
yfprq否string8原发票日期 当开票类型为1，专票时必填 格式：yyyyMMdd
yx否string200邮箱
zsfs是string1征税方式 0：普通征税 2：差额征税

4、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%即征即退

请求参数

Body 参数application/json

示例
{
    "method": "zpdkp",
    "object": {
        "bz": "备注",
        "fplxdm": "发票类型代码",
        "fyxm": [
            {
                "fphxz": "发票行性质",
                "spmc": "商品名称",
                "spbm": "税收编码",
                "ggxh": "规格型号",
                "dw": "单位",
                "dj": "单价",
                "spsl": "商品数量",
                "je": "金额",
                "sl": "税率",
                "se": "税额",
                "lslbs": "零税率标识",
                "yhzcbs": "优惠政策标识",
                "zzstsgl": "增值税特殊管理",
                "spsm": "商品税目",
                "hsbz": "含税标志"
            }
        ],
        "ghdwmc": "购货单位名称",
        "ghdwsbh": "购货单位识别号",
        "ghdwdzdh": "购货单位地址电话",
        "ghdwyhzh": "购货单位开户行及账号",
        "hjje": "合计金额",
        "hjse": "合计税额",
        "jshj": "价税合计",
        "kce": "扣除额",
        "kplx": "开票类型",
        "zsfs": "征税方式",
        "yx": "推送邮箱",
        "sjh": "推送手机号",
        "kpr": "开票人",
        "skr": "收款人",
        "fhr": "复核人",
        "fpqqlsh": "发票请求流水号",
        "yfpdm": "原发票代码",
        "yfphm": "原发票号码",
        "ykprq": "原开票日期",
        "yfplx": "原发票类型",
        "tzdbh": "红字信息表编号",
        "chyydm": "冲红原因代码",
        "fply": "发票来源",
        "id": "待开id",
        "djlsh": "单据流水号",
        "djType": "单据调用标识",
        "djly": "单据来源",
        "gwmc": "岗位名称",
        "kpsqr": "开票申请人"
    }
}

返回响应

🟢200成功
application/json
Body

示例
{
    "code": 0,
    "data": {
        "bz": "备注",
        "chyydm": "冲红原因代码",
        "djly": "单据来源",
        "fhr": "复核人",
        "fpdm": "发票代码",
        "fphm": "发票号码",
        "kprq": "开票日期",
        "fwqdz": "服务器地址",
        "fwqdkh": "服务器端口号",
        "fpcbh": "发票池",
        "bbh": "版本号",
        "bmbbbh": "编码表版本号",
        "zhsl": "综合税率",
        "jmbbh": "加密版本号",
        "zyspmc": "主要商品名称",
        "kpjh": "开票机号",
        "qmcs": "签名参数",
        "verify": "数据校验",
        "skm": "税控码",
        "qmz": "签名值",
        "jym": "校验码",
        "ewm": "二维码",
        "url": "版式文件地址",
        "fplxdm": "发票类型代码",
        "fpqqlsh": "发票请求流水号",
        "fyxm": [
            {
                "dj": "单价",
                "dw": "单位",
                "fphxz": "发票行性质",
                "ggxh": "规格型号",
                "hsbz": "含税标志",
                "je": "金额",
                "lslbs": "零税率标识",
                "se": "税额",
                "sl": "税率",
                "spbm": "商品编码",
                "spmc": "商品名称",
                "spsl": "商品数量",
                "spsm": "商品税目",
                "xh": "序号",
                "yhzcbs": "优惠政策标识",
                "zzstsgl": "增值税特殊管理"
            }
        ],
        "ghdwdzdh": "购货单位地址电话",
        "ghdwmc": "购货单位名称",
        "ghdwsbh": "购货单位识别号",
        "ghdwyhzh": "购货单位银行帐号",
        "hjje": "合计金额",
        "hjse": "合计税额",
        "jqbh": "机器编号",
        "jshj": "价税合计",
        "kce": "扣除额",
        "kplx": "开票类型",
        "kpr": "开票人",
        "qdbz": "清单标志",
        "sjh": "手机号",
        "skr": "收款人",
        "tspz": "特殊票种",
        "tzdbh": "红字信息表编号",
        "xhdwdzdh": "销货单位地址电话",
        "xhdwmc": "销货单位名称",
        "xhdwsbh": "销货单位识别号",
        "xhdwyhzh": "销货银行银行账号",
        "yfpdm": "原发票代码",
        "yfphm": "原发票号码",
        "yfplx": "原发票类型",
        "ykprq": "原发票日期",
        "yx": "邮箱",
        "zsfs": "征税方式"
    },
    "msg": "开具成功"
}
🟢200单据开票
上一页
红字信息表撤销
下一页
红字信息表准备信息查询
Built with