SOAP

WS_8_EnvoyerFactureDeVente

Transmet une facture de vente au format Factur-X à la Plateforme Agréée (PA) pour acheminement vers le destinataire et la DGFiP.

Résumé

Point d'entrée principal du flux de facturation sortante. Une fois votre Factur-X généré (via WS_2 ou votre propre outil), ce WS l'envoie à votre Plateforme Agréée qui se charge de la transmission au destinataire et de la déclaration à la DGFiP.

En retour, DevVersPA fournit un identifiant de suivi (IdFacture) à conserver pour interroger le statut via WS_5_LectureStatut.

Syntaxe

sResultat est chaîne = WS_8_EnvoyerFactureDeVente(Token, ContenuFichierPDF)

Paramètres

Nom	Type	Description	Obligatoire
Token	chaîne	Token de session obtenu via WS_1.	Oui
ContenuFichierPDF	chaîne	Contenu du fichier Factur-X (PDF/A-3 avec XML embarqué), encodé en Base64. Ce fichier doit être un Factur-X valide — utilisez WS_3 pour valider avant envoi si nécessaire. Note : malgré le nom du paramètre, le fichier transmis doit être un Factur-X complet, pas un simple PDF.	Oui

Valeur de retour

Cas	Valeur retournée
Succès	Identifiant numérique DevVersPA de la facture (IdFacture) — à stocker pour le suivi via WS_5.
Erreur	Chaîne commençant par Erreur : (Factur-X invalide, token expiré, PA non joignable…).

Exemple WLangage

// ── Envoi d'une facture de vente ─────────────────────────
// sFacturXBase64 : Factur-X en Base64 (produit par WS_2 ou outil tiers)

PROCÉDURE EnvoyerFactureVente(sFacturXBase64 est chaîne) : entier

sRetour est chaîne = WS_8_EnvoyerFactureDeVente( ­
    gsToken,        ­// Token de session
    sFacturXBase64  ­// Factur-X en Base64
)

SI Gauche(sRetour, 6) = "Erreur" ALORS
    Erreur("Envoi facture échoué :" + RC + sRetour)
    RENVOYER 0
FIN

// sRetour contient l'IdFacture DevVersPA
nIdFacture est entier = Val(sRetour)

// Stocker nIdFacture en base de données pour le suivi
// ex: MiseÀJour(TFactures, [IdDevVersPA], nIdFacture, [Statut], "ENVOYÉE")

Info("Facture envoyée avec succès. ID DevVersPA : " + nIdFacture)
RENVOYER nIdFacture

// ── Flux complet en exemple ───────────────────────────────
// 1. ConnexionDevVersPA(...)           → gsToken
// 2. WS_2_CreerFacturX(...)            → sFacturX (Base64)
// 3. WS_8_EnvoyerFactureDeVente(...)   → nIdFacture
// 4. Stocker nIdFacture en base
// 5. (Timer) WS_5_LectureStatut(...)   → suivre l'état

Voir aussi

• WS_2_CreerFacturX — générer le Factur-X à partir d'un JSON
• WS_3_ValidationFacturX — valider le Factur-X avant envoi
• WS_5_LectureStatut — suivre le traitement après envoi