API DevVersPA

Documentation de référence du service web SOAP permettant de connecter vos applications Windev® aux Plateformes Agréées (PA) pour la facturation électronique au format Factur-X.

Présentation

DevVersPA est un service web SOAP développé par SEALOG qui expose 8 points d'entrée couvrant l'ensemble du cycle de vie d'une facture électronique : création, validation, envoi, réception et suivi de statut — le tout intégrable nativement dans un projet Windev® grâce à l'assistant d'import de services web.

L'authentification repose sur un token de session obtenu via WS_1_ConnexionDevVersPA et transmis à tous les appels suivants. Ce token a une durée de vie limitée.

Point d'entrée WSDL

https://devverspa.fr/DEVVERSPA_WEB/awws/DevVersPA.awws?wsdl

Pour importer le service dans l'IDE Windev®, faites un clic droit dans l'explorateur de projet sur Webservices importés, choisissez Utiliser un Webservice SOAP… :

Flux d'utilisation typique

Pour envoyer une facture de vente, le flux standard est le suivant :

1. WS_1_ConnexionDevVersPA  →  obtenir un Token
2. WS_4_VerifieSurAnnuaireFrancais  →  vérifier l'adresse électronique de facturation du destinataire
3. WS_2_CreerFacturX  →  générer le Factur-X à partir de votre JSON + PDF
   — et/ou —
   WS_3_ValidationFacturX  →  valider le Factur-X généré ou existant
4. WS_8_EnvoyerFactureDeVente  →  transmettre à la Plateforme Agréée
5. WS_5_LectureStatut  →  suivre le traitement de la facture

Pour les factures d'achats reçues de vos fournisseurs :

1. WS_1_ConnexionDevVersPA  →  Token
2. WS_5_LectureStatut  →  détection des factures d'achats arrivées
2. WS_6_RecevoirFacturesAchats  →  récupérer les factures d'achats
3. WS_7_EnvoyerStatut  →  accuser réception / traitement

Référence des points d'entrée

Identifiant	Rôle
WS_1_ConnexionDevVersPA	Authentification — obtenir un token de session
WS_2_CreerFacturX	Créer un fichier Factur-X (PDF/A-3 + XML) depuis un JSON de facture
WS_3_ValidationFacturX	Valider la conformité d'un fichier Factur-X ou XML
WS_4_VerifieSurAnnuaireFrancais	Vérifier l'inscription d'un client dans l'annuaire centralisé (PPF)
WS_5_LectureStatut	Lire les statuts de traitement d'une facture de vente émise, ou détection des factures d'achats arrivées
WS_6_RecevoirFacturesAchats	Récupérer les factures d'achats reçues de fournisseurs
WS_7_EnvoyerStatut	Envoyer un accusé de réception ou de traitement d'une facture émise ou reçue
WS_8_EnvoyerFactureDeVente	Transmettre une facture Factur-X à la Plateforme Agréée

Conventions générales

• Tous les paramètres et valeurs de retour sont de type chaîne ou entier (types Windev® natifs).
• Les fichiers (PDF, XML, Factur-X) sont transmis encodés en Base64.
• Chaque réponse commence par ERREUR: en cas d'erreur, ou par la valeur attendue en cas de succès.
• Le token doit être transmis à chaque appel après la connexion (WS_1).
• Le token a une durée de vie limitée — reconnecter si une erreur de token invalide est renvoyée.

Conformité réglementaire

DevVersPA s'inscrit dans le cadre de la réforme française de facturation électronique B2B, obligatoire progressivement à partir de 2026. Le service est conçu pour interopérer avec la Plateforme Agréée (PA) SUPERPDP.