# Stripe Tax に取引をインポートする 外部プラットフォームから Stripe Tax に取引データをインポートします。 > [ログイン](https://dashboard.stripe.com/settings/tax)または[登録](https://dashboard.stripe.com/register)して、Stripe で Stripe Tax を有効にしてください。 CSV ファイルを使用して、サードパーティープラットフォームから Stripe Tax に取引データをインポートします。複数のプラットフォームからの売上データを統合することで、納税義務をまとめて把握し、法令遵守をシンプルにし、税務登録要件について十分な情報に基づいた意思決定を行うことができます。 外部プラットフォームから Stripe Tax に取引データをインポートすると、次のようなメリットが得られます。 - **納税義務の監視を統合**: Stripe 以外の取引を含むすべての販売チャネルのしきい値を監視します。 - **法令遵守をシンプルに**: 異なるプラットフォームからのデータを手動で照合して集計することを避けます。 - **しきい値の監視をより正確に**: 取引データを 1 ケ所に統合して、徴税を登録する必要がある場所を特定します。 - **データを柔軟に管理**: 過去の納税義務の履歴データをインポートするか、継続的な監視のために定期的なインポートを維持します。 ## 仕組み 取引データを Stripe Tax にインポートすると、次のようになります。 1. 外部プラットフォームから取引データをエクスポートします。 1. データを、項目あたり (取引あたりではなく) 1 行で CSV ファイルにフォーマットします。 1. [ダッシュボードから CSV ファイルを Stripe Tax にアップロード](https://docs.stripe.com/tax/imports.md#import-your-transaction-data)します。 1. Stripe Tax はデータを検証して処理します。 1. [レポート](https://docs.stripe.com/tax/reports.md)、[納税義務の監視](https://docs.stripe.com/tax/monitoring.md)、[申告と納付](https://docs.stripe.com/tax/filing.md)でインポートされた取引にアクセスします。 ## CSV ファイル形式の要件 CSV ファイルは、必須列を含む特定の形式に従う必要があります。各ファイルにヘッダー行を含めます。各行は、取引全体ではなく、項目を表します。1 つの取引が複数の商品または項目で構成されている場合は、各項目を CSV ファイルに個別の行として記載します。 ### 列リファレンス | 列名 | タイプ | 例 | | -------------------------------------- | -------------------------------------------------------- | ------------------------------------------- | | `source_transaction_id` | テキスト (必須) | `order_123abc` | 取引の一意の識別子 | | `transaction_type` | `Sale`、`Refund`、`Void` のいずれか (必須) | `Sale` | 取引のタイプ | | `transaction_version` | 数値 (オプション) | `1`、`1712863281` (Unix タイムスタンプ) | 取引の最新バージョンを指定する数値フィールド。デフォルトは `1` です。 | | `provider` | テキスト (必須) | `amazon`、`tax_jar`、`shopify` | 取引の外部ソース | | `liable_transaction_id` | テキスト (返金または無効化に必須) | `order_abc123` | この返金または無効化が処理しているソース取引 ID | | `tax_rules_at` | 日時 (形式: `yyyy-MM-dd HH:mm:ss z`) (必須) | `2024-02-22 18:42:47 UTC` | 納税義務が発生する日付 | | `created_at` | 日時 (形式: `yyyy-MM-dd HH:mm:ss z`) (必須) | `2024-02-22 18:42:47 UTC` | 取引作成日 | | `posted_at` | 日時 (形式: `yyyy-MM-dd HH:mm:ss z`) (必須) | `2024-02-22 18:42:47 UTC` | 債務が引き受けられるか軽減された日付 | | `currency` | 通貨コード (ISO 4217) (必須) | `USD`、`EUR`、`GBP` | 取引の売上処理通貨 | | `customer_id` | テキスト (オプション) | `cus_123` | Stripe の顧客 ID | | `tax_exempt` | `exempt`、`none`、`reverse` のいずれか (必須) | `exempt` | 取引の非課税ステータス | | `line_item.id` | テキスト (必須) | `item_123` | 項目の ID | | `line_item.amount` | 数値1 (オプション) | `150.50` | 割引適用後かつ**税金を含む項目の合計金額** | | `line_item.product_id` | テキスト (オプション) | `prod_123` | Stripe 製品 ID | | `line_item.product_name` | テキスト (オプション) | `Premium Widget` | ユーザー指定の商品名 | | `line_item.product_description` | テキスト (オプション) | `High-quality widget for premium customers` | 商品の詳細 (自由形式) | | `line_item.product_tax_code` | テキスト (必須) | `txcd_99999999` | この取引を分類する Stripe [商品税コード](https://docs.stripe.com/tax/tax-codes.md)。 | | `line_item.external_product_id` | テキスト (オプション) | `SKU123` | 外部商品 ID (加盟店 SKU など) | | `line_item.external_tax_code` | テキスト (オプション) | `TX456` | 商品の外部税コード | | `line_item.tax_behavior` | `exclusive` (デフォルト) または `inclusive` のいずれか (Optional) | `exclusive` | 項目の単価に対する税金の処理 | | `line_item.unit_amount` | 数値1 (必須) | `50.12` | 割引適用前、税抜き (外税の場合) または税込み (内税の場合) の単価 | | `line_item.quantity` | 数値 (小数値はサポートされています) (必須) | `1`、`2`、`3.5` | ユニットの数量 | | `line_item.amount_discount` | 数値1 (オプション) | `10.00` | 特定の項目の割引 | | `line_item.taxable_amount` | 数値1 (オプション) | `45.50` | 特定の項目の課税対象額 | | `line_item.tax_rate` | 数値 (オプション) | `0.08` | 項目レベルで集計された税率 | | `line_item.amount_tax` | 数値1 (必須) | `12.18` | 特定の項目に対して徴収された税金の合計額 | | `shipping_line_item.id` | テキスト (配送を使用する場合は必須)2 | `ship_123` | 外部配送項目 ID | | `shipping_line_item.tax_behavior` | `exclusive` (デフォルト) または `inclusive` のいずれか (Optional) | `exclusive` | 配送項目の税金処理 | | `shipping_line_item.amount` | 数値1 (配送を使用する場合は必須) | `5.99` | 割引適用前、税抜き (外税の場合) または税込み (内税の場合) の送料 | | `shipping_line_item.taxable_amount` | 数値1 (`tax_rate` がない場合は必須) | `5.99` | 配送の課税対象額 | | `shipping_line_item.tax_rate` | 数値 (`taxable_amount` がない場合は必須) | `0.08` | 配送の税率 | | `shipping_line_item.amount_tax` | 数値1 (配送を使用する場合は必須) | `0.48` | 配送項目に対して徴収された税金 | | `shipping_line_item.description` | テキスト (オプション) | `Express Shipping` | 自由形式の配送項目の説明 | | `shipping_line_item.tax_code` | `txcd_00000000` または `txcd_92010001` (必須) | `txcd_92010001` | 配送項目を分類する Stripe の[商品税コード](https://docs.stripe.com/tax/tax-codes.md)。 | | `shipping_line_item.external_tax_code` | テキスト (オプション) | `TX789` | 配送の外部税コード | | `shipping_line_item.amount_discount` | 数値1 (オプション) | `2.00` | 配送項目の割引 | | `merchant_address.city` | テキスト (オプション) | `San Francisco` | 加盟店の市区町村 | | `merchant_address.country` | 国コード (ISO 3166-1 alpha-2) (必須) | `US` | 加盟店の国 | | `merchant_address.line1` | テキスト (オプション) | `123 Commerce St` | 加盟店の住所 (1 行目) | | `merchant_address.line2` | テキスト (オプション) | `Suite 400` | 加盟店の住所 (2 行目) | | `merchant_address.postal_code` | テキスト (アメリカ / カナダで必須) | `94111` | 加盟店の郵便番号 | | `merchant_address.state` | テキスト (オプション) | `CA` | 加盟店の都道府県 | | `tax_ids.type` | テキスト (tax_ids フィールドが指定されている場合は必須です) | `EU_OSS_VAT`、`CA_QST` | 提供された納税者番号のタイプ。 | | `tax_ids.country` | 国コード (ISO 3166-1 alpha-2) (tax_ids フィールドが指定されている場合は必須です) | `US`、`CA` | 納税者番号の 2 文字の国コード。 | | `tax_ids.value` | テキスト (tax_ids フィールドが指定されている場合は必須です) | `12-3456789` | 納税者番号の値。 | | `buyer_address.city` | テキスト3 (オプション) | `Boston` | 買い手の市区町村 | | `buyer_address.country` | 国コード (ISO 3166-1 alpha-2)3 (必須) | `US` | 買い手の国 | | `buyer_address.line1` | テキスト3 (オプション) | `456 Main St` | 買い手の住所 (1 行目) | | `buyer_address.line2` | テキスト3 (オプション) | `Apt 789` | 買い手の住所 (2 行目) | | `buyer_address.postal_code` | テキスト3 (アメリカ / カナダで必須) | `02108` | 買い手の郵便番号 | | `buyer_address.state` | テキスト3 (オプション) | `MA` | 買い手の都道府県 | 1 金額は、主要通貨単位で小数点形式の通貨として表されます。たとえば、USD の `10.00` は `$10.00` に相当します。 2 配送項目はオプションですが、これを含めると特定のフィールドが必須になります。 3 顧客の住所については、[Stripe Tax の住所要件](https://docs.stripe.com/tax/customer-locations.md#supported-formats)が適用されます。 ### サンプル CSV ファイル 複数の項目とさまざまな一般的なフィールドを含む CSV ファイルの例 (ダッシュボードの**ファイルのインポート**パネルからサンプル CSV ファイルをダウンロードすることもできます)。 ``` source_transaction_id,transaction_type,provider,liable_transaction_id,transaction_version,tax_rules_at,created_at,posted_at,currency,customer_id,tax_exempt,line_item.id,line_item.amount,line_item.product_id,line_item.product_name,line_item.product_description,line_item.product_tax_code,line_item.external_product_id,line_item.external_tax_code,line_item.tax_behavior,line_item.unit_amount,line_item.quantity,line_item.amount_discount,line_item.taxable_amount,line_item.tax_rate,line_item.amount_tax,shipping_line_item.id,shipping_line_item.tax_behavior,shipping_line_item.description,shipping_line_item.tax_code,shipping_line_item.external_tax_code,shipping_line_item.amount,shipping_line_item.amount_discount,shipping_line_item.taxable_amount,shipping_line_item.tax_rate,shipping_line_item.amount_tax,merchant_address.city,merchant_address.country,merchant_address.line1,merchant_address.line2,merchant_address.postal_code,merchant_address.state,tax_ids.type,tax_ids.country,tax_ids.value,buyer_address.city,buyer_address.country,buyer_address.line1,buyer_address.line2,buyer_address.postal_code,buyer_address.state 1935a6-Sale,Sale,tax_jar,,1,2024-06-07 18:07:21 UTC,2024-06-07 18:07:21 UTC,2024-06-07 18:07:21 UTC,USD,cus_9s6XKzkNRiz8i3,none,LineItem-1,42.54,,,Pepperoni Pizza,txcd_40060003,tax_product_id_56,tax_code_99,inclusive,55.05,1,12.51,,,4.06,ShippingLineItem-8ab3,inclusive,Shipping description 69,txcd_92010001,shipping_tax_code_3,10.33,,,,0,San Francisco,US,510 Townsend St,,94103,CA,us_ein,US,12-3456789,Seattle,US,9205th Ave,,98104,WA 8a54a0-Refund,Refund,tax_jar,1935a6-Sale,1,2024-06-07 18:07:21 UTC,2024-06-07 18:07:21 UTC,2024-06-07 18:07:21 UTC,USD,cus_9s6XKzkNRiz8i3,none,LineItem-1,-42.54,,,Pepperoni Pizza,txcd_40060003,tax_product_id_56,tax_code_99,inclusive,-55.05,1,-12.51,,,-4.06,ShippingLineItem-8ab3,inclusive,Shipping description 69,txcd_92010001,shipping_tax_code_3,-10.33,,,,0,San Francisco,US,510 Townsend St,,94103,CA,us_ein,US,12-3456789,Seattle,US,9205th Ave,,98104,WA 1860e6-Sale,Sale,tax_jar,,1,2024-06-07 18:07:21 UTC,2024-06-07 18:07:21 UTC,2024-06-07 18:07:21 UTC,USD,cus_9s6XKzkNRiz8i3,none,LineItem-1,172.58,,,Pepperoni Pizza,txcd_40060003,tax_product_id_56,tax_code_99,inclusive,45.37,4,8.9,,,16.47,ShippingLineItem-e936,inclusive,Shipping description 69,txcd_92010001,shipping_tax_code_3,8.14,,,,0,San Francisco,US,510 Townsend St,,94103,CA,us_ein,US,12-3456789,Seattle,US,9205th Ave,,98104,WA e7f7a1-Void,Void,tax_jar,1860e6-Sale,1,2024-06-07 18:07:21 UTC,2024-06-07 18:07:21 UTC,2024-06-07 18:07:21 UTC,USD,cus_9s6XKzkNRiz8i3,none,LineItem-1,-172.58,,,Pepperoni Pizza,txcd_40060003,tax_product_id_56,tax_code_99,inclusive,-45.37,4,-8.9,,,-16.47,ShippingLineItem-e936,inclusive,Shipping description 69,txcd_92010001,shipping_tax_code_3,-8.14,,,,0,San Francisco,US,510 Townsend St,,94103,CA,us_ein,US,12-3456789,Seattle,US,9205th Ave,,98104,WA 6b8059-Sale,Sale,tax_jar,,1,2024-06-07 18:07:21 UTC,2024-06-07 18:07:21 UTC,2024-06-07 18:07:21 UTC,USD,cus_9s6XKzkNRiz8i3,none,LineItem-1,216.37,,,Pepperoni Pizza,txcd_40060003,tax_product_id_56,tax_code_99,exclusive,69.17,3,11.79,,,20.65,ShippingLineItem-3218,inclusive,Shipping description 69,txcd_92010001,shipping_tax_code_3,9.41,,,,0,San Francisco,US,510 Townsend St,,94103,CA,us_ein,US,12-3456789,Seattle,US,9205th Ave,,98104,WA ``` ### 各取引タイプのガイダンス #### 販売取引 販売取引をインポートする際は、適切な処理を確実に行うためにこれらのガイドラインに従ってください。取引ごとに含めることができる配送項目は 1 つのみです。 **単一項目の取引の場合:** - すべての必須フィールドを含む 1 つの行を作成する - `transaction_type` を `Sale` に設定します **項目が複数ある取引の場合:** - 項目ごとに個別の行を作成する - 同じ取引のすべての項目で、これらのフィールドが正確に一致するようにしてください。 - `source_transaction_id` - `transaction_type` - `provider` - `tax_rules_at` - `currency` - すべての `tax_ids.*` フィールド - すべての `shipping_line_item.*` フィールド #### 取引の返金と無効化 返金や無効化をインポートする場合は、元の取引を参照する必要があります。 **単一項目の取引の場合:** - すべての必須フィールドを含む 1 つの行を作成する - `transaction_type` を `Refund` または `Void` に設定します - `liable_transaction_id` を元の取引の `source_transaction_id` に設定します - 金額フィールドに負の値を使用する (マイナス記号を追加する) - `currency` が元の取引と一致していることを確認します **項目が複数ある取引の場合:** - 項目ごとに個別の行を作成する - `transaction_type` を `Refund` または `Void` に設定します - `liable_transaction_id` を元の取引の `source_transaction_id` に設定します - すべての金額フィールドに負の値を使用する - 同じ返金/無効化取引のすべての項目で、これらのフィールドが正確に一致するようにしてください。 - `source_transaction_id` - `transaction_type` - `provider` - `tax_rules_at` - `currency` - すべての `tax_ids.*` フィールド - すべての `shipping_line_item.*` フィールド #### 取引の修正 以前にインポートした取引を修正するには、以下の手順に従います。 1. 同じものを使用して、修正する取引を複製します。 - `source_transaction_id` - `transaction_type` - `provider` 1. 修正が必要なフィールドをすべて更新します。 1. `transaction_version` の値を増やします (たとえば、`1` から `2` へ)。 1. 修正した取引を再インポートします。 Stripe Tax は、すべてのバージョンの記録を保持し、計算とレポート作成で `transaction_version` の値が最も高いバージョンを使用します。このアプローチでは、課税する計算で元の取引データを差戻すのではなく、実質的に置き換えます。 ダッシュボードの [［Transactions］](https://dashboard.stripe.com/tax/transactions) ページには、元の取引、元の取引を否定する無効化取引、および新しい修正取引の 3 つのレコードがすべて表示されます。 ### インポートに関する制限 | 制限事項 | 詳細 | | --------------- | ------------------------------------------ | | 最大ファイルサイズ | 50 メガバイト | | サポートされているファイル形式 | CSV のみ | | ヘッダー行 | 必須 (上記の列名を含める必要があります) | | ファイルの処理 | サイズの大きいファイルは処理に時間がかかる場合があります | | レポートへの影響 | インポートした取引は、Stripe で処理した取引の計算やレポートには影響しません。 | ## 取引データをインポートする サードパーティーの取引データをインポートするには、以下のようにします。 1. Stripe ダッシュボードの **[税金](https://dashboard.stripe.com/tax)** セクションに移動します。 1. **クイックアクション** をクリックして、**取引をインポート** を選択します。 1. **CSV をインポート**をクリックします。 1. 用意した CSV ファイルを選択して、**ファイルをインポート** をクリックします。 1. 表示されるドロワーでインポートステータスを監視します。このドロワーを閉じて、後で戻って進行状況を確認したり、検証結果を表示したりできます。 インポート中にエラーが発生した場合は、問題のあるすべての行と発生した特定のエラーの CSV をダウンロードできます。 [Stripe Tax をテスト](https://docs.stripe.com/tax/testing.md)する検証手順を使用して、インポートしたデータをテストします。 > インポートした取引は削除できません。新しい取引バージョンをインポートすると、以前にインポートした取引を修正できます。意図せずにインポートした取引がある場合、無効な取引をインポートすると納税義務は削除されます。 ## 追加情報 ### 使用上の制限 取引インポートツールの使用目的には制限があります。 - **データの範囲**: このツールは、外部販売データをインポートして納税義務を監視するためのものです。VAT 申告対象の購入をインポートするために使用しないでください。VAT 申告対象の購入をインポートすると、総売上高の数値が不正確に膨れ上がり、納税義務が正しく調整されません。 - **外部取引のみ**: このツールは、外部ソースからの取引データのインポートのみに対応しています。Stripe を通じて処理された取引の修正や変更には使用しないでください。 ### 料金体系 公開プレビュー中は、CSV 取引を手数料なしでインポートできます。これらのインポートも、エンタイトルメントや API 使用状況の制限にはカウントされません。 ### 税額計算の処理 インポートした取引の税金を、Stripe が自動で再計算することはありません。インポートした取引は、その地域に有効な Stripe Tax の登録があるかどうかに関係なく、CSV ファイルに指定された税額を使用して報告されます。 インポートされた取引の課税対象金額、非課税金額、税率、課税対象の理由は、Stripe Tax レポートや Stripe 内のその他の箇所に表示される場合がありますが、これらの値はあくまで概算または近似値として取り扱ってください。 ### 表示に関する制限 インポートした取引データは、一部の Stripe Tax のレポートとインターフェイスでは表示が制限されます。 - [取引のエクスポート](https://docs.stripe.com/tax/reports.md#exports): 項目別エクスポートとサマリーのエクスポートには、インポートした取引の税率情報、課税対象額、管轄区域ごとの課税対象事由は含まれません。 - [Sigma](https://docs.stripe.com/stripe-data/query-tax-data.md): 課税する管轄区域の詳細 (`tax_transaction_jurisdiction_details` の行) は、Sigma レポートでインポートされた取引には使用できません。 - [Tax 概要ページ](https://docs.stripe.com/tax/testing.md#tax-transactions-page): Tax 概要ダッシュボードの計算や表示にインポートされた取引は含まれません。 - [店舗レポート](https://docs.stripe.com/tax/reports.md#us-location-reports): 店舗レポートには、インポートされた取引は表示されません。 インポートした取引詳細は、[納税申告書](https://docs.stripe.com/tax/reports.md)および[納税義務の監視](https://docs.stripe.com/tax/monitoring.md)で引き続き確認できます。 ### 他の Stripe プロダクトでの表示 インポートツールを使用してインポートされた取引は、Stripe Tax のレポートとインターフェイスにのみ表示されます。[Revenue Recognition](https://docs.stripe.com/revenue-recognition.md) などの他のプロダクトにサードパーティーの取引を含めるには、プロダクト固有のインポートツールを別途使用する必要があります。 ### データ処理 #### 過去の取引データ 2023 年 10 月 1 日以降の任意の期間の取引履歴データをインポートできます。 #### 処理時間 処理済みの該当する取引が一部の Stripe Tax のレポートとインターフェイスに反映されるまで、最大 24 時間かかります。 ## See also - [納税申告](https://docs.stripe.com/tax/reports.md) - [納税義務を監視する](https://docs.stripe.com/tax/monitoring.md) - [税金に登録する](https://docs.stripe.com/tax/registering.md)