Fehlerbehandlung

Erfahren Sie, wie Sie Fehler bei der Synchronisierung von Salesforce-Datensätzen über den Connector beheben.

Wenn bei der Verwendung des Stripe Billing Connectors für Salesforce CPQ zur Synchronisierung von Datensätzen zwischen Salesforce und Stripe Fehler auftreten, können Sie anhand der nachstehende Liste die Fehler identifizieren und beheben. In den meisten Fällen müssen Sie die Salesforce-Datensatzdaten ändern und den Datensatz manuell erneut synchronisieren, um den Fehler zu beheben.

Datenfehler

Die folgende Tabelle enthält die Fehler, die beim Synchronisieren von Salesforce-Aufträge auftreten können, und Informationen dazu, wie Sie diese beheben können.

Fehler	Beschreibung	Empfehlung
Nicht unterstützter Feldwert für `days_until_due`.	Der Wert des zugeordneten Felds für `days_until_due` muss eine Ganzzahl oder ein unterstütztes `CPQ Payment Term` sein.	Aktualisieren Sie den Wert des zugeordneten Felds für `days_until_due` mit einer Ganzzahl oder einem unterstützten `CPQ Payment Term` (z. B. Net-15, Net-30, Net-45, Net-60 oder Net-90).
Erforderliche Zuordnungen für das Stripe-Objekt waren leer.	Für den Connector müssen bestimmte Felder für den Auftrag und die Auftragsposten ausgefüllt werden.	Navigieren Sie in Salesforce zur Stripe Billing-Anwendung und öffnen Sie den Data Mapper. Stellen Sie sicher, dass Sie alle Pflichtfelder unter `Subscription Schedule`, `Subscription Item` und `Price Order Item` festgelegt haben.
Der Auftragsposten wurde gelöscht oder ist nicht aktiviert.	Aus den Feldern des Auftragspostens geht hervor, dass der Posten gelöscht oder nicht aktiviert wurde.	Stellen Sie sicher, dass alle Auftragsposten aktiviert sind und nicht gelöscht wurden.
Der Connector hat beim Überspringen des Erstauftrags versucht, den Änderungsauftrag zu synchronisieren, da er nicht den benutzerdefinierten Synchronisierungsfiltern entsprach.	Sie können benutzerdefinierte Auftragsfilter in der Stripe Billing-Anwendung in Salesforce angeben. Diese Filter bestimmen, ob der Salesforce-Auftrag synchronisiert werden soll oder nicht.	Sie können Salesforce-Änderungsaufträge erst synchronisieren, wenn der entsprechende Salesforce-Erstauftrag synchronisiert wurde. Dieser Fehler gibt an, dass der Salesforce-Erstauftrag nicht synchronisiert werden konnte, weil sie die Auftragsfilterkriterien nicht erfüllt hat, obwohl die Salesforce-Auftragsänderung erfolgreich war.

Änderungsfehler

Die nachstehende Tabelle enthält die Fehler im Zusammenhang mit den Änderungsaufträgen und wie diese behoben werden können.

Fehler	Beschreibung	Empfehlung
Daten der Auftragsänderungen müssen mit dem Enddatum des Erstauftrags übereinstimmen.	Der Salesforce-Änderungsauftrag muss am selben Tag enden wie der Salesforce-Erstauftrag.	Ändern Sie die Salesforce-Auftragsänderung so, dass das Enddatum mit dem Datum des Erstauftrags übereinstimmt. Dieser Fehler kann auftreten, wenn Sie die Abonnementlaufzeit aktualisieren.
Das Stripe-Abonnement für den Evergreen-Auftrag wurde bereits gekündigt und kann nicht mehr geändert werden.	Der Connector hat einen Evergreen-Änderungsauftrag von Salesforce synchronisiert. Dadurch wird versucht, ein storniertes Stripe-Abonnement zu ändern.	Der Salesforce-Änderungsauftrag kann nicht synchronisiert werden.
Der Stripe-Abonnementplan wurde bereits gekündigt und kann nicht mehr geändert werden.	Der Connector hat einen Evergreen-Änderungsauftrag von Salesforce synchronisiert. Dadurch wird versucht, einen stornierten Stripe-Abonnementplan zu ändern.	Der Salesforce-Änderungsauftrag kann nicht synchronisiert werden.
Änderungsaufträge müssen am selben Tag des Monats wie der Erstauftrag beginnen. Aktivieren Sie die Funktion für Änderungsanträge im Nicht-Jährlichen-Rhythmus, um Änderungsanträge an einem beliebigen Tag des Monats zu synchronisieren.	Der Salesforce-Änderungsauftrag beginnt an einem anderen Tag des Monats als die Erstauftrag.	Aktualisieren Sie den Salesforce-Änderungsauftrag so, dass er am selben Tag des Monats wie der Salesforce-Erstauftrag beginnt. Kontaktieren Sie alternativ den Support, um Änderungen im Nicht-Jährlichen-Rhythmus in Ihrem Konto zu aktivieren.
Die Laufzeit des Abonnements des Änderungsauftrags entspricht keinem ganzzahligen Wert der Monate zwischen dem Start- und Enddatum.	Dies tritt auf, wenn eine Änderung im Nicht-Jahres-Rhythmus synchronisiert wird und die Abonnementlaufzeit für das Angebot eine unerwartete Länge hat.	Ändern Sie die Abonnementlaufzeit für den Salesforce-Änderungsauftrag auf einen ganzen Monat zwischen dem Start- und Enddatum des Salesforce-Auftrags.
Der entsprechende Stripe-Abonnementzeitplan für den Änderungsauftrag konnte nicht gefunden werden.	Durch einen geänderten Salesforce-Auftrag ändert sich auch der Salesforce-Erstauftrag, der zuvor synchronisiert wurde. Dieser Fehler gibt an, dass der entsprechende Stripe-Abonnementzeitplan, der bei der Synchronisierung des Salesforce-Erstauftrags erstellt wurde, nicht gefunden wurde, da er gelöscht wurde.	Der Salesforce-Änderungsauftrag kann nicht synchronisiert werden.
Das Szenario der im Backend anteilig verrechneten Auftragsänderung wird nicht unterstützt.	Durch einen Salesforce-Änderungsauftrag wird ein Erstauftrag geändert, der im Backend anteilig verrechnet wurde, dessen Startdaten jedoch nicht übereinstimmen.	Der Connector unterstützt dieses Anwendungsszenario nicht. Kontaktieren Sie den Support, um Infos zum weiteren Vorgehen zu erhalten.
Die geänderte Bestellung steht für alle einmaligen Rechnungen.	Die geänderte Bestellung muss die ursprüngliche Bestellung ändern.	Um eine Bestellung mit einmaligen Rechnungsposten zu synchronisieren, müssen Sie eine neue Bestellung erstellen und mit den einmaligen Rechnungsposten synchronisieren.
Für die geänderte Bestellung wurde mehr als ein Vertrag gefunden.	Der Connector hat mehrere Verträge erkannt, die mit der geänderten Bestellung verknüpft sind.	Stellen Sie sicher, dass mit der geänderten Bestellung nur ein Vertrag verknüpft ist.
Für die geänderte Bestellung wurde mehr als ein Angebot gefunden.	Der Connector hat mehrere Angebote erkannt, die mit der geänderten Bestellung verknüpft sind.	Stellen Sie sicher, dass nur ein Angebot an die geänderte Bestellung gebunden ist.
Die geänderte Bestellung ist nicht mit einem Angebot verknüpft.	Der Connector konnte kein entsprechendes Angebot finden, das mit der geänderten Bestellung verknüpft ist.	Stellen Sie sicher, dass jede geänderte Bestellung ein entsprechendes Angebot enthält.

Angebotsfehler

Die nachstehende Tabelle enthält die Fehler im Zusammenhang mit den CPQ-Angeboten und wie diese behoben werden können.

Fehler	Beschreibung	Empfehlung
Es ist kein CPQ-Angebot mit dem Salesforce-Auftrag verknüpft. An Stripe übermittelte Aufträge müssen ein zugehöriges CPQ-Angebot haben.	Alle Salesforce-Aufträge benötigen ein entsprechendes CPQ-Angebot. Dieser Fehler weist darauf hin, dass der Connector kein entsprechendes Angebot finden konnte.	Generieren Sie den Salesforce-Auftrag aus einem Salesforce CPQ-Angebot erneut.
Das mit der Auftragsänderung verknüpfte Salesforce CPQ-Erstangebot konnte nicht gefunden werden.	Alle Salesforce-Aufträge, die über den Connector synchronisiert werden, benötigen ein zugehöriges Salesforce CPQ-Angebot.	Generieren Sie den Salesforce-Auftrag aus einem Salesforce CPQ-Angebot erneut.
Sie können die Abonnementlaufzeit nicht als Dezimalwert angeben.	Die Abonnementlaufzeit entspricht der Vertragslaufzeit in Monaten. Dieser Wert darf keine Dezimalzahl sein.	Ändern Sie die zugeordnete Abonnementlaufzeit mit einem ganzzahligen Wert.
Die Abrechnungshäufigkeit ist keine unterstützte Option für `CPQ Billing Frequency`.	CPQ unterstützt folgende Werte für das Feld `SBQQ__BillingFrequency__c`: monatlich, vierteljährlich, halbjährlich und jährlich.	Aktualisieren Sie den Wert des Feldes `CPQ Billing Frequency` auf `Monthly`, `Quarterly`, `Semiannual` oder `Annual`.

Preisfehler

Die nachstehende Tabelle enthält die Fehler im Zusammenhang mit den Preisen und wie diese behoben werden können.

Fehler	Beschreibung	Empfehlung
Es wurde ein entsprechender Stripe-Preis für den Salesforce-Preis gefunden, aber die Preisdaten haben sich geändert.	Der mit dem Auftragsposten verknüpfte Salesforce-Preisbucheintrag wurde zuvor synchronisiert und die entsprechenden Stripe-Preisdaten haben sich geändert.	Löschen Sie die Stripe-ID aus dem Salesforce-Preisbucheintrag und synchronisieren Sie den Salesforce-Auftrag erneut. Es ergibt sich ein neuer Stripe-Preis für den Preisbucheintrag.
Einem Preisbuch sind mehrere Verbrauchsregelungen zugeordnet, es kann jedoch nur eine geben.	Der Connector hat mehr als eine Verbrauchsregelung gefunden, die mit einem Preisbuch verknüpft ist, es kann jedoch nur eine geben.	Löschen Sie eine der Verbrauchsregelungen, die dem Preisbucheintrag zugeordnet sind.
Die Abonnementlaufzeit darf kein Dezimalwert sein.	Die Abonnementlaufzeit entspricht der Vertragslaufzeit in Monaten. Dieser Wert darf keine Dezimalzahl sein.	Ändern Sie die zugeordnete Abonnementlaufzeit in einen ganzzahligen Wert.
Für die obere Klassengrenze wurde ein Dezimalwert angegeben, die Klassengrenzen der Verbrauchsrate müssen jedoch ganzzahlig sein.	Der Connector hat einen Dezimalwert für die Obergrenze der Salesforce-Verbrauchsrate gefunden.	Ändern Sie die Klassengrenze der Salesforce-Verbrauchsrate in eine Ganzzahl.
Die Preismethode für die Verbrauchsrate wird nicht unterstützt.	Das Feld `SBQQ__PricingMethod__c` akzeptiert die Werte `PerUnit` oder `FlatFee`.	Ändern Sie den Feldwert für `SBQQ__PricingMethod__c` auf `PerUnit` oder `FlatFee` ab.
Die Verbrauchsregelungsart wird nicht unterstützt.	Das Feld `Consumption Schedule Type` akzeptiert Werte für `Range` oder `Slab`.	Aktualisieren Sie den `Consumption Schedule Type` entweder auf `Range` oder `Slab`.
Das Feld `unit_amount_decimal` darf im Falle von Stripe-Preisobjekten nicht leer sein.	Der Connector hat einen leeren Wert für den zugeordneten Salesforce-Wert gefunden, Preisfelder dürfen jedoch nicht leer sein.	Ändern Sie den zugeordneten Salesforce-Wert in eine positive Ganzzahl ab.
Unerwarteter Wert `billing_scheme` des Stripe-Preises.	Das Preisschema ist nicht auf einen gültigen Wert festgelegt.	Ändern Sie das Abrechnungsschema auf `per_unit` oder `tiered` ab.
Das Preisintervall wird nicht unterstützt.	Das Preisintervall ist nicht auf einen gültigen Wert festgelegt.	Aktualisieren Sie das Preisintervall auf `Month` oder `Year`.
Der abgerufene Stripe-Preis war leer.	Der entsprechende Stripe-Preis muss einen Wert haben.	Entfernen Sie die Stripe-Preis-ID aus dem entsprechenden Salesforce-Datensatz und versuchen Sie dann erneut, die fehlgeschlagene Bestellung zu synchronisieren.
Es wurden zwei Stufen mit einer unendlichen Grenze zum gleichen Preis gefunden.	Der Connector hat zwei Salesforce `ConsumptionRate`-Objekte gefunden, die mit einem einzigen `ConsumptionSchedule` verknüpft sind, wobei die Obergrenzen von beiden auf unendlich festgelegt sind.	Aktualisieren Sie einen der `ConsumptionRate`-Datensätze so, dass er eine endliche Obergrenze aufweist, wodurch die unendliche Grenzbedingung aufgehoben wird.
Die Standardwährung ist nicht in Ihrer Kontokonfiguration angegeben.	Der Connector konnte keine Standardwährung finden.	Legen Sie die Standardwährung für Ihre Organisation in Salesforce fest und stellen Sie sicher, dass die Einstellung des Connectors für `Billing Currency` die richtige Währung anzeigt.

Produktfehler

Die nachstehende Tabelle enthält die Fehler im Zusammenhang mit den Salesforce-Produkten und wie diese behoben werden können.

Fehler	Beschreibung	Empfehlung
Die Produktabrechnungsart ist keine unterstützte Option für `CPQ Product Billing Type`.	Die Abrechnungsart des Produkts (`SBQQ__BillingType__c`) akzeptiert einen Wert für `Advance` oder `Arrears`.	Aktualisieren Sie das Feld `SBQQ__BillingType__c` des Produkts auf `Advance` oder `Arrears`.
Salesforce-Produkte mit dem Typ „Renewable“ können nicht zu Evergreen-Aufträgen hinzugefügt werden.	Produkte von Salesforce CPQ akzeptieren die Werte „Renewable“ oder „Evergreen“.	Der Connector unterstützt beide Produktarten in einem einzigem Salesforce-Auftrag nicht. Um den Salesforce-Auftrag zu synchronisieren, müssen Sie einen der Auftragsposten entfernen.

Fehler bei der Kündigung

Die nachstehende Tabelle enthält die Fehler im Zusammenhang mit den Stornieraufträgen und wie diese behoben werden können.

Fehler	Beschreibung	Empfehlung
Ein Stornierauftrag wird bearbeitet, es befinden sich jedoch weitere Änderungen in der Warteschlange.	Der Connector verarbeitet einen Stornierauftrag, der den Abonnementzeitplan storniert. Es gibt jedoch weitere Änderungsaufträge, die verarbeitet werden müssen.	Um einen Salesforce-Auftrag zu stornieren, müssen Sie alle Änderungsaufträge, die nach dem Stornierauftrag aktiviert wurden, löschen oder deaktivieren. Wenn Sie einen Salesforce-Auftrag vor der Stornierung ändern möchten, müssen Sie den gekündigten Salesforce-Auftrag löschen oder deaktivieren, damit der Auftrag verarbeitet wird. Anschließend synchronisieren Sie den Salesforce-Stornierauftrag.
Die stornierte Menge ist größer als die aggregierte Menge für die Auftragsposten.	Sie möchten die Menge eines Auftragsostens um mehr als die vorhandene Menge reduzieren, was zu einer negativen Menge führt.	Aktualisieren Sie die Menge der Auftragsposten auf mindestens null.

Stripe-Fehler

Die folgende Tabelle enthält häufig vorkommende Fehler in Stripe und zeigt wie sie behoben werden können. Der Connector zeigt alle Stripe-Fehler, die auftreten, direkt für den/die Nutzer/in an.

Fehler	Beschreibung	Empfehlung
Die Höchstanzahl der Anfragen wurde überschritten.	Weitere Infos zu Ratenbegrenzungen.	Der Connector versucht zu einem späteren Zeitpunkt automatisch erneut, die Bestellung zu synchronisieren. Sie können auch die Funktion „Manuelle Synchronisierung“ verwenden, um eine manuelle Synchronisierung der fehlgeschlagenen Bestellung zu erzwingen.

Connector-Fehler

Die folgende Tabelle enthält häufige Connector-Fehler. Wenn eines dieser Probleme auftritt, wenden Sie sich an den Stripe-Support, um es genauer zu untersuchen.

Fehler	Beschreibung	Empfehlung
Die Anzahl der Angebots- oder Angebotszeilenzuordnungen unterscheidet sich von den Bestell- oder Artikelgutscheinen.	Der Connector konnte nicht automatisch einen Bestellgutschein für ein Angebot oder einen Angebotszeilengutschein generieren.	Wenden Sie sich an den Stripe-Support, um dieses Problem zu beheben und die Gutscheine vor der Synchronisierung zu generieren.
Der berechnete Preismultiplikator unterscheidet sich vom CPQ-Preismultiplikator.	Die Bestellung konnte nicht synchronisiert werden, da der Connector einen anderen Preismultiplikator als CPQ berechnet hat.	Vergewissern Sie sich, dass Ihre Salesforce CPQ Proration Precision mit den Einstellungen in Ihrer Salesforce CPQ-Anwendung übereinstimmt. Wenn sie nicht übereinstimmen, aktualisieren Sie sie entsprechend. Falls die Einstellungen übereinstimmen, wenden Sie sich an den Stripe-Support, um das Problem zu beheben und weitere Untersuchungen anzustellen.
Es wurde mehr als eine Phase der anteilsmäßigen Verrechnung im Backend gefunden.	Bei der Synchronisierung der Bestellung hat der Connector festgestellt, dass sich der Abonnementzeitplan in einem unerwarteten Zustand befindet, den er nicht verarbeiten sollte.	Wenden Sie sich an den Stripe-Support, um dieses Problem zu beheben und weitere Untersuchungen durchzuführen.