发票开具-医疗服务（住院）

请求参数

Header 参数

actionCode

string

必需

示例值:

XXFPYLFWZY

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

项目名称

必需

税收分类编码为3040502020200000000，名称固定填写：车辆停放服务

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

ylfwzyList

array [object {28}]

医疗服务（门诊）

必需

只允许单条明细

ylywlsh

string

医疗业务流水号,唯一

必需

<= 40 字符

hzxm

string

患者姓名

必需

<= 120 字符

hzsfzjlxdm

string

患者身份证件类型代码

必需

201，身份证

<= 3 字符

hzsfzjhm

string

患者身份证件号码

必需

<= 30 字符

blh

string

病历号

可选

<= 20 字符

zyh

string

住院号

必需

<= 20 字符

zykb

string

住院科别

可选

<= 100 字符

zysjq

string

住院时间起

可选

<= 30 字符

zysjz

string

住院时间止

可选

<= 30 字符

yjje

string

预缴金额

可选

<= 22 字符

bjje

string

补缴金额

可选

<= 22 字符

tfje

string

退费金额

可选

<= 22 字符

yljglxdm

string

医疗机构类型代码

可选

<= 4 字符

qtyljglx

string

其他医疗机构类型

可选

<= 100 字符

yblxdm

string

医保类型代码

可选

<= 2 字符

qtyblx

string

其他医保类型

可选

<= 100 字符

ybbh

string

医保编号

可选

<= 30 字符

xbdm

enum<string>

性别，枚举值：1男，2女

必需

<= 1 字符

枚举值:

ybtcjjzfje

string

医保统筹基金支付金额，BigDecimal(18,4)

可选

<= 30 字符

示例值:

18,4

qtzfje

string

其他支付金额，BigDecimal(18,4)

可选

<= 30 字符

示例值:

18,4

grzhzfje

string

个人账户支付金额，BigDecimal(18,4)

可选

<= 30 字符

示例值:

18,4

grxjzfje

string

个人现金支付金额，BigDecimal(18,4)

可选

<= 30 字符

示例值:

18,4

grzfje

string

个人自付金额，BigDecimal(18,4)

可选

<= 30 字符

示例值:

18,4

grzfeije

string

个人自费金额，BigDecimal(18,4)

可选

<= 30 字符

示例值:

18,4

jkr

string

交款人

可选

<= 100 字符

skdw

string

收款单位

必需

<= 100 字符

sszdyyssl

string

省市自定义要素数量

可选

<= 2 字符

sszdyysList

array [object {3}]

省市自定义要素

可选

sfmxlist

array [object {10}]

住院收费明细

必需

zysfmxxh

string

住院收费明细序号

必需

<= 8 字符

mxxh

string

住院收费明细对应的发票票面明细序号

必需

<= 8 字符

fymx

string

费用明细

必需

<= 100 字符

string

数量

可选

<= 25 字符

string

单位

可选

<= 255 字符

string

金额

必需

<= 22 字符

string

税率

必需

<= 23 字符

slv

string

税额

必需

<= 23 字符

ylfwbgm

string

医疗服务贯标码

可选

<= 50 字符

string

医疗服务备注

可选

<= 100 字符

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": "9144011223331133346601",
    "ddh": "91440101MA5250122001",
    "fppz": "02",
    "lzfpbz": "1",
    "xsfmc": "航天信息（广东）有限公司",
    "xsfnsrsbh": "91440101MA5APD8X8J",
    "gmfzrrbz": "N",
    "gmfmc": "邓伟滔",
    "hjse": 0.08,
    "kpr": "邓伟滔",
    "fpmxList": [
        {
            "mxxh": "1",
            "sphfwssflhbbm": "3070202000000000000",
            "xmmc": "住院",
            "fphxz": "0",
            "hsbz": "0",
            "je": "0.92",
            "slv": 0.09,
            "se": 0.08,
            "hsje": 1
         
        }],
    "hjje": 0.92,
    "jshj": 1,
    "ylfwmzList": [
        {
            "ylywlsh": "1",
            "mzh": "00001",
            "hzxm": "麦伟雄",
            "hzsfzjhm": "441522199210102718",
            "hzsfzjlxdm": "201",
            "mzjzsj": "2025-06-01 00:00:00",
            "xbdm": "1"
        }
            ],
    "hsbz": "1",
    "xsfdz": "广州市黄埔区科学大道98号",
    "xsfdh": "020-83208136",
    "xsfkhh": "中国工商银行广州东风中路支行",
    "xsfzh": "3602068719200033627",
    "fhr": "邓伟滔",
    "bz": "备注",
    "skr": "邓伟滔"
}

示例代码

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

返回响应

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