TROCCOがStripeのデータ転送に対応しました
Stripeとは?
Stripeは、オンライン決済処理を提供するSaaS（Software as a Service）です。企業や個人が簡単にクレジットカード決済や銀行振込、デジタルウォレット（Apple Pay, Google Pay など）を導入できるプラットフォームです!
TROCCOとは?
TROCCOは、データの連携・変換をスムーズに実現するクラウド型データ統合ツールです。
執筆者はTROCCOのカスタマーサクセスエンジニアをしています。
TROCCOでStripe??何ができるの??
コードを書かずに、Stripe APIから抽出したデータを
任意のサービスにデータを転送することができます。
次の2ステップでStripe→DWHへのデータ転送が可能です。
- 画面上でStripeから取得したいデータを選ぶ
- データの格納先の情報を入れる（今回はSnowflakeのテーブル）
プレビューが表示されるので、そのまま保存。
設定を作成したら、実行。
Snowflakeにデータが格納されました!!
TROCCOの転送元Stripeで取得できるもの
2025/02現在、以下のエンドポイントからデータを取得可能です。
※まとめをAIにお任せしたので、間違いがあるかもしれません
| API名（英語） | 管理画面上の表示（日本語） |
|---|---|
| Customers | 顧客 |
| Checkout Sessions | チェックアウトセッション |
| Setup Attempts | セットアップ試行 |
| Accounts | アカウント |
| Shipping Rates | 配送料 |
| Balance Transactions | 残高取引 |
| Files | ファイル |
| File Links | ファイルリンク |
| Refunds | 返金 |
| Payment Methods | 支払い方法 |
| Credit Notes | クレジットノート |
| Early Fraud Warning | 早期不正警告 |
| Authorizations | 認証 |
| Cardholders | カード所有者 |
| Charges | 支払い |
| Coupons | クーポン |
| Disputes | 支払い異議 |
| Application Fees | アプリケーション手数料 |
| Invoices | 計算書 |
| Invoice Items | 計算書アイテム |
| Payouts | 振込 |
| Plans | プラン |
| Prices | 価格 |
| Products | 商品 |
| Reviews | レビュー |
| Subscriptions | 定期支払い |
| Subscription Schedule | 定期支払いスケジュール |
| Transfers | 振替 |
| Payment Intents | 支払いインテント |
| Promotion Codes | プロモーションコード |
| Setup Intents | セットアップインテント |
| Transactions | 取引 |
| Top-ups | チャージ |
| Subscription Items | 定期支払いアイテム |
| External Accounts | 外部アカウント |
| Customer Balance Transactions | 顧客残高取引 |
| Person | 個人 |
| Cards | カード |
| Application Fee Refunds | アプリケーション手数料の返金 |
| Bank Accounts | 銀行口座 |
| Invoice Line Item | 計算書明細項目 |
| Transfer Reversals | 振替の取消 |
TROCCOを使って、Stripeの請求データをSnowflakeに転送してみます!!
（スクリーンショットはsandbox環境です）
TROCCOを使って請求書データをSnowflakeに転送する
invoice（請求書）のデータを抽出するよう指定します。画面から選ぶだけです。
Snowflakeの設定はこのような感じです。
TROCCO上でデータの加工もできますが、今回はなにもせず、そのままの形で転送します。
ジョブを実行して、データ転送は完了です。
参考）invoiceのカラム一覧
| カラム名 | 日本語訳 |
|---|---|
| id | ID |
| object | オブジェクト |
| auto_advance | 自動更新 |
| automatic_tax | 自動税計算 |
| charge | チャージ |
| collection_method | 収集方法 |
| currency | 通貨 |
| customer | 顧客 |
| description | 説明 |
| hosted_invoice_url | 請求書URL |
| lines | 明細行 |
| metadata | メタデータ |
| payment_intent | 支払いインテント |
| period_end | 期間終了 |
| period_start | 期間開始 |
| status | ステータス |
| subscription | サブスクリプション |
| account_country | アカウント国 |
| account_name | アカウント名 |
| account_tax_ids | アカウント税ID |
| amount_due | 支払金額 |
| amount_paid | 支払済み金額 |
| amount_remaining | 残額 |
| amount_shipping | 送料 |
| application | アプリケーション |
| application_fee_amount | アプリケーション手数料 |
| attempt_count | 試行回数 |
| attempted | 試行済み |
| automatically_finalizes_at | 自動確定時刻 |
| billing_reason | 請求理由 |
| created | 作成日時 |
| custom_fields | カスタムフィールド |
| customer_address | 顧客住所 |
| customer_email | 顧客メール |
| customer_name | 顧客名 |
| customer_phone | 顧客電話番号 |
| customer_shipping | 顧客配送情報 |
| customer_tax_exempt | 顧客の税免除 |
| customer_tax_ids | 顧客税ID |
| default_payment_method | デフォルト支払い方法 |
| default_source | デフォルトの支払い元 |
| default_tax_rates | デフォルト税率 |
| discount | 割引 |
| discounts | 割引一覧 |
| due_date | 期限日 |
| effective_at | 適用日時 |
| ending_balance | 期末残高 |
| footer | フッター |
| from_invoice | 元の請求書 |
| invoice_pdf | 請求書PDF |
| issuer | 発行者 |
| last_finalization_error | 最終確定エラー |
| latest_revision | 最新の改訂 |
| livemode | ライブモード |
| next_payment_attempt | 次回支払い試行日時 |
| number | 請求書番号 |
| on_behalf_of | 代理請求先 |
| paid | 支払い済み |
| paid_out_of_band | 手動支払い済み |
| payment_settings | 支払い設定 |
| post_payment_credit_notes_amount | 支払い後のクレジットメモ金額 |
| pre_payment_credit_notes_amount | 支払い前のクレジットメモ金額 |
| quote | 見積もり |
| receipt_number | 領収書番号 |
| rendering | 表示設定 |
| shipping_cost | 送料 |
| shipping_details | 配送詳細 |
| starting_balance | 期首残高 |
| statement_descriptor | 明細記載情報 |
| status_transitions | ステータス遷移 |
| subscription_details | サブスクリプション詳細 |
| subscription_proration_date | サブスクリプション日割り適用日 |
| subtotal | 小計 |
| subtotal_excluding_tax | 税抜小計 |
| tax | 税額 |
| test_clock | テストクロック |
| threshold_reason | 閾値理由 |
| total_discount_amounts | 割引合計 |
| total_excluding_tax | 税抜合計 |
| total_tax_amounts | 税合計 |
| transfer_data | 振替データ |
| webhooks_delivered_at | Webhook配信日時 |
Snowflake上で請求書データから未払請求書を特定してみる
クエリを書いて、TROCCOで転送したデータから未払請求書のデータを取り出してみます。
未払いの請求書は、statusがopenまたはuncollectibleのものを指します。
| ステータス | 説明 |
|---|---|
draft |
下書き状態（顧客には未送信） |
open |
発行済み・未払いの状態 |
paid |
支払い完了 |
uncollectible |
未回収（回収不能と判断されたもの） |
void |
無効化された請求書（支払い不可） |
詳しくはこちら
https://docs.stripe.com/invoicing/overview?locale=ja-JP#invoice-lifecycle
クエリ
SELECT
"id",
"customer",
"amount_due",
"currency",
"due_date",
"status",
TO_TIMESTAMP("due_date"),
CURRENT_TIMESTAMP
FROM DEMO_SHANAI.PUBLIC."demotable_stripe_invoice"
WHERE
("status" = 'open' AND TO_TIMESTAMP("due_date") < CURRENT_TIMESTAMP())
OR
("status" = 'uncollectible')
ORDER BY "due_date" ASC;
ポイント
- 画面上Past Due（期限切れ未払い）と表示されているものの、status値はopen
- 期限（due_date）と現在日付を比較し抽出する必要がある
- 期限（due_date）はUNIXTIME
実行結果
未払いの請求書を特定することができました!!
※uncollectibleのテストデータは作れませんでした…
取得したIDを画面から検索しましたが、Past Due（期限切れ未払い）のものが取得できています
まとめ
いかがでしたでしょうか。TROCCOを利用することで、Stripeから簡単にデータを転送できました
今回はStripeのデータを単体でクエリしましたが、Salesforce等の営業データと組み合わせることで、収益・顧客行動・営業の成果分析にも繋げられそうと思いました。
この記事を見てくださった方に、なにか少しでもお役に立てていたらならば幸いです🙏