Yam’s Peace Blog

GnuCashとは

GnuCash はオープンソースの 複式簿記 による経理ソフトです。 Ledger-cliに比べると日本国内にも相当数のユーザが存在している気配があります 😄

今回は

アンドロイド版のGnuCashを
Ledger-cliと「組み合わせ」て使ってみます

具体的には

Ledger-cliのトランザクションを書くための手段＝ メモパッド として使ってみようと思います¹。

GnuCashを使おうと思った動機は：

• Emacs/Ledger-cliの入ったPCを常に持って歩くことはできないこと
• 領収書やレシートをもらえないケースがあること

の2つです。²

おもて経済 の取引では、さすがのOECD内のガラパゴス国ジャパンでも、ほぼ100%の支出に対してきちんとレシートとか領収書が戻ってきます。

しかし、いまだに 現金払い限定 で、かつレシートをもらえない「取引」も少なくはありません。たとえば³

葬儀の香典や祝い事のご祝儀
屋台で一杯飲んだとき
神社への初穂料や玉串料
お坊さんへのお布施
チップや「おひねり」
政治屋さんへの裏献金
etc …

これらの支出のたびごとに、 手帳 にメモを残せる几帳面な性格なら問題はありませんが、 ふつうの人 が後で思い出しながら転記しようと思っても、なかなかむずかしいです。

少し前までは、ボールペンで左手の 手の甲 に金額を書き込んでいました。最近はコロナ禍であちこちに手指消毒用のアルコール液が置いてあります。メモしたことを忘れて消毒すると、大事なメモはアルコールで跡形もなく消えてしまいます。

手帳 または 手の甲 にメモ書きする代わりに、タブレット（スマホ）で記帳しておいて、旅行や出張が終わった後に、自分のPCにそれらのトランザクションをインポートできれば、記憶力が減退し始めたスボラな性格の自分でも、いくらかちゃんとした転記ができるようになるかも知れません。 😉

GnuCashのインストールと設定

インストールは Google Playストア からダウンロードするだけ。

使い始めるためには、自分の アカウント （勘定科目）構造をGnuCashに入力します⁴。

Ledgerのアカウント構造は、XMLでGnuCashにエクスポートできるのかと思いましたが、ver.3 以降 のLedgerには対応していないようでした⁵。手動でやっても小一時間で終わるので、手入力しました⁶。

その際、アカウント（勘定科目）を細部まで完全に用意する必要はありません。まずはよく使うトランザクションに関係するアカウントだけを先に入力して、そうでないアカウントは、取引が発生したときにその都度一つずつ作ります。

準備作業はこれだけです。

GnuCashからのエクスポート

GnuCashトップ画面の左上にあるメニューアイコン（ ≡ ）で次のようなメニューを開きます。

上のメニューから「設定」を選び、設定画面（図2）を開きます。設定が必要なのはこの4,5項目だけです。

設定が終わったら、画面右上の「エクスポート」をタップします。これでエクスポートは完了です。

あとは出来上がったCSVを「参考資料（β版ソースコード）」節で紹介した gnucash2ledger.sh を使ってLedgerタイプのトランザクションに整形しなおすだけです。

gnucash2ledger.sh の使い方

ターミナル内で gnucash2ledger.sh を起動します。

$ gnucash2leddger.sh
 ** Saved in IMPed-TXN-f-GnuCash/20211129.ledger

コンバートされたLedger向けのトランザクションはつぎのような感じになります：

$ cd  IMPed-TXN-f-GnuCash
$ cat 20211129.ledger
2021/11/24 NEXCO
    ; 沼田IC～青梅IC
    Expenses:Cars:Toll 	3420 JPY
    Liabilities:OricoCard

2021/11/24 ENEOS SS
    Expenses:Cars:Gasoline 	6156 JPY
    Liabilities:EneosCard

2021/11/26 ダイエー
    ; バナナなど
    Liabilities:ResonaVisa:seiji 	-1112 JPY
    Expenses:Grocery:Food:YOk
   ：

補足・注記

• こうして作成したトランザクションをLedgerファイルの本体にコピペするなどして使います。
• 上の出力例ではアカウント名がすべて英文字ですが、これは単なる偶然です
• 金額のカラム位置が揃っていませんが、EmacsのLedger-modeを使えば簡単に揃います
• ソースターゲットの行の金額はインポートしていません。

参考資料（β版ソースコード）

GnuCashからLedgerにデータを移行するためのプログラムは、たとえばPythonをつかったgnucash2ledger.py とか、すでにいくつか存在しています。

今回のスクリプトは bash で短時間に書いたものです。先人のすぐれたプログラムのように多機能で広い適用範囲を持つものではありません。自分が使う最低限の機能だけを素朴にコーディングしました。ベータ版ですがとりあえず動いています 😄

#!/bin/bash
set -eu  # Time-stamp: <2021-11-29 09:33:29 yamagami>
#
#    GnuCashからDropboxにエクスポートされたCSVを
#    ledger-cliトランザクションに変換する
#

## 変数定義
commodity='JPY'
drop_dir='/home/yamagami/Dropbox/アプリ/GnuCash Android'
storage_dir='/home/yamagami/local-ledger-directory/IMPed-TXN-f-GnuCash'

## ファイル初期設定
cp /dev/null ./tmp-transaction.ledger

## Dropboxから最新のGnuCash CSVファイルを抽出する
latest_csv=$(ls -1t "${drop_dir}"/*.csv|head -1)

## ヘッダー行を削除
sed '1d' "${latest_csv}" > ./gnucash.csv

## ダブルクォーテーションに挟まれた文字列中のカンマを外す
gawk -F"\"" '{x=$2;gsub(",","",x);print $1"\""x"\""$3}' ./gnucash.csv > ./tmp-no-comma.csv

## ここから本体 (2行ずつ読み出す)
while read odd_line && read even_line
do
    # トランザクション1行目
    date=$(date -d  `echo ${odd_line} | awk -F"," '{print $1}'`  '+%Y/%m/%d')
    payee=$(echo ${odd_line} | awk -F"," '{print $4}')
    #
    echo "${date} ${payee}" > ./tmp-1st-line.txt

    # notesがあれば追加する
    notes=$(echo ${odd_line} | awk -F"," '{print $5}')
    if [ -n "${notes}" ]; then
	flg_notes='Y'
	echo "    ; ${notes}" > ./tmp-notes.txt
    else
	flg_notes=''
    fi

    # トランザクション2行目
    target_acnt=$(echo ${odd_line} | awk -F"," '{print $10}' )
    amount=$(echo `echo "${odd_line}" | awk -F"," '{print $13}'` |sed 's/\.[0-9,]*$//g')
    # JPYを追加
    j_amount="${amount} ${commodity}"
    echo -e "    "${target_acnt} "\t"${j_amount} > ./tmp-2nd-line.txt

    ## トランザクション3行目
    source_acnt=$(echo "${even_line}" | awk -F"," '{print $10}')
    echo -e "    ${source_acnt}\\n" > ./tmp-3rd-line.txt

    ## 合体してLedgerファイルにする
    if [ -z "${flg_notes}" ]; then
	cat ./tmp-1st-line.txt ./tmp-2nd-line.txt ./tmp-3rd-line.txt  >> ./tmp-transaction.ledger
    else
	cat ./tmp-1st-line.txt ./tmp-notes.txt ./tmp-2nd-line.txt ./tmp-3rd-line.txt  >> ./tmp-transaction.ledger
    fi
#
done < ./tmp-no-comma.csv

# インポートデータの保存
c_date=$(date '+%Y%m%d')
cp ./tmp-transaction.ledger ${storage_dir}/${c_date}.ledger
echo "** Saved in IMPed-TXN-f-GnuCash/${c_date}.ledger"

# 一時ファイルの削除
rm ./tmp-*.csv
rm ./tmp-*.txt
rm ./gnucash.csv
rm ./tmp-transaction.ledger
exit 0

Footnotes: