# API — Joindre un justificatif (PDF) à une entrée du livre de recettes via POST /incomeBook

**URL:** <https://community.abby.fr/t/api-joindre-un-justificatif-pdf-a-une-entree-du-livre-de-recettes-via-post-incomebook/2081>\
**Category:** Intégration\
**Tags:** facture\
**Created:** [Octobre 18, 2026, 6:09 UTC](https://community.abby.fr/t/api-joindre-un-justificatif-pdf-a-une-entree-du-livre-de-recettes-via-post-incomebook/2081 "2026-10-18T18:09:58Z")\
**Posts on this page:** 1\
**Page:** 1

<div class="post-metadata">

**Author:** ![Michael](https://avatars.discourse-cdn.com/v4/letter/m/4bbf92/32.png) [@Michael](https://community.abby.fr/u/Michael)\
**Post date:** [Octobre 18, 2026, 6:09 UTC](https://community.abby.fr/t/api-joindre-un-justificatif-pdf-a-une-entree-du-livre-de-recettes-via-post-incomebook/2081/1 "2026-10-18T18:09:58Z")

</div>

Bonjour,

J’automatise la création d’entrées dans mon livre de recettes via l’API (depuis [Make.com](http://Make.com), module « Faire un appel API »). La création fonctionne très bien :

`POST /incomeBook` avec `client`, `priceWithoutTax` / `priceTotalTax` (en **centimes** ), `productType`, `vatId`, `paidAt`, `paymentMethodUsed` (`{ "value": 8, "other": "Mollie" }` pour « Autre »), `reference` → l’entrée est bien créée.

Je cherche maintenant à **joindre automatiquement le justificatif PDF** (le champ « Associez un nouveau document » visible dans l’interface). Le schéma `CreateIncomeBookItemDto` mentionne un champ `file` de type `object`, mais sans détail sur sa structure. J’ai testé deux approches, sans succès :

1. `"file": { "name": "facture.pdf", "url": "data:application/pdf;base64,<contenu>" }`  
→ un document apparaît bien comme attaché à l’entrée, mais au clic sur « télécharger » un onglet vide s’ouvre (le fichier ne s’affiche pas).
2. `"file": { "name": "facture.pdf", "mimeType": "application/pdf", "data": "<base64>", "content": "<base64>" }`  
→ aucun document exploitable, rien ne se passe au clic.

J’en déduis que le téléchargement s’appuie uniquement sur `file.url` et attend une **URL d’un fichier réellement hébergé** , pas un contenu inline.

**Mes questions :**

1. Quelle est la **structure exacte attendue** par le champ `file` d’une entrée du livre de recettes ?
2. Faut-il d’abord **uploader le document** via un endpoint dédié (type « asset ») qui renvoie une URL/clé à placer ensuite dans `file` ? Si oui, quels sont la **méthode, l’URL et le format** de cet endpoint (JSON base64 ou multipart/form-data) ?
3. Existe-t-il un exemple de payload complet pour créer une entrée **avec** son justificatif en un seul appel ?

Merci d’avance pour votre aide.