明細のPDFをJSONに変換する手順
銀行明細のPDFをPivotBankにドロップします。解析はブラウザーの中ですぐに始まります
プレビューの表で、読み取った全取引を残高の推移と照らして確かめます
明細のロックを解除すると(買い切り、定期課金なし)JSONの書き出しが使えます
.jsonをダウンロードして、スクリプトやノートブック、アプリケーションから読み込みます
JSONに実際に入っているもの
- metadataブロック:bankName、accountNumber、period、transactionCount、ISO形式のexportedAt
- transactions配列:各行にdate、description、debit、credit、残高
- 取引ごとのカテゴリー。摘要から自動で振り分けるので、ご自身で分類する必要はありません
- insightsブロック:入出金の合計、カテゴリー別の支出、よく使う店舗、検出した定期支払い、日ごとの支出
- 素のUTF-8、インデントは半角スペース2つ。ほどく必要のある入れ物のオブジェクトはありません
- スキャンした明細や写真に撮った明細も、この処理の前にブラウザー内のOCRが読み取ります
CSVではなくJSONを選ぶ理由
CSVは明細行を渡してくれるだけで、そこで終わりです。次の一手がコードなら、ファイルを解析し、列の並びを推測し、数値に直し、自前の分類まで書いて、ようやくデータに面白い問いを1つ投げられます。
JSONの書き出しはそこを飛ばします。PivotBankがすでに済ませた分析、つまり取引ごとのカテゴリーと、そこから計算した集計値をそのまま運びます。銀行明細のAPIが返してくるものと同じ中身でありながら、明細はお使いの端末で解析され、誰かに解析させるためにアップロードされることはありません。
JSONに変換できる銀行は?
すべてです。パーサーは銀行名を探すのではなく明細のレイアウトを読み取るため、専用のガイドがない銀行でも同じように変換できます。以下はよくご要望いただくガイドで、それぞれの銀行で明細をダウンロードする方法と、変換で取り出せる項目を説明しています。
PDFからJSONへの変換によくある質問
JSONの構造はどうなっていますか。
最上位のキーは3つです。metadataにはbankName、accountNumber、period、transactionCount、exportedAtが入ります。transactionsは行の配列で、各行にdate、description、debit、credit、balance、categoryがあります。insightsには合計、カテゴリー別の支出、よく使う店舗、定期支払い、日ごとの支出が入ります。
銀行明細はサーバーにアップロードされますか。
いいえ。PDFはお使いの端末で開かれ、スキャンしたページのOCRも端末の中で動きます。JSONファイルもお使いの端末で作られます。保存されるのは、ご自身でロックを解除してアカウントに保存した明細だけで、それも読み取った取引データのみです。PDFが保存されることはありません。
APIはありますか。
はい、件数が多い場合向けにご用意しています。ProプランにはAPIアクセスと、多数の明細をまとめて処理する一括変換が含まれます。数件であれば、ここで変換してJSONをダウンロードするほうが早く、組み込みの作業もいりません。
料金はいくらですか。
プレビューは無料です。どの明細でも、残高と照合済みの最初の5行をご覧いただけます。JSONの書き出しは明細1件ごとの買い切りのロック解除に含まれ、1件あたり約2.99ドル、定期課金はありません。件数が多い場合はProプランでカバーします。
