Architecture d'intégration MyRealShop

MyRealShop est conçu pour s'intégrer dans l'écosystème technique des entreprises. L'API REST de MyRealShop et les webhooks temps réel permettent de synchroniser les données de vente live avec votre ERP, CRM, PIM (catalogue produit) et logistique. Ce guide s'adresse aux équipes techniques (DSI, architectes, développeurs) qui souhaitent industrialiser la connexion MyRealShop à leurs systèmes existants.

Les 4 flux d'intégration principaux

Flux 1 : Synchronisation du catalogue produit (PIM → MyRealShop)

Votre Product Information Management (PIM) ou votre ERP contient la vérité sur votre catalogue. MyRealShop doit refléter exactement ce catalogue en temps réel. L'API MyRealShop expose des endpoints d'import/mise à jour produit :

POST /api/v1/products          # Créer un produit
PUT  /api/v1/products/{id}     # Mettre à jour un produit
DELETE /api/v1/products/{id}   # Supprimer un produit
PUT  /api/v1/products/{id}/stock  # Mettre à jour le stock

Le payload d'un produit MyRealShop suit ce schéma JSON :

{
  "sku": "REF-12345",
  "name": "Robe Wax Bleue - Taille M",
  "description": "...",
  "price": 25000,
  "currency": "XOF",
  "stock": 12,
  "variants": [
    {"label": "Taille", "value": "S", "stock": 5},
    {"label": "Taille", "value": "M", "stock": 7}
  ],
  "images": ["https://cdn.yourcompany.com/products/ref-12345.jpg"],
  "category": "Mode femme"
}

Fréquence recommandée : Synchronisation toutes les heures pour les stocks, immédiate pour les créations/suppressions produit via un événement de votre ERP.

Flux 2 : Réception des commandes en temps réel (MyRealShop → ERP)

Chaque vente passée pendant un live doit être injectée dans votre OMS (Order Management System) ou ERP pour déclencher la préparation et la livraison.

MyRealShop envoie un webhook POST à votre endpoint pour chaque commande confirmée :

POST https://your-erp.company.com/webhooks/myrealshop/order

{
  "event": "order.confirmed",
  "order_id": "MRS-2025-0841",
  "live_id": "live-abc123",
  "created_at": "2025-07-10T18:23:45Z",
  "customer": {
    "id": "cust-xyz",
    "name": "Aminata Diallo",
    "phone": "+221771234567",
    "payment_method": "orange_money"
  },
  "items": [
    {
      "sku": "REF-12345",
      "variant": "M",
      "quantity": 2,
      "unit_price": 25000,
      "total": 50000
    }
  ],
  "delivery": {
    "type": "home_delivery",
    "address": "Almadies, Dakar",
    "notes": "Appeler avant livraison"
  },
  "payment": {
    "method": "orange_money",
    "status": "confirmed",
    "amount": 50000,
    "currency": "XOF",
    "transaction_id": "TXN-OM-892346"
  }
}

Sécurisation des webhooks : Chaque webhook est signé avec un header X-MyRealShop-Signature (HMAC-SHA256 avec votre clé secrète). Vérifiez cette signature côté ERP avant de traiter l'événement.

Flux 3 : Mise à jour du statut de livraison (ERP → MyRealShop)

Une fois la commande préparée et expédiée, votre ERP doit notifier MyRealShop pour que le client et le vendeur reçoivent les mises à jour de statut en temps réel.

PUT /api/v1/orders/{order_id}/status

{
  "status": "shipped",  // confirmed | processing | shipped | delivered | cancelled
  "tracking_number": "DHL-876543",
  "estimated_delivery": "2025-07-12"
}

Flux 4 : Synchronisation CRM — historique client (MyRealShop → CRM)

Les données comportementales des acheteurs live (produits regardés, produits achetés, fréquence des achats, panier moyen) enrichissent votre CRM pour la segmentation et le ciblage marketing.

MyRealShop propose un export quotidien des événements client via l'API :

GET /api/v1/customers?updated_since=2025-07-09T00:00:00Z

# Retourne la liste des clients avec leurs métriques d'engagement live :
# - total_purchases, total_spent, last_purchase_date
# - lives_watched_count, average_watch_time
# - favorite_categories, preferred_payment_method

Intégrations natives disponibles

Pour les systèmes les plus courants sur le marché africain, MyRealShop propose des connecteurs natifs en configuration no-code :

Odoo (ERP) — Connecteur natif disponible. Synchronisation catalogue et commandes en temps réel.
Sage (comptabilité/gestion) — Synchronisation des ventes et des paiements
Hubspot (CRM) — Export des données client et des événements d'achat
Zoho CRM — Intégration via Zapier (disponible)
WooCommerce / PrestaShop — Plugin officiel pour les boutiques e-commerce existantes

Sécurité et conformité des données

Authentification API

L'API MyRealShop utilise OAuth 2.0 avec des tokens JWT à expiration courte (1 heure). Les tokens de rafraîchissement ont une durée de vie de 30 jours. Les clés API sont régénérables à tout moment depuis le dashboard Corporate.

Données personnelles (RGPD/protection des données)

MyRealShop est conforme aux exigences de protection des données personnelles applicables. Les données client ne sont jamais partagées avec des tiers sans consentement explicite. Votre entreprise peut demander l'export ou la suppression des données d'un client à tout moment.

Disponibilité de l'API

L'API MyRealShop est disponible 24/7 avec un SLA de 99.5% pour les comptes Corporate. Un environnement de staging est disponible pour vos développeurs sans impact sur la production.

Timeline d'intégration type

J1-J3 : Accès à la documentation API, création des credentials, exploration de l'environnement staging
J4-J7 : Développement du connecteur catalogue PIM → MyRealShop
J8-J12 : Développement du récepteur webhook commandes + injection ERP
J13-J15 : Tests end-to-end en staging. Simulation de 50 commandes live.
J16 : Go live. Premier live avec intégration complète.

Support technique pour les équipes Corporate

Les comptes MyRealShop Corporate incluent un accès direct à notre équipe technique : canal Slack privé, documentation Postman complète, réponse aux tickets techniques en moins de 4h ouvrées. Un Technical Account Manager dédié accompagne les intégrations complexes.

FAQ : Intégration ERP/CRM

L'API MyRealShop est-elle disponible en REST uniquement ?

L'API est principalement REST/JSON. Une interface GraphQL est en bêta pour les comptes Corporate qui nécessitent des requêtes plus flexibles. Contactez notre équipe technique pour y accéder.

Comment tester l'intégration sans impacter la production ?

MyRealShop met à disposition un environnement staging complet (sandbox) avec des données de test et des faux paiements Mobile Money. Tout peut être testé sans jamais toucher à des données réelles ou des transactions réelles.

Quelle charge peut supporter l'API lors d'un gros live ?

L'API MyRealShop est conçue pour gérer des pics de commandes (jusqu'à 500 commandes par minute sur les comptes Corporate). Des limites de rate limiting s'appliquent sur les endpoints de lecture (1000 req/min) mais pas sur les webhooks sortants.

Intégrer MyRealShop à votre ERP et CRM : Guide Technique pour les DSI