单据上传

请求参数

Header 参数

actionCode

string

可选

示例值:

XXSCDJ

taxnum

string

税号

可选

interfaceCode

string

授权码

可选

extensionNo

string

分机号

可选

isEncryption

string

是否加密

必需

Body 参数application/json

fpqqlsh

string

发票请求流水号

必需

防止重复开票，每张发票保证唯一性。红票，该请求流水号需要跟红字确认单的请求流水号一致。

ddh

string

订单号

必需

对应单据

fppz

enum<string>

发票票种

必需

枚举值:

0102010022

lzfpbz

enum<string>

蓝字发票标志

必需

枚举值:

tdywlx

enum<string>

特定业务类型

可选

枚举值:

010304050609

xsfmc

string

销货方名称

必需

xsfnsrsbh

string

销货方税号

必需

xsfdz

string

销货方地址

必需

xsfdh

string

销货方电话

必需

xsfkhh

string

销货方银行名称

必需

xsfzh

string

销货方银行账户

必需

gmfzrrbz

enum<string>

购买方自然人标志

必需

枚举值:

gmfmc

string

购货方名称

必需

gmfnsrsbh

string

购货方税号

可选

专票必传

gmfdz

string

购货方地址

可选

gmfdh

string

购货方电话

可选

gmfkhh

string

购货方银行名称

可选

gmfzh

string

购货方银行账户

可选

hsbz

enum<string>

含税标志

必需

枚举值:

hjje

string

合计金额（不含税）

必需

红冲，值为负数

hjse

string

合计税额

必需

红冲，值为负数

jshj

string

价税合计

必需

红冲，值为负数

kpr

string

开票人

必需

skr

string

收款人

可选

fhr

string

复核人

可选

yhid

string

用户ID

可选

bmid

string

部门ID

可选

dylzfphm

string

对应蓝字发票号码

可选

红冲发票必传

dylzskfpdm

string

对应蓝字税控发票代码

可选

发票票种fppz为010、022时，红冲发票必传

dylzskfphm

string

对应蓝字税控发票号码

可选

发票票种fppz为010、022时，红冲发票必传

hzqrxxdbh

string

红字确认信息单编号

可选

红冲发票必传

hzqrduuid

string

红字确认单 uuid

可选

红冲发票必传

jfsj

string

交付手机

可选

jfyx

string

交付邮箱

可选

cssj

string

抄送手机

可选

多个以 , 隔开

csyx

string

抄送邮箱

可选

多个以 , 隔开

string

备注

可选

xsxfyh

enum<string>

备注是否显示销方开户行及账户

可选

枚举值:

xsgfyh

enum<string>

备注是否显示购方开户行及账户

可选

枚举值:

xsskfh

enum<string>

备注是否显示收款人和复核人

可选

枚举值:

xsxfdz

enum<string>

备注是否显示销方地址及电话

可选

枚举值:

xsgfdz

enum<string>

备注是否显示购方地址及电话

可选

枚举值:

hddz

string

回调地址

可选

如果需要回调，回调地址可以在这里填，也可以在前置平台配置。需要先开启是否需要回调。

fpmxList

array [object {16}]

商品明细

必需

mxxh

string

明细序号

必需

蓝票，该字段从1开始，并按从小到大进行排列，如1、2、3、4、5。
红票，明细序号跟红字确认单明细序号一致

xmmc

string

项目名称

必需

sphfwssflhbbm

string

商品和服务税收分类合并编码

必需

spfwjc

string

商品服务简称

可选

fphxz

enum<string>

发票行性质

必需

枚举值:

012

ggxh

string

规格型号

可选

string

单位

可选

string

数量

可选

保留13位小数，红冲填负数

string

不含税单价

可选

保留13位小数

hsdj

string

含税单价

可选

保留13位小数

hsbz

enum<string>

含税标志

必需

枚举值:

string

不含税金额

必需

红冲，值为负数

slv

string

税率

必需

如6%应填0.06

string

税额

必需

红冲，值为负数

hsje

string

价税合计

必需

红冲，值为负数

yhzcbs

enum<string>

优惠政策标识

可选

枚举值:

010203040506070809101112131415161718

bdcxsList

array [object {9}]

不动产销售

必需

bdcdm

string

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

可选

bdcdz

string

不动产地址

必需

省市区县（需与行政区划名称一致）如：xx省xx市xx区

bdcxxdz

string

不动产详细地址

必需

详细地址（不动产地址+详细地址总长度最大120字符，且必须包含街、路、村、乡、镇、道关键词）如：xx路

kdsbz

enum<string>

跨地市标志

必需

枚举值:

tdzzssmbh

string

土地增值税编号

可选

hdjsjg

string

核定计税价格

可选

sjcjhsje

string

实际成交含税金额

可选

当核定计税价格有值时必填

bdcqzh

string

产权证书/不动产权证号

可选

mjdw

string

面积单位

必需

必须是平方米、亩、㎡、平方千米、公顷、h㎡、k㎡等

dfgtgmbz

enum<string>

多方购买共同标志

可选

枚举值:

gtgmfList

array [object {3}]

共同购买方

可选

gtgmf

string

共同购买方

可选

zjlx

enum<string>

证件类型

可选

枚举值:

100101102103199200201202203204205206207208209210211212213214215216217218219220221222223224225226227228229230231232233234235236237238239240241291299

zjhm

string

证件号码

可选

bdczlList

array [object {8}]

不动产租赁

必需

mxxh

string

明细序号

必需

跟发票明细序号对应

bdcdz

string

不动产地址

必需

省市区县（需与行政区划名称一致）如：xx省xx市xx区

bdcxxdz

string

不动产详细地址

必需

详细地址（不动产地址+详细地址总长度最大120字符，且必须包含街、路、村、乡、镇、道关键词）如：xx路

zlqqs

string

租赁期起始

必需

非停车场数电票：yyyy-MM-dd 停车场数电票：yyyy-MM-dd HH:mm

zlqzz

string

租赁期终止

必需

非停车场数电票：yyyy-MM-dd 停车场数电票：yyyy-MM-dd HH:mm

bdcqzh

string

产权证书/不动产权证号

可选

mjdw

string

面积单位

必需

必须是平方米、亩、㎡、平方千米、公顷、h㎡、k㎡等

kdsbz

enum<string>

跨地市标志

必需

枚举值:

cph

string

车牌号

可选

最多三个，逗号隔开，如：A001,A002,A003

zfxxList

array [object {2}]

支付信息

可选

zfqd

enum<string>

支付渠道

可选

枚举值:

001002003004005006007008009010011012013099

jydh

string

交易单号

可选

jzfw

object

建筑服务

必需

jzfwmc

string

建筑服务名称

必需

tdzzsxmbh

string

土地增值税项目编号

可选

jzfwfsd

string

建筑服务发生地

必需

建筑服务发生地（传对应省市区中文名称--需与行政区划名称一致）。如：广东省广州市天河区

jzfwfsdxxdz

string

详细地址

可选

详细地址（建筑服务发生地+详细地址总长度最大120字符）

kdsbz

enum<string>

跨地（市）标志

必需

枚举值:

kqyssm

string

跨区域涉税事项报验管理编号

可选

跨地（市）标志为Y时，此字段必填，填写时请务必注意格式，中间空格必须保留。示例：XXX税跨报〔XXXX〕 123 号

fjmbmc

string

附加模板名称

可选

需要先在电子税局平台维护好模版

fjysList

array [object {3}]

附加要素

可选

fjysmc

string

附加要素名称

必需

需要与电子税局中的模版中的附加要素信息名称一致

fjyslx

enum<string>

附加要素类型

必需

枚举值:

stringdatenumber

fjysxx

string

附加要素信息

必需

示例

{
    "fpqqlsh": "20250207001",
    "ddh": "20250207001",
    "fppz": "02",
    "lzfpbz": "1",
    "tdywlx": "06",
    "xsfmc": "企业名称",
    "xsfnsrsbh": "企业税号",
    "xsfdz": "",
    "xsfdh": "",
    "xsfkhh": "",
    "xsfzh": "",
    "gmfzrrbz": "N",
    "gmfmc": "企业名称",
    "hsbz": "1",
    "hjje": 0.92,
    "hjse": 0.08,
    "jshj": 1,
    "kpr": "test",
    "fpmxList": [
        {
            "mxxh": "1",
            "xmmc": "车辆停放服务",
            "sphfwssflhbbm": "3040502020200000000",
            "fphxz": "0",
            "sl": 1,
            "hsdj": 1,
            "hsbz": "1",
            "je": 0.92,
            "slv": 0.09,
            "se": 0.08,
            "hsje": 1
        }
    ],
    "bdczlList": [
        {
            "mxxh": "1",
            "bdcdz": "广东省广州市天河区",
            "bdcxxdz": "天河街道",
            "zlqqs": "2025-01-14 12:00",
            "zlqzz": "2025-01-14 15:00",
            "mjdw": "平方米",
            "kdsbz": "N",
            "cph": "A001,A002,A003"
        }
    ],
    "zfxxList": [
        {
            "zfqd": "001",
            "jydh": "jydh001"
        }
    ],
    "fjmbmc": "停车费",
    "fjysList": [
        {
            "fjysmc": "车牌号",
            "fjyslx": "string",
            "fjysxx": "A12345"
        },
        {
            "fjysmc": "交易单号",
            "fjyslx": "string",
            "fjysxx": "jy001"
        }
    ]
}

示例代码

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

application/json

Body

code

enum<string>

响应码

必需

枚举值:

00009999

mess

string

状态描述

必需

示例

{
    "code": "0000",
    "mess": "保存成功"
}

请求参数

示例代码

返回响应