PAR POS™ | Notes de version de l'API
Version 0.3.127 · PAR POS v5.17 · Date de publication à déterminer
Rapport de modification de l'API : v5.16r5 → v5.17
| ✅ 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 POS :
https://developers.partech.com/
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.3.127 — Nouveautés
Nouvelles fonctionnalités
| IDENTIFIANT | Description |
|---|---|
| AS1-3318 | Renforcement de SavePromotions API (intégration PMP/RSI). Les points de terminaison REST SavePromotions (POST /settings/v1/promotions pour créer et PUT /settings/v1/promotions pour mettre à jour) et l'opération SOAP SavePromotions ont été introduits dans la version 5.16r2. Cette version complète ce travail avec des validations supplémentaires lors de l'enregistrement des promotions, des correctifs aux problèmes de validation relevés lors des tests REST et SOAP, et la documentation de l'opération SOAP SavePromotions sur le portail API. Le type de données MarketingCampaigns doit toujours être demandé explicitement dans l'appel GetSettings. Les intégrateurs doivent consulter la documentation du portail API et confirmer que les charges utiles de promotions qu'ils soumettent satisfont aux validations. |
| AS1-3316 | Annuler les commandes futures qui ont été envoyées à la cuisine ou qui sont sur le KDS (demande de Burger King). La demande consiste à étendre l'API CancelOrder afin qu'une commande déjà envoyée puisse être annulée et supprimée, la source de l'annulation étant indiquée comme API. Cette capacité n'est pas active dans la version 5.17. La partie du travail côté POS n'est pas terminée dans cette version; la vérification du service de commandes (Order Service) qui rejette les commandes déjà envoyées a donc été rétablie. CancelOrder continue de se comporter comme dans la version 5.16r5 et renvoie le ResultCode 102 pour les commandes déjà envoyées à la cuisine. |
Performance et fiabilité
Ces modifications réduisent l'utilisation de la mémoire et protègent l'API externe contre les défaillances liées au cache en période de forte charge. Elles ne modifient pas les contrats de requête ou de réponse, et aucune action n'est requise de la part des intégrateurs.
| IDENTIFIANT | Description |
|---|---|
| AS1-3738 | Gestion de la ruée sur le cache (cache stampede) et optimisation de la mémoire. Un ensemble de modifications qui réduisent l'utilisation de la mémoire par requête sur l'API externe et préviennent les erreurs System.OutOfMemoryException sur les grands comptes. Les modifications individuelles sont énumérées ci-dessous. |
| AS1-3673 | Désérialisation en flux des paramètres. Les réponses de paramètres utilisées par GetItems, GetModifierGroups, GetItemGroups et Lanes sont maintenant désérialisées en flux plutôt que construites d'abord en mémoire. Cela réduit d'environ la moitié la mémoire de pointe pour ces appels. |
| AS1-3674 | Réduction des allocations dans GetOrders. La traduction des commandes libère maintenant les objets sources au fur et à mesure, utilise des collections de taille prédéfinie, remplace les balayages répétés par des recherches dans des dictionnaires et met en cache les options du sérialiseur. La structure de la réponse GetOrders est inchangée. |
| AS1-3685 | Champs inutilisés retirés des modèles de commandes historiques. Les champs qui étaient désérialisés à partir du service de rapports (Reporting), mais jamais renvoyés par GetOrders, ne sont plus lus. La réponse GetOrders est inchangée. |
| AS1-3749 | Utilisation réduite de la mémoire pour la mise en cache des jetons des grands comptes. Pour les comptes comptant plusieurs milliers d'emplacements, les renseignements d'accès mis en cache sont maintenant renvoyés directement plutôt que copiés à chaque lecture, ce qui réduit la pression sur le ramasse-miettes. |
| AS1-3684 | Regroupement des requêtes de paramètres et gigue du TTL. Lorsque de nombreuses requêtes ratent le cache des paramètres en même temps, elles sont regroupées en une seule extraction des paramètres. Les heures d'expiration du cache sont également randomisées afin que les emplacements n'expirent pas tous en même temps après une modification massive des paramètres. |
| AS1-3641 | Exception de dictionnaire corrigée dans le cache de filtre des paramètres. Correction d'une exception levée dans le cache de filtre des paramètres du client de paramètres. |
| AS1-3642 | Identifiant unique pour la communication en magasin. Les appels vers le magasin utilisent maintenant un GUID unique comme identifiant de communication plutôt que l'identifiant de corrélation de la requête HTTP. |
Modernisation du service de commandes
| IDENTIFIANT | Description |
|---|---|
| AS1-3336 | Modernisation du service de commandes — découplage de l'Order Service. Travaux d'ingénierie internes sur le service de commandes, notamment des améliorations de l'utilisation de la base de données, des correctifs de sérialisation et d'audit des paiements pour la solution .NET 10, des mises à jour des fichiers de projet et une couverture accrue des tests unitaires et d'intégration. Le contrat de l'API du service de commandes ne change pas, et aucune action n'est requise de la part des intégrateurs. |
Modifications apportées à WSDL (0.2.152 → 0.3.127)
Aucune modification des fichiers WSDL publiés sur le CDN n'a été identifiée pour les services SOAP couverts par cette version ; les clients SOAP utilisant des proxys générés automatiquement ne nécessitent aucune régénération pour cette version.
