> For the complete documentation index, see [llms.txt](https://docs.sellermagnet.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.sellermagnet.com/it-sellermagnet-guida/strumenti-di-vendita/repricer-overview/create-manage-repricer.md).

# Crea e gestisci le regole del Repricer

Guida completa al modale Create Repricer, selezione del prodotto, configurazione della strategia, base di costo, regole di prezzo, anteprima di profitto live e flussi di modifica/importazione in blocc

{% hint style="info" %}
**Difficoltà:** 🔴 Avanzato · **Tempo di lettura:** \~10 min
{% endhint %}

![Create Repricer Modal](https://2537803323-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FtuTBq4X62QzdvNBjVCWK%2Fuploads%2Fgit-blob-cc1dd41dff70daf85dd7b1481609790ac8a5a8e3%2Frepricer-create-modal.png?alt=media)

## 📋 Panoramica

Il flusso **Create Repricer** risiede in un unico modale a pagina intera che gestisce sia la **creazione di nuove regole del repricer** sia la **modifica di quelle esistenti**. È progettato come un unico modulo visivamente strutturato, tre schede di configurazione impilate a sinistra, un'anteprima di profitto live a destra, così puoi configurare una regola, vedere l'impatto sul margine in tempo reale e confermare in meno di un minuto.

{% hint style="info" %}
**Un modale, due modalità.** Lo stesso modale si apre sia che tu faccia clic su **New Repricer** sia sul pulsante **Manage** di una riga. Un badge in alto recita **Create Repricer** o **Manage Repricer** per dirti in quale modalità sei. In modalità Edit il selettore del prodotto è sostituito dal prodotto scelto. La barra delle schede - Settings / Recommendations / Simulation / Price History / Analysis / Sales History - appare in entrambe le modalità; in modalità Create compare non appena scegli un prodotto. Vedi [Simulazione (prova a vuoto)](#simulazione-prova-a-vuoto) sotto per la prova a vuoto senza rischi.
{% endhint %}

***

## 🚪 Aprire il modale Create

Dalla **Repricer Dashboard**, la toolbar in alto a destra porta sei controlli - un'icona report-settings, **Delete All**, **Columns**, **Export**, **Import CSV** e **New Repricer**. Tre di essi contano qui:

<table><thead><tr><th width="200">Pulsante</th><th width="80">Icona</th><th>Cosa fa</th></tr></thead><tbody><tr><td><strong>New Repricer</strong></td><td><code>+</code></td><td>Apre il modale Repricer Management in <strong>modalità Create</strong>. Usalo per la creazione manuale di regole una alla volta. (Se non hai ancora prodotti attivi sincronizzati, te lo dice invece.)</td></tr><tr><td><strong>Import CSV</strong></td><td><code>file</code></td><td>Apre il modale separato <strong>Bulk Import</strong> a 4 passi (Connection → Upload → Validation → Import) per creare decine o centinaia di regole in una volta.</td></tr><tr><td><strong>Export</strong></td><td><code>↓</code></td><td>Apre il modale <strong>Export options</strong>. Scegli cosa esportare, poi scarica come <strong>CSV o Excel</strong>. Vedi <a href="#opzioni-di-esportazione-csv-excel">Opzioni di esportazione</a> sotto.</td></tr></tbody></table>

Per modificare una regola esistente, fai clic sul pulsante d'azione **Manage** (matita) della riga - fare clic altrove sulla riga non fa nulla. Le righe sono raggruppate per le tre schede di strategia (**All**, **Resellers**, **Brand / PL**) e l'interruttore **State** (Active / Inactive). Vedi [Le schede di stato spiegate](#le-schede-di-stato-spiegate) per schede, pillole e stati.

***

## 🧭 Anatomia del modale

Una volta aperto il modale vedrai cinque regioni distinte, ciascuna che gestisce una parte diversa della configurazione.

### 1. Product Header

Corre per tutta la larghezza del modale sopra le schede di configurazione. Mostra il prodotto che stai riprezzando:

* **Immagine del prodotto, titolo, SKU (Stock Keeping Unit) e ASIN (Amazon Standard Identification Number)**
* **Bandiera + nome del marketplace** (es. Amazon.de)
* **Badge di fulfillment:** FBA (blu) o FBM (ambra)
* **Badge di scorte:** unità correnti in magazzino
* **Cinque riquadri di prezzo:** Current / Minimum / Maximum / BuyBox / New Offers

In modalità Create questa sezione è **vuota finché non scegli un prodotto** dal menu a discesa sottostante.

### 2. Product Selector (solo modalità Create)

{% hint style="warning" icon="triangle-exclamation" %}
**Non puoi digitare un ASIN qui.** Il menu a discesa è popolato dai tuoi **prodotti Amazon Active sincronizzati**. Se un prodotto che vuoi riprezzare manca, verifica che sia Active in Seller Central e attendi il prossimo ciclo di sincronizzazione.
{% endhint %}

Un singolo menu a discesa `<select>` etichettato **Select Product** elenca ogni prodotto attivo da ogni marketplace connesso. Scegline uno, il Product Header sopra si popola e le tre schede di configurazione + Live Preview diventano interattive.

### 3. Scheda Strategy Configuration

La prima scheda di configurazione (icona cavallo degli scacchi, in alto a sinistra dell'area del modulo). Qui scegli COME la regola compete.

{% tabs %}
{% tab title="Strategy picker" %}
**Strategy** (obbligatorio), menu a discesa di ogni strategia supportata. Ogni opzione ha una breve descrizione che appare in una casella info blu direttamente sotto il menu a discesa una volta selezionata. Un link "Learn more" ti porta alla [Repricing Strategies Overview](/it-sellermagnet-guida/strumenti-di-vendita/repricer-overview/repricing-strategies-overview.md) completa.

**Interruttore Active** (in alto a destra della scheda), attiva/disattiva la regola senza eliminarla. Le regole in pausa compaiono quando il filtro **State** della dashboard è impostato su **Inactive**.

**Expiry Date** (opzionale), scegli un valore `datetime-local`. La regola si ferma automaticamente in quel momento. Lascia vuoto per girare indefinitamente.
{% endtab %}

{% tab title="Campi specifici della strategia" %}
Strategie diverse espongono sotto-campi diversi che appaiono dinamicamente sotto il picker:

<table><thead><tr><th width="220">Famiglia di strategia</th><th>Campi extra</th></tr></thead><tbody><tr><td><strong>Position-based</strong></td><td><code>Position</code>, intero, predefinito <code>1</code>, minimo <code>1</code>. Determina quale rank punti.</td></tr><tr><td><strong>Same Price as Seller</strong></td><td><code>Seller ID</code>. Identificatore del venditore Amazon da rispecchiare.</td></tr><tr><td><strong>Brand Guard / Competitive</strong></td><td><code>Competitor ASINs</code> (separati da virgole), <code>Sales Velocity</code> (giorni, predefinito 7), <code>Low Stock</code> (predefinito 10), <code>High Stock</code> (predefinito 50), più una casella <strong>Reduce price when the item is not selling</strong> (off di default). Quando è attiva e nessun ASIN concorrente è impostato, il prezzo scende verso il tuo minimo su zero vendite nel periodo di velocità; lasciala off e BrandGuard riduce il prezzo solo per ribassare un concorrente o liberare l'eccesso di scorte.</td></tr><tr><td><strong>Competitor ASIN Sync</strong></td><td><code>Competitor ASIN</code>, <code>Price Adjustment Factor</code> (0,5-1,5, passo 0,01, predefinito 1,0).</td></tr><tr><td><strong>Lowest Price / MAP (Minimum Advertised Price) / Brand-PL</strong></td><td>Nessun campo extra, strategia guidata dal prezzo Min/Max e dai margini che imposti nella Scheda C.</td></tr></tbody></table>
{% endtab %}
{% endtabs %}

{% hint style="success" icon="circle-check" %}
**Live Strategy Advisory (controllo pre-salvataggio).** Per le strategie BrandGuard, Competitor ASIN-BuyBox Sync e Velocity Balance, un avviso contestuale appare sotto gli input della strategia e si aggiorna live mentre digiti, dicendoti prima di salvare se la configurazione corrente riprezzerà effettivamente. Una nota verde conferma una configurazione sana; una nota ambra avverte quando non lo è, per esempio "Add a competitor ASIN to start repricing" per Competitor ASIN-BuyBox Sync senza ASIN inserito, o, per BrandGuard senza ASIN concorrente e con "Reduce price when the item is not selling" lasciato off, "This setup won't lower your price on slow sales". Leggila prima di fare clic su Save.
{% endhint %}

### 4. Scheda Cost Basis

La seconda scheda di configurazione (icona monete). Tutto ciò che paghi per il prodotto, usato dalla Live Preview per calcolare il profitto reale.

<table><thead><tr><th width="200">Campo</th><th width="110">Tipo</th><th>Note</th></tr></thead><tbody><tr><td><strong>Purchase Price</strong> *</td><td>€ numero</td><td>Costo unitario pagato al tuo fornitore. Obbligatorio, senza di esso il calcolo del profitto è sbagliato.</td></tr><tr><td><strong>Shipping Cost</strong></td><td>€ numero</td><td>Spedizione per unità in entrata (FBA) o in uscita (FBM). Opzionale ma consigliato.</td></tr><tr><td><strong>VAT %</strong></td><td>% numero</td><td>Aliquota IVA o imposta sulle vendite da dedurre. Predefinito allo standard del tuo marketplace (19% per DE, ecc.).</td></tr><tr><td><strong>Fee %</strong></td><td>% numero</td><td>Commissioni referral + FBA di Amazon come percentuale. Fai clic sul pulsante <strong>Fetch</strong> accanto a questo campo per estrarre automaticamente l'aliquota live corrente da Amazon.</td></tr><tr><td><strong>Miscellaneous Cost</strong></td><td>€ numero</td><td>Costo flat per unità non coperto altrove (imballaggio, etichette, ispezione, ecc.).</td></tr><tr><td><strong>Miscellaneous Fee %</strong></td><td>% numero</td><td>Commissione percentuale non coperta altrove (es. commissioni 3PL).</td></tr></tbody></table>

{% hint style="success" icon="rocket" %}
**Consiglio pro:** fai sempre clic su **Fetch** per Fee %. La percentuale referral di Amazon varia per categoria (8-15%) e Fetch estrae il valore corretto per *questo* ASIN, molto più accurato che digitare una stima.
{% endhint %}

### 5. Scheda Pricing Rules

La terza scheda di configurazione (icona cursori). Il margine e le soglie di prezzo che vincolano dove il motore può andare.

{% stepper %}
{% step %}

### Margin Calculation Basis

Menu a discesa con due opzioni:

* **Based on Sale Price (Default):** margine = profitto ÷ prezzo di vendita. Margine e-commerce standard.
* **Based on COGs (Markup):** margine = profitto ÷ costo del venduto. Utile se ragioni in termini di markup anziché di margine.
  {% endstep %}

{% step %}

### Min Margin \*

Il margine di profitto più basso (%) che la regola può accettare. Se un prezzo proposto producesse un margine inferiore a questo, il motore si ferma a Min Price invece. Esempio: `8%` significa "non vendere mai a meno dell'8% di margine, qualunque cosa accada."
{% endstep %}

{% step %}

### Max Margin \*

Il margine più alto (%) che la regola punta. Agisce come limite superiore morbido, il motore non alzerà i prezzi oltre questo margine anche se la Buy Box non è contesa. Esempio: `35%`.
{% endstep %}

{% step %}

### Minimum Price \*

Soglia minima assoluta rigida. La regola non imposterà mai un prezzo sotto questo valore, indipendentemente da ciò che calcola Min Margin. Questo è il tuo guardrail di ultima difesa.
{% endstep %}

{% step %}

### Maximum Price (opzionale)

Soglia massima assoluta. Lascia vuoto per lasciare che il motore alzi liberamente fino a Max Margin.
{% endstep %}
{% endstepper %}

{% hint style="warning" icon="triangle-exclamation" %}
**Attenzione: cambiare "Margin Calculation Basis" reinterpreta i tuoi margini.** Passare tra **Sale Price** e **COGs** cambia cosa significano le tue percentuali di Min Margin e Max Margin, quindi lo stesso `8%` / `35%` fisserà la soglia minima e massima del prezzo in punti diversi. Ricontrolla sempre le tue cifre di Min/Max Margin dopo aver capovolto questo interruttore, prima di salvare.
{% endhint %}

{% hint style="warning" %}
**Min Margin vs Minimum Price : entrambi fissano la soglia minima del prezzo.** Il motore usa **quello più alto**. Se Min Margin calcola una soglia minima di €42,00 ma Minimum Price è €39,90, la soglia effettiva è €42,00. Questo è per progetto, i margini hanno priorità sui prezzi statici.
{% endhint %}

### 6. Live Preview / Price Breakdown

La colonna destra del modale, una pillola verde `LIVE PREVIEW` indica che questo pannello si aggiorna in tempo reale mentre digiti nei campi di costo/prezzo. Mostra due schede di prezzo impilate:

<table><thead><tr><th width="150">Scheda</th><th>Mostra</th></tr></thead><tbody><tr><td><strong>Min Price</strong> (blu)</td><td>Prezzo base + spedizione - IVA - commissioni Amazon (con sotto-ripartizione per referral / fulfillment FBA) - COG, poi <strong>Profitto</strong> su una riga separata in grassetto, e il <strong>30-day Avg Sell Price</strong> sotto per contesto.</td></tr><tr><td><strong>Max Price</strong> (grigio)</td><td>Stessa ripartizione applicata al Maximum Price. Vedi rapidamente la soglia massima di profitto.</td></tr></tbody></table>

Sotto le due schede: un pulsante blu a larghezza piena **Fetch Amazon Fees**. Facendo clic estrae la **percentuale referral** e le **commissioni di fulfillment FBA** live correnti per questo ASIN direttamente da Amazon: l'aliquota referral popola il campo **Fee %** e la commissione FBA alimenta la ripartizione del profitto, così le cifre di profitto Min/Max riflettono le commissioni Amazon reali invece di una stima.

{% hint style="danger" %}
**Banner di avviso rossi** appaiono in fondo alla Live Preview se una di queste condizioni è vera:

* **Min price è sotto la Buy Box corrente:** venderai ma probabilmente in perdita. **Correzione:** alza il tuo Minimum Price, o abbassa il tuo Min Margin %.
* **Min price è sopra il prezzo corrente:** salterai il prezzo del listing verso l'alto.
* **Max price è sotto la Buy Box:** la tua regola non potrà mai prendere la Buy Box. **Correzione:** alza il tuo Maximum Price.
  {% endhint %}

***

## 🧪 Simulazione (prova a vuoto)

La scheda **Simulation** ti consente di visualizzare in anteprima esattamente cosa il tuo repricer *farebbe* nei prossimi cicli, **prima** di salvare la regola e **senza mai inviare un prezzo ad Amazon**. Esegue la strategia configurata e la soglia minima/massima rispetto alle offerte **live** correnti del prodotto e proietta i movimenti che farebbe.

{% hint style="success" icon="rocket" %}
**Senza rischi per progetto.** La simulazione è una pura prova a vuoto. Nessun prezzo viene mai inviato ad Amazon, nulla viene salvato e il listing live non viene toccato. Eseguila quante volte vuoi per verificare una configurazione.
{% endhint %}

La scheda è disponibile in **entrambe le modalità Create ed Edit** (in modalità Create devi prima scegliere un prodotto, poiché il simulatore ha bisogno di un ASIN live per cui recuperare le offerte).

### Controlli

<table><thead><tr><th width="200">Controllo</th><th>Cosa fa</th></tr></thead><tbody><tr><td><strong>Iterations</strong></td><td>Quanti cicli di repricing proiettare, <strong>1-10</strong> (predefinito 5). Ogni ciclo è una decisione che il repricer prenderebbe contro le offerte live. Usa lo stepper <code>−</code> / <code>+</code>.</td></tr><tr><td><strong>Scenarios</strong></td><td>Scegli uno o più di tre modelli di reazione dei concorrenti (vedi sotto). Tutti e tre sono selezionati di default.</td></tr><tr><td><strong>Run preview</strong></td><td>Recupera le offerte live ed esegue la simulazione. Uno skeleton loader appare mentre lavora.</td></tr></tbody></table>

### I tre scenari

Il simulatore modella quanto aggressivamente i tuoi concorrenti reagiscono ai tuoi movimenti di prezzo, così puoi vedere l'intero spettro di risultati anziché una singola supposizione.

<table><thead><tr><th width="150">Scenario</th><th>Cosa presume</th></tr></thead><tbody><tr><td><strong>Best case</strong> (verde)</td><td>I concorrenti mantengono i loro prezzi, quindi prendi la Buy Box al miglior prezzo che la tua strategia consente.</td></tr><tr><td><strong>Expected</strong> (blu)</td><td>Solo l'attuale detentore della Buy Box reagisce, ribassando una volta se rubassi la box; tutti gli altri mantengono.</td></tr><tr><td><strong>Worst case</strong> (rosso)</td><td>Il concorrente più forte ti ri-ribassa ogni round, una corsa verso la tua soglia minima.</td></tr></tbody></table>

### Come leggere i risultati

Dopo aver fatto clic su **Run preview**, il pannello dei risultati mostra, dall'alto verso il basso:

* **Strategy hero:** la strategia simulata e una breve descrizione di come si comporta.
* **Simulation inputs:** chip che elencano esattamente cosa è stato applicato, strategia, fulfillment, soglia minima, soglia massima ed eventuali parametri specifici della strategia (posizione target, ASIN concorrenti, banda di velocità, ecc.). Questo è lo stesso insieme di limiti che il repricer live rispetta.
* **Current-state context:** numero di offerte live, l'attuale vincitore della Buy Box e il prezzo, e la tua banda soglia minima/massima.
* **Projected price trajectory chart:** il tuo prezzo lungo ogni ciclo, una linea per scenario, con linee tratteggiate che marcano la tua soglia minima e massima.
* **Scenario outcome cards** (una per scenario selezionato):
  * Prezzo iniziale → prezzo finale, con la variazione netta.
  * Un indicatore a banda che mostra dove il prezzo di arrivo si colloca tra la tua soglia minima e massima (segnala **hits floor** / **hits ceiling**).
  * **Wins Buy Box** o **No Buy Box** per quello scenario.
  * Statistiche: numero di variazioni di prezzo, netto stimato per unità, **margine %** al prezzo di arrivo (rosso se negativo) e il conteggio dei concorrenti.
  * Un **insight** in linguaggio semplice che spiega *perché* il prezzo arriva dove arriva per la strategia scelta.
* **Step-by-step cycles:** una tabella comprimibile per scenario, una riga per ciclo, che mostra il tuo prezzo prima, l'azione intrapresa (Price change / Hold / Blocked by limit / Out of stock), il nuovo prezzo, il netto per unità, il vincitore stimato della Buy Box e una breve spiegazione.

{% hint style="info" icon="circle-info" %}
**Stimato, non garantito.** Il vincitore della Buy Box a ogni ciclo è *stimato*, e i comportamenti time-gated (come il lento aumento graduale mentre mantieni la box, o il breve blocco di pazienza dopo un movimento di un concorrente) sono annotati anziché attesi. Tratta la proiezione come direzionale. Se tutti gli scenari selezionati risultano identici, il simulatore li unisce in un'unica scheda e ti dice che non c'è pressione competitiva a divergere.
{% endhint %}

{% hint style="warning" icon="triangle-exclamation" %}
**Brand Guard è approssimato.** Per la strategia Brand Guard, i controlli di velocità di vendita live, livelli di scorte e venditori non autorizzati sono semplificati per l'anteprima. I movimenti proiettati sono direzionali, il repricer live considera l'intero segnale.
{% endhint %}

> **Perché è importante:** la simulazione è il modo più sicuro per convalidare una nuova soglia minima, massima o un cambio di strategia. Se la scheda **worst case** arriva già alla tua soglia minima con un margine sottile o negativo, la tua soglia minima è troppo bassa o i tuoi costi troppo alti, correggilo qui prima che la regola tocchi mai il tuo prezzo live.

***

## 🎬 Barra delle azioni

Fissata in fondo al modale:

* **Reset** (grigio, icona rotazione): azzera tutti i campi ai predefiniti. Usa con cautela, nessuna conferma.
* **Create Repricer** (blu, icona più): convalida e salva. Se manca un campo obbligatorio il modale lo evidenzia in rosso e il pulsante è disabilitato.

In **modalità Edit** il pulsante Create è sostituito da un pulsante blu **Save** che invia all'endpoint di aggiornamento.

***

## ⚡ Push Price Now (spinta manuale del prezzo)

In **modalità Edit**, la barra delle azioni mostra un pulsante extra **Push price now** (icona fulmine) accanto a **Save**. È nascosto in modalità Create, perché non c'è un listing live a cui spingere finché la regola non esiste.

Questa è la tua sovrascrittura manuale. Facendo clic si apre un piccolo pannello inline dove digiti un prezzo e confermi, e SellerMagnet imposta quel prezzo esatto sul tuo listing Amazon **immediatamente**, al di fuori del normale ciclo del repricer. **Non** attende la prossima valutazione del motore, e **non** esegue la tua strategia, spinge il prezzo che hai digitato, direttamente.

{% hint style="info" icon="circle-info" %}
**Come funziona.** Il pannello si precompila con il tuo Minimum Price corrente come suggerimento iniziale e mostra la tua **banda di prezzo** configurata (`min - max`) come riferimento. Inserisci qualsiasi prezzo maggiore di zero e conferma (o premi **Invio** nel campo). Al successo, il riquadro Current price nel product header si aggiorna al nuovo valore e appare un toast di conferma. Fai clic di nuovo sul pulsante, o su **Cancel**, per chiudere il pannello senza inviare nulla.
{% endhint %}

{% hint style="danger" %}
**Questa è una modifica di prezzo live.** Il prezzo che inserisci viene scritto sul tuo listing Amazon reale nel momento in cui confermi. Non c'è prova a vuoto e non c'è annullamento, questa non è la scheda [Simulazione](#simulazione-prova-a-vuoto). Ricontrolla il valore, e la valuta, prima di confermare.
{% endhint %}

**Quando usarlo:**

* **Sbloccare un prezzo bloccato.** Se il tuo prezzo live si trova fuori dalla tua nuova banda min/max (per esempio, dopo aver stretto i tuoi margini), spingere un prezzo dentro la banda dà al motore un punto di partenza pulito da cui riprezzare.
* **Forzare un prezzo immediato** per una vendita flash, un price-match o una correzione manuale, senza attendere il prossimo ciclo del repricer.
* **Sovrascrittura una tantum** quando vuoi impostare un prezzo specifico a mano ma mantenere la regola e la sua strategia in vigore per tutto ciò che segue.

{% hint style="info" %}
**Push price now vs. Apply min/max now.** La barra delle azioni offre anche un pulsante **Apply min/max now** (icona frecce sinistra-destra). Sono strumenti diversi: **Push price now** invia un *prezzo che digiti*; **Apply min/max now** salva prima le tue impostazioni correnti, poi, solo se il prezzo live è fuori dalla tua banda salvata, lo sposta automaticamente al limite min/max più vicino (senza digitare). Usa **Apply min/max now** quando hai appena cambiato la tua banda e vuoi che il prezzo sia riportato dentro; usa **Push price now** quando vuoi impostare un numero specifico.
{% endhint %}

***

## ✏️ Modificare una regola esistente

Fai clic sul pulsante **Manage** (matita) di una riga nella tabella della Repricer dashboard; lo stesso modale si apre in **modalità Edit** con:

* Il badge che recita **Manage Repricer** invece di **Create Repricer**
* Il prodotto pre-selezionato (selettore nascosto)
* Tutti i valori correnti di strategia + costo + prezzo pre-popolati
* **Sei schede** in cima all'area del modulo: Settings / Recommendations / Simulation / Price History / Analysis / Sales History, così puoi vedere le performance storiche accanto alla configurazione corrente

Cambia ciò che ti serve, fai clic su **Save** per confermare.

{% hint style="info" %}
**Nessuna ricostruzione necessaria.** Le modifiche si applicano immediatamente al Save, il motore recepisce i nuovi parametri al suo prossimo ciclo di valutazione (circa ogni 5 minuti). Non devi mettere in pausa e riavviare la regola.
{% endhint %}

{% hint style="info" icon="circle-info" %}
**Salvare il costo sul prodotto.** Dopo aver creato un repricer, o cambiato il **prezzo d'acquisto** di un repricer, SellerMagnet può chiedere *"Save these costs to your products?"* - offrendo di copiare quel prezzo d'acquisto sul prodotto come suo costo del venduto (COGS) così la scheda Products e le analytics di profitto usano la stessa cifra. Vedi [Saving imported costs to your products (COGS sync)](/it-sellermagnet-guida/strumenti-di-vendita/repricer-overview/bulk-import-export.md#salvare-i-costi-importati-sui-tuoi-prodotti-sincronizzazione-cogs) per come leggere l'anteprima. Nota che il **costo di spedizione** del repricer è solo un input di prezzo/profitto - non viene scritto sul prodotto.
{% endhint %}

### La scheda Recommendations

In modalità Edit, la scheda **Recommendations** estrae uno snapshot di prezzo live per il listing (tramite l'endpoint `repricer_price_recommendations`) e lo trasforma in un singolo prezzo suggerito. Mostra:

* **Pricing overview** - Current Price, Competitive Price (etichettato **You own the BuyBox** quando la detieni già), Listing Price e un **Suggested Price**. Il suggerimento si colloca appena sotto il prezzo competitivo ed è limitato al tuo Min/Max, quando il tuo Minimum Price lo limita, la scheda mostra anche la cifra non vincolata come riferimento. Una riga **Recommendation** in linguaggio semplice spiega il movimento (mantieni, abbassa per competere, regola al meglio, o limitato dal tuo minimo).
* **Competitors** - il conteggio di **New Offers** e **Other Offers** sul listing.
* **Sales rankings** - il **Primary Rank** del listing e il **Sub Rank** di categoria.
* Un **grafico di confronto prezzi** che traccia il tuo prezzo corrente, competitivo, di listing, suggerito, min e max.

Usa **Refresh** per riestrarre lo snapshot, o applica il prezzo suggerito direttamente dalla scheda.

***

## ⬇️ Opzioni di esportazione (CSV & Excel)

Il pulsante **Export** della toolbar apre il modale **Export options**. Scegli una di tre modalità, poi fai clic sul pulsante di download, che è un menu diviso che offre **CSV** o **Excel (.xlsx)**.

<table><thead><tr><th width="230">Modalità</th><th>Cosa ottieni</th><th width="120">Formato</th></tr></thead><tbody><tr><td><strong>Products &#x26; Fees</strong> (predefinito)</td><td>Ogni prodotto sincronizzato precompilato con le sue reali commissioni Amazon, IVA e prezzi correnti, il template di partenza consigliato per Bulk Import. Un disclaimer sulle commissioni è mostrato mentre questa modalità è selezionata.</td><td>CSV o Excel</td></tr><tr><td><strong>Import template (Basic)</strong></td><td>Un template vuoto, con intestazioni corrette e una riga di esempio, per costruire un file di importazione da zero.</td><td>Solo CSV*</td></tr><tr><td><strong>Current repricers</strong></td><td>Le tue regole del repricer esistenti (SKU, ASIN, nome, marketplace, prezzo, soglie min/max, margine min/max, stato, ultimo aggiornamento). Un menu a discesa <strong>scope</strong> ti consente di restringere a, es., <em>Unsuccessful (No BuyBox)</em> o <em>Successful (BuyBox Secured)</em>.</td><td>CSV o Excel</td></tr></tbody></table>

{% hint style="info" icon="circle-info" %}
\*Il template Basic si scarica sempre come CSV perché è pensato per essere compilato e reimportato, e l'importatore legge CSV. Le altre due modalità rispettano la tua scelta CSV / Excel.
{% endhint %}

> **Raccomandazione:** usa **Excel** quando vuoi solo leggere, ordinare o condividere i dati, e **CSV** quando il file verrà reimportato qui o alimentato in un altro strumento. Entrambi i formati contengono le stesse colonne.

***

## 📦 Bulk Import (modale separato)

Per creare molte regole in una volta, usa **Import CSV** invece di New Repricer. Questo apre un modale wizard separato con quattro schede stepper numerate:

{% stepper %}
{% step %}

### Connection

Scegli sotto quale account marketplace dovrebbero essere create le regole. Tutte le regole in una singola importazione vanno a un solo marketplace, importa separatamente se stai creando regole per DE, FR, UK, ecc.
{% endstep %}

{% step %}

### Upload

Trascina il tuo file CSV nella drop zone o fai clic per sfogliare. SellerMagnet rileva automaticamente la mappatura delle colonne se hai usato il template di Export. Un banner appare in alto se una sessione precedente è ancora ripristinabile.
{% endstep %}

{% step %}

### Validation

Il wizard analizza ogni riga e mostra una tabella di validazione con quattro filtri: **All**, più:

* **Errors:** righe che verranno rifiutate (campi obbligatori mancanti, ASIN non validi, min > max, ecc.)
* **Warnings:** righe che verranno importate ma necessitano della tua revisione (min sotto la Buy Box corrente, ecc.)
* **Valid:** righe pronte da importare

Puoi fare **Edit**, **Fetch Fees** o **Delete** su qualsiasi riga inline.
{% endstep %}

{% step %}

### Import

Schermata di conferma finale che mostra l'intervallo di profitto su tutte le righe valide, più una card **Import Settings** il cui selettore **Bulk Strategy** applica una strategia a ogni riga valida con un clic. Fai clic su **Import** per creare ogni regola in un'unica transazione.
{% endstep %}
{% endstepper %}

{% hint style="success" %}
**Imposta bene il template:** fai clic su **Export → Products & Fees** dalla toolbar del Repricer PRIMA di compilare il tuo CSV. Questo ti dà un file precompilato con ogni prodotto sincronizzato e le loro commissioni correnti. Tutto ciò che devi aggiungere è Min Price, Max Price e Strategy.
{% endhint %}

***

## ⚙️ Gestire le regole dopo la creazione

Una volta che le regole esistono, la Repricer Dashboard le mostra sotto tre schede di strategia (**All**, **Resellers**, **Brand / PL**), con un interruttore **State** e pillole Buy Box per restringere la vista. Ogni riga termina in tre pulsanti a icona - **Manage**, un **interruttore start / stop** e **Delete**. Dalla tabella principale degli articoli puoi:

<table><thead><tr><th width="220">Azione</th><th>Come</th></tr></thead><tbody><tr><td><strong>Modificare una regola</strong></td><td>Fai clic sul pulsante <strong>Manage</strong> (matita) della riga. Fare clic altrove sulla riga non fa nulla.</td></tr><tr><td><strong>Pause / Restart</strong></td><td>Fai clic sul pulsante <strong>interruttore start / stop</strong> della riga, oppure usa l'interruttore Active dentro il modale di modifica.</td></tr><tr><td><strong>Eliminare una regola</strong></td><td>Fai clic sul pulsante <strong>Delete</strong> della riga. Prompt di conferma.</td></tr><tr><td><strong>Azione in blocco</strong></td><td>Seleziona le righe con le caselle, poi usa la toolbar in blocco (<strong>Start</strong>, <strong>Stop</strong>, <strong>Delete</strong>, <strong>Deselect All</strong>) che appare sopra la tabella. Export è un pulsante d'intestazione, non parte della toolbar in blocco.</td></tr><tr><td><strong>Cerca</strong></td><td>La barra di ricerca filtra per SKU, ASIN o titolo prodotto in tempo reale.</td></tr></tbody></table>

### Le schede di stato spiegate

La dashboard suddivide le tue regole in tre modi, così puoi vedere a colpo d'occhio quali prodotti stanno vincendo la Buy Box e quali no:

<table><thead><tr><th width="240">Controllo</th><th>Cosa fa</th></tr></thead><tbody><tr><td><strong>Schede di strategia</strong></td><td><strong>All</strong>, <strong>Resellers</strong> (regole che competono per la Buy Box su listing condivisi) e <strong>Brand / PL</strong> (strategie da brand owner come Brand Guard / Competitor ASIN Sync, raggruppate separatamente perché non competono per la Buy Box allo stesso modo). Ogni scheda porta un conteggio live.</td></tr><tr><td><strong>Interruttore State</strong></td><td><strong>Active</strong> / <strong>Inactive</strong> - se la regola è in esecuzione o disattivata, indipendentemente dalla scheda.</td></tr><tr><td><strong>Pillole Buy Box</strong></td><td><strong>Won</strong> (detiene attualmente la Buy Box), <strong>No BuyBox</strong> (attiva ma non vincente - un concorrente o Amazon la detiene, la box è soppressa, la regola è trattenuta da una soglia, o un motivo non di prezzo ti tiene fuori), <strong>Attention</strong> (uno stato bloccante o stantio) e <strong>Brand/PL</strong>. Ogni pillola porta un conteggio live.</td></tr></tbody></table>

{% hint style="info" icon="circle-info" %}
**Cosa significa davvero "Won".** Una regola mostra lo stato **Won** solo quando la decisione più recente del motore ti ha lasciato a detenere la Buy Box - lo stesso insieme di stati vincenti che usa la scheda **BuyBox Win Rate**, così i conteggi e le righe concordano sempre. Tutto il resto che è attivo ma non vincente si trova sotto **No BuyBox**, anche le righe che in precedenza detenevano la box. Passa sopra qualsiasi badge di stato per una spiegazione in linguaggio semplice del perché la regola è in quello stato.
{% endhint %}

> **Perché è importante:** la suddivisione è la tua vista di triage quotidiana. Lavora prima la pillola **No BuyBox** (o fai clic sulla scheda **Not Winning BuyBox**), poi apri il **Diagnosis Panel** per vedere se sei battuto sul prezzo (correggibile, abbassa la soglia minima o regola la strategia) o per un motivo non di prezzo come la velocità di spedizione o la valutazione del venditore (abbassare il prezzo non riconquisterà la box). Vedi [Repricer Overview](/it-sellermagnet-guida/strumenti-di-vendita/repricer-overview.md#repricer-dashboard) per le schede e le ragioni di diagnosi.

***

## 🚫 Quando la Buy Box è soppressa

Amazon occasionalmente mostra **nessuna Buy Box** su un listing ("See All Buying Options"), di solito perché il prezzo in evidenza è sopra il prezzo che Amazon si aspetta. Quando questo accade su una regola che stai modificando, il campo **Buy Box** nel modale mostra **N/A** con un tag rosso **Suppressed** e un banner di avviso - *"BuyBox suppressed - Amazon is not showing a BuyBox for this listing"* - accanto a un link **Learn more** all'articolo di aiuto di Amazon.

Se la regola usa la strategia **BuyBox**, puoi dire al repricer come reagire (mantieni, abbassa il prezzo di un passo, pareggia l'offerta più bassa, o vai al tuo minimo) - vedi [Handling a suppressed Buy Box](/it-sellermagnet-guida/strumenti-di-vendita/repricer-overview/reseller-strategies.md#gestire-una-buy-box-soppressa) nella pagina Reseller Strategies. Il risultato appare poi in **Recent Activity** come uno di:

| Stato                     | Significato                                                                                                        |
| ------------------------- | ------------------------------------------------------------------------------------------------------------------ |
| **BuyBox Suppressed**     | Nessuna Buy Box è mostrata; la regola mantiene e riporta lo stato (o attende di agire).                            |
| **Suppressed Price Step** | Il repricer ha abbassato il tuo prezzo di un passo per provare a riportare la Buy Box.                             |
| **Suppressed at Min**     | La Buy Box è ancora soppressa ma il tuo prezzo è già al minimo, quindi non viene fatta alcuna ulteriore riduzione. |

***

## 🧮 Esempio pratico: creare un Repricer

Ecco un passaggio completo attraverso il modale per un prodotto FBA, che mostra come le tre schede di configurazione alimentano la Live Preview. Tutte le cifre sono illustrative, usa i tuoi costi.

**Prodotto:** un accessorio da cucina su Amazon.de, evaso da FBA, attualmente fuori dalla Buy Box.

### 1. Scheda Strategy Configuration

| Campo           | Valore                                 |
| --------------- | -------------------------------------- |
| **Strategy**    | BuyBox (competi per la Buy Box)        |
| **Active**      | On                                     |
| **Expiry Date** | (lasciato vuoto, gira indefinitamente) |

### 2. Scheda Cost Basis

| Campo                  | Valore  | Nota                                              |
| ---------------------- | ------- | ------------------------------------------------- |
| **Purchase Price**     | € 18,00 | Costo unitario dal fornitore                      |
| **Shipping Cost**      | € 2,50  | Per unità in entrata verso FBA                    |
| **Miscellaneous Cost** | € 0,50  | Imballaggio / etichette                           |
| **VAT %**              | 19%     | Standard del marketplace DE                       |
| **Fee %**              | 15%     | Estratto con **Fetch** (referral per questo ASIN) |

Costo del venduto atterrato (COGS) = 18,00 + 2,50 + 0,50 = **€ 21,00** per unità. Il pulsante **Fetch** alimenta anche la commissione di fulfillment FBA (circa **€ 3,10** qui) nella ripartizione del profitto.

### 3. Scheda Pricing Rules

| Campo                        | Valore                        |
| ---------------------------- | ----------------------------- |
| **Margin Calculation Basis** | Based on Sale Price (Default) |
| **Min Margin**               | 8%                            |
| **Max Margin**               | 30%                           |
| **Minimum Price**            | € 35,00 (guardrail statico)   |
| **Maximum Price**            | (lasciato vuoto)              |

Con questi input la Live Preview risolve ogni soglia rispetto a COGS, IVA, referral e commissioni FBA:

* **Min Margin 8%** produce una soglia minima calcolata di circa **€ 39,50** (profitto ≈ € 3,16). Poiché è più alta del **Minimum Price** statico di € 35,00, il motore usa **€ 39,50** come soglia minima effettiva, i margini hanno priorità sui prezzi statici.
* **Max Margin 30%** produce una soglia massima di circa **€ 61,75** (profitto ≈ € 18,53).

### 4. Risultato della Live Preview

La Buy Box è attualmente detenuta da un concorrente a **€ 44,90**. La strategia BuyBox propone un prezzo appena sotto, **€ 44,89**, che si colloca comodamente dentro la banda € 39,50 - € 61,75:

| Riga                    | Importo      |
| ----------------------- | ------------ |
| Nuovo prezzo            | € 44,89      |
| meno IVA (19%)          | - € 7,17     |
| meno Referral fee (15%) | - € 6,73     |
| meno FBA fulfillment    | - € 3,10     |
| meno COGS (atterrato)   | - € 21,00    |
| **Profitto**            | **≈ € 6,89** |
| **Margine**             | **≈ 15,3%**  |

Nessun banner di avviso rosso appare: il prezzo proposto è sopra la soglia minima, sotto la soglia massima e prende la Buy Box. Fai clic su **Create Repricer**, e poiché **Active** è On la regola mostra la pillola **Won** della Buy Box una volta che il motore conferma la vittoria.

***

<details>

<summary><strong>⚠️ Common Mistakes to Avoid</strong></summary>

| Errore                                                         | Perché fa male                                                                                                                                 |
| -------------------------------------------------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------- |
| Impostare il Minimum Price sotto il break-even                 | Il motore può legalmente vendere in perdita per inseguire la Buy Box; la tua soglia minima deve stare sopra COGS atterrato + IVA + commissioni |
| Min e Max compressi troppo stretti                             | Il motore ha quasi nessuno spazio per muoversi, quindi non può né ribassare i concorrenti né salire quando la box non è contesa                |
| Base di costo sbagliata (digitare Fee % invece di usare Fetch) | Le commissioni referral variano dell'8-15% per categoria; un'aliquota stimata rende sbagliata ogni cifra di profitto e margine                 |
| Dimenticare i COGS / lasciare Purchase Price vuoto             | Il profitto della Live Preview è privo di significato e Min Margin fissa la soglia al prezzo sbagliato                                         |
| Capovolgere Margin Calculation Basis senza ricontrollare       | Lo stesso 8% / 30% significa prezzi diversi su Sale Price vs COGs, spostando silenziosamente la tua soglia minima e massima                    |
| Creare la regola ma lasciare Active off                        | La regola si trova solo sotto **State: Inactive** e non riprezza mai; nulla cambia sul tuo listing                                             |

</details>

## ✅ Buone pratiche

1. **Fai sempre clic su Fetch per Fee %.** Estrai l'aliquota referral live e la commissione di fulfillment FBA per l'ASIN esatto prima di fidarti di qualsiasi cifra di profitto, non digitare mai una stima.
2. **Imposta il tuo Minimum Price sopra il break-even, non ad esso.** Aggiungi un piccolo cuscinetto sopra COGS atterrato + IVA + commissioni così un cambio di commissione o un'oscillazione FX non può spingerti in perdita.
3. **Dai spazio alla banda per lavorare.** Lascia uno scarto significativo tra la tua soglia minima e massima così il motore può ribassare i concorrenti e comunque salire quando la Buy Box non è contesa.
4. **Simula prima di salvare.** Esegui lo scenario worst-case della [Simulazione](#simulazione-prova-a-vuoto); se arriva già alla tua soglia minima con un margine sottile o negativo, correggi prima la soglia o i costi.
5. **Conferma che la regola sia Active dopo la creazione.** Controlla che appaia con il filtro **State** impostato su **Active**, poi verifica il suo stato nei prossimi cicli.
6. **Mantieni i costi sincronizzati.** Quando richiesto, salva il prezzo d'acquisto sul prodotto come COGS così la scheda Products e le analytics di profitto corrispondono al repricer.

***

## ❓ FAQ

<details>

<summary><strong>Perché il menu a discesa dei prodotti non mostra il mio nuovo ASIN?</strong></summary>

Il menu a discesa è costruito dai tuoi **prodotti Amazon Active** all'ultima sincronizzazione. Se hai aggiunto di recente un listing in Seller Central, attendi 10-15 minuti per il prossimo ciclo di sincronizzazione. Se ancora non appare, verifica che lo stato del listing sia `Active` (non `Incomplete` o `Suppressed`) in Seller Central.

</details>

<details>

<summary><strong>Qual è la differenza tra Min Margin e Minimum Price?</strong></summary>

**Min Margin** è dinamico : fluttua in base al tuo costo + commissioni. **Minimum Price** è un valore statico che inserisci direttamente. Il motore usa sempre **quello che produce la soglia più alta**, così i margini ti proteggono quando le commissioni s'impennano e il prezzo statico ti protegge quando i costi scendono.

</details>

<details>

<summary><strong>Posso recuperare le commissioni Amazon per tutte le mie regole in una volta?</strong></summary>

Sì, usa l'azione in blocco **Fetch Fees** della schermata di validazione del Bulk Import. Chiama l'API di anteprima commissioni di Amazon per ogni riga valida e popola la colonna Fee %. Molto più veloce che aprire ogni regola singolarmente.

</details>

<details>

<summary><strong>Cosa succede se elimino una regola, il prezzo del mio listing torna indietro?</strong></summary>

No. Eliminare una regola del repricer interrompe gli ulteriori aggiornamenti automatici ma **non cambia il prezzo corrente del listing**. Il prezzo resta dove il motore l'ha impostato l'ultima volta. Se vuoi tornare indietro, aggiorna il prezzo manualmente in Seller Central o negli strumenti gemelli del Repricer.

</details>

<details>

<summary><strong>Una singola regola può coprire più marketplace?</strong></summary>

No, una regola = un listing su un marketplace. Se vendi lo stesso prodotto su DE/FR/IT, crea tre regole separate. Il Bulk Import è il modo più facile per farlo.

</details>

<details>

<summary><strong>Perché il mio pulsante Create è disabilitato?</strong></summary>

Almeno un campo obbligatorio è vuoto o non valido. Il modulo evidenzia i campi problematici in rosso. La causa più comune è Strategy non selezionata, Purchase Price vuoto, o Min Margin / Max Margin / Minimum Price mancante.

</details>

***

## ➡️ What's Next?

{% content-ref url="/pages/9fOg3ic30PGkLx7kWAEh" %}
[Importazione ed esportazione in blocco](/it-sellermagnet-guida/strumenti-di-vendita/repricer-overview/bulk-import-export.md)
{% endcontent-ref %}

{% content-ref url="/pages/O1t1Fm81v7nJvB2QHgdW" %}
[Panoramica delle Strategie di Repricing](/it-sellermagnet-guida/strumenti-di-vendita/repricer-overview/repricing-strategies-overview.md)
{% endcontent-ref %}