- 概述
- 账户服务
- 开票服务
- 获取风险预警级别接口POST
- 获取二维码POST
- 二次认证状态查询接口POST
- 直接发票开具接口(金四)POST
- 货物运输直接发票开具接口(金四)POST
- 申请查询蓝票订单结果(金四)POST
- 获取蓝票订单申请的处理结果(金四)POST
- 发票列表查询(蓝\红票)(金三+金四)POST
- 单张发票查询(蓝\红票)(金四)POST
- 发票下载(金四)POST
- 红字确认单开具接口(金三+金四)POST
- 红字确认单处理(金四)POST
- 红字确认单详情查询(金四)POST
- 红字确认单列表查询(金四)POST
- 红字确认单下载POST
- 发票冲红状态查询(蓝票对应红票状态查询 蓝\红票)(金四)POST
- 发票用票信息状态查询(金四)POST
- 查询发票明细接口(金三+金四)POST
货物运输直接发票开具接口(金四)
开发中
POST
https://skynjweb.com:7443/hx/api/fp/h5.js.blueInvoiceIssu.hwys
请求参数
Header 参数
nsrsbh
string
接口调用方税号
access_token
string
可选
Body 参数application/json
fpkjxx_fptxx
object
可选
fpqqlsh
string
发票请求流水号
<= 50 字符
cezslx_dm
string
差额征税类型代码
<= 2 字符
jazslx_dm
string
减按征税类型代码
<= 2 字符
sgfplx_dm
string
收购发票类型代码
<= 2 字符
fpfxyj_dm
string
发 票风险预警代码
<= 2 字符
cktslx_dm
string
出口退税类型代码
<= 2 字符
nsrmc
string
开票方纳税人名称
<= 100 字符
nsrsbh
string
开票方纳税人识别号
<= 20 字符
swjg_dm
string
税务机关代码
<= 11 字符
kpxm
string
主要开票项目
<= 90 字符
kplx
string
开票类型
<= 2 字符
bmb_bbh
string
编码版本号
<= 20 字符
xhfmc
string
销售方名称
<= 100 字符
xhf_nsrsbh
string
销售方纳税人识别号
<= 20 字符
xhf_dzdh
string
销售方地址电话
<= 140 字符
xhf_yhzh
string
销售方银行帐户
<= 100 字符
xhf_dz
string
销售方地址
<= 140 字符
xhf_dh
string
销售方电话
<= 20 字符
xhf_yh
string
销售方开户行
<= 100 字符
xhf_zh
string
销售方银行帐号
<= 50 字符
ghfqylx
string
购买方企业类型
<= 2 字符
ghfmc
string
购买方名称
<= 100 字符
ghf_nsrsbh
string
购买方纳税人识别号
<= 20 字符
ghf_dzdh
string
购买方地址电话
<= 100 字符
ghf_yhzh
string
购买方银行账户
<= 100 字符
ghf_dz
string
购买方地址
<= 140 字符
ghf_dh
string
购买方电话
<= 20 字符
ghf_yh
string
购买方开户行
<= 100 字符
ghf_zh
string
购买方银行账号
<= 50 字符
ghf_email
string
购买方邮箱
<= 50 字符
ghf_sj
string
购买方手机
<= 20 字符
kpy
string
开票员
<= 20 字符
jbr
string
经办人
<= 16 字符
jbr_sj
string
经办人手机
<= 11 字符
jbr_sflx
string
经办人身份类型
<= 3 字符
jbr_sfzhm
string
经办人身份证号
<= 30 字符
jbr_gj
string
经办人国籍
<= 10 字符
sky
string
收款员
<= 16 字符
fhr
string
复核人
<= 16 字符
kprq
string
开票日期
<= 16 字符
fpzl_dm
string
发票种类代码
<= 2 字符
xsfzrr_bz
string
销售方自然人标志
<= 1 字符
gmfzrr_bz
string
购买方自然人标志
<= 1 字符
kphjje
string
开票合计金额
<= 16 字符
hjbhsje
string
合计不含税金额
<= 20 字符
hjse
string
合计税额
<= 20 字符
bz
string
备注
<= 230 字符
sslkjly
string
3%税率开具理由
<= 1 字符
hzqrdbh
string
红字确认单编号
<= 20 字符
hzqrduuid
string
红字确认单uuid
<= 32 字符
hpzzfp_bz
string
红票纸质发票标志
<= 1 字符
yfp_hm
string
原发票号码
<= 20 字符
yfp_dm
string
原发票代码
<= 12 字符
ykprq
string
原开票日期
<= 16 字符
yfpzl_dm
string
原发票种类代码
<= 2 字符
is_dae
string
是否开具大额发票
<= 1 字符
zpfp_dm
string
纸票发票种类代码
<= 20 字符
sfzsgmfyhzh
string
是否显示购方银行账号
<= 1 字符
sfzsxsfyhzh
string
是否显示销方银行账号
<= 1 字符
sfzsgmfdzdh
string
是否显示购买方地址电话
<= 1 字符
sfzsxsfdzdh
string
是否显示销售方地址电话
<= 1 字符
zrr_zjlxdm
string
自然人证件类型代码
<= 3 字符
zrr_zjhm
string
自然人证件号码
<= 30 字符
zrr_gjdm
string
自然人国籍代码
<= 10 字符
jf_email
string
交付邮箱
<= 30 字符
jf_phone
string
交付手机号
<= 30 字符
spbmjc_bz
string
商品编码简称标志
<= 1 字符
macdz
string
Mac 地址
<= 30 字符
byzd1
string
备用字段 1
<= 500 字符
byzd2
string
备用字段 2
<= 500 字符
byzd3
string
备用字段 3
<= 500 字符
byzd4
string
备用字段 4
<= 500 字符
byzd5
string
备用字段 5
<= 500 字符
jffs
string
jffs
zzfp_bz
string
zzfp_bz
qyjjpp
string
qyjjpp
fpkjxx_xmxxs
array [object {23}]
可选
byzd1
string
备用字段 1
<= 500 字符
byzd2
string
备用字段 2
<= 500 字符
byzd3
string
备用字段 3
<= 500 字符
byzd4
string
备用字段 4
<= 500 字符
byzd5
string
备用字段 5
<= 500 字符
xh
string
商品行序号
<= 3 字符
fphxz
string
发票行性质
<= 1 字符
xmmc
string
项目名称
<= 132 字符
xmjc
string
项目简称
<= 40 字符
xmdw
string
项目单位
<= 40 字符
ggxh
string
规格型号
<= 40 字符
xmsl
string
项目数量
<= 16 字符
hsbz
string
含税标志
<= 1 字符
xmdj
string
项目单价
<= 24 字符
spbm
string
商品编码
<= 19 字符
yhzcbs
string
优惠政策标识
<= 1 字符
lslbs
string
零税率标识
<= 1 字符
zzstsgl
string
增值税特殊管理
<= 50 字符
xmje
string
项目金额
<= 16 字符
sl
string
税率
<= 10 字符
se
string
税额
<= 16 字符
kce
string
扣除额
<= 16 字符
tdzsfs_dm
string
特定征税方式代码
<= 20 字符
zfxx_list
array [object {3}]
可选
xh
string
商品行序号
<= 3 字符
zfqd_dm
string
支付渠道
<= 3 字符
jydh
string
交易单号
<= 40 字符
cepzmxs
array [object {13}]
可选
bz
string
备注
<= 230 字符
xh
string
商品行序号
<= 3 字符
kce
string
扣除额
<= 16 字符
pzlx
string
凭 证类型
<= 1 字符
fpdm
string
发票代码
<= 12 字符
fphm
string
发票号码
<= 20 字符
zzfphm
string
纸质发票号码
<= 8 字符
pzhm
string
凭证号码
<= 32 字符
kjrq
string
开具日期
<= 16 字符
hjje
string
合计金额
<= 16 字符
bckcje
string
本次扣除金额
<= 16 字符
pzhjje
string
凭证合计金额
<= 16 字符
kjly
string
kjly
fjys_xxs
array [object {3}]
可选
fjysmc
string
附加要素名称
<= 100 字符
fjysz
string
附加要素值
<= 100 字符
sjlx
string
数据类型
<= 10 字符
hwys_ts_list
array [object {6}]
可选
xh
string
商品行序号
<= 3 字符
ysgjzl
string
运输工具种类
<= 30 字符
ysgjhp
string
运输工具号牌
<= 40 字符
qyd
string
起运地
<= 80 字符
ddd
string
到达地
<= 80 字符
yshwmc1
string
运输货物名称
<= 80 字符
示例
{
"fpkjxx_fptxx": {
"fpqqlsh": "string",
"cezslx_dm": "st",
"jazslx_dm": "st",
"sgfplx_dm": "st",
"fpfxyj_dm": "st",
"cktslx_dm": "st",
"nsrmc": "string",
"nsrsbh": "string",
"swjg_dm": "string",
"kpxm": "string",
"kplx": "st",
"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": "st",
"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": "str",
"jbr_sfzhm": "string",
"jbr_gj": "string",
"sky": "string",
"fhr": "string",
"kprq": "string",
"fpzl_dm": "st",
"xsfzrr_bz": "s",
"gmfzrr_bz": "s",
"kphjje": "string",
"hjbhsje": "string",
"hjse": "string",
"bz": "string",
"sslkjly": "s",
"hzqrdbh": "string",
"hzqrduuid": "string",
"hpzzfp_bz": "s",
"yfp_hm": "string",
"yfp_dm": "string",
"ykprq": "string",
"yfpzl_dm": "st",
"is_dae": "s",
"zpfp_dm": "string",
"sfzsgmfyhzh": "s",
"sfzsxsfyhzh": "s",
"sfzsgmfdzdh": "s",
"sfzsxsfdzdh": "s",
"zrr_zjlxdm": "str",
"zrr_zjhm": "string",
"zrr_gjdm": "string",
"jf_email": "string",
"jf_phone": "string",
"spbmjc_bz": "s",
"macdz": "string",
"byzd1": "string",
"byzd2": "string",
"byzd3": "string",
"byzd4": "string",
"byzd5": "string",
"jffs": "string",
"zzfp_bz": "string",
"qyjjpp": "string"
},
"fpkjxx_xmxxs": [
{
"byzd1": "string",
"byzd2": "string",
"byzd3": "string",
"byzd4": "string",
"byzd5": "string",
"xh": "str",
"fphxz": "s",
"xmmc": "string",
"xmjc": "string",
"xmdw": "string",
"ggxh": "string",
"xmsl": "string",
"hsbz": "s",
"xmdj": "string",
"spbm": "string",
"yhzcbs": "s",
"lslbs": "s",
"zzstsgl": "string",
"xmje": "string",
"sl": "string",
"se": "string",
"kce": "string",
"tdzsfs_dm": "string"
}
],
"zfxx_list": [
{
"xh": "str",
"zfqd_dm": "str",
"jydh": "string"
}
],
"cepzmxs": [
{
"bz": "string",
"xh": "str",
"kce": "string",
"pzlx": "s",
"fpdm": "string",
"fphm": "string",
"zzfphm": "string",
"pzhm": "string",
"kjrq": "string",
"hjje": "string",
"bckcje": "string",
"pzhjje": "string",
"kjly": "string"
}
],
"fjys_xxs": [
{
"fjysmc": "string",
"fjysz": "string",
"sjlx": "string"
}
],
"hwys_ts_list": [
{
"xh": "str",
"ysgjzl": "string",
"ysgjhp": "string",
"qyd": "string",
"ddd": "string",
"yshwmc1": "string"
}
]
}
示例代码
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://skynjweb.com:7443/hx/api/fp/h5.js.blueInvoiceIssu.hwys' \
--header 'nsrsbh;' \
--header 'access_token;' \
--header 'Content-Type: application/json' \
--data-raw '{
"fpkjxx_fptxx": {
"fpqqlsh": "string",
"cezslx_dm": "st",
"jazslx_dm": "st",
"sgfplx_dm": "st",
"fpfxyj_dm": "st",
"cktslx_dm": "st",
"nsrmc": "string",
"nsrsbh": "string",
"swjg_dm": "string",
"kpxm": "string",
"kplx": "st",
"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": "st",
"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": "str",
"jbr_sfzhm": "string",
"jbr_gj": "string",
"sky": "string",
"fhr": "string",
"kprq": "string",
"fpzl_dm": "st",
"xsfzrr_bz": "s",
"gmfzrr_bz": "s",
"kphjje": "string",
"hjbhsje": "string",
"hjse": "string",
"bz": "string",
"sslkjly": "s",
"hzqrdbh": "string",
"hzqrduuid": "string",
"hpzzfp_bz": "s",
"yfp_hm": "string",
"yfp_dm": "string",
"ykprq": "string",
"yfpzl_dm": "st",
"is_dae": "s",
"zpfp_dm": "string",
"sfzsgmfyhzh": "s",
"sfzsxsfyhzh": "s",
"sfzsgmfdzdh": "s",
"sfzsxsfdzdh": "s",
"zrr_zjlxdm": "str",
"zrr_zjhm": "string",
"zrr_gjdm": "string",
"jf_email": "string",
"jf_phone": "string",
"spbmjc_bz": "s",
"macdz": "string",
"byzd1": "string",
"byzd2": "string",
"byzd3": "string",
"byzd4": "string",
"byzd5": "string",
"jffs": "string",
"zzfp_bz": "string",
"qyjjpp": "string"
},
"fpkjxx_xmxxs": [
{
"byzd1": "string",
"byzd2": "string",
"byzd3": "string",
"byzd4": "string",
"byzd5": "string",
"xh": "str",
"fphxz": "s",
"xmmc": "string",
"xmjc": "string",
"xmdw": "string",
"ggxh": "string",
"xmsl": "string",
"hsbz": "s",
"xmdj": "string",
"spbm": "string",
"yhzcbs": "s",
"lslbs": "s",
"zzstsgl": "string",
"xmje": "string",
"sl": "string",
"se": "string",
"kce": "string",
"tdzsfs_dm": "string"
}
],
"zfxx_list": [
{
"xh": "str",
"zfqd_dm": "str",
"jydh": "string"
}
],
"cepzmxs": [
{
"bz": "string",
"xh": "str",
"kce": "string",
"pzlx": "s",
"fpdm": "string",
"fphm": "string",
"zzfphm": "string",
"pzhm": "string",
"kjrq": "string",
"hjje": "string",
"bckcje": "string",
"pzhjje": "string",
"kjly": "string"
}
],
"fjys_xxs": [
{
"fjysmc": "string",
"fjysz": "string",
"sjlx": "string"
}
],
"hwys_ts_list": [
{
"xh": "str",
"ysgjzl": "string",
"ysgjhp": "string",
"qyd": "string",
"ddd": "string",
"yshwmc1": "string"
}
]
}'
返回响应
🟢200成功
application/json
Body
code
string
业务错误代码
<= 15 字符
msg
string
业务错误描述
<= 200 字符
fp_hm
string
发票号码
<= 20 字符
kprq
string
开具日期
<= 19 字符
zzfp_hm
string
纸质发票号码
<= 8 字符
fp_dm
string
发票代码
<= 10 字符
jbr_gj
string
经办人国籍
<= 10 字符
xhf_nsrsbh
string
销售方纳税人识别号
<= 20 字符
xhf_mc
string
销售方名称
jshj
string
价税合计
<= 16 字符
bzxx
string
备注信息
hzfpxxqrdbh
string
红字发票信息确认单编号
<= 32 字符
示例
{
"code": "业务错误代码",
"msg": "业务错误描述",
"fp_hm": "发票号码",
"zzfp_hm": "纸质发票号码",
"fp_dm": "发票代码",
"jbr_gj": "经办人国籍",
"kprq": "开票日期",
"xhf_nsrsbh": "销售方纳税人识别号",
"xhf_mc": "销售方名称",
"jshj": "价税合计",
"bzxx": "备注信息",
"hzfpxxqrdbh": "红字发票信息确认单编号"
}
修改于 2025-06-06 06:03:45