> ## Documentation Index
> Fetch the complete documentation index at: https://docs.aftersell.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Häufig gestellte Fragen zur Upcart-API

> Finde Antworten auf häufige Fragen zur Nutzung der Upcart-API, einschließlich Einrichtung, Fehlerbehebung und Drittanbieter-Integrationen.

<div id="overview">
  # Übersicht
</div>

Hier findest du Antworten auf einige der häufigsten Fragen zur Nutzung der Upcart-API.

* **[Wo füge ich Upcart-API-Skripte hinzu?](#where-to-add-upcart-api-scripts)**
* **[Muss ich Entwickler sein, um die Upcart-API zu nutzen?](#do-i-need-to-be-a-developer-to-use-upcarts-api)**
* **[Kann sich die Upcart-API mit anderen Drittanbieter-Apps integrieren?](#can-upcarts-api-integrate-with-other-third-party-apps)**
* **[Wie teste ich, ob meine API-Änderungen funktionieren?](#how-do-i-test-if-my-api-changes-are-working)**
* **[Was mache ich, wenn ein API-Skript nicht funktioniert?](#what-should-i-do-if-an-api-script-isnt-working)**
* **[Wie mache ich Änderungen rückgängig, wenn ein Skript etwas kaputt macht?](#how-do-i-undo-changes-if-i-add-a-script-that-breaks-something)**

***

<div id="where-to-add-upcart-api-scripts">
  ## **Wo füge ich Upcart-API-Skripte hinzu?**
</div>

Du kannst Skripte in Upcarts Custom-HTML-Einstellungen oder direkt in deinem Shopify-Theme-Code hinzufügen. Die beste Option hängt von deinen Anpassungsbedürfnissen ab.

<div id="how-do-i-use-upcarts-custom-html">
  ## Wie verwende ich Upcarts Custom HTML?
</div>

1. Navigiere zu **Upcart → Settings → Custom HTML**
2. Verwende API-Skripte, um das Warenkorbverhalten zu ändern, etwa den Zeitpunkt des Öffnens oder die Anzeige von Upsells
3. Passe Elemente außerhalb von Upcart an, etwa das Ausblenden von Buttons auf der Produktseite

<div id="example-hide-the-sticky-cart-button-when-the-cart-is-empty">
  #### 💡 *Beispiel: Den Sticky-Cart-Button ausblenden, wenn der Warenkorb leer ist*
</div>

```
<script>  
  window.upcartSubscribeCartLoaded((event) => {  
    const itemCount = event.cart.items.reduce((total, item) => total + item.quantity, 0);  
    document.querySelector("#upCartStickyButton").style.display = itemCount === 0 ? "none" : "block";  
    console.log("Sticky Cart is hiding!");  
  });  
</script>
```

<Note>
  **Hinweis zu Legacy-Callbacks:** `window.upcartOnCartLoaded`-Callbacks funktionieren weiterhin, sind aber veraltet und geben Konsolen-Warnungen aus. Verwende für alle neuen Skripte `upcartSubscribeCartLoaded`. Beachte, dass `event.cart` keine `item_count`-Eigenschaft hat — verwende `event.cart.items.reduce((total, item) => total + item.quantity, 0)`, um die Gesamtanzahl der Artikel zu berechnen.
</Note>

***

<div id="do-i-need-to-be-a-developer-to-use-upcarts-api">
  # **Muss ich Entwickler sein, um die Upcart-API zu nutzen?**
</div>

Nein! Die Upcart-API ist auch ohne Programmierkenntnisse einfach zu nutzen. Viele Funktionen sind integriert, und unsere [Anpassungs-Dokumentation](/de/upcart/add_a_mandatory_terms_and_conditions_checkbox_to_your_cart) enthält vorgefertigte Skripte, die du in Upcarts Custom-HTML-Einstellungen kopieren kannst — ganz ohne Programmieren!

Wenn du eigene Skripte schreiben möchtest, helfen grundlegende JavaScript-Kenntnisse. Wenn JavaScript neu für dich ist, keine Sorge! Diese einsteigerfreundlichen Ressourcen — **W3Schools** und **[MDN Web Docs](https://developer.mozilla.org/en-US/docs/Web/JavaScript)** — helfen dir beim Einstieg.

***

<div id="can-upcarts-api-integrate-with-other-third-party-apps">
  # Kann sich die Upcart-API mit anderen Drittanbieter-Apps integrieren?
</div>

Ja! Die Upcart-API funktioniert mit Apps für Übersetzungen, Analytics, Upsells und mehr. Manche integrieren sich automatisch, andere benötigen möglicherweise ein kleines Skript.

Wenn du zum Beispiel **[TripleWhale](https://kb.triplewhale.com/en/articles/6610178-adding-the-triple-pixel-to-third-party-checkouts#h_eccf979512)** für das Tracking verwendest, musst du das folgende Skript hinzufügen, damit die Warenkorbaktivität korrekt erfasst wird:

```
<script>  
window.upcartSubscribeAddedToCart((event) => {  
	window.TriplePixel('AddToCart', {item: event.item.variantId, q: event.item.quantityAdded});  
});  
</script>
```

<Note>
  **Hinweis zu Legacy-Callbacks:** `window.upcartOnAddToCart`-Callbacks funktionieren weiterhin, sind aber veraltet und geben Konsolen-Warnungen aus. Verwende für alle neuen Skripte `upcartSubscribeAddedToCart`. Beachte, dass die Ereignis-Eigenschaften auf `event.item` liegen (mit `variantId` und `quantityAdded`) und nicht als separate Parameter übergeben werden.
</Note>

Da jede App anders ist, frage beim Support-Team deiner App nach, ob zusätzlicher Code nötig ist. Upcart bietet keinen Skript-Support für Drittanbieter-Apps, aber dein App-Anbieter hat möglicherweise eine Integrationsanleitung.

***

<div id="how-do-i-test-if-my-api-changes-are-working">
  # Wie teste ich, ob meine API-Änderungen funktionieren?
</div>

Nachdem du ein Skript in Upcarts Custom-HTML-Einstellungen hinzugefügt hast, folge diesen Schritten, um sicherzustellen, dass es funktioniert:

1. **Aktualisiere deinen Shop** und lege einen Artikel in den Warenkorb.

2. **Leere deinen Cache** und versuche es erneut, um die neuesten Änderungen zu sehen.

3. **Füge eine Testnachricht hinzu**: Füge `console.log("The script works!");` vor `</script>` ein, um zu prüfen, ob dein Skript ausgeführt wird.

4. Prüfe deine Browser-Konsole:

   * Öffne die **Dev Tools** (`F12` oder `Ctrl + Shift + J` unter Windows, `Cmd + Option + J` auf dem Mac).
   * Gehe zum Tab **Console** und suche nach **"The script works!"**
   * Wenn du die Nachricht siehst, läuft dein Skript! Falls nicht, wird das Skript möglicherweise nicht korrekt ausgeführt.

5. **Teste verschiedene Aktionen** (z. B. das Entfernen eines Artikels), um das erwartete Verhalten sicherzustellen.

**Behebe Probleme**, indem du auf Tippfehler oder Konsolenfehler prüfst und den Code bei Bedarf anpasst.

***

<div id="what-should-i-do-if-an-api-script-isnt-working">
  # Was mache ich, wenn ein API-Skript nicht funktioniert?
</div>

Wenn dein API-Skript nicht funktioniert, probiere diese Schritte zur Fehlerbehebung:

* **Prüfe auf Tippfehler** – Schon kleine Fehler können ein Skript zerstören. Suche nach fehlenden Zeichen oder falscher Syntax.

* **Überprüfe die Skript-Platzierung** – Stelle sicher, dass das Skript im richtigen Abschnitt unter Upcart → Settings → Custom HTML liegt. Upcart hat zehn Skript-Abschnitte (neun HTML-Einfügepunkte plus einen Scripts-before-load-Abschnitt) — [Sieh dir diese Abschnitte hier an.](/de/upcart/custom_html)

* **Prüfe die Browser-Konsole** – Folge den obigen Schritten, um nach Fehlern zu suchen.

* **Teste ein anderes Skript** – Probiere ein anderes vorgefertigtes Upcart-API-Skript aus, um zu sehen, ob das Problem an deinem Code liegt.

* **Kommst du nicht weiter?** – Wenn du dein Shopify-Theme änderst oder Drittanbieter-Apps integrierst, kann dir ein Shopify-Experte aus dem [Shopify Partner Directory](https://www.shopify.com/partners/directory) helfen.

Mit diesen Schritten solltest du die meisten Skript-Probleme identifizieren und lösen können!

***

<div id="how-do-i-undo-changes-if-i-add-a-script-that-breaks-something">
  # Wie mache ich Änderungen rückgängig, wenn ein Skript etwas kaputt macht?
</div>

Wenn du ein Skript hinzufügst, das nicht wie erwartet funktioniert, kannst du es **ganz einfach entfernen oder deaktivieren**:

* **Gehe zu Upcarts Custom-HTML-Einstellungen**, wo das Skript hinzugefügt wurde.

* **Entferne das Skript** oder deaktiviere es vorübergehend, indem du `//` an den Anfang jeder Zeile setzt (das macht sie zu einem Kommentar und verhindert die Ausführung).

* **Speichere die Änderungen & aktualisiere deinen Shop**, um zu prüfen, ob das Problem behoben ist.

Wenn das Problem weiterhin besteht, versuche, deinen Cache zu leeren oder kürzliche Theme-Änderungen rückgängig zu machen — das löst oft versteckte Konflikte.

***

🚧 **Suchst du erweiterte Anpassungen?**

Brauchst du shop-weite Anpassungen oder Integrationen mit Drittanbieter-Apps? Möglicherweise benötigst du einen Entwickler, der die Upcart-API in dein Shopify-Theme einbaut.

Ziehe in Betracht, einen Shopify-Experten über das **[Shopify Partner Directory](https://www.shopify.com/partners/directory)** zu beauftragen, und teile unsere [API-Dokumentation](/de/upcart/introduction_to_upcarts_public_api) mit ihm, um Unterstützung zu erhalten