Squarespace non ha una schermata di installazione app come Shopify. Il collegamento usa una chiave API che generi nelle impostazioni del sito e incolli in Furgox. L'unica parte delicata sono i permessi, che Squarespace lascia in sola lettura per impostazione predefinita.
Prima di iniziare
Serve un piano commerce su Squarespace: senza, l'opzione delle chiavi API per sviluppatori non compare.
Devi accedere come proprietario o amministratore del sito.
Un negozio può essere collegato a un solo account Furgox alla volta.
1. Genera la chiave in Squarespace
Nel pannello del sito vai su Impostazioni → Avanzate → Chiavi API per sviluppatori.
Premi Genera chiave e dalle un nome riconoscibile, per esempio
Furgox.Imposta su Lettura e scrittura i permessi Ordini, Inventario e Prodotti (se compare).
Copia la chiave prima di chiudere la finestra.
I due errori classici: lasciare i permessi su «Sola lettura» — ognuno ha il suo menu — e chiudere la finestra senza copiare la chiave. Squarespace la mostra una volta sola: se la perdi, devi generarne un'altra.
Se il permesso Prodotti non compare nella tua lista, nessun problema: non tutti i siti lo offrono e possiamo comunque costruire il catalogo dall'inventario.
2. Incolla la chiave in Furgox
Nel pannello apri Integraciones, premi Conectar tienda e scegli Squarespace.
Incolla la chiave e collega. Controlliamo i permessi prima di salvare qualsiasi cosa: se ne manca uno, ti diciamo esattamente quale.
3. Fatto: il negozio è collegato
Cosa succede da qui in poi
Ordini
Squarespace non può avvisarci dei suoi cambiamenti quando il collegamento usa una chiave API: è possibile solo con OAuth, riservato alle estensioni approvate da loro. Quindi interroghiamo il negozio ogni 15 secondi. In pratica un ordine compare in Furgox in pochi secondi.
Prodotti
Importiamo il catalogo con varianti, SKU e foto. Se la tua chiave non ha il permesso sui prodotti, lo costruiamo dall'inventario, che porta comunque SKU e nome di ogni variante.
Stock
Pubblichiamo su Squarespace le unità reali del magazzino, man mano che arriva merce ed escono ordini.
Spedizioni
Quando l'ordine parte scriviamo il numero di tracking su Squarespace e lo segniamo come spedito, così il cliente riceve l'avviso di sempre.
Cosa Squarespace non ci lascia fare
La sua API non offre rimborsi, annullamenti né modifica degli ordini. Se devi annullare o rimborsare, fallo dal tuo Squarespace: noi ci occupiamo della parte fisica della spedizione.
Se qualcosa non funziona
«Alla chiave mancano dei permessi»
Torna in Impostazioni → Avanzate → Chiavi API e controlla che i permessi indicati siano su «Lettura e scrittura», non «Sola lettura». Squarespace non sempre permette di modificare una chiave esistente: in tal caso generane una nuova.
Gli ordini restano in attesa nel mio Squarespace
È il sintomo classico di Ordini in sola lettura: possiamo leggerli ma non segnarli come spediti. Rigenera la chiave con il permesso corretto e ricollega.
«Questo negozio è già collegato a un altro account»
Lo stesso negozio non può stare in due account Furgox. Scollegalo dall'altro oppure scrivici.
Ho rigenerato la chiave in Squarespace
Il collegamento vecchio smette di funzionare. Torna in Integrazioni e ricollega il negozio con la chiave nuova.
Ti blocchi sui permessi? Scrivici dalla chat del pannello.