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![](https://b.stripecdn.com/docs-statics-srv/assets/fcc3a1c24df6fcffface6110ca4963de.svg)
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_ . | Der Wert des zugeordneten Felds für days_ muss eine Ganzzahl oder ein unterstütztes CPQ Payment Term sein. | Aktualisieren Sie den Wert des zugeordneten Felds für days_ 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![](https://b.stripecdn.com/docs-statics-srv/assets/fcc3a1c24df6fcffface6110ca4963de.svg)
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. |
Angebotsfehler![](https://b.stripecdn.com/docs-statics-srv/assets/fcc3a1c24df6fcffface6110ca4963de.svg)
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_ : monatlich, vierteljährlich, halbjährlich und jährlich. | Aktualisieren Sie den Wert des Feldes CPQ Billing Frequency auf Monthly , Quarterly , Semiannual oder Annual . |
Preisfehler![](https://b.stripecdn.com/docs-statics-srv/assets/fcc3a1c24df6fcffface6110ca4963de.svg)
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_ akzeptiert die Werte PerUnit oder FlatFee . | Ändern Sie den Feldwert für SBQQ_ 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_ 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_ des Stripe-Preises. | Das Preisschema ist nicht auf einen gültigen Wert festgelegt. | Ändern Sie das Abrechnungsschema auf per_ 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 . |
Produktfehler![](https://b.stripecdn.com/docs-statics-srv/assets/fcc3a1c24df6fcffface6110ca4963de.svg)
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_ ) akzeptiert einen Wert für Advance oder Arrears . | Aktualisieren Sie das Feld SBQQ_ 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![](https://b.stripecdn.com/docs-statics-srv/assets/fcc3a1c24df6fcffface6110ca4963de.svg)
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. |