コンテンツにスキップ
アカウントを作成
または
サインイン
Stripe ドキュメントのロゴ
/
AI に質問する
アカウントを作成
サインイン
始める
支払い
売上
プラットフォームおよびマーケットプレイス
資金管理
開発者向けのツール
概要
バージョン管理
変更ログ
API バージョンのアップグレード
SDK バージョンをアップグレードする
開発者向けのツール
SDK
API
テスト
ワークベンチ
イベントの送信先
ワークフロー
Stripe CLI
Stripe Shell
開発者ダッシュボード
エージェントツールキット
LLM を使用した構築Visual Studio Code をご利用の場合Stripe 健全性アラートファイルのアップロード
セキュリティとプライバシー
セキュリティ
プライバシー
Stripe を拡張する
Stripe Apps
Stripe のコネクター
    概要
    コネクターを実装する
    Commercetools
    Adobe Commerce
    Mirakl
    NetSuite
      経理ハブ
      開発者ハブ
      アカウント登録の準備
      入金の自動化
      請求書の自動化
      請求書支払いページ
      顧客の決済ページ
      カスタムの決済アプリケーション
        フィールドとリファレンス
        フィールドマッピング
        データを同期
      複数の子会社
      複数の通貨
      トラブルシューティング
      請求書の決済用のリンク
    Oracle Opera
    Cegid
    PrestaShop
    Salesforce
    SAP
    Shopware 6
    Stripe Tax for WooCommerce
    Stripe Tax for BigCommerce
    パートナーコネクター
    独自のコネクターを構築する
パートナー
Partner Ecosystem
パートナー認定
ホーム開発者向けのツールStripe ConnectorsNetSuiteCustom payment application

フィールドマッピング

Stripe Connector for NetSuite を使用して、NetSuite レコードに同期されたデータをカスタマイズする方法をご紹介します。

ページをコピー

フィールドマッピングは、NetSuite でレコードのレポート作成や分類を行う必要がある場合、またはコネクターがレコードを作成する必要がある必須フィールドの値を追加する場合に利用します。

Stripe Connector for NetSuite を使用して NetSuite レコードにデータを追加する方法は 2 つあります。

  • フィールドデフォルト (静的)
  • フィールドマッピング (動的)

コネクターアプリから設定 > フィールドマッピングに移動すると、両方のマッピング方法を確認できます。これにより、たとえばデフォルトで同期されるデータよりも多くのデータを NetSuite レコードに同期したい場合に、NetSuite に同期するデータをカスタマイズできます。

フィールドデフォルト

フィールドデフォルト (静的な値) は、Stripe に存在しない場合でも、実装によって作成される任意のレコードに追加できます。NetSuite レコードの 1 つに必須フィールドがある場合、コネクターはそのフィールドの値を含めてレコードを作成する必要があります。これを怠った場合、レコード作成のリクエストがエラーにより失敗します。

たとえば、請求書フォームに必須の Class フィールドがある場合、Class の値を指定してコネクターがレコードを作成できるようにする必要があります。Class は recordReference またはドロップダウンフィールドであるため、コネクターにはフィールドデフォルトとして使用する値の内部 ID が必要です。internalID: 5 が指定された Corporate を使用したい場合、次の JSON ハッシュを入力します。

invoice: { "klass_id": 5 }

請求書のラインアイテムに同じフィールドが必要な場合は、次の JSON ハッシュを入力します。

invoice_item: { "klass_id": 5 }

上記の例では、class ではなく klass を使用しています。これは、このフィールドの NetSuite API に固有のものです。サフィックス _id は、フィールド値が recordReference (ドロップダウン) であることを NetSuite に示します。もう一つの一般的なサフィックスとして _date があります。これは、Unix タイムスタンプ形式にする必要がある NetSuite の日付フィールドを示します。

よくある間違い

必須フィールド、invoice のヘッダーフィールド、または invoice_item のラインフィールドが不足している場合、同じエラーメッセージが表示されます。ヘッダー別にマッピングを追加してレコードの同期に失敗した場合は、ライン別のマッピングの追加をお試しください。

フィールドマッピング

Stripe から NetSuite にフィールドマッピング (動的な値) を渡すことができます。これを実行するために、コネクターは Stripe フィールドからデータを取得し、それを NetSuite フィールドに記録します。

たとえば、Stripe に構築済みのシステムは、各支払いのメタデータに company_id を渡します。この ID を NetSuite の顧客への支払いのカスタムフィールドに渡し、トラッキングを行いたいとします。そのためには、以下のフィールドマッピングを設定する必要があります。

customer_payment: { "metadata.company_id": "custbody_company_identifier" }

上の例では、NetSuite のカスタムフィールドで _id ではなく _identifier を使用しています。NetSuite は _id を使用してレコード参照やドロップダウンフィールドタイプを示すため、カスタムフィールドではサフィックス _id 以外の値を使用する必要があります。

たとえば、サービスセールアイテムに収益認識ルールを設定する際のフィールドデフォルトは次のようになります。

"service_sale_item": { "revenue_recognition_rule_id": 123 }

カスタマイズを上書きする

コネクターは NetSuite でレコードを作成すると、Stripe レコードの標準のデータセットを NetSuite レコードにマッピングします。たとえば、Stripe 顧客の ID とメールアドレスは、コネクターによって作成される NetSuite 顧客にマッピングされます。

コネクターの標準のデータマッピングを上書きする場合は、フィールドデフォルトまたはフィールドマッピングを使用します。同じ NetSuite フィールドにデフォルトマッピング (静的) とフィールドマッピング (動的) がある場合は、フィールドデフォルトよりもフィールドマッピングが優先されます。

たとえば、コネクターが Stripe 顧客名を NetSuite フィールド company_name にマッピングしたとします。NetSuite は、デフォルトで company_name の値を法人 ID にコピーします。コネクターはこの機能を上書きし、代わりに Stripe 顧客 ID を使用して、一意の法人 ID を使用するという NetSuite の要件を満たします。このとき、Stripe 顧客 ID は使用しないでください。代わりに一意の ID を使用することをお勧めします。

この場合は、法人 ID を null にすることで、標準のデータマッピングを上書きできます。これにより、NetSuite は顧客の名前を法人 ID としてコピーし、NetSuite のデフォルトの動作を使用できます。

"customer": { "entity_id": null }

参照情報

  • Stripe フィールドおよび NetSuite フィールドとリファレンス
  • NetSuite スキーマブラウザー
このページはお役に立ちましたか。
はいいいえ
お困りのことがございましたら 、サポートにお問い合わせください。
早期アクセスプログラムにご参加ください。
変更ログをご覧ください。
ご不明な点がございましたら、お問い合わせください。
LLM ですか?llms.txt を読んでください。
Powered by Markdoc