场景描述 | 调用说明 |
---|---|
返回开票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平台开票单位的标识 |
接口描述 | 提交开票订单信息。Base64(明文) |
---|---|
请求路径 | 返回开票url链接(或预生成二维码):/cloud/addReceiptUrl 返回二维码字节流:/cloud/addReceipt |
开放权限 | 所有企业 |
调用方式 | POST |
参数方式 | Base64(JSON格式) |
重要说明 | |
业务范围 | 数电 税控 |
接口类型 | 同步 |
{
"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"
}
]
}
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"
}
]
}'
{
"code": "0",
"message": "执行成功",
"renson": "",
"data": "二维码地址"
}