Files

La section Files permet d’échanger des fichiers CSV avec Estaly pour notifier des évènements en batch (ex : création de contrats, annulations, création de ventes brutes).

Le principe est le suivant :

1. Votre système appelle Estaly pour générer des URLs d’upload signées (valides 30 minutes).
2. Vous uploadez ensuite les fichiers CSV via les URLs fournies (HTTPS).
3. Estaly traite les fichiers déposés.

ENDPOINTS

• POST /api/v2/organization/files/upload_urls (BULK) : Génère des URLs d’upload signées (valides 30 minutes) pour déposer un ou plusieurs fichiers CSV (ex : plans, cancellations, vouchers)..

---

Spécifications CSV

Format général

• Format : CSV (UTF-8)
• Délimiteur : ;
• Entêtes : oui (1ère ligne obligatoire)
• Décimaux : . (point) pour les montants (ex : 149.00)
• Dates : YYYY-MM-DD (ISO 8601)
• Valeurs vides : champ vide ("") accepté pour les champs optionnels
• Fin de ligne : LF (\n). CRLF (\r\n) accepté.