百旺金穗云-SaaS标准化接口
  1. 5.扫码开票
百旺金穗云-SaaS标准化接口
  • 销项
    • 1.接口概述
      • 1.接口调用规范
      • 2.接口调用示例代码
    • 2.接口调用说明（分场景）
      • 扫码开票
      • 数电开票
      • 税控开票
    • 3.接口定义
      • 1.通用接口
        • 3.1.1.查询企业唯一标识
        • 3.1.2.智能抬头
      • 2.发票开具
        • 3.2.6.发票开具申请(V2)
          • 3.2.6.发票开具申请(V2)
          • 6.1数电蓝字发票开具
          • 6.2数电纸票开具
          • 6.3折扣行发票开具
          • 6.4差额征收发票开具
          • 6.5特殊票种-住房租赁
          • 6.6特殊票种-不动产租赁-停车费
          • 6.7特殊票种-旅客运输服务
          • 6.8机动车销售统一发票-数电纸质
          • 6.9二手车销售统一发票-数电纸质
        • 3.2.1.查询企业税控设备
        • 3.2.2.查询开票终端
        • 3.2.3.查询数电纸票票种
        • 3.2.4.剩余票量查询
        • 3.2.5.获取待开票号
        • 3.2.7.(V2)发票查询-按订单流水号查询(V2)
      • 3.发票作废红冲
        • 3.3.3.数电红冲申请
        • 3.3.4.数电红冲结果查询
      • 4.辅助类接口
        • 3.4.1.企业基本信息查询
        • 3.4.2.电子税务局登录
        • 3.4.3.获取实人认证二维码（异步）
        • 3.4.4.获取实人认证二维码（同步）
        • 3.4.5.认证结果查询
      • 5.扫码开票
        • 3.5.1.订单码-全量（推送订单）
          POST
        • 3.5.1.订单码-数电（推送订单）
          POST
    • 4.附录信息
      • 6.1.特殊票种
      • 6.2.增值税特殊管理
      • 6.3.交通工具类型
      • 6.4.身份证件类型
      • 6.5.农产品证件类型
      • 6.6.商品列表
  • 进项
    • 1.接口概述
      • 1,1接口概述
    • 2.接口详情
      • 2.1登录辅助类接口
        • 2.1.1企业信息保存接口
        • 2.1.2电子税务局登录账号信息保存接口
        • 2.1.3电子税务局登录接口
        • 2.1.4获取电子税务局登录状态接口
      • 2.2税务基础
        • 2.2.1税期同步
          • 2.2.1.1同步税款所属期接口
          • 2.2.1.2查询税款所属期接口
        • 2.2.2发票归集接口
          • 2.2.2.1同步发票信息接口
          • 2.2.2.2单票信息查询接口
          • 2.2.2.3进项发票查询接口
          • 2.2.2.4全量进项发票查询接口
          • 2.2.2.5进项发票版式文件下载接口
          • 2.2.2.6海关缴款书查询接口
        • 2.2.3勾选接口
          • 2.2.3.1发票勾选接口
          • 2.2.3.2发票抵扣勾选查询接口
          • 2.2.3.3往期勾选发票信息查询接口
          • 2.2.3.4发票预勾选接口
          • 2.2.3.5海关缴款书勾选
          • 2.2.3.6发票勾选异步接口
          • 2.2.3.7发票勾选异步结果查询接口
          • 2.2.3.8农产品发票预处理接口
          • 2.2.3.9农产品发票加计勾选接口
        • 2.2.4退税勾选接口
          • 2.2.4.1发票退税勾选查询
          • 2.2.4.2发票退税勾选、撤销退税勾选
          • 2.2.4.3退税确认勾选
          • 2.2.4.4发票退税勾选统计接口
          • 2.2.4.5根据确认日期区间 查询已确认退税信息
        • 2.2.5入账接口
          • 2.2.5.1进项发票入账提交接口
          • 2.2.5.2进项发票入账调整接口
          • 2.2.5.3乐企通道--入账能力(非聚合接口，仅申请入账拿到流水号)
          • 2.2.5.4乐企通道--入账能力(非聚合接口，仅根据流水号查询乐企通道入账结果)
        • 2.2.6申请统计接口
          • 2.2.6.1申请统计查询接口
      • 2.3进项税额转出接口
        • 2.3.1进项税额转出接口
        • 2.3.2进项税额转出查询接口
        • 2.3.3进项税额转出统计接口
        • 2.3.4进项税额转出明细查询接口
      • 2.4采集查验接口
        • 2.4.1新版发票识别接口
        • 2.4.2新版发票查验接口
        • 2.4.3新版发票识别查验接口
        • 2.4.4乐企发票查验接口
        • 2.4.5新版采集发票保存接口
        • 2.4.6采集发票查询接口
        • 2.4.7老版发票查验接口（已停止维护，推荐使用新版发票查验接口）
        • 2.4.8老版发票识别接口（已停止维护，推荐使用新版发票识别接口）
        • 2.4.9老版发票识别查验接口（已停止维护，推荐使用新版发票识别查验接口）
        • 2.4.10发票业务状态保存接口
        • 2.4.11发票业务状态删除接口
        • 2.4.12发票业务状态查询接口
        • 2.4.13进项电子票据解析接口
        • 2.4.14新版发票识别查验接口(根据链接采集发票)
        • 2.4.15（批量）发票业务状态保存接口
      • 2.5归档管理
        • 2.5.1发票单据绑定、解绑接口（发票：单据 =1：N）
        • 2.5.2发票单据绑定、解绑接口（单据：发票 =1：N）
        • 2.5.3发票凭证绑定、解绑接口（发票：凭证 =1：N）
        • 2.5.4发票凭证绑定、解绑接口（凭证：发票=1：N）
        • 2.5.5单据凭证绑定、解绑接口（单据：凭证=1：N）
        • 2.5.6单据凭证绑定、解绑接口（凭证：单据=1：N）
      • 2.6配单管理
        • 2.6.1单据新增/修改接口
        • 2.6.2自动配单结果回填
    • 3.附录信息
      • 3.1响应状态码
      • 3.2.1发票状态码（全电平台）
      • 3.2.2发票状态码（全国增值税查验平台）
      • 3.3《全电票平台》发票类型代码
      • 3.4数据来源类型代码
      • 3.5发票业务类型代码
      • 3.6特定要素枚举值
      • 3.7老版发票识别接口发票类型代码
      • 3.8新版发票识别接口发票类型
      • 3.9税区代码
      • 3.10乐企查验返回发票票面信息数据说明
      • 3.11发票风险等级
  • 老版进项
    • 公共参数说明
    • 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发票识别接口
      • 2.1识别接口
        • 2.1.1发票识别接口
      • 2.2识别返回报文
        • 2.2.1增值税专用发票（普票相同）
        • 2.2.2增值税电子普通发票
        • 2.2.3增值税普通发票（卷票）
        • 2.2.4机动车销售统一发票
        • 2.2.5二手车销售统一发票
        • 2.2.6火车票
        • 2.2.7出租车票
        • 2.2.8航空运输电子客票行程单
        • 2.2.9客运汽车票
        • 2.2.10过路费发票
        • 2.2.11定额发票
        • 2.2.12机打发票
        • 2.2.13增值税发票销货清单
        • 2.2.14完税证明
        • 2.2.15电子发票返回列表
    • 3发票查验接口
      • 3.1发票查验接口
    • 4附录
      • 4.1接口类型编号
      • 4.2特定约束类型
      • 4.3出行人证件类型
      • 4.4交通工具类型
  • 申报
    • 1.接口概述
      • 1.1申报接口调用规范
      • 1.2 接口调用流程
        • 1.2.1 个税调用流程
        • 1.2.2 增值税一般人调用流程
        • 1.2.4 企业所得税预缴(查账征收)调用流程
        • 1.2.5 印花税调用流程
      • 1.3 接口调用示例代码
    • 2.接口定义
      • 2.1 个税
        • 2.1.1 社保接口
          • 2.1.1.1 获取社保申报的数据
          • 2.1.1.2 社保申报
          • 2.1.1.3 社保申报结果查询
          • 2.1.1.4 社保扣款
          • 2.1.1.5 社保扣款结果查询
          • 2.1.1.6 社保完税凭证明细查询
          • 2.1.1.7 社保完税凭证导出
          • 2.1.1.8 查询社保人员明细数据
        • 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.2.26 个税完税凭证查询
        • 2.1.3 个税附录
          • 纳税人类型代码
          • 收入类型代码及相对应的字段externFields
          • 人员相关字典
          • 国籍国家
      • 2.2 增值税一般纳税人
        • 2.2.1增值税一般人申报表接口
      • 2.3 增值税小规模
        • 2.3.1增值税小规模申报表接口
      • 2.4 企业所得税预缴(查账征收)
        • 2.4.1.企业所得税预缴申报表数据生成接口
      • 2.5 印花税
        • 2.5.1.印花税申报表数据生成接口
      • 2.6 工会经费
        • 2.6.1.工会经费台账数据生成接口
      • 2.7 财务报表
        • 2.7.1财务报表未执行申报表接口
        • 2.7.2 财务报表已执行申报表接口
        • 2.7.3 财务报表小企业申报表接口
      • 2.8 发起申报缴款完税凭证
        • 2.8.1发起申报接口
        • 2.8.2申报进度查询
        • 2.8.3发起缴款接口
        • 2.8.4缴款进度查询
        • 2.8.5发起表格式完税证明下载
        • 2.8.6表格式完税证明查询
        • 2.8.7发起申报/缴款结果查询任务
        • 2.8.8申报/缴款数据查询
      • 2.9 税种认定信息查询
        • 2.9.1税种认定信息查询
      • 2.10 增值税台账
        • 2.10.1销售收入台账接口
        • 2.10.2计算抵扣台账接口
        • 2.10.3增值税涉税事项台账接口
      • 2.11 残疾人就业保障金
        • 2.11.1残疾人就业保障金台账生成接口
      • 2.12 城镇垃圾处理费
        • 2.12.1城市垃圾处理费台账生成接口
      • 2.13 水利建设专项收入
        • 2.13.1水利建设专项收入台账生成接口
      • 2.14 通用申报
        • 2.14.1通用申报台账
      • 2.15 非税收入通用申报
        • 2.15 非税通用申报
      • 2.16 企业所得税台账
        • 2.16.1企业所得税涉税事项台账接口
        • 2.16.2从业人数台账接口
        • 2.16.3分配比例台账接口
      • 2.17 财务报表税基
        • 2.17.1财务报表税基接口
      • 2.18 科目余额表
        • 查询科目余额表接口
        • 科目余额表添加接口
      • 2.19 同步申报清册
        • 发起同步申报清册(同步纳税人信息)
      • 2.20 房产税台账
        • 房产税台账接口
      • 2.21 城镇土地使用税
        • 城镇土地使用税台账接口
      • 2.22 局端发票汇总
        • 发起获取局端发票汇总下载任务接口
        • 查询局端发票汇总明细
      • 2.23 历史申报数据
        • 发起同步历史申报数据下载任务
        • 申报数据查询接口
      • 2.24 文化事业建设费
        • 文化事业建设费台账生成接口
      • 2.25 企业所得税汇算清缴(年报)
      • 2.26 企业所得税分支机构(年报)
      • 2.27 工商年报
        • 工商登录信息配置接口
        • 工商登录信息查询接口
        • 发起工商业务初始化接口
        • 发起社保初始化接口
        • 发起工商年报申报接口
        • 工商年报状态查询接口
    • 3.附录信息
      • 税种类型
      • 纳税期限和税款所属期
      • 征收品目（印花税）
      • 销售收入类型
      • 计算抵扣类型
      • 增值税一般人免税类型
      • 增值税一般人减税类型
      • 申报/扣款状态代码
  1. 5.扫码开票

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 参数

Body 参数application/json

示例
{
    "qyId": "企业ID",
    "ddlsh": "自定义,全局唯一",
    "sksbh": "销售方税号",
    "dlzh": "开票员的电子税务局登录账号",
    "kpr": "电子税务局登录账号（dlzh）对应开票员的姓名",
    "sqr": "电子税务局登录账号（dlzh）对应开票员的姓名",
    "fplxdm": "数电专票传01、数电普票传02",
    "xsfMc": "〇〇〇〇有限公司",
    "xsfNsrsbh": "销方税号",
    "xsfDz": "销方地址",
    "xsfDh": "销方电话",
    "xsfYh": "销方银行",
    "xsfZh": "销方银行账号",
    "bz": "",
    "jshj": "1.00",
    "hjje": "0.99",
    "hjse": "0.01",
    "ywdjDm": "DJ001",
    "prodParam": [
        {
            "dj": "1",
            "je": "0.99",
            "lslbs": "0",
            "se": "0.01",
            "sl": "1",
            "slv": "0.01",
            "spbm": "1090620040000000000",
            "spmc": "博士顿双联盒"
        }
    ]
}

示例代码

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": "企业ID",
    "ddlsh": "自定义,全局唯一",
    "sksbh": "销售方税号",
    "dlzh": "开票员的电子税务局登录账号",
    "kpr": "电子税务局登录账号（dlzh）对应开票员的姓名",
    "sqr": "电子税务局登录账号（dlzh）对应开票员的姓名",
    "fplxdm": "数电专票传01、数电普票传02",
    "xsfMc": "〇〇〇〇有限公司",
    "xsfNsrsbh": "销方税号",
    "xsfDz": "销方地址",
    "xsfDh": "销方电话",
    "xsfYh": "销方银行",
    "xsfZh": "销方银行账号",
    "bz": "",
    "jshj": "1.00",
    "hjje": "0.99",
    "hjse": "0.01",
    "ywdjDm": "DJ001",
    "prodParam": [
        {
            "dj": "1",
            "je": "0.99",
            "lslbs": "0",
            "se": "0.01",
            "sl": "1",
            "slv": "0.01",
            "spbm": "1090620040000000000",
            "spmc": "博士顿双联盒"
        }
    ]
}'

返回响应

🟢200成功
application/json
Body

示例
{
    "code": "0",
    "message": "执行成功",
    "renson": "",
    "data": "二维码地址"
}
修改于 2024-09-25 11:07:40
上一页
3.5.1.订单码-全量（推送订单）
下一页
6.1.特殊票种
Built with