Comment PayoutStory calcule un rapprochement

Une équation contrôlée versement par versement

Le moteur part du versement, identifié par sa référence, puis rassemble uniquement les mouvements qui portent cette même référence ou qui lui sont reliés sans ambiguïté par un relevé. Il additionne ces composantes avec leur signe et soustrait leur total au montant versé. L’invariant reste donc toujours vérifiable : somme des mouvements + résiduel = versement.

Quatre conclusions sont possibles. « Rapproché » signifie que l’écart respecte la tolérance. « Écart » signale un résiduel supérieur à cette tolérance. « Partiellement rapproché » indique qu’une référence attendue manque. « Données insuffisantes » signifie qu’aucun mouvement exploitable ne permet de conclure.

• Vente et versement : montants positifs attendus.
• Remboursement, frais de plateforme et affiliation : montants négatifs attendus.
• Expédition, promotion et ajustement : signe conservé selon la source et la règle explicitement choisie.
• Devise unique par analyse : aucune conversion implicite n’est réalisée.

Pas d’arrondi silencieux

Les montants sont convertis en unités monétaires entières avant le calcul : en EUR, 10,25 € devient 1 025 centimes. Les additions et soustractions utilisent ensuite ces entiers, ce qui évite les erreurs binaires classiques des nombres à virgule flottante.

Pour un montant en EUR lu avec deux décimales, une valeur comportant davantage de décimales est refusée au lieu d’être arrondie en secret. La tolérance par défaut est d’une unité mineure : un résiduel de −0,01 €, 0,00 € ou +0,01 € peut être classé rapproché ; −0,02 € ou +0,02 € reste un écart.

Signes, doublons et rattachements sont des contrôles bloquants

Une vente négative, un remboursement positif ou un versement dupliqué n’est pas automatiquement corrigé. PayoutStory remonte une erreur afin que la convention du fichier soit vérifiée. Dans le parcours d’association manuelle, l’utilisateur choisit explicitement de conserver, inverser ou imposer le signe d’une colonne.

Le moteur bloque les identifiants d’écriture dupliqués, plusieurs versements portant le même identifiant, les composantes orphelines et les fichiers source identiques déposés plusieurs fois. Cette détection ne prétend pas reconnaître deux transactions métier identiques qui auraient des identifiants différents dans deux exports : ce cas reste à contrôler dans la source.

Les catégories inconnues restent visibles

Lorsqu’un adaptateur reconnu rencontre un libellé non classé, la ligne n’est pas transformée au hasard en vente ou en frais. Elle conserve la catégorie « inconnue », sa valeur et son lignage, contribue au contrôle arithmétique si elle est correctement rattachée, et ajoute une réserve visible au résultat.

Pour un format configuré manuellement, chaque colonne financière doit au contraire être classée ou ignorée explicitement. Une colonne ignorée n’entre jamais dans le total. La confirmation anti-double-comptage demandée à l’utilisateur documente son choix de granularité ; elle ne constitue pas une preuve automatique que deux colonnes ne se recouvrent jamais.

Un traitement local, avec des limites explicites

Dans le parcours CSV/XLSX, la lecture, le calcul et la génération du classeur s’exécutent dans le navigateur. Les rapports bruts restent sur l’appareil ; aucun compte n’est nécessaire. Le résultat conserve pour chaque mouvement le fichier, la feuille, la ligne, la valeur d’origine et la règle appliquée afin que le calcul puisse être repris.

PayoutStory rapproche uniquement les données déposées. Il ne vérifie pas que TikTok a fourni toutes les opérations, ne consulte pas le compte bancaire, ne choisit pas les comptes comptables, ne calcule pas la TVA et ne certifie pas un export vendeur France. Un résiduel nul doit donc être lu avec les réserves et les justificatifs disponibles.