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

全票种开具

POST

1、接口及场景描述#

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

2、请求参数#

字段名称必选类型长度字段含义及备注
method是string请求方法名
object是object请求数据
bz否string460备注
sfzsgmfyhzh否string1是否展示购买方银行账号 Y:是 N:不是 仅数电发票使用
sfzsxsfyhzh否string1是否展示销售方银行账号 Y:是 N:不是 仅数电发票使用
fplxdm是string4发票类型代码
004:专票、
007:普票、
026:电普
81:全电专
82:全电普
85 纸质专票(全电)
86纸质普票(全电)
qdzzfpzldm否string发票类型代码为85、86时必传
1130:增值税专用发票(中文三联无金额限制版);
1160:增值税专用发票(中文六联无金额限制版);
04:2016版增值税普通发票(二联折叠票)
05:2016版增值税普通发票(五联折叠票)
tdyslxdm否string5特定要素类型代码 开具004、007、026发票时此字段不获取
"01":"成品油发票“,
"02":"稀土发票",
"03":"建筑服务发票",
"04":"货物运输服务发票",
"05":"不动产销售服务发票",
"06":"不动产经营租赁服务",
"07":"代收车船税",
"08":"通行费",
"09":"旅客运输服务发票",
"10":"医疗服务(住院)发票",
"11":"医疗服务(门诊)发票",
"12":"自产农产品销售发票",
"13":"拖拉机和联合收割机发票",
"14":"机动车",
"15":"二手车",
"16":"农产品收购发票",
"17":"光伏收购发票",
"18":"卷烟发票",
"19":"出口发票",
"20":"农产品"
fyxm是object[]费用项目 详见fyxm数据信息
ghdwmc是string300购货单位名称
ghdwsbh否string26购货单位识别号 专票必填,普票,电票,卷票非必填
ghdwdzdh否string300购货单位地址电话 专票必填,普票,电票,卷票非必填开具81、82票具时此字段数据不获取
ghdwyhzh否string200购方开户行及账号 专票必填,普票,电票,卷票非必填开具81、82票具时此字段数据不获取
xsfdz否string300销方地址
xsflxdh否string60销方电话
xsfkhh否string120销方开户行
xsfyhzh否string100销方银行账号
hjje是string16合计金额
hjse是string16合计税额
jshj是string16价税合计
kce否string16税率 差额征税扣除额开具81、82票具时此字段数据不获取
kplx是string1开票类型
0:正数发票开具、
1:负数发票开具开具
81、82票具时此字段数据不获取
zsfs是string1征税方式
开具81、82票具时此字段数据不获取
0:普通征收、
2:差额征收
yx否string200推送邮箱 支持多邮箱推送中间使用 ; 分割
sjh否string200推送手机号 支持多手机号推送中间使用 ; 分割
kpr否string开票人开具81、82票具时此字段数据不获取
skr否string收款人开具81、82票具时此字段数据不获取
fhr否string复核人开具81、82票具时此字段数据不获取
fpqqlsh否string32发票请求流水号
zrrbs否string1Y:自然人N:非自然人(默认值)
开具发票类型为004、007、026时此字段值不获取
yfpdm否string12原发票代码 当开票类型为1时必填开具81、82票具时此字段数据不获取
yfphm否string20原发票号码 当开票类型为1时必填开具81、82票具时此字段数据不获取
ykprq否string原开票日期 当开票类型为1 时必填 格式:yyyyMMdd 开具81、82票具时此字段数据不获取
yfplx否string2原发票类型 当开票类型为1 时必填开具
81、82票具时此字段数据不获取
tzdbh否string红字信息表编号 当开票类型为1,专票时必填开具
81、82票具时此字段数据不获取
chyydm否string1冲红原因代码 当开票类型为1,普票、电票时必填
1:销货退回
2:开票有误
3:服务中止
4:销售折让开具
81、82票具时此字段数据不获取
id否string待开id(待开开票必传且只需要此字段,其他字段忽略)
djlsh否string单据流水号(单据开票必传)
djType否string1单据调用标识(
0:第一次调用 1:第二次调用 当djlsh不为空时此值必填)
开具81、82票具时此字段数据不获取
djly否string1单据来源 :2单据导入, 3接口对接 djlsh和djType都不为空时。
此值必填开具81、82票具时此字段数据不获取
tdywxx否object特定业务信息特定要素类型代码不为空时必填
(tdyslxdm为01时,此字段置空)
开具004、0007、026发票时此字段不获取
hwysfw否object[]货物运输服务开具004、007、026发票时此字段不获取
ddd否string80到达地货物运输服务必传按行政区划名称填写,包括县(市、区)名称,可在县(市、区)后自主增添具体地址
开具004、007、026发票时此字段不获取
qyd否string80起运地货物运输服务必传按行政区划名称填写,包括县(市、区)名称,可在县(市、区)后自主增添具体地址
开具004、007、026发票时此字段不获取
ysgjhp否string40货物运输服务必传运输工具种类属于无牌号的工具种类时,
需填写无开具004、007、026发票时此字段不获取
ysgjzl否string4运输工具种类货物运输服务必传
(铁路运输、公路运输、水路运输、航空运输、管道运输)
开具004、007、026发票时此字段不获取
yshwmc否string80运输货物名称货物运输服务必传开具004、007、026发票时此字段不获取
sjly否string50数据来源用户自行填写
jzfw否object建筑服务
jzfwfsd否string120建筑服务发生地,建筑服务必填
fsdxxdz否string120发生地详细地址
jzxmmc否string80建筑项目名称,建筑服务必填
kdsbz否string1跨地市标志,建筑服务必填Y/N
tdzzsxmbh否string50土地增值税项目编号
xzqhszDm否string行政区划数字代码,仅限于注册地和建筑服务发生地在不跨市时,必填
kqysssxbgglbm否string跨区域涉税事项报验管理编码,仅限于跨地(市)标志为是时,必填
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网签合同备案编号,暂只支持线路2.不动产销售服务必传
tdzzsxmbh否string18土地增值税项目编号,暂只支持线路2.不动产销售服务必传
hdjsjg否string16核定计税价格,暂只支持线路2.不动产销售服务必传
sjcjhsje否string16实际成交含税金额,暂只支持线路2.不动产销售服务必传
lkysfw否object[]旅客运输服务
cxr否20出行人
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否string拖拉机联合收割机必传。暂只支持线路2
sfyytljdj否string1是否用于联合机登记Y:是N:否
fdjhm否string40发动机号码、底盘合格证编号只能二选一
dphgzbh否string40底盘合格证编号发动机号码、底盘合格证编号只能二选一
dzccsTdys否string代收车船税必传。
bxdh否string40保险单号
cphcbdjh否string40车牌号船舶登记号
skssq否string税款所属期 例:2023-02 2023-02
dsccsje否string16代收车船税金额
znj否string16滞纳金金额
jehj否string16合计金额
cjh否string17车架号
kjly否string2针对于开具数电发票开具理由:条件必传:当小规模开具3%税率时,此字段为必传
04:前期已开具3%征收率发票,发生销售折让、
中止或者退回等情形需要开具红字发票,或者开票有误需要重新开具。
05:因为实际经营业务需要,放弃享受减按1%征收率征收增值税政策。
gwmc否string100岗位名称 不填默认为当前调用者默认岗位,否则使用当前填入的岗位名称
kpsqr否string16开票申请人

fyxm数据信息#

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

3、返回参数#

若请求参数fplxdm为 004、007、026 返回数据格式与 税控-发票开具(专、普、电)相同
若请求参数fplxdm为 81、82 返回数据格式与 数电-全电发票开具 相同

请求参数

Body 参数application/json
method
string 
固定值kp
必需
object
object 
必需
bz
string 
备注
可选
备注
fplxdm
string 
发票类型代码
可选
发票类型代码
004:专票、
007:普票、
026:电普、
81:全电专、
82:全电普
fpqqlsh
string 
发票请求流水号
可选
发票请求流水号
tdyslxdm
string 
特定要素类型代码
必需
特定要素类型代码
开具004、007、026发票时此字段不获取
"01":"成品油发票“,
"02":"稀土发票",
"03":"建筑服务发票",
"04":"货物运输服务发票",
"05":"不动产销售服务发票",
"06":"不动产经营租赁服务",
"07":"代收车船税",
"08":"通行费",
"09":"旅客运输服务发票",
"10":"医疗服务(住院)发票",
"11":"医疗服务(门诊)发票",
"12":"自产农产品销售发票",
"13":"拖拉机和联合收割机发票",
"14":"机动车",
"15":"二手车",
"16":"农产品收购发票",
"17":"光伏收购发票",
"18":"卷烟发票",
"19":"出口发票",
"20":"农产品"
ghdwmc
string 
购货单位名称
必需
购货单位名称
ghdwsbh
string 
购货单位识别号
可选
购货单位识别号 专票必填,普票,电票,卷票非必填
ghdwdzdh
string 
购货单位地址电话
可选
购货单位地址电话 专票必填,普票,电票,卷票非必填
开具81、82票具时此字段数据不获取
ghdwyhzh
string 
购方开户行及账号
可选
购方开户行及账号 专票必填,普票,电票,卷票非必填
开具81、82票具时此字段数据不获取
xsfdz 
string 
销方地址
可选
销方地址
xsflxdh 
string 
销方电话
可选
销方电话
xsfkhh 
string 
销方开户行
可选
销方开户行
xsfyhzh 
string 
销方银行账号
可选
销方银行账号
hjje
string 
合计金额
必需
合计金额
hjse
string 
合计税额
必需
合计税额
jshj
string 
价税合计
必需
价税合计
kce
string 
扣除额
可选
税率 差额征税扣除额
开具81、82票具时此字段数据不获取
kplx
string 
开票类型
必需
开票类型
0:正数发票开具、
1:负数发票开具
开具81、82票具时此字段数据不获取
zsfs
string 
征税方式
必需
征税方式
开具81、82票具时此字段数据不获取
0:普通征收、
2:差额征收
yx
string 
推送邮箱
可选
推送邮箱
sjh
string 
推送手机号
可选
推送手机号
kpr
string 
开票人
可选
开票人
开具81、82票具时此字段数据不获取
skr
string 
收款人
可选
收款人
开具81、82票具时此字段数据不获取
fhr
string 
复核人
可选
复核人
开具81、82票具时此字段数据不获取
yfpdm
string 
原发票代码
可选
原发票代码 当开票类型为1时必填
开具81、82票具时此字段数据不获取
yfphm
string 
原发票号码
可选
原发票号码 当开票类型为1时必填
开具81、82票具时此字段数据不获取
ykprq
string 
原开票日期
可选
原开票日期 当开票类型为1 时必填 格式:yyyyMMdd
开具81、82票具时此字段数据不获取
yfplx
string 
原发票类型
可选
原发票类型 当开票类型为1 时必填
开具81、82票具时此字段数据不获取
tzdbh
string 
红字信息表编号
可选
红字信息表编号 当开票类型为1,专票时必填
开具81、82票具时此字段数据不获取
chyydm
string 
冲红原因代码
可选
冲红原因代码 当开票类型为1,普票、电票时必填
1:销货退回
2:开票有误
3:服务中止
4:销售折让
开具81、82票具时此字段数据不获取
id
string 
待开id
可选
待开id(待开开票必传且只需要此字段,其他字段忽略)
djlsh
string 
单据流水号
可选
单据流水号(单据开票必传)
zrrbs
string 
自然人标识
可选
自然人标识
Y:自然人
N:非自然人(默认值)
开具发票类型为004、007、026时此字段值不获取
djType
string 
单据调用标识
可选
单据调用标识(0:第一次调用 1:第二次调用 当djlsh不为空时此值必填)
开具81、82票具时此字段数据不获取
djly
string 
单据来源
可选
单据来源 :
2单据导入, 3接口对接
djlsh和djType都不为空时。此值必填
开具81、82票具时此字段数据不获取
sjly
string 
数据来源
可选
数据来源
用户自行填写
kjly
string 
开具理由
可选
针对于开具数电发票
开具理由:
条件必传:当小规模开具3%税率时,此字段为必传
04:前期已开具3%征收率发票,发生销售折让、中止或者退回等情形需要开具红字发票,或者开票有误需要重新开具。
05:因为实际经营业务需要,放弃享受减按1%征收率征收增值税政策。
fyxm
array [object {15}] 
费用项目
可选
费用项目
tdywxx
object 
特定业务信息
可选
特定业务信息
特定要素类型代码不为空时必填(tdyslxdm为01时,此字段置空)
开具004、0007、026发票时此字段不获取
sfzsgmfyhzh
string 
是否展示购买方银行账号
可选
Y:是 N:不是
sfzsxsfyhzh 
string 
是否展示销售方银行账号
可选
Y:是 N:不是
gwmc 
string 
岗位名称
可选
不填默认为当前调用者默认岗位,否则使用当前填入的岗位名称
kpsqr 
string 
开票申请人
可选
开票申请人
示例
{
  "method": "kp",
  "object": {
    "bz": "备注",
    "sfzsgmfyhzh": "是否展示购买方银行账号",
    "sfzsxsfyhzh": "是否展示销售方银行账号",
    "fplxdm": "发票类型代码",
    "fpqqlsh": "发票请求流水号",
    "tdyslxdm": "特定要素类型代码",
    "ghdwmc": "购货单位名称",
    "ghdwsbh": "购货单位识别号",
    "ghdwdzdh": "购货单位地址电话",
    "ghdwyhzh": "购货单位开户行及账号",
    "hjje": "合计金额",
    "hjse": "合计税额",
    "jshj": "价税合计",
    "kce": "扣除额",
    "kplx": "开票类型",
    "zsfs": "征税方式",
    "yx": "推送邮箱",
    "sjh": "推送手机号",
    "kpr": "开票人",
    "skr": "收款人",
    "fhr": "复核人",
    "yfpdm": "原发票代码",
    "yfphm": "原发票号码",
    "ykprq": "原开票日期",
    "yfplx": "原发票类型",
    "tzdbh": "红字信息表编号",
    "chyydm": "冲红原因代码",
    "id": "待开id",
    "djlsh": "单据流水号",
    "zrrbs": "自然人标识",
    "djType": "单据调用标识",
    "djly": "单据来源",
    "sjly": "数据来源",
    "kjly": "开具理由",
    "gwmc": "岗位名称",
    "kpsqr": "开票申请人",
    "fyxm": [
      {
        "fphxz": "发票行性质",
        "spmc": "商品名称",
        "spbm": "税收编码",
        "ggxh": "规格型号",
        "dw": "单位",
        "dj": "单价",
        "spsl": "商品数量",
        "je": "金额",
        "sl": "税率",
        "se": "税额",
        "lslbs": "零税率标识",
        "yhzcbs": "优惠政策标识",
        "zzstsgl": "增值税特殊管理",
        "spsm": "商品税目",
        "hsbz": "含税标志"
      }
    ],
    "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": "车架号"
      }
    }
  }
}

返回响应

🟢200成功
application/json
Body
object {0}
示例
{}
上一页
账号注册
下一页
抬头联想
Built with