請求書PDFをkintone請求書管理アプリに登録する手順

概要

invoices フォルダ内の請求書PDF（複数件）を読み取り、内容を検算したうえで、kintoneの「請求書管理」アプリに1請求書＝1レコードとして登録する作業手順。

• kintone: https://qm4b01y687b5.cybozu.com/k/96/（アプリID 96）
• 対象フォルダ: /Users/ryo/claude/demo/invoices/（ファイル名例: 請求書_01_株式会社サンライズ商事.pdf）

フロー図

前提

• ユーザーのPCがリンクされ、demo フォルダが接続されていること（PC上のシェルで作業する）。
• kintone MCPコネクタ（KintoneMCPServer）が接続されていること。

手順

1. PDFの一覧化とテキスト抽出

• PC上のシェルで invoices フォルダを一覧し、pdftotext -layout で全PDFのテキストを抽出する（ファイルを取り込まずにPC上で処理する）。
• レイアウトの都合で文字が途切れたり崩れたりしている箇所は、そのPDFだけ取り込んで画像で目視確認する。

2. 項目の抽出

• 請求元（取引先名・住所・登録番号）、請求書番号、発行日、支払期限、振込先、明細、小計、消費税、合計（税込）。

3. 検算

• 明細の数量×単価、小計、消費税（10%）、合計を再計算し、PDFの記載と一致するか確認する。全件の合計金額も出す。

4. 読み取り結果の報告

• 一覧表（請求元・請求書番号・発行日・支払期限・税込金額・主な内容）と合計を示す。
• あわせて、次のような要確認事項を挙げる。
• • 支払期限を過ぎているもの・期限が近いもの（当日の日付と比べる）
  • 振込先が個人名の取引先（個人事業主の場合、デザイン料などは源泉徴収が必要なことがある）
  • 単価や計算根拠に不明点がある明細

5. kintoneアプリの確認

• kintone-get-form-fields（app: 96）でフィールド定義を取得する。
• kintone-get-records で既存レコードを取得し、請求書番号が同じものがあれば登録しない（重複登録の防止）。

6. 一括登録（kintone-add-records、最大100件/回）。フィールドの対応は次のとおり。

7. 登録後の突合

• kintone-get-records で再取得し、件数・各レコードの金額・合計金額がPDFと一致するか確認する。

8. 修正が必要な場合

• kintone-update-records で、対象レコードの id と revision を指定して更新する（他の人の更新を上書きしないため）。

9. 報告

• 登録件数、レコード番号、合計金額、フィールドの対応、要確認事項を簡潔に伝える。

注意点

• Chromeからの代替手段を使う場合は、kintoneへのログインが必要。パスワードはClaudeが入力せず、ユーザーにログインしてもらう。
• 振込先の口座名義がPDF上で途中で切れている場合は、口座番号までを登録する（例: 三菱UFJ銀行 五反田支店 普通 7788990）。
• アプリには支払期限・税抜金額・消費税額のフィールドがない。管理が必要ならフィールドの追加をユーザーに提案する。
• 取引年月日に発行日以外（納品日・検収日など）を入れたい場合はユーザーの指定に従う。
• 請求書PDFのファイル自体は変更・削除しない。