# Eine Rechnung in der Vorschau anzeigen

Erfahren Sie, wie Sie eine Rechnungsvorschau erstellen.

Sie können eine Vorschau einer Rechnung für Ihren Kundinnen und Kunden erstellen, während sie einen Kauf in Erwägung ziehen. [Erstellen Sie eine Vorschau](https://docs.stripe.com/api/invoices/create_preview.md), um den gesamten Rechnungsbetrag zu berechnen, jeden Rechnungsposten abzurufen und alle relevanten Steuern oder Rabatte einzubeziehen. Wenn Sie eine Vorschau erstellen, können Sie Ihren Kundinnen/Kunden den gesamten Zahlungsbetrag anzeigen, ohne eine Rechnung erstellen zu müssen.

Beispielsweise können Sie beim Betrieb eines Unternehmens, das Reparaturdienstleistungen für Unternehmen erbringt, Ihren Kundinnen/Kunden mehrere Artikel mit jeweils unterschiedlichen Preisen und Abrechnungsplänen vorlegen:

- Artikel 1: 299 USD einmalige Servicegebühr
- Artikel 2: 29 USD Reparaturmaterial A
- Artikel 3: 99 USD Reparaturmaterial B
- Artikel 4: 49 USD pro Monat Supportplan

Kunden/Kundinnen möchten vielleicht wissen, wie viel verschiedene Kombinationen Ihrer Waren und Dienstleistungen kosten. Wenn sie beabsichtigen, die Artikel 1 und 3 zu kaufen und dabei den Promo-Code `WINTERSALE` für 15 % Rabatt anwenden, führen Sie den folgenden API-Aufruf durch:

```curl
curl https://api.stripe.com/v1/invoices/create_preview \
  -u "<<YOUR_SECRET_KEY>>:" \
  -d "invoice_items[0][price]=price_item_1" \
  -d "invoice_items[0][quantity]=1" \
  -d "invoice_items[1][price]=price_item_3" \
  -d "invoice_items[1][quantity]=1" \
  -d "discounts[0][promotion_code]=promo_WINTERSALE"
```

Stripe gibt eine [Rechnungsvorschau](https://docs.stripe.com/api/invoices/object.md) mit jedem der Posten, dem angewendeten Rabatt und dem Gesamtbetrag zurück:

```json
{
  "id": "upcoming_in_1OujwkClCIKljWvsq5v2ICAN",
  "object": "invoice",
  "account_country": "US",
  "account_name": "Stripe Docs",
  "account_tax_ids": null,
  "amount_due": 39800,
  "amount_paid": 0,
  "amount_remaining": 39800,
  "amount_shipping": 0,
  "application": null,
  "application_fee_amount": null,
  "attachments": [],
  "attempt_count": 0,
  "attempted": false,
  "auto_advance": false,
  "automatic_tax": {
    "enabled": false,
    "liability": null,
    "status": null
  },
  "billing_reason": "upcoming",
  "charge": null,
  "collection_method": "charge_automatically",
  "created": 1710544434,
  "currency": "usd",
  "custom_fields": null,
  "customer": "cus_PkEPRnhp0Yk1ph",
  "customer_address": null,
  "customer_email": null,
  "customer_name": null,
  "customer_phone": null,
  "customer_shipping": null,
  "customer_tax_exempt": "none",
  "customer_tax_ids": [],
  "default_margins": [],
  "default_payment_method": null,
  "default_source": null,
  "default_tax_rates": [],
  "description": null,
  "discount": null,
  "discounts": [],
  "due_date": null,
  "effective_at": null,
  "ending_balance": 0,
  "footer": null,
  "from_invoice": null,
  "hosted_invoice_url": null,
  "invoice_pdf": null,
  "issuer": {
    "type": "self"
  },
  "last_finalization_error": null,
  "latest_revision": null,
  "lines": {
    "object": "list",
    "data": [
      {
        "id": "il_tmp_133608ClCIKljWvs8da61423",
        "object": "line_item",
        "amount": 9900,
        "amount_excluding_tax": 9900,
        "currency": "usd",
        "description": "Price2",
        "discount_amounts": [],
        "discountable": true,
        "discounts": [],
        "invoice": "in_1OujwkClCIKljWvsfntkIWhT",
        "invoice_item": "ii_1OujwkClCIKljWvsnajC2mHG",
        "livemode": false,
        "margin_amounts": [],
        "margins": [],
        "metadata": {},
        "period": {
          "end": 1710544434,
          "start": 1710544434
        },
        "plan": null,
        "price": {
          "id": "price_1OujwjClCIKljWvsKriuEI60",
          "object": "price",
          "active": true,
          "billing_scheme": "per_unit",
          "created": 1710544433,
          "currency": "usd",
          "custom_unit_amount": null,
          "livemode": false,
          "lookup_key": null,
          "metadata": {},
          "nickname": null,
          "product": "prod_PkEPiQtlsZzbaa",
          "recurring": null,
          "tax_behavior": "unspecified",
          "tiers_mode": null,
          "transform_quantity": null,
          "type": "one_time",
          "unit_amount": 9900,
          "unit_amount_decimal": "9900"
        },
        "proration": false,
        "proration_details": {
          "credited_items": null
        },
        "quantity": 1,
        "rendering": null,
        "subscription": null,
        "tax_amounts": [],
        "tax_rates": [],
        "type": "invoiceitem",
        "unit_amount_excluding_tax": "9900"
      },
      {
        "id": "il_tmp_1f6911ClCIKljWvs7a00e38c",
        "object": "line_item",
        "amount": 29900,
        "amount_excluding_tax": 29900,
        "currency": "usd",
        "description": "Price1",
        "discount_amounts": [],
        "discountable": true,
        "discounts": [],
        "invoice": "in_1OujwkClCIKljWvsfntkIWhT",
        "invoice_item": "ii_1OujwkClCIKljWvsJVGuvJYk",
        "livemode": false,
        "margin_amounts": [],
        "margins": [],
        "metadata": {},
        "period": {
          "end": 1710544434,
          "start": 1710544434
        },
        "plan": null,
        "price": {
          "id": "price_1OujwiClCIKljWvss6aaPCEe",
          "object": "price",
          "active": true,
          "billing_scheme": "per_unit",
          "created": 1710544432,
          "currency": "usd",
          "custom_unit_amount": null,
          "livemode": false,
          "lookup_key": null,
          "metadata": {},
          "nickname": null,
          "product": "prod_PkEPv778t9PLvu",
          "recurring": null,
          "tax_behavior": "unspecified",
          "tiers_mode": null,
          "transform_quantity": null,
          "type": "one_time",
          "unit_amount": 29900,
          "unit_amount_decimal": "29900"
        },
        "proration": false,
        "proration_details": {
          "credited_items": null
        },
        "quantity": 1,
        "rendering": null,
        "subscription": null,
        "tax_amounts": [],
        "tax_rates": [],
        "type": "invoiceitem",
        "unit_amount_excluding_tax": "29900"
      }
    ],
    "has_more": false,
    "total_count": 2,
    "url": "/v1/invoices/upcoming_in_1OujwkClCIKljWvsq5v2ICAN/lines"
  },
  "livemode": false,
  "metadata": {},
  "next_payment_attempt": null,
  "number": null,
  "on_behalf_of": null,
  "paid": false,
  "paid_out_of_band": false,
  "paper_checks": [],
  "payment_intent": null,
  "payment_settings": {
    "default_mandate": null,
    "payment_method_options": null,
    "payment_method_types": null
  },
  "period_end": 1710544434,
  "period_start": 1710544434,
  "post_payment_credit_notes_amount": 0,
  "pre_payment_credit_notes_amount": 0,
  "quote": null,
  "receipt_number": null,
  "recurring": true,
  "redaction": null,
  "rendering": {
    "amount_tax_display": "exclude_tax",
    "pdf": null,
    "template": null,
    "template_version": null
  },
  "rendering_options": {
    "amount_tax_display": "exclude_tax"
  },
  "shipping_cost": null,
  "shipping_details": null,
  "starting_balance": 0,
  "statement_descriptor": null,
  "status": "draft",
  "status_transitions": {
    "finalized_at": null,
    "marked_uncollectible_at": null,
    "paid_at": null,
    "voided_at": null
  },
  "subscription": null,
  "subscription_details": {
    "metadata": null,
    "pause_collection": null
  },
  "subtotal": 39800,
  "subtotal_excluding_tax": 39800,
  "tax": null,
  "tax_filing_currency": null,
  "test_clock": null,
  "total": 39800,
  "total_discount_amounts": [],
  "total_excluding_tax": 39800,
  "total_margin_amounts": [],
  "total_tax_amounts": [],
  "transfer_data": null,
  "webhooks_delivered_at": null
}
```

Zusätzlich kann die resultierende Rechnungsvorschau über den Endpoint [/v1/invoices/:id](https://docs.stripe.com/api/invoices/retrieve.md) für die folgenden 72&nbsp;Stunden abgerufen werden:

```curl
curl https://api.stripe.com/v1/invoices/upcoming_in_1OujwkClCIKljWvsq5v2ICAN \
  -u "<<YOUR_SECRET_KEY>>:"
```

## Stripe Tax einbeziehen

Um eine Vorschau der Steuerbeträge von Stripe Tax anzuzeigen, legen Sie `automatic_tax[enabled] = true` fest und übergeben Sie die Adresse des Kunden/der Kundin in `customer_details[address]`:

Alternativ können Sie eine IP-Adresse in `customer_details[tax][ip_address]` angeben, falls Sie die Adresse der Kundin/des Kunden nicht haben. In den meisten Fällen kann Stripe eine IP-Adresse einem physischen Gebiet zuordnen, die Genauigkeit variiert jedoch und entspricht möglicherweise nicht dem tatsächlichen Standort der Kundin/des Kunden. Wir empfehlen nicht, sich bei der Bestimmung der Adresse über eine erste Schätzung hinaus auf die IP-Adresse der Kundin/des Kunden zu verlassen.

```curl
curl https://api.stripe.com/v1/invoices/create_preview \
  -u "<<YOUR_SECRET_KEY>>:" \
  -d "customer_details[address][line1]=920 5th Ave" \
  -d "customer_details[address][city]=Seattle" \
  -d "customer_details[address][state]=WA" \
  -d "customer_details[address][postal_code]=98104" \
  -d "customer_details[address][country]=US" \
  -d "automatic_tax[enabled]=true" \
  -d "invoice_items[0][price]=price_item_1" \
  -d "invoice_items[0][quantity]=1" \
  -d "invoice_items[1][price]=price_item_3" \
  -d "invoice_items[1][quantity]=1" \
  -d "discounts[0][promotion_code]=promo_WINTERSALE"
```

## Vorschau von Rechnungen mit Abonnements

Um eine Vorschau der ersten Rechnung mit einem wiederkehrenden Preis anzuzeigen, verwenden Sie den Parameter [subscription_details.items](https://docs.stripe.com/api/invoices/create_preview.md#create_create_preview-subscription_details-items):

```curl
curl https://api.stripe.com/v1/invoices/create_preview \
  -u "<<YOUR_SECRET_KEY>>:" \
  -d "subscription_details[items][0][price]=price_recurring_4" \
  -d "subscription_details[items][0][quantity]=1" \
  -d "invoice_items[0][price]=price_item_1" \
  -d "invoice_items[0][quantity]=1" \
  -d "invoice_items[1][price]=price_item_3" \
  -d "invoice_items[1][quantity]=1" \
  -d "discounts[0][promotion_code]=promo_WINTERSALE"
```

Um Änderungen an einem bestehenden Abonnement in der Vorschau anzuzeigen, geben Sie die [Abonnement- oder Abonnementplan-ID](https://docs.stripe.com/billing/subscriptions/subscription-schedules.md#preview-an-invoice) an.

## Nur wiederkehrende Zahlungen in der Vorschau anzeigen

Ihr Kunde/Ihre Kundin wünscht möglicherweise ein wiederkehrendes Abonnement zusammen mit einmaligen Posten oder temporären Gutschriften oder Rabatten, die er/sie für seinen Kauf verwenden kann. Wenn sie wissen möchten, wie hoch die wiederkehrenden Zahlungen nach den Anpassungen sind, verwenden Sie den Parameter [preview_mode](https://docs.stripe.com/api/invoices/create_preview.md#create_create_preview-preview_mode), um den Kundinnen/Kunden eine Vorschau der Gesamtsumme zu zeigen.

Wenn es sich bei `WINTERSALE` beispielsweise um einen einmaligen Rabatt von 15&nbsp;% handelt und der Kunde/die Kundin die Artikel 1, 3 und 4 kaufen möchte, können Sie den wiederkehrenden Zahlungsbetrag mit diesem API-Aufruf abrufen:

```curl
curl https://api.stripe.com/v1/invoices/create_preview \
  -u "<<YOUR_SECRET_KEY>>:" \
  -d preview_mode=recurring \
  -d "subscription_details[items][0][price]=price_recurring_4" \
  -d "subscription_details[items][0][quantity]=1" \
  -d "invoice_items[0][price]=price_item_1" \
  -d "invoice_items[0][quantity]=1" \
  -d "invoice_items[1][price]=price_item_3" \
  -d "invoice_items[1][quantity]=1" \
  -d "discounts[0][promotion_code]=promo_WINTERSALE"
```

Die resultierende Rechnung enthält nur den Supportplan von 49&nbsp;USD pro Monat ohne Rabatte. Ebenso können Sie `preview_mode` mit `subscription` oder `subscription_schedule` kombinieren, um die erwarteten wiederkehrenden Zahlungen anzuzeigen, mit Ausnahme von einmaligen Posten und Rabatten.

## Paginierung der Rechnungsposten

Bei Rechnungen mit mehr als 10&nbsp;Zeilen können Sie [eine paginierte Ansicht der Zeilen abrufen](https://docs.stripe.com/api/invoice-line-item/retrieve.md):

```curl
curl https://api.stripe.com/v1/invoices/upcoming_in_1OujwkClCIKljWvsq5v2ICAN/lines \
  -u "<<YOUR_SECRET_KEY>>:"
```