Fehlerbehebung für den Connector

Erfahren Sie, wie Sie Fehler mit dem Stripe Connector for NetSuite beheben.

Verwenden Sie diesen Leitfaden, um Probleme mit dem Stripe Connector for NetSuite zu beheben, einschließlich der Identifizierung und Behebung von Fehlern beim Synchronisieren von Datensätzen oder Laden von Bezahlseiten.

Wenn Sie weitere Unterstützung benötigen, wenden Sie sich an Ihren Implementierungspartner oder an den Stripe-Support.

Datensätze von Stripe zu NetSuite synchronisieren

In der folgenden Tabelle werden Fehler beschrieben, die beim Synchronisieren von Datensätzen von Stripe zu NetSuite auftreten können. Sie können alle Fehler im Fenster mit den Synchronisierungsdatensätzen der Connector-App anzeigen.

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 Werte ein für: [Feldname].	NetSuite	Der Connector kann keinen NetSuite-Datensatz erstellen oder aktualisieren, da ein Pflichtfeld in diesem Datensatz fehlt. Wenn der Connector z. B. versucht, eine Rechnung zu erstellen, für die das `Department`-Feld erforderlich ist, lässt NetSuite nicht zu, dass der Connector die Aktion abschließt, bis ein Wert für `Department` in der Anforderung zum Erstellen einer Rechnung vorhanden ist.	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 einen NetSuite-Datensatz aufgrund eines oder mehrerer ungültiger Feldwerte nicht erstellen oder aktualisieren. Dies kann der Fall sein, wenn ein Feldstandard einen gelöschten oder nicht verfügbaren Wert verwendet. 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.

Rechnungs- oder Kundenbezahlseiten laden

In der folgenden Tabelle werden Fehler beschrieben, die auftreten können, wenn Sie versuchen, eine Rechnungsbezahlseite oder eine Kundenbezahlseite zu laden. Sie können alle Fehler im Fenster mit den Synchronisierungsdatensätzen der Connector-App anzeigen.

Fehler	Beschreibung
`scn_account_disabled`	Your Stripe Connector for NetSuite integration isn’t turned on. To turn it on, navigate to the app settings, and select Turn on.
`scn_amount_due`	Das Feld `Amount Due` muss auf einem NetSuite-Rechnungsformular ausgefüllt werden. Sie können überprüfen, ob Anzeigen für das Feld `Amount Due` ausgewählt ist, indem Sie zu Anpassung > Formulare > Transaktionsformulare zum NetSuite-Rechnungsdatensatzformular navigieren. Bearbeiten Sie das Formular in der Unterliste Bildschirmfelder.
`scn_amount_too_large`	Der fällige Betrag ist höher als der maximal zulässige Betrag. Verwenden Sie eine niedrigere Menge und versuchen Sie es noch einmal.
`scn_amount_too_small`	Der fällige Betrag liegt unter dem zulässigen Mindestbetrag. Verwenden Sie eine höhere Menge und versuchen Sie es noch einmal.
`scn_currency_not_found`	Für den NetSuite-Rechnungsdatensatz oder den Kundendatensatz ist keine Währung festgelegt.
`scn_duplicate_key`	Zwei Prozesse haben gleichzeitig versucht, eine Checkout-Sitzung zu erstellen. Erneut versuchen.
`scn_invalid_argument`	Der NetSuite-Kunde/die NetSuite-Kundin wurde nicht gefunden. Stripe blockiert die Erstellung einer Checkout-Sitzung.
`scn_invalid_customer_record`	Der Kundendatensatz ist ungültig, da der Kunde/die Kundin möglicherweise inaktiv ist, eine ungültige Verschleierungssignatur hat oder das nutzerdefinierte Feld für die Kundenzahlungsseite fehlt.
`scn_invalid_internal_id`	Der interne ID-Wert ist inkorrekt. Dieser Fehler bedeutet oft, dass die Formel falsch konfiguriert ist und sich am Ende der URL ein nachgestelltes Zeichen oder Symbol befindet. Zum Beispiel ein `)`. Überprüfen Sie die URL auf nachgestellte Zeichen oder Symbole, und geben Sie einen positiven numerischen Wert an.
`scn_invalid_livemode_value`	Der Wert für den Live-Modus des NetSuite-Pakets ist falsch.
`scn_invalid_merchant_account`	Stripe konnte keine Kontokonfiguration für die Kombination aus Geschäfts- und Live-Modus finden. Dies kann passieren, wenn das Unternehmen nicht existiert oder wenn das Unternehmen noch nicht mit der Einbindung in den Connector fertig ist.
`scn_invalid_payment_link_resource`	Die Ressource für den Zahlungslink ist ungültig, da es sich bei dem Datensatz entweder um einen Kundenauftrag oder eine Rechnung mit einem Nullsaldo handelt.
`scn_invalid_record_type`	Sie haben versucht, einen Zahlungslink aus einem NetSuite-Datensatz zu erstellen, bei dem es sich nicht um eine Rechnung oder einen Kundenauftrag handelt. Dies wird nicht unterstützt.
`scn_minimum_balance_not_met`	Sie haben versucht, eine Kundenzahlungsseite für einen Kunden/eine Kundin zu erstellen, dessen/deren Guthaben unter dem Mindestzahlungsbetrag (50 Cent, USD) liegt.
`scn_missing_amount`	The invoice is missing the “Amount Due” field. Enable this on all custom invoice forms: Go to Customization > Forms > Transaction Forms, and filter for Invoice type. Edit all custom invoice forms (those with Edit option). Look under the Screen Fields tab. Make sure you enable Amount due under Show. If no custom form exists, create one by clicking Customize on the preferred form. Save all changes.
`scn_no_customer_balance`	Der NetSuite-Kunde/die NetSuite-Kundin hat kein Guthaben.
`scn_no_guid`	Die Struktur des Zahlungslinks ist ungültig. Der Zahlungslink muss über eine GUID verfügen und dieser Struktur folgen: `/payment/{{{merchant}}}/live/invoice/{{{guid}}}`.
`scn_no_id`	Die Struktur des Zahlungslinks ist ungültig. Die GUID muss aus genau zwei Teilen bestehen, die durch einen Unterstrich getrennt sind. Beispiel: `F1783B96F2111D47E053972C0C0AAEB5_1234567`.
`scn_no_payment_methods_available`	Es liegen keine gültigen Zahlungsmethodentypen für die Checkout-Sitzung vor.
`scn_no_resource_lock`	Eine Ressourcensperre konnte nicht abgerufen werden, die Ressource wird wahrscheinlich gerade durch einen anderen Vorgang geändert. Versuchen Sie es später noch einmal.
`scn_ns_concurrent_request_limit_exceeded`	Alle NetSuite-Verbindungen werden verwendet und die Anforderung war begrenzt. Versuchen Sie es später noch einmal.
`scn_ns_data_center_not_found`	Eine NetSuite-Verbindungs-URL wurde nicht gefunden. Überprüfen Sie Ihre Kontokonfiguration und versuchen Sie es später noch einmal.
`scn_ns_invalid_login_attempt`	Verbindung zu NetSuite fehlgeschlagen. Überprüfen Sie Ihre Kontoanmeldedaten und versuchen Sie es erneut. Dieser Fehler kann auch bei korrekten Anmeldeinformationen zeitweise auftreten.
`scn_ns_record_changed`	Der Datensatz wurde gleichzeitig durch einen anderen Vorgang geändert. Versuchen Sie es später noch einmal.
`scn_ns_unexpected_error`	In NetSuite ist ein unerwarteter Fehler aufgetreten. Versuchen Sie es später noch einmal.
`scn_payment_links_not_enabled` oder `scn_customer_payment_page_not_enabled`	Die entsprechende Funktion der Zahlungsseite für Kundinnen/Kunden oder der Rechnungszahlungsseite ist in diesem Konto nicht aktiviert. Stripe blockiert die Erstellung einer Checkout-Sitzung.
`scn_recent_payment_found`	Über die Kundenzahlungsseite wurde innerhalb der letzten 24 Stunden eine erfolgreiche Zahlung übermittelt. Pro Tag ist nur eine Zahlung zulässig.
`scn_record_not_found`	Stripe verwendet die in einer URL angegebene interne ID, um NetSuite nach der mit einem Zahlungslink verknüpften Rechnung zu durchsuchen. Dieser Fehler kann in folgenden Fällen auftreten: Ein Rechnungsdatensatz mit der angegebenen internen ID existiert nicht. Im Rechnungsdatensatz fehlt eine GUID im nutzerdefinierten Feld `custbody_stripe_payment_link_guid` Die GUID im Rechnungsdatensatz stimmt nicht mit der GUID in der Zahlungslink-URL überein
`scn_too_many_parts`	Die Struktur des Zahlungslinks ist ungültig. Die GUID muss aus genau zwei Teilen bestehen, die durch einen Unterstrich getrennt sind. Beispiel: `F1783B96F2111D47E053972C0C0AAEB5_1234567`.
`scn_unknown_error`	Ein unbekannter Fehler ist aufgetreten. Wenden Sie sich an den Support.
`scn_unsupported_record_type`	Sie haben versucht, einen Zahlungslink aus einem NetSuite-Kundenauftrag zu erstellen. Dies wird nicht unterstützt.

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.

Stripe-Zahlungslink-Felder

Stellen Sie sicher, dass Sie die folgenden Felder korrekt konfigurieren.

Feld	Beschreibung
Währung	Dieses Feld ist obligatorisch und muss auf allen Rechnungsvorlagen erscheinen, die mit dem Stripe-Zahlungslink verwendet werden.
Zu zahlender Betrag / Verbleibender Betrag	Stellen Sie sicher, dass dieses Feld auf der Rechnung angezeigt wird. Die URL zeigt eine Nachricht an Ihren Kundinnen und Kunden an, wenn dieses Feld nicht angezeigt wird, der Wert null ist oder die Rechnung bezahlt wurde.

Feld „Versteckte GUID“

Das Feld Hidden GUID erstellt nicht automatisch zufällige IDs für Rechnungen, die vor der Installation des Zahlungslink-Pakets erstellt wurden. Dies gilt auch für Rechnungen, die aus früheren Verkaufsaufträgen erstellt wurden.

Wenn Sie aufgrund dieser Standardfunktionalität eine große Anzahl von Fehlern erhalten, wenden Sie sich an Ihre/n Stripe-Vertreter/in.

Paket-Updates

Wenn Sie das Paket aktualisieren, wird die Default Value-Konfiguration auf die Standardeinstellungen zurückgesetzt. Sie müssen die Default Value-Konfiguration neu konfigurieren, damit sie für Ihre Kundinnen und Kunden wieder ordnungsgemäß funktioniert.

Berechtigungen

Wenn Sie bestimmte Berechtigungen für den Zugriff auf Rechnungen benötigen, müssen Sie sicherstellen, dass Sie diese Berechtigungen der Rolle Stripe Limited Access hinzufügen (z. B. indem Sie zu Listen > Steuerdetails > Vollständig navigieren). Dadurch kann der Connector auf Rechnungsinformationen zugreifen, um eine Rechnungszahlungsseite zu erstellen.