Sandbox 沙箱环境

Sandbox 是完全独立的模拟环境，不调用引擎、不触发税局操作、不计费。所有响应携带 "env":"sandbox"。

使用方式

1. 在控制台创建 API Key 时选择 sandbox 环境

2. 使用 sk-sandbox- 前缀的 Key 访问 sandbox 路由

3. Base URL：/open/v1/sandbox/

可用接口

POST /open/v1/sandbox/lzfpkj     — 蓝字开票（仿真）
POST /open/v1/sandbox/czfpch     — 红字冲红（仿真）
GET  /open/v1/sandbox/bcgq       — 草稿 CRUD
POST /open/v1/sandbox/bcgq
GET  /open/v1/sandbox/fpcx       — 发票查询（仿真数据）
GET  /open/v1/sandbox/fpwjxz     — 文件下载（仿真文件）
GET  /open/v1/sandbox/zhxx       — 账户信息
GET  /open/v1/sandbox/rwzt/:id   — 任务状态（仿真流转）

状态流转

Sandbox 开票/冲红任务自动流转：queued →(1s)→ running →(3s)→ succeeded/failed

可通过管理后台 sys_config 的 sandbox_fail_ratio 参数控制失败比例（0-100）。

仿真发票号规则

20位 = "33" + YYYYMMDD + 10位单调序列；红字发票独立序列；jym 14位伪校验码。

← 返回接口总览