发票开具 - 数电前置API

请求参数

Header 参数

actionCode

string

必需

示例值:

XXFPKJYB

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>

蓝字发票标志

必需

枚举值:

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

对应税控/纸质蓝字发票代码

可选

税控/纸质发票红冲必传

dylzskfphm

string

对应税控/纸质蓝字发票号码

可选

税控/纸质发票红冲必传

hzqrxxdbh

string

红字确认单编号

可选

数电发票红冲必传

hzqrduuid

string

红字确认单UUID

可选

数电发票红冲必传

jfsj

string

交付手机

可选

jfyx

string

交付邮箱

可选

cssj

string

抄送手机

可选

多个以 , 隔开。例：1234,2345,454

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

fjmbmc

string

附加要素模板名称

可选

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

fjysList

array [object {3}]

附加要素信息列表

可选

fjysmc

string

附加要素名称

必需

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

fjyslx

enum<string>

附加要素类型

必需

枚举值:

string/date/number

fjysxx

string

附加要素信息

必需

示例

{
    "ddh": "20241205002",
    "fhr": "-",
    "fpmxList": [
        {
            "dw": "件",
            "fphxz": "0",
            "hsbz": "1",
            "hsdj": 1.10956879,
            "hsje": 1080.72,
            "je": 956.39,
            "mxxh": 1,
            "se": 124.33,
            "sl": 974,
            "slv": 0.13,
            "sphfwssflhbbm": "1070601990000000000",
            "xmmc": "后盖板 Y113122-031 RoHS YL1131S 厚度<mm>1.5mm HIPS 黑色 不带温控器孔(Φ10mm)"
        },
        {
            "dw": "件",
            "fphxz": "0",
            "hsbz": "1",
            "hsdj": 1.01632764,
            "hsje": 2618.06,
            "je": 2316.87,
            "mxxh": 2,
            "se": 301.19,
            "sl": 2576,
            "slv": 0.13,
            "sphfwssflhbbm": "1070601990000000000",
            "xmmc": "后盖板 Y9223701-012 RoHS MYL922S-B 厚度<mm>1.35 HIPS 黑色 不带温控器孔"
        },
        {
            "dw": "件",
            "fphxz": "0",
            "hsbz": "1",
            "hsdj": 5.00298246,
            "hsje": 570.34,
            "je": 504.73,
            "mxxh": 3,
            "se": 65.61,
            "sl": 114,
            "slv": 0.13,
            "sphfwssflhbbm": "1070601990000000000",
            "xmmc": "下门衬 YL1534S-007 RoHS D平台 YL1534S 吸塑成型 HIPS 白色 螺钉固定门封结构"
        },
        {
            "dw": "件",
            "fphxz": "0",
            "hsbz": "1",
            "hsdj": 8.284,
            "hsje": 124.26,
            "je": 109.96,
            "mxxh": 4,
            "se": 14.3,
            "sl": 15,
            "slv": 0.13,
            "sphfwssflhbbm": "1070601990000000000",
            "xmmc": "下门衬 J155921-031 REACH,RoHS 白 (海外净饮)门扣孔扩大版 JL1850S-RO"
        }
    ],
    "fppz": "01",
    "fpqqlsh": "20241205002",
    "gmfmc": "企业名称",
    "gmfnsrsbh": "企业税号",
    "gmfzrrbz": "N",
    "hjje": 3887.95,
    "hjse": 505.43,
    "hsbz": "1",
    "jshj": 4393.38,
    "kpr": "test",
    "lzfpbz": "1",
    "skr": "-",
    "xsfdh": "",
    "xsfdz": "",
    "xsfkhh": "",
    "xsfmc": "企业名称",
    "xsfnsrsbh": "企业税号",
    "xsfzh": ""
}

示例代码

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: XXFPKJYB' \
--header 'taxnum;' \
--header 'interfaceCode;' \
--header 'extensionNo;' \
--header 'isEncryption;' \
--header 'Content-Type: application/json' \
--data-raw '{
    "ddh": "20241205002",
    "fhr": "-",
    "fpmxList": [
        {
            "dw": "件",
            "fphxz": "0",
            "hsbz": "1",
            "hsdj": 1.10956879,
            "hsje": 1080.72,
            "je": 956.39,
            "mxxh": 1,
            "se": 124.33,
            "sl": 974,
            "slv": 0.13,
            "sphfwssflhbbm": "1070601990000000000",
            "xmmc": "后盖板 Y113122-031 RoHS YL1131S 厚度<mm>1.5mm HIPS 黑色 不带温控器孔(Φ10mm)"
        },
        {
            "dw": "件",
            "fphxz": "0",
            "hsbz": "1",
            "hsdj": 1.01632764,
            "hsje": 2618.06,
            "je": 2316.87,
            "mxxh": 2,
            "se": 301.19,
            "sl": 2576,
            "slv": 0.13,
            "sphfwssflhbbm": "1070601990000000000",
            "xmmc": "后盖板 Y9223701-012 RoHS MYL922S-B 厚度<mm>1.35 HIPS 黑色 不带温控器孔"
        },
        {
            "dw": "件",
            "fphxz": "0",
            "hsbz": "1",
            "hsdj": 5.00298246,
            "hsje": 570.34,
            "je": 504.73,
            "mxxh": 3,
            "se": 65.61,
            "sl": 114,
            "slv": 0.13,
            "sphfwssflhbbm": "1070601990000000000",
            "xmmc": "下门衬 YL1534S-007 RoHS D平台 YL1534S 吸塑成型 HIPS 白色 螺钉固定门封结构"
        },
        {
            "dw": "件",
            "fphxz": "0",
            "hsbz": "1",
            "hsdj": 8.284,
            "hsje": 124.26,
            "je": 109.96,
            "mxxh": 4,
            "se": 14.3,
            "sl": 15,
            "slv": 0.13,
            "sphfwssflhbbm": "1070601990000000000",
            "xmmc": "下门衬 J155921-031 REACH,RoHS 白 (海外净饮)门扣孔扩大版 JL1850S-RO"
        }
    ],
    "fppz": "01",
    "fpqqlsh": "20241205002",
    "gmfmc": "企业名称",
    "gmfnsrsbh": "企业税号",
    "gmfzrrbz": "N",
    "hjje": 3887.95,
    "hjse": 505.43,
    "hsbz": "1",
    "jshj": 4393.38,
    "kpr": "test",
    "lzfpbz": "1",
    "skr": "-",
    "xsfdh": "",
    "xsfdz": "",
    "xsfkhh": "",
    "xsfmc": "企业名称",
    "xsfnsrsbh": "企业税号",
    "xsfzh": ""
}'

返回响应

🟢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": "开票请求提交成功"
}