Skip to main content
GET
Télécharger l'avis AADL

Vue d’ensemble

Diffuse l’avis de paiement qu’AADL publie pour un dossier de logement — le PDF que le locataire téléchargerait lui-même chez le facturier — pour une transaction qui vous appartient. Comme Télécharger le reçu, cet endpoint ne renvoie pas l’enveloppe JSON en cas de succès : le corps, ce sont les octets, que vous pouvez transmettre directement à votre propre client. Ce n’est pas le reçu. Le reçu prouve que votre paiement est passé ; l’avis est l’état que publie AADL pour le dossier. Seul AADL en produit un.
L’avis s’adresse par transaction, jamais par dossier de logement. Cette requête ne contient aucun codeloc, et aucun n’est accepté. Nous chargeons la transaction, vérifions qu’elle est bien la vôtre dans cet environnement, la refusons si son partner n’est pas AADL, puis lisons le dossier de logement dans la facture déjà enregistrée sur cette transaction.C’est délibéré. La page d’export d’AADL ne demande aucune session et renvoie un PDF pour n’importe quel code, existant ou non : relayer un code fourni par l’appelant transformerait cet endpoint en outil d’énumération des dossiers d’autrui. Le résoudre depuis votre propre transaction rend cela impossible.

Paramètres de chemin

string
requis
L’identifiant de transaction. Une chaîne hexadécimale minuscule de 24 caractères, issue de Obtenir une transaction par ID ou de n’importe quelle liste, appartenant à l’une de vos transactions AADL.Contrairement au reçu, la transaction n’a pas besoin d’être en SUCCESS : n’importe laquelle de vos transactions AADL ayant résolu une facture peut produire un avis.

Réponse

En cas de succès, le corps est le PDF lui-même. Lisez les en-têtes pour savoir ce que vous avez reçu.
header
requis
application/pdf.
header
requis
attachment; filename="avis_<transactionId>.pdf". Le nom est construit à partir du seul identifiant de transaction : il ne porte aucune identité de locataire.
header
requis
La taille du fichier en octets.
header
requis
private, no-store. AADL régénère l’avis à la demande et le remplace à chaque période : il n’y a rien de stable à mettre en cache — et c’est le document d’un client, jamais un document partagé.

Exemples

Réponse de succès

Le corps est binaire. Les en-têtes ressemblent à ceci :

Réponses d’erreur

Les erreurs sont renvoyées en JSON, dans la même enveloppe que pour tous les autres endpoints.
La clé était absente ou a été rejetée.
Que faire : vérifiez la clé selon le guide Authentification.
L’identifiant est inconnu, ou la transaction n’est pas la vôtre dans cet environnement.
Une clé sandbox ne voit jamais une transaction de production, et aucune des deux ne voit celle d’une autre clé. La réponse est identique dans tous les cas : l’endpoint ne confirme donc jamais l’existence de la transaction de quelqu’un d’autre.Que faire : vérifiez l’identifiant, et vérifiez que vous utilisez bien la clé avec laquelle la transaction a été créée.
La transaction est bien la vôtre, mais son partenaire ne publie pas d’avis.
Que faire : lisez d’abord partner sur la transaction et ne proposez le téléchargement que lorsqu’il vaut AADL. Pour tous les autres facturiers, c’est le reçu qu’il vous faut.
Aucun dossier de logement n’a encore été résolu sur cette transaction, ou AADL a refusé de produire le document.
Une découverte qui n’a pas encore atteint READY ne porte aucune facture : il n’y a donc rien d’où résoudre un dossier de logement.Que faire : attendez que la transaction porte une facture, puis réessayez. Un refus du facturier mérite un essai supplémentaire, pas une boucle.

À quoi sert l’avis

Montrer au client ce qu'il doit

L’avis porte le détail établi par AADL pour le dossier de logement. C’est le document que le locataire reconnaît.

Pas un substitut au reçu

Seul le reçu prouve qu’un paiement est passé. C’est celui-là qu’il faut conserver avec votre commande.
Rappelez-vous qu’un dossier de logement AADL n’a qu’un seul avis ouvert, avec ses éventuels arriérés intégrés au total : ce PDF représente donc tout ce que doit le dossier, jamais une période parmi d’autres. Voir Partenaires et comptes.

Bonnes pratiques

Vérifiez d'abord le partenaire

Ne proposez le téléchargement que pour les transactions AADL. Tous les autres partenaires répondent 404 NOT_FOUND.

N'exposez jamais l'URL

Cette URL exige votre clé API. Servez les octets depuis votre propre système, derrière votre propre authentification.

Récupérez-le au moment voulu

no-store n’est pas décoratif : AADL remplace l’avis à chaque période. Téléchargez-le quand vous en avez besoin.

N'envoyez jamais de codeloc

Il n’y a aucun paramètre d’identifiant à deviner. Si votre code en construit un, c’est qu’il appelle autre chose.

Endpoints associés

Télécharger le reçu

La preuve d’un paiement réussi

Obtenir une transaction par ID

Où apparaissent partner et les factures

Découvrir les factures

Comment un dossier de logement AADL est interrogé

Partenaires et comptes

Les règles d’identifiant AADL