square-import

Square インポート

概要

Square POS の CSV エクスポートから取引データをインポートします。売上、チップ、返金、Square の決済処理手数料に対応しています。Square の商品ごとの詳細を Open Accountant の取引形式に変換します。

使用する Wilson ツール

• transaction_search — 既存の Square 取引を確認し、重複を防ぎます
• categorize — インポートした Square 取引にカテゴリを割り当てます
• export_transactions — 照合済みの Square データをエクスポートします

列の対応付け

Square CSV の列	Open Accountant のフィールド	備考
Date	date	取引日
Time	—	保存されません
Transaction ID	reference_id	重複排除用の Square 決済 ID
Description or Item	description	商品または決済の説明
Gross Sales	amount	手数料控除前の合計額（正の値 = 収入）
Tips	amount（別の行）	チップ額（正の値 = 収入）
Processing Fees	amount（別の行）	Square の手数料（負の値 = 経費）
Refunds	amount（別の行）	返金額（負の値）
Net Sales	—	計算値。直接保存されません
Payment Method	notes	現金、カードなど

ワークフロー

1. Square CSV ファイルのパスをユーザーに尋ねます。
2. CSV を解析し、Square の列ヘッダーを検証します。
3. 取引の各行について、最大 4 件のエントリを作成します。
   • 売上：総売上額（正の値）、カテゴリ「Revenue:Sales」
   • チップ：チップ額（正の値）、カテゴリ「Revenue:Tips」（$0 より大きい場合）
   • 手数料：決済処理手数料（負の値）、カテゴリ「Fees:Payment Processing」（$0 より大きい場合）
   • 返金：返金額（負の値）、カテゴリ「Revenue:Refunds」（$0 より大きい場合）
4. 現金取引の決済処理手数料は $0 ですが、売上はインポートします。
5. Square Transaction ID を使用して重複を排除します。
6. インポートの概要をプレビューします。売上合計、チップ合計、手数料合計、返金合計、純額が表示されます。
7. 取引を登録して確認します。

Wilson を使わない場合

Square のエクスポートを手動で処理する方法：

Square からダウンロードする

1. squareup.com（Square Dashboard）にログインします
2. Transactions（左側のサイドバー）に移動します
3. Export（右上、またはダウンロードアイコン）をクリックします
4. 期間を選択します
5. Transactions CSV を選択します（Items CSV ではありません。こちらは在庫用です）
6. ダウンロードします
7. 別の方法：Reporting > Sales > Export で概要レベルのデータをエクスポートします

スプレッドシートで手動処理する

1. CSV を Google Sheets または Excel で開きます。
2. 収益の種類ごとに分けます：
   • 列 E：Gross Sales（商品・サービスの収益）
   • 列 F：Tips（収入。一部の地域では売上と異なる税務上の扱いになります）
   • 列 G：Processing Fees（経費）
   • 列 H：Refunds（マイナスの収益）
3. カテゴリごとに行を作成します（または複数のカテゴリ列を使用します）：
   • チップが $0 より大きい行ごとに、チップ額の新しい行を作成します
   • 手数料が $0 より大きい行ごとに、マイナスの手数料を記録した新しい行を作成します
4. 集計用の数式：

   Gross Sales:       =SUM(E:E)
   Total Tips:        =SUM(F:F)
   Total Fees:        =SUM(G:G)
   Total Refunds:     =SUM(H:H)
   Net Revenue:       =GrossSales + Tips - Fees - Refunds
   Effective Fee %:   =TotalFees / (GrossSales + Tips) * 100
   Avg Transaction:   =GrossSales / COUNTA(D:D)
   

5. 銀行口座と照合します：Square は毎日または毎週、資金を入金します。入金日の間の純売上を合計し、銀行明細と照合します。

Square レポート（エクスポート不要）

Square Dashboard の Reporting > Sales Summary には、日、週、月ごとの総売上、手数料、純額を確認できるレポートが組み込まれています。エクスポートせずに手早く確認する場合に使用します。

重要な注意事項

• Square の CSV エクスポートには、取引レベルと商品レベルのものがあります。このスキルでは取引レベルのエクスポートを想定しています。商品レベルのエクスポートは販売ごとに商品 1 点につき 1 行となるため、まず Transaction ID でグループ化する必要があります。
• チップは売上収益とは税務上の扱いが異なる場合があるため、分けて記録します。
• POS で処理された現金取引も Square に表示されますが、決済処理手数料は $0 です。これらもインポートします。
• Square から銀行口座への入金額は、手数料を差し引いた額です。Square の収益として銀行口座の入金行をインポートしないでください。代わりにこのスキルを使って、内訳を総額で記録します。
• 対面販売とオンライン販売の両方で Square を使用している場合、どちらも同じエクスポートに表示されます。