- 销项
- 1.接口概述
- 2.接口调用说明(分场景)
- 3.接口定义
- 1.通用接口
- 2.发票开具
- 3.发票作废红冲
- 4.辅助类接口
- 5.扫码开票
- 4.附录信息
- 进项
- 老版进项
- 公共参数说明
- 1税局对接类
- 1.1进项底账库发票查询(共享本地缓存)
- 1.2 发票勾选/撤销勾选
- 1.3 申请统计/撤销统计
- 1.4 确认签名/取消确认签名
- 1.5 获取申请统计数据
- 1.6税期获取
- 1.7全票面数据查询(实时,不落库共享)
- 1.8发票查验
- 1.9海关缴款书勾选
- 1.10入账提交
- 1.11入账调整
- 1.12发票单据绑定/解绑
- 1.13发票凭证绑定/解绑
- 1.14采集发票查询
- 1.15采集发票删除
- 1.16发票文件识别保存
- 1.17发票数据保存
- 1.18单张发票版式获取
- 1.19发票退税勾选查询
- 1.20发票退税勾选、撤销退税勾选
- 1.21退税确认勾选
- 1.22发票退税勾选统计接口
- 1.23根据确认日期区间查询已确认退税信息
- 1.24异常状态发票更新
- 1.25查询增值税用途标签状态
- 1.26查询增值税用途标签状态(海关缴款书)
- 2发票识别接口
- 3发票查验接口
- 4附录
- 申报
- 1.接口概述
- 2.接口定义
- 2.1 个税
- 2.1.1 社保接口
- 2.1.2 个税接口
- 2.1.2.1 生成批次信息-每调用一次生成一个批次ID
- 2.1.2.2 删除批次信息
- 2.1.2.3 同步人员
- 2.1.2.4 个税-查询人员报送结果
- 2.1.2.5 查询某年度符合一次性扣除6万数据
- 2.1.2.6 确认并上报某年度一次性扣除6万数据
- 2.1.2.7 同步专项附加数据
- 2.1.2.8 获取专项附加数据
- 2.1.2.9 同步收入
- 2.1.2.10获取计算结果信息-第三方调用此接口,获取个税计算结果
- 2.1.2.11 计算税款
- 2.1.2.12 查询税款计算结果
- 2.1.2.13 个税申报
- 2.1.2.14 个税申报结果查询
- 2.1.2.15 个税申报扣款
- 2.1.2.16 个税扣款结果查询
- 2.1.2.17 个税申报表获取
- 2.1.2.18 个税完税凭证获取
- 2.1.2.19 个税-作废当期申报
- 2.1.2.20 个税-更正往期申报
- 2.1.2.21 个税-撤销往期更正申报
- 2.1.2.22 个税-撤销往期更正申报
- 2.1.2.23 三方同步人员接口
- 2.1.2.24 三方同步薪资接口
- 2.1.2.25 人员信息查询接口
- 2.1.3 个税附录
- 2.2 增值税一般纳税人
- 2.3 增值税小规模
- 2.4 企业所得税预缴(查账征收)
- 2.5 印花税
- 2.6 工会经费
- 2.7 财务报表
- 2.8 发起申报缴款完税凭证
- 2.9 税种认定信息查询
- 2.10 增值税台账
- 2.11 残疾人就业保障金
- 2.12 城镇垃圾处理费
- 2.13 水利建设专项收入
- 2.14 通用申报
- 2.15 非税收入通用申报
- 2.16 企业所得税台账
- 2.17 财务报表税基
- 2.18 科目余额表
- 2.19 同步申报清册
- 2.20 房产税台账
- 2.21 城镇土地使用税
- 2.22 局端发票汇总
- 2.23 历史申报数据
- 2.24 文化事业建设费
- 2.25 企业所得税汇算清缴(年报)
- 2.26 企业所得税分支机构(年报)
- 2.1 个税
- 3.附录信息
3.5.1.订单码-全量(推送订单)
POST
https://api.baiwangjs.com/swgx-saas/agentinvoiceservice-cloudservice-cloudservice/agentiscloud/cloud/addReceiptUrl
1.场景说明#
订单码分为三种场景,详细描述如下:#
场景描述 | 调用说明 |
---|---|
返回开票url链接 | 调用共享平台接口推送订单数据,共享平台返回自助开票的链接地址,可在移动端(浏览器/APP/微信/支付宝等)中直接链接填写发票抬头和交付信息,提交开票即可;也可以将返回的链接生成二维码(加上自定义logo)供消费者自助扫码开票; 返回示例: http://wx.baiwangjs.com/saas/wechat/zzkp/zzkp.html?orderId={orderId}&qyid={qyid} |
返回二维码字节流 | 调用共享平台接口推送订单数据,共享平台返回二维码字节流,还原成二维码后供消费者自助扫码开票 |
预生成二维码 | 根据固定规则生成二维码,随后将订单信息推送至共享平台,消费者自助扫码开票,以SaaS环境为例规则如下:http://wx.baiwangjs.com/saas/wechat/zzkp/zzkp.html?ddlsh={ddlsh}&qyid={qyid} ,其中 ddlsh 为业务系统的订单号,qyid 为SaaS平台开票单位的标识 |
2.接口描述#
接口描述 | 提交开票订单信息。Base64(明文) |
---|---|
请求路径 | 返回开票url链接(或预生成二维码):/cloud/addReceiptUrl 返回二维码字节流:/cloud/addReceipt |
开放权限 | 所有企业 |
调用方式 | POST |
参数方式 | Base64(JSON格式) |
重要说明 | |
业务范围 | 数电 税控 |
接口类型 | 同步 |
请求参数
Header 参数
Content-Type
string
必需
默认值:
application/json
Date
string
必需
默认值:
{{date}}
host
string
必需
默认值:
{{host}}
x-htjs-nonce
string
必需
默认值:
{{x-htjs-nonce}}
x-htjs-ua
string
必需
默认值:
{{x-htjs-ua}}
Authorization
string
必需
默认值:
{{Authorization}}
Body 参数application/json
qyId
string
企业唯一标识
ddlsh
string
订单流水号
sksbh
string
税控设备号
xsfMc
string
销售方名称
xsfNsrsbh
string
销售方纳税人识别号
xsfDzdh
string
销售方地址电话
xsfYhzh
string
销售方银行账户
kpr
string
开票人
skr
string
收款人
fhr
string
复核人
jshj
string
价税合计
hjje
string
不含税金额
hjse
string
不含税税额
bz
string
备注
sqr
string
申请人
fplxdm
string
发票类型代码
xsfDz
string
销售方地址
xsfDh
string
销售方电话
xsfYh
string
销售方银行
xsfZh
string
销售方账户
dlzh
string
登录账号
spxxbcsm
string
商品信息补充说明
ywdjDm
string
业务单据代码
djkz1
string
扩展1
djkz2
string
扩展2
djkz3
string
扩展3
djkz4
string
扩展4
djkz5
string
扩展5
djkz6
string
扩展6
prodParam
array [object {14}]
明细参数(多条明细)
dj
string
单价(含税)
je
string
金额(含税)
lslbs
string
零税率标识
se
string
税额
sl
string
数量
slv
string
税率
spbm
string
商品编码
spmc
string
商品名称
ggxh
string
规格型号
dw
string
单位
fphxz
integer
发票行性质
yhzcbs
integer
优惠政策标识
zxbm
string
自行编码
zzstsgl
string
增值税特殊管理
hwysfwdzfpmxbList
array [object {6}]
必需
xh
string
序号
ysgjzl
string
运输工具种类
ysgjhp
string
运输工具牌号
qyd
string
起运地
ddd
string
到达地
yshwmc1
string
运输货物名称
jzfwTdys
object
建筑服务特定元素
tdzzsxmbh
string
土地增值税项目编号
jzfwfsd
string
建筑服务发生地
fullAddress
string
详细地址
jzxmmc
string
建筑项目名称
kdsbz
string
跨地市标识
bdcTdys
object
不动产经营租赁(不动产销项)
bdcdz
string
不动产地址
fullAddress
string
不动产详细地址
zlqqz
string
租赁起止日期
kdsbz
string
跨地市标识
cqzsh
string
产权证书号
dw
string
面积单位
wqhtbabh
string
网签合同备案号
tdzzsxmbh
string
土地增值税项目编号
hdjsjg
string
核定计税价格
sjcjhsje
string
实际成交含税金额
lkysfwTdysList
array [object {9}]
旅客运输服务特定元素
xh
string
序号
cxr
string
出行人
chuxrq
string
出出行日期
cxrzjlx
string
出行人证件类型
sfzjhm
string
身份证件号码
cfd
string
出发地
ddd
string
到达地
dengj
string
等级
jtgjlx
string
交通工具类型
jdcxsTdysList
array [object {19}]
机动车销售特定元素
xmmc
string
项目名称
cpxh
string
厂牌型号
cd
string
产地
hgzh
string
合格证
jkzmsh
string
进口证明书
sjdh
string
商检单号
fdjhm
string
发动机号码
clsbdh
string
车架号
cldw
string
吨位
xcrs
string
限乘人数
jshjXx
string
价税合计小写
jshjDx
string
价税合计大写
je
string
金额(不含税)
slv
string
税率
se
string
税额
wspzhm
string
完税凭证
cllxDm
string
乘用车及客车
scqymc
string
生产企业名称
bhsje
string
不含税金额
示例
{
"qyId": "企业唯一标识",
"ddlsh": "订单流水号(全局唯一)",
"sksbh": "税控设备号",
"xsfMc": "销售方名称",
"xsfNsrsbh": "销售方纳税人识别号",
"xsfDzdh": "销售方地址电话",
"xsfYhzh": "销售方银行账户",
"kpr": "开票人",
"skr": "收款人",
"fhr": "复核人",
"jshj": "价税合计",
"hjje": "合计金额",
"hjse": "合计税额",
"bz": "备注",
"sqr": "申请人",
"fplxdm": "发票类型代码",
"xsfDz": "销售方地址",
"xsfDh": "销售方电话",
"xsfYh": "销售方银行",
"xsfZh": "销售方账户",
"dlzh": "登录账号",
"spxxbcsm": "商品信息补充说明",
"ywdjDm": "DJ001",
"djkz1": "扩展1",
"djkz2": "扩展2",
"djkz3": "扩展3",
"djkz4": "扩展4",
"djkz5": "扩展5",
"djkz6": "扩展6",
"prodParam": [
{
"spmc": "商品名称",
"spbm": "商品编码",
"ggxh": "规格型号",
"dw": "单位",
"dj": "单价",
"sl": "数量",
"je": "金额",
"se": "税额",
"slv": "税率",
"fphxz": "发票行性质",
"lslbs": "零税率标识",
"yhzcbs": "优化政策标识",
"zxbm": "自行编码",
"zzstsgl": "增值税特殊管理"
}
],
"hwysfwdzfpmxbList": [
{
"xh": "序号",
"ysgjzl": "运输工具种类",
"ysgjhp": "运输工具牌号",
"qyd": "起运地",
"ddd": "到达地",
"yshwmc1": "运输货物名称"
}
],
"jzfwTdys": {
"tdzzsxmbh": "土地增值税项目编号",
"jzfwfsd": "建筑服务发生地",
"fullAddress": "详细地址",
"jzxmmc": "建筑项目名称",
"kdsbz": "跨地市标识"
},
"bdcTdys": {
"bdcdz": "不动产地址",
"fullAddress": "不动产详细地址",
"zlqqz": "租赁起止日期-03-10 2022-04-07",
"kdsbz": "跨地市标识",
"cqzsh": "产权证书号",
"dw": "单位",
"wqhtbabh": "网签合同备案号",
"tdzzsxmbh": "土地增值税项目编号",
"hdjsjg": "核定计税价格",
"sjcjhsje": "实际成交含税金额"
},
"lkysfwTdysList": [
{
"xh": "序号",
"cxr": "出行人",
"chuxrq": "出现日期",
"cxrzjlx": "出行人证件类型",
"sfzjhm": "身份证件号码",
"cfd": "出发地",
"ddd": "到达地",
"dengj": "等级",
"jtgjlx": "交通工具类型"
}
],
"jdcxsTdysList": [
{
"xmmc": "摩托车",
"cpxh": "宝马牌/BMW",
"cd": "重庆",
"hgzh": "HGZBHC12050135",
"jkzmsh": "",
"sjdh": "sjdh001",
"fdjhm": "5210F866",
"clsbdh": "CLSBDHC2050135",
"cldw": "2",
"xcrs": "5",
"jshjXx": "1000.00",
"jshjDx": "壹仟圆整",
"je": "884.96",
"slv": "0.13",
"se": "115.04",
"wspzhm": "wspzh002",
"cllxDm": "乘用车及客车",
"scqymc": "华晨宝马汽车有限公司",
"bhsje": "884.96"
}
]
}
示例代码
Shell
JavaScript
Java
Swift
Go
PHP
Python
HTTP
C
C#
Objective-C
Ruby
OCaml
Dart
R
请求示例请求示例
Shell
JavaScript
Java
Swift
curl --location --request POST 'https://api.baiwangjs.com/swgx-saas/agentinvoiceservice-cloudservice-cloudservice/agentiscloud/cloud/addReceiptUrl' \
--header 'Date;' \
--header 'host;' \
--header 'x-htjs-nonce;' \
--header 'x-htjs-ua;' \
--header 'Authorization;' \
--header 'Content-Type: application/json' \
--data-raw '{
"qyId": "企业唯一标识",
"ddlsh": "订单流水号(全局唯一)",
"sksbh": "税控设备号",
"xsfMc": "销售方名称",
"xsfNsrsbh": "销售方纳税人识别号",
"xsfDzdh": "销售方地址电话",
"xsfYhzh": "销售方银行账户",
"kpr": "开票人",
"skr": "收款人",
"fhr": "复核人",
"jshj": "价税合计",
"hjje": "合计金额",
"hjse": "合计税额",
"bz": "备注",
"sqr": "申请人",
"fplxdm": "发票类型代码",
"xsfDz": "销售方地址",
"xsfDh": "销售方电话",
"xsfYh": "销售方银行",
"xsfZh": "销售方账户",
"dlzh": "登录账号",
"spxxbcsm": "商品信息补充说明",
"ywdjDm": "DJ001",
"djkz1": "扩展1",
"djkz2": "扩展2",
"djkz3": "扩展3",
"djkz4": "扩展4",
"djkz5": "扩展5",
"djkz6": "扩展6",
"prodParam": [
{
"spmc": "商品名称",
"spbm": "商品编码",
"ggxh": "规格型号",
"dw": "单位",
"dj": "单价",
"sl": "数量",
"je": "金额",
"se": "税额",
"slv": "税率",
"fphxz": "发票行性质",
"lslbs": "零税率标识",
"yhzcbs": "优化政策标识",
"zxbm": "自行编码",
"zzstsgl": "增值税特殊管理"
}
],
"hwysfwdzfpmxbList": [
{
"xh": "序号",
"ysgjzl": "运输工具种类",
"ysgjhp": "运输工具牌号",
"qyd": "起运地",
"ddd": "到达地",
"yshwmc1": "运输货物名称"
}
],
"jzfwTdys": {
"tdzzsxmbh": "土地增值税项目编号",
"jzfwfsd": "建筑服务发生地",
"fullAddress": "详细地址",
"jzxmmc": "建筑项目名称",
"kdsbz": "跨地市标识"
},
"bdcTdys": {
"bdcdz": "不动产地址",
"fullAddress": "不动产详细地址",
"zlqqz": "租赁起止日期-03-10 2022-04-07",
"kdsbz": "跨地市标识",
"cqzsh": "产权证书号",
"dw": "单位",
"wqhtbabh": "网签合同备案号",
"tdzzsxmbh": "土地增值税项目编号",
"hdjsjg": "核定计税价格",
"sjcjhsje": "实际成交含税金额"
},
"lkysfwTdysList": [
{
"xh": "序号",
"cxr": "出行人",
"chuxrq": "出现日期",
"cxrzjlx": "出行人证件类型",
"sfzjhm": "身份证件号码",
"cfd": "出发地",
"ddd": "到达地",
"dengj": "等级",
"jtgjlx": "交通工具类型"
}
],
"jdcxsTdysList": [
{
"xmmc": "摩托车",
"cpxh": "宝马牌/BMW",
"cd": "重庆",
"hgzh": "HGZBHC12050135",
"jkzmsh": "",
"sjdh": "sjdh001",
"fdjhm": "5210F866",
"clsbdh": "CLSBDHC2050135",
"cldw": "2",
"xcrs": "5",
"jshjXx": "1000.00",
"jshjDx": "壹仟圆整",
"je": "884.96",
"slv": "0.13",
"se": "115.04",
"wspzhm": "wspzh002",
"cllxDm": "乘用车及客车",
"scqymc": "华晨宝马汽车有限公司",
"bhsje": "884.96"
}
]
}'
返回响应
🟢200成功
application/json
Body
object {0}
示例
{
"code": "0",
"message": "执行成功",
"renson": "",
"data": "二维码地址"
}
修改于 2024-09-13 09:05:46