# Manuale utente — Stock Transfer Pro (IT)

## 1) Panoramica
Stock Transfer Pro aiuta a gestire le scorte su piu sedi Shopify:
- creazione e tracciamento dei trasferimenti,
- suggerimenti di riassortimento e smart transfers,
- obiettivi di stock per sede,
- previsioni per prevenire rotture di stock,
- modulo **Acquisti** (piano Pro): fornitori, ordini d'acquisto, inventari fisici e COGS ponderato.

## 2) Prerequisiti
- Un negozio Shopify con permessi admin necessari.
- App Stock Transfer Pro installata.
- Sedi Shopify configurate correttamente.
- Per gli Acquisti: piano **Pro** o **Pro+** attivo (salvo accesso partner).

## 3) Avvio rapido
1. Aprire l'app da Shopify Admin.
2. Controllare la pagina **Dashboard**.
3. Andare su **Transfers** per creare il primo trasferimento.
4. Se necessario, scegliere un piano in **Abbonamento** (Pro per acquisti).
5. Configurare lingua e opzioni in **Impostazioni**.
6. (Piano Pro) Configurare **Fornitori**, poi creare un **Ordine d'acquisto** o un **Inventario**.

## 4) Navigazione nell'app
- **Dashboard**: panoramica (trasferimenti, ordini in bozza) e avvisi di ricezione in sospeso.
- **Transfers**: creazione, invio, ricezione e storico trasferimenti.
- **Smart Transfers**: suggerimenti automatici (piano Pro).
- **Stock Targets**: obiettivi di stock per prodotto/sede (piano Pro).
- **POS Receive**: conferma ricezione in negozio tramite estensione Shopify POS.
- **Stock Insights**: previsioni e analisi (in base al piano).
- **Pianificazione acquisti** (piano Pro): suggerimenti di riassortimento.
- **Fornitori** (piano Pro): anagrafica fornitori, prodotti associati e costi unitari.
- **Ordini d'acquisto** (piano Pro): creare, inviare, ricevere e tracciare il pagamento.
- **Inventari** (piano Pro): conteggi fisici per sede.
- **Abbonamento**: gestione piano Starter / Pro / Pro+ (nascosto per alcuni negozi partner).
- **Impostazioni**: lingua, parametri previsioni, IA, download manuale PDF.
- **Contatto**: apre il client di posta per il supporto.

## 5) Flusso principale: creare un trasferimento
1. Aprire **Transfers**, poi **Nuovo trasferimento**.
2. Selezionare sede origine e sede destinazione.
3. Aggiungere prodotti/varianti (ricerca o **campo scan** per lettore barcode).
4. Verificare le quantita.
5. Confermare invio.
6. Confermare ricezione in **POS Receive** (Shopify POS) o dall'admin.

Buone pratiche:
- Preferire cicli regolari rispetto a trasferimenti solo urgenti.
- Verificare disponibilita in origine prima della conferma.
- Usare i suggerimenti smart come supporto decisionale.

## 6) Smart Transfers
Obiettivo: proporre quantita piu pertinenti in base a:
- vendite recenti,
- stock disponibile,
- stagionalita e anticipazione lead time,
- stock di sicurezza.

Suggerimento: adattare sempre le proposte al contesto locale.

## 7) Stock Targets
In **Stock Targets** puoi impostare livelli minimi/ideali per prodotto e sede.

Uso consigliato:
1. Definire target realistici per SKU critici.
2. Rivedere i target ogni mese (o stagione).
3. Incrociare con le previsioni.

## 8) Stock Insights
**Stock Insights** aiuta a:
- vedere trend di domanda,
- individuare rischi di rottura stock,
- preparare trasferimenti in anticipo.

Per risultati migliori:
- impostare un **lead time** realistico,
- mantenere uno **stock di sicurezza** coerente,
- verificare qualita dei dati storici di vendita.

## 9) Piani e limiti
- **Starter**: trasferimenti manuali, estensione POS, UI multilingue (1-2 sedi).
- **Pro**: tutto Starter + stock target, smart transfers, previsioni 30 gg, **modulo Acquisti** (fornitori, ordini, inventari, COGS ponderato).
- **Pro+**: tutto Pro + previsioni multi-orizzonte, alert avanzati, IA BYOK, Revenue-at-Risk dettagliato.

Regola importante:
- Con piu di 3 sedi attive, il piano **Pro+** e obbligatorio.

Accesso partner:
- Alcuni negozi hanno accesso completo senza tab **Abbonamento**.

Cambio piano:
- Upgrade/downgrade da **Abbonamento**.
- Prova gratuita di 14 giorni sull'abbonamento Shopify.

## 10) Impostazioni
In **Impostazioni** puoi:
- cambiare lingua (FR/EN/DE/IT/ES),
- regolare lead time e stock di sicurezza,
- attivare/disattivare IA e scegliere provider/modello (Pro+),
- scaricare il **manuale utente** in PDF,
- verificare gli scope API attivi.

## 11) Scansione e ricezione in negozio

### Scan alla creazione trasferimento (admin)
Su **Nuovo trasferimento**, il **campo scan** accetta codici a barre tramite **lettore hardware** (USB/Bluetooth). Mettere il focus nel campo, scansionare, confermare.

### Modalita scan trasferimento (admin)
Route dedicata per ricevere per scansione:
- **Lettore hardware**: campo attivo, scan + Invio incrementa la quantita ricevuta.
- **Fotocamera**: pulsante **Attiva fotocamera** per scansionare dal browser (anteprima, non a schermo intero).

### Ricezione POS (Shopify POS)
L'estensione **Stock Transfer Pro** in **Shopify POS** permette di:
- elencare i trasferimenti in attesa alla sede collegata,
- scansionare con **fotocamera nativa** (mirino a schermo intero) o lettore,
- validare le quantita ricevute riga per riga.

Ideale per la ricezione in negozio su tablet o smartphone.

## 12) Contatto e supporto
- Pulsante **Contatto** in barra app, pagina Abbonamento e Impostazioni.
- Apre il client di posta con indirizzo di supporto e oggetto precompilato.

## 13) Risoluzione problemi (FAQ)
**Non vedo alcune pagine (es. Stock Insights, Acquisti).**  
Verificare il piano attivo in **Abbonamento**. Gli Acquisti richiedono almeno **Pro**.

**Vengo reindirizzato ad Abbonamento.**  
Controllare stato billing e compatibilita piano/sedi.

**Non ho il tab Abbonamento.**  
Il negozio puo avere accesso partner. Ricaricare l'app dopo l'installazione.

**I suggerimenti sono troppo bassi/alti.**  
Regolare lead time, stock di sicurezza e stock target.

**Il pulsante Contatto non apre l'email.**  
Controllare il client email predefinito.

**Non vedo Ordini d'acquisto / Fornitori / Inventari.**  
Passare a **Pro** o **Pro+** in **Abbonamento**.

**Modifica bozza non risponde.**  
Ricaricare la pagina. Solo ordini in stato **Bozza** sono modificabili.

**La ricezione dell'ordine non aggiorna lo stock.**  
Verificare che l'inventario sia tracciato nella sede scelta.

**Il mio inventario mostra 0 articoli.**  
Verificare l'**ambito** alla creazione: scegliere **Tutti i prodotti**.

**Il costo Shopify non cambia dopo la ricezione.**  
Attivare **Aggiorna costo prodotto Shopify alla ricezione** sulla scheda ordine.

**La fotocamera non funziona su mobile (admin).**  
Consentire l'accesso alla fotocamera nel browser. Per l'uso in negozio, usare **Shopify POS**.

## 14) Checklist operativa
- Controllare ogni giorno i trasferimenti in sospeso.
- Confermare rapidamente le ricezioni (POS o admin).
- Rivedere previsioni ogni settimana (Pro+).
- Aggiornare target e stock sicurezza ogni mese.
- Ricontrollare il piano quando aggiungi nuove sedi.
- Mantenere aggiornati **Fornitori** e costi unitari.
- Finalizzare o annullare ordini in bozza.
- Ricevere ordini in attesa e tracciare il **pagamento**.

## 15) Modulo Acquisti (piano Pro)

> **Accesso:** **Pianificazione acquisti**, **Fornitori**, **Ordini d'acquisto** e **Inventari** sono disponibili con il piano **Pro** o **Pro+**. La ricezione aggiorna lo stock e, opzionalmente, il **COGS ponderato** in Shopify.

### Dashboard arricchita
La **Dashboard** mostra:
- contatori trasferimenti (totale, bozza, inviati, ricevuti);
- **Ordini d'acquisto in bozza**;
- avviso se **trasferimenti** attendono ricezione;
- avviso se **ordini d'acquisto** (Ordinato o Ricevuto parzialmente) attendono ricezione.

### Fornitori
1. Aprire **Fornitori**.
2. Creare un fornitore (nome, e-mail, dettagli).
3. **Associare prodotti** con **costo unitario** per variante.
4. Questi costi alimentano ordini e calcolo COGS alla ricezione.

### Pianificazione acquisti
Pagina di **suggerimenti di riassortimento** basati su stock e domanda.

### Creare un ordine d'acquisto
1. Aprire **Ordini d'acquisto** e creare un nuovo ordine.
2. Scegliere **sede**, **fornitore** e campi opzionali.
3. **Cercare prodotti** in tempo reale; varianti gia aggiunte sono nascoste.
4. Regolare **quantita ordinate** e **costo unitario** per riga.
5. Confermare: stato **Bozza**.

### Modificare una bozza
1. Aprire l'ordine, cliccare **Modifica bozza**.
2. Aggiornare fornitore, sede, righe, costi, date o note.
3. **Salva bozza**.

Solo le **Bozze** sono modificabili.

### Inviare al fornitore
1. Sezione **Invia al fornitore**.
2. Verificare o inserire l'e-mail del fornitore.
3. Opzione: **Copia a me**.
4. Inviare: e-mail con PDF; stato **Ordinato**.

Lo stato **Ordinato** si imposta solo dopo l'invio riuscito.

### Tracciamento pagamento
Su ordini **Ordinato**, **Ricevuto parzialmente** o **Ricevuto**:
- impostare **stato pagamento** (non pagato, parziale, pagato),
- registrare importi e date di pagamento.

### Scaricare il PDF
**Scarica PDF** sulla scheda ordine.

### Ricevere un ordine
Con stato **Ordinato** o **Ricevuto parzialmente**:
1. Sezione **Ricezione**: quantita per riga o **Ricevi tutto**.
2. Opzionale: **costi di spedizione** e **aggiustamenti**.
3. Attivare **Aggiorna costo prodotto Shopify alla ricezione** per COGS ponderato.
4. Confermare ricezione.

Effetti:
- lo stock aumenta nella sede;
- **costo medio ponderato** ricalcolato;
- storico COGS sulla scheda;
- stato **Ricevuto** o **Ricevuto parzialmente**.

### Lista e filtri
- Elenco con stato, fornitore, sede, pagamento e numero righe.
- Filtri e ordinamento per stato, data, fornitore.
- Link dashboard **Vedi ordini in sospeso**.

### Stati ordine d'acquisto
- **Bozza**: in preparazione, modificabile.
- **Ordinato**: inviato al fornitore.
- **Ricevuto parzialmente**: ricezione parziale.
- **Ricevuto**: ricezione completa.
- **Annullato**: annullato.

### Inventari fisici
1. Aprire **Inventari**, creare nuovo inventario.
2. Scegliere **sede** e **ambito** (**Tutti i prodotti** consigliato).
3. Articoli tracciati caricati da Shopify.
4. Inserire **quantita contate** per riga.
5. **Salva conteggi**, poi **Applica aggiustamenti**.

Stati: **Bozza** → **Conteggio** → **Applicato** (o **Annullato**).

Suggerimento: se l'inventario mostra 0 articoli, ricrearlo con ambito **Tutti i prodotti**.