Notes de Version de l'API 0.1.214

Build 0.1.214 · PAR POS v5.15r2 · Historique des versions v4.0 · Mars 2026

Rapport de modification de l'API : v5.15 → v5.15r2

Aucune modification majeure dans cette version. Toutes les modifications sont entièrement rétrocompatibles. Les intégrations existantes ne nécessitent aucune modification de code.

Portail API et documentation

La documentation complète de l'API, incluant des exemples de messages, des définitions de schémas et des descriptions de champs, est disponible sur le portail développeur PAR.

Bonnes pratiques en matière d'API

Taux de requête et traitement par lots

Les requêtes par lots doivent être séquentielles. Si les systèmes des clients finaux autorisent le traitement multithread, veuillez respecter les limites de requêtes par minute (RPM) recommandées ci-dessous.

Les modifications doivent d'abord être publiées et testées sur un seul emplacement, puis déployées sur d'autres emplacements.

Si des modifications sont effectuées en parallèle à plusieurs emplacements, seules les modifications d'enregistrements individuels doivent être exécutées ; les opérations par lots ne sont pas recommandées dans les scénarios parallèles.

Les modifications apportées à un emplacement ne doivent pas être répercutées simultanément sur plus de 500 emplacements.

Limites de débit (applicables à la fois à la publication en fin de journée et à la publication immédiate)

Groupe de points de terminaison Taille maximale du lot RPM max
SaveItems, SaveDestinations, SaveTaxes 100 5
DeleteItems, DeleteDestinations, DeleteTaxes 20 5
SavePriceChange / DeletePriceChange Non recommandé (un seul enregistrement) —

API Build 0.1.214 — Nouveautés

Correctifs de bogues signalés sur le terrain

IDENTIFIANT Description
AS1-3556 Erreur d'autorisation IAM Kinesis Firehose résolue sur l'API SOAP. Les services de l'API SOAP (Data, Order et Settings) ont commencé à générer des erreurs AmazonKinesisFirehoseException. Le rôle de nœud Kubernetes assumé par les services de l'API n'était pas autorisé à effectuer firehose: PutRecord sur le flux de livraison Firehose de télémétrie, ce qui empêchait la consignation des données de télémétrie de l'API sur tous les points de terminaison SOAP et sur les services de monétisation REST. Les autorisations IAM ont été corrigées afin d'accorder au rôle de nœud l'action firehose: PutRecord nécessaire sur le flux de télémétrie. Après le déploiement du correctif, les erreurs AmazonKinesisFirehoseException n'ont plus été observées, et il est confirmé que les requêtes de l'API sont consignées avec succès sur tous les services touchés (SOAP Data, SOAP Order, SOAP Settings, REST Data, REST Order, REST Settings et monétisation de l'API). Aucune modification de la structure des requêtes ou des réponses de l'API n'est requise ; les intégrations existantes ne sont pas touchées.

API Build 0.1.213 — Nouveautés

Correctifs de bogues et améliorations

IDENTIFIANT Description
AS1-3480

Nouveau point de terminaison Close Order ajouté. Un nouveau point de terminaison a été ajouté à l'API externe Brink, permettant aux systèmes externes de fermer par programmation une commande ouverte au moyen de son identifiant.

  • POST /v1/orders/{id}/close

Codes de réponse :

  • 200 OK (succès),

  • 400 Bad Request (commande déjà fermée, solde encore dû, commande pas encore envoyée à la cuisine ou requête invalide)

  • 404 Not Found (commande introuvable)

  • 504 Gateway Timeout (aucune réponse du magasin)

  • 401/403/500/503 pour les erreurs d'authentification, d'autorisation ou de serveur.

Remarque : toute tentative de fermer une commande dont le solde est impayé ou qui n'a pas encore été envoyée à la cuisine entraînera une erreur 400 ; assurez-vous que ces conditions sont réglées avant d'appeler le point de terminaison.

Des fichiers binaires mis à jour pour le service de commandes du magasin (Store Ordering Service) et le service en magasin (In-Store service) ont été déployés.

AS1-3540

Erreur d'article composite dans Get Orders résolue. Un bogue qui faisait renvoyer à l'API Get Orders une erreur générique UnknownError lors de la récupération de commandes historiques contenant certains articles de menu composites (combos) a été corrigé.

Trois scénarios précis sont maintenant traités correctement :

  1. Articles composites dont le parent n'a aucune taxe définie au niveau du parent

  2. Plusieurs articles enfants partageant le même type de taxe

  3. Articles enfants faisant référence à un parent inexistant.

Les commandes touchées sont maintenant renvoyées avec succès.

Aucune modification de la structure des requêtes ou des réponses de l'API n'est requise ; les intégrations existantes bénéficient automatiquement de ce correctif.

AS1-3558 Les enregistrements supprimés ne sont plus renvoyés par l'API Settings. Le service Settings incluait à tort dans les réponses de l'API des employés, des postes, des niveaux de sécurité et des permissions supprimés. Ce problème est résolu — seuls les enregistrements actifs et non supprimés sont maintenant renvoyés.

API Build 0.1.212 — Nouveautés

Correctifs de bogues et améliorations

IDENTIFIANT Description
AS1-3481 Point de terminaison CloseOrder — modifications du service de commandes au niveau supérieur (Above Store Ordering Service). Correctif côté serveur mettant en œuvre les modifications du service de commandes au niveau supérieur requises pour prendre en charge le nouveau point de terminaison CloseOrder (AS1-3474). Le service de commandes a été mis à jour pour traiter les demandes de fermeture de commande par programmation, en validant que l'identifiant de commande existe et que la commande est actuellement ouverte avant de faire passer son statut à Closed.
AS1-3540 Échec de GetOrders sur Admin6 résolu. Un appel à l'API GetOrders renvoyait le ResultCode 1 (erreur inconnue) pour une date comptable précise, ce qui empêchait la récupération des données de commandes. Le problème de données sous-jacent à l'origine de l'échec a été corrigé, et GetOrders renvoie maintenant les résultats avec succès pour la date comptable touchée.

API Build 0.1.211 — Nouveautés

Correctifs de bogues et améliorations

IDENTIFIANT Description
POG-3154 État de pointage à l'entrée indéfini résolu. Un bogue faisait en sorte que certains employés demeuraient pointés à l'entrée indéfiniment, sans heure de sortie enregistrée, ce qui faisait planter le Portail d'administration lors de la modification des quarts touchés et perturbait les rapports de paie. Le service de gestion des quarts a été mis à jour pour traiter correctement les enregistrements de pointage à l'entrée incomplets, ce qui évite les plantages lors de la modification des quarts et élimine les répercussions en aval sur la paie. Des mesures de protection ont également été ajoutées pour empêcher que ce scénario ne se reproduise.
AS1-3474 Nouveau point de terminaison de l'API : fermeture de commande par programmation. Auparavant, la fermeture des commandes était entièrement contrôlée par le paramètre Fermeture automatique de l'Éditeur de paramètres (activé : les commandes sont fermées à l'envoi à la cuisine ; désactivé : une fermeture manuelle est requise). Un nouveau point de terminaison de l'API permet maintenant aux intégrateurs de fermer des commandes par programmation. Avant le traitement, le point de terminaison valide que l'identifiant de commande existe et est valide, et que la commande associée est actuellement ouverte. Une fois ces deux vérifications réussies, le statut de la commande est mis à jour à Closed. Les intégrateurs bénéficient ainsi d'un meilleur contrôle de la gestion des commandes, tout en évitant les tentatives de fermeture invalides ou en double.

API Build 0.1.210 — Nouveautés

Correctifs de bogues et améliorations

IDENTIFIANT Description
AS1-3403 Optimisation de la mémoire pour les requêtes de grands ensembles de données. Les services CloudAPI consommaient auparavant beaucoup de mémoire lors du traitement de grands ensembles de données tels que les articles, les promotions et les groupes d'articles, ce qui nuisait à la performance. L'utilisation de la mémoire a été optimisée pour ces appels, ce qui se traduit par une réduction constante de 25 à 30 % des allocations dans les différents services et par une meilleure stabilité avec de grands volumes de données.

API Build 0.1.209 — Nouveautés

Correctifs de bogues et améliorations

IDENTIFIANT Description
AS1-3397 Amélioration de la vérification de disponibilité (readiness) des contrôles de santé. Les contrôles de santé de CloudAPI pouvaient auparavant signaler « en bonne santé » alors que le service était encore en cours de démarrage (avant le préchauffage des caches ou l'établissement des connexions), ce qui contribuait à des erreurs 5xx/502 intermittentes lors des déploiements ou des redémarrages. Les contrôles de santé sont maintenant liés à une vérification de disponibilité plus stricte — le service ne signale qu'il est en bonne santé qu'une fois entièrement prêt à accepter du trafic — ce qui réduit les erreurs passagères pendant les déploiements.

API Build 0.1.208 — Nouveautés

Correctifs de bogues et améliorations

IDENTIFIANT Description
AS1-3384 Validation de SaveItems alignée sur le noyau POS. Les requêtes de l'API SaveItems échouaient occasionnellement avec des erreurs comme « Modifier Group ID does not exist », parce que l'API externe appliquait deux validations que le noyau POS n'appliquait pas : la vérification de l'existence des groupes de modificateurs inclus (Included Modifier Groups) et la vérification des références de panneaux sous un article. Les validations de SaveItems ont été mises à jour pour correspondre au comportement du noyau POS, tant pour les vérifications IncludedModifiers que pour les vérifications des références de panneaux, sans nécessiter de nettoyage global des données.

API Build 0.1.207 — Nouveautés

Correctifs de bogues et améliorations

IDENTIFIANT Description
AS1-3286 Nettoyage des files SQS et des abonnements SNS orphelins. Les solutions Cloud API conteneurisées (SOAP et REST) créaient une nouvelle file SQS par conteneur abonné à une rubrique SNS. Lorsque les conteneurs étaient réduits, les files n'étaient pas supprimées, ce qui laissait des abonnements SNS orphelins qui provoquaient des échecs répétés et de fausses alarmes de surveillance. Les conteneurs retirent maintenant correctement les files SQS et les abonnements SNS associés à l'arrêt.
AS1-3287 Consignation des requêtes SubmitOrder ajoutée. Les requêtes SubmitOrder réussies sont maintenant écrites dans un compartiment S3 accessible afin de soutenir le développement de modèles d'apprentissage automatique et de faciliter le débogage des problèmes de commandes en ligne en production. La consignation est contrôlée par un indicateur de configuration et peut être activée ou désactivée pour gérer l'utilisation de l'espace de stockage.

API Build 0.1.199 — Nouveautés

Correctifs de bogues et améliorations

IDENTIFIANT Description
AS1-3231 Erreurs de mémoire insuffisante (OOM) du service de commandes résolues. Les pods du service de commandes (Ordering Service) échouaient avec des erreurs de mémoire insuffisante, ce qui faisait échouer les API de commande (y compris SubmitOrder). Un appel superflu à la base de données de groupes dans le flux CalculateOrder ajoutait une consommation de mémoire et une charge inutiles. L'appel a été supprimé et le problème ne devrait plus se reproduire.
AS1-3253 Refonte de la performance de GetOrderBumpTimes. GetOrderItemBumpTimes et GetOrderBumpTimes causaient de graves problèmes de performance, des erreurs OOM et des dépassements de délai, surtout pendant les extractions de données de nuit. Les deux points de terminaison ont été remaniés pour être exponentiellement plus efficaces sur le plan de la mémoire et de la performance.
AS1-3278 AWS SDK for .NET mis à niveau à la v4. La version 5.15r2 utilisait auparavant une version d'AWS SDK for .NET qui cessera de recevoir des mises à jour après le 1er juin 2026. Ce correctif met à niveau vers AWS SDK for .NET v4 afin d'assurer un accès continu aux mises à jour importantes du SDK.

API Build 0.1.196 — Nouveautés

Correctifs de bogues et améliorations

IDENTIFIANT Description
AS1-3200 Amélioration de l'arrêt des processus d'arrière-plan. L'API arrête maintenant plus proprement les tâches d'arrière-plan lorsque l'application POS s'arrête de façon inattendue, ce qui assure un fonctionnement plus fluide et réduit l'utilisation inutile des ressources.
AS1-3203 Instructions de cuisine séparées des commandes. Les intégrateurs utilisaient auparavant SubmitOrder pour envoyer des instructions de cuisine au KDS, ce qui nuisait à l'exactitude du décompte des additions. Les instructions de cuisine sont maintenant envoyées séparément. SubmitOrder n'accepte que des articles ouverts et hors revenus (0 $) pour les instructions de cuisine, ce qui les distingue clairement des commandes ordinaires et améliore l'exactitude du décompte des additions.

Historique des versions

Version Date Mises à jour
1.0 6 mars 2026 Version initiale
2.0 30 mars 2026 Correctif de maintenance du menu d'avril
3.0 15 mai 2026 Ajout du correctif de bogue AS1-3540
4.0 15 mai 2026 Ajout de la section API Build 0.1.212 avec AS1-3481 et AS1-3540
5.0 29 mai 2026 Ajout de la section API Build 0.1.213 avec AS1-3480, AS1-3540 et AS1-3558
6.0 9 juillet 2026 Ajout de la section API Build 0.1.214 avec AS1-3556