2.2.02税控发票快速红冲（仅支持全额红冲）

快速开始环境

https://cosmic-sandbox.piaozone.com/jdpjykjyxgs

POST

/kapi/app/sim/openApi

请求参数

Query 参数

access_token

string

可选

示例值:

1107974180231447552_L3nqi9yB42ysU25QKA2Z6qgxT3blIVYsp9Nr1eLbP9B63o4Pjb3177JC7544rQ0dgNCgwLEfI92NHbAaM5Cdxz1rsQwF9u1ANbDI

Header 参数

access_token

string

可选

默认值:

Body 参数application/json

requestId

string

时间戳

必需

businessSystemCode

string

必需

对接业务系统来源编码，用于区分不同业务系统的回调接口

interfaceCode

enum<string>

接口编码

必需

枚举值:

QUICK.RED

data

array [object {4}]

必需

需要把data加密成base64字符串

invoiceCode

string

蓝票发票代码

必需

<= 15 字符

invoiceNum

string

蓝票发票号码

必需

<= 15 字符

redInfoBillNo

string

可选

红字信息表编号，专票必填

<= 50 字符

redReason

string

可选

冲红原因：1销货退回；2开票有误；3开票中止；4销售折让（如不填，默认为2开票有误）

示例

{
    "requestId": "string",
    "businessSystemCode": "string",
    "interfaceCode": " QUICK.RED",
    "data": [
        {
            "invoiceCode": "string",
            "invoiceNum": "string",
            "redInfoBillNo": "string",
            "redReason": "string"
        }
    ]
}

示例代码

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

curl --location --request POST 'https://cosmic-sandbox.piaozone.com/jdpjykjyxgs/kapi/app/sim/openApi?access_token=1107974180231447552_L3nqi9yB42ysU25QKA2Z6qgxT3blIVYsp9Nr1eLbP9B63o4Pjb3177JC7544rQ0dgNCgwLEfI92NHbAaM5Cdxz1rsQwF9u1ANbDI' \
--header 'access_token: {{access_token}}' \
--header 'Content-Type: application/json' \
--data-raw '{
    "requestId": "string",
    "businessSystemCode": "string",
    "interfaceCode": " QUICK.RED",
    "data": [
        {
            "invoiceCode": "string",
            "invoiceNum": "string",
            "redInfoBillNo": "string",
            "redReason": "string"
        }
    ]
}'

返回响应

🟢200成功

application/json

Body

message

string

必需

errorCode

string

必需

success

boolean

成功响应

必需

示例

{"data":"提交红冲成功","errorCode":"0","success":true}

🟢200失败

修改于 2025-03-14 07:49:04

2.2.01税控开票（直接开票，不支持拆分合并）

2.2.03税控发票作废