SOAP

WS_6_RecevoirFacturesAchats

Récupère les factures d'achats (factures reçues de vos fournisseurs) déposées sur votre Plateforme Agréée et en attente de téléchargement.

Résumé

Ce point d'entrée permet de consulter et télécharger les factures fournisseurs transmises par leurs plateformes vers votre Plateforme Agréée. C'est l'équivalent côté acheteur du flux d'envoi géré par WS_8.

Après réception, pensez à accuser réception via WS_7_EnvoyerStatut.

Syntaxe

sResultat est chaîne = WS_6_RecevoirFacturesAchats(Token, IdFacture)

Paramètres

Nom	Type	Description	Obligatoire
Token	chaîne	Token de session obtenu via WS_1.	Oui
IdFacture	entier	ID DevVersPA de la facture à télécharger. Passer 0 pour récupérer la liste de toutes les factures en attente (sans leur contenu binaire). Passer un ID spécifique pour télécharger le contenu d'une facture précise.	Oui

Valeur de retour

Cas	Valeur retournée
IdFacture = 0	JSON listant les factures en attente (ID, fournisseur, montant, date, statut).
IdFacture > 0	Contenu du fichier Factur-X encodé en Base64 (PDF/A-3 + XML Factur-X embarqué).
Aucune facture	JSON vide ou tableau vide.
Erreur	Chaîne commençant par Erreur :.

Exemple WLangage

// ── Réception des factures d'achats ──────────────────────

// Étape 1 : lister les factures en attente
PROCÉDURE ListerFacturesAchats()

sListe est chaîne = WS_6_RecevoirFacturesAchats( ­
    gsToken,  ­// Token
    0         ­// 0 = liste des factures en attente
)

SI Gauche(sListe, 6) = "Erreur" ALORS
    Erreur("Erreur liste factures achats :" + RC + sListe)
    RETOUR
FIN

// Traiter la liste JSON (parcourir les ID de factures)
Info("Factures en attente :" + RC + sListe)

// ── Étape 2 : télécharger une facture spécifique ─────────
PROCÉDURE TéléchargerFacture(nIdFacture est entier)

sFacturX est chaîne = WS_6_RecevoirFacturesAchats( ­
    gsToken,    ­// Token
    nIdFacture  ­// ID de la facture à télécharger
)

SI Gauche(sFacturX, 6) = "Erreur" ALORS
    Erreur("Erreur téléchargement :" + RC + sFacturX)
    RETOUR
FIN

// Décoder le Base64 et sauvegarder le fichier Factur-X
sFichier est buffer = Décodage(sFacturX, encodageBase64URL)
sCheminDestination est chaîne = "C:\FacturesAchats\FAC_" + nIdFacture + ".pdf"
fSauveBuffer(sCheminDestination, sFichier)

Info("Facture " + nIdFacture + " sauvegardée : " + sCheminDestination)

// Étape 3 : accuser réception (voir WS_7)
// WS_7_EnvoyerStatut(gsToken, nIdFacture, 1) // 1 = reçue