红字全电发票开具

1、接口及场景描述

接口描述：为企业提供红字数电发票开具功能
是否支持数电及税控发票：仅支持数电
场景描述：
01：调用此接口前可先做数电认证及人脸识别，避免实人认证导致开具中断问题

2、请求参数

字段名称	必选	类型	长度	字段含义及备注
method	是	string		请求方法名
object	是	object		请求数据
hzfpxxqrdid	是	string	32	红字确认单id
gfkhdh	否	string	40	购方客户电话
gfkhyx	否	string	40	购方客户邮箱
zdhqbsdz	否	string	1	开票成功后是否返回板式下载地址： 0：否 1：是
fpqqlsh	否	string	32	发票请求流水号
yfplxdm	否	string	2	原发票类型代码 81：全电专 82：全电普 85：纸质专票(全电) 86：纸质普票(全电) 01：增值税专用发票 04：增值税普通发票 10：增值税电子普通发票
fplxdm	否	string	2	发票类型代码 81：全电专 82：全电普 85：纸质专票(全电) 86：纸质普票(全电)
yfphm	否	string	20	原发票号码
ytdyslxdm	否	string	2	原特定要素类型代码 "01"："成品油发票“, "02"："稀土发票", "03"："建筑服务发票", "04"："货物运输服务发票", "05"："不动产销售服务发票", "06"："不动产经营租赁服务", "07"："代收车船税", "08"："通行费", "09"："旅客运输服务发票", "10"："医疗服务（住院）发票", "11"："医疗服务（门诊）发票", "12"："自产农产品销售发票", "13"："拖拉机和联合收割机发票", "14"："机动车", "15"："二手车", "16"："农产品收购发票", "17"："光伏收购发票", "18"："卷烟发票", "19"："出口发票", "20"："农产品"

3、返回参数

字段名称	是否必返回	类型	长度	字段含义及备注
code	是	string		返回代码
msg	是	string		返回消息
data	是	object		返回数据
fphm	是	string	20	发票号码
kprq	是	string		开票日期格式：yyyy-MM-dd HH:mm:ss
ewmUrl	否	string	255	二维码下载地址
pdfUrl	否	string	255	pdf数据下载地址
ofdUrl	否	string	255	ofd数据下载地址
xmlUrl	否	string	255	xml数据下载地址
zzfpdm	否	string	12	全电纸质发票代码
zzfphm	否	string	8	全电纸质发票号码

请求参数

Body 参数application/json

method

string

固定值qdch

必需

object

必需

fplxdm

string

发票类型代码

可选

发票类型代码81：全电专 82：全电普

yfplxdm

string

原发票类型代码

可选

发票类型代码
81：全电专
82：全电普

fpqqlsh

string

发票请求流水号

可选

发票请求流水号

tdyslxdm

string

特定要素类型代码

可选

特定要素类型代码
"01"："成品油发票“,
"02"："稀土发票",
"03"："建筑服务发票",
"04"："货物运输服务发票",
"05"："不动产销售服务发票",
"06"："不动产经营租赁服务",
"07"："代收车船税",
"08"："通行费",
"09"："旅客运输服务发票",
"10"："医疗服务（住院）发票",
"11"："医疗服务（门诊）发票",
"12"："自产农产品销售发票",
"13"："拖拉机和联合收割机发票",
"14"："机动车",
"15"："二手车",
"16"："农产品收购发票",
"17"："光伏收购发票",
"18"："卷烟发票",
"19"："出口发票",
"20"："农产品"

yfphm

string

原全电发票号码

可选

原全电发票号码

hzfpxxqrdid

string

红字确认单id

必需

红字确认单id

gfkhdh

string

购方客户电话

可选

购方客户电话

gfkhyx

string

购方客户邮箱

可选

购方客户邮箱

zdhqbsdz

string

开票成功后是否返回板式下载地址

必需

开票成功后是否返回板式下载地址： 0：否 1：是

示例

{
  "method": "qdch",
  "object": {
    "fplxdm": "发票类型代码",
    "fpqqlsh": "发票请求流水号",
    "yfplxdm": "原发票类型代码",
    "yfphm": "原全电发票号码",
    "hzfpxxqrdid": "红字发票信息确认单id",
    "ytdyslxdm": "原特定要素类型代码",
    "gfkhdh": "购方客户电话",
    "gfkhyx": "购方客户邮箱",
    "zdhqbsdz": "开票成功后是否返回板式下载地址"
  }
}

返回响应

🟢200成功

application/json

Body

code

integer

返回代码

必需

返回代码

msg

string

返回消息

必需

返回消息

data

object

返回数据

必需

返回数据

fphm

string

发票号码

必需

发票号码

kprq

string

开票日期

必需

开票日期格式：yyyy-MM-dd HH:mm:ss

ewmUrl

string

二维码下载地址

可选

二维码下载地址

pdfUrl

string

pdf数据下载地址

可选

pdf数据下载地址

ofdUrl

string

ofd数据下载地址

可选

ofd数据下载地址

xmlUrl

string

xml数据下载地址

可选

xml数据下载地址

zzfpdm

string

全电纸质发票代码

可选

全电纸质发票代码

zzfphm

string

全电纸质发票号码

可选

全电纸质发票号码

示例

{
  "code": 0,
  "msg": "成功",
  "data": {
    "fphm": "发票号码",
    "kprq": "开票日期",
    "ewmUrl": "二维码下载地址",
    "pdfUrl": "pdf数据下载地址",
    "ofdUrl": "ofd数据下载地址",
    "xmlUrl": "xml数据下载地址",
    "zzfpdm": "全电纸质发票代码",
    "zzfphm": "全电纸质发票号码"
  }
}

⚪-79人脸识别

⚪-66异步获取

1、接口及场景描述#

2、请求参数#

3、返回参数#

请求参数

返回响应

1、接口及场景描述

2、请求参数

3、返回参数