Units Aio
Units Aio
  • Docs
  • Changelog
  • Feature requests
  • Support portal
    • Concept du module
    • GOAT
    • StockX
Docs / Marketplaces

StockX

Intégration StockX : connexion OAuth, clés API et comptes, listing en dropshipping et gestion des ventes.

Concept

StockX est l'autre marketplace sneakers majeure. Le module ERP fonctionne en parallèle de GOAT, avec une mécanique très similaire mais quelques particularités :

  • La connexion est OAuth (et non une simple clé API), avec un flux de validation à passer chaque fois qu'un nouveau compte est créé.
  • À ce jour, l'ERP gère uniquement le type Dropshipping côté StockX (pas de S2V).
  • Deux niveaux de connexion existent :
    • Clé API StockX (au niveau du tenant) — pour la récupération des prix de marché ou pour le listing.
    • Compte StockX (au niveau de la société) — pour les ventes et expéditions.

Connecter l'API StockX

Étape 1 — Créer une clé API StockX

Menu Marketplaces > StockX, sous-menu Comptes StockX (clés API). Bouton Nouveau.

Champ Description
Titre Libellé interne de la clé. Obligatoire.
Type d'utilisation Récupération des prix (les prix de marché StockX sont importés régulièrement) ou Listing de produits (les unités sont listées sur StockX).
Clé API Clé fournie par StockX. Obligatoire.
Limite de requêtes par jour Quota imposé par StockX (généralement 1000 ou 10 000 selon votre forfait API). Obligatoire.
Requêtes aujourd'hui Compteur en temps réel (lecture seule).

Enregistrer. La clé est utilisée par l'ERP pour les requêtes globales (pricing, mise à jour des annonces).

Étape 2 — Créer un compte StockX (OAuth)

Menu Marketplaces > StockX, bouton + dans la colonne de gauche pour créer un nouveau compte, ou Nouveau compte.

Le formulaire est organisé en trois panneaux.

Configuration API

Champ Description
Client ID Identifiant client OAuth fourni par StockX Developer.
Client secret Secret OAuth fourni par StockX Developer.
Code d'autorisation Généré automatiquement après autorisation OAuth. Lecture seule.
Token d'accès Token courant pour les appels API. Renouvelé automatiquement. Lecture seule.
Refresh token Token de renouvellement. Lecture seule.

Flux OAuth :

  1. Saisir le Client ID et le Client secret, puis enregistrer.
  2. Un bouton Connexion à StockX apparaît : cliquer dessus pour être redirigé vers la page d'autorisation StockX.
  3. Se connecter avec le compte StockX correspondant aux Client ID / Secret saisis (attention si plusieurs comptes sont actifs dans le navigateur — un encart d'avertissement le rappelle).
  4. Autoriser l'application : StockX redirige vers l'ERP, qui récupère et stocke automatiquement le Code d'autorisation, le Token d'accès, et le Refresh token.
  5. Une fois ces trois valeurs renseignées, la connexion est active.

Si vous devez renouveler la connexion (token expiré non renouvelable, changement de compte StockX, etc.), bouton Demander un nouveau code d'autorisation : le flux OAuth est rejoué.

Configuration du compte

Champ Description
Nom du compte Libellé interne. Obligatoire.
Société liée au compte Société du tenant qui détient les unités. Obligatoire en multi-sociétés.
Taux de commission Commission prélevée par StockX (en %). Sert au calcul des marges et à la facturation auto.
Frais d'envoi Frais fixes par vente (en euros). Sert au calcul des marges.
Client StockX Tiers client (CRM) à associer au compte. Apparaîtra comme acheteur des factures auto-générées.

Suivi des ventes StockX

Les ventes sont consultables depuis Marketplaces > StockX, onglet Ventes (par défaut). La vue est très similaire à celle de GOAT.

Filtres

Filtre Type Notes
Rechercher Texte Cherche dans le numéro de commande.
Sale Channel Sélection STANDARD (vente classique) / FLEX (programme StockX Flex).
SKU Multi-select SKU des modèles vendus.
Société Multi-select Société d'origine.
Ville Multi-select Ville d'emplacement.
Traitées Sélection Traitées / Non traitées / Toutes.
Statut de commande Multi-select Statuts StockX de la commande.

Listings StockX

Onglet Listings d'un compte StockX : montre les annonces actives sur StockX et leur stock lié côté ERP.

Onglet Listings non liés (badge rouge si > 0) : affiche les annonces StockX qui n'ont pas pu être rapprochées d'une unité de stock côté ERP. À traiter manuellement (vérifier que l'unité existe, que son SKU correspond, que la société est la bonne…).

Expédition des produits StockX (création d'une picking)

Mécanique similaire à GOAT.

Étape 1 — Filtrer et générer la picking

  1. Aller sur Marketplaces > StockX > Ventes.
  2. Filtrer la liste (SKU, société, ville, sale channel…).
  3. Cliquer sur Générer une picking.

L'ERP crée une picking contenant les unités correspondant aux filtres.

Étape 2 — Préparer physiquement les colis

La picking créée est traitée dans le module Restocks / Picking (cf. documentation Stock). Vous y trouvez la liste des unités à scanner, leur emplacement, et les actions de validation.

Étape 3 — Générer les expéditions StockX

Une fois les colis prêts, retour sur Marketplaces > StockX > Ventes.

  1. Cocher les ventes à expédier.
  2. Cliquer sur Générer les expéditions StockX dans le panneau d'actions en bas.

L'ERP crée les expéditions correspondantes (une par société selon le cas), avec :

  • Le client rattaché = Client StockX configuré sur le compte.
  • Les unités passent au statut Vendu dans le stock.

Bon à savoir — Pas d'étiquettes StockX
Contrairement à GOAT, StockX n'expose pas (à ce jour) d'API pour générer les étiquettes d'expédition directement depuis l'ERP. Vous devez récupérer les étiquettes côté StockX (espace vendeur) après création de la commande. L'ERP gère uniquement les expéditions et factures côté comptable.


Logs et journal API

Sur chaque compte (GOAT comme StockX), deux onglets supplémentaires permettent de diagnostiquer un problème :

Onglet Logs (events)

Affiche les événements métier liés au compte : récupération de ventes, création de listing, mise à jour de prix, génération d'expédition, génération de facture auto, etc.

Un badge rouge apparaît dans la navigation si des erreurs récentes sont détectées : utile pour repérer rapidement un problème de synchro.

Onglet Journal API

Affiche les appels API bruts entre l'ERP et la marketplace (requête, réponse, code HTTP). Outil de diagnostic technique en cas de support ou de bug.

Bon à savoir — Ces logs sont consultables uniquement par les administrateurs. En cas de problème de synchro (vente non remontée, listing en erreur, picking vide), ouvrez d'abord l'onglet Logs pour repérer l'événement récent en erreur, puis l'onglet Journal API pour voir le détail technique. C'est aussi l'information à transmettre au support si le problème persiste.

PrevGOAT
NextConcept du module
Was this helpful?