3.4.6 一般发票开具

接口说明

此接口用于一般发票开具，目前支持通用蓝字 / 红字发票和差额票的开具。

约束条件

1.
调用 3.3.1 单位账户登录接口成功；
2.
开具出口退税发票时，购方企业必须是"外贸综合服务"企业
3.
开具数电纸票时需要先请求"全电纸票发票种类查询"接口
4.
开票请求不能缺少节点，差额发票和附加要素列表字段不需要时也需传空值

请求参数

Query 参数

Body 参数application/json

示例

{
    "reqid": "20250601230114752263864",
    "nsrsbh": "91530302MAD475743B",
    "mobile": "13004160225",
    "fpkjxx_fptxx": {
        "fpqqlsh": "20250601230114751937800",
        "nsrmc": "灵税宝（曲靖）网络有限公司",
        "nsrsbh": "91530302MAD475743B",
        "kpxm": "*信息技术服务*数据处理服务",
        "kplx": "1",
        "bmb_bbh": "",
        "xhfmc": "灵税宝（曲靖）网络有限公司",
        "xhf_nsrsbh": "91530302MAD475743B",
        "xhf_dzdh": "0874-3284919，云南省曲靖市麒麟区沿江街道办事处东海屯路346号曲靖麒麟人力资源服务产业园212号",
        "xhf_yhzh": "平安银行股份有限公司昆明巫家坝支行，15450474610023",
        "xhf_dz": "云南省曲靖市麒麟区沿江街道办事处东海屯路346号曲靖麒麟人力资源服务产业园212号",
        "xhf_dh": "0874-3284919",
        "xhf_yh": "平安银行股份有限公司昆明巫家坝支行",
        "xhf_zh": "15450474610023",
        "ghfqylx": "01",
        "ghfmc": "云南新视数据管理有限公司",
        "ghf_nsrsbh": "91530111MAC0A1J15D",
        "ghf_dzdh": "中国（云南）自由贸易试验区昆明片区官渡区矣六街道办事处观云海千云荟一号楼3层0302号,15368864099",
        "ghf_yhzh": "中国民生银行股份有限公司昆明螺蛳湾支行，637404546",
        "ghf_dz": "中国（云南）自由贸易试验区昆明片区官渡区矣六街道办事处观云海千云荟一号楼3层0302号",
        "ghf_dh": "15368864099",
        "ghf_yh": "中国民生银行股份有限公司昆明螺蛳湾支行",
        "ghf_zh": "637404546",
        "sfzsgmfyhzh": "N",
        "sfzsxsfyhzh": "N",
        "fpzl_dm": "81",
        "xsfzrr_bz": "N",
        "gmfzrr_bz": "N",
        "zzfp_bz": "N",
        "kphjje": "18.00",
        "hjbhsje": "16.98",
        "hjse": "1.02",
        "bz": "",
        "is_dae": ""
    },
    "fpkjxx_xmxxs": [
        {
            "xh": "001",
            "fphxz": "0",
            "xmmc": "*信息技术服务*数据处理服务",
            "xmdw": "项",
            "ggxh": "次",
            "xmsl": "1",
            "xmdj": "16.98",
            "hsbz": "0",
            "spbm": "3040201030000000000",
            "yhzcbs": "0",
            "lslbs": "",
            "xmje": "16.98",
            "sl": "0.06",
            "se": "1.02"
        }
    ]
}

请求示例代码

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

curl --location --request POST 'https://agentapi.lingshuibao.com/agent/tax/v1/invoice/issu?appid=Zu4PXFeyu7gX&timestamp=1746979999&sign=d88b1f5c2ec5b8e016b8523edd5977e7549d6d73c3c01a0724410951c7be2b39' \
--header 'Content-Type: application/json' \
--data-raw '{
    "reqid": "20250601230114752263864",
    "nsrsbh": "91530302MAD475743B",
    "mobile": "13004160225",
    "fpkjxx_fptxx": {
        "fpqqlsh": "20250601230114751937800",
        "nsrmc": "灵税宝（曲靖）网络有限公司",
        "nsrsbh": "91530302MAD475743B",
        "kpxm": "*信息技术服务*数据处理服务",
        "kplx": "1",
        "bmb_bbh": "",
        "xhfmc": "灵税宝（曲靖）网络有限公司",
        "xhf_nsrsbh": "91530302MAD475743B",
        "xhf_dzdh": "0874-3284919，云南省曲靖市麒麟区沿江街道办事处东海屯路346号曲靖麒麟人力资源服务产业园212号",
        "xhf_yhzh": "平安银行股份有限公司昆明巫家坝支行，15450474610023",
        "xhf_dz": "云南省曲靖市麒麟区沿江街道办事处东海屯路346号曲靖麒麟人力资源服务产业园212号",
        "xhf_dh": "0874-3284919",
        "xhf_yh": "平安银行股份有限公司昆明巫家坝支行",
        "xhf_zh": "15450474610023",
        "ghfqylx": "01",
        "ghfmc": "云南新视数据管理有限公司",
        "ghf_nsrsbh": "91530111MAC0A1J15D",
        "ghf_dzdh": "中国（云南）自由贸易试验区昆明片区官渡区矣六街道办事处观云海千云荟一号楼3层0302号,15368864099",
        "ghf_yhzh": "中国民生银行股份有限公司昆明螺蛳湾支行，637404546",
        "ghf_dz": "中国（云南）自由贸易试验区昆明片区官渡区矣六街道办事处观云海千云荟一号楼3层0302号",
        "ghf_dh": "15368864099",
        "ghf_yh": "中国民生银行股份有限公司昆明螺蛳湾支行",
        "ghf_zh": "637404546",
        "sfzsgmfyhzh": "N",
        "sfzsxsfyhzh": "N",
        "fpzl_dm": "81",
        "xsfzrr_bz": "N",
        "gmfzrr_bz": "N",
        "zzfp_bz": "N",
        "kphjje": "18.00",
        "hjbhsje": "16.98",
        "hjse": "1.02",
        "bz": "",
        "is_dae": ""
    },
    "fpkjxx_xmxxs": [
        {
            "xh": "001",
            "fphxz": "0",
            "xmmc": "*信息技术服务*数据处理服务",
            "xmdw": "项",
            "ggxh": "次",
            "xmsl": "1",
            "xmdj": "16.98",
            "hsbz": "0",
            "spbm": "3040201030000000000",
            "yhzcbs": "0",
            "lslbs": "",
            "xmje": "16.98",
            "sl": "0.06",
            "se": "1.02"
        }
    ]
}'

返回响应

🟢200成功

application/json

Body

示例

{
    "code": 0,
    "data": {
        "fp_hm": "25532000000055871314",
        "zzfp_hm": "",
        "fp_dm": "",
        "kprq": "2025-05-1 09:56:55",
        "xhf_nsrsbh": "",
        "xhf_mc": "",
        "jshj": "",
        "bzxx": "",
        "hzfpxxqrdbh": ""
    },
    "msg": ""
}

🟠400请求有误

🔴500服务器错误

接口说明#

约束条件#

请求参数

请求示例代码

返回响应

接口说明

约束条件