Publié le 1 octobre 2025 · Mis à jour le 20 octobre 2026
Relier une boutique en ligne à Pennylane par l’API demande d’abord un cadrage : quelles données, dans quel sens, à quelle fréquence et avec quelles règles de TVA. La réussite d’une intégration e-commerce ↔ Pennylane se joue moins dans le code que dans le cadrage, l’architecture choisie et la supervision des flux. Ce guide s’adresse aux développeurs, architectes et DAF qui pilotent ce type de projet.
Altaïs – Tout-pour-la-gestion, intégrateur officiel Pennylane et agence web
- ✅ Sage Business Partner Platinum, Zoho Advanced Partner, partenaire EBP, Odoo et Pennylane
- ✅ +30 ans d’expérience (depuis 1996) et +600 clients actifs, tous éditeurs confondus
- ✅ Agences à Orléans, Paris et Tours, interventions sur toute la France, sur site ou à distance
- ✅ Organisme de formation certifié Qualiopi
En bref : l’API Pennylane est une API REST avec authentification par jeton ou OAuth 2.0. Une intégration e-commerce synchronise ventes, encaissements, avoirs et frais de plateforme. La documentation Pennylane indique une limite de 5 requêtes par seconde et par jeton pour l’API V1, au-delà de laquelle l’API renvoie une erreur 429 : l’architecture doit en tenir compte. Pennylane est par ailleurs Plateforme Agréée pour la facture électronique.
Cadrer l’intégration : le questionnaire technique
Avant toute ligne de code, sept sujets doivent être tranchés avec le métier et la comptabilité.
- La stack e-commerce Plateforme (PrestaShop, WooCommerce, Shopify, solution sur mesure), version, modules de paiement et outils connectés.
- Le périmètre des données Commandes, factures, avoirs, encaissements, frais de commission, clients B2B et B2C.
- Le sens et la fréquence Flux unidirectionnel vers Pennylane ou retours de statut, temps réel, lots horaires ou quotidiens.
- Les volumes et la saisonnalité Pics de soldes et de fin d’année, nombre de lignes par commande.
- Les règles métier Ventilation de la TVA par taux, ventes intracommunautaires, remboursements partiels, multi-devises.
- La conformité et la traçabilité RGPD, journalisation des appels, conservation des pièces.
- L’authentification Jeton développeur pour un usage interne, OAuth 2.0 pour un intégrateur qui se connecte à plusieurs dossiers.
Trois architectures possibles
| Architecture | Principe | Adaptée à |
|---|---|---|
| Synchronisation directe | La boutique appelle l’API Pennylane à chaque événement. | Faibles volumes, peu de règles métier. |
| File d’attente | Les événements sont empilés puis envoyés à un rythme maîtrisé, avec reprise sur erreur. | Volumes moyens à élevés, pics saisonniers. |
| Événementielle avec middleware | Un bus central diffuse les événements vers Pennylane et les autres outils (ERP, CRM, logistique). | Plusieurs canaux de vente et plusieurs logiciels à alimenter. |
Limiter le débit
Un algorithme de seau à jetons côté client, des reprises avec temporisation progressive sur les erreurs 429 et 5xx, et l’idempotence des envois évitent les doublons comme les pertes de données. Vérifiez la limite applicable à la version d’API utilisée dans la documentation Pennylane.
Un échange de 15 minutes avec notre équipe Pennylane
Un échange de 15 minutes avec notre équipe Pennylane permet de valider votre périmètre de données et l’architecture adaptée à vos volumes.
Mise en œuvre : les points techniques sensibles
OAuth 2.0
Stockage sécurisé et renouvellement des jetons, séparation des environnements de test et de production.
Factures clients
Création avec lignes, taux de TVA et références de commande, puis rapprochement avec l’encaissement.
Factur-X
Import de factures au format Factur-X, format reconnu par la réforme de la facturation électronique.
Avoirs et remboursements
Traitement des retours et remboursements partiels sans déséquilibrer la TVA.
Superviser l’intégration dans la durée
Une intégration qui fonctionne le jour du lancement doit continuer à fonctionner au fil des évolutions de la boutique et de l’API. Suivez au minimum le taux de synchronisations réussies, le taux d’erreurs 429 et 5xx, la taille de la file d’attente et l’ancienneté du plus vieux message en attente, avec des alertes graduées.
Pour la vue d’ensemble des cas d’usage (e-commerce, caisse, négoce), lisez API Pennylane : automatiser les flux d’un e-commerce ou d’un négoce ; pour les connecteurs existants, API et connecteurs Pennylane : relier vos logiciels ; pour les fonctionnalités, Pennylane pour les PME : le guide des fonctionnalités clés.
Questions fréquentes sur l’intégration API Pennylane e-commerce
Quelle authentification utiliser pour l’API Pennylane ?
Un jeton développeur pour une intégration interne à une entreprise, OAuth 2.0 pour une application qui se connecte à plusieurs dossiers Pennylane.
Quelle est la limite de requêtes de l’API Pennylane ?
La documentation Pennylane indique 5 requêtes par seconde et par jeton pour l’API V1, avec une erreur 429 au-delà ; vérifiez la limite de la version que vous utilisez.
Faut-il synchroniser en temps réel ?
Pas forcément : des lots réguliers via une file d’attente sont souvent plus robustes, surtout lors des pics de ventes.
Pennylane gère-t-il la facture électronique ?
Oui, Pennylane est Plateforme Agréée pour la réforme de la facturation électronique entrée en vigueur le 1er septembre 2026.
Altaïs peut-elle réaliser l’intégration ?
Oui : Altaïs est intégrateur officiel Pennylane et dispose d’une équipe web pour le développement des connecteurs, sur site ou à distance.
Sources
Parlons de votre intégration Pennylane
Cadrage, développement du connecteur, supervision et formation de vos équipes : un seul interlocuteur pour votre projet.
