乐企直连

数电红字确认单申请

POST

https://natural-system-dev.chinackts.com/ns-api/standard/aeRedConfirmationApply

请求参数

Header 参数

nsrsbh

string

调用方税号

可选

默认值:

Body 参数application/json

lrfsf

enum<string> | enum<null>

录入方身份

必需

枚举值:

正则匹配:

[01]

xsfnsrsbh

string | null

销售方纳税人识别号

必需

<= 26 字符

xsfmc

string | null

销售方名称

必需

<= 300 字符

gmfnsrsbh

string | null

购买方纳税人识别号

可选

<= 20 字符

gmfmc

string | null

购买方名称

必需

<= 300 字符

lzfpdm

string | null

蓝字发票代码

可选

<= 12 字符

lzfphm

string | null

蓝字发票号码

必需

<= 20 字符

sfzzfpbz

string | null

是否纸质发票标志

可选

正则匹配:

^$|[YN]

lzkprq

string | null

蓝字发票开票日期

必需

正则匹配:

((([0-9]{3}[1-9]|[0-9]{2}[1-9][0-9]{1}|[0-9]{1}[1-9][0-9]{2}|[1-9][0-9]{3})-(((0[13578]|1[02])-(0[1-9]|[12][0-9]|3[01]))|((0[469]|11)-(0[1-9]|[12][0-9]|30))|(02-(0[1-9]|[1][0-9]|2[0-8]))))|((([0-9]{2})(0[48]|[2468][048]|[13579][26])|((0[48]|[2468][048]|[3579][26])00))-02-29))\s+([0-1]?[0-9]|2[0-3]):([0-5][0-9]):([0-5][0-9])

lzhjje

number | null

蓝字发票合计金额

必需

>= -1000000000000000000<= 1000000000000000000

lzhjse

number | null

蓝字发票合计税额

必需

>= -1000000000000000000<= 1000000000000000000

lzfppzDm

string | null

蓝字发票票种代码

必需

正则匹配:

0[1-4]

lzfpTdyslxDm

string | null

可选

蓝字发票特定要素类型代码

正则匹配:

^$|0[1-9]|1[0-8]

hzcxje

number | null

红字冲销金额

必需

>= -1000000000000000000<= 1000000000000000000

hzcxse

number | null

红字冲销税额

必需

>= -1000000000000000000<= 1000000000000000000

chyyDm

string | null

必需

红字发票冲红原因代码

正则匹配:

0[1-4]

hzqrdmxList

array [object {13}] | null

必需

>= 1 items

lzmxxh

integer | null

蓝字发票明细序号

必需

>= -99999999<= 99999999

integer | null

序号

必需

>= -99999999<= 99999999

sphfwssflhbbm

string | null

必需

商品和服务税收分类合并编码

<= 19 字符

hwhyslwfwmc

string | null

必需

货物或应税劳务、服务名称

<= 300 字符

spfwjc

string | null

商品服务简称

必需

<= 120 字符

xmmc

string | null

项目名称

必需

<= 600 字符

ggxh

string | null

规格型号

可选

<= 150 字符

string | null

单位

可选

<= 300 字符

fpspdj

string | null

单价

可选

<= 25 字符

fpspsl

string | null

数量

可选

<= 25 字符

number | null

金额

必需

>= -1000000000000000000<= 1000000000000000000

sl1

number | null

税率

必需

>= -10000000000000000<= 10000000000000000

number | null

税额

必需

>= -1000000000000000000<= 1000000000000000000

示例

{
    "lrfsf": "0",
    "xsfnsrsbh": "string",
    "xsfmc": "string",
    "gmfnsrsbh": "string",
    "gmfmc": "string",
    "lzfpdm": "string",
    "lzfphm": "string",
    "sfzzfpbz": "string",
    "lzkprq": "string",
    "lzhjje": -1000000000000000000,
    "lzhjse": -1000000000000000000,
    "lzfppzDm": "string",
    "lzfpTdyslxDm": "string",
    "hzcxje": -1000000000000000000,
    "hzcxse": -1000000000000000000,
    "chyyDm": "string",
    "hzqrdmxList": [
        {
            "lzmxxh": -99999999,
            "xh": -99999999,
            "sphfwssflhbbm": "string",
            "hwhyslwfwmc": "string",
            "spfwjc": "string",
            "xmmc": "string",
            "ggxh": "string",
            "dw": "string",
            "fpspdj": "string",
            "fpspsl": "string",
            "je": -1000000000000000000,
            "sl1": -10000000000000000,
            "se": -1000000000000000000
        }
    ]
}

示例代码

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

curl --location --request POST 'https://natural-system-dev.chinackts.com/ns-api/standard/aeRedConfirmationApply' \
--header 'nsrsbh: {{nsrsbh}}' \
--header 'Content-Type: application/json' \
--data-raw '{
    "lrfsf": "0",
    "xsfnsrsbh": "string",
    "xsfmc": "string",
    "gmfnsrsbh": "string",
    "gmfmc": "string",
    "lzfpdm": "string",
    "lzfphm": "string",
    "sfzzfpbz": "string",
    "lzkprq": "string",
    "lzhjje": -1000000000000000000,
    "lzhjse": -1000000000000000000,
    "lzfppzDm": "string",
    "lzfpTdyslxDm": "string",
    "hzcxje": -1000000000000000000,
    "hzcxse": -1000000000000000000,
    "chyyDm": "string",
    "hzqrdmxList": [
        {
            "lzmxxh": -99999999,
            "xh": -99999999,
            "sphfwssflhbbm": "string",
            "hwhyslwfwmc": "string",
            "spfwjc": "string",
            "xmmc": "string",
            "ggxh": "string",
            "dw": "string",
            "fpspdj": "string",
            "fpspsl": "string",
            "je": -1000000000000000000,
            "sl1": -10000000000000000,
            "se": -1000000000000000000
        }
    ]
}'

返回响应

🟢200成功

application/json

Body

returncode

string | null

可选

返回码
00：成功
01：失败

returnmsg

string | null

可选

返回信息
错误信息说明

hzfpxxqrdbh

string | null

红字确认单编号

可选

uuid

string | null

红字确认单UUID

可选

hzqrxxztDm

string | null

红字确认单状态

可选

示例

{
  "returncode": "",
  "returnmsg": "",
  "hzfpxxqrdbh": "",
  "uuid": "",
  "hzqrxxztDm": ""
}

修改于 2025-06-14 02:20:53

数电红字确认单确认

预赋码信息查询