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 | 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
|
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 | Ä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_ (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_) so aktualisieren, dass er auf die korrekte interne NetSuite-Gutschrift-ID verweist. | Aktualisieren Sie den netsuite_-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. |
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_ 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:
- Melden Sie sich bei Ihrem NetSuite-Konto an.
- Navigieren Sie zu Listen > Buchhaltung > Konten.
- Überprüfen Sie das Vorhandensein des Bank-Einlagenkontos und notieren Sie sich dessen interne Nummer.
- Überprüfen Sie, ob die Person mit der Stripe-Rolle Stripe Limited Access (begrenzter Zugang) berechtigt ist, das Konto anzuzeigen.
- Gehen Sie in der Stripe Connector for NetSuite-App zu App-Einstellungen.
- 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_ 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:
- Navigieren Sie in der Connector-App zur Detailseite der Auszahlungen.
- Prüfen Sie die Liste der Transaktionen mit Synchronisierungsproblemen.
- Überprüfen Sie für jede nicht synchronisierte Transaktion deren Synchronisierungsstatus und Fehlermeldung.
- Beheben Sie alle Fehler, die die Synchronisierung verhindern (z. B. fehlende Kundinnen und Kunden oder Probleme mit der Kontozuordnung).
- 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_ 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:
- Prüfen Sie die spezifische Fehlermeldung, um festzustellen, welche Kontozuordnung fehlt.
- Gehen Sie in der Connector-App zu App-Einstellungen > Kontenzuordnung.
- Konfigurieren Sie die erforderliche Kontozuordnung und speichern Sie Ihre Änderungen.
- Wiederholen Sie die Synchronisierung der Auszahlung.
NetSuite-Bank-Einlagenkonto nicht eingerichtet
Der Wert payout_ 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:
- Gehen Sie in der Connector-App zu App-Einstellungen > Kontenzuordnung.
- Suchen Sie im Abschnitt Bank-Einlagenkonten.
- Fügen Sie ein Bank-Einlagenkonto hinzu, das der Währung der Auszahlung zugeordnet ist.
- Speichern Sie Ihre Änderungen und wiederholen Sie die Synchronisierung der Auszahlung.
NetSuite-Tochtergesellschaft nicht verfügbar
Der Fehlercode subsidary_ 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:
- Melden Sie sich als Administrator bei NetSuite an und navigieren Sie zu Einrichtung > Nutzer/innen/Rollen > Rollen verwalten.
- Bearbeiten Sie die Stripe-Rolle „Limited Access“ (begrenzter Zugriff).
- Stellen Sie unter der Registerkarte Tochtergesellschaften sicher, dass die Rolle Zugriff auf alle erforderlichen Tochtergesellschaften hat.
- Vergewissern Sie sich, dass die Berechtigung Listen > Tochtergesellschaften mindestens auf Ansicht eingestellt ist.
- Speichern Sie die Änderungen der Funktion; Position; Rolle und wiederholen Sie die Auszahlung.
Suche nach NetSuite-Tochtergesellschaft fehlgeschlagen
Der Fehlercode subsidary_ 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:
- Warten Sie ein paar Minuten und wiederholen Sie die Synchronisierung der Auszahlung.
- Wenn der Fehler weiterhin auftritt, melden Sie sich als Administrator bei NetSuite an und navigieren Sie zu Einrichtung > Nutzer/innen/Rollen > Rollen verwalten.
- Vergewissern Sie sich, dass bei der Berechtigung der Stripe-Rolle „Limited Access“ Listen > Tochtergesellschaften auf Vollständig gesetzt ist und Berichte > Suche aktiviert ist.
- Überprüfen Sie, ob die Tochtergesellschaften auf dem Bank-Einlagenkonto ordnungsgemäß konfiguriert sind.
- 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_ 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:
- Melden Sie sich bei NetSuite an und navigieren Sie zu Listen > Buchhaltung > Konten.
- Suchen Sie nach Ihrem Konto für nicht eingezahlte Geldmittel und überprüfen Sie, ob es vorhanden und aktiv ist.
- Überprüfen Sie, ob die Stripe-Rolle „Limited Access“ (begrenzter Zugriff)berechtigt ist, das Konto anzuzeigen.
- Gehen Sie in der Connector-App zu App-Einstellungen > Kontenzuordnung und aktualisieren Sie bei Bedarf die Kontozuordnung der nicht eingezahlten Geldmittel.
- Wiederholen Sie die Synchronisierung der Auszahlung.
NetSuite-Konto für nicht eingezahlte Geldmittel nicht eingerichtet
Der Fehlercode undep_ 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:
- Gehen Sie in der Connector-App zu App-Einstellungen > Kontenzuordnung.
- Suchen Sie die Einstellung Konto für nicht eingezahlte Geldmittel.
- Wählen Sie aus Ihrem NetSuite-Kontenplan das entsprechende Konto für nicht eingezahlte Geldmittel aus.
- Speichern Sie Ihre Änderungen und wiederholen Sie die Synchronisierung der Auszahlung.
Temporärer NetSuite-Fehler
Der Fehlercode transient_ 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_ 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:
- Navigieren Sie in der Connector-App zur Detailseite der Auszahlungen.
- Prüfen Sie die Liste der Transaktionen mit Validierungsfehlern.
- Jede Transaktion weist einen bestimmten Validierungsfehler auf (z. B. Nichtübereinstimmung des Betrags, bereits eingezahlt, gelöschter Datensatz oder ungültige Tochtergesellschaft).
- Beheben Sie jeden Validierungsfehler gemäß den Anweisungen im Abschnitt Validierung von Auszahlungstransaktionen.
- 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_ 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:
- Melden Sie sich bei Ihrem NetSuite-Konto an.
- Navigieren Sie zu einer der Kundenzahlungen mit dem Status
already_.deposited - Ü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.
- Falls ja, überprüfen Sie das Feld Einlagen-ID, um die manuelle Bankeinlage zu finden.
- Wiederholen Sie die Synchronisierung der Auszahlung.
- 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_ 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:
- 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.
- Ist das Löschen unbeabsichtigt erfolgt, erstellen Sie den Datensatz in NetSuite manuell mit dem korrekten Betrag und den Details.
- Wenden Sie sich an den Stripe-Support, um die Stripe-Transaktion erneut mit dem korrekten NetSuite-Datensatz zu verknüpfen.
- Wiederholen Sie die Synchronisierung der Auszahlung.
NetSuite-Datensatz ist bereits mit einer anderen Transaktion verknüpft
Der Fehlercode duplicate_ 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:
- Prüfen Sie die Fehlermeldung, um die Stripe-Transaktion, die den Konflikt ausgelöst hat, sowie die gemeinsam genutzte NetSuite-Datensatz-ID zu ermitteln.
- Legen Sie fest, welche Stripe-Transaktion mit dem bestehenden NetSuite-Datensatz verknüpft bleiben soll.
- 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.
- Verwenden Sie das Tool zur manuellen Überschreibung in der SCN-App-Drawer, um die Transaktion mit dem richtigen NetSuite-Datensatz zu verknüpfen.
- 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.
- Wiederholen Sie die Synchronisierung der Auszahlung.
Ungültige Tochtergesellschaft
Der Fehlercode invalid_ 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:
- Melden Sie sich bei NetSuite an und suchen Sie den mit dieser Transaktion verknüpften NetSuite-Datensatz.
- Überprüfen Sie das Feld Tochtergesellschaft im Datensatz.
- Vergleichen Sie es mit den in Ihrem Bank-Einlagenkonto konfigurierten Tochtergesellschaften.
- Bearbeiten Sie entweder den NetSuite-Datensatz, um eine gültige Tochtergesellschaft zu verwenden, oder aktualisieren Sie das Bank-Einlagenkonto, um diese Tochtergesellschaft aufzunehmen.
- Das Ändern von Tochtergesellschaften in Datensätzen kann buchhalterische Auswirkungen haben. Wenden Sie sich an Ihr Buchhaltungsteam.
- Wiederholen Sie die Synchronisierung der Auszahlung.
Das Konto für nicht eingezahlte Geldmittel zeigt keine Übereinstimmung
Der Fehlercode undep_ 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:
- Melden Sie sich bei NetSuite an und suchen Sie den mit dieser Transaktion verknüpften NetSuite-Datensatz.
- Überprüfen Sie das Feld Konto auf dem Posten des Datensatzes.
- Vergleichen Sie es mit dem Konto für nicht eingezahlte Geldmittel in Ihren Connector-Einstellungen.
- 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.
- Um Konten in Datensätzen zu ändern, müssen möglicherweise Journalbuchungen korrigiert werden. Wenden Sie sich an Ihr Buchhaltungsteam.
- Wiederholen Sie die Synchronisierung der Auszahlung.
Transaktionsbetrag stimmt nicht überein
Der Fehlercode unequal_ 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:
- Notieren Sie sich in der Connector-App den genauen Betrag aus der Stripe-Transaktion.
- Melden Sie sich bei NetSuite an und suchen Sie den mit dieser Transaktion verknüpften NetSuite-Datensatz.
- Vergleichen Sie das Feld Gesamtbetrag oder Betrag mit dem Stripe-Betrag.
- Identifizieren Sie die Quelle der Abweichung, indem Sie System Notes auf manuelle Änderungen oder Workflow- und Skript Logs auf automatische Änderungen überprüfen.
- 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.
- Wiederholen Sie die Synchronisierung der Auszahlung.
Einlagensuche fehlgeschlagen
Der Fehlercode deposit_ 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:
- Melden Sie sich als Administrator bei NetSuite an und navigieren Sie zu Einrichtung > Nutzer/innen/Rollen > Rollen verwalten.
- Bearbeiten Sie die Stripe-Rolle „Limited Access“ (begrenzter Zugriff).
- Vergewissern Sie sich, dass für die Rolle die Berechtigung Transaktionen > Einlagen tätigen mindestens auf Ansicht eingestellt ist.
- Überprüfen Sie, ob die Berechtigung Berichte > Suchen aktiviert ist.
- 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_: Ein unerwarteter interner Fehler ist aufgetreten.breakage_ error unexpected_: Bei der Initialisierung von Daten zur Tochtergesellschaft ist ein Fehler aufgetreten.subsidiary_ initialization_ error multiple_: Ein Problem mit der Datenintegrität, bei dem dieselbe Transaktion mehrmals synchronisiert wurde.successful_ translations_ found
Wenden Sie sich bei diesen Fehler mit Ihrer Auszahlungs-ID (z. B. po_) 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.
| Fehler | Beschreibung |
|---|---|
scn_ | Ihr 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_ | 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_ | 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_ | Der fällige Betrag liegt unter dem zulässigen Mindestbetrag. Verwenden Sie eine höhere Menge und versuchen Sie es noch einmal. |
scn_ | Für den NetSuite-Rechnungsdatensatz oder den Kundendatensatz ist keine Währung festgelegt. |
scn_ | Zwei Prozesse haben gleichzeitig versucht, eine Checkout-Sitzung zu erstellen. Erneut versuchen. |
scn_ | Der NetSuite-Kunde/die NetSuite-Kundin wurde nicht gefunden. Stripe blockiert die Erstellung einer Checkout-Sitzung. |
scn_ | 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_ | 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_ | Der Wert für den Live-Modus des NetSuite-Pakets ist falsch. |
scn_ | 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_ | 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_ | 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_ | Sie haben versucht, eine Kundenzahlungsseite für einen Kunden/eine Kundin zu erstellen, dessen/deren Guthaben unter dem Mindestzahlungsbetrag (50 Cent, USD) liegt. |
scn_ | Auf der Rechnung fehlt das Feld „Fälliger Betrag“. Aktivieren Sie diese Option für alle nutzerdefinierten Rechnungsformulare:
|
scn_ | Der NetSuite-Kunde/die NetSuite-Kundin hat kein Guthaben. |
scn_ | 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_ | Die Struktur des Zahlungslinks ist ungültig. Die GUID muss aus genau zwei Teilen bestehen, die durch einen Unterstrich getrennt sind. Beispiel: F1783B96F2111D47E053972C0C0AAEB5_. |
scn_ | Es liegen keine gültigen Zahlungsmethodentypen für die Checkout-Sitzung vor. |
scn_ | 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_ | Alle NetSuite-Verbindungen werden verwendet und die Anforderung war begrenzt. Versuchen Sie es später noch einmal. |
scn_ | Eine NetSuite-Verbindungs-URL wurde nicht gefunden. Überprüfen Sie Ihre Kontokonfiguration und versuchen Sie es später noch einmal. |
scn_ | Verbindung zu NetSuite fehlgeschlagen. Überprüfen Sie Ihre Kontoanmeldedaten und versuchen Sie es erneut. Dieser Fehler kann auch bei korrekten Anmeldeinformationen zeitweise auftreten. |
scn_ | Der Datensatz wurde gleichzeitig durch einen anderen Vorgang geändert. Versuchen Sie es später noch einmal. |
scn_ | In NetSuite ist ein unerwarteter Fehler aufgetreten. Versuchen Sie es später noch einmal. |
scn_ oder scn_ | 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_ | Über die Kundenzahlungsseite wurde innerhalb der letzten 24 Stunden eine erfolgreiche Zahlung übermittelt. Pro Tag ist nur eine Zahlung zulässig. |
scn_ | 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:
|
scn_ | Die Struktur des Zahlungslinks ist ungültig. Die GUID muss aus genau zwei Teilen bestehen, die durch einen Unterstrich getrennt sind. Beispiel: F1783B96F2111D47E053972C0C0AAEB5_. |
scn_ | Ein 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_ | Sie 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_in die Metadaten einer doppelten Stripe-Zahlung ein.allow_ duplicate: true
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.
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_) 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
Gehen Sie im Dashboard zu Einstellungen > Installierte Apps > Stripe Connector for NetSuite > Support-Tools.
Klicken Sie auf Datensätze synchronisieren.
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.
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
| Status | Beschreibung |
|---|---|
| In der Warteschlange | Warten auf die Bearbeitung |
| Erfolgreich | Ohne Fehler synchronisiert |
| Fehlgeschlagen | Die Synchronisierung ist fehlgeschlagen. Bewegen Sie den Mauszeiger über den Fehlertyp, um Details anzuzeigen. |
Synchronisierungsstatus
| Status | Beschreibung |
|---|---|
| Vor der Verfüllung | Der Datensatz liegt vor dem Go-Live-Datum vor |
| Erfolgreich | Ohne Fehler synchronisiert |
| Fehlgeschlagen | Die Synchronisierung ist fehlgeschlagen. Bewegen Sie den Mauszeiger über den Fehlertyp, um Details anzuzeigen. |
Fehlertypen
| Fehlertyp | Beschreibung |
|---|---|
| Falsche Stripe-Ressourcen-ID | Überprüfen Sie die eingegebene ID erneut |
| Nicht übersetzbare Ressourcen-ID | Die ID ist gültig, kann jedoch nicht synchronisiert werden. |
| Bereits erfolgreiche Ressourcen-ID | ID bereits erfolgreich, kein erneuter Versuch erforderlich |
| Ressourcendaten nicht gefunden | Daten für die ID können nicht abgerufen werden |
| Synchronisierung fehlgeschlagen | Bewegen 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.