コンテンツにスキップ

myclinic-next ドキュメント

stamp-pdf

stamp-pdf¶

portal-tmp ディレクトリにある既存の PDF に、印影（スタンプ）画像を重ねて押印するエンドポイントです。押印後、元のファイルにそのまま上書きします（in place）。

主な用途は領収書 PDF への「領収印」の押印で、create-pdf-file で PDF を生成したあとに呼び出します。

リクエスト¶

項目	内容
メソッド	`POST`
パス	`/api/stamp-pdf`

クエリパラメータ¶

名前	必須	意味
`file-name`	○	`portal-tmp` 内の対象 PDF ファイル名（パス区切りを含めない）
`stamp`	○	スタンプ定義名（例: `receipt`）。パス区切りを含めない

スタンプ定義¶

スタンプは設定ディレクトリ配下の ${MYCLINIC_DATA_DIR}/config/stamp-data/ に置きます。

${stamp}.yml … スタンプ定義ファイル
定義ファイル内の imageFile … 同ディレクトリ内の画像ファイル（PNG / JPEG）

定義ファイルの例（`receipt.yml`）¶

imageFile: "receipt-stamp.png"
scale: 0.70                   # 画像ピクセル寸法にかける倍率
xPos: 121                     # mm
yPos: 18                      # mm
isImageCenterRelative: true   # true の場合 (xPos, yPos) は画像の中心

座標系は左下原点。isImageCenterRelative: true のときは (xPos, yPos) が画像中心、false のときは画像の左上隅の位置になります。描画サイズ（ポイント）は「画像ピクセル寸法 × scale」です。

レスポンス¶

成功時は true を返します。

true

エラー¶

ステータス	意味
`400`	`file-name` または `stamp` が未指定、または名前が不正
`503`	スタンプ定義・画像・対象 PDF の読み込みや書き込みに失敗
`500`	その他の予期しないエラー