6.7特殊票种-旅客运输服务

接口描述	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",
        "fpDm": "",
        "checkAudit": "0",
        "lkysfwTdysList": [
                {
                        "xh": "24012800013046",
                        "cfd": "出发地地址",
                        "dengj": "",
                        "cxrzjlx": "201",
                        "ddd": "到达地地址",
                        "chuxrq": "2024-01-28（出发日期）",
                        "sfzjhm": "旅客身份证号",
                        "cxr": "旅客姓名",
                        "jtgjlx": "交通工具类型（参考附录）"
                }
        ],
        "detailParam": [
                {
                        "ggxh": "",
                        "yhzcbs": "0",
                        "spmc": "运输服务",
                        "dj": "222.77",
                        "fphxz": "0",
                        "lslbs": "0",
                        "hsbz": "0",
                        "se": "2.23",
                        "dw": "次",
                        "sl": "1",
                        "je": "222.77",
                        "slv": 0.01,
                        "spbm": "3010101020101010000"
                }
        ],
        "gmfMobile": "",
        "gmfEmail": "购方邮箱",
        "xsfMc": "〇〇有限公司",
        "sqr": "开票员姓名",
        "qyId": "企业ID",
        "bz": "备注",
        "xsfDz": "上海市**********206-2室",
        "xsfDh": "021-5*****0772",
        "xsfYh": "招商银*****支行",
        "xsfZh": "1219*****202",
        "bmbBbh": "",
        "dlzh": "开票员登录电局账号",
        "gmfDz": "购买方地址",
        "gmfDh": "购买方电话",
        "gmfYh": "购买方银行",
        "gmfZh": "购买方账号",
        "fpHm": "",
        "qdbz": "0",
        "gmfNsrsbh": "购方税号",
        "sksbh": "销方税号",
        "gmfMc": "购方企业名称",
        "sfdj": "0",
        "kpr": "开票员姓名",
        "xsfNsrsbh": "销方税号",
        "ddlsh": "唯一流水号（自定义）",
        "fplxdm": "数电专票传01、数电普票传02",
        "ywdjDm": "回调单据代码",
        "tspz": "09",
        "zsfs": "0"
}

示例代码

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",
        "fpDm": "",
        "checkAudit": "0",
        "lkysfwTdysList": [
                {
                        "xh": "24012800013046",
                        "cfd": "出发地地址",
                        "dengj": "",
                        "cxrzjlx": "201",
                        "ddd": "到达地地址",
                        "chuxrq": "2024-01-28（出发日期）",
                        "sfzjhm": "旅客身份证号",
                        "cxr": "旅客姓名",
                        "jtgjlx": "交通工具类型（参考附录）"
                }
        ],
        "detailParam": [
                {
                        "ggxh": "",
                        "yhzcbs": "0",
                        "spmc": "运输服务",
                        "dj": "222.77",
                        "fphxz": "0",
                        "lslbs": "0",
                        "hsbz": "0",
                        "se": "2.23",
                        "dw": "次",
                        "sl": "1",
                        "je": "222.77",
                        "slv": 0.01,
                        "spbm": "3010101020101010000"
                }
        ],
        "gmfMobile": "",
        "gmfEmail": "购方邮箱",
        "xsfMc": "〇〇有限公司",
        "sqr": "开票员姓名",
        "qyId": "企业ID",
        "bz": "备注",
        "xsfDz": "上海市**********206-2室",
        "xsfDh": "021-5*****0772",
        "xsfYh": "招商银*****支行",
        "xsfZh": "1219*****202",
        "bmbBbh": "",
        "dlzh": "开票员登录电局账号",
        "gmfDz": "购买方地址",
        "gmfDh": "购买方电话",
        "gmfYh": "购买方银行",
        "gmfZh": "购买方账号",
        "fpHm": "",
        "qdbz": "0",
        "gmfNsrsbh": "购方税号",
        "sksbh": "销方税号",
        "gmfMc": "购方企业名称",
        "sfdj": "0",
        "kpr": "开票员姓名",
        "xsfNsrsbh": "销方税号",
        "ddlsh": "唯一流水号（自定义）",
        "fplxdm": "数电专票传01、数电普票传02",
        "ywdjDm": "回调单据代码",
        "tspz": "09",
        "zsfs": "0"
}'

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