elc-invoice-engine-cli 0.1.0__py3-none-any.whl

cli/commands/invoice.py

@@ -0,0 +1,268 @@
+"""invoice-request V2 命令组。
+
+接口基路径：/v2/invoice-requests
+"""
+from __future__ import annotations
+
+import json
+import uuid
+import typer
+from typing import Optional
+from cli.session import get_client
+from cli.output import print_result, console
+
+app = typer.Typer(help="开票申请单管理 (V2)")
+
+# ── 公共 header 选项 ─────────────────────────────────────────────────────────
+
+def _idempotency_key() -> str:
+    return str(uuid.uuid4())
+
+
+# ── 命令 ─────────────────────────────────────────────────────────────────────
+
+@app.command("list")
+def invoice_list(
+    source_system: Optional[str] = typer.Option(None, "--source-system"),
+    source_id: Optional[str] = typer.Option(None, "--source-id"),
+    status: Optional[str] = typer.Option(None, "--status"),
+    page: int = typer.Option(1),
+    page_size: int = typer.Option(20, "--page-size"),
+    output: str = typer.Option("table", "-o"),
+):
+    """查询开票申请单列表。
+
+    GET /v2/invoice-requests
+    """
+    params: dict = {"pageNum": page, "pageSize": page_size}
+    if source_system:
+        params["sourceSystem"] = source_system
+    if source_id:
+        params["sourceId"] = source_id
+    if status:
+        params["status"] = status
+    status_code, body = get_client().get("/v2/invoice-requests", params=params)
+    # V2 响应：data.invoiceRequests 列表
+    data = body.get("data") or {}
+    if isinstance(data, dict):
+        rows = data.get("invoiceRequests", [])
+        body = {"data": rows}
+    print_result(status_code, body, output, rows_key="data",
+                 columns=["invoiceRequestId", "sourceSystem", "sourceId", "invoiceRequestStatus", "createdTime"])
+
+
+@app.command("get")
+def invoice_get(
+    invoice_request_id: str = typer.Argument(..., help="申请单 ID"),
+    output: str = typer.Option("json", "-o"),
+):
+    """查询申请单详情。
+
+    GET /v2/invoice-requests/{invoiceRequestId}
+    """
+    status, body = get_client().get(f"/v2/invoice-requests/{invoice_request_id}")
+    print_result(status, body, output)
+
+
+@app.command("create")
+def invoice_create(
+    file: str = typer.Option(..., "-f", "--file", help="KDUBL XML 文件路径"),
+    source_system: str = typer.Option("CLI", "--source-system"),
+    source_id: Optional[str] = typer.Option(None, "--source-id"),
+    batch_id: Optional[str] = typer.Option(None, "--batch-id", help="批次 ID（UUID），同批次多单共用"),
+    idempotency_key: Optional[str] = typer.Option(None, "--idempotency-key", help="幂等键，默认自动生成"),
+    timezone: str = typer.Option("UTC+00:00", "--timezone"),
+    output: str = typer.Option("json", "-o"),
+):
+    """创建开票申请单（上传 KDUBL XML）。
+
+    POST /v2/invoice-requests  (multipart/form-data)
+    """
+    import httpx
+    from cli.config import BASE_URL, REQUEST_TIMEOUT
+
+    source_id = source_id or f"CLI-{uuid.uuid4().hex[:8].upper()}"
+    ikey = idempotency_key or _idempotency_key()
+
+    client = get_client()
+    headers = {k: v for k, v in client.headers.items() if k.lower() != "content-type"}
+    headers.update({
+        "X-Request-Id":      uuid.uuid4().hex,
+        "X-Idempotency-Key": ikey,
+        "X-Timezone":        timezone,
+    })
+
+    form_data: dict = {"sourceSystem": source_system, "sourceId": source_id}
+    if batch_id:
+        form_data["batchId"] = batch_id
+
+    with open(file, "rb") as f:
+        files = {"payload": (file.split("/")[-1], f, "application/xml")}
+        resp = httpx.post(
+            f"{BASE_URL}/v2/invoice-requests",
+            headers=headers,
+            files=files,
+            data=form_data,
+            timeout=REQUEST_TIMEOUT,
+        )
+
+    body = resp.json() if "application/json" in resp.headers.get("content-type", "") else {"raw": resp.text}
+    console.print(f"[dim]幂等键：{ikey}[/dim]")
+    print_result(resp.status_code, body, output)
+
+
+@app.command("update")
+def invoice_update(
+    invoice_request_id: str = typer.Argument(..., help="申请单 ID"),
+    file: str = typer.Option(..., "-f", "--file", help="KDUBL XML 文件路径"),
+    idempotency_key: Optional[str] = typer.Option(None, "--idempotency-key"),
+    timezone: str = typer.Option("UTC+00:00", "--timezone"),
+    output: str = typer.Option("json", "-o"),
+):
+    """更新开票申请单（状态为 draft/validate_failed/pending 时可更新）。
+
+    PUT /v2/invoice-requests/{invoiceRequestId}  (multipart/form-data)
+    """
+    import httpx
+    from cli.config import BASE_URL, REQUEST_TIMEOUT
+
+    ikey = idempotency_key or _idempotency_key()
+    client = get_client()
+    headers = {k: v for k, v in client.headers.items() if k.lower() != "content-type"}
+    headers.update({
+        "X-Request-Id":      uuid.uuid4().hex,
+        "X-Idempotency-Key": ikey,
+        "X-Timezone":        timezone,
+    })
+
+    with open(file, "rb") as f:
+        files = {"payload": (file.split("/")[-1], f, "application/xml")}
+        resp = httpx.put(
+            f"{BASE_URL}/v2/invoice-requests/{invoice_request_id}",
+            headers=headers,
+            files=files,
+            timeout=REQUEST_TIMEOUT,
+        )
+
+    body = resp.json() if "application/json" in resp.headers.get("content-type", "") else {"raw": resp.text}
+    print_result(resp.status_code, body, output)
+
+
+@app.command("void")
+def invoice_void(
+    invoice_request_id: str = typer.Argument(..., help="申请单 ID"),
+    output: str = typer.Option("json", "-o"),
+):
+    """作废开票申请单（设置状态为 void）。
+
+    POST /v2/invoice-requests/{invoiceRequestId}/void
+    """
+    client = get_client()
+    status, body = client.post(f"/v2/invoice-requests/{invoice_request_id}/void")
+    print_result(status, body, output)
+
+
+@app.command("issue")
+def invoice_issue(
+    invoice_request_id: str = typer.Argument(..., help="申请单 ID"),
+    output: str = typer.Option("json", "-o"),
+):
+    """触发开票（Issue Invoice）。
+
+    POST /v2/invoice-requests/{invoiceRequestId}/issue
+    """
+    client = get_client()
+    status, body = client.post(f"/v2/invoice-requests/{invoice_request_id}/issue")
+    print_result(status, body, output)
+
+
+@app.command("invoices")
+def invoice_get_invoices(
+    invoice_request_id: str = typer.Argument(..., help="申请单 ID"),
+    output: str = typer.Option("table", "-o"),
+):
+    """查询申请单下的发票列表。
+
+    GET /v2/invoice-requests/{invoiceRequestId}/invoices
+    """
+    status, body = get_client().get(f"/v2/invoice-requests/{invoice_request_id}/invoices")
+    print_result(status, body, output, rows_key="data",
+                 columns=["invoiceId", "invoiceNo", "invoiceStatus", "issueStatus", "totalAmount"])
+
+
+# ── Credit Note 匹配 ──────────────────────────────────────────────────────────
+
+@app.command("match-cn-create")
+def match_cn_create(
+    file: str = typer.Option(..., "-f", "--file", help="Credit Note KDUBL XML 文件路径"),
+    idempotency_key: Optional[str] = typer.Option(None, "--idempotency-key"),
+    output: str = typer.Option("json", "-o"),
+):
+    """创建 Credit Note 蓝冲匹配任务。
+
+    POST /v2/invoice-requests/match-cn  (multipart/form-data)
+    """
+    import httpx
+    from cli.config import BASE_URL, REQUEST_TIMEOUT
+
+    ikey = idempotency_key or _idempotency_key()
+    client = get_client()
+    headers = {k: v for k, v in client.headers.items() if k.lower() != "content-type"}
+    headers.update({"X-Request-Id": uuid.uuid4().hex, "X-Idempotency-Key": ikey})
+
+    with open(file, "rb") as f:
+        resp = httpx.post(
+            f"{BASE_URL}/v2/invoice-requests/match-cn",
+            headers=headers,
+            files={"payload": (file.split("/")[-1], f, "application/xml")},
+            timeout=REQUEST_TIMEOUT,
+        )
+
+    body = resp.json() if "application/json" in resp.headers.get("content-type", "") else {"raw": resp.text}
+    console.print(f"[dim]幂等键：{ikey}[/dim]")
+    print_result(resp.status_code, body, output)
+
+
+@app.command("match-cn-run")
+def match_cn_run(
+    invoice_request_id: str = typer.Argument(..., help="申请单 ID"),
+    reason_code: str = typer.Option("OTHER", "--reason", help="RETURN / ALLOWANCE / OTHER"),
+    output: str = typer.Option("json", "-o"),
+):
+    """触发 Credit Note 蓝冲匹配任务。
+
+    POST /v2/invoice-requests/match-cn/{invoiceRequestId}/run
+    """
+    status, body = get_client().post(
+        f"/v2/invoice-requests/match-cn/{invoice_request_id}/run",
+        json={"reasonCode": reason_code},
+    )
+    print_result(status, body, output)
+
+
+@app.command("match-cn-results")
+def match_cn_results(
+    invoice_request_id: str = typer.Argument(..., help="申请单 ID"),
+    output: str = typer.Option("json", "-o"),
+):
+    """查询 Credit Note 蓝冲匹配结果。
+
+    GET /v2/invoice-requests/{invoiceRequestId}/matchResults
+    """
+    status, body = get_client().get(f"/v2/invoice-requests/{invoice_request_id}/matchResults")
+    print_result(status, body, output)
+
+
+@app.command("match-cn-unlink")
+def match_cn_unlink(
+    invoice_request_id: str = typer.Argument(..., help="申请单 ID"),
+    output: str = typer.Option("json", "-o"),
+):
+    """解除 Credit Note 蓝冲匹配绑定。
+
+    POST /v2/invoice-requests/match-cn/{invoiceRequestId}/unlink
+    """
+    status, body = get_client().post(
+        f"/v2/invoice-requests/match-cn/{invoice_request_id}/unlink"
+    )
+    print_result(status, body, output)

cli/commands/invoice_doc.py

@@ -0,0 +1,104 @@
+"""invoice (发票) 命令组 — 区别于 invoice-request。"""
+from __future__ import annotations
+
+import httpx
+import typer
+from pathlib import Path
+from typing import Optional
+from cli.config import BASE_URL, REQUEST_TIMEOUT
+from cli.session import get_client
+from cli.output import print_result, console
+
+app = typer.Typer(help="发票管理 (V2)")
+
+
+@app.command("get")
+def invoice_get(
+    invoice_id: str = typer.Argument(..., help="发票 ID"),
+    output: str = typer.Option("json", "-o"),
+):
+    """查询发票详情。
+
+    GET /v2/invoices/{invoiceId}
+    """
+    status, body = get_client().get(f"/v2/invoices/{invoice_id}")
+    print_result(status, body, output)
+
+
+@app.command("file-link")
+def invoice_file_link(
+    invoice_id: str = typer.Argument(..., help="发票 ID"),
+    file_type: str = typer.Option("Humanreadable", "--type",
+                                   help="Humanreadable(PDF) / Target(电子发票) / Source(KDUBL)"),
+    file_format: str = typer.Option("xml", "--format", help="xml / json"),
+    link_type: str = typer.Option("EXTERNAL", "--link-type", help="EXTERNAL / INTERNAL"),
+    expiry_days: int = typer.Option(7, "--expiry-days"),
+    output: str = typer.Option("json", "-o"),
+):
+    """获取发票文件下载链接。
+
+    GET /v2/invoices/file-link/{invoiceId}
+    """
+    params = {
+        "fileType":   file_type,
+        "fileFormat": file_format,
+        "linkType":   link_type,
+        "expiryDays": expiry_days,
+    }
+    status, body = get_client().get(f"/v2/invoices/file-link/{invoice_id}", params=params)
+    print_result(status, body, output)
+
+
+@app.command("cancel")
+def invoice_cancel(
+    invoice_id: str = typer.Argument(..., help="发票 ID"),
+    reason: str = typer.Option(..., "--reason", help="取消原因（MY 发票必填，72小时内）"),
+    output: str = typer.Option("json", "-o"),
+):
+    """取消发票（仅支持马来西亚 MY，72小时内）。
+
+    POST /v1/invoice/{invoiceId}/cancel
+    """
+    status, body = get_client().post(f"/v1/invoice/{invoice_id}/cancel", json={"reason": reason})
+    print_result(status, body, output)
+
+
+@app.command("download")
+def invoice_download(
+    invoice_id: str = typer.Argument(..., help="发票 ID"),
+    file_type: str = typer.Option("Source", "--type",
+                                   help="Humanreadable(PDF) / Target(电子发票) / Source(KDUBL XML)"),
+    file_format: str = typer.Option("xml", "--format", help="xml / json"),
+    out: str = typer.Option(".", "--out", "-o", help="保存目录，默认当前目录"),
+    filename: Optional[str] = typer.Option(None, "--name", "-n", help="文件名，默认用 invoiceId"),
+):
+    """直接下载发票文件到本地。
+
+    使用内部接口 /v1/invoices/file/{invoiceId} 下载原始文件。
+    """
+    client = get_client()
+    token = client.headers.get("Authorization", "").removeprefix("Bearer ")
+    company = client.headers.get("X-Company-ID", "") or client.headers.get("X-Company-Id", "")
+
+    headers = {"Authorization": f"Bearer {token}", "X-Company-Id": company}
+    params = {"filetype": file_type, "fileFormat": file_format}
+
+    resp = httpx.get(
+        f"{BASE_URL}/v1/invoices/file/{invoice_id}",
+        headers=headers,
+        params=params,
+        timeout=REQUEST_TIMEOUT,
+    )
+
+    ct = resp.headers.get("content-type", "")
+    if resp.status_code != 200 or ("xml" not in ct and not resp.content.strip().startswith(b"<")):
+        console.print(f"[red]下载失败（HTTP {resp.status_code}）：{resp.content[:200]}[/red]")
+        raise typer.Exit(1)
+
+    ext = ".pdf" if file_type == "Humanreadable" else f".{file_format}"
+    name = filename or f"{invoice_id}{ext}"
+    out_path = Path(out).expanduser() / name
+    out_path.parent.mkdir(parents=True, exist_ok=True)
+    out_path.write_bytes(resp.content)
+
+    console.print(f"[green]✓ 已下载：{out_path}（{len(resp.content)} 字节）[/green]")

cli/commands/login.py

@@ -0,0 +1,82 @@
+"""login / logout 命令。"""
+from __future__ import annotations
+
+import os
+import typer
+from rich.console import Console
+from cli.token_store import save_token, clear_token, load_token
+from cli.auth import fetch_token
+from cli.session import reset_client
+
+app = typer.Typer(help="登录与认证管理", invoke_without_command=True)
+console = Console()
+
+
+@app.callback(invoke_without_command=True)
+def login(
+    ctx: typer.Context,
+    domain: str = typer.Option(None, "--domain", help="租户域名，如 kingdee-fpy"),
+    app_id: str = typer.Option(None, "--app-id", help="应用 ID"),
+    secret: str = typer.Option(None, "--secret", help="应用密钥"),
+    mobile: str = typer.Option(None, "--mobile", help="手机号"),
+    org_num: str = typer.Option(None, "--org-num", help="组织编号"),
+    base_url: str = typer.Option(None, "--url", help="服务地址，如 http://host:port/xm-demo"),
+):
+    """登录并保存凭证到 ~/.elc/token.json。
+
+    凭证可通过选项传入，也可以交互式输入。已有 .env.local 配置的字段可直接回车跳过。
+    """
+    if ctx.invoked_subcommand is not None:
+        return
+
+    import cli.config as cfg
+
+    console.print("[bold cyan]ELC Invoice Engine CLI — 登录[/bold cyan]")
+    console.print("已有 .env.local 配置的字段可直接回车跳过\n")
+
+    # 覆盖配置（命令行优先，其次交互，再次 .env.local）
+    def _ask(label: str, current: str, opt_val: str | None, secret_input: bool = False) -> str:
+        if opt_val:
+            return opt_val
+        display = f"[dim]{current}[/dim]" if current else "[dim](未配置)[/dim]"
+        prompt = f"{label} {display}"
+        val = typer.prompt(prompt, default="", hide_input=secret_input, show_default=False)
+        return val.strip() or current
+
+    if base_url:
+        os.environ["BASE_URL"] = base_url
+        cfg.BASE_URL = base_url.rstrip("/")
+
+    cfg.SSO_CONFIG["domain"]      = _ask("租户域名    (domain)   ", cfg.SSO_CONFIG["domain"], domain)
+    cfg.SSO_CONFIG["app_id"]      = _ask("应用 ID     (appId)    ", cfg.SSO_CONFIG["app_id"], app_id)
+    cfg.SSO_CONFIG["secret"]      = _ask("应用密钥    (secret)   ", cfg.SSO_CONFIG["secret"], secret, secret_input=True)
+    cfg.SSO_CONFIG["mobile"]      = _ask("手机号      (mobile)   ", cfg.SSO_CONFIG["mobile"], mobile)
+    cfg.SSO_CONFIG["org_num"]     = _ask("组织编号    (orgNum)   ", cfg.SSO_CONFIG["org_num"], org_num)
+
+    console.print("\n正在登录...")
+    try:
+        token, expires_in = fetch_token()
+        save_token(token, expires_in)
+        reset_client()
+        console.print(f"[green]✓ 登录成功[/green]，token 已保存至 ~/.elc/token.json（有效期 {expires_in // 3600}h）")
+    except Exception as e:
+        console.print(f"[red]✗ 登录失败：{e}[/red]")
+        raise typer.Exit(1)
+
+
+@app.command("logout")
+def logout():
+    """清除本地保存的 token。"""
+    clear_token()
+    reset_client()
+    console.print("[green]✓ 已退出登录[/green]")
+
+
+@app.command("status")
+def status():
+    """查看当前登录状态。"""
+    token = load_token()
+    if token:
+        console.print(f"[green]✓ 已登录[/green]，token 前缀：{token[:20]}...")
+    else:
+        console.print("[yellow]未登录或 token 已过期[/yellow]，请运行 elc login")

cli/commands/party.py

@@ -0,0 +1,72 @@
+"""party V2 命令组。"""
+from __future__ import annotations
+
+import json
+import typer
+from typing import Optional
+from cli.session import get_client
+from cli.output import print_result
+
+app = typer.Typer(help="注册主体（Party）管理 - V2")
+
+
+@app.command("list")
+def party_list(
+    keyword: Optional[str] = typer.Option(None, "-k", "--keyword", help="关键字搜索"),
+    type: Optional[int] = typer.Option(None, "--type", help="主体类型：1=供应商 2=客户"),
+    page: int = typer.Option(1, help="页码"),
+    page_size: int = typer.Option(20, "--page-size"),
+    output: str = typer.Option("table", "-o"),
+):
+    """查询注册主体列表。"""
+    payload = {"pageNum": page, "pageSize": page_size}
+    if keyword:
+        payload["keyword"] = keyword
+    if type is not None:
+        payload["type"] = type
+    status, body = get_client().post("/api/party/page", json=payload)
+    print_result(status, body, output, rows_key="rows",
+                 columns=["id", "name", "organizationNo", "country", "type", "status"])
+
+
+@app.command("get")
+def party_get(
+    id: int = typer.Argument(..., help="主体 ID"),
+    output: str = typer.Option("json", "-o"),
+):
+    """查询注册主体详情。"""
+    status, body = get_client().get(f"/api/party/{id}")
+    print_result(status, body, output)
+
+
+@app.command("upsert")
+def party_upsert(
+    file: Optional[str] = typer.Option(None, "-f", "--file", help="JSON 文件路径"),
+    data: Optional[str] = typer.Option(None, "-d", "--data", help="内联 JSON 字符串"),
+    output: str = typer.Option("json", "-o"),
+):
+    """创建或更新注册主体（传入 JSON）。
+
+    示例：
+      elc party upsert -f party.json
+      elc party upsert -d '{"type":1,"name":"ACME","country":"DE",...}'
+    """
+    if file:
+        with open(file) as f:
+            payload = json.load(f)
+    elif data:
+        payload = json.loads(data)
+    else:
+        typer.echo("需要 --file 或 --data 参数", err=True)
+        raise typer.Exit(1)
+    status, body = get_client().post("/v2/parties/create-or-update", json=payload)
+    print_result(status, body, output)
+
+
+@app.command("delete")
+def party_delete(
+    id: int = typer.Argument(..., help="主体 ID"),
+):
+    """删除注册主体。"""
+    status, body = get_client().delete(f"/api/party/{id}")
+    print_result(status, body, "json")

cli/commands/product.py

@@ -0,0 +1,67 @@
+"""product V2 命令组。"""
+from __future__ import annotations
+
+import json
+import typer
+from typing import Optional
+from cli.session import get_client
+from cli.output import print_result
+
+app = typer.Typer(help="商品/物料管理 - V2")
+
+
+@app.command("list")
+def product_list(
+    keyword: Optional[str] = typer.Option(None, "-k", "--keyword"),
+    category: Optional[str] = typer.Option(None, "--category", help="GOODS / SERVICE"),
+    page: int = typer.Option(1),
+    page_size: int = typer.Option(20, "--page-size"),
+    output: str = typer.Option("table", "-o"),
+):
+    """查询商品列表。"""
+    payload: dict = {"pageNum": page, "pageSize": page_size}
+    if keyword:
+        payload["keyword"] = keyword
+    if category:
+        payload["categoryType"] = category
+    status, body = get_client().post("/api/product/page", json=payload)
+    print_result(status, body, output, rows_key="rows",
+                 columns=["id", "productCode", "productName", "uomCode", "categoryType", "status"])
+
+
+@app.command("get")
+def product_get(
+    id: int = typer.Argument(...),
+    output: str = typer.Option("json", "-o"),
+):
+    """查询商品详情。"""
+    status, body = get_client().get(f"/api/product/{id}")
+    print_result(status, body, output)
+
+
+@app.command("upsert")
+def product_upsert(
+    file: Optional[str] = typer.Option(None, "-f", "--file"),
+    data: Optional[str] = typer.Option(None, "-d", "--data"),
+    output: str = typer.Option("json", "-o"),
+):
+    """创建或更新商品（传入 JSON）。"""
+    if file:
+        with open(file) as f:
+            payload = json.load(f)
+    elif data:
+        payload = json.loads(data)
+    else:
+        typer.echo("需要 --file 或 --data 参数", err=True)
+        raise typer.Exit(1)
+    status, body = get_client().post("/v2/products/create-or-update", json=payload)
+    print_result(status, body, output)
+
+
+@app.command("delete")
+def product_delete(
+    id: int = typer.Argument(...),
+):
+    """删除商品。"""
+    status, body = get_client().delete(f"/api/product/{id}")
+    print_result(status, body, "json")

cli/commands/tax.py

@@ -0,0 +1,67 @@
+"""tax-category 命令组。"""
+from __future__ import annotations
+
+import json
+import typer
+from typing import Optional
+from cli.session import get_client
+from cli.output import print_result
+
+app = typer.Typer(help="税目管理")
+
+
+@app.command("list")
+def tax_list(
+    country: Optional[str] = typer.Option(None, "--country", help="国家代码，如 MY"),
+    keyword: Optional[str] = typer.Option(None, "-k", "--keyword"),
+    page: int = typer.Option(1),
+    page_size: int = typer.Option(20, "--page-size"),
+    output: str = typer.Option("table", "-o"),
+):
+    """查询税目列表。"""
+    payload = {"pageNum": page, "pageSize": page_size}
+    if country:
+        payload["country"] = country
+    if keyword:
+        payload["keyword"] = keyword
+    status, body = get_client().post("/api/taxCategory/page", json=payload)
+    print_result(status, body, output, rows_key="rows",
+                 columns=["id", "code", "name", "country", "taxType", "schemeId"])
+
+
+@app.command("get")
+def tax_get(
+    id: int = typer.Argument(...),
+    output: str = typer.Option("json", "-o"),
+):
+    """查询税目详情。"""
+    status, body = get_client().get(f"/api/taxCategory/{id}")
+    print_result(status, body, output)
+
+
+@app.command("create")
+def tax_create(
+    file: Optional[str] = typer.Option(None, "-f", "--file"),
+    data: Optional[str] = typer.Option(None, "-d", "--data"),
+    output: str = typer.Option("json", "-o"),
+):
+    """新增税目（传入 JSON）。"""
+    if file:
+        with open(file) as f:
+            payload = json.load(f)
+    elif data:
+        payload = json.loads(data)
+    else:
+        typer.echo("需要 --file 或 --data 参数", err=True)
+        raise typer.Exit(1)
+    status, body = get_client().post("/api/taxCategory", json=payload)
+    print_result(status, body, output)
+
+
+@app.command("delete")
+def tax_delete(
+    id: int = typer.Argument(...),
+):
+    """删除税目。"""
+    status, body = get_client().delete(f"/api/taxCategory/{id}")
+    print_result(status, body, "json")