Guide Collect
Structure d’une demande, participants, vérification au dépôt, relances et export. Dans l’application, Collect correspond aux Dépôts.
Structure d’une demande
Une demande est composée de pièces, regroupées par participant. Une pièce peut exiger plusieurs fichiers (par exemple recto et verso) et peut être conditionnelle (« si le bien est en copropriété »).
Critères de vérification
Par pièce : extension, taille, nom de fichier et nombre de fichiers. Dans l’API, ces critères s’écrivent sous forme d’expression rules :
extension:eq:pdf|and|size:lt:5000000
Un fichier type (slot_type) porte ses règles par défaut et ses motifs de refus.
Refus motivés
Chaque motif de refus a un intitulé et un message affiché au déposant, par exemple Signature — Le document n’est pas signé. Le déposant comprend ce qui ne va pas et redépose aussitôt.
Vérification automatique au dépôt
Un motif marqué llm: true est évalué au moment du dépôt : s’il se déclenche, le fichier est refusé, aucun fichier n’est créé et l’événement upload.refused est émis. Un motif llm: false est proposé lors de la revue manuelle. La décision finale reste toujours la vôtre.
Relances
Un scénario est attaché à chaque modèle : délais (J+3, J+7, J+14), canal (e-mail, SMS), message. Il s’arrête automatiquement pour chaque pièce reçue. Relance manuelle possible par participant, par dossier ou en groupe.
Dépôts récurrents
Une récurrence crée et envoie le dépôt automatiquement à intervalle régulier : chaque mois, trimestre ou année. C’est le cas typique de la TVA du mois ou des notes de frais.
Récupérer les fichiers
Depuis l’application, un dossier complet s’exporte en .zip. Par l’API : GET /deposits/{public_id}/uploads liste les fichiers reçus, puis GET /uploads/{id}/download renvoie le fichier. Pour être prévenu sans interroger l’API, abonnez-vous à upload.created et deposit.directory.completed (webhooks).