6.8机动车销售统一发票-数电纸质

接口描述	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

示例

{
        "qyId": "2403111****50101443",
        "ddlsh": "jdc20240312001",
        "sksbh": "9299****5662",
        "fplxdm": "03",
        "kplx": "0",
        "tspz": "00",
        "zsfs": "0",
        "qdbz": "0",
        "sfwzzfp": "Y",
        "zpFppzdm": "000008102600",
        "xsfMc": "重庆盛*****售有限公司",
        "xsfNsrsbh": "915001*****1817891",
        "xsfDz": "重庆****龙溪路78号",
        "xsfDh": "023-68****966",
        "xsfYh": "中国建设银*****处",
        "xsfZh": "50001093*****0201592",
        "gmfMc": "冯**",
        "gmfNsrsbh": "4113021994****0027",
        "gmfDz": "购买方地址",
        "gmfDh": "购买方电话",
        "gmfYh": "购买方银行",
        "gmfZh": "购买方账号",
        "gmfMobile": "153****3399",
        "gmfEmail": "820****20@qq.com",
        "kpr": "尹**",
        "sqr": "1214***kehu",
        "dlzh": "133****2462",
        "sfdj": "0",
        "djbh": "jdcdj20240312001",
        "gmfzrrbs": "Y",
        "qtzjhm": "",
        "vinCode": "LBPPCK*****041019",
        "djkz1": "河南省",
        "djkz2": "郑州市",
        "djkz3": "宁馨苑",
        "djkz4": "333",
        "djkz5": "555",
        "djkz6": "666",
        "detailParam": [
                {
                        "fphxz": "0",
                        "hsbz": "1",
                        "spmc": "摩托车",
                        "spbm": "1090312010000000000",
                        "je": "884.96",
                        "slv": "0.13",
                        "lslbs": "0",
                        "yhzcbs": "0"
                }
        ],
        "jdcxsTdysList": [
                {
                        "xmmc": "摩托车",
                        "cpxh": "JYM150-7",
                        "cd": "重庆",
                        "hgzh": "MY1032311005134",
                        "jkzmsh": "",
                        "sjdh": "sjdh001",
                        "fdjhm": "JYM157FMJ-4",
                        "clsbdh": "LBPPCKM01P0041019",
                        "cldw": "1",
                        "xcrs": "2",
                        "jshjXx": "1000.00",
                        "jshjDx": "壹仟圆整",
                        "je": "884.96",
                        "slv": "0.13",
                        "se": "115.04",
                        "wspzhm": "wspzh002",
                        "cllxDm": "乘用车及客车",
                        "scqymc": "华晨宝马汽车有限公司",
                        "bhsje": "884.96"
                }
        ]
}

请求示例代码

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 '{
        "qyId": "2403111****50101443",
        "ddlsh": "jdc20240312001",
        "sksbh": "9299****5662",
        "fplxdm": "03",
        "kplx": "0",
        "tspz": "00",
        "zsfs": "0",
        "qdbz": "0",
        "sfwzzfp": "Y",
        "zpFppzdm": "000008102600",
        "xsfMc": "重庆盛*****售有限公司",
        "xsfNsrsbh": "915001*****1817891",
        "xsfDz": "重庆****龙溪路78号",
        "xsfDh": "023-68****966",
        "xsfYh": "中国建设银*****处",
        "xsfZh": "50001093*****0201592",
        "gmfMc": "冯**",
        "gmfNsrsbh": "4113021994****0027",
        "gmfDz": "购买方地址",
        "gmfDh": "购买方电话",
        "gmfYh": "购买方银行",
        "gmfZh": "购买方账号",
        "gmfMobile": "153****3399",
        "gmfEmail": "820****20@qq.com",
        "kpr": "尹**",
        "sqr": "1214***kehu",
        "dlzh": "133****2462",
        "sfdj": "0",
        "djbh": "jdcdj20240312001",
        "gmfzrrbs": "Y",
        "qtzjhm": "",
        "vinCode": "LBPPCK*****041019",
        "djkz1": "河南省",
        "djkz2": "郑州市",
        "djkz3": "宁馨苑",
        "djkz4": "333",
        "djkz5": "555",
        "djkz6": "666",
        "detailParam": [
                {
                        "fphxz": "0",
                        "hsbz": "1",
                        "spmc": "摩托车",
                        "spbm": "1090312010000000000",
                        "je": "884.96",
                        "slv": "0.13",
                        "lslbs": "0",
                        "yhzcbs": "0"
                }
        ],
        "jdcxsTdysList": [
                {
                        "xmmc": "摩托车",
                        "cpxh": "JYM150-7",
                        "cd": "重庆",
                        "hgzh": "MY1032311005134",
                        "jkzmsh": "",
                        "sjdh": "sjdh001",
                        "fdjhm": "JYM157FMJ-4",
                        "clsbdh": "LBPPCKM01P0041019",
                        "cldw": "1",
                        "xcrs": "2",
                        "jshjXx": "1000.00",
                        "jshjDx": "壹仟圆整",
                        "je": "884.96",
                        "slv": "0.13",
                        "se": "115.04",
                        "wspzhm": "wspzh002",
                        "cllxDm": "乘用车及客车",
                        "scqymc": "华晨宝马汽车有限公司",
                        "bhsje": "884.96"
                }
        ]
}'

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版式参数说明