1.04.发票作废(czlx-6)

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

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

POST

发票作废

注意：电子发票不支持作废
什么是空白作废：假如你现在开的最后一张纸票代码是ABC，号码是123，那么你下一张发票应该是ABC，号码是124。如果124这张发票纸损坏或者没找到，那么你就可以通过空白作废将124这张发票作废掉，然后下一张开的发票则是代码ABC号码125

请求参数

Query 参数

name

string

必需

clientsecret+税盘号

reqid

string

必需

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

Header 参数

Content-Type

string

必需

示例值:

application/json

Body 参数application/json

czlx

enum<string>

固定为：6

必需

枚举值:

sfrz

object

身份认证

必需

client_id

string

由发票云分配的id

必需

client_secret

string

由发票云分配的密钥

可选

timestamp

string

时间戳

可选

sjd

object

作废发票信息

必需

kpzl

string

必需

发票类型 0：专用发票 2：普通发票 41：卷式发票

fpdm

string

可选

作废发票的代码为空时执行空白作废

fphm

string

可选

作废发票的号码为空时执行空白作废

zfr

string

可选

执行作废操作的人员（只适用百望，默认为原蓝字发票的开票人）

示例

{
    "czlx": "6",
    "sfrz": {
        "client_id": "string",
        "client_secret": "string",
        "timestamp": "string"
    },
    "sjd": {
        "kpzl": "string",
        "fpdm": "string",
        "fphm": "string",
        "zfr": "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 '{
    "czlx": "6",
    "sfrz": {
        "client_id": "string",
        "client_secret": "string",
        "timestamp": "string"
    },
    "sjd": {
        "kpzl": "string",
        "fpdm": "string",
        "fphm": "string",
        "zfr": "string"
    }
}'

返回响应

🟢200成功

application/json

Body

description

string

必需

errcode

string

6011：成功

必需

示例

{"description":"作废成功","errcode":"6011"}

修改于 2024-04-03 06:11:59

1.03.发票开具(czlx-3)

1.05.发票查询(czlx-5)