Stripe フィールドおよび NetSuite フィールドとリファレンス
Stripe Connector for NetSuite で Stripe レコードと NetSuite レコードにフィールドを適用する方法をご紹介します。
以下のリストで、Stripe レコードと NetSuite レコード間の相互関係を確認できます。
Stripeと NetSuite のオブジェクトマッピング
NetSuite では、Stripe レコードが次のように表示されます。
Stripe オブジェクト | NetSuite レコード |
---|---|
Charge (支払い) | 顧客の支払い |
Credit Note (クレジットノート) | クレジットメモ (ほとんどの場合) および返金 (一部の場合) |
Coupon (クーポン) | ディスカウントアイテム |
顧客 | 顧客 |
不審請求の申請 | Customer Refund (顧客への返金) |
請求書 | 請求書およびクレジットメモ (一部の場合) |
Invoice Item (請求書アイテム) | サービスセールアイテムまたはディスカウントアイテム |
Payout (入金) | 入金 |
Price (価格) | サービスセールアイテム |
Refund (返金) | 顧客への返金およびクレジットメモ (一部の場合) |
Subscription (サブスクリプション) | なし (月次の請求書をサブスクリプションとして処理) |
NetSuite レコード ID とStripe ID
Stripe レコードが NetSuite との同期に成功すると、新しいレコードの NetSuite 内部 ID が Stripe レコードのメタデータに保存されます。
NetSuite は Stripe ID を次のように保存します。
レコード | NetSuite での ID 保存先 |
---|---|
クレジットメモ | メモ、externalId |
顧客 | コメント (externalId が空の場合のみ追加) |
顧客の支払い | メモ、externalId |
入金 | メモ、externalId |
不審請求の申請 | メモ、externalId |
請求書 | メモ、externalId |
NetSuite アイテム (ディスカウントアイテム、サービスセールアイテムなど) | アイテム名、アイテム ID、その他の表示名フィールド、externalId |
NetSuite のメモフィールド
Stripe:
は、対応する Stripe レコード ID を含むメモフィールドの前に配置されます。これにより、どの Stripe レコードが NetSuite レコードに対応するかを判別できます。コネクターは NetSuite のメモフィールドを使用する代わりに、情報提供のみを目的としてメモを追加します。作成したレコードのメモフィールドは、安全に消去または上書きできます。
コネクターは、以下の場合に NetSuite レコードのメモフィールドに追加情報を保存します。
- 取引日を変更した場合、メモには元の取引日が記載されます。これにより、レコードの変換が正常に成功します (例:
Original transaction date: 2023-04-01
)。 - 支払いが請求書または注文に関連付けられていない場合、顧客の支払いメモには支払いの説明が記載されます (例:
Stripe description: charge for invoice 12345
)。 - 請求書によって顧客残高が増加する場合、NetSuite 請求書にその金額が記載されます。
- クレジットメモが顧客残高からの請求書の支払いを表す場合、クレジットメモにはその支払いが記載されます。
NetSuite 外部 ID
Stripe が作成したすべての NetSuite レコードの外部 ID は、対応する Stripe レコード ID に設定されます。これにより、Stripe レコード ID を使用して NetSuite からレコードを取得できるようになります。
一部の例外は、外部 ID の前に配置されることがあります。
- クレジットメモ: 外部 ID の前に
ns_
が配置されます。たとえば、返金 ID がmemo: re_
の場合、クレジットメモの外部 ID はabcd ns_
になります。memo:re_ abcd - Stripe 価格のディスカウントアイテム: 外部 ID の前に、割引が適用される価格オブジェクトの ID が配置されます。
NetSuite インスタンスに他の実装が存在する場合は、Stripe がレコードに設定した 外部 ID を上書きしないようにしてください。
NetSuite レコードフィールド
コネクターは、以下にリストされている NetSuite レコードフィールドをデフォルトで使用します。これらのフィールドは、コネクターが作成または使用するすべてのレコードに使用されるカスタムフォームに含まれている必要があります。
レコード | フィールド | 注意事項 |
---|---|---|
請求書 (読み取りのみ) |
| amountRemaining は請求額とも呼ばれます。 |
顧客 | externalId | |
クレジットメモ |
| |
顧客の支払い |
| tranDate は、Stripe での取引が行われた正確な日付に設定されます。paymentMethod は、Stripe の支払い方法に設定されます (アカウントで自動的に作成されます)。account は、コネクターによって未入金の売上口座に設定されます。 |
顧客への返金 |
| tranDate は、Stripe での取引が行われた正確な日付に設定されます。paymentMethod は、Stripe の支払い方法に設定されます (アカウントで自動的に作成されます)。account は、コネクターによって未入金の売上口座に設定されます。 |
入金 |
|