Feldzuordnungen

Sie verwenden Feldzuordnungen, wenn Sie zusätzliche Berichte oder die Kategorisierung von Datensätzen in NetSuite wünschen oder um Werte für erforderliche Felder hinzuzufügen, die der Connector zum Erstellen von Datensätzen benötigt.

Der Stripe Connector for NetSuite bietet Ihnen zwei Möglichkeiten, Daten zu Ihren NetSuite-Datensätzen hinzuzufügen:

• Feldvorgaben (statisch)
• Feldzuordnungen (dynamisch)

Sie finden beide Zuordnungsmethoden in der Connector-App, wenn Sie zu Einstellungen > Feldzuordnungen navigieren. Auf diese Weise können Sie die mit NetSuite synchronisierten Daten anpassen, zum Beispiel wenn Sie mehr Daten im NetSuite-Datensatz benötigen, als standardmäßig synchronisiert werden.

Feldvorgaben

Sie können Feldvorgaben (statische Werte) zu jedem Datensatz hinzufügen, den die Integration erstellt, auch wenn er nicht in Stripe vorhanden ist. Wenn einer Ihrer NetSuite-Datensätze über ein erforderliches Feld verfügt, muss der Connector einen Wert für dieses Feld enthalten, um den Datensatz zu erstellen. Andernfalls schlägt die Anfrage zum Erstellen des Datensatzes mit einem Fehler fehl.

Wenn Ihr Rechnungsformular beispielsweise ein erforderliches Class-Feld enthält, müssen Sie einen Wert für Class angeben, damit der Connector den Datensatz erstellen kann. Da Class ein recordReference- oder Dropdown-Feld ist, benötigt der Connector die interne ID des zu verwendenden Werts als Feldvorgabe. Um den Wert Corporate mit internalID: 5 zu verwenden, geben Sie den folgenden JSON-Hash ein:

invoice: {
  "klass_id": 5
}

Wenn der Rechnungsposten dasselbe Feld benötigt, geben Sie den folgenden JSON-Hash ein:

invoice_item: {
  "klass_id": 5
}

In den obigen Beispielen verwenden wir klass anstelle von class, was spezifisch für die NetSuite-API für dieses Feld ist. Das Suffix _id zeigt NetSuite an, dass der Feldwert eine recordReference (Dropdown) ist. Ein weiteres häufiges Suffix ist _date, das ein NetSuite-Datumsfeld angibt, das im Unix-Zeitstempelformat vorliegen muss.

Feldzuordnungen

Sie können Feldzuordnungen (dynamische Werte) von Stripe an NetSuite übergeben. Dazu ruft der Connector Daten aus dem Stripe-Feld ab und erfasst sie im NetSuite-Feld.

Ihr mit Stripe vernetztes System übergibt beispielsweise eine company_id an die Metadaten jeder Zahlung. Sie möchten, dass diese ID zu Tracking-Zwecken an ein nutzerdefiniertes Feld in der NetSuite-Kundenzahlung übergeben wird. Dazu richten Sie die folgende Feldzuordnung ein:

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

Im obigen Beispiel wird das Suffix _identifier anstelle von _id im nutzerdefinierten Feld in NetSuite verwendet. Nutzerdefinierte Felder müssen einen anderen Wert als das Suffix _id verwenden, da NetSuite _id verwendet, um einen Datensatzreferenz- oder Dropdown-Feldtyp anzugeben.

Beispiel: Eine Feldvorgabe zum Festlegen einer Revenue-Recognition-Regel für Serviceverkaufsposten könnte wie folgt aussehen:

"service_sale_item": { "revenue_recognition_rule_id": 123 }

Anpassungen überschreiben

Wenn der Connector einen Datensatz in NetSuite erstellt, ordnet er eine Standarddatenmenge aus dem Stripe-Datensatz dem NetSuite-Datensatz zu. Beispielsweise werden die Stripe-Kunden-ID und die E-Mail-Adresse den NetSuite-Kundinnen/Kunden zugeordnet, die vom Connector erstellt wurden.

Wenn Sie die Standarddatenzuordnungen des Connectors überschreiben möchten, können Sie Feldvorgaben oder Feldzuordnungen verwenden. Wenn Sie eine Standardzuordnung (statisch) und eine Feldzuordnung (dynamisch) für dasselbe NetSuite-Feld haben, hat die Feldzuordnung Vorrang vor der Feldvorgabe.

Der Connector ordnet beispielsweise den Stripe-Kundennamen dem NetSuite-Feld company_name zu. NetSuite kopiert standardmäßig den Wert für company_name in die Unternehmens-ID. Der Connector überschreibt diese Funktionalität und verwendet stattdessen die Stripe-Kunden-ID, um sicherzustellen, dass er die NetSuite-Anforderung für die Verwendung einer eindeutigen Unternehmens-ID erfüllt. Verwenden Sie nicht die Stripe-Kunden-ID – wir empfehlen stattdessen die Verwendung einer eindeutigen ID.

In diesem Fall können Sie die Standarddatenzuordnung außer Kraft setzen, indem Sie die Unternehmens-ID annullieren. Dadurch kann NetSuite den Kundennamen als Unternehmens-ID kopieren und das Standardverhalten von NetSuite verwenden.

"customer": {
    "entity_id": null
  }