- 灵税宝AI Agent开放平台
- 1. 产品服务
- 1.1 工商注册
- 1.2 智能财税
- 1.3 即时结算
- 1.4 风控预警
- 2. 解决方案
- 3. 税务接口定义
- 3.2 接口协议说明
- 3.3 账户服务
- 3.4 发票开具服务
- 3.5 纳税申报服务
- 3.6 附录
- 4. 银行接口定义
- 4.2 批量结算服务
3.4.3 自产农产品销售发票开具
POST
/api.svc/was.invsvr/electron.tax/blueInvoiceIssu_zcncpxs
/api.svc/was.invsvr/electron.tax/blueInvoiceIssu_zcncpxs
请求参数
Query 参数
version
string
协议版本
示例值:
1.0
appid
string
必需
示例值:
99F0562A5F894CA7BF9A37E0A46B3493
timestamp
string
Unix时间戳
示例值:
1727966629
sign
string
必需
示例值:
8FD98344E3771F558558152EC90DF6764C60A45E
token
string
必需
示例值:
a34a487d85b94722b82da22ce62c590f0542d6f32c8448228624a49b6a72e31b
format
string
响应格式
示例值:
json
Body 参数application/json
reqid
string
业务流水号,guid值
nsrsbh
string
纳税人识别号
mobile
string
电子税务局登录手机号
fpqqlsh
string
发票请求流水号
tdys
string
特定要素
02 稀土发票
03 建筑服务发票
04 货物运输服务发票
05 不动产销售服务发票
06 不动产经营租赁服务
07 代收车船税
08 通行费
09 旅客运输服务发票
10 医疗服务 (住院) 发票
11 医疗服务 (门诊) 发票
12 自产农产品销售发票
13 拖拉 机和联 合收割机发票
14 机动车
15 二手车
16 农产品收购发票
17 光伏收购发票
18 卷烟发票
19 出口发票
20 农产品
fpfxyj_dm
string
发票风险预警代码
01 正常
02 异常
03 疑点
nsrmc
string
开票方纳税人名称
nsrsbh
string
开票方纳税人识别号
swjg_dm
string
税务机关代码
kpxm
string
主要开票项目
kplx
string
开票类型
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
购买方企业类型
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
经办人
rjb_sj
string
经办人手机
rjb_sflx
string
经办人身份类型
jbr_sfzhm
string
经办人身份证号
jbr_gj
string
经办人国籍
sky
string
收款员
sfzsgmfyhzh
string
是否显示购方银行账号
N 不显示
sfzsxsfyhzh
string
是否显示销方银行账号
N 不显示
sfzsgmfdzdh
string
是否显示购买方地址电话
N 不显示
sfzsxsfdzdh
string
是否显示销售方地址电话
N 不显示
fhr
string
复核人
kprq
string
开票日期
fpzl_dm
string
发票种类代码
82 普通发票[数电]
qd_bz
string
清单标志
0 根据项目名称字数,自动
产生清单;
xsfzrr_bz
string
销售方自然人标志
gmfzrr_bz
string
购买方自然人标志
zzfp_bz
string
纸质发票标志
kphjje
string
开票合计金额
hjbhsje
string
合计不含税金额
qyjqpp
string
是否启用精确匹配
spbmjc_bz
string
商品编码简称标志
hjse
string
合计税额
bz
string
备注
备注长度应减去“机器编号:ZZZZZZZZZZZ”,”对应正数发票代码:XXXXXXXXXXXX 号码:YYYYYYYY”字样长度,长度剩余 160。增值税发票代开发票开具时,备注要求:必须在备注中注明 “代开企业税号:XXXXXXXXX 代开企业名称:YYYYYYYY”字样,其中“X”为代开企业税号,“Y”为代开企业名称。
差额征税发票开具时, 备注要求:蓝票必须在备注中注明 “差额征税:X。”字样,其中“X”为差额值。
专用发票冲红时, 备注须注明 “开具红字增值税专用发票信息表编号 M” 字样, 其中 M 为红字发票信息表编号。
sslkjly
string
3%税率开具理由
2-前期已开具相应征收率发票, 发生销售折让、 中止或者退回等情形需要开具红字发票, 或者开票有误需要重新开具;
3-因为实际经营业务需要,放弃享受免征增值税政策。
hzqrdbh
string
红字确认单编号
hzqrduuid
string
红字确认单 uuid
yfp_hm
string
原发票号码
yfp_dm
string
原发票代码
ykprq
string
原开票日期
yfpzl_dm
string
原发票种类代码
is_dae
string
是否开具大额发票
Code : GT4000101220085
Msg: 本张发票开具金额******元,开具金额较大,请确认是否开具? is_dae
传-"Y" 其他情况传""
jf_email
string
交付邮箱
jf_phone
string
交付手机号
macdz
string
Mac 地址
byzd1
string
备用字段 1
byzd2
string
备用字段 2
byzd3
string
备用字段 3
byzd4
string
备用字段 4
byzd5
string
备用字段 5
fpkjxx_xmxxs
array [object {23}]
发票明细
xh
string
商品行序号
fphxz
string
发票行性 质
1 表示折扣行
2 表示被折扣行
xmmc
string
项目名称
只允许对单行商品进行折扣,折扣行紧挨被折行之后, 折扣行的商品名称、 商品编码与被折行相同。 最大100 字节(50 汉字,100 数字)
xmjc
string
项目简称
xmdw
string
项目单位
ggxh
string
规格型号
xmsl
string
项目数量
hsbz
string
含税标志
xmdj
string
项目单价
spbm
string
商品编码
电子发票清单发票冲红时,传入蓝票对应的发票明细数据
yhzcbs
string
优惠政策标识
0:不使用,1:使用
lslbs
string
零税率标识
1:免税
2:不征税
3:普通零税率
zzstsgl
string
增值税特殊管理
详情见 3.3.24
xmje
string
项目金额
等于=单价*数量, 根据含税标志, 确定此金额是否为含税金额。
sl
string
税率
se
string
税额
kce
string
扣除额
tdzsfs_dm
string
特定征税方式代码
byzd1
string
备用字段 1
byzd2
string
备用字段 2
byzd3
string
备用字段 3
byzd4
string
备用字段 4
byzd5
string
备用字段 5
fjys_xxs
array [object {3}]
附加要素列表
fjysmc
string
附加要素名称
fjysz
string
附加要素值
sjlx
string
数据类型
number:数值型
date:日期型
示例
{
"reqid": "业务流水号",
"nsrsbh": "纳税人识别号",
"mobile": "电子税务局登录手机号",
"fpqqlsh": "发票请求流水号",
"tdys": "特定要素",
"cezslx_dm": "差额征税类型代码",
"jazslx_dm": "减按征税类型代码",
"sgfplx_dm": "收购发票类型代码",
"fpfxyj_dm": "发票风险预警代码",
"cktslx_dm": "出口退税类型代码",
"nsrmc": "开票方纳税人名称",
"nsrsbh ": "开票方纳税人识别号",
"swjg_dm": "税务机关代码",
"kpxm": "主要开票项目",
"kplx": "开票类型",
"bmb_bbh": "编码版本号",
"xhfmc": "销售方名称",
"xhf_nsrsbh": "销售方纳税人识别号",
"xhf_dzdh": "销售方地址电话",
"xhf_yhzh": "销售方银行帐户",
"xhf_dz": "销售方地址",
"xhf_dh": "销售方电话",
"xhf_yh": "销售方开户行",
"xhf_zh": "销售方银行帐号",
"ghfqylx": "购买方企业类型",
"ghfmc": "购买方名称",
"ghf_nsrsbh": "购买方纳税人识别号",
"ghf_dzdh": "购买方地址电话",
"ghf_yhzh": "购买方银行账户",
"ghf_dz": "购买方地址",
"ghf_dh": "购买方电话",
"ghf_yh": "购买方开户行",
"ghf_zh": "购买方银行账号",
"ghf_email": "购买方邮箱",
"ghf_sj": "购买方手机",
"kpy": "开票员",
"jbr": "经办人",
"rjb_sj": "经办人手机",
"rjb_sflx": "经办人身份类型",
"jbr_sfzhm": "经办人身份证号",
"jbr_gj": "经办人国籍",
"sky": "收款员",
"zpfp_dm": "纸票发票种类代码",
"fppzl": "发票票种类(发票来源)",
"sfzsgmfyhzh": "是否显示购方银行账号",
"sfzsxsfyhzh": "是否显示销方银行账号",
"sfzsgmfdzdh": "是否显示购买方地址电话",
"sfzsxsfdzdh": "是否显示销售方地址电话",
"fhr": "复核人",
"kprq": "开票日期",
"fpzl_dm": "发票种类代码",
"xsfzrr_bz": "销售方自然人标志",
"gmfzrr_bz": "购买方自然人标志",
"zzfp_bz": "纸质发票标志",
"hpzzfp_bz": "红票纸质发票标志",
"kphjje": "开票合计金额",
"hjbhsje": "合计不含税金额",
"hjse": "合计税额",
"qyjqpp": "是否启用精确匹配",
"bz": "备注",
"sslkjly": "3%税率开具理由",
"hzqrdbh": "红字确认单编号",
"hzqrduuid": "红字确认单 uuid",
"yfp_hm": "原发票号码",
"yfp_dm": "原发票代码",
"ykprq": "原开票日期",
"yfpzl_dm": "原发票种类代码",
"is_dae": "是否开具大额发票",
"jf_email": "交付邮箱",
"jf_phone": "交付手机号",
"macdz": "Mac 地址",
"byzd1": "备用字段 1",
"byzd2": "备用字段 2",
"byzd3": "备用字段 3",
"byzd4": "备用字段 4",
"byzd5": "备用字段 5",
"fpkjxx_xmxxs": [
{
"xh": "商品行序号",
"fphxz": "发票行性质",
"xmmc": "项目名称",
"xmjc": "项目简称",
"xmdw": "项目单位",
"ggxh": "规格型号",
"xmsl": "项目数量",
"hsbz": "含税标志",
"xmdj": "项目单价",
"spbm": "商品编码",
"yhzcbs": "优惠政策标识",
"lslbs": "零税率标识",
"zzstsgl": "增值税特殊管理",
"xmje": "项目金额",
"sl": "税率",
"se": "税额",
"kce": "扣除额",
"tdzsfs_dm": "特定征税方式代码",
"jzjtlxdm": "即征即退类型代码",
"byzd1": "备用字段 1",
"byzd2": "备用字段 2",
"byzd3": "备用字段 3",
"byzd4": "备用字段 4",
"byzd5": "备用字段 5"
}
],
"cepzmxs": [
{
"xh": "差额凭证序号",
"pzlx": "凭证类型",
"fpdm": "发票代码",
"fphm": "发票号码",
"zzfphm": "纸质发票号码",
"pzhm": "凭证号码",
"kjrq": "开具日期",
"hjje": "合计金额",
"kce": "扣除额",
"bz": "备注",
"lrfs": "录入方式",
"bckcje": "本次扣除金额",
"pzhjje": "凭证合计金额"
}
],
"fjys_xxs": [
{
"fjysmc": "附加要素名称",
"fjysz": "附加要素值",
"sjlx": "数据类型"
}
]
}
示例代码
Shell
JavaScript
Java
Swift
Go
PHP
Python
HTTP
C
C#
Objective-C
Ruby
OCaml
Dart
R
请求示例请求示例
Shell
JavaScript
Java
Swift
curl --location --request POST 'https://openapi.lingshuibao.com/api.svc/was.invsvr/electron.tax/blueInvoiceIssu_zcncpxs?version=1.0&appid=99F0562A5F894CA7BF9A37E0A46B3493×tamp=1727966629&sign=8FD98344E3771F558558152EC90DF6764C60A45E&token=a34a487d85b94722b82da22ce62c590f0542d6f32c8448228624a49b6a72e31b&format=json' \
--header 'Content-Type: application/json' \
--data-raw '{
"reqid": "业务流水号",
"nsrsbh": "纳税人识别号",
"mobile": "电子税务局登录手机号",
"fpqqlsh": "发票请求流水号",
"tdys": "特定要素",
"cezslx_dm": "差额征税类型代码",
"jazslx_dm": "减按征税类型代码",
"sgfplx_dm": "收购发票类型代码",
"fpfxyj_dm": "发票风险预警代码",
"cktslx_dm": "出口退税类型代码",
"nsrmc": "开票方纳税人名称",
"nsrsbh ": "开票方纳税人识别号",
"swjg_dm": "税务机关代码",
"kpxm": "主要开票项目",
"kplx": "开票类型",
"bmb_bbh": "编码版本号",
"xhfmc": "销售方名称",
"xhf_nsrsbh": "销售方纳税人识别号",
"xhf_dzdh": "销售方地址电话",
"xhf_yhzh": "销售方银行帐户",
"xhf_dz": "销售方地址",
"xhf_dh": "销售方电话",
"xhf_yh": "销售方开户行",
"xhf_zh": "销售方银行帐号",
"ghfqylx": "购买方企业类型",
"ghfmc": "购买方名称",
"ghf_nsrsbh": "购买方纳税人识别号",
"ghf_dzdh": "购买方地址电话",
"ghf_yhzh": "购买方银行账户",
"ghf_dz": "购买方地址",
"ghf_dh": "购买方电话",
"ghf_yh": "购买方开户行",
"ghf_zh": "购买方银行账号",
"ghf_email": "购买方邮箱",
"ghf_sj": "购买方手机",
"kpy": "开票员",
"jbr": "经办人",
"rjb_sj": "经办人手机",
"rjb_sflx": "经办人身份类型",
"jbr_sfzhm": "经办人身份证号",
"jbr_gj": "经办人国籍",
"sky": "收款员",
"zpfp_dm": "纸票发票种类代码",
"fppzl": "发票票种类(发票来源)",
"sfzsgmfyhzh": "是否显示购方银行账号",
"sfzsxsfyhzh": "是否显示销方银行账号",
"sfzsgmfdzdh": "是否显示购买方地址电话",
"sfzsxsfdzdh": "是否显示销售方地址电话",
"fhr": "复核人",
"kprq": "开票日期",
"fpzl_dm": "发票种类代码",
"xsfzrr_bz": "销售方自然人标志",
"gmfzrr_bz": "购买方自然人标志",
"zzfp_bz": "纸质发票标志",
"hpzzfp_bz": "红票纸质发票标志",
"kphjje": "开票合计金额",
"hjbhsje": "合计不含税金额",
"hjse": "合计税额",
"qyjqpp": "是否启用精确匹配",
"bz": "备注",
"sslkjly": "3%税率开具理由",
"hzqrdbh": "红字确认单编号",
"hzqrduuid": "红字确认单 uuid",
"yfp_hm": "原发票号码",
"yfp_dm": "原发票代码",
"ykprq": "原开票日期",
"yfpzl_dm": "原发票种类代码",
"is_dae": "是否开具大额发票",
"jf_email": "交付邮箱",
"jf_phone": "交付手机号",
"macdz": "Mac 地址",
"byzd1": "备用字段 1",
"byzd2": "备用字段 2",
"byzd3": "备用字段 3",
"byzd4": "备用字段 4",
"byzd5": "备用字段 5",
"fpkjxx_xmxxs": [
{
"xh": "商品行序号",
"fphxz": "发票行性质",
"xmmc": "项目名称",
"xmjc": "项目简称",
"xmdw": "项目单位",
"ggxh": "规格型号",
"xmsl": "项目数量",
"hsbz": "含税标志",
"xmdj": "项目单价",
"spbm": "商品编码",
"yhzcbs": "优惠政策标识",
"lslbs": "零税率标识",
"zzstsgl": "增值税特殊管理",
"xmje": "项目金额",
"sl": "税率",
"se": "税额",
"kce": "扣除额",
"tdzsfs_dm": "特定征税方式代码",
"jzjtlxdm": "即征即退类型代码",
"byzd1": "备用字段 1",
"byzd2": "备用字段 2",
"byzd3": "备用字段 3",
"byzd4": "备用字段 4",
"byzd5": "备用字段 5"
}
],
"cepzmxs": [
{
"xh": "差额凭证序号",
"pzlx": "凭证类型",
"fpdm": "发票代码",
"fphm": "发票号码",
"zzfphm": "纸质发票号码",
"pzhm": "凭证号码",
"kjrq": "开具日期",
"hjje": "合计金额",
"kce": "扣除额",
"bz": "备注",
"lrfs": "录入方式",
"bckcje": "本次扣除金额",
"pzhjje": "凭证合计金额"
}
],
"fjys_xxs": [
{
"fjysmc": "附加要素名称",
"fjysz": "附加要素值",
"sjlx": "数据类型"
}
]
}'
返回响应
🟢200成功
application/json
Body
code
string
业务错误代码
msg
string
业务错误描述
fp_hm
string
发票号码
kprq
string
开具日期
xhf_nsrsbh
string
销售方纳税人识别号
xhf_mc
string
销售方名称
jshj
string
价税合计
bzxx
string
备注信息
hzfpxxqrdbh
string