# Historique des versions

## Septembre 2026

### Refonte de l'application cliente - v28.0.0.0

Nouvelle version majeure de CAP Caisse : v28.0.0.0.

La caisse a eu le droit à une refonte complète de son logiciel bureau, ainsi qu'à de nombreuses améliorations techniques et fonctionnelles. Cette nouvelle version est embarquée avec une technologie récente et est compatible avec Business Central v28.

#### Plateforme et installation

- L'application cliente devient **multi-plateforme** : elle s'installe désormais sur **Windows** et **macOS** (la v27 était limitée à Windows).
- Chaque caisse possède sa **propre base de données locale, stable et unique**, ce qui permet de **basculer facilement d'un profil de caisse à l'autre** sur un même poste, sans risque de perdre des données. Se déconnecter d'un serveur et tenter de se connecter à un profil déjà existant sur le poste repartira de la même base et ne déclenchera pas de synchronisation.
- L'application garantit qu'**une seule instance** s'exécute à la fois sur le poste, et signale automatiquement un éventuel arrêt brutal.

#### Expérience utilisateur

- Interface revue pour la rendre plus moderne, rendue **plus réactive et plus fluide**.
- Interface **multilingue français / anglais**, modifiable **sans redémarrage** et répercutée sur le second écran.
- **Thèmes** d'affichage (clair, sombre, etc.) avec **planification horaire**, **taille de police** réglable et **position des éléments** configurable.
- **Second écran client en temps réel**, avec une **vitrine** affichée lorsqu'aucun ticket n'est en cours.
- **Tableau de bord statistique configurable branché sur les données en temps réel** de la caisse (chiffre d'affaires, panier moyen, nombre de ventes, produits vendus, nouveaux clients, tops articles/catégories, répartition par catégorie et par mode de paiement, affluence moyenne), ainsi qu'un onglet **« Mes performances »** par vendeur.
- **Chargement progressif** (défilement infini) des longues listes (tickets, contacts, articles, devis, historique). Les données s'affichent par défaut sans nécessiter de recherche en amont.
- Meilleure gestion des préférences d'impression : **séparation** de la préférence d'impression entre les factures et les clôtures, en plus de l'impression ticket (la v27 appliquait le même réglage entre les factures et les clôtures).
- Des synchronisations plus complètes, plus stables et plus rapides.
- Système des mises à jour revu
- En v27, la caisse lançait une synchronisation totale après une mise à jour à l'ouverture de la page de connexion vendeur. La v28 n'applique plus cela, sauf si la mise à jour en a réellement besoin.

#### Vente et encaissement

- **Déplacement et réorganisation des lignes** du ticket, par boutons et par **glisser-déposer (drag & drop)**.
- La fiche du client par défaut est maintenant consultable, ainsi que son historique Business Central total (chargé à la volée).

#### Fidélité

- Le paiement en points est plafonné par le **reste réel à payer** du ticket, et la **date d'expiration de l'adhésion** est désormais vérifiée.
- Le **solde de points est rafraîchi en temps réel** depuis le système centralisé au moment du paiement (mesure anti-fraude) ; la validation est bloquée si le solde ne couvre plus le règlement en points.

#### Matériel (terminal de paiement, imprimante, tiroir)

- **Impression native multi-plateforme** des tickets en **ESC/POS** (série, USB et **réseau TCP/IP**), avec codes-barres, QR codes, images, réglage fin de la liaison série, détection automatique, jeu de caractères configurable, lecture de l'état de l'imprimante et test d'impression.
- **Impression PDF native** des factures, devis et clôtures, **sans dépendance à un lecteur PDF tiers** (Adobe Acrobat, Foxit) ; bascule automatique vers le PDF en cas d'échec de l'imprimante à tickets.
- **Véritable ouverture du tiroir-caisse** série (commande d'impulsion ESC/POS) — correctif par rapport à la v27.
- Communication TPE **fiabilisée** : délais d'attente maîtrisés, annulation propre, réémission en cas de message corrompu, détection automatique du port, masquage des données bancaires dans les journaux (conformité PCI).

#### Conformité (NF525)

- Le **contrôle d'antériorité** met désormais l'application dans un **état bloqué signalé à l'écran** au lieu d'afficher une alerte qui ferme brutalement l'application (même garantie d'inaltérabilité, comportement plus sûr).
- La **numérotation des tickets** s'appuie sur une souche fiabilisée et n'est plus modifiable manuellement. Correctif apporté sur la gestion de la bonne synchronisation de cette souche entre le poste et le système centralisé (Business Central) par rapport à la v27.

Identique à la v27 :
- **Impression automatique du ticket Z** à la clôture, et **blocage de la clôture** tant qu'il reste des tickets non validés.
- La **signature électronique et le chaînage** des tickets et écritures restent assurés par le **système centralisé** (Business Central) ; le poste garantit l'antériorité, l'inaltérabilité par non-suppression (corrections par écriture inverse) et la tenue du **Journal des Événements Techniques (JET)**.
- Renforcement très important des tests automatisés sur l'intégralité des traitements faits par le logiciel.

#### Robustesse et performances

- Synchronisation **« tout ou rien »** (jamais de base à moitié à jour si elle échoue avant la fin ou si l'application ou le poste s'arrêtent pendant)
- Synchronisation **plus rapide en moyenne**, malgré un volume de données plus important qu'en v27 (+10%) : on constate une amélioration moyenne d'environ 50%, et jusqu'à 80% dans les meilleurs cas.
- Fin des erreurs liées au partage des données et des plantages observés à la **sortie de veille** du poste.
- **Intervalle de synchronisation** en arrière-plan désormais **stable** à exactement 15 minutes d'intervalle (le compte à rebours démarre à partir de la fin d'une synchronisation ou après chargement de la caisse au démarrage).
- Possibilité de consulter l'historique des synchronisations. Permet de voir :
  - Le type de synchronisation (totale ou différentielle)
  - Le statut de la synchronisation (réussie ou échouée)
  - Le date et l'heure de la synchronisation (début et fin)
  - La durée totale
  - La durée par type de données par type de synchronisation (envoir, réception, écriture en base de données)
  - Le nombre d'éléments synchronisés par type de données
  - les messages d'erreur en cas d'échec de la synchronisation
- Les informations de log de la synchronisation sont désormais plus détaillées et plus lisibles, afin de faciliter leur exploitation par le support technique.

#### Synchronisation différentielle des articles bloqués

- La synchronisation des changements récupère les articles bloqués depuis la dernière synchronisation pour ne plus les proposer dans la liste des articles.

#### Fonctionnalités retirées

Quelques réglages secondaires de la v27 ne sont pas reconduits :
- la **modification manuelle du dernier numéro de ticket** (numérotation désormais fiabilisée),
- le **sélecteur de canal de mise à jour** dans l'application (chaque canal fait désormais l'objet d'un build distinct).

### Nouveau système de gestion des versions et des mises à jour

Désormais, la gestion des des mises à jour de la caisse est plus robuste, et la façon dont la version est construite a été revue.
Une version de l'application cliente :
- est constituée de 4 segments : `{Majeure}.{Mineure}.{Patch}.{Build}`.
- est compatible avec Business Central ayant la même version majeure et mineure.

Quand la version `Patch` augmente pour la version de l'application cliente, la mise à jour de la caisse est obligatoire, mais n'impacte que l'application cliente.
Quand la version `Majeure` ou `Mineure` augmente pour l'application cliente, la mise à jour de la caisse est obligatoire et impacte à la fois l'application cliente et le système centralisé (Business Central).
Pour une mise à jour de l'application cliente vers une version qui augmente la version majeure ou mineure, il est nécessaire de mettre à jour Business Central vers la version compatible (même version majeure et mineure) avant de mettre à jour l'application cliente.

Les notifications de mise à jour obligatoire bloqueront l'utilisation de la caisse tant que celle-ci n'est pas mise à jour.

Enfin, une mise à jour est totalement gérée par le logiciel : découverte, téléchargement, mise à jour et redémarrage.

### Système centralisé (Business Central) - v28

Le système centralisé a évolué en parallèle de l'application cliente pour la v28.

#### Configuration de la caisse et des vendeurs

- **Second écran client** : vous pouvez désormais définir, sur la fiche de la caisse, un **texte** et une **image** d'accueil affichés sur l'écran client (vitrine). L'image est automatiquement redimensionnée.
- **Personnalisation des vendeurs** : chaque vendeur peut recevoir un **nom d'affichage** (surnom) et une **photo de profil**, repris sur l'application cliente. La photo de profil accepte la transparence. JPEG, JPG et PNG sont supportés. La photo est automatiquement redimensionnée.
- La fiche caisse expose désormais la **langue**, la **locale** et la **devise** à l'application cliente, ainsi qu'une option permettant d'**ignorer le blocage d'un article** lors de l'encaissement.

#### Disposition des touches

- Deux nouvelles actions de disposition des touches : **Monter la ligne** et **Descendre la ligne**, pour réordonner les lignes du ticket depuis la caisse.

#### Articles et catégories

- Les **catégories d'articles** sont exposées à l'application cliente (avec un champ **couleur** réservé à un usage futur, utilisé notamment pour les statistiques par catégorie), et chaque article référence sa **catégorie**.
- Le statut **bloqué / bloqué en caisse** des articles est exposé pour fiabiliser la **synchronisation différentielle**.

#### Tickets et règlements

- La **remise facture en pourcentage** est désormais portée par l'en-tête du ticket (en plus du montant), et les montants nets / bruts (HT/TTC) sont distingués de façon cohérente dans l'API.
- Une **API dédiée** permet de récupérer le **dernier numéro de ticket** de la souche active d'une caisse (séquence continue NF525).

#### API et intégration

- L'**API cliente** a été consolidée : l'**APIV2** devient le contrat principal (en-têtes plus riches, groupes de comptabilisation revus), l'**APIV1** des mêmes endpoints restant disponible mais dépréciée pour compatibilité.
- Une **documentation technique complète** de l'application serveur a été ajoutée (configuration, caisses, dispositions des touches, tickets, comptabilisation, présentations, signatures, archive fiscale, API…).

#### Conformité (NF525)

- La **couverture de tests automatisés** a été fortement renforcée sur les **signatures**, l'**intégrité des données** et l'**archive fiscale**, et les mécanismes de conformité (chaîne de signatures, archive fiscale) sont désormais **formellement documentés**.

## Versions antérieures

Pour consulter l'historique des changements lié à la version antérieure, reportez-vous à l'[historique des changements v27](../v27/changelog.md)