3.2.2 一般发票开具

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

约束条件：

调用 1.1单位账户登录 接口成功；

开具出口退税发票时，购方企业必须是"外贸综合服务"企业

开具数电纸票时需要先请求"全电纸票发票种类查询"接口

开票请求报文不能缺少节点，差额发票和附加要素列表字段不需要时也需传空值

煤炭商品编码：1020101000000000000、1020102000000000000、1020199000000000000

开票接口触发防重开票流程时的操作流程

流程说明

防重开票流程图

防重开票处理结果流程图

红字发票开具流程

示例数据

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

Body参数

TaxInvoiceRequest 结构定义

Cepzmx 结构定义

Cepzmx GO语言定义

Cepzmx Java语言定义

Cepzmx Typescript语言定义

FjysXx 结构定义

FjysXx GO语言定义

FjysXx Java语言定义

FjysXx Typescript语言定义

FpkjxxXmx 结构定义

FpkjxxXmx GO语言定义

FpkjxxXmx Java语言定义

FpkjxxXmx Typescript语言定义

FpkjxxFptxx 结构定义

FpkjxxFptxx GO语言定义

FpkjxxFptxx Java语言定义

FpkjxxFptxx Typescript语言定义

Zfxx 结构定义

Zfxx GO语言定义

Zfxx Java语言定义

Zfxx Typescript语言定义

TaxInvoiceRequest GO语言定义

TaxInvoiceRequest Java语言定义

TaxInvoiceRequest Typescript语言定义

请求Body报文示例

接口响应

[200]发票开具结果

ginx.OkResult 结构定义

ResponseTaxInvoice 结构定义

ResponseTaxInvoice GO语言定义

ResponseTaxInvoice Java语言定义

ResponseTaxInvoice Typescript语言定义

[200]发票开具结果报文示例

[400]Bad Request

ginx.ResponseError 结构定义

[400]Bad Request 报文示例

[500]Internal Server Error

ginx.ResponseError 结构定义

[500]Internal Server Error 报文示例

请求参数

Query 参数

Body 参数application/json必填

示例

{
    "cepzmxs": [
        {
            "bckcje": "string",
            "bz": "string",
            "fpdm": "string",
            "fphm": "string",
            "hjje": "string",
            "kce": "string",
            "kjrq": "string",
            "lrfs": "string",
            "pzhjje": "string",
            "pzhm": "string",
            "pzlx": "string",
            "xh": "string",
            "zzfphm": "string"
        }
    ],
    "fjys_xxs": [
        {
            "fjysmc": "string",
            "fjysz": "string",
            "sjlx": "string"
        }
    ],
    "fpkjxx_fptxx": {
        "bmb_bbh": "string",
        "byzd1": "string",
        "byzd2": "string",
        "byzd3": "string",
        "byzd4": "string",
        "byzd5": "string",
        "bz": "string",
        "cezslx_dm": "string",
        "cktslx_dm": "string",
        "fhr": "string",
        "fpfxyj_dm": "string",
        "fppzl": "string",
        "fpqqlsh": "string",
        "fpzl_dm": "81",
        "ghf_dh": "string",
        "ghf_dz": "string",
        "ghf_dzdh": "string",
        "ghf_email": "string",
        "ghf_nsrsbh": "string",
        "ghf_sj": "string",
        "ghf_yh": "string",
        "ghf_yhzh": "string",
        "ghf_zh": "string",
        "ghfmc": "string",
        "ghfqylx": "01",
        "gmfzrr_bz": "string",
        "hjbhsje": "16.98",
        "hjse": "1.02",
        "hpzzfp_bz": "string",
        "hzqrdbh": "string",
        "hzqrduuid": "string",
        "is_dae": "string",
        "jazslx_dm": "string",
        "jbr": "string",
        "jbr_gj": "string",
        "jbr_sflx": "string",
        "jbr_sfzhm": "string",
        "jbr_sj": "string",
        "jf_email": "string",
        "jf_phone": "string",
        "jffs": "string",
        "kphjje": "18.00",
        "kplx": "1",
        "kprq": "string",
        "kpxm": "string",
        "kpy": "string",
        "macdz": "string",
        "mtpzxx": "string",
        "nsrmc": "string",
        "nsrsbh": "string",
        "qyjjpp": "string",
        "sfzsgmfdzdh": "string",
        "sfzsgmfyhzh": "string",
        "sfzsxsfdzdh": "string",
        "sfzsxsfyhzh": "string",
        "sgfplx_dm": "string",
        "sky": "string",
        "sslkjly": "string",
        "swjg_dm": "string",
        "tdys": "string",
        "xhf_dh": "string",
        "xhf_dz": "string",
        "xhf_dzdh": "string",
        "xhf_nsrsbh": "string",
        "xhf_yh": "string",
        "xhf_yhzh": "string",
        "xhf_zh": "string",
        "xhfmc": "string",
        "xsfzrr_bz": "string",
        "yfp_dm": "string",
        "yfp_hm": "string",
        "yfpzl_dm": "string",
        "ykprq": "string",
        "zpfp_dm": "string",
        "zrr_gjdm": "string",
        "zrr_zjhm": "string",
        "zrr_zjlxdm": "string",
        "zzfp_bz": "string"
    },
    "fpkjxx_xmxxs": [
        {
            "byzd1": "string",
            "byzd2": "string",
            "byzd3": "string",
            "byzd4": "string",
            "byzd5": "string",
            "fphxz": "0",
            "ggxh": "string",
            "hsbz": "0",
            "jzjtlxdm": "string",
            "kce": "string",
            "lslbs": "string",
            "mtzldm": "string",
            "se": "1.02",
            "sl": "0.06",
            "spbm": "3040201030000000000",
            "tdzsfs_dm": "string",
            "xh": "string",
            "xmdj": "string",
            "xmdw": "string",
            "xmjc": "string",
            "xmje": "16.98",
            "xmmc": "string",
            "xmsl": "string",
            "yhzcbs": "0",
            "zzstsgl": "string"
        }
    ],
    "mobile": "string",
    "nsrsbh": "91320110MA0000000000",
    "reqid": "string",
    "zfxx_list": [
        {
            "jydh": "string",
            "xh": "string",
            "zfqd_dm": "string"
        }
    ]
}

请求示例代码

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&timestamp&sign' \
--header 'Content-Type: application/json' \
--data-raw '{
    "cepzmxs": [
        {
            "bckcje": "string",
            "bz": "string",
            "fpdm": "string",
            "fphm": "string",
            "hjje": "string",
            "kce": "string",
            "kjrq": "string",
            "lrfs": "string",
            "pzhjje": "string",
            "pzhm": "string",
            "pzlx": "string",
            "xh": "string",
            "zzfphm": "string"
        }
    ],
    "fjys_xxs": [
        {
            "fjysmc": "string",
            "fjysz": "string",
            "sjlx": "string"
        }
    ],
    "fpkjxx_fptxx": {
        "bmb_bbh": "string",
        "byzd1": "string",
        "byzd2": "string",
        "byzd3": "string",
        "byzd4": "string",
        "byzd5": "string",
        "bz": "string",
        "cezslx_dm": "string",
        "cktslx_dm": "string",
        "fhr": "string",
        "fpfxyj_dm": "string",
        "fppzl": "string",
        "fpqqlsh": "string",
        "fpzl_dm": "81",
        "ghf_dh": "string",
        "ghf_dz": "string",
        "ghf_dzdh": "string",
        "ghf_email": "string",
        "ghf_nsrsbh": "string",
        "ghf_sj": "string",
        "ghf_yh": "string",
        "ghf_yhzh": "string",
        "ghf_zh": "string",
        "ghfmc": "string",
        "ghfqylx": "01",
        "gmfzrr_bz": "string",
        "hjbhsje": "16.98",
        "hjse": "1.02",
        "hpzzfp_bz": "string",
        "hzqrdbh": "string",
        "hzqrduuid": "string",
        "is_dae": "string",
        "jazslx_dm": "string",
        "jbr": "string",
        "jbr_gj": "string",
        "jbr_sflx": "string",
        "jbr_sfzhm": "string",
        "jbr_sj": "string",
        "jf_email": "string",
        "jf_phone": "string",
        "jffs": "string",
        "kphjje": "18.00",
        "kplx": "1",
        "kprq": "string",
        "kpxm": "string",
        "kpy": "string",
        "macdz": "string",
        "mtpzxx": "string",
        "nsrmc": "string",
        "nsrsbh": "string",
        "qyjjpp": "string",
        "sfzsgmfdzdh": "string",
        "sfzsgmfyhzh": "string",
        "sfzsxsfdzdh": "string",
        "sfzsxsfyhzh": "string",
        "sgfplx_dm": "string",
        "sky": "string",
        "sslkjly": "string",
        "swjg_dm": "string",
        "tdys": "string",
        "xhf_dh": "string",
        "xhf_dz": "string",
        "xhf_dzdh": "string",
        "xhf_nsrsbh": "string",
        "xhf_yh": "string",
        "xhf_yhzh": "string",
        "xhf_zh": "string",
        "xhfmc": "string",
        "xsfzrr_bz": "string",
        "yfp_dm": "string",
        "yfp_hm": "string",
        "yfpzl_dm": "string",
        "ykprq": "string",
        "zpfp_dm": "string",
        "zrr_gjdm": "string",
        "zrr_zjhm": "string",
        "zrr_zjlxdm": "string",
        "zzfp_bz": "string"
    },
    "fpkjxx_xmxxs": [
        {
            "byzd1": "string",
            "byzd2": "string",
            "byzd3": "string",
            "byzd4": "string",
            "byzd5": "string",
            "fphxz": "0",
            "ggxh": "string",
            "hsbz": "0",
            "jzjtlxdm": "string",
            "kce": "string",
            "lslbs": "string",
            "mtzldm": "string",
            "se": "1.02",
            "sl": "0.06",
            "spbm": "3040201030000000000",
            "tdzsfs_dm": "string",
            "xh": "string",
            "xmdj": "string",
            "xmdw": "string",
            "xmjc": "string",
            "xmje": "16.98",
            "xmmc": "string",
            "xmsl": "string",
            "yhzcbs": "0",
            "zzstsgl": "string"
        }
    ],
    "mobile": "string",
    "nsrsbh": "91320110MA0000000000",
    "reqid": "string",
    "zfxx_list": [
        {
            "jydh": "string",
            "xh": "string",
            "zfqd_dm": "string"
        }
    ]
}'

返回响应

🟢200成功

application/json

发票开具结果

Body

示例

{
    "code": 0,
    "data": {
        "bzxx": "string",
        "fp_dm": "string",
        "fp_hm": "string",
        "hzfpxxqrdbh": "string",
        "jshj": "string",
        "kprq": "string",
        "xhf_mc": "string",
        "xhf_nsrsbh": "string",
        "zzfp_hm": "string"
    },
    "msg": "string"
}

🟠400请求有误

🔴500服务器错误

约束条件：#

开票接口触发防重开票流程时的操作流程#

示例数据#

Body参数#

接口响应#

[200]发票开具结果#

[400]Bad Request#

[500]Internal Server Error#