6.5特殊票种-住房租赁

接口描述	1.支持税控增值税专用发票、增值税普通发票、增值税普通发票（卷式）、增值税电子普通发票、增值税电子专用发票的开具，另外包括税控红字发票开具； 2.支持数电票（增值税专用发票）、数电票（普通发票）、数电纸质发票（增值税专用发票）、数电纸质发票（普通发票）、数电纸质发票（机动车统一销售发票）、数电纸质发票（二手车统一销售发票）的开具以及特殊票种开具； 3.该接口暂不支持数电红字发票开具；
请求路径	/cloud/v2/applyInvoice
开放权限	所有企业
调用方式	POST
参数方式	Base64（JSON格式）
重要说明	本接口不支持数电红字发票开具
业务范围	数电、税控
接口类型	异步

6.1简易回调报文

6.1.1报文示例

{
  "ywlxdm":"fpkj",
  "ddlsh":"发票请求流水号",
  "status":"发票状态",
  "qdfphm":"全电发票号码",
  "fpdm":"发票代码",
  "fphm":"发票号码",
  "kprq":"开票日期",
  "jshj":"价税合计",
  "hjje":"合计金额",
  "hjse":"合计税额",
  "djbh":"单据编号",
  "djbhs":["原始单据编号","原始单据编号"],
  "ycyy":"异常原因"
}

6.1.2参数说明

参数名称	名称	长度	必须	说明
ywlxdm	业务类型代码	4	是	fpkj
ddlsh	订单流水号	40	是	入参的ddlsh
status	请求状态	5	是	1开具成功 2 开具失败 3 已开具未生成PDF（税控电子票） 1004 需要登录 1003 需要认证
qdfphm	全电发票号码	20	否
fpdm	发票代码	8	否	税控发票/数电纸票
fphm	发票号码	12	否	税控发票/数电纸票
kprq	开票日期	20	否	yyyymmddhhmmsssss
jshj	价税合计	10	否
hjje	不含税金额	12	否
hjse	不含税税额	12	否
djbh	单据编号	20	否	单据拆分：拆分后单据编号单据合并：合并后单据编号单据不拆分不合并：入参的djbh
djbhs	原始单据编号	20	否	单据拆分：拆分前单据编号单据合并：合并前单据编号单据不拆分不合并：入参的djbh
ycyy	异常原因	200	否

注：当开票请求参数中参数【sfdj】取值为“否（0）”时，【djbh】和【djbhs】节点为空；值为“是（1）”时，第三方通过接口先把单据存到百旺系统，然后登录百旺系统手动开具(可以对单据拆分、合并)，开票成功后才回调。

6.2全量回调报文

6.2.1报文示例

{
    "ywlxdm": "fpkj",  
    "ddlsh": "202401*******47258951",
    "status": 1,
    "zsfs": "normal",
    "ewm": "MDE******************************************DAyQw==",
    "fplxdm": "02",
    "gmfDh": "021-*****062",
    "gmfDz": "中国**********530号A5库",
    "gmfNsrsbh": "91************487D",
    "gmfMc": "上海***************公司",
    "gmfYh": "中国************支行",
    "gmfZh": "100************1508",
    "hjje": "188.68",
    "kprq": "20240111142522",
    "qdfphm": "243120000000******75",
    "xsfDh": "60****89",
    "xsfDz": "中国***************515号5楼",
    "xsfMc": "上海***************公司",
    "xsfYh": "工行***************支行",
    "xsfZh": "100*************184",
    "djbh":"单据编号",
    "djbhs":["原始单据编号","原始单据编号"],
    "ycyy": "",
    "detailParam": [{
        "fphxz": "normal",
        "spmc": "操作服务费",
        "spbm": "3040407990000000000",
        "bhsJe": 188.68,
        "slv": 0.060,
        "se": 11.32,
        "je": 200.00,
        "lslbs": "normalTax"
    }
    ]
}

6.2.2参数说明

参数名称	名称	长度	必须	说明
ywlxdm	业务类型代码	4	是	fpkj
ddlsh	订单流水号	40	是	入参的ddlsh
status	请求状态	5	是	1开具成功 2 开具失败 3 已开具未生成PDF（税控电子票） 1004 需要登录 1003 需要认证
zsfs	征收方式	1	否	0 普通征税（默认） 1 减按计增 2 差额征收-差额开票 3 差额征收-全额开票
ewm	二维码	100	否	发票二维码内容（Base64编码）
fplxdm	发票类型代码	3	否	【税控】 026：电子发票 007：普通发票 004：专用发票 025：卷票 028：电子专用发票【数电】 01：全电专票 02：全电普票
gmfDh	购方电话	20	否
gmfDz	购方地址	100	否
gmfNsrsbh	购方税号	20	否
gmfMc	购买方名称	100	否
gmfYh	购方银行名称	100	否
gmfZh	购方银行账号	20	否
hjje	不含税金额	12	否
kprq	开票日期	20	否	yyyymmddhhmmsssss
qdfphm	全电发票号码	20	否	数电票/数电纸票
fpdm	发票代码	12	否	税控发票/数电纸票
fphm	发票号码	8	否	税控发票/数电纸票
xsfDh	销方电话	20	否
xsfDz	销方地址	100	否
xsfMc	销方名称	100	否
xsfYh	销方银行名称	100	否
xsfZh	销方银行账号	20	否
djbh	单据编号	20	否	单据拆分：拆分后单据编号单据合并：合并后单据编号单据不拆分不合并：入参的djbh
djbhs	原始单据编号	20	否	单据拆分：拆分前单据编号单据合并：合并前单据编号单据不拆分不合并：入参的djbh
ycyy	异常原因	200	否
detailParam	发票明细信息，数组对象
fphxz	发票行性质	1	否	0 正常行 1 折扣行 (折扣票金额负) 2 被折扣行'(折扣票金额正)
spmc	商品名称	150	否
spbm	商品编码	40	否
bhsJe	不含税金额	12	否
slv	税率	6	否
se	税额	12	否
je	价税合计	12	否
yhzcbs	优惠政策标识	1	否	0 是正常税率 1是免税 2是不征税 3普通零税率

注：当开票请求参数中参数【sfdj】取值为“否（0）”时，返回报文中【djbh】和【djbhs】节点为空；取值为“是（1）”时，开票成功后回调【djbh】和【djbhs】字段。

6.3版式示例报文

6.3.1示例报文

{
    "ywlxdm":"qdbswj",
    "ddlsh":"已开具发票请求流水号",
    "status":"生成状态",
    "ofdurl":"ofd地址",
    "pdf":"pdf地址",
    "xmlurl":"xml地址",
    "jfdz":"局端交付地址",
    "ycyy":"异常原因"
}

6.3.2版式参数说明

参数	名称	长度	必须	说明
ywlxdm	业务类型	30	是	qdbswj发票开具
ddlsh	已开具发票请求流水号	40	是
status	请求状态	10	是	1成功 2失败 1004 需要登录 1003 需要认证
ofdurl	ofd地址	100	否	地址时效：永久
pdf	pdf地址	100	否	地址时效：永久
xmlurl	xml地址	100	否	地址时效：永久
jfdz	局端交付地址	200	否	局端交付地址，打开为局端发票下载页面
ycyy	异常原因	200	否

请求参数

Header 参数

Body 参数application/json

示例

{
    "kplx": "0",
    "ykprq": "",
    "kce": "",
    "hjje": "",
    "spflxconfirm": "",
    "xsfMc": "上海****运营有限公司",
    "gmfEmail": "",
    "yfplx": "",
    "xsfDz": "上海市**********206-2室",
    "xsfDh": "021-5*****0772",
    "xsfYh": "招商银*****支行",
    "xsfZh": "1219*****202",
    "dlzh": "913101******1G",
    "gmfDz": "购买方地址",
    "gmfDh": "购买方电话",
    "gmfYh": "购买方银行",
    "gmfZh": "购买方账号",
    "skr": "",
    "qdbz": "0",
    "gmfNsrsbh": "11310******9340M",
    "sksbh": "9131010*****781G",
    "gmfMc": "上海市*******道办事处",
    "kpr": "凌*艳",
    "sfdj": "",
    "xsfNsrsbh": "9131********81G",
    "yfpHm": "",
    "fplxdm": "02",
    "yfpDm": "",
    "jshj": "",
    "sfzsxsfyhzh": "Y",
    "fpDm": "",
    "checkAudit": "0",
    "sfzsgmfyhzh": "Y",
    "detailParam": [
        {
            "ggxh": "套",
            "yhzcbs": "1",
            "zzstsgl": "免税",
            "spmc": "公租房租金",
            "dj": "6578.00",
            "zxbm": "",
            "fphxz": "0",
            "lslbs": "1",
            "hsbz": "0",
            "se": "",
            "dw": "月",
            "sl": "1",
            "je": "6578.00",
            "slv": "0.0",
            "spbm": "3040502020101000000"
        }
    ],
    "sfwzzfp": "",
    "gmfzrrbs": "",
    "gmfMobile": "",
    "cktslxDm": "",
    "sqr": "凌*艳",
    "qyId": "231017******1402",
    "bz": " 陈**",
    "bmbBbh": "",
    "fpHm": "",
    "djbh": "",
    "hjse": "",
    "zpFppzdm": "",
    "bdcTdys": {
        "kdsbz": "N",
        "zlqqz": "2024-01-01 2024-03-10",
        "dw": "平方米",
        "bdcdz": "上海市*****68弄",
        "fullAddress": "2号***室",
        "cqzsh": "沪房地长字（2015）第006630号"
    },
    "chyydm": "",
    "cloudData": "",
    "ddlsh": "8B0107E70C080*********947658",
    "fhr": "",
    "sslkjly": "",
    "ywdjDm": "",
    "ncpsgzjlx": "",
    "tspz": "06",
    "zsfs": "0",
    "tzdbh": ""
}

请求示例代码

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

curl --location --request POST 'https://api.baiwangjs.com/swgx-saas/agentinvoiceservice-cloudservice-cloudservice/agentiscloud/cloud/v2/applyInvoice' \
--header 'Date: ' \
--header 'host: ' \
--header 'x-htjs-nonce: ' \
--header 'x-htjs-ua: ' \
--header 'Authorization: ' \
--header 'Content-Type: application/json' \
--data-raw '{
    "kplx": "0",
    "ykprq": "",
    "kce": "",
    "hjje": "",
    "spflxconfirm": "",
    "xsfMc": "上海****运营有限公司",
    "gmfEmail": "",
    "yfplx": "",
    "xsfDz": "上海市**********206-2室",
    "xsfDh": "021-5*****0772",
    "xsfYh": "招商银*****支行",
    "xsfZh": "1219*****202",
    "dlzh": "913101******1G",
    "gmfDz": "购买方地址",
    "gmfDh": "购买方电话",
    "gmfYh": "购买方银行",
    "gmfZh": "购买方账号",
    "skr": "",
    "qdbz": "0",
    "gmfNsrsbh": "11310******9340M",
    "sksbh": "9131010*****781G",
    "gmfMc": "上海市*******道办事处",
    "kpr": "凌*艳",
    "sfdj": "",
    "xsfNsrsbh": "9131********81G",
    "yfpHm": "",
    "fplxdm": "02",
    "yfpDm": "",
    "jshj": "",
    "sfzsxsfyhzh": "Y",
    "fpDm": "",
    "checkAudit": "0",
    "sfzsgmfyhzh": "Y",
    "detailParam": [
        {
            "ggxh": "套",
            "yhzcbs": "1",
            "zzstsgl": "免税",
            "spmc": "公租房租金",
            "dj": "6578.00",
            "zxbm": "",
            "fphxz": "0",
            "lslbs": "1",
            "hsbz": "0",
            "se": "",
            "dw": "月",
            "sl": "1",
            "je": "6578.00",
            "slv": "0.0",
            "spbm": "3040502020101000000"
        }
    ],
    "sfwzzfp": "",
    "gmfzrrbs": "",
    "gmfMobile": "",
    "cktslxDm": "",
    "sqr": "凌*艳",
    "qyId": "231017******1402",
    "bz": " 陈**",
    "bmbBbh": "",
    "fpHm": "",
    "djbh": "",
    "hjse": "",
    "zpFppzdm": "",
    "bdcTdys": {
        "kdsbz": "N",
        "zlqqz": "2024-01-01 2024-03-10",
        "dw": "平方米",
        "bdcdz": "上海市*****68弄",
        "fullAddress": "2号***室",
        "cqzsh": "沪房地长字（2015）第006630号"
    },
    "chyydm": "",
    "cloudData": "",
    "ddlsh": "8B0107E70C080*********947658",
    "fhr": "",
    "sslkjly": "",
    "ywdjDm": "",
    "ncpsgzjlx": "",
    "tspz": "06",
    "zsfs": "0",
    "tzdbh": ""
}'

6.1简易回调报文#

6.1.1报文示例#

6.1.2参数说明#

注：当开票请求参数中参数【sfdj】取值为“否（0）”时，【djbh】和【djbhs】节点为空；值为“是（1）”时，第三方通过接口先把单据存到百旺系统，然后登录百旺系统手动开具(可以对单据拆分、合并)，开票成功后才回调。#

6.2全量回调报文#

6.2.1报文示例#

6.2.2参数说明#

注：当开票请求参数中参数【sfdj】取值为“否（0）”时，返回报文中【djbh】和【djbhs】节点为空；取值为“是（1）”时，开票成功后回调【djbh】和【djbhs】字段。#

6.3版式示例报文#

6.3.1示例报文#

6.3.2版式参数说明#

请求参数

请求示例代码

返回响应

6.1简易回调报文

6.1.1报文示例

6.1.2参数说明

注：当开票请求参数中参数【sfdj】取值为“否（0）”时，【djbh】和【djbhs】节点为空；值为“是（1）”时，第三方通过接口先把单据存到百旺系统，然后登录百旺系统手动开具(可以对单据拆分、合并)，开票成功后才回调。

6.2全量回调报文

6.2.1报文示例

6.2.2参数说明

注：当开票请求参数中参数【sfdj】取值为“否（0）”时，返回报文中【djbh】和【djbhs】节点为空；取值为“是（1）”时，开票成功后回调【djbh】和【djbhs】字段。

6.3版式示例报文

6.3.1示例报文

6.3.2版式参数说明