Intégration REST : déclencher le rapprochement depuis vos systèmes

Vue stylisée : requête vers l’API de run de session, réponse immédiate ou mise en file selon la configuration.

Ce guide s’adresse aux équipes techniques qui enchaînent la clôture avec des traitements automatiques. Il décrit comment lancer une exécution de rapprochement pour une session déjà créée dans Ninon, sans repasser par le parcours métier du tableau de bord.

Authentification

Deux modes : session utilisateur avec un rôle autorisé à agir sur la session (admin ou member du groupe ; le rôle viewer est refusé pour cet endpoint), ou appel machine avec l’en-tête Authorization: Bearer suivi du secret de run fourni à votre DSI dans la documentation de déploiement Ninon. L’identifiant dans l’URL doit être une session appartenant à votre organisation.

Déclencher un run

Méthode POST. Chemin /api/reconciliation/[sessionId]/run — remplacez [sessionId] par l’UUID de la session (celui du tableau de bord). Le corps de la requête peut être vide.

Réponses HTTP

Lorsqu’une file de jobs d’arrière-plan est configurée sur l’hébergement et que vous ne forcez pas le mode synchrone, la réponse est HTTP 202 avec queued: true et des identifiants de file. Sinon le traitement s’exécute dans la requête : HTTP 200 avec queued: false et des statistiques. Pour forcer l’exécution synchrone même avec une file, utilisez le paramètre de requête sync=1 ou l’en-tête x-sync-matching: true. Sans file configurée, le comportement reste synchrone (200).

Workers Inngest

Les déploiements hébergés qui traitent des traitements d’arrière-plan exposent un point d’accès worker à un chemin fixe sous ce site (voir le guide d’exploitation hébergement). Ce point d’accès est distinct de l’appel métier qui déclenche un rapprochement pour une session.