Abonnement Bestellungen
Erfahren Sie, wie Sie Ihre Abonnement-Bestellungen zwischen Salesforce und Stripe synchronisieren.
Der Stripe Billing Connector für Salesforce CPQ erstellt für jede in Salesforce aktivierte Bestellung mit einem Abonnementtyp einen Abonnementzeitplan in Stripe. In einer Salesforce-Bestellung erstellt jeder Bestellposten einen Abonnementposten (für ein wiederkehrendes Produkt) oder einen Rechnungsposten in Stripe. Bestellung können in Stripe nicht in mehrere Posten aufgeteilt werden.
Standardmäßig verlängert sich nicht jeder Abonnementzeitplan in Stripe automatisch. Führen Sie einen der folgenden Schritte aus, um ein Abonnement zu erneuern:
- Erstellen Sie eine Auftragsänderung mit einem neuen Startdatum und einer neuen Laufzeit des Abonnements.
- Richten Sie Ihre Integration so ein, dass alle Abonnements automatisch verlängert werden.
Notiz
Das „native“ Angebotsobjekt, das sich vom CPQ Quote
-Objekt unterscheidet, wird in Salesforce nicht verwendet. Der Connector verwendet Bestellungen, die aus dem CPQ Quote
-Objekt generiert wurden.
Bestimmen, welche Bestellungen synchronisiert werden sollen![](https://b.stripecdn.com/docs-statics-srv/assets/fcc3a1c24df6fcffface6110ca4963de.svg)
Der Connector überprüft Salesforce alle 90 Sekunden auf aktualisierte Bestellungen seit der letzten erfolgreichen Bestellsynchronisierung.
Der Connector versucht, alle Bestellungen zu synchronisieren, die die folgenden Bedingungen erfüllen:
- Der Bestellstatus ist aktiviert. Sie können diese Standardbedingung entfernen oder anpassen.
- Der Auftragstyp ist neu.
- Mindestens eine der Bestellpositionen ist ein Abonnementprodukt. Dies bedeutet, dass er auf
SBQQ_
festgelegt ist.SubscriptionType_ c
Wenn alle Bestellpositionen einmalige Einkaufsposten sind, erstellt der Connector eine einmalige Rechnung anstelle eines Abonnements.
Bestelldatum![](https://b.stripecdn.com/docs-statics-srv/assets/fcc3a1c24df6fcffface6110ca4963de.svg)
Beim Einrichten des Connectors können Sie ein Backfill-Datum für Bestellungen auswählen. Nur Bestellungen, die nach diesem Datum erstellt wurden, werden mit Stripe synchronisiert.
Sie können das Startdatum des Abonnements rückdatieren, wobei es sich um das in Stripe verwendete Startdatum handelt. Um Fehler bei der Aktivierung der Bestellung zu vermeiden, müssen Sie ein Startdatum für das Angebot und die zugehörige Bestellung angeben.
Sie können optional ein Enddatum für die Testversion angeben. Wenn Sie keinen Testzeitraum festlegen, erhält der Kunde/die Kundin keinen Testzeitraum.
Synchronisierungsbedingungen![](https://b.stripecdn.com/docs-statics-srv/assets/fcc3a1c24df6fcffface6110ca4963de.svg)
Sie können den Standard-Synchronisierungsbedingungen benutzerdefinierte Bedingungen hinzufügen. Diese Bedingungen werden mit der Standard-SOQL-Syntax beschrieben.
Um benutzerdefinierte Bedingungen hinzuzufügen oder Standardbedingungen zu entfernen, navigieren Sie zu Stripe Billing Setup > Sync Preferences > Custom Order Sync Conditions.
Einschränkungen![](https://b.stripecdn.com/docs-statics-srv/assets/fcc3a1c24df6fcffface6110ca4963de.svg)
Der Connector kann keine Bestellungen mit mehr als 100 wiederkehrenden Posten synchronisieren. In Salesforce wird ein Fehler angezeigt, wenn eine Bestellung mehr als 100 wiederkehrende Posten enthält.
Sie müssen Mengen in Salesforce als ganze Zahl angeben. Stripe erlaubt keine Dezimalzahlen. Wenn eine Bestellung eine Dezimalmenge enthält, wird in Salesforce ein Fehler angezeigt.
Alle Posten eines Auftrags müssen die gleiche Intervallanzahl und den gleichen Intervalltyp haben. Die Intervallanzahl ergibt sich standardmäßig aus dem Feld Billing Frequency
. Der Intervalltyp ist täglich oder monatlich. Stripe erlaubt keine unterschiedlichen Abrechnungshäufigkeiten in einem Auftrag. Das bedeutet, dass Sie keinen Auftrag mit einem Posten haben können, der jeden zweiten Monat in Rechnung gestellt wird, und einem weiteren Posten, der monatlich abgerechnet wird.
Posten ausschließen![](https://b.stripecdn.com/docs-statics-srv/assets/fcc3a1c24df6fcffface6110ca4963de.svg)
Standardmäßig werden alle Posten (einschließlich Posten mit dem Wert Null) von Salesforce mit Stripe synchronisiert. Sie können bestimmte Posten aus dem in Stripe erstellten Abonnementplan ausschließen. Sie können beispielsweise Posten ausschließen, die nur zu Informationszwecken dienen und die Sie nicht auf wiederkehrenden Rechnungen in Stripe anzeigen möchten.
Um Posten auszuschließen, setzen Sie Skip Line Item in Stripe
für den Auftragsposten auf true
.
Wenn dieses Feld auf true
festgelegt ist, überspringt der Connector den Auftragsposten und er wird von den Posten der Abonnementplanphase in Stripe ausgeschlossen. Der interne Feldname ist Skip_
(ohne Berücksichtigung des Paketpräfixes).
Zuordnung von Abonnementplänen![](https://b.stripecdn.com/docs-statics-srv/assets/fcc3a1c24df6fcffface6110ca4963de.svg)
Eine aktivierte Bestellung in Salesforce erstellt einen Abonnementplan in Stripe. Die Felder werden wie folgt zugeordnet.
Salesforce-Bestellfeld | Feld für den Stripe-Abonnementplan | Hinweise | Pflichtfeld |
---|---|---|---|
Angebot, Startdatum (SBQQ_ ) | Startdatum | ||
Angebot, Abonnementlaufzeit | Phasen, Iterationen | ||
End-Verhalten | Der Standardwert ist cancel . Wenn das Abonnement automatisch verlängert werden soll, können Sie diese Zuordnung im Data Mapper konfigurieren. | ||
Zahlungsfrist (SBQQ_ ) | Standardeinstellungen, Invoice_settings, Tage bis zur Fälligkeit |
Einzelpostenzuordnung![](https://b.stripecdn.com/docs-statics-srv/assets/fcc3a1c24df6fcffface6110ca4963de.svg)
Die einzelnen Posten einer aktivierten Bestellung in Salesforce werden wie folgt zugeordnet. Diese Felder sind Pflichtfelder.
Wenn der Stückpreis für einen Bestellposten vom Preisbuch-Preis abweicht, verwendet der Connector den Preis der Bestellung und erstellt einen neuen Stripe -Preis.
Salesforce-Feld (OrderItem-Objekt) | Stripe-Einzelpostenfeld | Hinweise |
---|---|---|
Preisbucheintrag, UnitPrice | Preis | Der Stripe-Preis enthält genau den Betrag pro Einheit, der im Preisbuchposten angegeben ist. Wenn Sie ein benutzerdefiniertes Feld verwenden, um den der Kundin/dem Kunden in Rechnung gestellten wiederkehrenden Preis darzustellen, können Sie diese Zuordnung konfigurieren. |
OrderItem, UnitPrice | Preis | Der Stripe-Preis enthält genau den Betrag pro Einheit, der im Auftragsposten angegeben ist. Wenn Sie ein benutzerdefiniertes Feld verwenden, um den der Kundin/dem Kunden in Rechnung gestellten wiederkehrenden Preis darzustellen, können Sie diese Zuordnung konfigurieren. |
Menge (OrderItem. ) | Anzahl | Sie müssen die Menge als ganze Zahl angeben. Andernfalls wird die Menge auf 1 erzwungen und der Preis wird angepasst, um den Nettobetrag der Einzelpostenkosten darzustellen. Wenn es sich bei der Abrechnungsart um arrears (nutzungsbasierte Abrechnung) handelt, wird die Menge für den Posten nicht festgelegt. Stattdessen müssen Sie die Menge vor dem Ende des Abrechnungszeitraums an Stripe melden. |
Änderungen des Abonnements![](https://b.stripecdn.com/docs-statics-srv/assets/fcc3a1c24df6fcffface6110ca4963de.svg)
Sie können einen aktivierten Auftrag in Salesforce nicht aktualisieren. Alle Änderungen, die Sie in Salesforce an einem Auftrag vornehmen, werden nicht mit Stripe synchronisiert. Um ein Abonnement in der Mitte des Zyklus anzupassen oder teilweise zu kündigen, führen Sie eine Auftragsänderung durch.
Standardmäßig verlängern sich Abonnementpläne nicht automatisch. Um die Verlängerungsinformationen zu aktualisieren, erstellen Sie eine Auftragsänderung, die dem ursprünglichen Vertrag zugeordnet ist.
Sie können diese Funktionalität auch so anpassen, dass sie standardmäßig automatisch verlängert wird, oder die Verlängerungslogik direkt in Stripe verwalten.