RouteurStable

Propose payment allocation

Analyse les créances ouvertes d’une entreprise et propose des allocations candidates pour un montant reçu, puis route selon la qualité factuelle du matching.

Contexte financier
Propose payment allocation
Finance
Résultat typé

Vue d’ensemble

Analyse les créances ouvertes d’une entreprise et propose des allocations candidates pour un montant reçu, puis route selon la qualité factuelle du matching.

Exemple

Recevoir 1 000 EUR sans référence exploitable et déterminer s’ils correspondent exactement à une facture, à plusieurs factures, à un sous-paiement ou à une situation ambiguë.

Routes de décision

exact_match

Match exact

Une allocation candidate explique exactement le montant avec une correspondance factuelle suffisante.

Action recommandéeAppliquer la proposition avec reconcile_payment si votre politique n’exige pas de revue supplémentaire.
underpayment

Sous-paiement

Le montant reçu est inférieur au montant de la cible la plus plausible.

Action recommandéeDécider si le paiement partiel doit être appliqué ou revu manuellement.
overpayment

Surpaiement

Le montant reçu dépasse le montant des créances candidates retenues.

Action recommandéeAppliquer seulement une allocation conforme à votre politique et traiter explicitement le reliquat.
ambiguous

Ambigu

Plusieurs allocations plausibles restent en concurrence sans vainqueur suffisamment factuel.

Action recommandéeDemander une revue ou utiliser des données supplémentaires avant toute application.
unmatched

Sans correspondance

Aucune allocation candidate exploitable n’a été trouvée dans les contraintes configurées.

Action recommandéeÉlargir les données de recherche ou marquer explicitement le paiement unmatched selon votre processus.

Paramètres 11

companyRequisCompany
Entreprise acheteuse utilisé comme contexte de l’intention de paiement ou du rapprochement.
amountRequisamount
Montant de l’opération en unités monétaires mineures. Lorsqu’il est optionnel, le node peut utiliser le montant résiduel défini par son contrat.
currencyRequiscurrency code
Devise ISO 4217 utilisée pour interpréter tous les montants de l’opération.
invoiceOptionnelInvoice
Facture utilisée pour borner ou dériver le contexte financier de l’opération.
orderOptionnelOrder
Commande utilisée pour borner ou dériver le contexte financier de l’opération.
source_referenceOptionnelstring
Référence durable de votre système utilisée pour corrélation ou idempotence lorsque l’opération la supporte.
invoice_window_past_daysOptionnelinteger
Fenêtre passée dans laquelle les factures ouvertes restent candidates au rapprochement.
invoice_window_future_daysOptionnelinteger
Fenêtre future admise pour les factures candidates lorsque la politique le permet.
max_invoices_per_combinationOptionnelinteger
Nombre maximal de factures combinées dans une proposition candidate.
max_line_items_per_combinationOptionnelinteger
Nombre maximal de lignes de facture considérées dans une combinaison candidate.
max_candidatesOptionnelinteger
Nombre maximal de propositions alternatives conservées pour le résultat du matching.

Sorties 2

selected_routeenum
Route de matching choisie à partir du résultat factuel de la proposition d’allocation.
allocation_proposalreceivable allocation
Proposition structurée d’allocation du montant reçu, avec la meilleure combinaison et les informations nécessaires pour décider de l’appliquer ou non.

Comportement

Le node recherche les factures candidates dans les fenêtres configurées, limite la combinatoire puis retourne la meilleure proposition et une route décrivant le résultat du matching.

À retenir Distinguez toujours l’objet canonique créé par Ormuz de l’effet externe éventuel. Une intention de paiement ou de remboursement au statut draft ne prouve pas qu’un provider a exécuté le mouvement de fonds.

Limites et responsabilités

  • Le node propose une allocation ; il ne modifie aucun solde tant que reconcile_payment n’est pas exécuté.
  • Les limites de fenêtres et de combinatoire influencent les candidats considérés : elles doivent être dimensionnées selon votre volume et votre politique de matching.