发票开具-旅客运输 - 数电前置API

请求参数

Header 参数

actionCode

string

必需

示例值:

XXFPLKYSKJYB

interfaceCode

string

授权码

必需

taxnum

string

税号

必需

extensionNo

string

分机号

可选

isEncryption

string

是否加密

必需

Body 参数application/json

fpqqlsh

string

发票请求流水号

必需

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

ddh

string

订单号

必需

fppz

enum<string>

发票类型

必需

枚举值:

0102010022

lzfpbz

enum<string>

蓝字发票标志

必需

枚举值:

12

xsfmc

string

销方名称

必需

xsfnsrsbh

string

销方税号

必需

xsfdz

string

销方地址

必需

xsfdh

string

销方电话

必需

xsfkhh

string

销方开户行名称

必需

xsfzh

string

销方开户行账号

必需

gmfzrrbz

enum<string>

购方自然人标志

必需

枚举值:

YN

gmfmc

string

购方名称

必需

gmfnsrsbh

string

购方税号

可选

专票必传

gmfdz

string

购方地址

可选

gmfdh

string

购方电话

可选

gmfkhh

string

购方开户行名称

可选

gmfzh

string

购方开户行账号

可选

hsbz

enum<string>

含税标志

必需

枚举值:

01

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

抄送邮箱

可选

多个以 , 隔开

bz

string

备注

可选

xsxfyh

enum<string>

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

可选

枚举值:

NY

xsgfyh

enum<string>

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

可选

枚举值:

NY

xsskfh

enum<string>

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

可选

枚举值:

NY

xsxfdz

enum<string>

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

可选

枚举值:

NY

xsgfdz

enum<string>

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

可选

枚举值:

NY

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

规格型号

可选

dw

string

单位

可选

sl

string

数量

可选

最多保留13位小数，红票填负数

dj

string

不含税单价

可选

最多保留13位小数

hsdj

string

含税单价

可选

最多保留13位小数

hsbz

enum<string>

含税标志

必需

枚举值:

01

je

string

不含税金额

必需

最多保留两位小数，红票填负数

slv

string

税率

必需

小数，如6%应填0.06

se

string

税额

必需

最多保留两位小数，红票填负数

hsje

string

价税合计

必需

最多保留两位小数，红票填负数

yhzcbs

enum<string>

优惠政策标识

可选

枚举值:

010203040506070809101112131415161718

lkysList

array [object {9}]

旅客运输信息列表

必需

mxxh

string

明细序号

必需

跟发票明细序号保持一致

cxr

string

出行人

必需

cxrq

string

出行日期

必需

yyyy-MM-dd

zjlx

enum<string>

证件类型

必需

枚举值:

100101102103199200201202203204205206207208209210211212213214215216217218219220221222223224225226227228229230231232233234235236237238239240241291299

zjhm

string

证件号码

必需

cfd

string

出发地

必需

ddd

enum<string>

到达地

必需

枚举值:

平方米、亩、㎡、平方千米、公顷、h㎡、k㎡

jtgj

enum<string>

交通工具类型

必需

枚举值:

12345679

dj

enum<string>

等级

必需

枚举值:

一等座、二等座、软席（软座、软卧）、硬席（硬座、硬卧）、公务舱、头等舱、经济舱、一等舱、二等舱、三等舱

zfxxList

array [object {2}]

支付信息

可选

zfqd

enum<string>

支付渠道

可选

枚举值:

001002003004005006007008009010011012013099

jydh

string

交易单号

可选

fjmbmc

string

附加要素模板名称

可选

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

fjysList

array [object {3}]

附加要素信息列表

可选

fjysmc

string

附加要素名称

必需

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

fjyslx

enum<string>

附加要素类型

必需

枚举值:

string/date/number

fjysxx

string

附加要素信息

必需

示例

{
    "fpqqlsh": "20250227005",
    "ddh": "20250227005",
    "fppz": "02",
    "lzfpbz": "1",
    "xsfmc": "销方名称",
    "xsfnsrsbh": "销方税号",
    "xsfdz": "销方地址",
    "xsfdh": "销方电话",
    "xsfkhh": "销方开户行名称",
    "xsfzh": "销方开户行账户",
    "gmfzrrbz": "N",
    "gmfmc": "test",
    "hsbz": "1",
    "hjje": 0.92,
    "hjse": 0.08,
    "jshj": 1,
    "kpr": "test",
    "fpmxList": [
        {
            "mxxh": "1",
            "xmmc": "旅客运输测试",
            "sphfwssflhbbm": "3010301010100000000",
            "fphxz": "0",
            "sl": 1,
            "hsdj": 1,
            "hsbz": "1",
            "je": 0.92,
            "slv": 0.09,
            "se": 0.08,
            "hsje": 1
        }
    ],
    "lkysList": [
        {
            "mxxh": "1",
            "cxr": "test",
            "cxrq": "2025-02-27",
            "zjlx": "101",
            "zjhm": "112",
            "cfd": "北京",
            "ddd": "上海",
            "jtgj":"2",
            "dj": "一等座"
        }
    ],
    "zfxxList": [
        {
            "zfqd": "001",
            "jydh": "jydh001"
        }
    ],
    "fjmbmc": "停车费",
    "fjysList": [
        {
            "fjysmc": "车牌号",
            "fjyslx": "string",
            "fjysxx": "A12345"
        },
        {
            "fjysmc": "交易单号",
            "fjyslx": "string",
            "fjysxx": "jy001"
        }
    ]
}

示例代码

Shell

JavaScript

Java

Swift

Go

PHP

Python

HTTP

C

C#

Objective-C

Ruby

OCaml

Dart

R

curl --location --request POST 'http://120.48.195.50:5000/EInvoice-Test/Api' \
--header 'actionCode: XXFPLKYSKJYB' \
--header 'interfaceCode;' \
--header 'taxnum;' \
--header 'extensionNo;' \
--header 'isEncryption;' \
--header 'Content-Type: application/json' \
--data-raw '{
    "fpqqlsh": "20250227005",
    "ddh": "20250227005",
    "fppz": "02",
    "lzfpbz": "1",
    "xsfmc": "销方名称",
    "xsfnsrsbh": "销方税号",
    "xsfdz": "销方地址",
    "xsfdh": "销方电话",
    "xsfkhh": "销方开户行名称",
    "xsfzh": "销方开户行账户",
    "gmfzrrbz": "N",
    "gmfmc": "test",
    "hsbz": "1",
    "hjje": 0.92,
    "hjse": 0.08,
    "jshj": 1,
    "kpr": "test",
    "fpmxList": [
        {
            "mxxh": "1",
            "xmmc": "旅客运输测试",
            "sphfwssflhbbm": "3010301010100000000",
            "fphxz": "0",
            "sl": 1,
            "hsdj": 1,
            "hsbz": "1",
            "je": 0.92,
            "slv": 0.09,
            "se": 0.08,
            "hsje": 1
        }
    ],
    "lkysList": [
        {
            "mxxh": "1",
            "cxr": "test",
            "cxrq": "2025-02-27",
            "zjlx": "101",
            "zjhm": "112",
            "cfd": "北京",
            "ddd": "上海",
            "jtgj":"2",
            "dj": "一等座"
        }
    ],
    "zfxxList": [
        {
            "zfqd": "001",
            "jydh": "jydh001"
        }
    ],
    "fjmbmc": "停车费",
    "fjysList": [
        {
            "fjysmc": "车牌号",
            "fjyslx": "string",
            "fjysxx": "A12345"
        },
        {
            "fjysmc": "交易单号",
            "fjyslx": "string",
            "fjysxx": "jy001"
        }
    ]
}'

返回响应

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