Notes de version de l'API 0.2.135
Version 0.2.135 · PAR POS v5.0.16 · Historique des versions v2.0 · Mai 2026
Rapport de modification de l'API : v5.0.15 (P) → v5.0.16 (Q)
Aucune modification majeure dans cette version
Toutes les modifications apportées à la version 5.0Q sont entièrement rétrocompatibles. Les champs optionnels ajoutés aux opérations existantes seront absents ou définis sur « faux » pour les données plus anciennes. Les intégrations existantes ne nécessitent aucune modification de code, sauf si les utilisateurs souhaitent utiliser les nouveaux champs ou la nouvelle opération SendKitchenInstructions.
Portail API et documentation
La documentation complète de l'API, incluant des exemples de messages, des définitions de schéma 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 site, puis déployées sur d'autres sites.
- Si des modifications sont effectuées en parallèle à plusieurs endroits, 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 | Régime moteur maximal |
|---|---|---|
| SaveItems, SaveDestinations, SaveTaxes | 100 | 5 |
| Supprimer les éléments, Supprimer les destinations, Supprimer les taxes | 20 | 5 |
| Enregistrer le changement de prix / Supprimer le changement de prix | Non recommandé (un seul disque) | — |
API Build 0.2.135 — Nouveautés
Corrections de bugs et améliorations
| IDENTIFIANT | Description |
|---|---|
| AS1-3523 | Les horodatages des journaux de l'API SOAP ont été corrigés. Auparavant, le temps de traitement était calculé incorrectement dans les journaux de l'API SOAP, ce qui entraînait des horodatages inexacts. Les temps de traitement sont désormais enregistrés avec précision. |
API Build 0.2.134 — Nouveautés
Nouvelles fonctionnalités
| IDENTIFIANT | Description |
|---|---|
| BRNK-32880 | API en magasin (Données de vente) : Nouveaux points d'accès aux données en temps réel pour les services en magasin. Permet la création de tableaux de bord interactifs, l'intégration de la vidéosurveillance et l'utilisation d'outils d'analyse sans dépendre du cloud. Donne accès aux données de commandes en cours et historiques, à l'état des caisses et aux synthèses de performance. Compatible avec les capteurs d'IA/ML et la vidéosurveillance. Réduit les coûts d'interrogation et améliore l'efficacité. |
| AS1-2720 | Tarification simplifiée des offres groupées — Ajout de la prise en charge de l'indicateur de tarification simplifiée des offres groupées aux API de commande hors magasin. Les offres groupées peuvent désormais avoir un prix unique et explicite, correctement reflété et conservé via les API (articles et modifications de prix). La suppression d'articles et les modifications de prix fonctionnent toujours correctement. Le comportement de CalculateOrder et SubmitOrder reste inchangé. Les outils situés au-dessus du magasin peuvent désormais définir et gérer en toute sécurité les prix des combinaisons sans raccourcis d'interface utilisateur ni risque de double comptage des prix des composants. |
| AS1-3199 | API Instructions Cuisine — Un point de terminaison dédié pour envoyer les instructions cuisine au KDS via les API Cloud, indépendamment des commandes de facturation. Les intégrateurs peuvent désormais utiliser une nouvelle API dédiée aux instructions cuisine au lieu de les envoyer comme de fausses commandes (ce qui affectait le décompte des tickets de caisse). Seuls les articles ouverts, non facturés, sont envoyés. La plateforme les marque en interne avec le type de commande « Instruction Cuisine », les distinguant ainsi clairement des véritables commandes de facturation. |
Rapport de modification du schéma : v5.0.15 (P) → v5.0.16 (Q)
Résumé
Cette version ne comporte aucune modification majeure (à l'exception des changements de domaine des points de terminaison). Tous les nouveaux champs sont optionnels (minOccurs=0) et rétrocompatibles. Les utilisateurs existants ne constateront aucune différence, sauf s'ils choisissent d'utiliser les nouveaux champs.
Résumé de l'impact sur les consommateurs
| Fichier de service | Opération / Portée | Type de changement | Direction | Champ / Élément | Type de données | Requis? | Action/Impact des consommateurs |
|---|---|---|---|---|---|---|---|
| Fichier Ordering.xml | Envoyer les instructions de cuisine | Nouvelle opération | Demande | DestinationId | int | Facultatif | Nouvelle fonction d'envoi des instructions de cuisine à une destination précise. Aucun impact sur les appels existants. |
| Fichier Ordering.xml | Envoyer les instructions de cuisine | Nouvelle opération | Demande | Instructions de cuisine | Tableau des instructions de cuisine | Facultatif | Tableau d'objets KitchenInstruction. Chacun possède : ItemId (int), Instruction (string). |
| Fichier Ordering.xml | Envoyer les instructions de cuisine | Nouvelle opération | Réponse | Message | chaîne | Facultatif | Enveloppe-réponse standard — même modèle que pour toutes les autres opérations de commande. |
| Fichier Ordering.xml | Envoyer les instructions de cuisine | Nouvelle opération | Réponse | Code de résultat | int | Facultatif | Code de résultat standard. |
| Ventes2.xml | GetOrders / GetFutureDateOrders | ✅ Champ de réponse ajouté | Réponse | Élément non générateur de revenus | booléen | Facultatif | Indique si un article n'a pas généré de revenus. Cette valeur apparaîtra comme fausse/absente pour les commandes plus anciennes. Aucune modification de code n'est requise ; les clients peuvent gérer cette information s'ils le souhaitent. |
| Ventes2.xml | GetOrders / GetFutureDateOrders | ✅ Champ de réponse ajouté | Réponse | Identifiant du centre de revenus (RevenueCenterId) | int | Facultatif | Identifiant du centre de revenus pour le poste de dépense. Les consommateurs peuvent l'utiliser, s'ils le souhaitent, pour la génération de rapports au niveau du centre de revenus. |
| Settings.xml | Obtenir les articles | ✅ Champ de requête ajouté | Demande | inclureSupprimé | booléen | Facultatif | Indiquez « true » pour inclure les éléments supprimés de manière réversible. Les appelants existants qui omettent ce champ conservent le même comportement qu'auparavant. Aucune modification majeure. |
| Settings.xml | Obtenir les articles | ✅ Champ de réponse ajouté | Réponse | TarificationSimpleCombo | booléen | Facultatif | Nouveau champ dans l'objet Article. Indique si l'article utilise une tarification combinée simple. Les consommateurs peuvent consulter cette information lors de la consultation des articles du menu. |
| Settings2.xml | GetItems / GetMenu / GetSettings | ✅ Champ de réponse ajouté | Réponse | TarificationSimpleCombo | booléen | Facultatif | Identique à Settings.xml : un nouveau champ apparaît dans le modèle de données Item. Les utilisateurs d'objets Item de Settings2 doivent prendre en compte cette nouvelle propriété. |
| Tous les fichiers (7) | Bibliothèque de schémas/types | ℹ️ Nouveaux types de schémas | N/A | dateOnly, heureOnly | xs
|
N/A | Deux nouveaux types primitifs restreints ont été ajoutés. Ils ne sont pas encore utilisés dans les opérations. Aucune action du consommateur n'est requise ; le traitement est purement additif. |
Différence détaillée entre les champs — Nouveaux champs uniquement
Tous les nouveaux champs ont minOccurs=0 et sont entièrement rétrocompatibles.
| Fichier de service | Objet de données / Type | Nom du champ | Type de données | minOccurs (Ancien) | minOccurs (Nouveau) | Notes |
|---|---|---|---|---|---|---|
| Fichier Ordering.xml | Demande d'instructions pour la cuisine | DestinationId | int | N/A (nouveau) | 0 | Nouvelle opération — champ de requête |
| Fichier Ordering.xml | Demande d'instructions pour la cuisine | Instructions de cuisine | Tableau des instructions de cuisine | N/A (nouveau) | 0 | Sous-objet du tableau KitchenInstructions |
| Fichier Ordering.xml | Instructions de cuisine (sous-objet KitchenInstructions) | ID de l'article (ItemId) | int | absent | 0 | Sous-objet du tableau KitchenInstructions |
| Fichier Ordering.xml | Instructions de cuisine (sous-objet KitchenInstructions) | Instruction | chaîne | absent | 0 | Sous-objet du tableau KitchenInstructions |
| Ventes2.xml | Article de commande | Article non générateur de revenus | booléen | absent | 0 | Réponse renvoyée par GetOrders / GetFutureDateOrders |
| Ventes2.xml | Article de commande | RevenueCenterId | int | absent | 0 | Réponse renvoyée par GetOrders / GetFutureDateOrders |
| Settings.xml | GetItems (élément de requête) | inclureSupprimé | booléen | absent | 0 | Champ de requête ajouté |
| Settings.xml | Article | TarificationSimpleCombo | booléen | absent | 0 | Nouveau champ de l'objet Article |
| Settings2.xml | Article | TarificationSimpleCombo | booléen | absent | 0 | Opérations liées aux éléments de Settings2 renvoyées |
| Tous les fichiers | Bibliothèque de types de schémas | dateOnly (simpleType) | restriction de date XS | absent | 0 | Format : AAAA-MM-JJ — non encore utilisé dans aucun champ opérationnel |
| Tous les fichiers | Bibliothèque de types de schémas | tempsOnly (simpleType) | restriction de temps XS | absent | 0 | Modèle : HH
|
Opérations sans modification
Les opérations suivantes ont été confirmées inchangées dans la version 5.16 (Q). Elles ne présentent aucun risque pour les utilisateurs actuels.
| Fichier de service | Opérations inchangées |
|---|---|
| HouseAccounts.xml | GetHouseAccount, GetHouseAccountCharges, GetHouseAccountPayments, GetHouseAccounts |
| Cuisine.xml | GetOrderBumpTimes, GetOrderItemBumpTimes |
| Labor2.xml | Obtenir le planning de travail, Obtenir les horaires, Enregistrer le planning de travail |
| Fichier Ordering.xml | Appliquer le paiement, Calculer la commande, Annuler la commande, Obtenir la disponibilité de l'article, Obtenir l'état du terminal principal, Obtenir la commande, Obtenir le client, Obtenir les articles indisponibles, Envoyer la commande, Soumettre la commande, Mettre à jour la disponibilité de l'article |
| Ventes2.xml | GetCurrentBusinessDate, GetDeposits, GetFutureDateOrderDeposits, GetTills |
| Settings2.xml | GetCashDrawers, GetDayParts, GetDestinations, GetDiscounts, GetEmployees, GetItemGroups, GetJobs, GetModifierCodes, GetModifierGroups, GetOptions, GetPettyAccounts, GetPromotions, GetRegisters, GetRevenueCenters, GetSections, GetSurcharges, GetTaxes, GetTenders, GetVoidReasons |
| Settings.xml | Supprimer les heures d'ouverture, Supprimer les destinations, Supprimer les dates d'exception, Supprimer les articles, Supprimer les changements de prix, Supprimer les taxes, Obtenir les marques, Obtenir les heures d'ouverture, Obtenir les organismes de bienfaisance, Obtenir les destinations, Obtenir les employés, Obtenir les options de commande futures, Obtenir les articles, Obtenir les emplois, Obtenir les files d'attente de la cuisine, Obtenir la date de dernière modification, Obtenir le menu, Obtenir les groupes de modificateurs, Obtenir les options du menu de commande en ligne, Obtenir les autorisations, Obtenir les changements de prix, Obtenir les promotions, Obtenir les motifs de remboursement, Obtenir les niveaux de sécurité, Obtenir les paramètres, Obtenir les tables, Obtenir les taxes, Enregistrer les heures d'ouverture, Enregistrer les destinations, Enregistrer les employés, Enregistrer les dates d'exception, Enregistrer les articles, Enregistrer les groupes de modificateurs, Enregistrer les changements de prix, Enregistrer les taxes, Mettre à jour le prix des articles |
Historique des versions
| Version | Date | Mises à jour |
|---|---|---|
| 1.0 | 16/04/2026 | Version initiale |
| 2.0 | 28/04/2026 | Correction de bug supplémentaire ajoutée (AS1-3523) |
| 3.0 | 14/05/2026 | Informations WSDL ajoutées |