# Kund/innen Erfahren Sie, wie Sie die Customer-Ressource mit Stripe Invoicing verwenden. Wenn Ihre Integration [kundenseitig konfigurierte Konten](https://docs.stripe.com/api/v2/core/accounts/create.md#v2_create_accounts-configuration-customer) verwendet, ersetzen Sie in den Codebeispielen Verweise auf `Customer` und Ereignisse durch die entsprechenden Verweise auf die Accounts v2 API. Weitere Informationen finden Sie unter [Kundinnen und Kunden mit Kontoobjekten darstellen](https://docs.stripe.com/connect/use-accounts-as-customers.md). Legen Sie für alle neuen Nutzer/innen oder Unternehmen, denen Sie Rechnungen stellen möchten, eine neue Kundin/einen neuen Kunden an. Richten Sie dabei ein [einfaches Kundenprofil](https://docs.stripe.com/invoicing/customer.md#customer-profile) ein, um die Erstellung von Rechnungen zu vereinfachen, und aktivieren Sie Smart Retries (wenn Sie Nutzer/in von [Invoicing Plus](https://stripe.com/invoicing/pricing) sind). Nachdem Sie Ihre/n Kund/in eingerichtet haben, können Sie einmalige Rechnungen ausstellen oder *Abonnements* (A Subscription represents the product details associated with the plan that your customer subscribes to. Allows you to charge the customer on a recurring basis) erstellen. > Stellen Sie vor der Erstellung einer neuen Kundin/eines neuen Kunden sicher, dass dieser/dieser nicht bereits im Dashboard vorhanden ist. Wenn Sie mehrere Kundeneinträge für eine Person erstellen, kann dies später zu Problemen führen, wenn Sie zum Beispiel die Transaktionshistorie abgleichen oder gespeicherte Zahlungsmethoden koordinieren müssen. #### Dashboard Sie können Kund/innen auf der Seite [Kund/innen](https://dashboard.stripe.com/customers) erstellen und verwalten, wenn Sie keinen Code zum Erstellen eines/einer Kund/in verwenden möchten oder wenn Sie einem/einer Kund/in manuell eine einmalige Rechnung ausstellen möchten. > Bei der Rechnungserstellung können Sie auch einen/eine Kund/in im Dashboard erstellen. ### Kund/in erstellen Wenn Sie neue Kund/innen erstellen, können Sie ihre Konto- und Rechnungsdaten wie **E-Mail**, **Name** und **Land** festlegen. Sie können auch die bevorzugte Sprache des/der Kund/in, die Währung und andere wichtige Details festlegen. Sie können diese Aktionen auch auf der Seite **Kund/innen** durchführen: - Ihre Kund/innen filtern. - Kund/innen löschen. - Alle Ihre Kund/innen anzeigen. - Liste mit Kundendaten exportieren. Um eine/n Kund/in zu erstellen, führen Sie die folgenden Schritte aus: 1. Stellen Sie sicher, dass der Kunde/die Kundin nicht bereits existiert. 1. Klicken Sie auf der Seite **Kund/innen** auf **Kund/in hinzufügen**, oder drücken Sie **N**. 1. Geben Sie mindestens den **Namen** und die **Konto-E-Mail** Ihres/Ihrer Kund/in ein. 1. Klicken Sie im Dialogfeld auf **Kund/in hinzufügen**. ### Kund/in bearbeiten Um das Profil eines/einer Kund/in zu bearbeiten, führen Sie folgende Schritte aus: 1. Ermitteln Sie den/die Kund/in, den/die Sie ändern möchten, und klicken Sie auf der Seite **Kund/innen** auf den Namen. 1. Wählen Sie auf der Seite mit den Kontoinformationen **Aktionen** > **Angaben bearbeiten** aus. 1. Nehmen Sie Ihre Änderungen am Kundenprofil vor. 1. Klicken Sie auf **Kund/in aktualisieren**. ### Kund/in löschen Um einen/eine Kund/in zu löschen, führen Sie folgende Schritte aus: 1. Ermitteln Sie auf der Seite **Kund/innen** den/die Kund/in, den/die Sie löschen möchten. 1. Aktivieren Sie das Kontrollkästchen neben dem Namen Ihres/Ihrer Kund/in, gefolgt von **Löschen**. Sie können auch auf die Informationsseite des/der Kund/in klicken und **Aktionen** > **Kund/in löschen** auswählen. #### API Vergewissern Sie sich vor der Erstellung einer neuen Kundin/eines neuen Kunden, dass diese/dieser nicht bereits vorhanden ist. Übergeben Sie beispielsweise eine E-Mail-Adresse an die API, die [alle Kundinnen/Kunden anzeigt](https://docs.stripe.com/api/customers/list.md). ```curl curl -G https://api.stripe.com/v1/customers \ -u "<>:" \ -d email={EMAIL_ADDRESS} ``` Das folgende Beispiel zeigt, wie Sie eine neue Kundin/einen neuen Kunden mit einer E-Mail-Adresse und einer Standardzahlungsmethode erstellen. Eine vollständige Liste der Argumente, die Sie an die API übergeben können, finden Sie unter [Kundin/Kunden erstellen](https://docs.stripe.com/api/customers/create.md). ```curl curl https://api.stripe.com/v1/customers \ -u "<>:" \ --data-urlencode "email=jenny.rosen@example.com" \ -d payment_method=pm_card_visa \ -d "invoice_settings[default_payment_method]=pm_card_visa" ``` ## Kundenprofile Ein einfaches Kundenprofil eignet sich zum Generieren von Rechnungen und Zahlungsbelegen oder als einfaches Customer Relationship Management-System (CRM) für Ihre Anwendung. Legen Sie diese Eigenschaften fest, um ein Basis-Kundenprofil zu erstellen. - E-Mail-Adresse. - Name des/der Kund/in - Metadaten mit Verweis auf die interne Kunden-ID Ihrer Anwendung Durch die Angabe einer [E-Mail-Adresse](https://docs.stripe.com/api/customers/object.md#customer_object-email) kann Stripe Ihre Kundinnen/Kunden über fehlgeschlagene Zahlungen oder zusätzliche Schritte benachrichtigen, die für den Zahlungsabschluss erforderlich sind. Speichern Sie die interne Kunden-ID Ihrer Anwendung im [Metadatenattribut](https://docs.stripe.com/api/customers/object.md#customer_object-metadata). Wie bei den meisten Stripe-Ressourcen enthält auch die `Customer`-Ressource einen Hash des [Metadatenobjekts](https://docs.stripe.com/api/metadata.md), um kontextbezogene Schlüsselwertinformationen flexibel speichern zu können. Speichern Sie Ihre interne Kunden-ID als Schlüssel-Wert-Paar in der `Customer`-Ressource, um Rechnungsprüfung und Support zu unterstützen. So können Sie anhand Ihrer internen Referenz-ID nach der Kundin/dem Kunden suchen. Wir empfehlen, dass Sie die Kunden-IDs von Stripe auch im internen Kundenmodell Ihrer Anwendung speichern. ### Rechnungs- und Versandadressen Verwenden Sie die [Adresseigenschaften](https://docs.stripe.com/api/customers/object.md#customer_object-address), um eine Rechnungsadresse für Rechnungsstellung und Stornorechnungen festzulegen. Fügen Sie für den Versand physischer Waren eine [Versandadresse](https://docs.stripe.com/api/customers/object.md#customer_object-shipping) hinzu. > Rechnungen, Stornorechnungen und Belege enthalten die Rechnungsadresse – eine häufige Voraussetzung für die Einhaltung der Steuervorschriften. ### Lokalisierung von E-Mails und PDF-Dateien Wenn Sie eine/n Kund/in erstellen, verwenden Sie das Dropdown-Menü **Sprache**, um die bevorzugte Sprache hinzuzufügen. (Sie können die bevorzugte Sprache eines/einer Kund/in auch auf der **Detailseite eines/einer Kund/in** oder beim Erstellen einer Rechnung hinzufügen oder bearbeiten.) Stripe verwendet die gewählte Sprache zur Lokalisierung von Rechnungs-E-Mails und PDFs sowie Stornorechnungs-PDFs. Um die Sprache über die API zu aktualisieren, verwenden Sie den Parameter [preferred_locales](https://docs.stripe.com/api/customers/object.md#customer_object-preferred_locales). Dieser Parameter akzeptiert eine nach Präferenz sortierte Liste von Sprachen. Diesen bevorzugten Gebietsschemawerten liegt [RFC-4646](https://tools.ietf.org/html/rfc4646) zugrunde. Beispiele sind „en“ für Englisch oder„fr-CA“ für kanadisches Französisch. Weitere Informationen finden Sie unter [Von Kundinnen/Kunden bevorzugte Sprachen](https://docs.stripe.com/invoicing/customize.md#customer-language). ## Kundeneigenschaften Die folgende Tabelle enthält weitere Kundeneigenschaften: | Eigenschaft | Beschreibung | | ---------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ | | Zahlungseigenschaften | Stripe verwendet die mit einem Kunden/einer Kundin verknüpften [Zahlungsdetails](https://docs.stripe.com/payments.md) für den Einzug von Zahlungen. Ein Kunde/eine Kundin kann eine Zahlung auf verschiedene Arten tätigen, darunter die [Payment Methods API](https://docs.stripe.com/payments/payment-methods.md) und [Kundenguthaben](https://docs.stripe.com/invoicing/customer/balance.md). Kundinnen/Kunden werden immer mit einer festen Währung angelegt, d. h., Sie können eine Währung nicht mehr ändern, nachdem Sie eine Währung zugewiesen, dem Kunden/der Kundin eine Rechnung gestellt oder ein Kundenguthaben festgelegt haben. Diese feste Währung wird im Dashboard in der deaktivierten Dropdown-Liste **Währung** angezeigt. Wenn Sie eine einzelne Entität in mehreren Währungen fakturieren müssen, erstellen Sie für jede Währung einen neuen Kunden/eine neue Kundin. | | Rechnungseigenschaften | Alle [mit der Rechnungsstellung zusammenhängenden Ressourcen](https://docs.stripe.com/api/customers/create.md#create_customer-invoice_settings) sind mit den Kundinnen/Kunden verbunden, an die die Rechnung gestellt wird. | | Steuereigenschaften | Um die Anforderungen der Steuergesetzgebung zu erfüllen, müssen Sie ggf. die Steuernummern Ihrer Kundinnen/Kunden sowie weitere steuerbezogene Informationen in Ihre Rechnung aufnehmen. Es liegt in Ihrer Verantwortung, sicherzustellen, dass die Rechnungen Ihrer Kundinnen/Kunden alle korrekten Informationen enthalten z. B. [Steuer-IDs](https://docs.stripe.com/invoicing/customer/tax-ids.md), [Steuerbefreiungsstatus](https://docs.stripe.com/api/customers/create.md#create_customer-tax_exempt) und [Adressen](https://docs.stripe.com/invoicing/customer.md#addresses). Mit Steuer-IDs können Sie eine oder mehrere Steueridentifikationsnummern in Rechnungen speichern und anzeigen. Der Steuerbefreiungsstatus gibt an, ob die juristische Person steuerpflichtig ist. In der Standardeinstellung ist der Status `tax_exempt` eines Kunden/einer Kundin auf `none` festgelegt, was bedeutet, dass es sich um eine steuerpflichtige Abrechnungseinheit handelt. Allerdings können Sie auch angeben, dass ein Kunde/eine Kundin für die Zahlung der Steuer selbst verantwortlich ist. Legen Sie dazu den Parameter `tax_exempt` auf `reverse` fest oder wählen Sie den Status `exempt`, um eine Steuerbefreiung anzugeben. Weitere Informationen zur Verwendung von `tax_exempt` und `reverse` finden Sie unter [Steuersätze](https://docs.stripe.com/billing/taxes/tax-rates.md#tax-exempt-and-reverse-charge). | ## Häufige Aufgaben In diesem Abschnitt werden einige der häufigsten Aufgaben erläutert, die Sie mit der `Customer`-Ressource durchführen können. - **Rechnung an einen Kunden/eine Kundin senden**: Nachdem Sie Kundinnen/Kunden erstellt haben, können Sie [ihnen eine Rechnung senden](https://docs.stripe.com/invoicing/dashboard.md#create-invoice). - **Kundenguthaben speichern**: Mit der Funktion für Kundenguthaben können bestimmten Kundinnen/Kunden Korrekturen im Habensaldo und Sollsaldo zugeordnet werden. Der so ermittelte Saldo wird bei künftigen Rechnungen für diese Kundinnen/Kunden angerechnet. - **Steueridentifikationsnummern hinzufügen und validieren**: Die Angabe der Steueridentifikationsnummer einer Kundin/eines Kunden auf Rechnungsdokumenten ist eine übliche steuerliche Anforderung. Mit Stripe können Sie einem Kunden/einer Kundin mehrere Steueridentifikationsnummern hinzufügen. Diese Steueridentifikationsnummern werden in der Kopfzeile von PDF-Rechnungen und PDF-Stornorechnungen angezeigt. Weitere Informationen dazu finden Sie auf der Seite [Steuer-IDs von Kundinnen/Kunden](https://docs.stripe.com/invoicing/customer/tax-ids.md). - **Kundenwährung festlegen**: Die Standardwährung der Kundinnen/Kunden zum Bezahlen von Rechnungen können Sie über das Dashboard festlegen. Gehen Sie hierfür zur Seite **Kundinnen/Kunden**, wählen die gewünschte Kundin/den gewünschten Kunden aus und klicken neben den **Details** auf **Bearbeiten**. Auf der Seite [Kundinnen/Kunden mit mehreren Währungen](https://docs.stripe.com/invoicing/multi-currency-customers.md) erfahren Sie mehr dazu, wie Sie Zahlungen einer Kundin/eines Kunden mit einer Währung abwickeln, die von ihrer/seiner Standardwährung abweicht. - **Mehrere Kundinnen/Kunden erstellen**: Mit den [Stripe Apps für Produktivität](https://marketplace.stripe.com/categories/productivity) können Sie mehrere Kundinnen/Kunden hochladen.