> ## 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.

# Domande frequenti sull'API di Upcart

> Trova le risposte alle domande più comuni sull'uso dell'API di Upcart, tra cui configurazione, risoluzione dei problemi e integrazioni di terze parti.

<div id="overview">
  # Panoramica
</div>

Ecco le risposte ad alcune delle domande più comuni sull'uso dell'API di Upcart.

* **[Dove aggiungere gli script API di Upcart?](#where-to-add-upcart-api-scripts)**
* **[Devo essere uno sviluppatore per usare l'API di Upcart?](#do-i-need-to-be-a-developer-to-use-upcarts-api)**
* **[L'API di Upcart può integrarsi con altre app di terze parti?](#can-upcarts-api-integrate-with-other-third-party-apps)**
* **[Come faccio a verificare se le mie modifiche API funzionano?](#how-do-i-test-if-my-api-changes-are-working)**
* **[Cosa devo fare se uno script API non funziona?](#what-should-i-do-if-an-api-script-isnt-working)**
* **[Come annullo le modifiche se aggiungo uno script che rompe qualcosa?](#how-do-i-undo-changes-if-i-add-a-script-that-breaks-something)**

***

<div id="where-to-add-upcart-api-scripts">
  ## **Dove aggiungere gli script API di Upcart?**
</div>

Puoi aggiungere gli script nelle impostazioni Custom HTML di Upcart o direttamente nel codice del tuo tema Shopify. L'opzione migliore dipende dalle tue esigenze di personalizzazione.

<div id="how-do-i-use-upcarts-custom-html">
  ## Come uso il Custom HTML di Upcart?
</div>

1. Vai su **Upcart → Settings → Custom HTML**
2. Usa gli script API per modificare il comportamento del carrello, come i tempi di apertura o la visualizzazione degli upsell
3. Regola elementi esterni a Upcart, come nascondere i pulsanti della pagina prodotto

<div id="example-hide-the-sticky-cart-button-when-the-cart-is-empty">
  #### 💡 *Esempio: nascondere il pulsante sticky del carrello quando il carrello è vuoto*
</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>
  **Nota legacy:** le callback `window.upcartOnCartLoaded` funzionano ancora ma sono deprecate e registrano avvisi in console. Usa `upcartSubscribeCartLoaded` per tutti i nuovi script. Tieni presente che `event.cart` non ha una proprietà `item_count`: usa `event.cart.items.reduce((total, item) => total + item.quantity, 0)` per calcolare il numero totale di articoli.
</Note>

***

<div id="do-i-need-to-be-a-developer-to-use-upcarts-api">
  # **Devo essere uno sviluppatore per usare l'API di Upcart?**
</div>

No! L'API di Upcart è facile da usare, anche senza competenze di programmazione. Molte funzionalità sono integrate e la nostra [documentazione sulle personalizzazioni](/it/upcart/add_a_mandatory_terms_and_conditions_checkbox_to_your_cart) include script già pronti che puoi copiare nelle impostazioni Custom HTML di Upcart — nessuna programmazione richiesta!

Se vuoi scrivere script personalizzati, una conoscenza base di JavaScript aiuta. Se sei nuovo a JavaScript, non preoccuparti! Queste risorse per principianti — **W3Schools** e **[MDN Web Docs](https://developer.mozilla.org/en-US/docs/Web/JavaScript)** — possono aiutarti a iniziare.

***

<div id="can-upcarts-api-integrate-with-other-third-party-apps">
  # L'API di Upcart può integrarsi con altre app di terze parti?
</div>

Sì! L'API di Upcart funziona con app per traduzioni, analytics, upsell e altro ancora. Alcune si integrano automaticamente, mentre altre potrebbero richiedere un piccolo script.

Per esempio, se usi **[TripleWhale](https://kb.triplewhale.com/en/articles/6610178-adding-the-triple-pixel-to-third-party-checkouts#h_eccf979512)** per il tracciamento, dovrai aggiungere il seguente script per assicurarti che registri correttamente l'attività del carrello:

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

<Note>
  **Nota legacy:** le callback `window.upcartOnAddToCart` funzionano ancora ma sono deprecate e registrano avvisi in console. Usa `upcartSubscribeAddedToCart` per tutti i nuovi script. Tieni presente che le proprietà dell'evento si trovano su `event.item` (con `variantId` e `quantityAdded`), non vengono passate come parametri separati.
</Note>

Poiché ogni app è diversa, consulta il team di supporto della tua app per verificare se serve codice aggiuntivo. Upcart non offre supporto per gli script di app di terze parti, ma il fornitore della tua app potrebbe avere una guida all'integrazione.

***

<div id="how-do-i-test-if-my-api-changes-are-working">
  # Come faccio a verificare se le mie modifiche API funzionano?
</div>

Dopo aver aggiunto uno script nelle impostazioni Custom HTML di Upcart, segui questi passaggi per assicurarti che funzioni:

1. **Aggiorna il tuo store** e aggiungi un articolo al carrello.

2. **Svuota la cache** e riprova per vedere le modifiche più recenti.

3. **Aggiungi un messaggio di test**: inserisci `console.log("The script works!");` prima di `</script>` per verificare se il tuo script viene eseguito.

4. Controlla la console del browser:

   * Apri i **Dev Tools** (`F12` o `Ctrl + Shift + J` su Windows, `Cmd + Option + J` su Mac).
   * Vai alla scheda **Console** e cerca **"The script works!"**
   * Se vedi il messaggio, il tuo script è in esecuzione! In caso contrario, lo script potrebbe non essere eseguito correttamente.

5. **Testa azioni diverse** (es. rimuovere un articolo) per assicurarti del comportamento atteso.

**Risolvi i problemi** controllando errori di battitura o errori in console e modificando il codice secondo necessità.

***

<div id="what-should-i-do-if-an-api-script-isnt-working">
  # Cosa devo fare se uno script API non funziona?
</div>

Se il tuo script API non funziona, prova questi passaggi di risoluzione dei problemi:

* **Controlla gli errori di battitura** – Anche piccoli errori possono rompere uno script. Cerca caratteri mancanti o sintassi errata.

* **Verifica la posizione dello script** – Assicurati che lo script sia nella sezione corretta sotto Upcart → Settings → Custom HTML. Upcart ha dieci sezioni per script (nove punti di iniezione HTML più una sezione Scripts-before-load) — [Consulta queste sezioni qui.](/it/upcart/custom_html)

* **Controlla la console del browser** – Segui i passaggi sopra per cercare errori.

* **Prova uno script diverso** – Prova un altro script API di Upcart già pronto per capire se il problema è nel tuo codice.

* **Ancora bloccato?** – Se stai modificando il tuo tema Shopify o integrando app di terze parti, uno Shopify Expert dalla [Shopify Partner Directory](https://www.shopify.com/partners/directory) può aiutarti.

Questi passaggi dovrebbero aiutarti a identificare e risolvere la maggior parte dei problemi con gli script!

***

<div id="how-do-i-undo-changes-if-i-add-a-script-that-breaks-something">
  # Come annullo le modifiche se aggiungo uno script che rompe qualcosa?
</div>

Se aggiungi uno script che non funziona come previsto, puoi **rimuoverlo o disattivarlo facilmente**:

* **Vai alle impostazioni Custom HTML di Upcart** dove è stato aggiunto lo script.

* **Rimuovi lo script** o disattivalo temporaneamente aggiungendo `//` all'inizio di ogni riga (questo lo trasforma in un commento, impedendone l'esecuzione).

* **Salva le modifiche e aggiorna il tuo store** per verificare se il problema è risolto.

Se il problema persiste, prova a svuotare la cache o a ripristinare le modifiche recenti al tema — questo spesso risolve conflitti nascosti.

***

🚧 **Cerchi personalizzazioni avanzate?**

Hai bisogno di personalizzazioni a livello di store o integrazioni con app di terze parti? Potresti aver bisogno di uno sviluppatore per aggiungere l'API di Upcart al tuo tema Shopify.

Valuta di ingaggiare uno Shopify Expert tramite la **[Shopify Partner Directory](https://www.shopify.com/partners/directory)** e condividi con lui la nostra [documentazione API](/it/upcart/introduction_to_upcarts_public_api) per assistenza