快捷申请即开票

集成红字确认单申请+查询确认单同步状态+红票开具；

注意：
1.sqdh请求流水号与红票fpqqlsh请求流水号相同
2.30秒请求一次，直到成功或失败（72小时内的才重试，红字确认单最大72小时有效）

响应状态情况：
（两层响应报文，第一层代表红字确认单申请情况，第二层代表发票开具情况）
情况一：失败状态码+null：结束
情况二：00+null ：等待，继续请求本接口（请求流水号不变即原报文不变）
情况三：0000+00：调发票查看接口获取板式文件，或者继续请求本接口
情况四：0000+0000：调发票查看接口获取板式文件
情况五：0000+失败状态码：人工处理PC端处理

如：
{
"code": "0000",
"data": {
"code": "00",
"isStored": true,
"mess": "开票提交成功"
},
"isStored": false,
"mess": "红字确认单申请成功"
}

场景1：（无需确认情况）
1.调该接口，申请确认单成功
2.内部立刻开红票
3.响应开具结果（提交成功状态为00，开具成功为0000）

场景2：（申请确认单信息错误情况）
1.调该接口，申请确认单成功
2.响应申请确认单失败结果

场景3：（确认单需要购销方确认情况）
1.调该接口，申请确认单成功
2.响应确认单申请结果（业务系统ERP要判断确认单是否为待购销方确认情况，再次请求，具体查看【红字确认单查询接口】）
2. 重新调该接口（使用原报文），异步自动同步状态
3. 重新调该接口（使用原报文），检查确认单状态是否无需确认或购销方已确认，如果是则自动开票

场景4：（开票存在错误情况）
1.调该接口，申请确认单成功
2.内部立刻开红票，如遇到：开票中、网络异常
3.响应返回错误信息（业务系统根据情况重新提交请求，或者进入PC端页面修复）
4.重新调该接口（使用原报文），开票成功，则返回0000，信息：此流水号发票已开具成功

请求参数

Header 参数

Body 参数application/json

示例

{
    "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

application/json

Bodyapplication/json

示例

申请确认单提交成功示例（未开具红票）发票开具成功申请确认单成功，发票提交成功（未完全开具成功）

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

请求参数

请求示例代码

返回响应