发票开具申请 - 平台Api对接

业务系统通过本接口可实现开具全面数字化电子发票的开具（增值税专用发票，增值税普通发票）。
特定业务已支持：“二手车发票”，"建筑服务发票"，"不动产经营租赁服务"，"不动产销售服务发票"，"拖拉机和联合收割机发票"，"旅客运输服务发票"，"机动车"，"货物运输服务发票"，"代收车船税"，"成品油"，"自产农产品销售发票"，"农产品收购发票"。

请求参数

Body 参数application/json

accountId

string

多账号下的账号唯一标识

可选

fphead

object

发票主体信息

必需

ly_ddbh

string

来源订单编号

必需

唯一不可重复

默认值:

fplxdm

integer

发票类型代码

必需

1=专票，0=普票

默认值:

xsf_nsrsbh

string

销方税号

必需

默认值:

xsf_nsrmc

string

销方名称

必需

默认值:

xsf_dz

string

销售方地址

必需

默认值:

xsf_dh

string

销售方电话

必需

默认值:

xsf_yhmc

string

销售方开户银行

必需

默认值:

xsf_yhzh

string

销售方银行账号

必需

默认值:

gmf_lx

integer

购方类型

必需

0,企业 1,个人

默认值:

gmf_nsrsbh

string

购方税号

可选

默认值:

gmf_nsrmc

string

购方名称

必需

默认值:

gmf_dz

string

购买方地址

可选

默认值:

gmf_dh

string

购买方电话

可选

默认值:

gmf_yhmc

string

购买方开户银行

可选

默认值:

gmf_yhzh

string

购买方银行账号

可选

默认值:

hjje

string

合计金额

必需

默认值:

hjse

string

合计税额

必需

默认值:

jshj

string

价税合计

必需

默认值:

string

备注

可选

默认值:

fhr

string

复核人

可选

默认值:

skr

string

收款人

必需

默认值:

kpr

string

开票人

可选

hsbz

integer

含税标识

必需

1：是不含税价, 不传值默认为含税价 2：是含税价

默认值:

xgm_xsyhzc

integer

小规模享受优惠政策

必需

1:是，0：否

默认值:

gfxx_confirm

string

购方信息确认,直接传0

可选

1:是

cezs

integer

差额开票代码

必需

1:是，0：否

默认值:

wjgs

string

文件格式

必需

版式文件格式（OFD,PDF,XML)多个以,隔开

默认值:

tdyslxdm

string

特定要素类型代码

可选

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

默认值:

kjje_confirm

string

大金额信息确认

可选

"0": 忽略大金额提示，直接开具“”：空或不传，则会提示开具金额较大；纳税人首次开票额度大于发票额度的50%，且开票金额大于50万，会触发大额发票提醒

sfzsgmfyhzh

string

是否展示购买方银行账号 1 展示 0或空不展示

可选

sfzsxsfyhzh

string

是否展示销售方银行账号 1 展示 0或空不展示

可选

sfzsgmfdzdh

string

是否展示购买方地址电话 1 展示 0或空不展示

可选

sfzsxsfdzdh

string

是否展示销售方地址电话 1 展示 0或空不展示

可选

dfgtgmbq

string

多方共同购买标识

可选

Y/N 不填默认N，不动产销售信息时使用

gtgmxxes

array [object {3}]

多方共同购买方信息

可选

不动产销售信息选中多方购买标识此项必填

fjxxList

array [object {2}]

附加要素列表

可选

jbrxm

string

经办人姓名

可选

jbrzjhm

string

经办人证件号码

可选

jbrgjdm

enum<string>

经办人国籍代码

可选

枚举值:

004008010012016020024028031032036040044048050051052056060064068070072074076084086090092096100104108112116120124132136140144148152156158162166170174175178180184188191192196203204208212214218222226231232233234238239242246250254258260262266268270275276288292296300304308312316320324328332334336340344348352356360364368372376380384388392398400404408410414417418422426428430434438440442446450454458462466470474478480484492496498499500504508512516520524528530533540548554558562566570574578580581583584585586591598600604608612616620624626630634638642643646654659660662666670674678682686688690694702703704705706710716724728732736740744748752756760762764768772776780784788792795796798800804807818826831832833834840850854858860862876882887891894A00

jbrzrrnsrsbh

string

经办人纳税人识别号

可选

jbrzjzldm

string

经办人证件种类代码

可选

见多方共同购买方信息中证件类型

zfxxes

array [object {2}]

可选

fpbody

array [object {15}]

开票明细

必需

fphxz

integer

发票行性质

必需

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

默认值:

spbm

string

税收商品编码

必需

默认值:

spmc

string

税收商品名称

必需

默认值:

xmmc

string

商品名称

必需

默认值:

ggxh

string

规格型号

必需

默认值:

jldw

string

计量单位

必需

默认值:

string

数量

必需

默认值:

string

单价

必需

默认值:

string

金额

必需

默认值:

slv

string

税率

必需

默认值:

string

税额

必需

默认值:

slbz

integer

税率标识

可选

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

默认值:

tdzsfsdm

string

特定征税方式代码

可选

"01"："不征税“,"02"："零税率","03"："差额征税","04"："免税","05":"简易征税","06"："减按征税"

默认值:

ssyhzclx

string

税收优惠政策类型

可选

"01"："简易征收","02"： "稀土产品“,"03": "免税","04": "不征税",“05": "先征后退","06": "100%先征后退","07": "50%先征后退",”08“:"按3%简易征收","09":"按5%简易征收","10": "按5%简易征收减按1.5%计征","11"："即征即退30%","12": "即征即退50%","13": "即征即退70%","14": "即征即退100%","15": "超税负3%即征即退","16": "超税负8%即征即退","17": "超税负12%即征即退","18": "超税负6%即征即退"

默认值:

jzjtlxDm

string

即征即退类型代码

可选

01软件产品发票,02资源综合利用产品发票,03管道运输服务发票,04有形动产融资租赁服务,05有形动产融资性售后回租服务发票,06新型墙体材料发票,07风力发电产品发票,08光伏发电产品发票,09动漫软件产品发票,10飞机维修劳务发票,11黄金发票,12铂金发票

默认值:

hwysxx

array [object {6}]

货物运输明细

可选

string

必需

默认值:

ysgjzl

string

运输工具种类

必需

铁路运输、公路运输、水路运输、航空运输、管道运输、其他运输工具

默认值:

ysgjhp

string

运输工具号牌

必需

默认值:

qyd

string

起始地

必需

默认值:

ddd

string

到达地

必需

默认值:

yshwmc

string

运输货物名称

必需

默认值:

bdczlxx

array [object {8}]

不动产租赁明细

可选

fwcqzshm

string

房屋产权证书/不动产权证号码

必需

默认值:

bdcdz

string

不动产地址

必需

默认值:

bdcxxdz

string

不动产详细地址

必需

zlqq

string

租赁期起(yyyy-MM-dd）

必需

默认值:

zlqz

string

租赁期止(yyyy-MM-dd)

必需

默认值:

cph

string

车牌号

可选

商品编码是3040502020200000000时传入车牌号会在备注中显示其他税编无效

默认值:

kdsbz

string

跨地市标志(Y/N)

必需

默认值:

mjdw

string

平方米,亩,m²,平方千米,公顷,hm²,km²

必需

默认值:

jdc

object

机动车销售信息

可选

xxmc

string

项目名称

必需

默认值:

spmc

string

商品名称

必需

默认值:

spjc

string

商品简称

必需

默认值:

ssflbm

string

税收分类编码

必需

默认值:

string

不含税价（小写）

必需

默认值:

string

增值税税率/征税率

必需

默认值:

string

增值税税额

必需

默认值:

jshjXx

string

价税合计（小写）

必需

默认值:

jshjDx

string

价税合计（大写）

必需

默认值:

cllxDm

string

车辆类型代码

必需

默认值:

cpxh

string

厂牌型号

必需

默认值:

string

产地

必需

默认值:

hgzh

string

合格证号

必需

默认值:

jkzmsh

string

进口证明书号

必需

默认值:

sjdh

string

商险单号

必需

默认值:

fdjhm

string

发动机号码

必需

默认值:

clsbdh

string

车辆识别代码/车架号码

必需

默认值:

cldw

string

吨位

必需

默认值:

xcrs

string

限乘人数

必需

默认值:

wspzhm

string

完税凭证号码

必需

默认值:

scqymc

string

生产企业名称

必需

默认值:

swjgmc

string

主管税务机关名称

必需

默认值:

swjgdm

string

主管税务机关代码

必需

分组

默认值:

tdzsfsdm

string

特定征收方式代码

必需

默认值:

zzstsgldm

string

增值税特殊管理代码

必需

默认值:

jdctzclsbdhuuid

string

机动车车辆识别号uuid

必需

默认值:

ccsxx

object

代收车船税信息

可选

bxdh

string

保险单号

必需

默认值:

chhcbdjh

string

车船号船舶登记号

必需

默认值:

skssq

string

税款所属期

必需

默认值:

dsccsje

string

代收车船税金额

必需

默认值:

znjje

string

滞纳金金额

必需

默认值:

hjje

string

合计金额

必需

默认值:

cjh

string

车架号

必需

默认值:

lkysfw

array [object {8}]

旅客运输服务信息

可选

cxr

string

出行人

必需

默认值:

cxrzjlx

string

出行人证件类型

必需

默认值:

sfzjhm

string

出行人证件号码

必需

默认值:

cxrq

string

出行日期

必需

默认值:

cfd

string

出发地

必需

默认值:

ddd

string

到达地

必需

默认值:

jtgjlx

string

交通工具类型

必需

"1":飞机; "2":火车; "3":长途汽车; "4":公共交通; "5":出租车; "6":汽车; "7":船舶; "9":其他

默认值:

string

等级

必需

若交通工具为火车、飞机、船舶，则该要素为必填；等级类型: 1、交通工具-飞机:经济舱、头等舱、公务舱 2、交通工具-船舶:一等舱、二等舱、三等舱) 3、交通工具-火车:一等座、二等座、软席(软座、软卧)、硬席(硬座、硬卧))

默认值:

tlj

object

拖拉机和联合收割机信息

可选

sfyytljdj

string

是否用于联合机登记

必需

Y是,N否，默认Y是，若N时发动机号码、底盘号/机架号不传

默认值:

fdjbh

string

发动机号码

必需

默认值:

dphgzbh

string

底盘合格证编号

必需

默认值:

bdcxs

array [object {9}]

不动产经营销售服务

可选

fwcqzshm

string

房屋产权证书/不动产权证号码

必需

bdcdz

string

不动产地址

必需

bdcxxdz

string

不动产详细地址

必需

wqhtbabm

string

不动产单元代码/网签合同备案编码

必需

tdzzsxmbh

string

土地增值税项目编号

必需

hdjsjg

string

核定计税价格

必需

sjcjhsje

string

实际成交含税金额

必需

kdsbz

string

跨地市标志

必需

(Y/N)

mjdw

string

面积单位

必需

平方米,亩,m²,平方千米,公顷,hm²,km²

jzfw

object

建筑服务信息

可选

jzfwfs

string

建筑服务发生地

必需

默认值:

fsdxxdz

string

发生地详细地址

必需

默认值:

jzxmmc

string

建筑项目名称

必需

默认值:

kdsbz

string

跨地市标志(只能为Y/N)

必需

默认值:

tdzzsxmbh

string

土地增值税项目编号

必需

默认值:

wcjyhdssglzmbh

string

跨区域涉税事项报验管理编号,kdsbz是Y时该字段必填

必需

默认值:

esc

object

二手车信息

可选

sdfphm

string

数电发票号码

必需

默认值:

zzfpdm

string

发票代码

必需

默认值:

zzfphm

string

发票号码

必需

默认值:

escxsfzrrbs

string

卖方自然人标识

必需

默认值:

escxsfdz

string

卖方地址

必需

默认值:

escxsflxdh

string

卖方电话

必需

默认值:

escxsfmc

string

卖方名称

必需

默认值:

escxsfnsrsbh

string

卖方税号

必需

默认值:

escyqrhyxz

string

二手车企业性质

必需

07-二手车市场 08-二手车经销企业 09-二手车拍卖企业

默认值:

escfwList

array [object {5}]

二手车服务信息

必需

cepz

array [object {9}]

差额明细列表

可选

fpdm

string

发票代码

必需

默认值:

zzfphm

string

纸质发票号码

必需

默认值:

fphm

string

数电票号码

必需

默认值:

pzlx

string

凭证类型(默认 01数电票)

必需

01数电票,02增值税专用发票,03增值税普通发票,04营业税发票,05财政票据,06法院裁决书,07契税完税凭证,08其他发票类,09其他扣除凭证

默认值:

pzhm

string

凭证号码

必需

默认值:

kjrq

string

开具日期(格式yyyy-MM-dd)

必需

默认值:

string

备注

可选

默认值:

bckcje

string

本次扣除金额

必需

默认值:

pzhjje

string

凭证合计金额

必需

默认值:

示例

{
    "accountId": "string",
    "fphead": {
        "ly_ddbh": "",
        "fplxdm": "",
        "xsf_nsrsbh": "",
        "xsf_nsrmc": "",
        "xsf_dz": "",
        "xsf_dh": "",
        "xsf_yhmc": "",
        "xsf_yhzh": "",
        "gmf_lx": "",
        "gmf_nsrsbh": "",
        "gmf_nsrmc": "",
        "gmf_dz": "",
        "gmf_dh": "",
        "gmf_yhmc": "",
        "gmf_yhzh": "",
        "hjje": "",
        "hjse": "",
        "jshj": "",
        "bz": "",
        "fhr": "",
        "skr": "",
        "kpr": "string",
        "hsbz": "",
        "xgm_xsyhzc": "",
        "gfxx_confirm": "string",
        "cezs": "",
        "wjgs": "",
        "tdyslxdm": "",
        "kjje_confirm": "string",
        "sfzsgmfyhzh": "string",
        "sfzsxsfyhzh": "string",
        "sfzsgmfdzdh": "string",
        "sfzsxsfdzdh": "string",
        "dfgtgmbq": "string",
        "gtgmxxes": [
            {
                "gtgmf": "string",
                "zjlx": "string",
                "zjhm": "string"
            }
        ],
        "fjxxList": [
            {
                "fjxxmc": "",
                "fjxxnr": ""
            }
        ],
        "jbrxm": "string",
        "jbrzjhm": "string",
        "jbrgjdm": "004",
        "jbrzrrnsrsbh": "string",
        "jbrzjzldm": "string",
        "zfxxes": [
            {
                "zfqdDm": "001",
                "jydh": "string"
            }
        ]
    },
    "fpbody": [
        {
            "fphxz": "",
            "spbm": "",
            "spmc": "",
            "xmmc": "",
            "ggxh": "",
            "jldw": "",
            "sl": "",
            "dj": "",
            "je": "",
            "slv": "",
            "se": "",
            "slbz": "",
            "tdzsfsdm": "",
            "ssyhzclx": "",
            "jzjtlxDm": ""
        }
    ],
    "hwysxx": [
        {
            "xh": "",
            "ysgjzl": "",
            "ysgjhp": "",
            "qyd": "",
            "ddd": "",
            "yshwmc": ""
        }
    ],
    "bdczlxx": [
        {
            "fwcqzshm": "",
            "bdcdz": "",
            "bdcxxdz": "string",
            "zlqq": "",
            "zlqz": "",
            "cph": "",
            "kdsbz": "",
            "mjdw": ""
        }
    ],
    "jdc": {
        "xxmc": "",
        "spmc": "",
        "spjc": "",
        "ssflbm": "",
        "je": "",
        "sv": "",
        "se": "",
        "jshjXx": "",
        "jshjDx": "",
        "cllxDm": "",
        "cpxh": "",
        "cd": "",
        "hgzh": "",
        "jkzmsh": "",
        "sjdh": "",
        "fdjhm": "",
        "clsbdh": "",
        "cldw": "",
        "xcrs": "",
        "wspzhm": "",
        "scqymc": "",
        "swjgmc": "",
        "swjgdm": "",
        "tdzsfsdm": "",
        "zzstsgldm": "",
        "jdctzclsbdhuuid": ""
    },
    "ccsxx": {
        "bxdh": "",
        "chhcbdjh": "",
        "skssq": "",
        "dsccsje": "",
        "znjje": "",
        "hjje": "",
        "cjh": ""
    },
    "lkysfw": [
        {
            "cxr": "",
            "cxrzjlx": "",
            "sfzjhm": "",
            "cxrq": "",
            "cfd": "",
            "ddd": "",
            "jtgjlx": "",
            "dj": ""
        }
    ],
    "tlj": {
        "sfyytljdj": "",
        "fdjbh": "",
        "dphgzbh": ""
    },
    "bdcxs": [
        {
            "fwcqzshm": "string",
            "bdcdz": "string",
            "bdcxxdz": "string",
            "wqhtbabm": "string",
            "tdzzsxmbh": "string",
            "hdjsjg": "string",
            "sjcjhsje": "string",
            "kdsbz": "string",
            "mjdw": "string"
        }
    ],
    "jzfw": {
        "jzfwfs": "",
        "fsdxxdz": "",
        "jzxmmc": "",
        "kdsbz": "",
        "tdzzsxmbh": "",
        "wcjyhdssglzmbh": ""
    },
    "esc": {
        "sdfphm": "",
        "zzfpdm": "",
        "zzfphm": "",
        "escxsfzrrbs": "",
        "escxsfdz": "",
        "escxsflxdh": "",
        "escxsfmc": "",
        "escxsfnsrsbh": "",
        "escyqrhyxz": "",
        "escfwList": [
            {
                "clsbdh": "",
                "cphm": "",
                "cpxh": "",
                "djzh": "",
                "zrdclglsmc": ""
            }
        ]
    },
    "cepz": [
        {
            "fpdm": "",
            "zzfphm": "",
            "fphm": "",
            "pzlx": "",
            "pzhm": "",
            "kjrq": "",
            "bz": "",
            "bckcje": "",
            "pzhjje": ""
        }
    ]
}

示例代码

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

curl --location --request POST '/InvoiceKP/fpkpsq/1.0' \
--header 'Content-Type: application/json' \
--data-raw '{
    "accountId": "string",
    "fphead": {
        "ly_ddbh": "",
        "fplxdm": "",
        "xsf_nsrsbh": "",
        "xsf_nsrmc": "",
        "xsf_dz": "",
        "xsf_dh": "",
        "xsf_yhmc": "",
        "xsf_yhzh": "",
        "gmf_lx": "",
        "gmf_nsrsbh": "",
        "gmf_nsrmc": "",
        "gmf_dz": "",
        "gmf_dh": "",
        "gmf_yhmc": "",
        "gmf_yhzh": "",
        "hjje": "",
        "hjse": "",
        "jshj": "",
        "bz": "",
        "fhr": "",
        "skr": "",
        "kpr": "string",
        "hsbz": "",
        "xgm_xsyhzc": "",
        "gfxx_confirm": "string",
        "cezs": "",
        "wjgs": "",
        "tdyslxdm": "",
        "kjje_confirm": "string",
        "sfzsgmfyhzh": "string",
        "sfzsxsfyhzh": "string",
        "sfzsgmfdzdh": "string",
        "sfzsxsfdzdh": "string",
        "dfgtgmbq": "string",
        "gtgmxxes": [
            {
                "gtgmf": "string",
                "zjlx": "string",
                "zjhm": "string"
            }
        ],
        "fjxxList": [
            {
                "fjxxmc": "",
                "fjxxnr": ""
            }
        ],
        "jbrxm": "string",
        "jbrzjhm": "string",
        "jbrgjdm": "004",
        "jbrzrrnsrsbh": "string",
        "jbrzjzldm": "string",
        "zfxxes": [
            {
                "zfqdDm": "001",
                "jydh": "string"
            }
        ]
    },
    "fpbody": [
        {
            "fphxz": "",
            "spbm": "",
            "spmc": "",
            "xmmc": "",
            "ggxh": "",
            "jldw": "",
            "sl": "",
            "dj": "",
            "je": "",
            "slv": "",
            "se": "",
            "slbz": "",
            "tdzsfsdm": "",
            "ssyhzclx": "",
            "jzjtlxDm": ""
        }
    ],
    "hwysxx": [
        {
            "xh": "",
            "ysgjzl": "",
            "ysgjhp": "",
            "qyd": "",
            "ddd": "",
            "yshwmc": ""
        }
    ],
    "bdczlxx": [
        {
            "fwcqzshm": "",
            "bdcdz": "",
            "bdcxxdz": "string",
            "zlqq": "",
            "zlqz": "",
            "cph": "",
            "kdsbz": "",
            "mjdw": ""
        }
    ],
    "jdc": {
        "xxmc": "",
        "spmc": "",
        "spjc": "",
        "ssflbm": "",
        "je": "",
        "sv": "",
        "se": "",
        "jshjXx": "",
        "jshjDx": "",
        "cllxDm": "",
        "cpxh": "",
        "cd": "",
        "hgzh": "",
        "jkzmsh": "",
        "sjdh": "",
        "fdjhm": "",
        "clsbdh": "",
        "cldw": "",
        "xcrs": "",
        "wspzhm": "",
        "scqymc": "",
        "swjgmc": "",
        "swjgdm": "",
        "tdzsfsdm": "",
        "zzstsgldm": "",
        "jdctzclsbdhuuid": ""
    },
    "ccsxx": {
        "bxdh": "",
        "chhcbdjh": "",
        "skssq": "",
        "dsccsje": "",
        "znjje": "",
        "hjje": "",
        "cjh": ""
    },
    "lkysfw": [
        {
            "cxr": "",
            "cxrzjlx": "",
            "sfzjhm": "",
            "cxrq": "",
            "cfd": "",
            "ddd": "",
            "jtgjlx": "",
            "dj": ""
        }
    ],
    "tlj": {
        "sfyytljdj": "",
        "fdjbh": "",
        "dphgzbh": ""
    },
    "bdcxs": [
        {
            "fwcqzshm": "string",
            "bdcdz": "string",
            "bdcxxdz": "string",
            "wqhtbabm": "string",
            "tdzzsxmbh": "string",
            "hdjsjg": "string",
            "sjcjhsje": "string",
            "kdsbz": "string",
            "mjdw": "string"
        }
    ],
    "jzfw": {
        "jzfwfs": "",
        "fsdxxdz": "",
        "jzxmmc": "",
        "kdsbz": "",
        "tdzzsxmbh": "",
        "wcjyhdssglzmbh": ""
    },
    "esc": {
        "sdfphm": "",
        "zzfpdm": "",
        "zzfphm": "",
        "escxsfzrrbs": "",
        "escxsfdz": "",
        "escxsflxdh": "",
        "escxsfmc": "",
        "escxsfnsrsbh": "",
        "escyqrhyxz": "",
        "escfwList": [
            {
                "clsbdh": "",
                "cphm": "",
                "cpxh": "",
                "djzh": "",
                "zrdclglsmc": ""
            }
        ]
    },
    "cepz": [
        {
            "fpdm": "",
            "zzfphm": "",
            "fphm": "",
            "pzlx": "",
            "pzhm": "",
            "kjrq": "",
            "bz": "",
            "bckcje": "",
            "pzhjje": ""
        }
    ]
}'

返回响应

🟢200成功

application/json

Body

code

integer

业务代码

必需

0:成功，非0:失败

message

string

业务消息

必需

默认值:

requestID

string

业务流水号

必需

默认值:

timestamp

integer

业务提交时间戳

必需

token

string

登陆Token

必需

只有登陆接口有返回数据

默认值:

codeType

integer

业务返回编码格式

必需

data数据内容编码格式，0：明文，2：AES，3：Base64

iszip

integer

业务返回数据压缩标记

必需

data数据是否压缩，1：zip压缩

data

object

业务返回数据

必需

taskId

string

业务ID

必需

用于发票结果获取接口调用

默认值:

示例

{
    "code": 0,
    "message": "",
    "requestID": "",
    "timestamp": 0,
    "token": "",
    "codeType": 0,
    "iszip": 0,
    "data": {
        "taskId": ""
    }
}