DOC
Accueil/ Projets/ KOBIKE Tracking Notifier/ Guide 05 - API Shifter (email client des ventes en boutique physique)

Guide 05 - API Shifter (email client des ventes en boutique physique)

Objectif : retrouver l'email d'un client issu d'une vente physique (caisse/atelier gérés par Shifter) quand il manque dans le Tencent Docs. Voir ADR 0002.

Shifter = logiciel de caisse/atelier pour boutiques de vélo (app.trouver-un-reparateur.fr, site produit app-shifter.com). Portail réparateur : https://app.trouver-un-reparateur.fr/espace_reparateur_2.

Disponibilité de l'API - vérifié ⚠️ (accès sur demande)

Shifter dispose bien d'une API documentée : « nous avons aussi documenté une API vous permettant de connecter le logiciel Shifter à n'importe quels services tiers » (source : page e-commerce/API de Shifter). Elle propose aussi des connecteurs e-commerce natifs (Shopify, WooCommerce, PrestaShop).

MAIS l'accès n'est pas en self-service : il faut le demander commercialement.

Il faut donc, en pratique, être client Shifter (entreprise) et passer par un échange avec leur équipe pour activer l'accès API et obtenir les identifiants.

1. Démarche d'obtention de l'accès

  1. Remplir le formulaire https://www.app-shifter.com/api-shifter (coordonnées entreprise + besoin : « enrichissement email pour notifications de suivi de commande »).
  2. Participer au rendez-vous de présentation proposé par Shifter.
  3. Demander explicitement :
    • le type d'authentification (clé API / token / OAuth),
    • l'URL de base de l'API,
    • les endpoints pour rechercher un client, une commande/vente ou une facture par identifiant,
    • la politique de rate limiting.
  4. Récupérer les identifiants et les stocker dans les credentials n8n.

2. Intégration n8n (à finaliser une fois la doc obtenue)

Structure prévue (à confirmer avec apidoc.getshifter.io) :

  • Nœud HTTP Request authentifié vers l'API Shifter.
  • Recherche par téléphone + nom du client (voir ci-dessous), pas par numéro de commande.
  • ⚠️ Confirmé : les identifiants Shifter sont des numéros internes atelier (ex. #1192, #2172, #1005, visibles sur le tableau de bord Shifter) et ne correspondent PAS au Platform order number du Tencent Docs (ex. KO260107-1). La correspondance doit donc se faire sur téléphone + nom (les deux sont présents dans le Tencent Docs), éventuellement complétée par une table de mapping manuelle pour les cas ambigus.
  • En cas de succès : écrire l'email dans client (cache local, ADR 0002/0004).

3. Si l'email reste introuvable (ni local, ni Shopify, ni Shifter)

  • Ne pas créer de notification (pas de blocage anti-doublon - ADR 0004).
  • Générer une alerte interne vers l'équipe magasin (email interne ou message WeCom) pour recontacter le client / compléter la fiche Shifter.
  • Voir aussi les leviers de collecte d'email en boutique (rapport_0002 §4 : email obligatoire dans Shifter, portail QR code d'auto-enregistrement).

Checklist

  • Demande d'accès API envoyée via le formulaire / téléphone.
  • Type d'auth + URL de base + endpoints clients/ventes obtenus.
  • Correspondance numero_commande ↔ identifiant Shifter clarifiée.
  • Identifiants stockés dans n8n, appel de test réussi.

Ressources