蓝字开票 lzfpkj - 数电票开放平台

蓝字开票接口。提交开票请求后异步执行，返回 task_id 用于查询任务状态。

请求参数

字段	类型	必填	说明
gmfmc	string	是	购方名称
gmfnsrsbh	string	是	购方纳税人识别号
sphfwssflhbbm	string	是	商品和服务税收分类编码
slv	number	是	税率（如 0.13）
hsje	number	是	含税金额
bz	string	否	备注
skr	string	否	收款人
fhr	string	否	复核人
idempotency_key	string	否	幂等键（24h窗口内相同key+相同请求体视为重放）

响应

202 Accepted — 任务已创建

{"task_id": 12345, "status": "queued", "message": "开票任务已创建"}

200 OK — 幂等重放（相同 idempotency_key + 相同请求体）

{"task_id": 12345, "status": "succeeded", "result": {"fphm": "33202609050000000001", "kprq": "2026-09-05"}}

代码示例

curl -X POST https://your-domain.com/open/v1/lzfpkj \
  -H "X-API-Key: sk-live-xxxx" \
  -H "Content-Type: application/json" \
  -d '{"gmfmc":"测试公司","gmfnsrsbh":"91330100XXXXXXXXXX","sphfwssflhbbm":"1010101010000000000","slv":0.13,"hsje":100.00}'

import requests

resp = requests.post(
    "https://your-domain.com/open/v1/lzfpkj",
    headers={"X-API-Key": "sk-live-xxxx", "Content-Type": "application/json"},
    json={"gmfmc": "测试公司", "gmfnsrsbh": "91330100XXXXXXXXXX",
          "sphfwssflhbbm": "1010101010000000000", "slv": 0.13, "hsje": 100.00}
)
print(resp.json())

OkHttpClient client = new OkHttpClient();
RequestBody body = RequestBody.create(
    "{\"gmfmc\":\"测试公司\",\"gmfnsrsbh\":\"91330100XXXXXXXXXX\",\"sphfwssflhbbm\":\"1010101010000000000\",\"slv\":0.13,\"hsje\":100.00}",
    MediaType.parse("application/json")
);
Request request = new Request.Builder()
    .url("https://your-domain.com/open/v1/lzfpkj")
    .header("X-API-Key", "sk-live-xxxx")
    .post(body)
    .build();
Response response = client.newCall(request).execute();

$ch = curl_init();
curl_setopt($ch, CURLOPT_URL, "https://your-domain.com/open/v1/lzfpkj");
curl_setopt($ch, CURLOPT_POST, true);
curl_setopt($ch, CURLOPT_HTTPHEADER, [
    "X-API-Key: sk-live-xxxx",
    "Content-Type: application/json"
]);
curl_setopt($ch, CURLOPT_POSTFIELDS, json_encode([
    "gmfmc" => "测试公司",
    "gmfnsrsbh" => "91330100XXXXXXXXXX",
    "sphfwssflhbbm" => "1010101010000000000",
    "slv" => 0.13,
    "hsje" => 100.00
]));
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
$response = curl_exec($ch);