Téléchargement de Fichiers

Le SDK Smartbills supporte deux méthodes de téléchargement : les téléchargements directs via FormData et les téléchargements par URL présignée pour les fichiers volumineux. Les deux méthodes sont disponibles pour les dépenses, les factures et les logos de fournisseurs.

Téléchargements FormData

L’approche la plus simple, construisez un objet FormData et passez-le à la méthode de téléchargement. Le SDK gère automatiquement l’encodage multipart et les en-têtes content-type.

Télécharger des reçus de dépenses

// Environnement navigateur
const fileInput = document.querySelector('input[type="file"]');
const formData = new FormData();
for (const file of fileInput.files) {
  formData.append('files', file);
}

const results = await client.expenses.uploadBusiness(formData);
for (const result of results) {
  console.log(`Dépense créée : ${result.id}`);
}

Téléchargement en Node.js

import { readFileSync } from 'fs';

const formData = new FormData();
const fileBlob = new Blob([readFileSync('/chemin/vers/reçu.pdf')], {
  type: 'application/pdf',
});
formData.append('files', fileBlob, 'reçu.pdf');

const results = await client.expenses.uploadBusiness(formData);

Portees de téléchargement

// Pour l'entreprise (administrateur)
const businessResults = await client.expenses.uploadBusiness(formData);

// Pour un employé spécifique
const employéeResults = await client.expenses.uploadEmployée(employéeId, formData);

// Pour l'utilisateur courant
const myResults = await client.expenses.uploadMy(formData);

Télécharger des documents de facture

const formData = new FormData();
formData.append('files', pdfFacture);

const results = await client.bills.upload(formData);

Validation avant téléchargement

Validez les fichiers sans créer d’enregistrements :

const formData = new FormData();
formData.append('files', fichierRecu);

try {
  await client.expenses.validateBusiness(formData);
  console.log('Fichier valide, téléchargement en cours');
  const results = await client.expenses.uploadBusiness(formData);
} catch (error) {
  console.error('Validation échouée :', error);
}

Téléchargements par URL présignée

Pour les fichiers volumineux ou les téléchargements directs vers le stockage cloud.

Fonctionnement

Presigner: demander une URL présignée à l’API
Télécharger: télécharger le fichier directement vers l’URL présignée
Confirmer: notifier l’API que le téléchargement est terminé

Exemple étape par étape

// Étape 1 : Demander une URL presignee
const presigned = await client.expenses.presignUpload({
  fileName: 'gros-reçu.pdf',
  contentType: 'application/pdf',
  fileSize: fileBuffer.byteLength,
});

// Étape 2 : Télécharger vers l'URL presignee
const uploadResponse = await fetch(presigned.url, {
  method: 'PUT',
  body: fileBuffer,
  headers: { 'Content-Type': 'application/pdf' },
});

if (!uploadResponse.ok) {
  throw new Error(`Téléchargement échoué : ${uploadResponse.statusText}`);
}

// Étape 3 : Confirmer le téléchargement
await client.expenses.confirmUpload({
  key: presigned.key,
  fileName: 'gros-reçu.pdf',
});

Téléchargements présignés par employé

const presigned = await client.expenses.presignEmployéeUpload(employéeId, {
  fileName: 'reçu.jpg',
  contentType: 'image/jpeg',
  fileSize: fileBuffer.byteLength,
});

// Télécharger vers l'URL presignee...

await client.expenses.confirmEmployéeUpload(employéeId, {
  key: presigned.key,
  fileName: 'reçu.jpg',
});

Logos de fournisseurs

// Fournisseur au niveau utilisateur
const updated = await client.vendors.uploadLogo(vendorId, fichierLogo);

// Fournisseur au niveau entreprise
const updated = await client.vendors.uploadBusinessLogo(vendorId, fichierLogo);