Pennylane
Statut : Disponible. Le plugin actuel livre un connecteur Pennylane Company API V2 pour les capacités ci-dessous. Les fonctionnalités non listées ne doivent pas être déduites de l’ensemble plus large de l’API Pennylane.
Capacités implémentées
| Capacité | Statut | Comportement |
|---|---|---|
| Test de connexion | Disponible | valide le token, l’identité de la société et la cohérence sandbox/production |
| Soumission Factur-X | Disponible | importe le Factur-X figé comme facture électronique client |
| Transfert PA | Disponible, sur activation | ajoute send_to_pa=true uniquement si l’option est explicitement activée |
| Suivi du cycle de vie | Disponible | interroge le changelog des factures clients puis la ressource facture courante |
| Webhooks Pennylane | Non supportés par ce connecteur | utiliser la commande de polling implémentée |
L’infrastructure générique de webhooks du plugin ne rend pas les webhooks Pennylane disponibles : aucun authentificateur/décodeur spécifique Pennylane n’est enregistré par le connecteur actuel.
Configuration sûre
Commencez avec une société/un token sandbox dédiés, le transfert PA désactivé et la transmission manuelle :
sylius_invoice:
platform:
active: pennylane
environment: SANDBOX
organization_id: '%env(PENNYLANE_COMPANY_ID)%'
credentials:
api_token: PENNYLANE_API_TOKEN
options:
send_to_pa: false
transmission:
mode: MANUAL
api_token est une référence de secret. Le vrai token doit rester dans le gestionnaire de secrets du déploiement. Le connecteur implémenté nécessite les permissions fournisseur documentées par le plugin, dont customer_invoices:all pour les opérations sur les factures clients.
Validez la connexion avant d’activer la transmission :
bin/console sylius-invoice:platform:test-connection
La synchronisation des statuts utilise :
bin/console sylius-invoice:pennylane:sync-statuses
Limite opérationnelle
Le traitement côté prestataire est asynchrone. Un import réussi n’équivaut pas à une acceptation finale. Le plugin ne normalise que les états Pennylane explicitement mappés et évite de transformer les valeurs inconnues en statuts cœur trompeurs.
Le connecteur n’implémente actuellement ni cycle OAuth2, ni soumission de factures fournisseurs, ni upload UBL/CII autonome, ni ingestion de webhooks spécifiques Pennylane.
Le guide canonique d’implémentation est invoice-plugin/docs/connectors/pennylane.md ; c’est la source à relire lors d’une évolution du prestataire ou du connecteur.