Suivre une livraisonCommander une livraisonConnexion
Accueil → Développeurs

API développeurs

Intégrez Supply Factory à votre CMS, WMS, ERP ou tool 3PL en quelques heures. API REST simple, webhooks signés HMAC-SHA256, 8 connecteurs CMS natifs.

API REST publique

Créez des shipments, générez étiquettes PDF, suivez statuts en temps réel.

POST /api/shipments
Authorization: Bearer sf_xxx
{ pickupAddress, deliveryAddress,
  weightGrams, serviceLevel }

Webhooks signés HMAC

Recevez les 12 events shipment.* sur votre URL callback. Signature HMAC-SHA256 vérifiable.

POST https://shop.marque.fr/hook
X-SF-Signature: sha256=...
X-SF-Event: shipment.delivered
{ id, trackingRef, status, pod }

Connecteurs CMS natifs

8 tools supportés : Shopify · WooCommerce · PrestaShop · Wix · BigCommerce · Magento · Odoo · Klaviyo.

# Un seul clic dans BrandApp
# → tracking pushé automatiquement
# dans votre CMS admin

Portail retour public

URL /retour/[ref] pour que vos clients finaux initient un retour eux-mêmes. Configurable par marque.

GET /api/public/return-info/:ref
POST /api/public/return-request
{ trackingRef, email, reason }

Chat client final ↔ chauffeur

Vos clients peuvent envoyer des instructions au chauffeur (code interphone, etc.) via /suivi/[ref].

POST /api/public/shipment-message
{ trackingRef, email,
  content: "Code 4321B" }

KPI dashboard temps réel

7 métriques agrégées : taux service, perte, dommage, échec, tentatives, note satisfaction, volume.

GET /api/shipments/kpis?window=30
{ volume, quality,
  customerSatisfaction }

Démarrage rapide (5 min)

  1. Créez votre compte marque sur supplyfactory.fr/inscription
  2. Générez une API key dans BrandApp → Mon compte → API tokens
  3. Testez votre première expédition :
    curl -X POST https://api.supplyfactory.fr/api/shipments \
      -H "Authorization: Bearer sf_xxxxx" \
      -H "Content-Type: application/json" \
      -d '{
        "pickupAddress": {"street":"10 rue Paradis","postalCode":"75010","city":"Paris","contactEmail":"you@brand.fr"},
        "deliveryAddress": {"street":"42 av Champs","postalCode":"75008","city":"Paris","contactEmail":"client@ex.com"},
        "weightGrams": 1500,
        "serviceLevel": "j+1"
      }'
  4. Configurez un webhook pour recevoir les status automatiquement
  5. Téléchargez l'étiquette PDF et vous êtes prêt

Support intégration

Une question technique ? Notre équipe dev est joignable directement.

dev@supplyfactory.fr →

Status & monitoring

Uptime API + incidents en cours. Consultable publiquement.

status.supplyfactory.fr →

Prêt à démarrer ?

Créez votre compte gratuitement, testez notre API en sandbox, contactez-nous pour un onboarding personnalisé.

Créer un compte