---
name: clock-invoice
description: Clockインボイス（docs.clock-clock.biz）で、請求書・領収書・見積書をURLパラメータから作成する。「請求書を作って」「見積書を作って」「領収書を出して」「Clockインボイスで」などの依頼で使う。会員登録不要で、生成したURLを開くと書類が表示される。
---

# Clockインボイスで書類を作る

ユーザーの依頼から、Clockインボイスの書類をそのまま開けるURLを作る。

## 手順

1. 仕様書を読む: https://docs.clock-clock.biz/invoice/developer/developer_guide.md
   読めない場合は、下の「要点」に従う。
2. 依頼から、請求先・品目・金額・日付・書類の種類（請求書／領収書／見積書）を取り出す。
3. 請求先名、品目と金額がわからないときは、URLを作る前にユーザーに質問する。発行者情報や振込先がわからないときは空欄のまま作り、あとで画面上で入力できることを伝える。
4. URLを作り、コードブロックでそのまま出す。

## 要点

- ベースURL: `https://docs.clock-clock.biz/invoice/`
- 主なパラメータ: `clientName`（請求先。敬称は入れない）、`clientHonorific`（会社なら「御中」、個人なら「様」）、`issuerName`、`items`、`issueDate`、`paymentDeadline`（`YYYY-MM-DD`）、`docType`（`invoice` / `receipt` / `estimate`）、`mode=preview`
- `items` は JSON 配列: `[{"description":"品目名","quantity":1,"price":100000,"taxRate":0.1}]`
  - `price` は税抜の単価。「税込」と言われたら税抜に戻す（税込11,000円 → `price` 10000）。
  - `taxRate` は `0.1`（10%）、`0.08`（軽減税率）、`0`（非課税）。
- 「来月末」などの日付は、今日を基準に具体的な日付にする。
- 源泉徴収が必要なときは `withholdingTax=true`。

## 出力のルール

- Markdownのリンク記法（`[文字](URL)`）は使わない。JSONを含むURLが壊れるため。
- URLはコードブロックで、そのまま1本出す。
- URLの下に、請求先・合計金額・支払期限を短く添えて、ユーザーが中身を確認できるようにする。
