数电前置API

发票开具-建筑服务

POST

http://120.48.195.50:5000/EInvoice-Test/Api

请求参数

Header 参数

actionCode

string

必需

示例值:

XXFPJZFWKJYB

taxnum

string

税号

必需

interfaceCode

string

授权码

必需

extensionNo

string

分机号

可选

isEncryption

string

是否加密

必需

Body 参数application/json

fpqqlsh

string

发票请求流水号

必需

1.对于开票失败的建议不修改请求流水号进行重推开票。
2.对于已经开票成功的请求流水号不能进行重复申请。
3.如果是开红票，该请求流水号需要跟红字确认单的请求流水号一致。

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

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": "1887779684146614272",
    "ddh": "1887779684146614272",
    "fppz": "02",
    "lzfpbz": "1",
    "xsfmc": "企业名称",
    "xsfnsrsbh": "企业税号",
    "xsfdz": "",
    "xsfdh": "",
    "xsfkhh": "",
    "xsfzh": "",
    "gmfzrrbz": "N",
    "gmfmc": "企业名称",
    "gmfnsrsbh": "",
    "gmfdz": "gmfdz001",
    "gmfdh": "gmfdh001",
    "gmfkhh": "gmfkhh001",
    "gmfzh": "gmfzh001",
    "hsbz": "1",
    "hjje": "125.69",
    "hjse": "11.31",
    "jshj": "137.00",
    "kpr": "kpr001",
    "skr": "skr001",
    "fhr": "fhr001",
    "xsxfyh": "Y",
    "xsgfyh": "Y",
    "xsskfh": "Y",
    "dylzfphm": "",
    "hzqrxxdbh": "",
    "hzqrduuid": "",
    "jfsj": "",
    "jfyx": "",
    "bz": "bz001",
    "fpmxList": [
        {
            "mxxh": "1",
            "xmmc": "建筑服务发票开具测试",
            "sphfwssflhbbm": "3059900000000000000",
            "spfwjc": "建筑服务",
            "fphxz": "0",
            "hsbz": "1",
            "ggxh": "",
            "dw": "",
            "sl": "",
            "dj": "",
            "hsdj": "",
            "je": "125.69",
            "slv": "0.09",
            "se": "11.31",
            "hsje": "137.00",
            "kce": "",
            "yhzcbs": ""
        }
    ],
    "jzfw":{
           "jzfwmc":"建筑服务测试",
           "tdzzsxmbh":"1002",
           "jzfwfsd":"广东省广州市天河区",
           "jzfwfsdxxdz":"新塘街道绿色场地中央89号",
           "kdsbz":"Y",
           "kqyssm":"12345"
   }
}

示例代码

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

curl --location --request POST 'http://120.48.195.50:5000/EInvoice-Test/Api' \
--header 'actionCode: XXFPJZFWKJYB' \
--header 'taxnum;' \
--header 'interfaceCode;' \
--header 'extensionNo;' \
--header 'isEncryption;' \
--header 'Content-Type: application/json' \
--data-raw '{
    "fpqqlsh": "1887779684146614272",
    "ddh": "1887779684146614272",
    "fppz": "02",
    "lzfpbz": "1",
    "xsfmc": "企业名称",
    "xsfnsrsbh": "企业税号",
    "xsfdz": "",
    "xsfdh": "",
    "xsfkhh": "",
    "xsfzh": "",
    "gmfzrrbz": "N",
    "gmfmc": "企业名称",
    "gmfnsrsbh": "",
    "gmfdz": "gmfdz001",
    "gmfdh": "gmfdh001",
    "gmfkhh": "gmfkhh001",
    "gmfzh": "gmfzh001",
    "hsbz": "1",
    "hjje": "125.69",
    "hjse": "11.31",
    "jshj": "137.00",
    "kpr": "kpr001",
    "skr": "skr001",
    "fhr": "fhr001",
    "xsxfyh": "Y",
    "xsgfyh": "Y",
    "xsskfh": "Y",
    "dylzfphm": "",
    "hzqrxxdbh": "",
    "hzqrduuid": "",
    "jfsj": "",
    "jfyx": "",
    "bz": "bz001",
    "fpmxList": [
        {
            "mxxh": "1",
            "xmmc": "建筑服务发票开具测试",
            "sphfwssflhbbm": "3059900000000000000",
            "spfwjc": "建筑服务",
            "fphxz": "0",
            "hsbz": "1",
            "ggxh": "",
            "dw": "",
            "sl": "",
            "dj": "",
            "hsdj": "",
            "je": "125.69",
            "slv": "0.09",
            "se": "11.31",
            "hsje": "137.00",
            "kce": "",
            "yhzcbs": ""
        }
    ],
    "jzfw":{
           "jzfwmc":"建筑服务测试",
           "tdzzsxmbh":"1002",
           "jzfwfsd":"广东省广州市天河区",
           "jzfwfsdxxdz":"新塘街道绿色场地中央89号",
           "kdsbz":"Y",
           "kqyssm":"12345"
   }
}'

返回响应

🟢200成功

application/json

Body

code

string

响应码

必需

00：开票中；0000：开票成功；9999：开票失败

mess

string

状态描述

必需

data

object

数据项

可选

code为开票成功状态（0000）会返回

fphm

string

发票号码

必需

fpqqlsh

string

发票请求流水号

必需

hjje

string

合计金额

必需

hjse

string

合计税额

必需

jshj

string

价税合计

必需

kprq

string

开票日期

必需

yyyy-MM-dd HH:mm:ss.S

示例

{
    "code": "00",
    "mess": "开票提交成功"
}

修改于 2025-02-27 05:41:36

发票开具-不动产销售

发票开具-成品油