订单上传-旅客运输发票

请求参数

Header 参数

actionCode

string

可选

示例值:

DJGLXZ

taxnum

string

税号

可选

interfaceCode

string

授权码

可选

extensionNo

string

分机号

可选

isEncryption

string

是否加密

必需

Body 参数application/json

fpzt

object

发票主体信息

必需

kplsh

string

开票流水号

必需

ddh

string

业务编号

可选

djlx

string

单据类型

必需

1-销售单；2-退货单

zdkp

string

自动开票标志

可选

null-不自动开票；1-自动开票

xxzh

string

信息转换

可选

null-不转换；0-订单创建时；1-提交开票时

fppz

enum<string>

发票票种代码

必需

枚举值:

0102010022

tdyw

string

特定业务代码

可选

09-旅客运输

gmfzrrbz

string

购买方自然人标识

必需

Y-自然人；N-非自然人

gmfmc

string

购买方名称

必需

gmfnsrsbh

string

购买方识别号

可选

专票必传

gmfdz

string

购买方地址

可选

gmfdh

string

购买方电话

可选

gmfkhh

string

购买方开户行名称

可选

gmfzh

string

购买方开户行账户

可选

xsfmc

string

销售方名称

必需

xsfnsrsbh

string

销售方税号

必需

xsfdz

string

销售方地址

必需

xsfdh

string

销售方电话

必需

xsfkhh

string

销售方开户行名称

必需

xsfzh

string

销售方开户行账户

必需

hsbz

string

含税标志

必需

0-不含税；1-含税

hjje

string

合计金额

必需

最多保留两位小数，退货单为负数

hjse

string

合计税额

必需

最多保留两位小数，退货单为负数

jshj

string

价税合计

必需

最多保留两位小数，退货单为负数

kpr

string

开票人

必需

skr

string

收款人

可选

fhr

string

复核人

可选

yhid

string

用户ID

可选

系统内部使用，如果不传，仅组织级管理员可见

bmid

string

部门ID

可选

jfsj

string

交付手机

可选

jfyx

string

交付邮箱

可选

cssj

string

抄送手机

可选

csyx

string

抄送邮箱

可选

bzxx

string

备注

可选

xsxfyh

string

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

可选

N-不显示；Y-显示

xsxfdz

string

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

可选

N-不显示；Y-显示

xsgfyh

string

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

可选

N-不显示；Y-显示

xsgfdz

string

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

可选

N-不显示；Y-显示

xsskfh

string

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

可选

N-不显示；Y-显示

gfbm

string

客户编码

可选

用于补全购方信息

hddz

string

回调地址

可选

开票成功后回传发票数据

kpfj

string

开票分机

可选

jqbm

string

机器编码

可选

zdh

string

终端号

可选

yfprq

string

原蓝票开票日期

可选

yyyy-MM-dd HH:mm:ss
自动开票\退货单必填

ysdfphm

string

原蓝字数电发票号码

可选

退货单必填

yfpdm

string

原蓝字税控/纸质发票号码

可选

退货单必填

yfphm

string

原蓝字税控/纸质发票号码

可选

退货单必填

yfppz

string

原发票票种

可选

退货单必填

fqf

string

发起方

可选

0-销方；1-购方
退货单必填

gxsf

string

购销身份

可选

0-销方；1-购方
退货单必填

chyy

enum<string>

冲红原因

可选

退货单必填

枚举值:

01020304110000000010100000000000000100

fpmxList

array [object {18}]

发票明细列表

必需

string

行号

必需

从1开始递增，如：1、2、3、4、5

yhh

string

对应蓝字发票行号

可选

退货单必填

spmc

string

商品名称

必需

ggxh

string

规格型号

可选

string

单位

可选

string

数量

可选

最多保留13为小数，退货单为负数

hsbz

string

含税标志

必需

0-不含税；1-含税

hsdj

string

含税单价

可选

最多保留13位小数

string

不含税单价

可选

最多保留13位小数

string

不含税金额

必需

最多保留2位小数，退货单为负数

string

税额

必需

最多保留2位小数，退货单为负数

slv

string

税率

必需

填小数，如0.06

jshj

string

含税金额

必需

最多保留2位小数，退货单为负数

ssflbm

string

税收分类编码

必需

fphxz

string

发票行性质

必需

0-正常行；1-折扣行；2-被折扣行

kce

string

扣除额

可选

yhzcbs

enum<string>

优惠政策代码

可选

枚举值:

010203040506070809101112131415161718

spzdybm

string

商品信息补全字段

可选

用于商品信息补全

tdyxList

array [object {9}]

特定业务列表

必需

string

行号

必需

跟商品明细行号对应

cxr

string

出行人

必需

cxrq

string

出行日期

必需

yyyy-MM-dd

zjlx

enum<string>

证件类型

必需

枚举值:

100101102103199200201202203204205206207208209210211212213214215216217218219220221222223224225226227228229230231232233234235236237238239240241291299

zjhm

string

证件号码

必需

cfd

string

出发地

必需

ddd

string

到达地

必需

jtgj

enum<string>

交通工具类型

必需

枚举值:

12345679

string

等级

必需

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

示例

{
    "fpzt": {
        "ddh": "20250217010",
        "kplsh": "20250217010",
        "tdyw": "09",
        "fppz": "02",
        "lzfpbz": "1",
        "xsfmc": "销售方名称",
        "xsfnsrsbh": "339901999999199",
        "xsfdz": "xsfdz001",
        "xsfdh": "xsfdh001",
        "xsfkhh": "xsfkhh001",
        "xsfzh": "xsfzh",
        "gmfzrrbz": "N",
        "gmfmc": "购买方名称",
        "hsbz": "1",
        "hjje": "91.74",
        "hjse": "8.26",
        "jshj": "100.00",
        "kpr": "kpr001",
        "bz": "bz001",
        "djlx": "1"
    },
    "fpmxList": [
        {
            "hh": 1,
            "ssflbm": "3040502020199000000",
            "spmc": "旅客运输",
            "fphxz": "0",
            "hsbz": "1",
            "slv": "0.09",
            "se": "8.26",
            "je": "91.74",
            "jshj": "100.00",
            "hsdj": "100",
            "sl": "1"
        }
    ],
    "tdyxList": [
        {
            "hh": 1,
            "cxr": "出行人",
            "cxrq": "2025-02-17",
            "zjlx": "201",
            "zjhm": "xxx",
            "cfd": "北京",
            "ddd": "上海",
            "jtgj": "2",
            "dj": "硬席（硬座、硬卧）"
        }
    ]
}

示例代码

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

application/json

Body

code

string

响应码

必需

0000-上传订单成功；9999-上传订单失败

mess

string

状态描述

必需

示例

{
    "code": "0000",
    "mess": "单据上传成功！"
}

订单上传-旅客运输发票

请求参数

示例代码

返回响应