TROCCOでSquareのデータを転送してみた

TROCCOが転送元Squareに対応しました!!

TROCCOとは?

クラウドETL（データ転送・データ変換）サービスです。
※筆者はTROCCOのカスタマーサクセスをしています。

🚀 Squareとは？

いわゆるPOSシステムの1つです。

↓の端末はお店でもよく見ますね。

スマホやタブレットを活用したクラウド型のPOSシステムで、最初は小規模ビジネス向けの決済サービスとしてスタートしましたが、今ではPOS、在庫管理、予約システム、オンライン販売など幅広いビジネス支援ツールを提供するプラットフォームとして活用されているようです。
POSアプリは無料で利用可能で、初期費用がかからないことも強みのひとつです

---

　TROCCOで取得できるSquareのデータ一覧（2025/03現在）

取得対象	APIエンドポイント	説明
支払い一覧	List Payments	支払いの一覧を取得します。
返金一覧	List Refunds	返金の一覧を取得します。
支払いリンク一覧	List Payment Links	支払いリンクの一覧を取得します。
チャージバック一覧	List Disputes	チャージバック（支払いの異議）の一覧を取得します。
チャージバック証拠一覧	List Dispute Evidence	特定のチャージバックに関連する証拠の一覧を取得します。
請求書一覧	List Invoices	請求書の一覧を取得します。
カード一覧	List Cards	カードの一覧を取得します。
サブスクリプション一覧	List Subscriptions	サブスクリプションの一覧を取得します。
注文一覧	Search Orders	注文の一覧を検索・取得します。
カタログ一覧	List Catalog	カタログオブジェクトの一覧を取得します。
在庫数一覧	Batch Retrieve Inventory Counts	在庫数の一覧をバッチで取得します。
顧客一覧	List Customers	顧客の一覧を取得します。
顧客カスタムフィールド一覧	List Customer Custom Attributes	顧客のカスタム属性の一覧を取得します。
スタッフ一覧	Search Team Members	スタッフ（チームメンバー）の一覧を検索・取得します。

※AIくんにまとめてもらったため、誤記載があるかもしれません。

　最もよく使われるであろう「支払い一覧（List Payments）」をTROCCOで連携してみます

接続情報の作成

まずはSquareの接続情報を作成します。詳しい作成方法は以下をご確認ください。

とはいえ、手順はとてもシンプルでした。

1️⃣ ログインする
2️⃣ +を押す

3️⃣ アプリの名前を決める

4️⃣ するとチェックボックスが表示されますが、何を選択しても大丈夫です。(それっぽいものを選択しました)

5️⃣アクセストークンが作成されるのでコピー。

6️⃣ TROCCOの接続情報に貼り付けて、保存。

---

転送設定の作成

転送設定として設定するのは、取得対象としたいエンドポイントだけです。

転送先(今回はSnowflake)の設定をしたら、プレビューを確認します。

---

転送する前に、プレビュー上で気になった項目をちょっと見てみます。

amount_money

tip_money を含まない、この支払いに処理された金額。つまり金額。

デフォルトではJSONの中に通貨と値が格納されています。

{"currency":"JPY","amount":85}

JSONはデータ転送後に展開してもいいですが、このくらいのJSONならTROCCOで展開したほうが楽かもしれません。
ということで、currencyとamountにそれぞれ展開します。

JSONカラムを展開に☑し、任意のカラム名を入力、カラム内のJSONからのJSONパスを指定します。
この場合はcurrencyとamountを入力すればOK。

展開できました。

---

tip_money

チップとして指定された金額。

---

total_money

amount_money および tip_money を含む支払総額。

---

cash_details

現金払いの詳細。source_type が CASH の場合のみ入力されます。
要するに、お預かり金額（buyer_supplied_money）と お釣り（change_back_money）の情報です。

こちらもJSONにまとめられています。

{"change_back_money":{"currency":"JPY","amount":0},"buyer_supplied_money":{"currency":"JPY","amount":85}}

TROCCO上で展開しようとすると、以下の様な設定になります。

それぞれのJSONパス設定は以下の通りです。

• buyer_supplied_money.currency
• buyer_supplied_money.amount
• change_back_money.currency
• change_back_money.amount

展開できました。

---

類似の項目

• bank_account_details（銀行支払詳細）
• card_details（カード払い詳細）
• external_details（外部支払い詳細）
• wallet_details（ウォレット払い詳細）

などがあります。
ギフトカードの支払いはexternal_details、ほにゃららPayはwallet_detailsに該当するようです。

---

設定を保存して、転送実行

転送先(Snowflake)へデータを転送することができました。

---

おわりに

今回はTROCCOを使って、Squareからデータを転送してみました。
Squareのデータは比較的シンプルな形式で、データ転送後の統合・分析にも利用しやすいと感じました。
天候データやCRMデータと組み合わせることで、より詳細な売上分析ができそうですね!!

---

TROCCOの最新アップデート情報はこちら