CGFA CONNETTORE RIVENDITORI — versione 1.0.0
Per negozi WordPress + WooCommerce (WordPress 6.0+, WooCommerce 7.0+, PHP 7.4+)

COSA FA
Collega il tuo negozio al magazzino Citygraph.it o CityShirt.it:
- importa i prodotti con foto, descrizioni, colori e taglie;
- mette i prezzi di vendita partendo dal tuo prezzo rivenditore (con il ricarico che scegli tu)
  oppure dal prezzo al pubblico consigliato;
- aggiorna da solo il catalogo ogni ora e le disponibilità ogni 15 minuti;
- rispetta le quantità minime del magazzino (es. gadget da 100 pezzi);
- se un prodotto esce dal magazzino lo mette in bozza, quando rientra lo ripubblica.

INSTALLAZIONE (5 minuti)
1. WordPress → Plugin → Aggiungi nuovo → Carica plugin → scegli cgfa-connettore-rivenditori.zip → Installa → Attiva.
2. WooCommerce → Connettore rivenditori.
3. Scegli il magazzino, incolla la CHIAVE API ricevuta via email, imposta ricarico, IVA e foto → Salva.
4. Premi "Prova collegamento": deve dire "Collegamento riuscito".
5. Premi "Sincronizza ora". Il catalogo arriva un pezzo al minuto in sottofondo (si può chiudere la pagina).

CONSIGLI
- La prima sincronizzazione con le foto può richiedere da qualche minuto a un'ora, secondo il numero di prodotti.
- Se il sito ha poco traffico, WP-Cron parte solo quando qualcuno visita il sito: chiedi al tuo hosting un cron
  reale ogni 5 minuti su https://TUOSITO/wp-cron.php?doing_wp_cron
- Se modifichi a mano nomi e descrizioni, lascia spenta "riscrivi nome e descrizione": prezzi, disponibilità e foto
  continuano ad aggiornarsi.
- Ordini: quando vendi, ordini a tua volta al magazzino al prezzo rivenditore (account rivenditore sul sito
  del magazzino). Stampa e spedizione ai tuoi clienti le gestisci come concordato nel programma.

SITO NON WOOCOMMERCE?
Usa direttamente l'API (documentazione: https://www.citygraph.it/diventa-rivenditore/api oppure
https://www.cityshirt.it/diventa-rivenditore/api/) o il feed CSV, importabile da quasi tutti i gestionali e
dai plugin di importazione (es. WP All Import, Shopify Matrixify, PrestaShop import CSV):
  https://www.citygraph.it/api/rivenditori/v1/feed.csv?chiave=LA_TUA_CHIAVE
Esempio in PHP puro: file esempio-api.php in questa cartella.

CONDIZIONI D'USO
Foto e dati si possono usare solo per vendere i prodotti del magazzino e solo finché il programma rivenditori
è attivo. Vietato cederli o rivenderli a terzi. La chiave è personale: se pensi che qualcuno l'abbia vista,
chiedi di sostituirla.

ASSISTENZA
Citygraph — WhatsApp 339 2896941 — www.citygraph.it/contatti
