# Vendi articoli su misura dalla tua pagina

> Se hai creato una tua pagina in cui i clienti progettano un prodotto e vedono il prezzo in tempo reale, quella pagina può aggiungere esattamente quell’articolo al tuo carrello Shoprocket. Il tuo server firma l’articolo con una chiave di firma, così nessuno può cambiare il prezzo dal browser.

Centro assistenza / Integrazioni - Aggiornato il 12 novembre 2026

Alcuni prodotti hanno un prezzo che dipende dalle scelte del cliente. Una mensola su misura costa di più se è più lunga, e il prezzo di una pergola dipende dalle dimensioni e dal legno usato. Oggi molti venditori creano una propria pagina per questo, spesso con un costruttore di siti basato sull’IA: il cliente sposta qualche cursore e vede il prezzo cambiare.

Quella pagina può aggiungere il progetto finito al tuo carrello Shoprocket. Poi il cliente paga come di consueto, con gli altri tuoi prodotti nello stesso carrello, e l’ordine, le e-mail e la fattura mostrano ogni sua scelta.

**Il prezzo è firmato, quindi i clienti non possono cambiarlo.** Un prezzo inviato da una pagina web per conto suo potrebbe essere modificato da chiunque nel proprio browser. Invece è il tuo server a calcolare il prezzo e a firmarlo con una chiave segreta. Shoprocket controlla la firma prima che l’articolo entri nel carrello e lo rifiuta se qualcosa è stato modificato.

Serve uno sviluppatore, oppure un costruttore IA in grado di eseguire codice su un server, perché la firma deve avvenire su un server e non nella pagina web.

## Prima di cominciare

Le chiavi di firma si trovano nella schermata **Chiavi API**, che fa parte dell’app **Strumenti per sviluppatori**. Se non vedi **Chiavi API** sotto **Impostazioni** nella barra laterale, vai su **App**, trova **Strumenti per sviluppatori** sotto **Sviluppatori** e fai clic su **Aggiungi**. Vedi [Aggiungere e rimuovere app](https://shoprocket.io/it/aiuto/aggiungere-e-rimuovere-app.md).

Ti serve anche un prodotto nel catalogo a cui l’articolo appartenga, per esempio “Mensola su misura”. L’articolo prende da quel prodotto l’impostazione delle tasse e le opzioni di consegna, e anche l’immagine, a meno che il tuo server ne invii una propria. Se non vuoi che i clienti possano acquistare il prodotto da solo al prezzo indicato, impostalo su **Richiedi info** (vedi [Ricevi richieste di preventivo e di informazioni](https://shoprocket.io/it/aiuto/richieste-di-preventivo.md)). I clienti potranno comunque acquistare un articolo firmato per quel prodotto.

## Creare una chiave di firma

1. Nella dashboard, vai su **Impostazioni > Chiavi API**.
2. Nella scheda **Chiavi di firma**, fai clic su **Crea chiave di firma**.
3. Copia l’**ID chiave** e il **Segreto**, poi fai clic su **L’ho salvata**.

![La scheda Chiavi di firma con l’ID chiave e il segreto di una nuova chiave, e i pulsanti Copia](https://shoprocket.io/img/help/sell-custom-priced-items/signing-key.webp)

Il segreto viene mostrato solo questa volta. Tienilo sul tuo server, dove il codice della tua pagina possa leggerlo, e non metterlo mai nella pagina web stessa.

## Aggiungere un articolo firmato al carrello

Il tuo server prepara una breve descrizione dell’articolo e la firma. Poi la tua pagina passa il risultato al carrello. La descrizione indica:

- a quale prodotto appartiene e il prezzo di un singolo articolo, nella valuta del tuo negozio
- un nome da mostrare nel carrello, per esempio “Mensola, 120 cm, rovere”
- le scelte del cliente, come elenco di etichette e valori, per esempio “Lunghezza: 120 cm”
- il peso di un singolo articolo, se calcoli la spedizione in base al peso
- un’immagine del design, se è già online, come indirizzo web che inizia con https://
- per quanto tempo è valido il prezzo, fino a 30 giorni da adesso

Uno sviluppatore trova il formato esatto e un esempio da copiare in [Articoli firmati del carrello](https://shoprocket.io/docs/signed-items.md). La tua pagina aggiunge poi l’articolo con una sola riga e il carrello si apre come per qualsiasi altro prodotto:

```js
Shoprocket.cart.add({ signed: signedItemFromYourServer, quantity: 1 });
```

Il cliente può cambiare la quantità nel carrello, ma mai il prezzo. Due progetti diversi restano due articoli separati.

## Cosa vede il cliente

L’articolo compare nel carrello con il nome che hai scelto, con la sua immagine e, sotto, ciascuna scelta del cliente. L’immagine è quella inviata dal tuo server o, se non ne ha inviata nessuna, quella del prodotto stesso. Dopo il pagamento, le stesse scelte compaiono nell’ordine nella tua dashboard, nell’e-mail di conferma dell’ordine e nella fattura.

Per mostrare a ogni cliente il proprio design, la tua pagina può salvarne un’immagine e caricarla nel carrello subito prima di aggiungere l’articolo:

```js
const { token } = await Shoprocket.cart.uploadFile(snapshot);
Shoprocket.cart.add({ signed: signedItemFromYourServer, image: token, quantity: 1 });
```

Shoprocket conserva una propria copia dell’immagine, quindi non devi archiviarla da nessuna parte. Se il cliente non completa mai il checkout, l’immagine viene eliminata insieme al suo carrello. Anche un’immagine che il tuo server invia come indirizzo web viene copiata, quando l’ordine viene effettuato. In entrambi i casi, l’ordine e le sue e-mail continuano a mostrare l’immagine anche se il file originale viene eliminato in seguito.

I codici sconto e gli sconti automatici funzionano sugli articoli firmati come su qualsiasi altro prodotto. Il prezzo non viene mai modificato dal prezzo in offerta del prodotto né dagli sconti per quantità, perché il prezzo firmato dal tuo server è il prezzo.

Se calcoli la spedizione in base al peso, conta il peso firmato dal tuo server. Altrimenti valgono le impostazioni di spedizione del prodotto.

## Mantenere un prezzo per un periodo fisso

Ogni articolo firmato indica per quanto tempo il suo prezzo è valido, così puoi rispettare un preventivo per un periodo fisso. Ad esempio, se proponi una pergola a 1.000 e ti impegni a mantenere quel prezzo per 14 giorni, il tuo server firma l’articolo con una scadenza tra 14 giorni. Puoi mantenere un prezzo fino a 30 giorni.

Il cliente vede "Prezzo garantito fino al" e la data sotto l’articolo nel carrello. Fino a quella data può pagare a quel prezzo.

Dopo la data non può più acquistare l’articolo a quel prezzo, anche se è ancora nel carrello. Quando prova a pagare, il carrello mostra "Questo prezzo è scaduto. Richiedi di nuovo il prezzo." sotto l’articolo, con un pulsante per rimuoverlo. Può quindi tornare sulla tua pagina e ottenere un nuovo prezzo.

Se un cliente ha già effettuato l’ordine, o approvato un pagamento PayPal, prima della scadenza del prezzo, niente lo blocca. Il suo ordine va a buon fine al prezzo che hai firmato.

## Sostituire o revocare una chiave

- **Sostituisci una chiave** quando uno sviluppatore se ne va o pensi che il segreto sia trapelato. Fai clic su **Sostituisci chiave**. La vecchia chiave continua a funzionare per 7 giorni, così la tua pagina va avanti mentre aggiorni il server con il nuovo segreto. La vecchia chiave mostra la data in cui smette di funzionare.
- **Revoca una chiave** per fermarla subito. Fai clic su **Revoca** e conferma. Ciò che ha firmato non potrà più essere aggiunto a un carrello, e gli articoli già presenti nel carrello di un cliente vengono rifiutati al pagamento.

## Articoli correlati

- [Creare una chiave API](https://shoprocket.io/it/aiuto/creare-una-chiave-api.md)
- [Incorpora Shoprocket in qualsiasi sito](https://shoprocket.io/it/aiuto/incorpora-shoprocket-su-qualsiasi-sito.md)
- [Extra e personalizzazione](https://shoprocket.io/it/aiuto/extra-e-personalizzazione.md)

[Apri le chiavi API nella dashboard](https://app.shoprocket.io/go/settings/api-keys)

---

- HTML version: https://shoprocket.io/it/aiuto/vendere-articoli-su-misura-dalla-tua-pagina
- Language: Italiano (it)
- Also in: [العربية](https://shoprocket.io/ar/help/sell-custom-priced-items.md), [Deutsch](https://shoprocket.io/de/hilfe/eigene-seite-massgefertigte-artikel-verkaufen.md), [Ελληνικά](https://shoprocket.io/el/help/sell-custom-priced-items.md), [English](https://shoprocket.io/help/sell-custom-priced-items.md), [Español](https://shoprocket.io/es/ayuda/vender-articulos-a-medida-desde-tu-propia-pagina.md), [Français](https://shoprocket.io/fr/aide/vendre-articles-sur-mesure-depuis-votre-page.md), [עברית](https://shoprocket.io/he/help/sell-custom-priced-items.md), [हिन्दी](https://shoprocket.io/hi/help/sell-custom-priced-items.md), [Bahasa Indonesia](https://shoprocket.io/id/bantuan/jual-barang-pesanan-khusus-dari-halaman-anda-sendiri.md), [日本語](https://shoprocket.io/ja/help/sell-custom-priced-items.md), [Lietuvių](https://shoprocket.io/lt/pagalba/parduokite-pagal-uzsakyma-pagamintas-prekes-is-savo-puslapio.md), [Norsk](https://shoprocket.io/nb/hjelp/selge-skreddersydde-varer-fra-din-egen-side.md), [Nederlands](https://shoprocket.io/nl/hulp/maatwerk-artikelen-verkopen-vanaf-je-eigen-pagina.md), [Polski](https://shoprocket.io/pl/pomoc/sprzedawaj-produkty-na-miare-z-wlasnej-strony.md), [Português](https://shoprocket.io/pt/ajuda/vender-itens-sob-medida-na-sua-propria-pagina.md), [Română](https://shoprocket.io/ro/ajutor/vinde-articole-la-comanda-din-propria-pagina.md), [Русский](https://shoprocket.io/ru/help/sell-custom-priced-items.md), [ไทย](https://shoprocket.io/th/help/sell-custom-priced-items.md), [Türkçe](https://shoprocket.io/tr/yardim/kendi-sayfanizdan-ozel-uretim-urunler-satin.md), [中文](https://shoprocket.io/zh/help/sell-custom-priced-items.md)
