3.1.02查询订单接口(由客户提供)

快速开始环境

POST

/此为对接发票云方提供的查询订单接口地址（对接方必须按照成功响应示例报文返回 json ）接口配置地址关联动态二维码配置里的业务编码（位于发票云->系统管理->业务系统）

扫码开票二维码规则：
1 规则说明

示例扫码地址：http://scan.piaozone.com/demo/tyqr?k=key,ddh,je,timestamps,md5,$

key：门店id，由金蝶分配
ddh：小票单号
je: 小票金额
timestamps: 时间戳
md5: MD5加密值

注意：最后要拼接$结尾

2 MD5值说明

MD5(KEY + DDH + MD5(public_key+ DDH) + JE)

第一步：
MD5_1 = MD5(public_key + DDH)
第二步：
MD5_2 = MD5(KEY + DDH + MD5_1 + JE)
附：

public_key 由金蝶分配，每个租户分配一对
public_key 由 key 关联查询（金蝶端校验）

流程步骤：
1.对接客户通过以下接口生成二维码给到用户(http://scan.piaozone.com/demo/tyqr?k=key,ddh,je,timestamps,md5,$)
2.用户扫码到开票界面，填写购方信息
3.用户提交开票
4.发票云系统通过客户提供给发票云的明细查询地址（http://xxxxxxx/scanInvoice/queryOrder）查询单据编号对应的明细数据
5.完成开票

请求参数

Body 参数application/json

interfaceCode

enum<string>

必需

固定业务编码 GET.ORDER

枚举值:

GET.ORDER

data

string

必需

单据编号，是BASE64编码或AES密文，根据设置的加密规则进行解码或解密

示例

{
  "interfaceCode": "GET.ORDER",
  "data": "string"
}

示例代码

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

curl --location --request POST 'https://cosmic-sandbox.piaozone.com/jdpjykjyxgs/此为对接发票云方提供的查询订单接口地址（对接方必须按照成功响应示例报文返回 json ） 接口配置地址关联动态二维码配置里的业务编码（位于 发票云->系统管理->业务系统）' \
--header 'Content-Type: application/json' \
--data-raw ''

返回响应

🟢200成功

application/json

Body

code

string

必需

message

string

必需

接口返回成功消息，失败返回失败原因

data

object

必需

data数据为明文不需要加密

billNo

string

单据编号，必填

必需

drawer

string

开票人，必填

必需

payee

string

付款人

可选

reviewer

string

复核人

可选

billDate

string

必需

单据日期，必填格式yyyy-MM-dd

remark

string

发票备注，选填

可选

includeTaxFlag

string

必需

含税标识，必填 0-不含税 1-含税

billProperty

string

必需

单据性质，必填 1-正数 -1负数

sellerTaxpayerId

string

必需

销售方纳税人识别号，必填

buyerTaxpayerId

string

购方税号

可选

buyerName

string

购方名称

可选

buyerBankAndAccount

string

购方银行账号

可选

buyerAddressAndTel

string

购方地址电话

可选

cancalState

string

必需

作废标识，必填。 0-未作废，1-作废

billAmount

number

必需

单据金额，必填。如果含税标识是含税就是含税金额，不含税就是不含税金额

billTax

number

单据税额，选填

可选

issueBizType

string

可选

调度开票业务类型（传开票业务类型编码）

billDetail

array [object {14}]

必需

示例

{
  "code": "string",
  "message": "string",
  "data": {
    "billNo": "string",
    "drawer": "string",
    "payee": "string",
    "reviewer": "string",
    "billDate": "string",
    "remark": "string",
    "includeTaxFlag": "string",
    "billProperty": "string",
    "sellerTaxpayerId": "string",
    "buyerTaxpayerId": "string",
    "buyerName": "string",
    "buyerBankAndAccount": "string",
    "buyerAddressAndTel": "string",
    "cancalState": "string",
    "billAmount": 0,
    "billTax": 0,
    "issueBizType": "string",
    "billDetail": [
      {
        "amount": 0,
        "quantity": "string",
        "discountAmount": 0,
        "specification": "string",
        "units": "string",
        "privilegeContent": "string",
        "taxRate": "string",
        "privilegeFlag": "string",
        "price": "string",
        "goodsCode": "string",
        "lineProperty": "string",
        "taxAmount": 0,
        "goodsName": "string",
        "revenueCode": "string"
      }
    ]
  }
}

修改于 2024-09-25 08:56:57

3.1.01业务系统组装二维码链接格式

3.1.03 扫码提交购方抬头规则