3.5.1.订单码-数电（推送订单）

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

必需

默认值:

host

string

必需

默认值:

x-htjs-nonce

string

必需

默认值:

x-htjs-ua

string

必需

默认值:

Authorization

string

必需

默认值:

Body 参数application/json

qyId

string

企业唯一标识

必需

ddlsh

string

订单流水号

必需

sksbh

string

税控设备号

必需

dlzh

string

登录账号

必需

kpr

string

开票人

必需

sqr

string

申请人

必需

fplxdm

string

发票类型代码

必需

xsfMc

string

销售方名称

必需

xsfNsrsbh

string

销售方纳税人识别号

必需

xsfDz

string

销售方地址

必需

xsfDh

string

销售方电话

必需

xsfYh

string

销售方银行

必需

xsfZh

string

销售方账户

必需

string

备注

必需

jshj

string

价税合计

必需

hjje

string

不含税金额

必需

hjse

string

不含税税额

必需

ywdjDm

string

业务单据代码

必需

prodParam

array [object {8}]

明细参数(多条明细)

必需

string

单价（含税）

可选

保留10位小数

string

金额（含税）

必需

保留2位小数

lslbs

integer

零税率标识

必需

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

string

税额

必需

保留2位小数

string

数量

必需

保留6位小数

slv

string

税率

必需

最多3位小数

spbm

string

商品编码

必需

spmc

string

商品名称

可选

示例

{
    "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

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

application/json

Body

code

string

必需

message

string

必需

renson

string

必需

data

string

必需

示例

{
    "code": "0",
    "message": "执行成功",
    "renson": "",
    "data": "二维码地址"
}

1.场景说明#

订单码分为三种场景，详细描述如下：#

2.接口描述#

请求参数

示例代码

返回响应

1.场景说明

订单码分为三种场景，详细描述如下：

2.接口描述