Weiter zum Inhalt
Konto erstellen oder anmelden
Das Logo der Stripe-Dokumentation
/
KI fragen
Konto erstellenAnmelden
Jetzt starten
Zahlungen
Umsatz
Plattformen und Marktplätze
Geldmanagement
Entwicklerressourcen
APIs und SDKsHilfe
Übersicht
Versionierung
Änderungsprotokoll
Aktualisieren Sie Ihre API-Version
Ihre SDK-Version aktualisieren
Essentials
SDKs
API
Tests
Stripe-CLI
Beispiel-Projekte
Tools
Stripe Dashboard
Workbench
Entwickler-Dashboard
Stripe Shell
Stripe für Visual Studio Code
Terraform
Funktionen
Arbeitsabläufe
Ereignisziele
Stripe-StatuswarnungenHochgeladene Dateien
KI-Lösungen
Agent-Toolkit
Model Context ProtocolAgentische KI-SaaS-Billing-Workflows aufbauen
Sicherheit und Datenschutz
Sicherheit
Stripebot-Webcrawler
Datenschutz
Stripe erweitern
Erstellen Sie Stripe-Apps
Verwenden Sie Apps von Stripe
    Übersicht
    Von Stripe entwickelte Apps
    Adobe Commerce
    Cegid
    Commercetools
    Guidewire
    Mirakl
    NetSuite
      Auf das Onboarding vorbereiten
      Nutzerdefinierte Zahlungsanwendung
      Bezahlseite für Kundinnen/Kunden
      Automatisierte Einzahlung
      Automatisierte Rechnungsstellung
      Link zur Zahlung von Rechnungen
      Bezahlseite für Rechnungen
      Mehrere Währungen
      Mehrere untergeordnete Konten
      Fehlerbehebung
    Oracle Opera
    Oracle Simphony
    Oracle Xstore
    PrestaShop
    Salesforce
    SAP
    Shopware 6
    Stripe Tax for BigCommerce
    Stripe Tax for Shopify
    Stripe Tax für WooCommerce
    Partner-Apps
    Entwickeln Sie Ihre eigenen Apps
Partner
Partner-Ecosystem
Partner-Zertifizierung
Vereinigte Staaten
Deutsch
StartseiteEntwicklerressourcenUse apps from StripeNetSuite

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.

FehlerQuelleBeschreibungBeilegung
NetSuite-Systemfehler: Es konnte keine passende Zeile für die Unterliste mit folgendem Schlüssel gefunden werden: [doc,line] und Wert: [12345,null].NetSuiteDer 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. Gehen Sie dazu im Connector auf die Seite App-Einstellungen > Feldzuordnung > Feldvorgaben. Der Connector verwendet den Standardwert bei der Erstellung von Datensätzen dieses Typs. Feldvorgaben verwenden das JSON-Format.

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, um eine gültige Feld-ID zu verwenden. Gehen Sie dazu im Connector auf die Seite App-Einstellungen > Feldzuordnungen > Feldvorgaben.

Ungültiger Datensatz, auf den im Metadatenschlüssel netsuite_metadata_id (012345) verwiesen wird.ConnectorDer 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.ConnectorDie 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.

Auszahlungen mit NetSuite synchronisieren

Beim Synchronisieren von Auszahlungen von Stripe mit NetSuite können die folgenden Fehler auftreten. Sie können Fehler beim Synchronisieren von Auszahlungen auf der Detailseite der Auszahlungen in der Connector-App anzeigen.

Bank-Einlagenkonto fehlt

Der Fehlercode bank_deposit_account_missing weist darauf hin, dass der Connector das NetSuite-Bank-Einlagenkonto nicht abrufen konnte. Dies geschieht, wenn das Bankkonto in NetSuite gelöscht wird, die interne ID in den Connector-Einstellungen falsch ist oder die Person mit der Stripe-Rolle „Limited Access“ (begrenzter Zugang) nicht berechtigt ist, das Konto anzuzeigen.

So beheben Sie dieses Problem:

  1. Melden Sie sich bei Ihrem NetSuite-Konto an.
  2. Navigieren Sie zu Listen > Buchhaltung > Konten.
  3. Überprüfen Sie das Vorhandensein des Bank-Einlagenkontos und notieren Sie sich dessen interne Nummer.
  4. Überprüfen Sie, ob die Person mit der Stripe-Rolle Stripe Limited Access (begrenzter Zugang) berechtigt ist, das Konto anzuzeigen.
  5. Gehen Sie in der Stripe Connector for NetSuite-App zu App-Einstellungen.
  6. Navigieren Sie zur Registerkarte Kontozuordnung und aktualisieren Sie die Zuordnung des Bank-Einlagenkontos mit der richtigen internen Nummer.

Nicht synchronisierte Transaktionen gefunden

Der Fehlercode inventorying_waiting_on_child_records zeigt an, dass eine oder mehrere Transaktionen in der Auszahlung noch nicht mit NetSuite synchronisiert wurden. Die Einlage des Auszahlungsbetrags kann erst erstellt werden, wenn alle zugehörigen Transaktionen erfolgreich synchronisiert wurden. Dies ist ein Wartezustand, nicht unbedingt ein Fehler.

So beheben Sie dieses Problem:

  1. Navigieren Sie in der Connector-App zur Detailseite der Auszahlungen.
  2. Prüfen Sie die Liste der Transaktionen mit Synchronisierungsproblemen.
  3. Überprüfen Sie für jede nicht synchronisierte Transaktion deren Synchronisierungsstatus und Fehlermeldung.
  4. Beheben Sie alle Fehler, die die Synchronisierung verhindern (z. B. fehlende Kundinnen und Kunden oder Probleme mit der Kontozuordnung).
  5. Wiederholen Sie die Synchronisierung, falls erforderlich. Nachdem alle Transaktionen synchronisiert wurden, wird die Einlage des Auszahlungsbetrags automatisch fortgesetzt.

Zuordnung des NetSuite-Kontos nicht festgelegt

Der Fehlercode missing_netsuite_account_mapping gibt an, dass eine erforderliche Zuordnung des NetSuite-Kontos nicht konfiguriert ist. Die Fehlermeldung gibt an, welcher Kontotyp fehlt (z. B. Einkommen, Transaktionsgebühr, Rückerstattung oder Anpassungskonten).

So beheben Sie dieses Problem:

  1. Prüfen Sie die spezifische Fehlermeldung, um festzustellen, welche Kontozuordnung fehlt.
  2. Gehen Sie in der Connector-App zu App-Einstellungen > Kontenzuordnung.
  3. Konfigurieren Sie die erforderliche Kontozuordnung und speichern Sie Ihre Änderungen.
  4. Wiederholen Sie die Synchronisierung der Auszahlung.

NetSuite-Bank-Einlagenkonto nicht eingerichtet

Der Wert payout_currency_account_missing gibt an, dass kein Bank-Einlagenkonto für die Währung dieser Auszahlung konfiguriert ist. Jede Währung, in der Sie Auszahlungen erhalten (USD, EUR, GBP usw.), erfordert ein entsprechendes Bank-Einlagenkonto.

So beheben Sie dieses Problem:

  1. Gehen Sie in der Connector-App zu App-Einstellungen > Kontenzuordnung.
  2. Suchen Sie im Abschnitt Bank-Einlagenkonten.
  3. Fügen Sie ein Bank-Einlagenkonto hinzu, das der Währung der Auszahlung zugeordnet ist.
  4. Speichern Sie Ihre Änderungen und wiederholen Sie die Synchronisierung der Auszahlung.

NetSuite-Tochtergesellschaft nicht verfügbar

Der Fehlercode subsidary_not_found_likely_permission_issue gibt an, dass der Connector nicht auf die NetSuite-Tochtergesellschaft zugreifen kann. Dies liegt in der Regel daran, dass die Person mit der Stripe-Rolle „Limited Access“ (begrenzter Zugriff) nicht zum Anzeigen der Tochtergesellschaften berechtigt ist. Weitere Gründe können sein, dass der Datensatz zur Tochtergesellschaft gelöscht oder deaktiviert wird oder dass keine Tochtergesellschaften auf dem Bank-Einlagenkonto konfiguriert sind.

So beheben Sie dieses Problem:

  1. Melden Sie sich als Administrator bei NetSuite an und navigieren Sie zu Einrichtung > Nutzer/innen/Rollen > Rollen verwalten.
  2. Bearbeiten Sie die Stripe-Rolle „Limited Access“ (begrenzter Zugriff).
  3. Stellen Sie unter der Registerkarte Tochtergesellschaften sicher, dass die Rolle Zugriff auf alle erforderlichen Tochtergesellschaften hat.
  4. Vergewissern Sie sich, dass die Berechtigung Listen > Tochtergesellschaften mindestens auf Ansicht eingestellt ist.
  5. Speichern Sie die Änderungen der Funktion; Position; Rolle und wiederholen Sie die Auszahlung.

Suche nach NetSuite-Tochtergesellschaft fehlgeschlagen

Der Fehlercode subsidary_search_failed gibt an, dass der Connector bei der Suche nach untergeordneten Tochtergesellschaften in NetSuite auf einen Fehler gestoßen ist. Dies weist in der Regel auf eine Netzwerkzeitüberschreitung, eine Begrenzung oder darauf hin, dass die Stripe-Rolle „Limited Access“ nicht berechtigt ist, nach Tochtergesellschaften durchzuführen.

So beheben Sie dieses Problem:

  1. Warten Sie ein paar Minuten und wiederholen Sie die Synchronisierung der Auszahlung.
  2. Wenn der Fehler weiterhin auftritt, melden Sie sich als Administrator bei NetSuite an und navigieren Sie zu Einrichtung > Nutzer/innen/Rollen > Rollen verwalten.
  3. Vergewissern Sie sich, dass bei der Berechtigung der Stripe-Rolle „Limited Access“ Listen > Tochtergesellschaften auf Vollständig gesetzt ist und Berichte > Suche aktiviert ist.
  4. Überprüfen Sie, ob die Tochtergesellschaften auf dem Bank-Einlagenkonto ordnungsgemäß konfiguriert sind.
  5. Wenden Sie sich an den [Stripe-Support](https://support.stripe.com/contact/email?topic=third_party_integrations&subject=%5BStripe%20Connector%20for%20NetSuite%20(SCN) %5D), wenn das Problem weiterhin auftritt.

NetSuite-Konto für nicht eingezahlte Geldmittel nicht verfügbar

Der Fehlercode undep_funds_account_fetch_error gibt an, dass der Connector das Konto für nicht eingezahlte Geldmittel nicht von NetSuite abrufen konnte. Dies kann aufgrund von Netzwerkproblemen oder Berechtigungsproblemen beim Zugriff auf das Konto der Fall sein.

So beheben Sie dieses Problem:

  1. Melden Sie sich bei NetSuite an und navigieren Sie zu Listen > Buchhaltung > Konten.
  2. Suchen Sie nach Ihrem Konto für nicht eingezahlte Geldmittel und überprüfen Sie, ob es vorhanden und aktiv ist.
  3. Überprüfen Sie, ob die Stripe-Rolle „Limited Access“ (begrenzter Zugriff)berechtigt ist, das Konto anzuzeigen.
  4. Gehen Sie in der Connector-App zu App-Einstellungen > Kontenzuordnung und aktualisieren Sie bei Bedarf die Kontozuordnung der nicht eingezahlten Geldmittel.
  5. Wiederholen Sie die Synchronisierung der Auszahlung.

NetSuite-Konto für nicht eingezahlte Geldmittel nicht eingerichtet

Der Fehlercode undep_funds_account_not_found gibt an, dass in Ihren Connector-Einstellungen kein Konto für nicht eingezahlte Geldmittel konfiguriert ist oder die konfigurierte Kontozuordnung leer ist. Dieses Konto ist für die Verarbeitung von Einlagen der Auszahlungsbeträge erforderlich.

So beheben Sie dieses Problem:

  1. Gehen Sie in der Connector-App zu App-Einstellungen > Kontenzuordnung.
  2. Suchen Sie die Einstellung Konto für nicht eingezahlte Geldmittel.
  3. Wählen Sie aus Ihrem NetSuite-Kontenplan das entsprechende Konto für nicht eingezahlte Geldmittel aus.
  4. Speichern Sie Ihre Änderungen und wiederholen Sie die Synchronisierung der Auszahlung.

Temporärer NetSuite-Fehler

Der Fehlercode transient_netsuite_error gibt an, dass bei der Kommunikation mit NetSuite ein temporärer Fehler aufgetreten ist, z. B. eine Netzwerk-Zeitüberschreitung, eine Begrenzung oder eine vorübergehende Nichtverfügbarkeit. Der Connector wiederholt diese Vorgänge automatisch.

So beheben Sie dieses Problem:

Keine Aktion erforderlich. Der Connector versucht es automatisch erneut mit exponentiellem Backoff. Wenn der Fehler länger als 24 Stunden andauert, wenden Sie sich an den [Stripe-Support](https://support.stripe.com/contact/email?topic=third_party_integrations&subject=%5BStripe%20Connector%20for%20NetSuite%20(SCN) %5D).

Ungültige Transaktionen gefunden

Der Fehlercode validating_waiting_on_child_records zeigt an, dass die Validierungsprüfung/en einer oder mehrerer Transaktionen der Auszahlung fehlgeschlagen ist/sind. Die Einlage des Auszahlungsbetrags kann erst erstellt werden, wenn Sie alle Validierungsfehler behoben haben. Dies ist ein Wartestatus, während Sie die zugrunde liegenden Transaktionen beheben.

So beheben Sie dieses Problem:

  1. Navigieren Sie in der Connector-App zur Detailseite der Auszahlungen.
  2. Prüfen Sie die Liste der Transaktionen mit Validierungsfehlern.
  3. Jede Transaktion weist einen bestimmten Validierungsfehler auf (z. B. Nichtübereinstimmung des Betrags, bereits eingezahlt, gelöschter Datensatz oder ungültige Tochtergesellschaft).
  4. Beheben Sie jeden Validierungsfehler gemäß den Anweisungen im Abschnitt Validierung von Auszahlungstransaktionen.
  5. Nachdem Sie alle Validierungsfehler behoben haben, wird die Einlage des Auszahlungsbetrags automatisch fortgesetzt.

Validierung der Auszahlungstransaktion

Die folgenden Validierungsfehler können bei einzelnen Transaktionen innerhalb einer Auszahlung auftreten. Jede Transaktion in einer Auszahlung wird validiert, bevor die Einlage erstellt werden kann. Sie können diese Fehler auf der Detailseite der Auszahlung in der Connector-App anzeigen.

Bereits eingezahlt

Der Fehlercode already_deposited gibt an, dass der NetSuite-Datensatz (Barverkauf, Kundenzahlung usw.) den Status „Eingezahlt“ hat, d. h. er ist bereits in einer manuell erstellten NetSuite-Bankeinlage enthalten oder der Zahlungsdatensatz selbst wurde auf ein anderes GL-Konto als nicht eingezahlte Geldmittel aktualisiert. NetSuite bietet keine Möglichkeit, dass derselbe Datensatz zweimal hinterlegt wird.

So beheben Sie dieses Problem:

  1. Melden Sie sich bei Ihrem NetSuite-Konto an.
  2. Navigieren Sie zu einer der Kundenzahlungen mit dem Status already_deposited.
  3. Überprüfen Sie, ob das Konto der Zahlung auf Nicht eingezahlte Geldmittel festgelegt ist.
    • Falls ja, überprüfen Sie das Feld Einlagen-ID, um die manuelle Bankeinlage zu finden.
      • Navigieren Sie zu dieser Bankeinlage und entfernen Sie diese Transaktion von der Bankeinlage.
    • Falls nein, aktualisieren Sie das Konto der Kundenzahlung auf Nicht eingezahlte Geldmittel.
  4. Wiederholen Sie die Synchronisierung der Auszahlung.
  5. Wenn der Datensatz in einer vorherigen Auszahlung korrekt hinterlegt wurde:
    • Die Stripe Transaktion muss möglicherweise von der Auszahlungs-Synchronisierung ausgeschlossen werden.
    • Kontaktieren Sie den [Stripe-Support](https://support.stripe.com/contact/email?topic=third_party_integrations&subject=%5BStripe%20Connector%20for%20NetSuite%20(SCN) %5D), um Unterstützung beim Abgleich zu erhalten.

NetSuite-Datensatz gelöscht

Der Fehlercode deleted_netsuite_record gibt an, dass der mit dieser Stripe-Transaktion verknüpfte NetSuite-Datensatz gelöscht, deaktiviert oder nicht gefunden wurde. Dies kann passieren, wenn jemand den Datensatz manuell gelöscht hat, ein Skript oder einen Workflow gelöscht hat, wenn sich der Datensatz in einer anderen Tochtergesellschaft befindet oder der Datensatz storniert wurde.

So beheben Sie dieses Problem:

  1. Melden Sie sich bei NetSuite an und überprüfen Sie, ob der Datensatz absichtlich gelöscht wurde, indem Sie System Notes oder Audit-Trails überprüfen.
  2. Ist das Löschen unbeabsichtigt erfolgt, erstellen Sie den Datensatz in NetSuite manuell mit dem korrekten Betrag und den Details.
  3. Wenden Sie sich an den Stripe-Support, um die Stripe-Transaktion erneut mit dem korrekten NetSuite-Datensatz zu verknüpfen.
  4. Wiederholen Sie die Synchronisierung der Auszahlung.

NetSuite-Datensatz ist bereits mit einer anderen Transaktion verknüpft

Der Fehlercode duplicate_netsuite_record_in_payout gibt an, dass dieselbe interne NetSuite-Datensatz-ID mit mehreren Stripe-Transaktionen innerhalb dieser Auszahlung verknüpft ist. Jede Stripe-Transaktion muss mit einem eindeutigen NetSuite-Datensatz verknüpft sein. Dieser Fehler tritt in der Regel auf, wenn ein Datensatz manuell falsch verknüpft wird oder doppelte Synchronisierungen doppelte Zuordnungen erstellen. Die Fehlermeldung zeigt, welche Stripe-Ressourcen-ID den Konflikt auslöst und um welche gemeinsam genutzte NetSuite-Datensatz-ID es sich handelt.

So beheben Sie dieses Problem:

  1. Prüfen Sie die Fehlermeldung, um die Stripe-Transaktion, die den Konflikt ausgelöst hat, sowie die gemeinsam genutzte NetSuite-Datensatz-ID zu ermitteln.
  2. Legen Sie fest, welche Stripe-Transaktion mit dem bestehenden NetSuite-Datensatz verknüpft bleiben soll.
  3. Für die andere(n) Transaktion(en) gehen Sie bitte folgendermaßen vor:
    • Erstellen Sie neue NetSuite-Datensätze in NetSuite, die mit den näheren Angaben der Stripe-Transaktionen übereinstimmen.
  4. Verwenden Sie das Tool zur manuellen Überschreibung in der SCN-App-Drawer, um die Transaktion mit dem richtigen NetSuite-Datensatz zu verknüpfen.
  5. Wenn dies nicht funktioniert, kontaktieren Sie den [Stripe-Support](https://support.stripe.com/contact/email?topic=third_party_integrations&subject=%5BStripe%20Connector%20for%20NetSuite%20(SCN) %5D), um die Datensatzverknüpfungen zu aktualisieren.
  6. Wiederholen Sie die Synchronisierung der Auszahlung.

Ungültige Tochtergesellschaft

Der Fehlercode invalid_subsidiary zeigt an, dass die Tochtergesellschaft im NetSuite-Datensatz nicht mit den gültigen Tochtergesellschaften für das Bank-Einlagenkonto übereinstimmt. Dies kann bei NetSuite-Konten mit mehreren Tochtergesellschaften der Fall sein, wenn der Datensatz unter einer anderen Tochtergesellschaft erstellt wird, sich die Tochtergesellschafts-Konfiguration des Bank-Einlagenkontos ändert oder ein Workflow die Tochtergesellschaft des Datensatzes ändert.

So beheben Sie dieses Problem:

  1. Melden Sie sich bei NetSuite an und suchen Sie den mit dieser Transaktion verknüpften NetSuite-Datensatz.
  2. Überprüfen Sie das Feld Tochtergesellschaft im Datensatz.
  3. Vergleichen Sie es mit den in Ihrem Bank-Einlagenkonto konfigurierten Tochtergesellschaften.
  4. Bearbeiten Sie entweder den NetSuite-Datensatz, um eine gültige Tochtergesellschaft zu verwenden, oder aktualisieren Sie das Bank-Einlagenkonto, um diese Tochtergesellschaft aufzunehmen.
  5. Das Ändern von Tochtergesellschaften in Datensätzen kann buchhalterische Auswirkungen haben. Wenden Sie sich an Ihr Buchhaltungsteam.
  6. Wiederholen Sie die Synchronisierung der Auszahlung.

Das Konto für nicht eingezahlte Geldmittel zeigt keine Übereinstimmung

Der Fehlercode undep_funds_account_mismatch zeigt an, dass das Konto für nicht eingezahlte Geldmittel im NetSuite-Datensatz nicht mit dem in Ihren Connector-Einstellungen konfigurierten Konto übereinstimmt. Alle Datensätze einer Auszahlungseinlage müssen auf dasselbe Konto für nicht eingezahlte Geldmittel gebucht werden, damit die Einlage korrekt abgeglichen werden kann.

So beheben Sie dieses Problem:

  1. Melden Sie sich bei NetSuite an und suchen Sie den mit dieser Transaktion verknüpften NetSuite-Datensatz.
  2. Überprüfen Sie das Feld Konto auf dem Posten des Datensatzes.
  3. Vergleichen Sie es mit dem Konto für nicht eingezahlte Geldmittel in Ihren Connector-Einstellungen.
  4. Bearbeiten Sie entweder den NetSuite-Datensatz, um das richtige Konto für nicht eingezahlte Geldmittel zu verwenden, oder aktualisieren Sie Ihre Connector-Einstellungen, um eine Übereinstimmung mit dem in den Datensätzen verwendeten Konto zu erreichen.
  5. Um Konten in Datensätzen zu ändern, müssen möglicherweise Journalbuchungen korrigiert werden. Wenden Sie sich an Ihr Buchhaltungsteam.
  6. Wiederholen Sie die Synchronisierung der Auszahlung.

Transaktionsbetrag stimmt nicht überein

Der Fehlercode unequal_amounts zeigt an, dass der Transaktionsbetrag in Stripe nicht mit dem Betrag im verknüpften NetSuite-Datensatz übereinstimmt. Die Beträge müssen genau übereinstimmen, damit die Einlage der Auszahlung korrekt verbucht wird. Häufige Ursachen für diesen Fehler sind manuelle Änderungen am NetSuite-Datensatzbetrag, Workflows oder Skripte, die Beträge ändern, Unterschiede bei Währungsumrechnungen und in NetSuite angewendete Steuer- oder Gebührenanpassungen.

So beheben Sie dieses Problem:

  1. Notieren Sie sich in der Connector-App den genauen Betrag aus der Stripe-Transaktion.
  2. Melden Sie sich bei NetSuite an und suchen Sie den mit dieser Transaktion verknüpften NetSuite-Datensatz.
  3. Vergleichen Sie das Feld Gesamtbetrag oder Betrag mit dem Stripe-Betrag.
  4. Identifizieren Sie die Quelle der Abweichung, indem Sie System Notes auf manuelle Änderungen oder Workflow- und Skript Logs auf automatische Änderungen überprüfen.
  5. Korrigieren Sie den NetSuite-Datensatz entweder so, dass er mit dem Stripe-Betrag übereinstimmt, oder wenn der NetSuite-Betrag absichtlich abweicht, wenden Sie sich an den [Stripe-Support](https://support.stripe.com/contact/email?topic=third_party_integrations&subject=%5BStripe%20Connector%20for%20NetSuite%20(SCN) %5D), der Ihnen gerne weiterhilft.
  6. Wiederholen Sie die Synchronisierung der Auszahlung.

Einlagensuche fehlgeschlagen

Der Fehlercode deposit_search_failed zeigt an, dass der Connector nicht nach Datensätzen von Einlagen in NetSuite suchen konnte, um zu überprüfen, ob ein Datensatz bereits hinterlegt ist. Dies kann durch Berechtigungsprobleme oder Verbindungsprobleme verursacht werden.

So beheben Sie dieses Problem:

  1. Melden Sie sich als Administrator bei NetSuite an und navigieren Sie zu Einrichtung > Nutzer/innen/Rollen > Rollen verwalten.
  2. Bearbeiten Sie die Stripe-Rolle „Limited Access“ (begrenzter Zugriff).
  3. Vergewissern Sie sich, dass für die Rolle die Berechtigung Transaktionen > Einlagen tätigen mindestens auf Ansicht eingestellt ist.
  4. Überprüfen Sie, ob die Berechtigung Berichte > Suchen aktiviert ist.
  5. Wiederholen Sie die Synchronisierung der Auszahlung. Wenn der Fehler weiterhin auftritt, kontaktieren Sie den [Stripe-Support](https://support.stripe.com/contact/email?topic=third_party_integrations&subject=%5BStripe%20Connector%20for%20NetSuite%20(SCN) %5D).

Sonstige Auszahlungsfehler

Wenn einer der folgenden Fehlercodes auftritt, weisen er auf interne Probleme hin, die der Connector entweder automatisch wiederholt oder für deren Behebung der Stripe-Support eingeschaltet werden muss.

  • unexpected_breakage_error: Ein unerwarteter interner Fehler ist aufgetreten.
  • unexpected_subsidiary_initialization_error: Bei der Initialisierung von Daten zur Tochtergesellschaft ist ein Fehler aufgetreten.
  • multiple_successful_translations_found: Ein Problem mit der Datenintegrität, bei dem dieselbe Transaktion mehrmals synchronisiert wurde.

Wenden Sie sich bei diesen Fehler mit Ihrer Auszahlungs-ID (z. B. po_xxx) und dem Fehlercode an den Stripe-Support.

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.

FehlerBeschreibung
scn_account_disabledIhr Stripe-Connector für die NetSuite-Integration ist nicht aktiviert. Um sie einzuschalten, gehen Sie zu den App-Einstellungen und wählen Sie Einschalten.
scn_amount_dueDas 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_largeDer 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_smallDer fällige Betrag liegt unter dem zulässigen Mindestbetrag. Verwenden Sie eine höhere Menge und versuchen Sie es noch einmal.
scn_currency_not_foundFür den NetSuite-Rechnungsdatensatz oder den Kundendatensatz ist keine Währung festgelegt.
scn_duplicate_keyZwei Prozesse haben gleichzeitig versucht, eine Checkout-Sitzung zu erstellen. Erneut versuchen.
scn_invalid_argumentDer NetSuite-Kunde/die NetSuite-Kundin wurde nicht gefunden. Stripe blockiert die Erstellung einer Checkout-Sitzung.
scn_invalid_customer_recordDer 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_idDer 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_valueDer Wert für den Live-Modus des NetSuite-Pakets ist falsch.
scn_invalid_merchant_accountStripe 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_resourceDie 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_typeSie 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_metSie haben versucht, eine Kundenzahlungsseite für einen Kunden/eine Kundin zu erstellen, dessen/deren Guthaben unter dem Mindestzahlungsbetrag (50 Cent, USD) liegt.
scn_missing_amountAuf der Rechnung fehlt das Feld „Fälliger Betrag“. Aktivieren Sie diese Option für alle nutzerdefinierten Rechnungsformulare:
  • Gehen Sie zu Anpassung > Formulare > Transaktionsformulare und filtern Sie nach Rechnungstyp.
  • Bearbeiten Sie alle nutzerdefinierten Rechnungsformulare (mit der Option Bearbeiten).
  • Sehen Sie unter der Registerkarte Screen Fields (Bildschirmfelder) nach. Aktivieren Sie unbedingt Fälliger Betrag unter Anzeigen.
  • Wenn kein nutzerdefiniertes Formular vorhanden ist, erstellen Sie eines, indem Sie auf dem gewünschten Formular auf Anpassen klicken.
  • Speichern Sie alle Änderungen.
scn_no_customer_balanceDer NetSuite-Kunde/die NetSuite-Kundin hat kein Guthaben.
scn_no_guidDie 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_idDie 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_availableEs liegen keine gültigen Zahlungsmethodentypen für die Checkout-Sitzung vor.
scn_no_resource_lockEine 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_exceededAlle NetSuite-Verbindungen werden verwendet und die Anforderung war begrenzt. Versuchen Sie es später noch einmal.
scn_ns_data_center_not_foundEine NetSuite-Verbindungs-URL wurde nicht gefunden. Überprüfen Sie Ihre Kontokonfiguration und versuchen Sie es später noch einmal.
scn_ns_invalid_login_attemptVerbindung 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_changedDer Datensatz wurde gleichzeitig durch einen anderen Vorgang geändert. Versuchen Sie es später noch einmal.
scn_ns_unexpected_errorIn NetSuite ist ein unerwarteter Fehler aufgetreten. Versuchen Sie es später noch einmal.
scn_payment_links_not_enabled oder scn_customer_payment_page_not_enabledDie 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_foundStripe 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_partsDie 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_errorEin unbekannter Fehler ist aufgetreten. Wenden Sie sich an den [Stripe-Support](https://support.stripe.com/contact/email?topic=third_party_integrations&subject=%5BStripe%20Connector%20for%20NetSuite%20(SCN) %5D).
scn_unsupported_record_typeSie haben versucht, einen Zahlungslink aus einer NetSuite-Bestellung 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.

FeldBeschreibung
WährungDieses Feld ist obligatorisch und muss auf allen Rechnungsvorlagen erscheinen, die mit dem Stripe-Zahlungslink verwendet werden.
Zu zahlender Betrag / Verbleibender BetragStellen 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.

Zugriffsrollen

Die GUID kann verschwinden, nachdem Sie sie für bestimmte Zugriffsrollen gespeichert haben, die weniger Berechtigungen als ein Administrator haben. Beispielsweise ist der Zugriff View nicht ausreichend. Um die entsprechenden Berechtigungen zu erteilen, gehen Sie zum benutzerdefinierten Feld Stripe Payment Page Guid (custbody_stripe_payment_link_guid) und wählen Sie Zugriff. Fügen Sie die Rolle hinzu und erteilen Sie im benutzerdefinierten Feld den Zugriff Edit.

Massen-Synchronisierung von Datensätzen

Verwenden Sie das Support-Tool, um Stripe-Datensätze für die erneute Synchronisierung hinzuzufügen und deren Fortschritt zu verfolgen.

Status synchronisieren

  1. Gehen Sie im Dashboard zu Einstellungen > Installierte Apps > Stripe Connector for NetSuite > Support-Tools.

  2. Klicken Sie auf Datensätze synchronisieren.

  3. Fügen Sie eine oder mehrere Stripe-Ressourcen-IDs ein, getrennt durch Kommas. Die maximale Anzahl von IDs, die Sie gleichzeitig übermitteln können, wird in der Nutzeroberfläche angezeigt.

  4. Klicken Sie auf Absenden.

Nachdem Sie auf „Senden“ geklickt haben, werden akzeptierte IDs sofort zur Warteschlange hinzugefügt. Abgelehnte IDs werden in einer Fehlerliste mit einem der folgenden Gründe angezeigt:

  • Beheben Sie das Problem (z. B. korrigieren Sie eine ungültige ID).
  • Reichen Sie gegebenenfalls alle fehlgeschlagenen Ausweise erneut ein.

Synchronisierungsstatus anzeigen

Um den Synchronisierungsstatus anzuzeigen, klicken Sie auf der Seite Support-Tools auf Synchronisierungsstatus anzeigen, fügen Sie die durch Kommas getrennten IDs ein, die Sie überprüfen möchten, und klicken Sie auf Senden.

Prüfen Sie die folgenden Abschnitte, um den Status von Warteschlangen, Synchronisierungen und Fehlertypen zu erfahren.

Status der Warteschlangen

StatusBeschreibung
In der WarteschlangeWarten auf die Bearbeitung
ErfolgreichOhne Fehler synchronisiert
FehlgeschlagenDie Synchronisierung ist fehlgeschlagen. Bewegen Sie den Mauszeiger über den Fehlertyp, um Details anzuzeigen.

Synchronisierungsstatus

StatusBeschreibung
Vor der VerfüllungDer Datensatz liegt vor dem Go-Live-Datum vor
ErfolgreichOhne Fehler synchronisiert
FehlgeschlagenDie Synchronisierung ist fehlgeschlagen. Bewegen Sie den Mauszeiger über den Fehlertyp, um Details anzuzeigen.

Fehlertypen

FehlertypBeschreibung
Falsche Stripe-Ressourcen-IDÜberprüfen Sie die eingegebene ID erneut
Nicht übersetzbare Ressourcen-IDDie ID ist gültig, kann jedoch nicht synchronisiert werden.
Bereits erfolgreiche Ressourcen-IDID bereits erfolgreich, kein erneuter Versuch erforderlich
Ressourcendaten nicht gefundenDaten für die ID können nicht abgerufen werden
Synchronisierung fehlgeschlagenBewegen Sie den Mauszeiger über den Fehler, um Details anzuzeigen.

Vorrangig

Die Spalte „Vorrangig“ gibt an, dass die Datensatzsynchronisierung für die angegebene ID Vorrang vor anderen Datensatzsynchronisierungen hat.

War diese Seite hilfreich?
JaNein
  • Benötigen Sie Hilfe? Kontaktieren Sie den Kundensupport.
  • Schauen Sie sich unser Änderungsprotokoll an.
  • Fragen? Sales-Team kontaktieren.
  • LLM? Lesen Sie llms.txt.
  • Unterstützt von Markdoc