v2.3.2

Notes de version – ExoConnect API `v2.3.2`

Date de publication : 2026-04-30
Statut : ✅ Stable
Type de mise à jour : Amélioration / Correctif
Compatibilité : Compatible avec le gestionnaire/API v2.3.0+
Lien de la version précédente : v2.3.0

Nouvelles fonctionnalités

Pré-validation des références de factures sur les paiements clients (POST /api/customers/payments)

Les invoice_ar_id inexistants ou appartenant à un autre client sont désormais rejetés avec un 404 ou 422 explicite (ex. "0Comptoir (id:1)"), avant l'acquisition du lock COM.

Remplace l'ancienne erreur Filer 42 (409) cryptique. Les règles métier (solde, statut, current_day) restent gérées par le SDK pour éviter la dérive cache/réalité.

Réf. CT-0313.

Lecture cache-first sur l'inventaire : GET /api/inventory/category-items et GET /api/inventory/product-items servent désormais depuis le cache local lorsqu'aucun filtre avancé n'est appliqué (chemin SDK direct préservé pour les requêtes filtrées).

Améliorations

Timeouts upstream relevés à 300 s sur le relais et le proxy superviseur (auparavant 20 s/120 s) — supporte les opérations longues comme l'aging client.

Code customer.code ajouté au cache invoice_ar : le code propriétaire est disponible sans lookup secondaire une fois les enregistrements ré-indexés (fallback transparent pour les anciens enregistrements).

Refonte de product_items : passe d'une accumulation full-memory à paginate_sdk_interface — prévient les crashs OOM observés à fort volume.

Correctifs

Sync worker — entités superflues retirées (réduction notable du volume de scan SDK par cycle) :

product_suppliers (~74 K enregistrements/cycle, aucun consommateur du cache, pas d'index modifié SDK).

product_categories (doublon strict de categories).

product_serials (volume massif, accumulation mémoire → crash enfant observé en test client).

product_components (aucune propriété TimeModified côté SDK).

Nettoyage supplier_payment_lines : entité désormais correctement déclarée dans REMOVED_INDEXING_ENTITIES (élimine le statut « missing » résiduel).

Purge automatique des lignes IndexingRecord / IndexingStatus / IndexingEntityPolicy au prochain démarrage pour les 4 entités retirées.

Sécurité / Permissions

Clés API en lecture seule autorisées sur les opérations runtime /system/indexing/* et /system/sync/* (toggle indexation, déclenchement de sync, gestion des fenêtres). Les routes métier /api/* continuent d'exiger scope_write=true — il s'agit ici de contrôles d'opérations runtime, pas de CUD sur les données Acomba.

Ruptures de compatibilité

Aucune.

⚠️ Note opérationnelle : les caches SDK des entités product_suppliers, product_categories, product_serials, product_components sont supprimés au démarrage. Les endpoints concernés continuent de fonctionner via lecture SDK directe (et cache pour category_items / product_items).

Informations techniques

UPSTREAM_TIMEOUT_SECONDS : 300 s (relais + superviseur).

REMOVED_INDEXING_ENTITIES enrichi des 4 entités ci-dessus.

Helper alias map (helpers/helper_service.py) nettoyé en conséquence.

Recommandation

Mise à jour fortement recommandée pour tous les clients — réduit significativement la durée et la charge mémoire des cycles de synchronisation, améliore les diagnostics côté paiements clients, et débloque les opérations longues (aging) précédemment coupées par les timeouts.

Notes de version – ExoConnect API v2.3.2#

Nouvelles fonctionnalités#

Améliorations#

Correctifs#

Sécurité / Permissions#

Ruptures de compatibilité#

Informations techniques#

Recommandation#