票单云

蓝字发票开具

POST

/qdjk/fullExteriorInvoke/blueTicket

用于开具蓝字发票

请求参数

Header 参数

Authorization

string

必需

示例值:

Body 参数multipart/form-data

username

string

局端账号

必需

示例值:

fpqqlsh

string

必需

发票请求流水号，唯一值，自定义非重复字符串，40个字符以内

示例值:

111_111

fplxdm

string

必需

发票类型代码，82：增值税普通发票，81：增值税专用发票；51：铁路子电子客票，61：航空运输电子客票行程单

示例值:

tdyslxDm

string

可选

特定要素类型代码，“”空字符串，非特殊票种。其他特殊票种，单独咨询技术人员

kplx

string

必需

开票类型：0正数发票，1负数发票

示例值:

qdbz

string

可选

清单标志，开具纸质数电发票时，上命名系大于8行传1,代表是清单发票

xhdwsbh

string

销方识别号

必需

示例值:

xhdwmc

string

销方名称

必需

示例值:

北京民诺科技有限公司

xhdwdzdh

string

销方地址电话

必需

示例值:

北京市***

xhdwyhzh

string

销方银行账户

必需

示例值:

111***

ghdwsbh

string

购方税号

可选

ghdwmc

string

购方名称

必需

示例值:

上海市****科技有限公司

ghdwdzdh

string

购方地址电话

可选

ghdwyhzh

string

购方银行账号

可选

zsfs

string

可选

征收方式，0：普通征税1：减按计征2：差额征税全额开具3：差额征税差额开具默认为0

fyxm[0][fphxz]

string

必需

发票行性质，0:正常行1:折扣行2:被折扣行

示例值:

fyxm[0][spmc]

string

商品名称

必需

示例值:

*软件*票单云财税管理系统

fyxm[0][ggxh]

string

规格型号

可选

示例值:

fyxm[0][dw]

string

单位

可选

示例值:

年

fyxm[0][spsl]

number

商品数量

可选

示例值:

fyxm[0][dj]

number

可选

单价，对于有小数位的情况，建议精确到小数后4位，否则可能因金额误差过大造成参数校验失败

示例值:

fyxm[0][je]

number

金额

必需

示例值:

fyxm[0][sl]

string

税率

必需

示例值:

0.01

fyxm[0][se]

number

税额

必需

示例值:

0.01

fyxm[0][hsbz]

string

必需

含税标志：0不含税1含税

示例值:

fyxm[0][spbm]

string

商品编码

必需

示例值:

1060301020100000000

fyxm[0][yhzcbs]

string

可选

优惠政策标识：0未使用，1使用

fyxm[0][lslbs]

string

可选

零税率标识：0代表正常税率1出口免税和其他免税优惠政策（免税）2不征增值税（不征税）3普通零税率（0%）

fyxm[0][zzstsgl]

string

可选

增值税特殊管理（咨询技术人员）

hjje

string

合计金额

必需

示例值:

0.99

hjse

string

合计税额

必需

示例值:

0.01

jshj

string

加税合计

必需

示例值:

kce

number

扣除额

可选

kpr

string

开票人

可选

skr

string

收款人

可选

fhr

string

复核人

可选

gfkhdh

string

购方电话

可选

gfkhyx

string

购方邮箱

可选

slsm

string

可选

税率说明（小规模纳税人开具3税率使用）前期已开具发票，发生销售折让、中止或者退回等情形需要开具红字发票，或者开票有误需要重新开具传2，因为实际经营业务需要，放弃享受减按1%征收率征收增值税政策传3

string

可选

备注 255个字符以内

gfzrrbs

string

可选

购方自然人标识，N：企业Y：个人不传默认为N

xfzrrbs

string

可选

销方自然人标识，可用值N，Y（不传值为N）

gfxxConfirm

string

可选

确认购方信息是否存在，值为1是不确认。购方信息可能会报（当前未查询到购买方纳税人信息，请确认是否继续开具），默认是确认，意思是不管购方信息是否真实存在都进行开具

spflxConfirm

string

可选

是否开启自然人校验，1：开启，空：不开启/继续开票

sfzsgmfyhzh

string

可选

是否展示购方银行账号到备注里面y/Y展示，其他否

sfzsxsfyhzh

string

可选

是否展示销方银行账号到备注里面y/Y展示，其他否

示例代码

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

curl --location --request POST 'https://api.piaodanyun.com/test/tax/v2/qdjk/fullExteriorInvoke/blueTicket' \
--header 'Authorization: 6Mw6p7Rt7SUyM6G81WOVcJjl' \
--form 'username="13581913199"' \
--form 'fpqqlsh="111_111"' \
--form 'fplxdm="82"' \
--form 'tdyslxDm=""' \
--form 'kplx="0"' \
--form 'qdbz=""' \
--form 'xhdwsbh="9111011457319202X9"' \
--form 'xhdwmc="北京民诺科技有限公司"' \
--form 'xhdwdzdh="北京市***"' \
--form 'xhdwyhzh="111***"' \
--form 'ghdwsbh=""' \
--form 'ghdwmc="上海市****科技有限公司"' \
--form 'ghdwdzdh=""' \
--form 'ghdwyhzh=""' \
--form 'zsfs=""' \
--form 'fyxm[0][fphxz]="0"' \
--form 'fyxm[0][spmc]="*软件*票单云财税管理系统"' \
--form 'fyxm[0][ggxh]="V1"' \
--form 'fyxm[0][dw]="年"' \
--form 'fyxm[0][spsl]="1"' \
--form 'fyxm[0][dj]="1"' \
--form 'fyxm[0][je]="1"' \
--form 'fyxm[0][sl]="0.01"' \
--form 'fyxm[0][se]="0.01"' \
--form 'fyxm[0][hsbz]="1"' \
--form 'fyxm[0][spbm]="1060301020100000000"' \
--form 'fyxm[0][yhzcbs]=""' \
--form 'fyxm[0][lslbs]=""' \
--form 'fyxm[0][zzstsgl]=""' \
--form 'hjje="0.99"' \
--form 'hjse="0.01"' \
--form 'jshj="1"' \
--form 'kce=""' \
--form 'kpr=""' \
--form 'skr=""' \
--form 'fhr=""' \
--form 'gfkhdh=""' \
--form 'gfkhyx=""' \
--form 'slsm=""' \
--form 'bz=""' \
--form 'gfzrrbs=""' \
--form 'xfzrrbs=""' \
--form 'gfxxConfirm=""' \
--form 'spflxConfirm=""' \
--form 'sfzsgmfyhzh=""' \
--form 'sfzsxsfyhzh=""'

返回响应

🟢200成功

application/json

Body

code

integer

必需

msg

string

必需

data

object

必需

Fphm

string

必需

Kprq

string

必需

Gmfyx

null

必需

GmfSsjswjgdm

null

必需

total

integer

必需

示例

{
    "code": 200,
    "msg": "成功",
    "data": {
        "Fphm": "22111111111111111180",
        "Kprq": "2022-11-28 15:28:11",
        "Gmfyx": null,
        "GmfSsjswjgdm": null
    },
    "total": 0
}

修改于 2025-06-14 08:40:09

获取人脸二维码

发票详细查询

蓝字发票开具

用于开具蓝字发票#

请求参数

示例代码

返回响应

用于开具蓝字发票