Pour connecter une application à Pennylane, on passe par l'API Company v2 : un administrateur génère un jeton dans Paramètres > Connectivité > Développeurs, en lecture seule ou en lecture et écriture, puis l'application appelle app.pennylane.com/api/external/v2. Condition souvent découverte trop tard : la formule Starter ne donne pas accès à l'API, il faut l'offre Essential ou supérieure.

Les points qui font la différence en production, relevés dans la documentation officielle au 5 novembre 2026 :

  • 25 requêtes toutes les 5 secondes par jeton, sandbox comprise ; au-delà, erreur 429. Une reprise d'historique doit passer par une file d'attente, pas par une boucle d'appels.
  • Pas d'idempotence sur la création de factures ou d'écritures : un appel rejoué crée un doublon. Le dédoublonnage se code côté application, par exemple avec le champ external_reference.
  • Le jeton n'est affiché qu'une fois et expire à 1, 6 ou 12 mois selon le choix fait : sans alerte de renouvellement, la synchronisation s'arrête sans prévenir.
  • Les webhooks exigent une URL de rappel en HTTPS ; à défaut, on interroge les journaux de modifications des factures.

Un intégrateur qui publie un connecteur pour plusieurs sociétés doit passer par OAuth 2.0, avec un jeton d'accès valable 24 heures. Pour un usage interne, le jeton Company suffit. Pulsar Forge développe ces connecteurs entre Pennylane, vos applications métier et votre CRM : parlons de votre flux.