1.08.查询专用发票申请红字信息表(czlx-18)

请求参数

Query 参数

name

string

必需

clientsecret+税盘号

reqid

string

必需

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

Header 参数

Content-Type

string

必需

示例值:

application/json

Body 参数application/json

czlx

enum<string>

固定为：18

必需

枚举值:

18

sfrz

object

身份认证

必需

client_id

string

由发票云分配的id

必需

client_secret

string

由发票云分配的密钥

可选

timestamp

string

时间戳

可选

sjd

object

查询内容

必需

kjf_jh

string

开票机号

必需

kjf_nsrsbh

string

必需

查询时使用的金税盘纳税人识别号

kjf_sbbh

string

设备编号

必需

qstkrq

string

可选

填开日期起, yyyy-MM-dd

jstkrq

string

可选

填开日期止, yyyy-MM-dd

xhf_nsrsbh

string

销售方纳税人识别号

可选

ghf_nsrsbh

string

购货方纳税人识别号

可选

xxbbh

string

信息表编号

可选

xzfw

string

必需

信息表下载范围。0->全部 1->本企业申请 2->其它企业申请

yqzt

string

必需

逾期状态 N:非逾期，Y->逾期

pageno

string

页号从1开始

必需

pagesize

string

每页记录数

必需

示例

{
    "czlx": "18",
    "sfrz": {
        "client_id": "string",
        "client_secret": "string",
        "timestamp": "string"
    },
    "sjd": {
        "kjf_jh": "string",
        "kjf_nsrsbh": "string",
        "kjf_sbbh": "string",
        "qstkrq": "string",
        "jstkrq": "string",
        "xhf_nsrsbh": "string",
        "ghf_nsrsbh": "string",
        "xxbbh": "string",
        "xzfw": "string",
        "yqzt": "string",
        "pageno": "string",
        "pagesize": "string"
    }
}

示例代码

Shell

JavaScript

Java

Swift

Go

PHP

Python

HTTP

C

C#

Objective-C

Ruby

OCaml

Dart

R

curl --location --request POST 'https://api-dev.piaozone.com/test/?name=&reqid=' \
--header 'Content-Type: application/json' \
--data-raw '{
    "czlx": "18",
    "sfrz": {
        "client_id": "string",
        "client_secret": "string",
        "timestamp": "string"
    },
    "sjd": {
        "kjf_jh": "string",
        "kjf_nsrsbh": "string",
        "kjf_sbbh": "string",
        "qstkrq": "string",
        "jstkrq": "string",
        "xhf_nsrsbh": "string",
        "ghf_nsrsbh": "string",
        "xxbbh": "string",
        "xzfw": "string",
        "yqzt": "string",
        "pageno": "string",
        "pagesize": "string"
    }
}'

返回响应

🟢200成功

application/json

Body

description

string

描述

必需

errcode

string

必需

0000：成功其他：失败

lists

array [object {5}]

编码表数组

必需

hzxxbm

string

信息表编号

可选

sqdh

string

申请单号

可选

ztm

string

状态码

可选

ztms

string

状态描述

可选

invoice

object

可选

该编码表对应的红字发票信息

示例

{
    "description": "string",
    "errcode": "string",
    "lists": [
        {
            "hzxxbm": "string",
            "sqdh": "string",
            "ztm": "string",
            "ztms": "string",
            "invoice": {
                "fpdm": "string",
                "fphm": "string",
                "ghf_mc": "string",
                "ghf_nsrsbh": "string",
                "hjbhsje": "string",
                "hsbz": "string",
                "items": [
                    {
                        "ggxh": "string",
                        "se": "string",
                        "sl": "string",
                        "taxcode": {
                            "bmbb": "string",
                            "kce": "string",
                            "lslbs": "string",
                            "qyzbm": "string",
                            "ssflbm": "string",
                            "ssyhzc": "string",
                            "ssyhzcnr": "string"
                        },
                        "xmdj": "string",
                        "xmdw": "string",
                        "xmje": "string",
                        "xmmc": "string",
                        "xmsl": "string"
                    }
                ],
                "jshjje": "string",
                "kphjse": "string",
                "kprq": "string",
                "xhf_mc": "string",
                "xhf_nsrsbh": "string"
            }
        }
    ]
}

🟢200失败