Fehlerbehebung

Erfahren Sie, wie Sie mit dem Stripe Connector for NetSuite mit Fehlern umgehen.

Wenn beim Synchronisieren von Datensätzen zwischen Stripe und NetSuite Probleme auftreten, können Sie die Fehler anhand der folgenden Liste identifizieren und beheben. Möglicherweise müssen Sie NetSuite, Stripe oder den Connector anpassen und den Datensatz dann manuell synchronisieren.

Sie können alle Fehler im Fenster für die Synchronisierung der Datensätze der Connector-App anzeigen.

Datenfehler

Die folgende Tabelle enthält Fehler, die beim Synchronisieren von Datensätzen mit NetSuite auftreten können.

Fehler	Quelle	Beschreibung	Beilegung
NetSuite-Systemfehler: Es konnte keine passende Zeile für die Unterliste mit folgendem Schlüssel gefunden werden: [doc,line] und Wert: [12345,null].	NetSuite	Der Connector kann keinen Datensatz als Zahlungseintrag (Unterliste) für einen vorhandenen NetSuite-Datensatz erstellen. Der Connector kann beispielsweise eine Zahlung nicht im Rahmen einer vorhandenen Rechnung erstellen und zuordnen, wenn sie bereits vollständig bezahlt wurde. Dieser Fehler kann auch dann auftreten, wenn der Betrag der Gutschrift unter dem Rückerstattungsbetrag liegt. Dies kommt manchmal vor, wenn der Steuerbetrag oder ein anderer Betrag die automatisierte Einrichtung in NetSuite ändert.	Überprüfen Sie den Fehler des NetSuite-Datensatzes, um herauszufinden, warum der Zahlungseintrag nicht erfolgreich war. Wenn der Grund weiterhin unklar bleibt, können Sie den Zahlungseintrag auch manuell erstellen und so die Ursache möglicherweise besser identifizieren.
Bitte geben Sie den/die Wert(e) ein für: [Feldname].	NetSuite	Der Connector kann aufgrund eines fehlenden Pflichtfelds in diesem Datensatz keinen NetSuite-Datensatz erstellen oder aktualisieren. Beispiel: Der Connector versucht, eine Rechnung zu erstellen, für die das Feld `Department` erforderlich ist. NetSuite lässt erst dann zu, dass der Connector den Vorgang abschließen kann, wenn während der Anfrage zur Rechnungserstellung für `Department` eine Angabe gemacht wurde.	Fügen Sie einen Standardwert für das Feld hinzu. Navigieren Sie dazu im Connector zur Seite App-Einstellungen > Feldzuordnung > Feldstandardwerte. Der Connector verwendet den Standardwert beim Erstellen von Datensätzen dieses Typs. Für Feldstandardwerte wird das JSON-Format verwendet. Um beispielsweise einen Standardwert von 2 für `Department` auf Ihren Rechnungen hinzuzufügen, fügen Sie Folgendes hinzu: `invoice: { "department_id": 2 }`
Sie haben einen ungültigen Feldwert [Wert] für das folgende Feld eingegeben: [Feld].	NetSuite	Der Connector kann aufgrund eines oder mehrerer ungültiger Feldwerte keinen NetSuite-Datensatz erstellen oder aktualisieren. Dies kann passieren, wenn der Standardwert eines Felds einen Wert verwendet, der aus irgendeinem Grund gelöscht wurde oder nicht verfügbar ist. Zum Beispiel haben Sie möglicherweise `Class` für Einzahlungen als Pflichtfeld angegeben. Während des Onboardings fügen Sie einen Feldstandardwert für Corporate mit der internen ID 5 hinzu, um die Anforderung zu erfüllen. Nach einiger Zeit wird der Wert für Corporate (ID: 5) gelöscht. Wenn der Connector nun versucht, eine weitere Bankeinzahlung zu erstellen, schlägt diese mit folgender Fehlermeldung fehl: `You have entered an Invalid Field Value 'Corporate' for the following field: Class`	Ändern Sie den Standardwert so, dass eine gültige Feld-ID verwendet wird. Navigieren Sie dazu im Connector zur Seite App-Einstellungen > Feldzuordnungen > Feldstandardwerte.
Ungültiger Datensatz, auf den im Metadatenschlüssel `netsuite_metadata_id` (012345) verwiesen wird.	Connector	Der Connector kann den Datensatz wegen eines gelöschten NetSuite-Datensatzes, den Sie zuvor synchronisiert oder verknüpft haben, nicht synchronisieren. Wenn Sie beispielsweise eine Stripe-Rückerstattung mit einer Gutschrift verknüpfen und dann die Gutschrift löschen, müssen Sie den Metadatenschlüssel der Stripe-Rückerstattung (`netsuite_credit_memo_id`) so aktualisieren, dass er auf die korrekte interne NetSuite-Gutschrift-ID verweist.	Aktualisieren Sie den `netsuite_credit_memo_id`-Metadatenschlüssel der Rückerstattung, um auf die neue interne Gutschrifts-ID zu verweisen.
Der Zahlungsbetrag 100,0 unterscheidet sich von dem auf der zugehörigen Rechnung fälligen Betrag. Transaktions-ID: INV12345 (ID 1234567) Fälliger Betrag: 99,0.	Connector	Die Rechnungszahlung übersteigt den fälligen Betrag der NetSuite-Rechnung. Dies kann passieren, wenn der Connector die Stripe-Rechnung falsch mit NetSuite synchronisiert und Sie die Steuerabwicklung noch nicht eingerichtet haben. Außerdem kann dies vorkommen, wenn Sie den Gesamtbetrag der NetSuite-Rechnung im Zeitraum zwischen dem Versand der Rechnung und der Zahlung auf Kundenseite ändern.	Wenn Ihr Connector-Konto nicht für die Verarbeitung von Steuern eingerichtet ist, wenden Sie sich zur Einrichtung an Ihren Implementierungspartner. Wenn Sie eine vom Connector erstellte NetSuite-Rechnung manuell geändert haben, müssen Sie die Rechnung aktualisieren, um den ursprünglichen Betrag zu verwenden.

Doppelte Zahlungen

Stripe und NetSuite verarbeiten doppelte Zahlungen unterschiedlich. Während Stripe eine Überzahlung einer Rechnung zulässt, gibt NetSuite einen Fehler zurück, wenn Kundinnen/Kunden versuchen, eine Zahlung für eine bereits vollständig geleistete Rechnung vorzunehmen. Sollte es bei Stripe zu einer doppelten Zahlung kommen, so synchronisiert der Connector die Zahlung in der Regel nicht, da NetSuite keine zweite Zahlung zulässt.

Wenn eine doppelte Zahlung einen Fehler verursacht, weil der Connector versucht, die Auszahlung während der automatischen Einzahlung abzugleichen, können Sie das Problem beheben, indem Sie die erste Zahlung manuell von der Rechnung entfernen und so die zweite Zahlung zulassen.

Sie können dem Connector auch gestatten, doppelte Zahlungen für Sie abzuwickeln. Wenn Sie eine NetSuite-Rechnung haben, die vollständig bezahlt ist, führt der Connector doppelte Zahlungen als nicht zugeordnete Zahlungen in NetSuite auf. Die nicht zugeordnete Zahlung enthält den folgenden Vermerk: Stripe Payment Error: could not apply to invoice XYZ. Sie können diese Zahlungen dann auf einer anderen Rechnung zuordnen oder manuell in Stripe zurückerstatten. Um in NetSuite nach doppelten Zahlungen zu suchen, erstellen Sie eine gespeicherte Suche mit dem Vermerk als Kriterium.

Sie können den Connector aktivieren, um doppelte Zahlungen auf die folgende Weise zu verarbeiten:

Erlauben Sie standardmäßig alle doppelten Zahlungen im Connector. Gehen Sie dazu zu Ihren Connector-Einstellungen und aktivieren Sie die Option Doppelte Rechnungszahlungen zulassen für die Einstellungen Ihrer Stripe-App. Wenden Sie sich an Ihren Implementierungspartner und erkundigen sich vor der Aktivierung der Funktion bei diesem, wie sich dies auf buchhalterische und technische Angelegenheiten auswirkt.
Fügen Sie mithilfe der Stripe API das Feld netsuite_allow_duplicate: true in die Metadaten einer doppelten Stripe-Zahlung ein.