蓝字发票开具

请求参数

Header 参数

Authorization

string

可选

示例值:

Body 参数application/json

fpqqlsh

string

发票请求流水号

必需

唯一值，如若重复，会开票失败

username

string

电票平台账号

必需

kplx

string

开票类型

必需

0 正数发票

fplxdm

string

发票类型代码

必需

发票类型代码(详见附件 4)

tdyslxDm

string

特定要素类型代码

可选

特殊票种(详见附件 3)

xhdwsbh

string

销方识别号

必需

xhdwmc

string

销方名称

必需

xhdwdzdh

string

销方地址电话

必需

xhdwyhzh

string

销方银行账户

必需

ghdwmc

string

购方名称

必需

ghdwsbh

string

购方税号

可选

ghdwdzdh

string

购方地址电话

可选

ghdwyhzh

string

购方银行账号

可选

zsfs

string

征收方式

可选

0：普通征税 2：差额征税全额开具 3：差额征税差额开具默认为 0

fyxm

array [object {14}]

费用项目

必需

fphxz

string

发票行性质

必需

0:正常行 1:折扣行 2:被折扣行

spmc

string

商品名称

必需

ggxh

string

规格型号

可选

dw

string

单位

可选

spsl

number

商品数量

可选

dj

number

单价

可选

je

number

金额

必需

sl

string

税率

必需

se

number

税额

必需

hsbz

string

含税标志

必需

0 不含税 1 含税

spbm

string

商品编码

必需

yhzcbs

string

优惠政策标识

可选

0 未使用，1 使用

lslbs

string

零税率标识

可选

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

zzstsgl

string

增值税特殊管理

必需

hjje

string

合计金额

必需

hjse

string

合计税额

必需

jshj

string

价税合计

必需

kce

string

扣除额

可选

kpr

string

开票人

可选

skr

string

收款人

可选

fhr

string

复核人

可选

gfkhdh

string

购方电话

可选

gfkhyx

string

购方邮箱

可选

slsm

string

税率说明可用值

可选

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

bz

string

备注

可选

gfzrrbs

string

购方自然人标识

可选

N：企业 Y：个人不传默认为 N

xfzrrbs

string

销方自然人标识

可选

可用值 N，Y（不传值为 N）

gfxxConfirm

string

确认购方信息是否存在

可选

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

spflxConfirm

string

是否开启自然人校验

可选

1：开启空：不开启/继续开票

sfzsgmfyhzh

string

是否展示购方银行账号

可选

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

sfzsxsfyhzh

string

是否展示销方银行账号

可选

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

zpFppzDm

string | null

纸票票种代码【数电纸票专用字段】

可选

fplxdm 为 85 或 86 时必填（详见附件 6）

zzfpdm

string

纸质发票代码【数电纸票专用字段】

必需

fplxdm 为 85 或 86 时必填，1.23 接口获取

zzfphm

string

纸质发票号码【数电纸票专用字段】

必需

fplxdm 为 85 或 86 时必填，1.23 接口获取

示例

{
    "fpqqlsh": "pdy202506141234",
    "username": "{{username}}",
    "kplx": "0",
    "fplxdm": "82",
    "tdyslxDm": "",
    "xhdwsbh": "{{nsrsbh}}",
    "xhdwmc": "北京民诺科技有限公司",
    "xhdwdzdh": "北京市昌平区xxxxxxxx  13xxxxxxx",
    "xhdwyhzh": "工商银行xxxxxxx 02002401092xxxxxx",
    "ghdwmc": "个人",

    "fyxm": [
        {
            "fphxz": "0",
            "spmc": "*软件*票单云财税管理系统",
            "ggxh": "V2",
            "dw": "年",
            "spsl": 1,
            "dj": 1,
            "je": 1,
            "sl": "0.01",
            "se": 0.01,
            "hsbz": "1",
            "spbm": "1060301020100000000"
        }
    ],
    "hjje": "0.99",
    "hjse": "0.01",
    "jshj": "1"
}

示例代码

Shell

JavaScript

Java

Swift

Go

PHP

Python

HTTP

C

C#

Objective-C

Ruby

OCaml

Dart

R

curl --location --request POST 'https://api.piaodanyun.com/test/tax/v2/qdjk/fullExteriorInvoke/blueTicket' \
--header 'Authorization: 6Mw6p7Rt7SUyM6G81WOVcJjl' \
--header 'Content-Type: application/json' \
--data-raw '{
    "fpqqlsh": "pdy202506141234",
    "username": "13581913199",
    "kplx": "0",
    "fplxdm": "82",
    "tdyslxDm": "",
    "xhdwsbh": "9111011457319202X9",
    "xhdwmc": "北京民诺科技有限公司",
    "xhdwdzdh": "北京市昌平区xxxxxxxx  13xxxxxxx",
    "xhdwyhzh": "工商银行xxxxxxx 02002401092xxxxxx",
    "ghdwmc": "个人",

    "fyxm": [
        {
            "fphxz": "0",
            "spmc": "*软件*票单云财税管理系统",
            "ggxh": "V2",
            "dw": "年",
            "spsl": 1,
            "dj": 1,
            "je": 1,
            "sl": "0.01",
            "se": 0.01,
            "hsbz": "1",
            "spbm": "1060301020100000000"
        }
    ],
    "hjje": "0.99",
    "hjse": "0.01",
    "jshj": "1"
}'

返回响应

🟢200成功

application/json

Body

code

integer

必需

data

object

必需

Fphm

string

发票号码

必需

GmfSsjswjgdm

null

必需

Gmfyx

null

可选

Kprq

string

必需

zzfpdm

string

必需

zzfphm

string

必需

示例

{
    "code": 0,
    "data": {
        "Fphm": "25112000000122447100",
        "GmfSsjswjgdm": null,
        "Gmfyx": null,
        "Kprq": "2025-06-14 17:49:37",
        "zzfpdm": "",
        "zzfphm": ""
    }
}

蓝字发票开具

发票开具#

请求参数

示例代码

返回响应

发票开具