票单云

申请红字信息表

POST

/qdjk/fullExteriorInvoke/hzxxbsq

申请红字信息表

开负数发票前，需要先申请红字信息表

请求参数

Header 参数

Authorization

string

必需

示例值:

Body 参数application/json

username

string

局端账号

必需

xhdwsbh

string

销方税号

必需

yfphm

string

发票号码

必需

chyydm

string

必需

申请红字信息表原因代码：01，开票有误；02，销货退回；03，服务中止；04，销售折让。目前局端部分冲红只支持：02，销货退回；03，服务中止。商品服务编码仅为服务时红冲原因不允许选择“02，销售退回”如原蓝字发票商品服务编码仅为货物或劳务时红冲原因不允许选择“03，服务中止”

sqyy

string

必需

（暂时只支持）2：销方全额红冲；3:购方全额红冲

sdfpbz

string

可选

数电发票标志。只有数电纸票才需要该节点，蓝票是数电纸票，开具负数数电发票，该节点传 1

hzxxbcheck

string

可选

红字信息表校验标志。传 1 不校验，直接去 1局端申请，否则申请过红字信息表返回申请过的数据

示例

{
    "username": "{{username}}",
    "xhdwsbh": "{{nsrsbh}}",
    "yfphm": "{{fphm}}",
    "chyydm": "01",
    "sqyy": "2"
}

示例代码

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

curl --location --request POST 'https://api.piaodanyun.com/test/tax/v2/qdjk/fullExteriorInvoke/hzxxbsq' \
--header 'Authorization: 6Mw6p7Rt7SUyM6G81WOVcJjl' \
--header 'Content-Type: application/json' \
--data-raw '{
    "username": "13581913199",
    "xhdwsbh": "9111011457319202X9",
    "yfphm": "25112000000122447100",
    "chyydm": "01",
    "sqyy": "2"
}'

返回响应

🟢200成功

application/json

Body

code

integer

必需

data

object

必需

sqsj

string

必需

uuid

string

必需

xsfnsrsbh

string

必需

xxbbh

string

必需

xxbzt

string

必需

xxbztDm

string

必需

示例

{
    "code": 0,
    "data": {
        "sqsj": "2025-06-14 18:48:49",
        "uuid": "a3fd7c7128d74de59609e6d19e838ec5",
        "xsfnsrsbh": "9111011457319202X9",
        "xxbbh": "11011425061000339962",
        "xxbzt": "无需确认",
        "xxbztDm": "01"
    }
}

修改于 2025-06-14 15:19:59

申请红字前查蓝票信息

红字发票开具

申请红字信息表

申请红字信息表#

请求参数

示例代码

返回响应

申请红字信息表