Bloccato

Impostazioni.

Il tuo account, Face ID e la guida della app.

Il tuo account

—

Cambia password

Utenti

Solo le persone in questo elenco possono entrare. Aggiungi email, ruolo e sedi: l'app crea un link d'invito personale (vale 48 ore) da mandare alla persona, che sceglie la sua password. Il ruolo lo vedi solo tu.

Caricamento…

Sedi

Quali sedi tenere in contabilità e da quali partono gli ordini online.

Caricamento…

Shopify

Come l'app si collega al negozio e quali permessi ha (tutti in sola lettura).

Controllo del collegamento…

Face ID

Sblocca la app con Face ID invece della password. La chiave resta nel tuo iPhone (e nel Portachiavi iCloud): il server riceve solo una firma.

—

Backup

Ogni sera, dopo la chiusura, la app salva una copia completa della contabilità in un posto sicuro fuori dal server (GitHub). Qui puoi scaricarla o ripristinarla.

Ultimo backup automatico: —

Registro attività

Chi è entrato, quando, e le operazioni importanti (esportazioni, ricalcoli, modifiche). Si tiene per circa un anno.

Caricamento…

Guida

Tutte le funzioni, passo passo. Tocca un argomento per aprirlo.

1Primo avvioLe cose da fare una volta sola, nell'ordine.

Accedi con la password della app, poi in Impostazioni → Face ID premi Attiva su questo dispositivo: dalla volta dopo entri con Face ID.
Qui in Impostazioni → Sedi controlla gli interruttori: In contabilità acceso per i negozi da seguire, Vendite online acceso solo per le sedi da cui partono gli ordini del sito (oggi Napoli). Premi Salva.
Se hai un Excel di una sede (come Toledo per Napoli), apri Contabilità, scegli la sede e usa Importa storico. È facoltativo: senza file la sede parte da sola alla prima chiusura serale.
Scegli un giorno recente di cui conosci i numeri, aprilo nel registro e premi Verifica con Shopify: vendite e sconti devono coincidere con i tuoi.
Da quel momento la app chiude ogni giornata da sola alle 23:55.

2Stock · Report giornalieroCosa è entrato e uscito da una sede in un giorno, con i valori.

Scegli la sede e la data dal calendario.
Accendi Invia copia su Discord se vuoi il PDF anche sul canale.
Premi Genera giornaliero: trovi pezzi e valore in entrata e in uscita, e sotto l'elenco dei prodotti con i numeri dei trasferimenti.
Scarica PDF salva il report, Condividi manda il riepilogo con WhatsApp o Messaggi, Nuova ricerca pulisce la pagina.

3Stock · Report mensileI pezzi entrati e usciti da una sede in tutto il mese.

Scegli la sede e il mese, poi Genera mensile.
Il mensile conta i pezzi, non i valori: per i valori del mese usa la Contabilità.

4Stock · RiassortimentiCosa spostare dal Deposito per riempire le sedi più scariche.

Tocca le sedi di destinazione: nere sono incluse, bianche escluse.
Prodotti da analizzare: quanti prodotti attivi controllare, partendo dai più recenti (150 di solito basta).
Premi Avvia riassortimenti e segui l'avanzamento. Alla fine vedi pezzi e movimenti totali; con Scarica PDF hai la lista da preparare, sede per sede.
A parità di stock Napoli ha la precedenza.
Smart (in prova, accanto al metodo attuale): scegli Smart in alto nella scheda e la copertura in giorni (di base 7: i riassortimenti partono almeno due volte a settimana). Per ogni sede e taglia manda i pezzi che servono per quei giorni: vendite delle ultime 4 settimane × stagionalità (come andavano le stesse settimane l'anno scorso), con almeno 1 pezzo per ogni taglia dei prodotti che lì vendono. Se il Deposito non basta, i pezzi vanno prima alla sede più scoperta.
Il risultato smart mostra la stagionalità di ogni sede, il confronto con il metodo attuale (pezzi e prodotti) e, sede per sede, i prodotti con le taglie da mandare. Scarica PDF ha anche quanto vende ogni taglia al giorno.

5Contabilità · I sei riquadriIl riepilogo del mese della sede scelta.

Vendite POS: incassato in negozio con IVA, già al netto di sconti e resi. Sotto, le vendite online.
Sconti: sconti con IVA (POS + online) e la loro percentuale sulle vendite.
Trasf. in entrata (verde) e in uscita (rosso): valore a prezzo di vendita e numero di trasferimenti.
Giacenza reale: l'ultima rilevata, cioè quantità disponibile × prezzo di tutti i prodotti della sede.
Differenza: somma delle differenze del mese. Rossa se manca merce o denaro, verde se ce n'è in più. Sotto, quanti giorni superano la soglia (50 €).

6Contabilità · Il registro giorno per giornoOgni riga è un giorno, come nel tuo Excel.

La formula è la stessa del foglio: iniziale + entrata − uscita − vendite POS − online − sconti = calcolata.
L'iniziale di un giorno è la giacenza reale della sera prima (se manca, la calcolata).
A destra trovi la giacenza reale e la Δ (reale − calcolata). Se la reale non c'è vedi calc. con la sola calcolata.
prezzi ↓ / ↑ (in blu) segna le sere in cui sono cambiati dei prezzi, ad esempio l'inizio dei saldi: la giacenza reale si abbassa senza che manchi merce. Nel dettaglio trovi quanto vale il cambio e la differenza «vera» senza di esso; i giorni da verificare la ignorano già.
≠ Excel segna i giorni ricalcolati che non coincidono con il file importato: aprili per la tabella Excel / Shopify / Differenza.
Tocca un giorno per il dettaglio: tutte le voci, i trasferimenti con provenienza e pezzi, gli ordini online e le note.

7I pulsanti della ContabilitàCosa fa ognuno, e cosa non tocca.

Ricalcola giorno: rilegge da Shopify vendite, online, sconti e trasferimenti di quel giorno e li sostituisce. La giacenza reale non cambia mai, e i trasferimenti già registrati tengono il valore della prima registrazione (non vengono rivalutati ai prezzi di oggi, per esempio durante i saldi).
Ricalcola mese: lo stesso per tutti i giorni del mese (chiede conferma, circa un minuto). I numeri importati dall'Excel restano salvati per il confronto.
Verifica con Shopify: mostra i numeri grezzi di Shopify per quel giorno (lordo, sconti, resi, netto, IVA, totale). Non salva nulla: serve a capire perché un giorno non torna.
Chiudi oggi: fa subito la chiusura serale di tutte le sedi attive, leggendo la giacenza reale in questo momento.
Importa storico: carica un Excel come Toledo.xlsx sulla sede scelta. Prima ti mostra un'anteprima (giorni, date corrette, giorni già presenti) e scrive solo dopo la conferma.
Scarica Excel: il mese scelto con le colonne del tuo foglio più giacenza reale e differenza.

8La chiusura automatica seraleCome la app tiene il registro da sola.

Ogni sera un servizio esterno (cron-job.org) sveglia la app alle 23:45 e alle 23:55 avvia la chiusura.
La chiusura calcola la giornata di ogni sede attiva e salva la giacenza reale del momento: è l'unico dato che Shopify non conserva, per questo va letto ogni sera.
Ricontrolla anche il giorno prima: vendite online e trasferimenti registrati dopo la chiusura della sera precedente entrano nel giorno giusto. I giorni importati o corretti a mano non vengono toccati.
Se una sede, il backup o il report non riescono, riprova da sola dopo 5 minuti (fino a 3 tentativi, solo la parte che non è riuscita).
Se la chiusura non parte proprio, tra mezzanotte e venti e le 6 la app se ne accorge e la recupera da sola, con la giacenza reale letta in quel momento (a negozi chiusi).
Se una sera salta del tutto, la chiusura successiva recupera i giorni mancanti (fino a 31), ma quei giorni non avranno la giacenza reale.
Subito dopo, la app salva il backup completo della contabilità su GitHub.
L'esito resta salvato anche se il server si riavvia: in fondo alla Contabilità leggi l'ora dell'ultima chiusura e gli eventuali errori.
Avvisi (solo per te): se la chiusura non riesce dopo tutti i tentativi, se il backup fallisce, se Shopify toglie un permesso o se una scheda delle Analisi dà errore più volte di fila, ricevi un messaggio su Discord e vedi un riquadro rosso in cima all'app. Quando il problema si risolve arriva il «✅ Risolto» e il riquadro sparisce; «Ignora» lo toglie subito.

9SediGli interruttori qui sopra.

In contabilità: la sede compare nella Contabilità e viene chiusa ogni sera.
Vendite online: alla sede vengono attribuiti gli ordini del sito assegnati a lei. Accendilo solo dove parte merce online (non serve per il Deposito, che non è in contabilità).
Una sede nuova creata su Shopify compare qui da sola: accendila e premi Salva.

10Da dove vengono i numeriLe fonti, per sapere cosa aspettarti.

Vendite POS e sconti: i report di Shopify della sede (gli stessi delle statistiche POS). Lo sconto dei report è senza IVA: la app lo riporta con IVA.
Vendite online: ordini del sito creati quel giorno e assegnati alla sede, all'importo pagato; lo sconto online va negli sconti.
Trasferimenti: quelli creati quel giorno (esclusi gli annullati), valutati al prezzo dei prodotti nel momento in cui la app li registra la prima volta (di solito la sera stessa); quel valore poi resta fisso. I giorni importati dall'Excel, se ricalcolati per la prima volta, usano i prezzi del momento: meglio farlo prima di saldi o promozioni.
Giacenza reale: quantità disponibile × prezzo di vendita; le quantità negative contano zero.
Tutti i giorni seguono l'ora italiana, anche al cambio dell'ora legale.

11Problemi frequentiSe qualcosa non torna.

Un giorno ha una differenza grande: aprilo e premi Verifica. Spesso è un trasferimento creato un giorno e ricevuto il giorno dopo, o un ordine online spedito da un'altra sede.
Manca la giacenza reale di ieri: la chiusura serale non è partita. Controlla cron-job.org; oggi puoi premere Chiudi oggi.
Online non ricalcolato su giorni vecchi: Shopify dà gli ordini solo degli ultimi 60 giorni, salvo il permesso read_all_orders. Il valore resta quello di prima.
«Password non corretta»: rientra con la password della app.
La sede dice «Non trovata su Shopify»: su Shopify ha un nome diverso, controlla come è scritta.

★Analisi · NegoziAndamento dei negozi e confronto con l'anno scorso.

Scegli il periodo (giorno, settimana, mese, semestre, anno) e la data dal calendario: ogni numero è confrontato con lo stesso periodo dell'anno prima (per giorno e settimana, con gli stessi giorni della settimana).
Scegli Tutte le sedi o una sede sola (anche Online, cioè il sito). Toccando una sede nel Confronto sedi la analizzi da sola.
I quattro riquadri: vendite (con IVA, al netto di sconti e resi), scontrino medio, pezzi per scontrino, sconto medio. ▲ verde = meglio dell'anno scorso, ▼ rosso = peggio (per lo sconto, scendere è meglio).
Andamento: con tutte le sedi una linea per sede; con una sede sola, la sua linea e l'anno scorso tratteggiato. Passa il dito o il mouse sul grafico per i valori.
Obiettivi del mese (solo col periodo Mese): premi Imposta, scrivi l'obiettivo di ogni sede e premi Salva. La barra è il venduto, la tacca la previsione a fine mese al ritmo attuale.
Orari e giorni: più è scuro, più si vende in quel giorno e in quella fascia oraria. Tocca una casella per l'importo.
Personalizzato: scegli le due date «dal → al»; il confronto è con le stesse date dell'anno prima. Il grafico va per giorno, oltre 3 mesi per settimana, oltre un anno per mese.
La previsione degli obiettivi segue l'andamento dello stesso mese dell'anno scorso (es. a dicembre conta il picco di Natale), non una semplice proporzione.
I numeri arrivano dai report di Shopify, gli stessi delle sue statistiche. Per essere veloci, il server li prepara in anticipo e li tiene da parte: il periodo in corso si aggiorna ogni 30 minuti (la scheda Oggi ogni 2), i periodi già chiusi restano pronti per un giorno. Sotto il periodo vedi «Dati delle 14:20»: Aggiorna adesso rilegge subito da Shopify.

★Analisi · OggiCome sta andando la giornata, sede per sede.

Vendite e scontrini di oggi, confrontati con lo stesso giorno della settimana scorsa fino alla stessa ora.
Per ogni sede: vendite, scontrini, ora dell'ultima vendita e variazione. Sotto, i prodotti più venduti di oggi.
Premi Aggiorna per i numeri più recenti (si aggiornano ogni 2 minuti).

★Analisi · ProdottiCosa vende, cosa manca, cosa è fermo.

Sell-through: venduti nel periodo ÷ (venduti + giacenza di oggi), per prodotto, tipo, collezione o taglia. Con una sede scelta conta solo la giacenza di quella sede.
Curva taglie: per ogni tipo di capo, come si dividono le vendite tra le taglie rispetto ai pezzi che c'erano. «Finisce prima» = la taglia vende più di quanto ne avevate: alla prossima produzione fatene di più. Usa un periodo lungo (es. Anno).
Copertura: per quanti giorni basta la merce in sede al ritmo delle ultime 4 settimane, corretto con la stagionalità; rosso sotto i 7 giorni.
Taglie mancanti: taglie a zero in sede ma presenti in Deposito, per i prodotti che lì vendono. Il pulsante apre il riassortimento smart con quelle sedi.
Merce ferma: prodotti con stock e nessuna vendita da 30, 60 o 90 giorni (esclusi i nuovi arrivi), con il valore a prezzo di vendita e la sede dove vendevano di più.
Comprati insieme, resi (online e negozi) e clienti nuovi o di ritorno.
Il catalogo si legge da Shopify in una volta sola e resta in memoria 20 minuti: la prima apertura può richiedere un minuto.

★Analisi · EconomiaMargini, ricarico, valore del magazzino, sconti.

Margine = vendite con IVA − costo con IVA. Il costo è quello inserito in Shopify (senza IVA) × 1,22; per il venduto si usa il costo che Shopify ha registrato al momento della vendita.
Ricarico = vendite ÷ costo con IVA (comprato a 10, venduto a 30 = 3x), per sede, tipo, collezione o prodotto. I prodotti senza costo in Shopify sono esclusi e indicati sotto.
Valore del magazzino di oggi per sede, al costo con IVA e al prezzo di vendita. Excel per il commercialista scarica il riepilogo e un foglio per sede, articolo per articolo.
Sconti e codici: quanto è costato ogni codice, quante vendite ha portato e con che ricarico; sotto, tutti gli sconti per sede.
Differenze contabilità: le differenze giorno per giorno (in rosso oltre la soglia) e se si ripetono in un giorno della settimana.
Report mensile: il 1° del mese il server salva da solo il PDF del mese finito su GitHub (cartella report); dal pulsante lo scarichi quando vuoi.

★Analisi · AcquistiQuanto comprate, da chi, e quanto rende.

Legge gli ordini d'acquisto di Shopify del periodo (per data di creazione), con gli importi registrati (costo con IVA). Le bozze e gli ordini annullati non contano.
Smaltito = pezzi di quegli acquisti già venduti; ricarico = incasso di quei pezzi ÷ il loro costo; a listino = prezzo di vendita ÷ costo di tutto l'acquistato.
Il prezzo di vendita di ogni riga d'ordine si fissa la prima volta che l'app la legge: saldi e cambi prezzo successivi non lo cambiano.
Per fornitore: quota sul totale, ricarico e venduto; toccandolo vedi ordini, tipi di capo, prodotti più e meno venduti. Se più fornitori hanno fatto la stessa variante, le vendite si dividono in proporzione ai pezzi.
Serve il permesso Shopify read_inventory_purchase_orders (vedi «Collegare Shopify»).

★Collegare Shopify (nuova app)Passare dall'app legacy a quella del Dev Dashboard.

In Shopify: Impostazioni → App → Sviluppa app → Crea app nel Dev Dashboard (si apre dev.shopify.com). Crea un'app, ad esempio «Eternal Inventory».
Nella scheda Versioni crea una versione: come URL dell'app metti https://eternal-inventory.onrender.com, come URL di reindirizzamento https://eternal-inventory.onrender.com/api/shopify/callback.
Negli ambiti di accesso (Admin API) spunta solo questi, tutti in lettura: read_products, read_inventory, read_locations, read_orders, read_all_orders, read_merchant_managed_fulfillment_orders, read_inventory_transfers, read_reports, read_customers, read_returns, read_discounts, read_inventory_purchase_orders. Poi rilascia la versione.
Dalla pagina dell'app premi Installa e scegli il negozio.
In Impostazioni dell'app copia ID client e Segreto client. Su Render (Environment) aggiungi SHOPIFY_CLIENT_ID e SHOPIFY_CLIENT_SECRET; controlla che SHOPIFY_STORE sia il dominio …myshopify.com. Salva: Render riavvia il server.
Apri la app → Impostazioni → Shopify: deve dire «Nuova app · collegamento automatico» e mostrare i permessi con ✓. Il codice d'accesso dura 24 ore e il server lo rinnova da solo.
Se invece compare un errore di collegamento automatico, premi Collega Shopify: si apre Shopify, approvi e torni nella app. Funziona allo stesso modo.
Quando tutto va, puoi togliere SHOPIFY_ACCESS_TOKEN da Render e disinstallare l'app legacy. Finché le nuove variabili non ci sono, l'app continua a usare quella vecchia.
Per aggiungere un permesso in futuro: nuova versione con il permesso in più, rilascio, poi approvi l'aggiornamento nel negozio.

12Backup e ripristinoCome non perdere mai i dati, anche se il server chiude.

I movimenti si possono sempre rileggere da Shopify; i dati che esistono solo nella app sono le giacenze reali, lo storico importato e le impostazioni delle sedi. Il backup li contiene tutti.
Automatico: ogni sera dopo la chiusura la app salva il file backup_contabilita_data.json nel tuo repository privato su GitHub (cartella backup/anno/mese), e su Discord arriva un messaggio di conferma. GitHub conserva tutte le versioni: puoi recuperare il backup di qualsiasi sera.
Scarica backup: lo stesso file, sul telefono o sul computer. Fallo ogni tanto e mettilo su iCloud o Drive.
Excel completo: tutte le sedi, un foglio per sede, con tutti i giorni registrati.
Salva backup ora: salva subito un backup, senza aspettare la sera.
Ripristina…: scarica il file da GitHub (apri il file → pulsante Download raw) e sceglilo qui; vedi un'anteprima (data, giorni, sedi) e solo dopo la conferma la app riscrive i dati. I giorni nel backup sostituiscono quelli attuali, gli altri restano.
Se il server o il database spariscono: crea un nuovo database (Neon), pubblica di nuovo la app da GitHub con le stesse variabili, accedi e usa Ripristina con l'ultimo backup su GitHub. Perdi al massimo la giornata in corso.

13Accesso e sicurezzaFace ID, password e blocco dei tentativi.

Entrare: email e password scelte dal link d'invito. Se l'hai dimenticata, chiedi all'amministratore un nuovo invito.
Face ID: dopo il primo accesso vai in Impostazioni → Face ID e premi Attiva su questo dispositivo. Dalla volta dopo all'apertura compare subito Face ID; puoi sempre entrare anche con email e password. La chiave si sincronizza con il Portachiavi iCloud (anche sul Mac, con Touch ID).
Ogni accesso vale 12 ore o finché chiudi la app. Esci (in Il tuo account) chiude subito la sessione.
Cambia password in Il tuo account: gli altri dispositivi dovranno rientrare.
Blocco: dopo 5 tentativi sbagliati in 15 minuti, da quel dispositivo l'accesso resta bloccato per 15 minuti.
Il token di Shopify e i dati delle altre persone non arrivano mai sul telefono: il server manda solo ciò che puoi vedere.

★Utenti e permessiChi può entrare e cosa può fare (lo vedi solo tu).

Aggiungere una persona: Impostazioni → Utenti → Aggiungi utente. Scrivi email e nome, scegli il ruolo e le sedi, premi Salva e crea invito. Copia o condividi il link (vale 48 ore, si usa una volta) e mandalo alla persona: lo apre, sceglie la password ed entra.
Ruoli (modelli di partenza): Commesso = Oggi e Negozi delle sue sedi, report giornaliero e mensile; Responsabile = in più Prodotti, riassortimenti e contabilità in sola lettura delle sue sedi; Socio = tutto, comprese Economia e Acquisti, su tutte le sedi; Amministratore = tutto più utenti, backup, sedi, Shopify e registro.
Puoi cambiare i singoli permessi di una persona con gli interruttori. Gli utenti non vedono il proprio ruolo: vedono solo le sezioni che possono usare.
Solo tu (amministratore) puoi fare ciò che sovrascrive i dati: Ricalcola giorno, Ricalcola mese, Importa storico, Chiudi oggi, ripristino del backup, sedi e utenti.
Reimposta accesso: nuovo link d'invito; la vecchia password, i Face ID e le sessioni della persona smettono subito di funzionare. Disattiva: la persona esce subito da tutti i dispositivi e non può più entrare (lo storico resta). Elimina: la toglie dall'elenco.
Registro attività: accessi, tentativi sbagliati, esportazioni, ricalcoli e modifiche, con data, persona e indirizzo.
Accesso di emergenza: se perdi il tuo accesso, nella schermata di accesso lascia vuota l'email e scrivi la password di emergenza (APP_PASSWORD su Render). Dà pieno accesso; se la cambi su Render, le sessioni di emergenza aperte si chiudono.
Dopo un ripristino da backup gli utenti tornano, ma senza password: manda a ognuno un nuovo invito.

Magazzino.

Report giornaliero

Report mensile

Riassortimenti

Riepilogo.

Entrate

Uscite

Contabilità.

Analisi.

Confronto sedi

Andamento

Obiettivi del mese

Orari e giorni

Impostazioni.

Il tuo account

Utenti

Sedi

Shopify

Face ID

Backup

Registro attività

Guida

Accesso.

Benvenuto.

Il tuo account.

Magazzino.

Report giornaliero

Report mensile

Riassortimenti

Riepilogo.

Entrate

Uscite

Contabilità.

Analisi.

Confronto sedi

Andamento

Obiettivi del mese

Orari e giorni

Impostazioni.

Il tuo account

Utenti

Sedi

Shopify

Face ID

Backup

Registro attività

Guida