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

Intégration
1

Bonjour,

J’automatise la création d’entrées dans mon livre de recettes via l’API (depuis 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.