# 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_memo:` が配置されます。たとえば、返金 ID が `re_abcd` の場合、クレジットメモの外部 ID は `ns_memo:re_abcd` になります。
- **Stripe 価格のディスカウントアイテム**: 外部 ID の前に、割引が適用される価格オブジェクトの ID が配置されます。

NetSuite インスタンスに他の実装が存在する場合は、Stripe がレコードに設定した 外部 ID を上書きしないようにしてください。

## NetSuite レコードフィールド

コネクターは、以下にリストされている NetSuite レコードフィールドをデフォルトで使用します。これらのフィールドは、コネクターが作成または使用するすべてのレコードに使用されるカスタムフォームに含まれている必要があります。

| レコード         | フィールド                                                                                                                                             | 注意事項                                                                                                                                     |
| ------------ | ------------------------------------------------------------------------------------------------------------------------------------------------- | ---------------------------------------------------------------------------------------------------------------------------------------- |
| 請求書 (読み取りのみ) | - amountRemaining
  - status
  - currency
  - custbody_suitesync_authorization_code
  - tranId
  - memo
  - createdFrom
  - entity
  - externalId | `amountRemaining` は請求額とも呼ばれます。                                                                                                           |
| 顧客           | externalId                                                                                                                                        |                                                                                                                                          |
| クレジットメモ      | - memo
  - currency
  - custbody_suitesync_authorization_code
  - line items sub-list                                                             |                                                                                                                                          |
| 顧客の支払い       | - memo
  - currency
  - paymentMethod
  - account
  - payment
  - tranDate                                                                        | `tranDate` は、Stripe での取引が行われた正確な日付に設定されます。`paymentMethod`は、Stripe の支払い方法に設定されます (アカウントで自動的に作成されます)。`account` は、コネクターによって未入金の売上口座に設定されます。 |
| 顧客への返金       | - memo
  - currency
  - tranDate
  - paymentMethod
  - account                                                                                    | `tranDate` は、Stripe での取引が行われた正確な日付に設定されます。`paymentMethod`は、Stripe の支払い方法に設定されます (アカウントで自動的に作成されます)。`account` は、コネクターによって未入金の売上口座に設定されます。 |
| 入金           | - currency
  - memo
  - all sub-lists (支払いリスト、その他の入金、キャッシュバック)                                                                                    |                                                                                                                                          |

## See also

- [フィールドマッピング](https://docs.stripe.com/use-stripe-apps/netsuite/field-mappings.md)
- [Stripe データを NetSuite に同期する](https://docs.stripe.com/use-stripe-apps/netsuite/sync-data.md)