数电票开放平台 API 文档

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

接口总览 快速入门 套餐与订单 API Key 管理 Webhook 配置 SMS 映射 错误码表 蓝字开票 红字冲红 保存草稿 发票查询 文件下载 账户信息 任务状态
用户后台指南

快速入门

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

查看详情 →

套餐与订单

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

查看详情 →

API Key 管理

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

查看详情 →

Webhook 配置

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

查看详情 →

SMS 映射配置

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

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

POST lzfpkj

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

查看详情 →

POST czfpch

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

查看详情 →

POST bcgq

保存草稿 — 草稿 CRUD,逻辑删除

查看详情 →

GET fpcx

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

查看详情 →

GET fpwjxz

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

查看详情 →

GET zhxx

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

查看详情 →

GET rwzt

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

查看详情 →

POST sandbox/*

Sandbox 沙箱 — 同构仿真,不触引擎不计费

查看详情 →
认证方式

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

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

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

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

基础信息

Base URL(生产):https://your-domain.com/open/v1

Base URL(沙箱):https://your-domain.com/open/v1/sandbox

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

响应格式:JSON

字符编码:UTF-8