- Listino Prezzi Ficoo Pro
- Indice
- Come funziona
- Prerequisiti
- Configurazione passo per passo
- Opzioni disponibili
- Verificare la corrispondenza prodotti
- Prezzi netti e lordi
- Domande frequenti
- Il cliente vede ancora il prezzo originale del prodotto. Cosa è andato storto?
- Ho aggiornato i prezzi su Fatture in Cloud. Quando vengono aggiornati su WooCommerce?
- Posso assegnare lo stesso listino a più utenti?
- I prezzi del listino vengono mostrati anche nelle email di WooCommerce?
- Cosa succede se un prodotto ha prezzo 0 nel listino?
- Il pulsante "Scarica listini" non fa nulla o mostra un errore.
Listino Prezzi Ficoo Pro #
La funzionalità Listino Prezzi di Ficoo Pro permette di importare i listini prezzi da Fatture in Cloud e di applicarli automaticamente ai prodotti WooCommerce per singoli utenti registrati. In questo modo ogni cliente può vedere prezzi personalizzati nel negozio, nel carrello e al checkout, senza dover modificare manualmente i prezzi dei prodotti.
Come funziona #
Il sistema lavora in tre passaggi distinti:
- Sincronizzazione — Ficoo scarica i listini prezzi dal tuo account Fatture in Cloud e li salva nel database WordPress.
- Abbinamento — Ogni prodotto WooCommerce viene abbinato al corrispondente prodotto su Fatture in Cloud tramite un identificativo univoco (FIC ID). Senza abbinamento il listino non può essere applicato.
- Applicazione — Quando un utente loggato con un listino assegnato visita il negozio, Ficoo sostituisce automaticamente il prezzo WooCommerce con il prezzo del listino.
[Screenshot: diagramma del flusso — FIC → listino → utente → prezzo nel negozio]
Prerequisiti #
- Ficoo Pro installato e attivato
- Connessione API con Fatture in Cloud configurata e funzionante (verifica in Ficoo → Impostazioni)
- Almeno un listino prezzi di tipo Vendita presente in Fatture in Cloud
- I prodotti WooCommerce devono avere un SKU corrispondente ai codici prodotto su Fatture in Cloud (per l’abbinamento automatico) oppure devono essere abbinati manualmente
Configurazione passo per passo #
1. Importare i listini da Fatture in Cloud #
Vai su Ficoo Pro → Listino Prezzi. La prima cosa da fare è scaricare i listini dal tuo account FIC.
- Clicca il pulsante Scarica listini prezzi.
- Ficoo si connetterà all’API di Fatture in Cloud, recupererà tutti i listini disponibili e salverà i prezzi nel database locale.
- Al termine compare un messaggio di conferma con il numero di listini aggiornati.
[Screenshot: pulsante “Scarica listini prezzi” con messaggio di conferma]
Nella tabella dei listini sono visibili:
| Colonna | Significato |
|---|---|
| Nome | Nome del listino come appare su Fatture in Cloud |
| Tipo | Sell (vendita) o Buy (acquisto). Solo i listini di vendita vengono usati per i prezzi WooCommerce. |
| Prezzi | Se il listino contiene prezzi netti o lordi su FIC |
| Prodotti inclusi | Numero di prodotti con un prezzo maggiore di zero nel listino |
| Prodotti esclusi | Numero di prodotti con prezzo uguale a zero (non verranno sovrascritti) |
2. Collegare i prodotti WooCommerce ai prodotti FIC #
Affinché Ficoo sappia quale prezzo del listino applicare a ciascun prodotto WooCommerce, ogni prodotto deve essere collegato al corrispondente prodotto su Fatture in Cloud. Questo collegamento viene fatto tramite il FIC ID — un identificativo numerico assegnato da Fatture in Cloud.
Vai sulla scheda Prodotti all’interno della sezione Listino Prezzi (o tramite Ficoo Pro → Magazzino).
Abbinamento automatico per SKU #
Se il codice prodotto su Fatture in Cloud coincide con lo SKU del prodotto WooCommerce, puoi usare il pulsante Assegna nella colonna Azioni: Ficoo cercherà automaticamente il prodotto FIC con quello SKU e salverà il collegamento.
Verifica dello stato di abbinamento #
La tabella mostra per ogni prodotto:
| Simbolo | Significato |
|---|---|
| ✓ | Prodotto trovato nel listino selezionato, prezzo disponibile |
| ✗ | Prodotto ha un FIC ID ma non è presente nel listino (o il prezzo è 0) |
| — | Prodotto senza FIC ID — non è ancora stato abbinato |
[Screenshot: tabella prodotti con le tre tipologie di stato]
3. Abilitare la sovrascrittura prezzi #
Nella sezione principale della scheda Listino Prezzi, trovi le opzioni per attivare e configurare il comportamento della sovrascrittura.
- Imposta Abilita sovrascrittura listino su Sì.
- Scegli il Tipo di prezzo (vedi tabella opzioni sotto).
- Scegli a quali Tipi di prodotto applicare la sovrascrittura.
- Clicca Salva impostazioni.
[Screenshot: sezione opzioni con i tre menu a tendina]
4. Assegnare un listino agli utenti #
Nella parte inferiore della scheda Listino Prezzi trovi la tabella Assegna listino agli utenti.
- Usa il campo di ricerca per trovare un utente per nome, email o username.
- Nel menu a tendina nella colonna Listino, seleziona il listino prezzi da associare a quell’utente.
- La selezione viene salvata automaticamente.
- Per rimuovere il listino da un utente, seleziona — Nessuno —.
[Screenshot: tabella utenti con il menu a tendina per l’assegnazione del listino]
Opzioni disponibili #
| Opzione | Valori | Descrizione |
|---|---|---|
| Abilita sovrascrittura listino | Sì / No | Attiva o disattiva l’intera funzionalità. Se disabilitata, tutti gli utenti vedono i prezzi standard WooCommerce. |
| Tipo di prezzo | Prezzo normale + Prezzo scontato Solo prezzo normale Solo prezzo scontato |
Quale campo prezzo di WooCommerce viene sovrascritto con il valore del listino. |
| Applica a | Prodotti semplici + Varianti Solo prodotti semplici Solo varianti |
Quali tipologie di prodotto ricevono la sovrascrittura del prezzo. |
Verificare la corrispondenza prodotti #
La scheda Prodotti ti permette di controllare in qualsiasi momento quali prodotti WooCommerce hanno una corrispondenza nel listino scelto.
- Apri la scheda Prodotti.
- Seleziona un listino dal menu a tendina Listino prezzi.
- Usa il campo di ricerca per filtrare per nome o SKU.
- La tabella mostra per ogni prodotto: tipo, SKU, FIC ID, prezzo WooCommerce, prezzo nel listino e stato della corrispondenza.
[Screenshot: scheda Prodotti con un listino selezionato e la colonna “Stato listino” visibile]
Prezzi netti e lordi #
Il prezzo importato da Fatture in Cloud viene utilizzato così com’è, senza conversioni. Ciò che conta è la configurazione di WooCommerce:
- Se WooCommerce è impostato su prezzi comprensivi di IVA, Ficoo assumerà che il prezzo del listino sia già lordo.
- Se WooCommerce è impostato su prezzi esclusi di IVA, Ficoo assumerà che il prezzo sia netto.
Domande frequenti #
Il cliente vede ancora il prezzo originale del prodotto. Cosa è andato storto? #
Verifica questi punti nell’ordine:
- L’opzione Abilita sovrascrittura listino è impostata su Sì e le impostazioni sono state salvate?
- L’utente ha un listino assegnato nella tabella degli utenti?
- Il prodotto ha un FIC ID assegnato (colonna FIC ID nella scheda Prodotti)?
- Il FIC ID del prodotto è presente nel listino assegnato all’utente con un prezzo maggiore di zero?
- Il listino è stato scaricato di recente? I prezzi su Fatture in Cloud potrebbero essere stati aggiornati senza una nuova sincronizzazione.
Ho aggiornato i prezzi su Fatture in Cloud. Quando vengono aggiornati su WooCommerce? #
I prezzi non si aggiornano automaticamente. Devi cliccare di nuovo il pulsante Scarica listini prezzi nella scheda Listino Prezzi per importare i prezzi aggiornati.
Posso assegnare lo stesso listino a più utenti? #
Sì, non c’è nessun limite. Puoi assegnare lo stesso listino a tutti gli utenti di una categoria (ad esempio tutti i rivenditori) semplicemente selezionando lo stesso listino per ciascuno di loro.
I prezzi del listino vengono mostrati anche nelle email di WooCommerce? #
Sì, poiché la sovrascrittura avviene a livello di filtro sul prezzo del prodotto, il prezzo applicato viene usato anche durante il checkout e viene salvato nell’ordine con il valore corretto. Le email di riepilogo ordine mostrano quindi il prezzo effettivamente pagato.
Cosa succede se un prodotto ha prezzo 0 nel listino? #
I prodotti con prezzo uguale a zero nel listino non vengono sovrascritti. Ficoo ignorerà quel prodotto e manterrà il prezzo standard di WooCommerce. Questi prodotti vengono conteggiati nella colonna “Prodotti esclusi” della tabella dei listini.
Il pulsante “Scarica listini” non fa nulla o mostra un errore. #
Controlla che la connessione API con Fatture in Cloud funzioni correttamente: vai in Ficoo → Impostazioni e verifica che le credenziali siano valide e che la Company ID sia configurata. Se l’API è funzionante ma il problema persiste, controlla i log di PHP per messaggi di errore che iniziano con FicooPro PriceListService.
