数电发票开具接口

业务说明

业务系统通过本接口可实现开具全面数字化电子发票的开具（增值税专用发票，增值税普通发票）。
特定业务已支持：“二手车发票”，"建筑服务发票"，"不动产经营租赁服务"，"不动产销售服务发票"，"拖拉机和联合收割机发票"，"旅客运输服务发票"，"机动车"，"货物运输服务发票"，"代收车船税"，"成品油"，"自产农产品销售发票"，"农产品收购发票"。

请求与响应流程

本接口支持数电发票的开具操作，默认以同步方式执行。若同步处理过程超过40秒，系统将自动将该请求转为异步处理模式，并同步返回（返回code=2001 message=因税局不稳定导致任务执行超时，本次请求已自动转为异步方式，可通过异步请求结果查询获取结果），对应异步请求结果查询接口，以确保用户界面的响应性。

业务系统设计
用户交互建议
用户发起开票请求后，根据当前处理状态，前端应显示相应的状态信息。
若请求转为异步处理，用户只需耐心等待，无需进行任何额外操作，系统应自动处理并更新状态。
业务操作状态
业务系统设计中建议包含的操作状态：未开票、开票中、异步开票中、开票完成、开票失败。
未开票：发票开具流程尚未开始。
开票中：发票开具流程正在同步执行中。
异步开票中：同步处理预计耗时过长，请求已自动转为异步处理，发票开具流程在后台进行中。
开票完成：发票已成功开具，无论是同步还是异步处理，最终都将达到此状态。
开票失败：发票开具过程中遇到错误，无论是同步还是异步处理，均将返回失败状态及相应错误信息。
异步处理机制
自动转换：当同步处理时间预计超过40秒时，系统将自动将请求转为异步处理，无需用户干预，并返回reqeustId，系统可通过异步请求结果查询接口来异步获取结果。
界面反馈：转为异步处理后，前端界面将即时显示“异步开票中”状态，提醒用户当前操作已转为后台处理。
结果查询：用户无需进行任何额外操作，后台将自动轮询或通过异步回调机制获取处理结果，并更新状态为“开票完成”或“开票失败”。
异常处理：所有异步处理过程中可能出现的异常情况，应由系统后台自动捕获并处理，确保用户界面的友好性和系统的稳定性。

请求参数

Header 参数

Content-Type

string

可选

默认值:

application/json

access_token

string

必需

通过调用access_token接口返回的access_token值

默认值:

req_date

string

必需

当前时间转为的毫秒数

默认值:

Body 参数application/json

action

enum<string> | enum<null>

操作类型

可选

枚举值:

fpkj_zzs

nsrsbh

string

纳税人识别号

必需

async

boolean

是否为异步方式（默认同步)

可选

默认值:

false

data

object

请求数据

必需

ly_ddbh

string

来源订单编号

必需

指业务系统中对应的订单编号，销售单号或合同单号等，本接口同一个单号仅能开具一次发票。

fplxdm

enum<string>

发票类型代码

必需

枚举值:

030,全电普通发票032,全电专用发票87,全电纸质机动车发票

xsf_nsrsbh

string

销方税号

必需

销方统一社会信用代码

xsf_nsrmc

string

销方名称

必需

xsf_dz

string

销方地址

必需

xsf_dh

string

销方电话

必需

xsf_yhmc

string

销方开户银行

可选

xsf_yhzh

string

销方银行账号

可选

gmf_lx

enum<string>

购方类型

必需

受票方自然人标识：如开票给自然人，此标识请选择“1”，

枚举值:

0-N1-Y

gmf_nsrsbh

string

购方税号

可选

购方统一社会信用代码（当发票开具为全电专用发票（032）时该字段必填）

gmf_nsrmc

string

购方名称

必需

gmf_dz

string | null

购买方地址

可选

gmf_dh

string | null

购买方电话

可选

gmf_yhmc

string | null

购买方开户银行

可选

gmf_yhzh

string | null

购买方银行账号

可选

hjje

string | null

合计金额

可选

不传时会自动通过明细计算，为保证您的票面金额的准确性，在开具不含税发票时，建议您传入合计金额。

hjse

string | null

合计税额

可选

不传时会自动通过明细计算

jshj

string | null

价税合计

可选

不传时会自动计算，为保证您的票面金额的准确性，在开具含税发票时，建议您传入价税合计。

string | null

备注

可选

fhr

string

复核人

可选

skr

string

收款人

可选

hsslbs

string | null

含税标识

可选

1：是不含税价, 不传值默认为含税价
2：是含税价
（注：本参数仅用于价税分离，如您的请求报文已包含项目金额、税额，则本参数无任何意义）

xgm_xsyhzc

enum<string>

放弃享受减按1%征收率原因

可选

“04”：因为前期已开具3%征收率的发票，发生销售折让、中止或者退回等情形崙要开具3%征收率的红字发票，或者开票有误需要重新开具3%征收率的发票

枚举值:

gfxx_confirm

string | null

购方信息确认

可选

"0": 忽略购方信息错误，直接开具“”：空或不传，则会提示购方信息错误；

kjje_confirm

string

大金额信息确认

可选

"0": 忽略大金额提示，直接开具“”：空或不传，则会提示开具金额较大；纳税人首次开票额度大于发票额度的50%，且开票金额大于50万，会触发大额发票提醒

kdsbzConfirm

string

建筑服务发生地与销售方注册地址不在同一县市提示

可选

"0" 弹出上述提示 "1"忽略提示开票默认0

dfgtgmbq

string

多方共同购买标识

可选

Y/N 不填默认N，不动产销售信息时使用

gtgmxxes

array [object {3}]

多方共同购买方信息

可选

不动产销售信息选中多方购买标识此项必填

zfxxes

array [object {2}]

支付信息

可选

xmmx

array [object {16}]

开票明细项目

必需

tdyslxdm

enum<string>

特定要素类型代码

可选

枚举值:

"15":"二手车""03":"建筑服务发票""06":"不动产经营租赁服务""05":"不动产销售服务发票""13":"拖拉机和联合收割机发票""09":"旅客运输服务发票""14":"机动车""04":"货物运输服务发票""07": "代收车船税""01": "成品油""12":"自产农产品销售发票""16":"农产品收购发票""02":"稀土发票""08":"通行费""10":"医疗服务（住院）发票""11":"医疗服务（门诊）发票""17":"光伏收购发票""18":"卷烟发票""19":"出口发票""20":"农产品""21":"铁路电子客票""22":"航空运输电子客票行程单""23":"白酒""24":"报废产品收购"

hwysfwdzfpmxbList

array [object {6}]

货物运输明细（当特定业务类型为04 货物运输时必填)

可选

bdczyzlxxs

array[object (不动产经营租赁信息(当特定业务类型是不动产经营租赁服务时必填)) {8}]

不动产经营租赁信息（多个）

可选

bdcjyxsxxs

array[object (不动产经营销售服务(当特定业务类型是不动产经营销售服务时必填）) {9}]

不动产销售信息（多个)

可选

jdctyxsxx

object

机动车统一销售信息（当特定业务类是机动车统一销售发票时必填）

可选

dsccsxx

object

代收车船税(当特定业务类型是代收车船税时必填)

可选

lkysfwxx

array [object {8}]

旅客运输服务发票

可选

tljlhsgjxx

object

拖拉机和联合收割机信息（当特定业务是拖拉机和联合收割机时必填）

可选

jzfwxx

object

建筑服务信息

可选

特定业务为建筑服务信息时必填

escxx

object

二手车信息

可选

特定业务选择二手车时必填

sfzsgmfyhzh

string | null

是否展示购买方银行账号 1 展示 0或空不展示

可选

sfzsxsfyhzh

string | null

是否展示销售方银行账号 1 展示 0或空不展示

可选

sfzsgmfdzdh

string

是否展示购买方地址电话 1 展示 0或空不展示

可选

sfzsxsfdzdh

string

是否展示销售方地址电话 1 展示 0或空不展示

可选

cezslxDm

string

差额开票代码

可选

01: 全额
02: 差额

cepzmxList

array [object {9}]

差额明细列表

可选

wjgs

enum<string>

版式文件格式

可选

多个以,隔开

枚举值:

OFDPDFXMLEWM

fjxxList

array [object {2}]

附加要素列表

可选

jbrxm

string

经办人姓名

可选

jbrzjhm

string

经办人证件号码

可选

jbrgjdm

enum<string>

经办人国籍代码

可选

枚举值:

004008010012016020024028031032036040044048050051052056060064068070072074076084086090092096100104108112116120124132136140144148152156158162166170174175178180184188191192196203204208212214218222226231232233234238239242246250254258260262266268270275276288292296300304308312316320324328332334336340344348352356360364368372376380384388392398400404408410414417418422426428430434438440442446450454458462466470474478480484492496498499500504508512516520524528530533540548554558562566570574578580581583584585586591598600604608612616620624626630634638642643646654659660662666670674678682686688690694702703704705706710716724728732736740744748752756760762764768772776780784788792795796798800804807818826831832833834840850854858860862876882887891894A00

jbrzrrnsrsbh

string

经办人纳税人识别号

可选

jbrzjzldm

string

经办人证件种类代码

可选

见多方共同购买方信息中证件类型

aggOrgId

string

企业id

必需

accountId

string

账号唯一标识

可选

多账号下的账号唯一标识

示例

{
  "async": false,
  "nsrsbh": "91***********17",
  "data": {
    "xsfYhmc": "中国银行***********支行",
    "hjse": "7.75",
    "ly_ddbh": "2024092*****li03v5",
    "gmfDz": "",
    "wjgs": "OFD,PDF,XML",
    "gmfNsrmc": "个人",
    "xsfNsrsbh": "91***********17",
    "gfxxConfirm": "0",
    "xsfDz": "深圳市***************************B栋102",
    "xsfNsrmc": "深圳市*********有限公司",
    "gmfLx": "0",
    "fplxdm": "030",
    "bz": "订单号: 2024092*****li03v5",
    "xmmx": [
      {
        "ggxh": "FA26",
        "fphxz": "0",
        "se": "7.75",
        "spsl": "1",
        "xmmc": "桌面风扇",
        "ssyhzclx": "",
        "spmc": "家用通风电器具",
        "sl": "0.13",
        "je": "59.64",
        "spbm": "1090416010000000000",
        "slbs": "0"
      }
    ],
    "xsfYhzh": "74***********39",
    "jshj": "67.39",
    "xsfDh": "0755-***********5"
  },
  "action": "fpkj_zzs"
}

返回响应

🟢200成功

application/json

Body

data

object

必需

kplsh

string

开票流水号

必需

fplxdm

string

发票类型代码

必需

fpdm

string

发票代码

可选

仅旧版发票有值

zzfphm

string

纸质发票号码（纸质发票开具时返回)

可选

fphm

string

发票号码

必需

旧版为8位发票号码，新数电为20位数电号码

kprq

string

开票日期与时间

必需

kplx

enum<string>

开票类型

必需

0：蓝票

枚举值:

jshj

number

价税合计

必需

发票的价税合计

gmfNsrsbh

string

购买方税号

可选

gmfNsrmc

string

购买方名称

可选

xsfNsrsbh

string

销售方税号

可选

xsfNsrmc

string

销售方名称

可选

pdf_url

string

链接

可选

pdf板式文件链接

ofd_url

string

链接

可选

ofd板式文件链接

xml_url

string

链接

可选

xml板式文件链接

ewm_url

string

链接

可选

二维码链接

reqId

string

请求id

必需

code

string

返回code

必需

（2000成功，详细参考错误代码说明)

success

boolean

可选

message

string | null

返回错误信息提示

可选

示例

成功请求超时转异步示例异步请求成功返回示例

{
  "reqId": "1f349ace904b481182c494844a82f467",
  "code": "2000",
  "success": true,
  "message": null,
  "data": {
    "kplx": "0",
    "kplsh": "202403010449175685068215",
    "gmfNsrsbh": "************16873K",
    "gmfNsrmc": "********有限公司",
    "xsfNsrsbh": "************79064G",
    "xsfNsrmc": "******有限公司",
    "fplxdm": "030",
    "kprq": "2024-03-01 04:49:19",
    "jshj": 1175.52,
    "fphm": "************14101182"
  }
}

数电发票开具接口

业务说明#

请求与响应流程#

业务系统设计#

用户交互建议#

业务操作状态#

异步处理机制#

请求参数

返回响应

业务说明

请求与响应流程

业务系统设计

用户交互建议

业务操作状态

异步处理机制