Fichiers et documents - Documentation - Arrhes

Stockage

Fichiers, pièces justificatives et organisation en dossiers

Fichiers

Les fichiers sont les pièces justificatives rattachées à un exercice comptable. Le stockage utilise des URLs signées compatibles S3.

POST/organizations/:idOrganization/years/:idYear/files
Content-Type: application/jsonAuthorization: Bearer <clé>
NomTypeRequis
idFolderstringnon
referencestringnon
namestringoui
hashstringnon
GET/organizations/:idOrganization/years/:idYear/files
Content-Type: application/jsonAuthorization: Bearer <clé>
Aucun champ requis
GET/organizations/:idOrganization/years/:idYear/files/:idFile
Content-Type: application/jsonAuthorization: Bearer <clé>
NomTypeRequis
idFilestringoui
PATCH/organizations/:idOrganization/years/:idYear/files/:idFile
Content-Type: application/jsonAuthorization: Bearer <clé>
NomTypeRequis
idFilestringoui
referencestringnon
namestringnon
datestringnon
idFolderstringnon
DELETE/organizations/:idOrganization/years/:idYear/files/:idFile
Content-Type: application/jsonAuthorization: Bearer <clé>
NomTypeRequis
idFilestringoui
POST/organizations/:idOrganization/years/:idYear/files/:idFile/upload-url
Content-Type: application/jsonAuthorization: Bearer <clé>
Générer une URL signée pour uploader un fichier. Taille maximale : 50 Mo.
NomTypeRequis
idFilestringoui
typestringoui
sizenumberoui
POST/organizations/:idOrganization/years/:idYear/files/:idFile/download-url
Content-Type: application/jsonAuthorization: Bearer <clé>
Générer une URL signée pour télécharger un fichier.
NomTypeRequis
idFilestringoui
POST/organizations/:idOrganization/years/:idYear/files/:idFile/delete-url
Content-Type: application/jsonAuthorization: Bearer <clé>
Générer une URL signée pour supprimer un fichier.
NomTypeRequis
idFilestringoui
POST/organizations/:idOrganization/years/:idYear/files/:idFile/finalize
Content-Type: application/jsonAuthorization: Bearer <clé>
Finaliser l'upload d'un fichier après avoir utilisé l'URL signée PUT.
NomTypeRequis
idFilestringoui
POST/organizations/:idOrganization/years/:idYear/files/:idFile/ocr
Content-Type: application/jsonAuthorization: Bearer <clé>
Lancer la reconnaissance optique de caractères (OCR) sur un fichier. Nécessite des pages OCR disponibles.
NomTypeRequis
idFilestringoui
Attention
La taille maximale par fichier est de 50 Mo. Au-delà, l'API retourne une erreur 400.

Dossiers

Les dossiers permettent d'organiser les fichiers au sein d'un exercice. Ils supportent une hiérarchie imbriquée via le champ idFolderParent.

POST/organizations/:idOrganization/years/:idYear/folders
Content-Type: application/jsonAuthorization: Bearer <clé>
NomTypeRequis
idFolderParentstringnon
namestringoui
GET/organizations/:idOrganization/years/:idYear/folders
Content-Type: application/jsonAuthorization: Bearer <clé>
Aucun champ requis
GET/organizations/:idOrganization/years/:idYear/folders/:idFolder
Content-Type: application/jsonAuthorization: Bearer <clé>
NomTypeRequis
idFolderstringoui
PATCH/organizations/:idOrganization/years/:idYear/folders/:idFolder
Content-Type: application/jsonAuthorization: Bearer <clé>
NomTypeRequis
idFolderstringoui
namestringnon
idFolderParentstringnon
DELETE/organizations/:idOrganization/years/:idYear/folders/:idFolder
Content-Type: application/jsonAuthorization: Bearer <clé>
NomTypeRequis
idFolderstringoui