1.02 .读取票种信息(czlx-30)

测试环境(除税控、数电和扫码开票外的接口）

https://api-dev.piaozone.com/test

POST

请求参数

Query 参数

name

string

必需

clientsecret+税盘号

reqid

string

必需

当前13位毫秒级时间戳加3位随机数字(总共16位)

Header 参数

Content-Type

string

必需

示例值:

application/json

Body 参数application/json

sfrz

object

身份认证

必需

client_id

string

由发票云分配的id

必需

client_secret

string

由发票云分配的密钥

可选

timestamp

string

时间戳

可选

czlx

enum<string>

固定为：30

必需

枚举值:

invoice_type

string

必需

发票类型; 0:专用发票 ; 2:普通发票 41:卷式发票; 51:电子发票; 61:电子专用发票

示例

{
    "sfrz": {
        "client_id": "string",
        "client_secret": "string",
        "timestamp": "string"
    },
    "czlx": "30",
    "invoice_type": "string"
}

示例代码

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

curl --location --request POST 'https://api-dev.piaozone.com/test/?name=&reqid=' \
--header 'Content-Type: application/json' \
--data-raw '{
    "sfrz": {
        "client_id": "string",
        "client_secret": "string",
        "timestamp": "string"
    },
    "czlx": "30",
    "invoice_type": "string"
}'

返回响应

🟢200成功

application/json

Body

errcode

string

0000：成功

必需

description

string

描述

必需

info

object

相关信息

必需

invoice_code

string

必需

下一张可用的发票代码

invoice_num

string

必需

下一张可用的发票号码

remainder

number

发票剩余张数

必需

max_limit

string

发票限额

必需

volumn

array [object {6}]

票卷信息

必需

invoice_code

string

发票代码

可选

invoice_num

string

起始发票号码

可选

remainder

number

发票剩余张数

可选

amount

number

该票卷总份数

可选

purchase_date

string

可选

领购日期 YYYY-MM-DD

purchase_person

string

可选

领购人（当前只有百望系支持该字段）

示例

{"description":"操作成功","errcode":"0000","info":{"invoice_code":"4403183130","invoice_num":"19519870","max_limit":"99999.99","remainder":175},"volumn":[{"amount":5000,"invoice_code":"4403183130","invoice_num":"19515045","purchase_date":"2019-05-29","purchase_person":"","remainder":175}]}

修改于 2024-04-03 06:14:09

1.01.读取税盘信息(czlx-7)

1.03.发票开具(czlx-3)