数电前置API

红字确认单申请

POST

http://120.48.195.50:5000/EInvoice-Test/Api

请求参数

Header 参数

actionCode

string

可选

示例值:

HZQRDSQ

taxnum

string

税号

可选

interfaceCode

string

授权码

可选

extensionNo

string

分机号

可选

isEncryption

string

是否加密

必需

Body 参数application/json

sqdh

string

请求流水号

必需

请求流水号唯一，不要跟蓝票流水号重复，如果申请失败建议不更换请求流水号重新推过来。红票开具同样使用该流水号去进行开票。

lrfsf

enum<string>

录入方身份

必需

非乐企通道，只能销方申请

枚举值:

xsfnsrsbh

string

销方纳税人识别号

必需

xsfmc

string

销方名称

必需

gmfmc

string

购方名称

必需

gmfnsrsbh

string

购方纳税人识别号

可选

专票必填

gmfzrrbz

enum<string>

购方纳税人标志

必需

枚举值:

lzfphm

string

蓝字数电发票号码

可选

数电发票必填

lzfpdm

string

税控/纸质蓝字发票代码

可选

税控/纸质发票必填

lzskfphm

string

税控/纸质蓝字发票号码

可选

税控/纸质发票必填

sfzzfpbz

enum<string>

是否纸质发票标志

必需

枚举值:

lzkprq

string

蓝字发票开票日期

必需

yyyy-MM-dd HH:mm:ss

lzhjje

string

蓝字发票合计金额

必需

保留两位小数，正数

lzhjse

string

蓝字发票合计税额

必需

保留两位小数，正数

lzjshj

string

蓝字发票价税合计

必需

保留两位小数，正数

lzfppzDm

enum<string>

蓝字发票票种代码

必需

枚举值:

0102010022

lzfpTdyslxDm

enum<string>

蓝字发票特定要素代码

可选

枚举值:

010304050609

hzcxje

string

红字冲销金额

必需

保留两位小数，负数

hzcxse

string

红字冲销税额

必需

保留两位小数，负数

hzjshj

string

红字冲销价税合计

必需

保留两位小数，负数

chyyDm

enum<string>

红冲原因

必需

枚举值:

01020304

hddz

string

回调地址

可选

用于接收红字确认单申请信息。
申请成功和申请失败都会返回。

hzqrdmxList

array [object {15}]

必需

mxxh

string

明细序号

可选

如果为空则自动按行顺序赋号

string

对应蓝字发票明细序号

必需

蓝票明细是折扣行时只需传被折扣行的明细序号，折扣行的序号不传（跳过），或者直接不传折扣行

xmmc

string

项目名称

必需

sphfwssflhbbm

string

税收分类编码

必需

spfwjc

string

税收分类简称

可选

ggxh

string

规格型号

可选

string

单位

可选

fpspdj

string

不含税单价

可选

正数

fphsdj

string

含税单价

可选

正数

fpspsl

string

数量

可选

负数

string

不含税金额

必需

负数

slv

string

税率

必需

小数。如 6% 填 0.06

string

税额

必需

负数

hsje

string

价税合计

必需

负数

yhzcbs

enum<string>

优惠政策标志

可选

枚举值:

010203040506070809101112131415161718

示例

{
    "sqdh": "20240821006",
    "lrfsf": "0",
    "xsfnsrsbh": "企业税号",
    "xsfmc": "企业名称",
    "gmfmc": "企业名称",
    "gmfnsrsbh": "企业税号",
    "gmfzrrbz": "Y",
    "lzfphm": "24442000000378123456",
    "lzfpdm": "",
    "lzskfphm": "",
    "sfzzfpbz": "N",
    "lzkprq": "2024-08-21 17:16:43",
    "lzhjje": 0.92,
    "lzhjse": 0.08,
    "lzjshj": 1.00,
    "lzfppzDm": "02",
    "lzfpTdyslxDm": "",
    "hzcxje": -0.92,
    "hzcxse": -0.08,
    "hzjshj": -1.00,
    "chyyDm": "01",
    "hddz": "",
    "hzqrdmxList": [
        {
            "mxxh": "1",
            "xh": "1",
            "xmmc": "第一级水费",
            "sphfwssflhbbm": "1100301010000000000",
            "spfwjc": "水冰雪",
            "ggxh": "",
            "dw": "",
            "fpspdj": "",
            "fphsdj": "",
            "fpspsl": "",
            "je": "-0.92",
            "slv": "0.09",
            "se": "-0.08",
            "hsje": "-1.00",
            "yhzcbs": ""
        }
    ]
}

示例代码

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

curl --location --request POST 'http://120.48.195.50:5000/EInvoice-Test/Api' \
--header 'actionCode: HZQRDSQ' \
--header 'taxnum;' \
--header 'interfaceCode;' \
--header 'extensionNo;' \
--header 'isEncryption;' \
--header 'Content-Type: application/json' \
--data-raw '{
    "sqdh": "20240821006",
    "lrfsf": "0",
    "xsfnsrsbh": "企业税号",
    "xsfmc": "企业名称",
    "gmfmc": "企业名称",
    "gmfnsrsbh": "企业税号",
    "gmfzrrbz": "Y",
    "lzfphm": "24442000000378123456",
    "lzfpdm": "",
    "lzskfphm": "",
    "sfzzfpbz": "N",
    "lzkprq": "2024-08-21 17:16:43",
    "lzhjje": 0.92,
    "lzhjse": 0.08,
    "lzjshj": 1.00,
    "lzfppzDm": "02",
    "lzfpTdyslxDm": "",
    "hzcxje": -0.92,
    "hzcxse": -0.08,
    "hzjshj": -1.00,
    "chyyDm": "01",
    "hddz": "",
    "hzqrdmxList": [
        {
            "mxxh": "1",
            "xh": "1",
            "xmmc": "第一级水费",
            "sphfwssflhbbm": "1100301010000000000",
            "spfwjc": "水冰雪",
            "ggxh": "",
            "dw": "",
            "fpspdj": "",
            "fphsdj": "",
            "fpspsl": "",
            "je": "-0.92",
            "slv": "0.09",
            "se": "-0.08",
            "hsje": "-1.00",
            "yhzcbs": ""
        }
    ]
}'

返回响应

🟢200成功

application/json

Body

code

string

响应码

必需

00-红字确认单申请提交成功；9999-红字确认单申请提交失败

mess

string

状态描述

必需

示例

{
    "code": "00",
    "mess": "红字确认单申请提交成功"
}

修改于 2025-02-19 05:51:59

单据删除

红字确认单确认