Squarespace n'a pas d'écran d'installation d'application comme Shopify. La connexion se fait avec une clé d'API que vous générez dans les réglages de votre site et collez dans Furgox. Le seul point délicat, ce sont les permissions, laissées en lecture seule par défaut.
Avant de commencer
Il faut un plan commerce sur Squarespace : sans lui, l'option de clés d'API pour développeurs n'apparaît pas.
Vous devez être connecté en tant que propriétaire ou administrateur du site.
Une boutique ne peut être reliée qu'à un seul compte Furgox à la fois.
1. Générez la clé dans Squarespace
Dans le panneau de votre site, allez dans Paramètres → Avancé → Clés d'API pour développeurs.
Cliquez sur Générer une clé et donnez-lui un nom reconnaissable, par exemple
Furgox.Passez en Lecture et écriture les permissions Commandes, Inventaire et Produits (si elle apparaît).
Copiez la clé avant de fermer la fenêtre.
Les deux erreurs classiques : laisser les permissions en « Lecture seule » — chacune a son menu — et fermer la fenêtre sans copier la clé. Squarespace ne l'affiche qu'une seule fois : perdue, il faut en générer une autre.
Si la permission Produits n'apparaît pas chez vous, ce n'est pas grave : tous les sites ne la proposent pas et nous pouvons construire votre catalogue depuis l'inventaire.
2. Collez la clé dans Furgox
Dans votre panneau, ouvrez Integraciones, cliquez sur Conectar tienda et choisissez Squarespace.
Collez la clé et connectez. Nous vérifions les permissions avant d'enregistrer quoi que ce soit : s'il en manque une, nous vous disons précisément laquelle.
3. C'est fait : la boutique est connectée
Et ensuite ?
Commandes
Squarespace ne peut pas nous prévenir de ses changements quand la connexion utilise une clé d'API : ce n'est possible qu'en OAuth, réservé aux extensions qu'ils ont validées. Nous interrogeons donc votre boutique toutes les 15 secondes. En pratique, une commande arrive dans Furgox en quelques secondes.
Produits
Nous importons votre catalogue avec ses déclinaisons, son SKU et sa photo. Si votre clé n'a pas la permission produits, nous le construisons depuis l'inventaire, qui porte aussi le SKU et le nom de chaque déclinaison.
Stock
Nous publions dans Squarespace les quantités réelles de l'entrepôt, au fil des réceptions et des expéditions.
Expéditions
Au départ du colis, nous inscrivons le numéro de suivi dans Squarespace et marquons la commande comme expédiée, pour que votre client reçoive sa notification habituelle.
Ce que Squarespace ne nous permet pas
Son API n'offre ni remboursement, ni annulation, ni modification de commande. Pour annuler ou rembourser, passez par votre Squarespace : nous nous occupons de la partie physique de l'expédition.
En cas de problème
« Il manque des permissions à la clé »
Retournez dans Paramètres → Avancé → Clés d'API et vérifiez que les permissions indiquées sont en « Lecture et écriture », pas en « Lecture seule ». Squarespace ne permet pas toujours de modifier une clé existante : dans ce cas, générez-en une nouvelle.
Les commandes restent en attente dans mon Squarespace
C'est le symptôme classique de Commandes en lecture seule : nous pouvons les lire mais pas les marquer expédiées. Régénérez la clé avec la bonne permission et reconnectez.
« Cette boutique est déjà connectée à un autre compte »
Une même boutique ne peut pas figurer dans deux comptes Furgox. Déconnectez-la de l'autre ou écrivez-nous.
J'ai régénéré la clé dans Squarespace
L'ancienne connexion cesse de fonctionner. Retournez dans Intégrations et reconnectez la boutique avec la nouvelle clé.
Bloqué sur les permissions ? Écrivez-nous depuis le chat du panneau.