红字确认单查询 - 数电前置API

请求参数

Header 参数

actionCode

string

可选

示例值:

HZQRDCX

taxnum

string

税号

可选

interfaceCode

string

授权码

可选

extensionNo

string

分机号

可选

isEncryption

string

是否加密

必需

Body 参数application/json

sqdh

string

请求流水号

可选

如果该值为空，红字确认单编号必填

lrfsf

enum<string>

录入方身份

可选

枚举值:

01

yhjslx

enum<string>

用户角色类型

可选

枚举值:

01

xsfnsrsbh

string

销方税号

可选

xsfmc

string

销方名称

可选

gmfnsrsbh

string

购方税号

可选

gmfmc

string

购方名称

可选

hzfpxxqrdbh

string

红字确认单编号

可选

如果该值为空，请求流水号必填

hzqrxxztDm

enum<string>

红字确认单状态代码

可选

枚举值:

010203040506070809

fppzDm

enum<string>

发票种类

可选

枚举值:

0102010022

示例

{
    "sqdh": "请求流水号",
    "lrfsf": "0",
    "yhjslx": "",
    "xsfnsrsbh": "企业税号",
    "xsfmc": "企业名称",
    "gmfnsrsbh": "",
    "gmfmc": "",
    "lrrqq": "",
    "lrrqz": "",
    "lzfpdm": "",
    "lzfphm": "",
    "lzskfphm": "",
    "hzfpxxqrdbh": "",
    "hzqrxxztDm": "",
    "fppzDm": "02"
}

示例代码

Shell

JavaScript

Java

Swift

Go

PHP

Python

HTTP

C

C#

Objective-C

Ruby

OCaml

Dart

R

curl --location --request POST 'http://120.48.195.50:5000/EInvoice-Test/Api' \
--header 'actionCode: HZQRDCX' \
--header 'taxnum;' \
--header 'interfaceCode;' \
--header 'extensionNo;' \
--header 'isEncryption;' \
--header 'Content-Type: application/json' \
--data-raw '{
    "sqdh": "请求流水号",
    "lrfsf": "0",
    "yhjslx": "",
    "xsfnsrsbh": "企业税号",
    "xsfmc": "企业名称",
    "gmfnsrsbh": "",
    "gmfmc": "",
    "lrrqq": "",
    "lrrqz": "",
    "lzfpdm": "",
    "lzfphm": "",
    "lzskfphm": "",
    "hzfpxxqrdbh": "",
    "hzqrxxztDm": "",
    "fppzDm": "02"
}'

返回响应

🟢200成功

application/json

Body

code

enum<string>

状态码

必需

枚举值:

0000009999

mess

string

状态描述

可选

data

object

必需

sqdh

string

请求流水号

必需

uuid

string

红字确认单uuid

可选

hzfpxxqrdbh

string

红字确认单编号

可选

lrfsf

enum<string>

录入方身份

必需

枚举值:

01

xsfmc

string

销方名称

可选

xsfnsrsbh

string

销方税号

可选

gmfmc

string

购方名称

可选

gmfnsrsbh

string

购方税号

可选

lzfphm

string

蓝字全电发票号码

必需

lzfpdm

string

蓝字税控/纸质发票代码

可选

lzskfphm

string

蓝字税控/纸质发票号码

可选

sfzzfpbz

enum<string>

是否纸质发票标志

可选

枚举值:

YN

lzkprq

string

蓝字开票日期

必需

yyyy-MM-dd HH:mm:ss

lzhjje

number

蓝字合计金额

必需

lzhjse

number

蓝字合计税额

必需

lzfppzDm

enum<string>

蓝字发票票种代码

必需

枚举值:

0102010022

lzfpTdyslxDm

enum<string>

蓝字发票特定要素代码

可选

枚举值:

01020304050609

hzcxje

number

红字冲销金额

必需

负数

hzcxse

number

红字冲销税额

必需

负数

chyyDm

enum<string>

红冲原因

必需

枚举值:

01020304

hzqrxxztDm

enum<string>

红字确认单状态代码

可选

枚举值:

010203040506070809

qrrq

string

确认单日期

可选

yyyy-MM-dd HH:mm:ss

ykjhzfpbz

enum<string>

已开具红字发票标志

可选

枚举值:

10

hzfphm

string

红字全电发票号码

可选

hzskfphm

string

红字税控/纸质发票发票号码

可选

hzskfpdm

string

红字税控/纸质发票代码

可选

hzkprq

string

红字开票日期

可选

yxbz

enum<integer>

有效标志

可选

枚举值:

01

lrrq

string

录入日期

可选

yyyy-MM-dd HH:mm:ss

hzqrdList

array [object {14}]

红字确认单明细列表

必需

示例

{
    "code": "0000",
    "mess": "红字确认单申请成功",
    "data": {
        "uuid": "红字确认单UUID",
        "hzfpxxqrdbh": "红字确认单编号",
        "sqdh": "请求流水号",
        "lrfsf": "0",
        "xsfnsrsbh": "企业名称",
        "xsfmc": "测试企业",
        "gmfnsrsbh": "企业税号",
        "gmfmc": "虚拟企业",
        "lzfphm": "20882412111636123456",
        "sfzzfpbz": "N",
        "lzhjje": 97.09,
        "lzhjse": 2.91,
        "lzfptdyslxdm": "04",
        "hzcxje": -97.09,
        "hzcxse": -2.91,
        "hzqrxxztdm": "01",
        "ykjhzfpbz": "1",
        "hzfphm": "20882412131308123456",
        "yxbz": 0,
        "lzkprq": "2024-12-11 16:36:08",
        "hzkprq": "2024-12-13 13:08:16",
        "lrrq": "2024-12-13 13:07:30",
        "chyyDm": "01",
        "lzfppzDm": "02",
        "hzqrdList": [
            {
                "xh": 1,
                "xmmc": "New Project",
                "sphfwssflhbbm": "3019902000000000000",
                "spfwjc": "运输服务",
                "dw": "unit",
                "ggxh": "size",
                "fpspsl": -10,
                "fpspdj": 9.709,
                "fphsdj": 10,
                "je": -97.09,
                "hsje": -100,
                "se": -2.91,
                "slv": 0.03,
                "yhzcbs": "01"
            }
        ]
    }
}