数电票开放平台 API 文档

浙江电子税务局数电票 API 服务 · v1

接口总览 接口文档与调试 快速入门 套餐与订单 接口管理 Webhook 配置 SMS 映射 错误码表
用户后台指南

快速入门

从注册到第一张发票 — 完整接入流程

查看详情 →

套餐与订单

套餐对比、购买、续订、对公转账流程

查看详情 →

接口管理

创建/轮换/撤销 API Key,IP 白名单,生产与沙箱环境

查看详情 →

Webhook 配置

事件回调地址配置、签名校验、重试策略

查看详情 →

SMS 映射配置

税号与手机号映射、短信验证码自动转发

查看详情 →
开放接口(/open/v1/)

所有接口的参数说明、请求示例、响应示例和在线调试功能已整合到 接口文档与调试 页面。

每个接口展开后可查看完整参数表、curl 示例和响应格式,并支持直接在页面中发送调试请求。

POST lzfpkj

蓝字开票 — 异步任务,预扣配额,返回 task_id

查看详情与调试 →

POST czfpch

红字冲红 — 原票校验、预扣配额、异步任务

查看详情与调试 →

GET fpcx

发票查询 — 同步调用引擎,扣日配额

查看详情与调试 →

GET fpwjxz

文件下载 — PDF/OFD/XML 版式文件流

查看详情与调试 →

GET zhxx

账户信息 — 余额/套餐/配额聚合查询

查看详情与调试 →

GET rwzt

任务状态 — 查询异步任务进度与结果

查看详情与调试 →
认证方式

所有开放接口需在请求头携带 X-API-Key。

生产环境:X-API-Key: sk-live-xxxx,访问 /open/v1/*

沙箱环境:X-API-Key: sk-sandbox-xxxx,访问 /open/v1/sandbox/*

交叉访问将被拦截(生产 Key 不可访问 sandbox 路径,反之同)。

所有接口均需传入 nsrsbh(纳税人识别号)参数,系统校验该税号是否已授权。

基础信息

Base URL(生产):https:///open/v1

Base URL(沙箱):https:///open/v1/sandbox

请求格式:JSON(Content-Type: application/json)

响应格式:JSON

字符编码:UTF-8