3.4.6 一般发票开具

接口说明

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

约束条件

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

请求参数

Query 参数

appid

string

必需

用户唯一凭证，由平台提供

示例值:

Zu4PXFeyu7gX

timestamp

string

Unix时间戳

必需

示例值:

1746979999

sign

string

必需

hmac+sha256 加密

示例值:

d88b1f5c2ec5b8e016b8523edd5977e7549d6d73c3c01a0724410951c7be2b39

Body 参数application/json

reqid

string

业务流水号

可选

nsrsbh

string

纳税人识别号

必需

mobile

string

电子税务局登录手机号

可选

fpkjxx_fptxx

object (schema.Fpkjxx_fptxx)

发票信息

必需

fpqqlsh

string

发票请求流水号

可选

发票请求的唯一标识，唯一不可重复，例如：
20250601230114751937800，流水号中不能有特殊字符，不能有下划线（_），不能有短横线(-)

tdys

string

特定要素

可选

01 成品油发票
02 稀土发票
03 建筑服务发票
04 货物运输服务发票
05 不动产销售服务发票
06 不动产经营租赁服务
07 代收车船税
08 通行费
09 旅客运输服务发票
10 医疗服务（住院）发票
11 医疗服务（门诊）发票
12 自产农产品销售发票
13 拖拉机和联合收割机
发票
14 机动车
15 二手车
16 农产品收购发票
17 光伏收购发票
18 卷烟发票
19 出口发票
20 农产品

cezslx_dm

string

差额征税类型代码

可选

01 全额开票
02 差额开票

jazslx_dm

string

减按征税类型代码

可选

01 个人出租住房
02 小规模复工复业
03 销售自己使用过的固定资产
04 销售收购的二手车
05 住房租赁
51 开具发票为 2022 年 4月 1 日前发生纳税义务的业务
52 前期已开具相应征收率发票
53 因实际经营业务需要，放弃享受免征增值税政策

sgfplx_dm

string

收购发票类型代码

可选

空非收购发票
01 农产品收购发票
02 光伏收购发票
03 二手车收购发票

fpfxyj_dm

string

发票风险预警代码

可选

开票类型为 2 时，传入
01 正常
02 异常
03 疑点

cktslx_dm

string

出口退税类型代码

可选

空非出口业务
01 出口退税专用
注：开具出口退税业时，
cktslx_dm 不为空且值只能为 01

nsrmc

string

开票方纳税人名称

必需

nsrsbh

string

开票方纳税人识别号

必需

swjg_dm

string

税务机关代码

可选

kpxm

string

主要开票项目

必需

必须与项目信息中第一条
数据的项目名称保持一致

kplx

string

开票类型

必需

1 蓝票
2 红票

bmb_bbh

string

编码版本号

必需

税务局发布的税收分类编码版本

xhfmc

string

销售方名称

必需

xhf_nsrsbh

string

销售方纳税人识别号

必需

企业纳税人识别号，仅支持数字、大小写字母

xhf_dzdh

string

销售方地址电话

必需

xhf_yhzh

string

销售方银行账号

必需

xhf_dz

string

销售方地址

必需

xhf_dh

string

销售方电话

必需

销售方电话（支持数字、空格”-"、“+”）

xhf_yh

string

销售方开户行

必需

xhf_zh

string

销售方银行账号

必需

ghfqylx

string

购买方企业类型

必需

01：企业
02：机关事业单位
03：个人
04：其它

ghfmc

string

购买方名称

必需

ghf_nsrsbh

string

购买方纳税人识别号

可选

条件必填，普票非必填，专票必填，其他情况可以为空。仅支持数字、大小写字母

ghf_dzdh

string

购买方地址电话

可选

ghf_yhzh

string

购买方银行账号

可选

ghf_dz

string

购买方地址

可选

ghf_dh

string

购买方电话

可选

ghf_yh

string

购买方开户行

可选

ghf_zh

string

购买方银行账号

可选

ghf_email

string

购买方邮箱

可选

ghf_sj

string

购买方手机

可选

kpy

string

开票员

可选

jbr

string

经办人

可选

jbr_sj

string

经办人手机

可选

jbr_sflx

string

经办人身份类型

可选

详情见 3.6.29 经办人身份类型

jbr_sfzhm

string

经办人身份证号

可选

因证件类型不同，校验规则不同，统一校验；最大长度30

jbr_gj

string

经办人国籍

可选

详情见 3.6.27 经办人国籍代码

sky

string

收款员

可选

只能包含数字、大小写字母、汉字、或空格

zpfp_dm

string

纸票发票种类代码

可选

纸票发票种类代码，开纸票时为必填项，查询全电纸票发票种类接口返回值中的value

fppzl

string

发票票种类

可选

01 数电发票
02 非数电发票

sfzsgmfyhzh

string

是否显示购方银行账号

必需

Y 显示，N 不显示

sfzsxsfyhzh

string

是否显示销方银行账号

必需

Y 显示，N 不显示

sfzsgmfdzdh

string

是否显示购买方地址电话

可选

Y 显示，N 不显示

sfzsxsfdzdh

string

是否显示销售方地址电话

可选

Y 显示，N 不显示

zrr_zjlxdm

string

自然人证件类型代码

可选

详情见 3.6.11 身份证件类型

zrr_zjhm

string

自然人证件号码

可选

zrr_gjdm

string

自然人国籍代码

可选

详情见 3.6.27 经办人国籍代码

fhr

string

复核人

可选

只能包含数字、大小写字母、汉字、或空格

kprq

string

开票日期

可选

格式：yyyy-MM-dd HH:mm:ss

fpzl_dm

string

发票种类代码

必需

81 增值税专用发票[数电] 82 普通发票[数电]

xsfzrr_bz

string

销售方自然人标志

必需

Y/N

gmfzrr_bz

string

购买方自然人标志

必需

Y/N

zzfp_bz

string

纸质发票标志

必需

Y/N

hpzzfp_bz

string

红票纸质发票标志

必需

Y/N， Y 是纸质红票， N 开电子红票，不填默认是电子红票

kphjje

string

开票合计金额

必需

小数点后 2 位，以元为单位精确到分

hjbhsje

string

合计不含税金额

可选

默认为 0，小数点后 2 位，以元为单位精确到分（单行商品金额之和），开票时通过价税合计反推。

hjse

string

合计税额

可选

默认为 0，小数点后 2 位，以元为单位精确到分(单行商品税额之和)，开票时通过价税合计反推。

qyjjpp

string

是否启用精确匹配

可选

校验是否启用精确匹配（Y/N)，不填默认为N；用于开具失败防重票处理，如果启用了精确匹配，备注bz 字段格式需按照要求格式传参；如果启用精准匹配但备注的NBDH 字段不是唯一，就可能会匹配多张发票并放入疑似发票列表中需要

string

备注

可选

sslkjly

string

3%税率开具理由

可选

条件必填
3%税率开具理由（小规模纳税人明细中含 3%税率时需要 sslkjly 传值 04 或 05）明细中含 3%税率且为普票，sslkjly 只能为 04;
明细中含 3%税率且为专票，sslkjly 只能为 04 或 05。04-前期已开具 3%征收率的发票，发生销售折让、中止或者退回等情形需要开具3%征收率的红字发票，或者开票有误需要重新开具 3%征收率的发票;05- 因为实际经营业务需要，放弃享受减按 1%征收率征收增值税政策。

hzqrdbh

string

红字确认单编号

可选

hzqrduuid

string

红字确认单 uuid

可选

yfp_hm

string

原发票号码

可选

冲红数电发票或增值税管理系统发票或数电纸票时必填

yfp_dm

string

原发票代码

可选

ykprq

string

原开票日期

可选

格式：yyyy-MM-dd HH:mm:ss

yfpzl_dm

string

原发票种类代码

可选

对应的发票为增值税管理系统发票或全电纸票冲红时为必填

is_dae

string

是否开具大额发票

可选

若触发授信额度大额发票提醒规则Code ：GT4000101220085
Msg: 本张发票开具金额
******元，开具金额较大，
请确认是否开具? is_dae传-"Y" 其他情况传""

jf_email

string

交付邮箱

可选

邮箱不为空时交付邮箱

jf_phone

string

交付手机号

可选

手机不为空时交付手机号

macdz

string

Mac 地址

可选

ac 地址为六组两位字符组成，由冒号分隔，比如：00:1B:44:11:3A:B7

mtpzxx

string

煤炭品质信息

可选

条件必填
煤炭商品不含税合计金额大于等于 1000 万时需要传值
传值规范：煤炭发热量支持0-99999 整数；干基全硫支持 0-100 数字；干燥无灰基挥发分支持 0-100 数字。
示例：每千克煤炭发热量 :100千卡、干基全硫:5.00%、干燥无灰基挥发分:5.20%

byzd1

string

备用字段 1

可选

byzd2

string

备用字段 2

可选

byzd3

string

备用字段 3

可选

byzd4

string

备用字段 4

可选

byzd5

string

备用字段 5

可选

fpkjxx_xmxxs

array[object (schema.Fpkjxx_xmxxs) {25}]

发票明细

必需

string

商品行序号

必需

fphxz

enum<string>

发票行性质

必需

0 表示正常商品行
1 表示折扣行
2 表示被折扣行

枚举值:

012

xmmc

string

项目名称

必需

项目名称前必须加商品简称，格式：项目简称项目名称。
只允许对单行商品进行折扣，折扣行紧挨被折行之后，折扣行的商品名称、商品编码与被折行相同。
项目名称最大长度 100

xmjc

string

项目简称

可选

该字段传值主要解决项目名称非"项目简称项目名称"标准格式化数据开具后项目名称展示不一致问题

xmdw

string

项目单位

可选

ggxh

string

规格型号

可选

最长 40 个字符（20 汉字，40数字）

xmsl

string

项目数量

可选

hsbz

enum<string>

含税标志

必需

默认为 0，表示项目单价和
项目金额是否含税。
0 表示都不含税，1 表示都含税。

枚举值:

xmdj

string

项目单价

可选

数字，最大 12 位整数，12位整数的情况下小数最多 4位，13 位小数时候整数最多 3 位，最多 16 位（系统反算最大 13 位小数）

spbm

string

商品编码

必需

商品编码，不足位时，请自行补 0；
电子发票清单发票冲红时，传入蓝票对应的发票明细数据

示例值:

3040201030000000000

yhzcbs

enum<string>

优惠政策标识

必需

商品编码版本：必填0：不使用，1：使用

枚举值:

lslbs

string

零税率标识

可选

空：非零税率，
1：免税
2：不征税
3：普通零税率

zzstsgl

string

增值税特殊管理

必需

享受优惠政策标志为 1 时必填；
详情见 3.6.24 增值税特殊管理类型

xmje

string

项目金额

必需

数字，金额手工录入最大支持 16 位整数，自动保留 2位小数.00，含有小数最大14 位整数 2 位小数；
等于=单价*数量，根据含税标志，确定此金额是否为含税金额。

示例值:

16.98

string

税率

必需

保留两位有效小数。如果税率为 0，表示免税（正常税率以小数形式给出，如0.17）。最大 8 字符

示例值:

0.06

string

税额

必需

数字，金额手工录入最大支持 16 位整数，自动保留 2 位小数.00，含有小数最大14 位整数 2 位小数

示例值:

1.02

kce

string

扣除额

可选

mtzldm

string

煤炭种类代码

可选

条件必填
0100 政府保供煤
0201 长协煤-协议期不足半年
0202 长协煤-协议期在半年到一年之间
0203 长协煤-协议期在一年到两年之间
0204 长协煤-协议期在两年以上
0300 市场煤

tdzsfs_dm

string

特定征税方式代码

可选

详情见 3.6.22 特定征税方式代码

jzjtlxdm

string

即征即退类型代码

可选

详情见 3.6.28 即征即退类型代码

byzd1

string

备用字段 1

可选

byzd2

string

备用字段 2

可选

byzd3

string

备用字段 3

可选

byzd4

string

备用字段 4

可选

byzd5

string

备用字段 5

可选

zfxx_list

array[object (schema.Zfxx_list) {3}]

支付信息

可选

数电票时选填

string

序号

必需

不能大于 10 行明细

zfqd_dm

string

支付渠道

必需

jydh

string

交易单号

可选

支持录入字母，数字，汉字，特殊字符

cepzmxs

array[object (schema.Cepzmx) {13}]

差额发票

可选

开具差额发票时必填

bckcje

string

本次扣除金额

可选

string

备注

可选

fpdm

string

发票代码

可选

fphm

string

发票号码

可选

hjje

string

合计金额

可选

kce

string

扣除额

可选

kjrq

string

开具日期

可选

lrfs

string

录入方式

可选

pzhjje

string

凭证合计金额

可选

pzhm

string

凭证号码

可选

pzlx

string

票种类型

可选

string

序号

可选

zzfphm

string

纸质发号码

可选

fjys_xxs

array[object (schema.Fjys_xxs) {3}]

附加要素列表

可选

附加要素列表全字段都要传，可以没有值

fjysmc

string

附加要素信息

可选

fjysz

string

附加要素值

可选

sjlx

string

数据类型

可选

string：文本型
number：数值型
date：日期型

示例

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

integer

错误码

可选

data

object

schema.ResponseInvoiceIssu

可选

fp_hm

string

发票号码

可选

kprq

string

开具日期

可选

格式：yyyy-MM-dd HH:mm:ss

zzfp_hm

string

纸质发票号码

可选

fp_dm

string

纸质发票代码

可选

jbr_gj

string

经办人国籍

可选

xhf_nsrsbh

string

销售方纳税人识别号

可选

kplx开票类型字段为 2，即为红票时才会返回

xhf_mc

string

销售方名称

可选

kplx开票类型字段为 2，即为红票时才会返回

jshj

string

价税合计

可选

kplx开票类型字段为 2，即为红票时才会返回

bzxx

string

备注信息

可选

kplx开票类型字段为 2，即为红票时才会返回

hzfpxxqrdbh

string

红字发票信息确认单编号

可选

kplx开票类型字段为 2，即为红票时才会返回

msg

string

错误信息

可选

示例

{
    "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服务器错误

接口说明#

约束条件#

请求参数

示例代码

返回响应

接口说明

约束条件