6.4差额征收发票开具

POST

https://api.baiwangjs.com/swgx-saas/agentinvoiceservice-cloudservice-cloudservice/agentiscloud/cloud/v2/applyInvoice

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

Content-Type

string

必需

默认值:

application/json

Date

string

必需

默认值:

host

string

必需

默认值:

x-htjs-nonce

string

必需

默认值:

x-htjs-ua

string

必需

默认值:

Authorization

string

必需

默认值:

Body 参数application/json

qyId

string

企业唯一标识

必需

通过1.1接口获去（只需一次）

ddlsh

string

订单流水号

必需

要求全局唯一，对同一笔订单，如果开具失败，重新发起这一笔时，需传原ddlsh

sksbh

string

税控设备号

必需

税盘：传盘号（支持多盘）；全电：传销方税号；税控服务器核心板：传开票终端代码（通过接口2.2查询）

bmbBbh

string

编码表版本号

可选

fplxdm

string

发票类型代码

必需

【税控】
026：电子发票
007：普通发票
004：专用发票
025：卷票
028：电子专用发票
【数电】
01：数电专票
02：数电普票
03：机动车纸票
04：二手车纸票
如果是数电纸票，节点sfwzzfp传Y

kplx

integer

开票类型

必需

0：蓝字发票 1：红字发票

fpDm

string

发票代码

可选

fpHm

string

发票号码

可选

tspz

string

特殊票种

必需

00 默认【税控】 02农产品收购(收购票) 08成品油 16 矿产品【数电】 03 建筑服务 01成品油 04货物运输服务 05不动产销售 06 不动产经营租赁服务 09旅客运输服务 0200稀土 1400机动车专用发票 1600 农产品收购 1200 农产品销售 51 正向开具(二手车市场、二手车拍卖固定、二手车经销正向) 52 反向开具(二手车经销反向)

zsfs

integer

征收方式

必需

0 普通征税（默认） 1 减按计征 2 差额征收-差额开票 3 差额征收-全额开票

qdbz

string

清单标识

必需

0 非清单（数电传此项） 1 清单(纸质超过8行默认清单票)

xsfMc

string

销售方名称

必需

xsfNsrsbh

string

销售方纳税人识别号

必需

xsfDz

string

销售方地址

必需

卷票不填，其他票种必填

xsfDh

string

销售方电话

必需

卷票不填，其他票种必填

xsfYh

string

销售方银行

必需

卷票不填，其他票种必填

xsfZh

string

销售方账号

必需

卷票不填，其他票种必填

gmfMc

string

购买方名称

必需

购方是自然人时，gmfzrrbs传Y；购方非自然人，并且名称小于5个字时，gmfzrrbs传N，spflxconfirm传0

gmfNsrsbh

string

购买方纳税人识别号

可选

如果特殊票种是全电农产品收购，填写对应的证件号码

gmfDz

string

购买方地址

可选

gmfDh

string

购买方电话

可选

gmfYh

string

购买方银行

可选

gmfZh

string

购买方账号

可选

gmfMobile

string

购买方手机号

可选

电票填写(发送PDF地址) 手机号和邮箱，默认交付规则：两项都不传，都不发，只传任意一项，发对应项，两项都传，只发邮箱

gmfEmail

string

购买方邮箱

可选

1.电票填写(发送PDF地址)； 2.支持传入多个邮箱，采用英文逗号【,】分隔 3.多邮箱请勿超过字段允许长度

kpr

string

开票人姓名

必需

电子税务局登录账号（dlzh）对应开票员的姓名

kprId

string

开票人ID

可选

skr

string

收款人

可选

fhr

string

复核人

可选

jshj

string

价税合计

可选

小数点2位

hjje

string

不含税金额

可选

小数点2位

hjse

string

税额

可选

小数点2位

string

备注

可选

200(汉字)

yfpDm

string

原发票代码

可选

红字发票必填

yfpHm

string

原发票号码

可选

红字发票必填

tzdbh

string

通知单编号

可选

专票红冲必填

sqr

string

申请人

必需

开票员在SaaS平台注册的姓名，一般与kpr相同

sslkjly

string

小规模开具1%，3%发票理由

可选

(开具1%，3%税率必填)
1、2022年3月31日前发生纳税义务。
2、前期已开具相应征收率发票，因发生销售折让、中止或者退回等情形需要开具红字发票，或者开票有误需要重新开具。
3、因实际经营业务需要，放弃享受免征增值税政策。

ykprq

string

原开票日期

可选

电票、普票、卷票、专票红冲 (格式：YYYYMMDD)

kce

string

扣除额

可选

小数点2位

yfplx

string

原发票类型

可选

电票、普票、卷票红冲原发票类型：【税控】 026：电子发票 007：普通发票 004：专用发票 025：卷票 028：电子专用发票【数电】 01：全电专票 02：全电普票

chyydm

string

冲红原因代码

可选

电票、普票、卷票红冲冲红原因代码： 1-销货退回； 2-开票有误； 3-服务中止； 4-销售折让；

dlzh

string

局端登录账号

必需

数电票必填（其他可不填），开票员登录电子税务局的账号，一般为手机号

zjhm

string

增值税号

可选

sfwzzfp

string

是否为纸质发票

可选

Y是 N不是

pzDetailParam

array [object {11}]

差额票种明细

可选

pzlx

string

凭证类型

必需

01 全电发票
02 增值税发票
03 增值税普通发票
04 营业税发票
05 财政票据
06 法院裁决书
07 契税完税凭证
08 其他发票类
09 其他扣除凭证

kjrq

string

开具日期

必需

格式2024-04-11

hjje

string

凭证合计金额

必需

小数点2位

pzhjje

string

凭证合计金额

必需

小数点2位

kce

string

扣除额

必需

小数点2位

bckcje

string

本次扣除额

必需

小数点2位

string

备注

必需

社保4730.4,公积金1100,服务费280,

string

录入类型

必需

接口录入

fpdm

string

发票代码

可选

fphm

string

发票号码

可选

zzfphm

string

增值税发票号码

可选

detailParam

array [object {14}]

明细参数(多条明细)

必需

fphxz

string

发票行性质

必需

0 正常行
1 折扣行 (折扣票金额负，正票折扣行: 金额、税额是负数，规格型号、单位、单价、数量必须为空 )
2 被折扣行'(折扣票金额正)

hsbz

string

含税标识

必需

0:不含税 1:含税 (默认) 与明细内dj和je节点的值相关联

spmc

string

商品名称

必需

spbm

string

商品编码

必需

ggxh

string

规格型号

可选

1.卷票必须为空；
2.数电开票时，当【特殊票种】取值为“建筑服务”、“不动产销售”和“不动产经营租赁”，必须为空；
3.当【特殊票种】取值为“机动车专用发票1400”时，规格型号为车架号；

string

单位

可选

1.卷票必须为空； 2.数电开票时，当【特殊票种】取值为“建筑服务”、“不动产销售”和“不动产经营租赁”，必须为空； 3.数电开票时，当【特殊票种】取值为“稀土”时，只能为吨或公斤；

string

单价

可选

1.最长保留10位小数 2.白盘最多6位小数 3.数电开票时，当【特殊票种】取值为“建筑服务”时，必须为空； 4.特殊票种为06（不动产）时，必填

string

金额

必需

保留2位小数

string

税额

可选

1.保留2位小数 2.二手车销售统一发票该字段必须传0

slv

string

税率

必需

最多3位小数

lslbs

string

零税率标识

必需

0 是正常税率 1是免税 2是不征税 3普通零税率

yhzcbs

string

优惠政策标识

可选

0不使用 1使用

zxbm

string

商品编码

可选

商品编码

zzstsgl

string

增值税特殊管理

可选

优惠政策标识yhzcbs为1时，必须填写内容：
免税
100%先征后退
50%先征后退
不征税
先征后退
即征即退100%
即征即退30%
即征即退50%
即征即退70%
按3%简易征收
按5%简易征收
按5%简易征收减按1.5%计征
稀土产品
简易征收
超税负12%即征即退
超税负3%即征即退
超税负8%即征即退

示例

{
  "qyId": "2309061*****91407376",
  "ddlsh": "my*****066",
  "sksbh": "91310112MACFTD7T84",
  "bmbBbh": "",
  "fplxdm": "02",
  "kplx": 0,
  "fpDm": "",
  "fpHm": "",
  "tspz": "00",
  "zsfs": 2,
  "qdbz": "0",
  "xsfMc": "上海*****有限公司",
  "xsfNsrsbh": "9131*****7T84",
  "xsfDz": "上海市**********206-2室",
  "xsfDh": "021-5*****0772",
  "xsfYh": "招商银*****支行",
  "xsfZh": "1219*****202",
  "gmfMc": "上海***************有限公司",
  "gmfNsrsbh": "911*****861J",
  "gmfDz": "购买方地址",
  "gmfDh": "购买方电话",
  "gmfYh": "购买方银行",
  "gmfZh": "购买方账号",
  "gmfMobile": "",
  "gmfEmail": "zh*****@ca*****und.com.cn",
  "kpr": "丁*婷",
  "kprId": "",
  "skr": "",
  "fhr": "",
  "jshj": "6110.40",
  "hjje": "6097.07",
  "hjse": "13.33",
  "bz": "社保4730.4,公积金1100,服务费280,",
  "yfpDm": "",
  "yfpHm": "",
  "tzdbh": "",
  "sqr": "丁*婷",
  "sslkjly": "",
  "ykprq": "",
  "kce": "5830.40",
  "yfplx": "",
  "chyydm": "",
  "dlzh": "135****5715",
  "zjhm": "",
  "sfwzzfp": "N",
  "pzDetailParam": [
    {
      "pzlx": "09",
      "kjrq": "2024-04-11",
      "hjje": "6097.07",
      "pzhjje": "6097.07",
      "kce": "5830.40",
      "bckcje": "5830.40",
      "bz": "社保4730.4,公积金1100,服务费280,",
      "ly": "接口录入",
      "fpdm": "",
      "fphm": "",
      "zzfphm": ""
    }
  ],
  "detailParam": [
    {
      "fphxz": "0",
      "hsbz": "1",
      "spmc": "服务费",
      "spbm": "3040803010000000000",
      "ggxh": "",
      "dw": "",
      "dj": "",
      "je": "6110.40",
      "se": "13.33",
      "slv": "0.05",
      "lslbs": "0",
      "yhzcbs": "0",
      "zxbm": "",
      "zzstsgl": ""
    }
  ]
}

示例代码

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": "2309061*****91407376",
    "ddlsh": "my*****066",
    "sksbh": "91310112MACFTD7T84",
    "bmbBbh": "",
    "fplxdm": "02",
    "kplx": 0,
    "fpDm": "",
    "fpHm": "",
    "tspz": "00",
    "zsfs": 2,
    "qdbz": "0",
    "xsfMc": "上海*****有限公司",
    "xsfNsrsbh": "9131*****7T84",
    "xsfDz": "上海市**********206-2室",
    "xsfDh": "021-5*****0772",
    "xsfYh": "招商银*****支行",
    "xsfZh": "1219*****202",
    "gmfMc": "上海***************有限公司",
    "gmfNsrsbh": "911*****861J",
    "gmfDz": "购买方地址",
    "gmfDh": "购买方电话",
    "gmfYh": "购买方银行",
    "gmfZh": "购买方账号",
    "gmfMobile": "",
    "gmfEmail": "zh*****@ca*****und.com.cn",
    "kpr": "丁*婷",
    "kprId": "",
    "skr": "",
    "fhr": "",
    "jshj": "6110.40",
    "hjje": "6097.07",
    "hjse": "13.33",
    "bz": "社保4730.4,公积金1100,服务费280,",
    "yfpDm": "",
    "yfpHm": "",
    "tzdbh": "",
    "sqr": "丁*婷",
    "sslkjly": "",
    "ykprq": "",
    "kce": "5830.40",
    "yfplx": "",
    "chyydm": "",
    "dlzh": "135****5715",
    "zjhm": "",
    "sfwzzfp": "N",
    "pzDetailParam": [
        {
            "pzlx": "09",
            "kjrq": "2024-04-11",
            "hjje": "6097.07",
            "pzhjje": "6097.07",
            "kce": "5830.40",
            "bckcje": "5830.40",
            "bz": "社保4730.4,公积金1100,服务费280,",
            "ly": "接口录入",
            "fpdm": "",
            "fphm": "",
            "zzfphm": ""
        }
    ],
    "detailParam": [
        {
            "fphxz": "0",
            "hsbz": "1",
            "spmc": "服务费",
            "spbm": "3040803010000000000",
            "ggxh": "",
            "dw": "",
            "dj": "",
            "je": "6110.40",
            "se": "13.33",
            "slv": "0.05",
            "lslbs": "0",
            "yhzcbs": "0",
            "zxbm": "",
            "zzstsgl": ""
        }
    ]
}'

返回响应

🟢200成功

application/json

Body

code

string

返回代码

必需

0成功，其它失败

message

string

返回信息

必需

成功/失败

renson

string

描述

必需

失败原因具体描述

jfmUrl

string

交付码url

必需

gdJfmUrl

string

固定交付码url

必需

以SaaS环境为例规则如下：http://wx.baiwangjs.com/saas/wechat/jfm/jfmRes.html?type=invoice&ysddh={订单流水号}&qyid={企业id}，其中 ysddh为请求报文的订单流水号（ddlsh），qyid为SaaS平台开票单位的标识

示例

{
  "code": "0",
  "message": "成功",
  "renson": "",
  "jfmUrl": "",
  "gdJfmUrl": ""
}

修改于 2024-09-13 07:47:52

6.3折扣行发票开具

6.5特殊票种-住房租赁

6.4差额征收发票开具

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