Outil de configuration de l'imprimante

Version 01
Date octobre 2026
Public cible Intégrateurs POS, équipes de mise en œuvre et de soutien, auteurs de scripts
Types de documents Reçus, billets de cuisine et étiquettes

1. Aperçu

1.1 Qu'est-ce que l'impression par script

L'impression par script permet à un utilisateur autorisé de définir la mise en page d'un reçu ou d'un billet de cuisine dans PAR POS à l'aide d'un court programme JavaScript, plutôt que de se fier uniquement aux formats fixes de l'Éditeur de paramètres. Un script lit la commande à imprimer, décide de ce qui doit être imprimé et construit la sortie ligne par ligne au moyen d'un objet PrintJob : texte aligné, séparateurs, mise en évidence, codes à barres, codes QR, images stockées, regroupement d'articles, modificateurs et contenu conditionnel. Sur les imprimantes d'étiquettes prises en charge, le même script peut aussi positionner du texte et tracer des cadres.

Le script s'exécute localement sur la caisse au moment de l'impression, dans un environnement isolé sans accès au réseau, aux fichiers ni au système. La configuration fixe Options > Impression reste en place comme solution de repli.

1.2 Problèmes résolus

Deux limites des formats fixes ont motivé cette fonctionnalité. Les changements de mise en page nécessitaient auparavant une modification du code du produit, et il était difficile de faire varier la sortie selon les caractéristiques d'une transaction, comme la destination, le type de billet, l'état de commande future, le terminal, l'article, le groupe d'articles ou l'imprimante. Un script est une couche de personnalisation contrôlée qui répond aux deux besoins sans modifier le code de la caisse.

Portée Détail
Types de documents pris en charge Reçus et billets de cuisine (phase 1). Les étiquettes sur les imprimantes d'étiquettes Brother prises en charge sont produites au moyen de scripts de billets.
Non couvert Les reçus de paiement et les autres types de documents nécessitent une prise en charge distincte du produit. Les scripts ne peuvent pas appeler de services externes.
Solution de repli Si l'indicateur de fonctionnalité est désactivé, qu'aucun script n'est assigné ou qu'un script échoue, la caisse imprime la mise en page existante de Options > Impression.

1.3 À qui s'adresse ce guide

  • Les intégrateurs POS qui configurent des sorties propres à une marque ou à un emplacement sans modifier le code de la caisse.

  • Les exploitants d'entreprise qui gèrent les exigences de marketing, d'exécution des commandes et de communication en cuisine.

  • Les équipes de mise en œuvre et de soutien qui prévisualisent, valident et publient des ensembles de modifications.

  • Les auteurs de scripts qui connaissent JavaScript et travaillent avec les objets Order, Printer, Store et PrintJob.

Ce guide suppose une connaissance pratique de JavaScript, de l'Éditeur de paramètres et de la publication d'ensembles de modifications. Il ne suppose aucune connaissance du code source de la caisse.

1.4 Démarrage rapide

Ce script minimal imprime le nom du magasin, une ligne de commande et un remerciement. C'est le script le plus court qui soit valide à la fois en aperçu et en production.

Script 1 : reçu minimal

function setupPreviewData() {
    Store.Name = "PAR Burger";
    Store.Address1 = "123 Main Street";
    Order.Number = 312;
    Order.Total = 9.71;
}

function print() {
    PrintJob.Bold = true;
    PrintJob.AddCenteredLine(Store.Name);
    PrintJob.Bold = false;
    PrintJob.AddCenteredLine(Store.Address1);
    PrintJob.AddFilledLine("-");
    PrintJob.AddLeftAndRightLine("Order " + Order.Number, "$" + Order.Total.toFixed(2));
    PrintJob.AddNewLine();
    PrintJob.AddCenteredLine("Merci!");
}

Exemple de sortie (imprimante de 42 colonnes)

                PAR Burger
             123, rue Principale
------------------------------------------
Ordre 312                            9,71 $

                Merci!
  1. Dans le Portail d'administration, ouvrez l'Éditeur de paramètres pour votre emplacement ou votre groupe.

  2. Ouvrez Fonctions de script et sélectionnez Ajouter une nouvelle fonction de script.

  3. Définissez Nom avec une valeur descriptive, Type de script à Configurateur d'impression et Type de document à Reçu.

  4. Collez le script 1 dans l'éditeur et exécutez l'aperçu. Un script valide s'affiche; un script invalide affiche « Le script est invalide. ».

  5. Sélectionnez OK, puis ouvrez Options > Impression > Reçu et sélectionnez votre script.

  6. Publiez l'ensemble de modifications, attendez que la caisse reçoive les paramètres, puis imprimez un reçu.

2. Exigences et compatibilité

2.1 Logiciel et indicateur de fonctionnalité

  • L'indicateur de fonctionnalité au niveau du groupe PARPOS.EnableScriptPrintingConfiguration doit être activé. Lorsqu'il est activé, un script Configurateur d'impression sélectionné a préséance. Lorsqu'il est désactivé, la configuration existante de Options > Impression demeure active et les commandes du Configurateur d'impression sont masquées.

  • La caisse et l'Éditeur de paramètres exécutent tous deux la bibliothèque PARPOS.JavaScriptEngine (un paquet .NET Standard 2.0 reposant sur l'interpréteur JavaScript Jint 4.1.0), de sorte qu'un script se comporte de la même façon en aperçu et sur la caisse.

2.2 Accès

  • Accès au Portail d'administration avec l'autorisation d'ouvrir l'Éditeur de paramètres de l'emplacement.

  • Autorisation de créer ou de modifier des fonctions de script et de publier des ensembles de modifications.

  • Accès à la caisse pour les essais d'impression physiques.

2.3 Imprimantes prises en charge

La portée de certification documentée pour l'impression par script est la suivante :

  • Bixolon SRP-S300 (couramment configurée au moyen de l'émulation Epson).

  • Epson TM-U220.

  • Epson TM-T88.

  • Imprimante d'étiquettes Epson TM-L90.

3. Fonctionnement

3.1 Cycle d'exécution

Étape Ce qui se passe
1. Déclencheur Un événement d'impression de reçu ou de billet survient sur la caisse.
2. Sélection La caisse identifie le type de document et le script sélectionné pour celui-ci sous Options > Impression (Reçu ou Billet). Si l'indicateur est désactivé ou si rien n'est sélectionné, la mise en page existante est utilisée et les étapes suivantes sont ignorées.
3. Validation Le moteur vérifie que le script ne contient aucun mot restreint et qu'il comporte la fonction print() requise.
4. Exécution Le moteur isolé reçoit les objets de données (Order, Store, PrintJob, PrintHelper et Printer pour les billets) et appelle print().
5. Rendu print() a mis à jour le PrintJob; la caisse le convertit en commandes d'imprimante pour le pilote et l'émulation configurés.
6. Livraison La file d'impression et le processus de traitement existants envoient la sortie par le chemin COM, USB ou réseau configuré.

3.2 Reçus par rapport aux billets

Script de reçu Script de billet
Type de document Reçu Billet
Sélectionné sous Options > Impression > Reçu Options.Printing.Receipt.ScriptId Options > Impression > Bon (Options.Impression.Bon.ScriptId)
Objets disponibles PrintJob, Order, Store, PrintHelper. Aucun objet Printer. PrintJob, Order, Store, Printer, PrintHelper
Coupe Avance du papier et coupe automatiques après le script. N'appelez pas AddCut. Le script termine lui-même le billet avec PrintJob.AddCut(85).
Autour de votre sortie Le cadre d'application imprime une image d'en-tête et des messages d'imprimante avant votre sortie, et les renseignements de fidélisation après celle-ci. Aucune image d'en-tête, aucun message d'imprimante ni aucun bloc de fidélisation n'est documenté pour les billets. Considérez que le script est responsable de l'ensemble du billet.
Données supplémentaires Order.ReceiptPrintCount Destination de l'article, OrderTime, Seat, Units, Weight, PreviousItems, BagItems, AllItems, KeyIngredients et plus encore

Un script de reçu et un script de billet sont des scripts distincts. Ils exposent des données différentes; ne réutilisez donc pas l'un pour l'autre sans protéger chaque champ propre à un document.

3.3 Le modèle d'exécution des billets

Le même script de billet s'exécute à répétition, et ce qu'il voit dépend de Printer.ChitType :

ChitType Fréquence d'exécution du script Contenu de Order.Items
SingleChit Une fois par article Exactement un article
SummaryChit Une fois par imprimante Les articles de cette imprimante
Bag Une fois Les articles du sac

L'énumération ChitType comporte aussi une valeur Both, mais le moteur ne la transmet jamais à un script. Ne gérez que SingleChit, SummaryChit et Bag.

3.4 Aperçu des objets de données

Objet Accès Objectif
PrintJob Lecture et écriture La sortie que vous construisez. Définissez des propriétés pour contrôler le formatage et appelez des méthodes pour ajouter du contenu.
Order Lecture seule en production La commande à imprimer : articles, totaux, modes de paiement, client, destination, employé et plus encore.
Printer Lecture seule, billets seulement L'imprimante de billets et l'exécution de billet en cours.
Store Lecture seule Nom, adresse et numéro de téléphone de l'emplacement.
PrintHelper Lecture seule Fonctions d'aide au formatage (devise, date courte, heure courte et longue).

3.5 Aperçu par rapport à la production

Aperçu de l'Éditeur de paramètres Caisse (production)
Données Objets JavaScript simples et modifiables. Votre fonction setupPreviewData() crée les données. Enveloppes en lecture seule construites à partir de la commande réelle.
setupPreviewData() Obligatoire. S'exécute avant print(). Non appelée.
Limites Des limites plus strictes sont appliquées. Limites configurées sur la caisse.
Objets figés Non figés. Les objets marqués comme figés, y compris PrintHelper, ne peuvent pas être modifiés.
Erreurs L'éditeur affiche « Script is invalid Le script est invalide.ise en page intégrée est imprimée.
IMPORTANT: L'aperçu valide votre syntaxe et votre logique par rapport aux données que vous avez inventées. Il ne prouve pas que les données de production ont la même structure et ne dit rien du matériel.

Le moteur fige tout objet marqué comme figé lorsqu'il s'exécute hors de l'aperçu. PrintHelper en est un. Les autres objets qui portent cet indicateur n'ont pas été vérifiés; traitez donc chaque objet comme étant en lecture seule en production.

3.6 Solution de repli et échec silencieux

Si la validation échoue ou si le script génère une erreur à l'exécution, le moteur ne renvoie rien et la caisse imprime la mise en page intégrée. L'utilisateur voit un reçu ou un billet ordinaire, et l'erreur n'est consignée que dans les journaux de la caisse. Un reçu qui est « revenu à l'ancien format » après une publication est donc le premier symptôme d'une erreur de script.

4. Création, assignation et publication d'un script

4.1 Champs de la fonction de script

Champ Valeur Objectif
Nom Unique et descriptif Identifie le script dans la liste des fonctions de script et dans la liste déroulante d'assignation.
Type de script Configurateur d'impression Active les champs et le comportement de l'éditeur propres aux reçus et aux billets.
Type de document Reçu ou Billet Définit le contexte du document et, par conséquent, les objets que reçoit le script.
Éditeur de script JavaScript contenant print() Définit la sortie.
Données d'aperçu setupPreviewData() Crée des données représentatives pour le panneau d'aperçu.
Publication Ensemble de modifications publié Rend la sélection enregistrée disponible pour la caisse.

4.2 Procédure

  1. Connectez-vous au Portail d'administration et ouvrez l'Éditeur de paramètres pour l'emplacement ou le groupe cible.

  2. Sélectionnez Fonctions de script dans la navigation de gauche.

  3. Sélectionnez Ajouter une nouvelle fonction de script.

  4. Saisissez un nom descriptif.

  5. Définissez Type de script à Configurateur d'impression.

  6. Définissez Type de document à Reçu ou Bon.

  7. Saisissez le script. Définissez print(). Définissez setupPreviewData() pour que l'aperçu dispose de données.

  8. Utilisez la commande d'aperçu. Un script valide affiche un aperçu; un script invalide affiche « Le script est invalide. » avec la raison.

  9. Sélectionnez OK pour enregistrer la fiche du script.

  10. Ouvrez Options > Impression > Reçu ou Options > Impression > Bon et sélectionnez le script enregistré dans la liste déroulante.

  11. Publiez l'ensemble de modifications et attendez que la caisse reçoive les paramètres mis à jour.

4.3 Assignation des scripts

  • Reçu : Options > Impression > Reçu > sélectionnez un script Configurateur d'impression de reçu.

  • Bon: Options > Impression > Bon > sélectionnez un script Configurateur d'impression de billet.

Si aucun script n'est sélectionné ou si l'indicateur de fonctionnalité est désactivé, la configuration existante du même onglet Options est utilisée.

4.4 Correspondance entre imprimante et contexte

Le script sélectionné contrôle le contenu du document. La configuration de l'imprimante contrôle la destination physique, la connexion, l'émulation, le rôle en cuisine et la file d'impression. Un script de billet peut inspecter Printer.Name, Printer.ChitType, Printer.ChitCurrentIndex et Printer.TotalChits afin de varier la sortie pour une imprimante ou une position de billet précise.

Les facteurs d'affaires que vous pouvez utiliser dans la logique de sélection comprennent la destination, le type de billet, l'état de commande future, le type de service, le sous-total, la date ou l'heure, le terminal, l'article, le groupe d'articles, l'imprimante et l'état d'assignation à un client ou de fidélisation.

4.5 Paramètres de cuisine

  • Les types de billets de cuisine sont Sommaire, Simple, Sommaire + Simple et Sac, lorsque la version déployée les prend en charge.

  • Les champs propres aux billets comprennent la destination de l'article, les modificateurs au niveau de l'article, l'heure de la commande, le siège, les unités, le nom de l'unité, le poids, les ingrédients clés, ainsi que les collections PreviousItems, BagItems et AllItems.

  • SortPriority est exposé sur les articles et peut réordonner les articles de cuisine. Le tri par groupe d'articles dépend de la prise en charge du produit et ne doit pas être tenu pour acquis.

  • Les paramètres existants des imprimantes de cuisine et les messages d'imprimante sont des couches distinctes. Ne présumez pas qu'un script remplace tous les anciens messages d'imprimante, à moins que la version ne le documente.

5. Règles des scripts

5.1 Contrat d'exécution

  • Un script est du JavaScript et il est sensible à la casse. Utilisez exactement les noms PrintJob, Order, Printer, Store, PrintHelper, print et setupPreviewData.

  • print() est toujours obligatoire. Le moteur l'appelle; votre code ne doit pas l'appeler.

  • setupPreviewData() n'est obligatoire que dans l'aperçu de l'Éditeur de paramètres. Le moteur l'appelle avant print(); votre code ne doit pas l'appeler.

  • Définissez les deux comme déclarations de fonction de niveau supérieur. Un appel direct de l'une ou l'autre génère l'erreur « L'appel direct à la fonction print n'est pas autorisé. ».

  • Ne déclarez pas de variable ni de fonction dont le nom est original suivi de print ou de setupPreviewData; le moteur utilise ces noms.

5.2 Mode strict et déclarations

Le mode strict est activé. L'affectation à une variable non déclarée génère une erreur ReferenceError (par exemple « q n'est pas défini »); déclarez donc tout avec var, let ou const.

Privilégiez var pour les déclarations de niveau supérieur. En aperçu, le validateur évalue l'ensemble de votre script une fois pour chaque fonction requise (print et setupPreviewData) dans le même moteur. Un const ou let de niveau supérieur est donc déclaré deux fois et échoue avec « L'identifiant ... a déjà été déclaré ». Les let et const à l'intérieur d'une fonction sont sûrs, tout comme les déclarations de fonction de niveau supérieur.

Déclarations

var IG_BOXED = 673549520;      // OK: top-level var
const IG_OTHER = 1;            // FAILS in preview: declared twice

function print() {
    const width = 42;          // OK: scoped to the function
}

5.3 Mots restreints

Avant l'exécution, le validateur recherche des mots restreints dans l'ensemble du texte du script. La correspondance ne tient pas compte de la casse, porte sur des mots entiers et s'applique partout : code, commentaires et chaînes littérales. Une seule correspondance entraîne le rejet du script avec « Le script contient un motif non autorisé».

Les mots restreints sont eval, alert, console, document, window, localStorage, sessionStorage, setTimeout, setInterval, XMLHttpRequest, fetch, onload, onerror, System.IO, System.Net et Process.Start.

5.4 Fonctionnalités du langage prises en charge

Le moteur est Jint 4.1.0, qui prend en charge le JavaScript moderne. Les éléments suivants fonctionnent, à notre connaissance : fonctions fléchées, gabarits de chaînes littérales, let et const à l'intérieur des fonctions, chaînage optionnel (?.), opérateur de décomposition sur des objets simples, padStart et padEnd, Array.from, Object.assign, Number.isFinite, ainsi que les API habituelles Array, String, Math et Date.

Non disponibles : les API de navigateur et de Node.js (document, window, fetch, minuteries, localStorage); l'accès au système de fichiers, au réseau, aux processus et à .NET (CLR) en général; et le code dynamique (eval et le constructeur Function sont désactivés).

5.5 Limites d'exécution

Un script est arrêté s'il dépasse les limites de mémoire, de temps ou d'instructions du moteur. Un script arrêté entraîne le retour à la mise en page intégrée.

Limite Configuration de la caisse Valeur par défaut de la bibliothèque (dépôt)
Mémoire 100 Mo 1 Mo
Délai d'expiration 5 000 ms 100 ms
Instructions 1 000 000 1 000
Mode strict Activé Activé

La caisse fournit ses propres valeurs au moyen de la configuration JavaScriptEngineOptions. L'aperçu de l'Éditeur de paramètres applique des limites plus strictes. Confirmez les valeurs de votre version déployée.

5.6 PrintJob conserve son état

Les propriétés de formatage restent activées jusqu'à ce que vous les désactiviez. Initialisez les propriétés qui vous intéressent au début d'un script et réinitialisez chacune d'elles immédiatement après le contenu qui en avait besoin. Cela est particulièrement important sur les imprimantes d'étiquettes, où Bold, DoubleHeight, DoubleWidth et la justification se reportent d'une étiquette à la suivante.

Réinitialiser le formatage après utilisation

PrintJob.Bold = true;
PrintJob.AddCenteredLine("TOTAL");
PrintJob.Bold = false;      // always switch it back off

5.7 Manipuler les données en toute sécurité

Sujet Règle
Valeurs nulles et manquantes Order.Customer est null lorsqu'aucun client n'est assigné. Order.Destination n'est jamais null en JavaScript, mais la lecture de ses propriétés génère une erreur si la destination ne figure pas dans les paramètres. Protégez chaque valeur facultative.
Collections Les collections de production proviennent de .NET. Utilisez length en minuscules. Copiez une collection avec Array.from(collection) avant d'utiliser des méthodes de tableau telles que forEach, sort, filter ou find; les scripts de production le font couramment. Vérifiez d'abord qu'elle n'est pas null.
Types Store.Id est une chaîne. Order.Training est un booléen. Order.Id est une chaîne et peut être un identifiant chiffré selon les paramètres du groupe. Les montants sont des nombres; formatez-les avec toFixed(2).
Dates CreatedDate, BusinessDate et PromiseTime sont des valeurs DateTime .NET qui arrivent sous forme d'objets Date JavaScript. Ne transmettez pas un objet Date à PrintHelper; transmettez date.toISOString(). La sortie des dates est dans l'heure et la culture locales de la caisse.
Devise PrintHelper.ConvertDecimalToCurrencyString utilise la culture de l'ordinateur de la caisse; le symbole monétaire dépend donc de cet ordinateur. Pour un symbole fixe, construisez la chaîne vous-même : "\$" + value.toFixed(2).
Données sensibles Les numéros de carte et les jetons sont masqués dans les enveloppes. N'imprimez pas de renseignements personnels sur les employés au-delà des besoins opérationnels approuvés.

6. Référence des objets et des méthodes

Les types suivent les conventions courantes : string, int, decimal, bool et DateTime. Un ? final (par exemple decimal?) signifie que la valeur peut être null. Les membres qui ne sont pas indiqués comme propres aux billets ou aux reçus peuvent être utilisés dans les deux documents.

6.1 PrintJob

Propriétés

Chaque propriété est un interrupteur qui s'applique au contenu ajouté après sa définition, jusqu'à ce qu'elle soit rétablie.

Propriété Type Description
Bold bool Texte en gras.
Red bool Texte rouge sur les imprimantes et les rubans qui le prennent en charge. Ignoré ailleurs.
Center bool Centre le texte subséquent. La méthode dédiée AddCenteredLine est habituellement plus claire.
Reverse bool Vidéo inversée, habituellement du texte blanc sur fond noir. Sur les imprimantes d'étiquettes Brother, elle s'imprime sous forme de barre pleine.
DoubleHeight bool Hauteur de caractère double.
DoubleWidth bool Largeur de caractère double. Réduit de moitié le nombre de caractères par ligne.
Orientation int Imprimantes d'étiquettes seulement : 1 = horizontale, 2 = verticale. 0 n'est pas valide.
FixXPosition bool Imprimantes d'étiquettes seulement : ancre la position X pour les lignes suivantes.
FixYPosition bool Imprimantes d'étiquettes seulement : ancre la position Y pour les lignes suivantes.
Height, Width int Imprimantes d'étiquettes seulement : taille de l'étiquette, reportée d'une étiquette à l'autre dans une tâche.
Justification enum Justification du texte (gauche, centre, droite). Non réinitialisée lors de la coupe d'une étiquette.

Méthodes

Méthode Description
AddText(string text) Ajoute du texte à la position courante sans terminer la ligne.
AddLine(string text) Ajoute une ligne alignée à gauche.
AddCenteredLine(string text) Ajoute une ligne centrée.
AddRightLine(string text) Ajoute une ligne alignée à droite.
AddLeftAndRightLine(string left, string right) Texte à gauche et à droite sur une même ligne. L'outil de prédilection pour les lignes d'articles et de totaux.
AddLeftCenterRightLine(string left, string center, string right) Trois colonnes sur une même ligne.
AddLeftCenterLine(left, center)
AddCenterRightLine(center, right)
Existent, mais n'ont aucun effet sur les imprimantes visées. Utilisez plutôt AddLeftCenterRightLine.
AddFilledLine(char c) Remplit toute une ligne avec un seul caractère, par exemple "-". Elle accepte un seul caractère, et non une chaîne.
AddNewLine() Ajoute une ligne vide.
AddNewLines(int count) Ajoute plusieurs lignes vides.
AddCut(byte length) Coupe le papier. length est un octet (85 par défaut), et non un pourcentage. Transmettez 85 explicitement.
AddQRCode(string data, int moduleSize = 3) Imprime un code QR. La taille du module est facultative.
AddBarCode(string data, symbology) Imprime un code à barres. Symbologies : Code39, Ean13, UPCA. La prise en charge varie selon l'imprimante.
AddImage(byte id) Imprime un logo déjà stocké dans la mémoire NVRAM de l'imprimante, identifié par son numéro d'image. Cette méthode ne téléverse pas d'image.
SetCursorPosition(int x, int y) Imprimantes d'étiquettes : saute à une position absolue, en points d'imprimante.
MoveCursorPosition(int x, int y) Imprimantes d'étiquettes : déplace le curseur par rapport à la position courante, en points. Les valeurs négatives déplacent vers la gauche ou vers le haut.
AddBox(int width, int height, int thickness) Imprimantes d'étiquettes : cadre à la position du curseur. Une épaisseur égale à la plus petite dimension produit une barre pleine.
AddBoxToAxis(int position, int otherDimension, int thickness) Imprimantes d'étiquettes : cadre allant du curseur jusqu'à un point cible, sans déplacer le curseur.

PrintJob expose aussi AddLines, Merge et Clone, que ce guide ne documente pas encore. Separation, Bottom, BottomLineCount, FontB et Wrap existent, mais n'ont aucun effet sur les imprimantes visées (voir la section 7.2).

6.2 Order

La commande à imprimer. Elle est en lecture seule en production. En aperçu, vous attribuez les propriétés dont vous avez besoin dans setupPreviewData().

Propriétés de niveau supérieur

Propriété Type Remarques
Id string Peut être un identifiant de commande chiffré selon les paramètres du groupe.
Number int Numéro de commande.
Name string Nom de la commande. Certains magasins ajoutent du texte supplémentaire après une barre verticale.
Balance decimal Positif : solde dû. Négatif : monnaie à rendre. Zéro : payé en entier.
SubTotal decimal Sous-total.
SubTotalBeforeReduction decimal? Sous-total avant réductions.
Tax decimal Taxe de la commande. Les scripts de production utilisent cette propriété plutôt que TotalTaxAmount.
TotalTaxAmount decimal Montant total des taxes.
Rounding decimal Ajustement d'arrondi; zéro s'il n'y en a pas.
Total decimal Total de la commande.
BusinessDate DateTime? Date d'affaires.
CreatedDate DateTime Date de création de la commande.
PromiseTime DateTime Heure promise. Les scripts de livraison de production impriment « ASAP » lorsque getFullYear() n'est pas supérieur à 0.
Closed bool La commande est fermée.
IsFired bool La commande a été envoyée à la cuisine.
IsFutureOrder bool Commande future.
Refund bool Commande de remboursement.
TaxExempt bool Commande exonérée de taxes.
Training bool Commande en mode formation.
GuestCount string Nombre de convives.
CustomerAccountNumber string Numéro de compte du client.
CustomerAssigned bool Un client est assigné.
CustomerType string Type de client.
Email string Courriel de la commande.
PhoneNumber string Numéro de téléphone de la commande.
ReceiptPrintCount int Reçu seulement. Nombre de fois que le reçu a été imprimé.
ChitPrintCount, EditCount int Compteurs des impressions et des modifications de billets.

Objets imbriqués

Propriété Membres Remarques
Customer FirstName, LastName, FullName, PhoneNumber, Address (y compris Notes) Null lorsqu'aucun client n'est assigné.
Delivery Address.Address1, Address2, City, State, PostalCode, Notes; PhoneNumber Renseigné pour les commandes de livraison. Vérifiez Destination.IsDelivery.
Destination Id, Name, Indicator, IsDelivery, KitchenChitHeader, KitchenDescription Jamais null, mais la lecture des propriétés génère une erreur si la destination ne figure pas dans les paramètres.
Employee, ClosedByEmployee DisplayName, FirstName, LastName, IsTraining DisplayName peut être null; utilisez alors le prénom et le nom de famille.
Lane Name, Prefix
Party Name, OrderNumber
Terminal Name La caisse.

Collections d'ajustements

Collection Membres
Discounts Name, PrintedName, Amount
Promotions Name, PrintedName, Amount
Surcharges Name, Amount
Taxes Name, Amount
MarketingCampaigns Name

Articles

Order.Items contient les lignes de commande. Cette collection peut comprendre des articles annulés (Vidée est true) ainsi que les enfants des combos et des ensembles. Un enfant a un CompositeOrderItemId supérieur à zéro et apparaît aussi sous son parent dans CompositeOrderItems; un article de niveau supérieur a un CompositeOrderItemId égal à 0. N'imprimez que les articles de niveau supérieur et affichez les enfants par l'intermédiaire du parent. Order.VoidItems a la même structure, avec Vidée à true.

Propriété Type Remarques
Id, ItemId int Id identifie la ligne de commande, ItemId l'article du menu.
Description string Nom de l'article.
AlternateKitchenName string Nom en cuisine.
Quantity int
Price decimal Prix unitaire de base.
PriceWithModifiers decimal Prix unitaire incluant les modificateurs. Multipliez par Quantity pour obtenir le total de la ligne.
Note string Note de l'article.
SortPriority byte Ordre d'affichage; la valeur la plus basse s'imprime en premier.
ItemGroups[] Id, Name Peut être vide. Ne présumez jamais que la première entrée existe.
Modifiers[] voir ci-dessous Chaque modificateur peut contenir ses propres Modifiers.
CompositeOrderItemId int 0 = autonome, supérieur à 0 = fait partie d'un combo.
CompositeOrderItems[] articles Articles enfants. Chaque propriété d'article s'applique à chaque enfant.
AutoNumber, AutoNumberPrefix, AutoNumberItemGroupId byte, string, int Numérotation automatique.
IsEdited bool Modifié après son envoi à la cuisine.
IsDeleted, IsCleared, Voided, Sent, IsTaxFree bool Indicateurs d'état. La propriété est IsDeleted (I majuscule).
PrinterGroupId int Articles de billet : le groupe d'imprimantes de l'article.
Length int Longueur de l'article.

Membres d'un modificateur : Description, Id, ItemId, Price, IsTaxFree, ModifierGroup.Id, ModifierGroup.Name et Modifiers imbriqués. ModifierGroupIds et ModifierCodeId ne sont pas exposés aux scripts. Sur les billets, la structure du modificateur est réduite à Description et ItemId.

Propriétés d'article propres aux billets : Destination (Id, Indicator, KitchenChitHeader, KitchenDescription, IsDelivery, Name), Discounts[] (PrintedName, Name, Amount), OrderTime, Seat, Units, UnitName, Weight.

Remarque: Ces noms n'existent pas et causent des erreurs s'ils sont utilisés : ItemGroupIds, Order.DestinationId, Order.DestinationName. Utilisez ItemGroups ainsi que Order.Destination.Id et .Name.

Collections propres aux billets

Propriété Description
Order.PreviousItems Articles déjà envoyés sur un billet antérieur. Structure d'article.
Order.BagItems Articles destinés au sac. Structure d'article.
Order.AllItems Tous les articles de la commande. Structure d'article.
Order.KeyIngredients Tableau de { Count, Text }.

Modes de paiement

Order.Tenders énumère les paiements. Il n'existe aucune propriété de type de paiement; déduisez le type d'après les champs présents. Le numéro de carte et le jeton sont masqués.

Type de paiement Membres
Espèces Name, Amount
Chèque Name, Amount, CheckNumber
Carte de crédit Name, Amount, TipAmount, CardNumber, Authorization, AuthorizedTenderAmount, Token, Balance
Débit Name, Amount, TipAmount, CardNumber, Authorization, AuthorizedTenderAmount
Externe Name, Amount, TipAmount, AuthorizedTenderAmount
Carte-cadeau Name, Amount, TipAmount, CardNumber, AuthorizedTenderAmount, BalanceRemaining
Certificat-cadeau Name, Amount, TipAmount, AuthorizedTenderAmount
Compte client Name, Amount, TipAmount, AccountNumber, AuthorizedTenderAmount
EBT Name, Amount, TipAmount, CardNumber, Authorization, Balance, AuthorizedTenderAmount

Les modes de paiement peuvent aussi comporter AdditionalData.

Order expose également les méthodes GetUCPEmbeddedBarCode(plu) et GetCode39EmbeddedBarCode(), ainsi que les collections AllOrderItems et GiftCardItems. Ces éléments ne sont pas encore documentés en détail.

6.3 Printer

Scripts de billets seulement. Le fait de référencer Printer dans un script de reçu génère une erreur Erreur de référence.

Propriété Type Description
Name string Nom de l'imprimante.
ChitType string SummaryChit, SingleChit ou Bag.
ChitCurrentIndex int Billet courant dans une exécution à billets multiples.
TotalChits int Nombre total de billets dans l'exécution.
DiscountChitPlacement string None, Top, Bottom ou Both.
KeyIngredientSummaryPlacement string None, Top, Bottom ou Both.
PrinterGroupIds int[] Groupes d'imprimantes auxquels l'imprimante appartient.

6.4 Store

Propriété Type
Id string
Name string
Address1, Address2 string (Address2 peut être null)
City, State, Zip string
Phone string

6.5 PrintHelper

Fonctions d'aide au formatage disponibles en aperçu et en production. Hors de l'aperçu, l'objet est figé et ne peut pas être modifié.

Méthode Description
ConvertDecimalToCurrencyString(decimal) Formate selon la culture de l'ordinateur (par exemple, 7.5 devient $7.50 sur un ordinateur américain; le symbole dépend de la culture).
GetShortDate(string iso) Analyse une chaîne ISO 8601 et renvoie la date courte locale.
GetShortTime(string iso) Renvoie l'heure courte locale.
GetLongTime(string iso) Renvoie l'heure longue locale.
IMPORTANT: Les fonctions d'aide pour les dates prennent une **chaîne** ISO. Transmettre un objet Date échoue avec « was not recognized as a valid DateTime ». Convertissez d'abord : PrintHelper.GetShortDate(new Date(value).toISOString()).

Une chaîne ISO sans Z ni décalage est traitée comme étant en UTC. Le résultat est affiché selon l'heure et la culture locales de la caisse.

Formatage sécuritaire des dates

function formatDateTime(value) {
    // value can be a production Date or a preview string
    var iso = new Date(value).toISOString();
    return PrintHelper.GetShortDate(iso) + " " + PrintHelper.GetShortTime(iso);
}

7. Capacités des imprimantes

Le tableau ci-dessous provient d'un examen technique des pilotes d'imprimante. Il décrit ce que chaque pilote fait avec une commande PrintJob, et non le résultat sur le matériel physique; confirmez donc sur l'imprimante réelle avant la mise en production.

7.1 Largeur de ligne et prise en charge des fonctionnalités

Imprimante Largeur Red Reverse AddBarCode AddQRCode AddImage
Epson TM-T88 / RESTICK / U200 42 / 44 / 33 Fonctionne Fonctionne Code39, Ean13, UPCA (la U200 imprime du texte centré) Fonctionne Image NV stockée
Star TSP100 48 Sans effet Sans effet Code39 seulement Sans action Génère une erreur
NCR 7197 44 Fonctionne Fonctionne Code39, Ean13 (UPCA génère une erreur) Sans action Génère une erreur
PAR M3876 42 Sans effet Fonctionne Code39, Ean13, UPCA Sans action Image stockée
Partner RP-320 42 Sans effet Fonctionne Code39, Ean13, UPCA Sans action Génère une erreur
Zebra TTP2000 Non vérifiée Sans effet Fonctionne Sans action Sans action Génère une erreur
OPOS Selon les paramètres Stocké seulement Stocké seulement Toujours Code39 Fonctionne Génère une erreur
PosForDotNet Selon les paramètres (42 par défaut) Stocké seulement Stocké seulement Génère une erreur Sans action Génère une erreur
Brother (nouveau pilote) Proportionnelle (ZPL) Sans effet Cadre rempli Code39, Ean13, UPCA Fonctionne Image flash IMAGE{n}.GRF

« Sans effet » signifie que la commande est acceptée, puis ignorée. « Sans action » signifie que rien n'est imprimé. « Génère une erreur » signifie que le script échoue et que la caisse revient à la mise en page intégrée. AddFilledLine fonctionne sur toutes ces imprimantes, sauf la Zebra TTP2000, où elle ne fait rien.

Rouge et Reverse sont envoyés sous forme des commandes d'imprimante suivantes. Le pilote Brother ne les utilise pas : il imprime Reverse sous forme de cadre rempli, et Red n'a aucun effet.

Imprimante Red Reverse
Epson TM-T88 / RESTICK / U200 ESC r Fonctionne
Star TSP100 Sans effet Sans effet
NCR 7197 ESC r GS B
PAR M3876 Sans effet GS B
Partner RP-320 Sans effet GS B
Zebra TTP2000 Sans effet ESC T
OPOS / PosForDotNet Stocké seulement Stocké seulement

Seul le nouveau pilote Brother prend en charge les commandes de curseur et de cadre ZPL, FixXPosition, FixYPosition, Orientation, Height et Width.

7.2 Commandes sans effet sur les imprimantes visées

AddLeftCenterLine, AddCenterRightLine, FontB, Wrap, Bottom, BottomLineCount et Separation.

7.3 Largeur, polices et jeux de caractères

  • La largeur de ligne, la taille de police, Red, Reverse, la double hauteur et la double largeur sont limitées par l'imprimante et son émulation. Un script ne peut pas forcer un résultat que le matériel ne peut pas produire.

  • Gardez le texte à l'intérieur de la largeur imprimable. Tronquez ou découpez vous-même les noms d'articles et les modificateurs longs, et faites des essais avec les noms réels les plus longs.

  • DoubleWidth réduit de moitié le nombre de caractères par ligne. Les mises en page sensibles à la largeur doivent en tenir compte.

  • Ne présumez pas la prise en charge des polices proportionnelles, des glyphes Unicode, de l'italique ou du soulignement. Utilisez les caractères que l'imprimante prend en charge.

  • Testez les codes à barres et les codes QR avec un lecteur réel; l'aperçu n'indique pas la qualité de lecture.

7.4 Étiquettes Epson TM-L90

L'Epson TM-L90 fait partie de la portée de certification de l'impression par script. Son mécanisme existant de gabarits d'étiquettes (la page Étiquettes, avec des balises de formatage comme <Bold> et des paramètres comme%ItemName%) est une fonctionnalité distincte, documentée dans le Guide de formatage des étiquettes Epson TM-L90. Le présent guide ne le remplace pas.

8. Impression d'étiquettes sur les imprimantes Brother

Les imprimantes d'étiquettes Brother offrent un contrôle de mise en page de bas niveau : orientation de l'étiquette, positions ancrées, déplacement manuel du curseur et cadres. Les coordonnées sont exprimées en points d'imprimante, et non en pouces ni en millimètres. N'utilisez ces membres que sur une imprimante et un type de document qui les prennent en charge; sur une imprimante de reçus thermique, ils n'ont aucun effet.

8.1 Orientation

Définissez PrintJob.Orientation pour changer la mise en page. Les valeurs proviennent de l'énumération d'orientation des étiquettes.

Valeur Signification
0 (None) Valeur non valide à définir.
1 (Horizontal) Mise en page standard, de gauche à droite.
2 (Vertical) L'étiquette pivote de 90 degrés. Le texte se lit de côté et les lignes avancent dans le sens de la largeur de l'étiquette.
  • L'orientation se reporte d'une étiquette à l'autre dans la même tâche. Définissez-la toujours explicitement au début du script.

  • Un changement en cours d'étiquette conserve la position courante et modifie la façon dont elle est interprétée; il ne ramène pas le curseur à un coin.

  • Un changement sur une toute nouvelle étiquette part de la position de départ normale de cette orientation.

8.2 Positions fixes

L'activation de FixXPosition ou de FixYPosition verrouille la position courante du curseur comme point d'ancrage. Chaque ligne suivante qui reviendrait à la marge par défaut part plutôt du point d'ancrage, jusqu'à ce que vous le désactiviez.

  • La direction physique régie par un point d'ancrage dépend de l'orientation au moment de son activation. Modifier l'orientation par la suite ne change pas un point d'ancrage actif.

  • La désactivation d'une fixation ramène cet axe à son point de départ par défaut pour la ligne suivante. Elle ne rétablit pas la position antérieure à la fixation.

  • Déplacer manuellement le curseur pendant qu'une fixation est active déplace aussi le point d'ancrage.

  • Une barre inversée pleine largeur tracée pendant qu'une fixation est active s'étend du point d'ancrage jusqu'au bord opposé, et non sur toute la largeur de l'étiquette.

8.3 Contrôle manuel du curseur

  • MoveCursorPosition(x, y) se déplace par rapport à la position courante. Les valeurs peuvent être négatives : un x négatif déplace vers la gauche et un y négatif vers le haut.

  • SetCursorPosition(x, y) saute à une position exacte. Les valeurs sont normalement 0 ou positives; une valeur négative place le contenu hors de l'étiquette.

  • Dans l'appel, x est toujours horizontal et y toujours vertical. En orientation verticale, leur effet visuel s'inverse, mais l'ordre des arguments ne change jamais.

  • Ce sont des commandes de bas niveau. Elles ne découpent pas le texte, ne s'ajustent pas à la taille de l'étiquette et n'évitent pas les chevauchements; il revient au script d'éviter les collisions.

8.4 Cadres et barres

  • AddBox(width, height, thickness) trace un cadre à la position du curseur. Lorsque l'épaisseur est grande par rapport à la plus petite dimension, le cadre est rendu plein, ce qui produit une barre d'arrière-plan inversée ou en surbrillance.

  • AddBoxToAxis(position, otherDimension, thickness) trace un cadre du curseur jusqu'à un point cible sans déplacer définitivement le curseur.

Cadres

PrintJob.AddBox(800, 307, 2);            // outer border for the whole label
PrintJob.MoveCursorPosition(765, 0);
PrintJob.AddBox(35, 35, 2);              // small square callout
PrintJob.AddBox(681, 35, 35);            // thickness = height: solid bar

Appels d'orientation, d'ancrage et de curseur

PrintJob.Orientation = 2;          // Vertical
PrintJob.Orientation = 1;          // back to Horizontal

PrintJob.FixXPosition = true;      // lock the X anchor
PrintJob.AddLeftAndRightLine("Left text", "Right text");
PrintJob.FixXPosition = false;     // release it when done

PrintJob.MoveCursorPosition(20, 0);    // 20 dots right, from the current position
PrintJob.MoveCursorPosition(0, -35);   // 35 dots up (negative y)
PrintJob.SetCursorPosition(8, 0);      // jump to x = 8, y = 0

8.5 Ce qui est réinitialisé lors de la coupe d'une étiquette

AddCut (ou l'envoi de la mémoire tampon) termine une étiquette. Certains états reviennent à leur valeur par défaut pour l'étiquette suivante, d'autres non.

Comportement État
Réinitialisé à la valeur par défaut Mode Reverse (toujours désactivé); ancrages FixXPosition et FixYPosition (libérés); position du curseur (retour au départ pour l'orientation active); toute ligne en cours et inachevée.
Reporté Orientation; Height et Width de l'étiquette.
Non réinitialisé (à désactiver vous-même) Bold, DoubleHeight, DoubleWidth et justification du texte.
Remarque: Bold, DoubleHeight, DoubleWidth et la justification ne sont pas réinitialisés lors de la coupe d'une étiquette. Il s'agit d'une lacune connue. Tant qu'elle n'est pas corrigée, désactivez chaque style que vous avez activé avant de terminer l'étiquette, ou tout au début du script suivant si vous ne pouvez pas garantir ce qui s'est exécuté avant.

9. Recettes

Chaque recette est un bloc de construction autonome et testé. Copiez dans votre script les fonctions dont vous avez besoin. Les exemples supposent la fonction d'aide list(c) qui renvoie c ? Array.from(c) : [].

9.1 Lecture sécuritaire des données facultatives

Protégez chaque valeur qui peut être manquante : Order.Customer, Order.Delivery, ItemGroups, Employee.DisplayName et toute collection.

Lectures sécuritaires

function safeReads() {
    var customerName = Order.Customer && Order.Customer.FirstName
        ? Order.Customer.FirstName
        : "Guest";
    var city = Order?.Delivery?.Address?.City ?? "";
    var items = Order.Items ? Array.from(Order.Items) : [];
    var employee = Order.Employee.DisplayName == null
        ? Order.Employee.FirstName + " " + Order.Employee.LastName
        : Order.Employee.DisplayName;
    return [customerName, city, items.length, employee];
}

9.2 Dates et heures

Deux approches fonctionnent. PrintHelper formate selon la culture locale de la caisse. Le formatage manuel donne une mise en page fixe qui ne dépend pas de la culture de l'ordinateur. Les deux acceptent un objet Date ou une chaîne analysable.

Formatage manuel de la date et de l'heure

function formatDate(value) {
    var d = new Date(value);
    return (d.getMonth() + 1) + "/" + d.getDate() + "/" + d.getFullYear();
}
function formatTime(value) {
    var d = new Date(value);
    var hours = d.getHours();
    var minutes = String(d.getMinutes()).padStart(2, "0");
    var ampm = hours >= 12 ? "PM" : "AM";
    return (hours % 12 || 12) + ":" + minutes + " " + ampm;
}

9.3 Montants et totaux

  • Formatez vous-même les montants avec "\$" + value.toFixed(2). Les scripts de production ont cessé d'utiliser PrintHelper.ConvertDecimalToCurrencyString après qu'il eut imprimé le mauvais symbole monétaire sur un ordinateur configuré avec une culture différente.

  • Le total d'une ligne est item.Quantity \* item.PriceWithModifiers. PriceWithModifiers est le prix unitaire incluant les modificateurs; imprimer séparément le prix des modificateurs les compte donc en double.

  • Affichez les rabais avec un signe moins et les frais supplémentaires avec un signe plus, en utilisant la valeur absolue du montant stocké.

  • N'imprimez la ligne Rounding que si elle n'est pas nulle, avec son signe.

  • Déduisez le résultat final de Order.Balance : positif correspond à un solde dû, négatif à de la monnaie à rendre (imprimez la valeur absolue).

Solde et monnaie

function printBalance() {
    if (Order.Balance > 0) {
        PrintJob.AddLeftAndRightLine("BALANCE DUE", "$" + Order.Balance.toFixed(2));
    } else if (Order.Balance < 0) {
        PrintJob.AddLeftAndRightLine("CHANGE DUE", "$" + Math.abs(Order.Balance).toFixed(2));
    }
}

9.4 Colonnes, troncature et retour à la ligne

PrintJob.Wrap n'a aucun effet, et un texte long peut déborder de la ligne. Tronquez ou découpez le texte vous-même, en utilisant la largeur de l'imprimante cible.

Retour à la ligne par mots

function wrapText(text, width) {
    var words = String(text || "").split(" ");
    var lines = [];
    var line = "";
    words.forEach(function (word) {
        if ((line + " " + word).trim().length > width) {
            if (line) { lines.push(line); }
            line = word;
        } else {
            line = (line + " " + word).trim();
        }
    });
    if (line) { lines.push(line); }
    return lines;
}

Colonnes fixes

function padRight(text, width) {
    return String(text).substring(0, width).padEnd(width, " ");
}
function padLeft(text, width) {
    return String(text).substring(0, width).padStart(width, " ");
}

9.5 Modificateurs, sous-modificateurs et combos

Un modificateur peut contenir des modificateurs, et un article combo contient des articles enfants qui ont leurs propres modificateurs. Une petite fonction récursive gère n'importe quelle profondeur. Dans un script de reçu, n'imprimez que les articles de niveau supérieur (CompositeOrderItemId == 0) et affichez les enfants par l'intermédiaire de CompositeOrderItems.

Modificateurs récursifs

function printModifiers(modifiers, level) {
    (modifiers ? Array.from(modifiers) : []).forEach(function (mod) {
        PrintJob.AddLine(" ".repeat(level * 3) + mod.Description);
        printModifiers(mod.Modifiers, level + 1);
    });
}

9.6 Regroupement des articles en double

Lorsque le même article est saisi sur plusieurs lignes, vous pouvez souhaiter une seule ligne avec la quantité totale. Faites la fusion en fonction de tout ce qui doit correspondre : l'article du menu, le prix unitaire, la note et les modificateurs.

Regrouper des articles identiques

function itemKey(item) {
    var mods = list(item.Modifiers)
        .map(function (m) { return m.ItemId + ":" + m.Price; })
        .sort()
        .join(",");
    return [item.ItemId, item.PriceWithModifiers, item.Note || "", mods].join("|");
}
function consolidate(items) {
    var byKey = {};
    var result = [];
    items.forEach(function (item) {
        var key = itemKey(item);
        if (byKey[key]) {
            byKey[key].Quantity += item.Quantity;
        } else {
            byKey[key] = Object.assign({}, item);      // copy so the original is untouched
            result.push(byKey[key]);
        }
    });
    return result;
}
IMPORTANT:* Fusionner uniquement par ItemId combine un hamburger ordinaire avec un hamburger contenant du fromage supplémentaire et imprime les modificateurs de la première entrée pour les deux. Incluez l'ensemble des modificateurs dans la clé, comme ci-dessus. Les articles combo doivent aussi comparer leurs enfants.

9.7 Fonctions d'aide destinées aux clients

Numéro de téléphone, numéro de commande abrégé, nom d'affichage

function formatPhone(raw) {
    var digits = String(raw || "").replace(/\D/g, "");
    var m = digits.match(/^(\d{3})(\d{3})(\d{4})$/);
    return m ? "(" + m[1] + ") " + m[2] + "-" + m[3] : String(raw || "");
}
function shortOrderNumber(id) {
    var s = String(id);
    return s.slice(Math.max(0, s.length - 4));
}
// "Name|extra" -> "Name", at most 20 characters
function displayName(name) {
    var s = String(name || "");
    var i = s.indexOf("|");
    return s.substring(0, i === -1 ? Math.min(20, s.length) : Math.min(i, 20));
}

9.8 Modes de paiement et détails du paiement

Il n'existe aucune propriété de type de paiement. Déduisez le type d'après les champs présents et n'imprimez les détails de carte que pour les modes de paiement qui en comportent. Les numéros de carte sont déjà masqués.

Déduire le type de paiement

function tenderKind(t) {
    if (t.CheckNumber != null) return "check";
    if (t.AccountNumber != null) return "house account";
    if (t.BalanceRemaining != null) return "gift card";
    if (t.CardNumber != null) return "card";
    return "other";
}

9.9 Commandes de livraison

Vérifiez Order.Destination.IsDelivery avant de lire Order.Delivery. Utilisez le numéro de téléphone de livraison pour les commandes de livraison, ignorez les valeurs de remplissage dans la deuxième ligne d'adresse et imprimez les notes du client ou de livraison lorsqu'elles sont présentes.

En-tête de livraison

function printDeliveryHeader() {
    if (!Order.Destination.IsDelivery) {
        return;
    }
    var address = Order.Delivery.Address;
    var line2 = address.Address2 ? address.Address2.trim() : "";
    var promise = new Date(Order.PromiseTime);

    PrintJob.Bold = true;
    PrintJob.DoubleHeight = true;
    PrintJob.AddCenteredLine("Delivery Order");
    PrintJob.AddCenteredLine(address.Address1.trim());
    if (line2 && line2 !== "APT" && line2 !== "NON") {      // skip placeholder values
        PrintJob.AddCenteredLine(line2);
    }
    PrintJob.AddCenteredLine(address.City + ", " + address.State + " " + address.PostalCode);
    PrintJob.AddCenteredLine("Requested: " + (promise.getFullYear() > 0
        ? formatDate(promise) + " " + formatTime(promise)
        : "ASAP"));
    PrintJob.DoubleHeight = false;
    PrintJob.Bold = false;
    if (address.Notes && address.Notes.trim().length > 0) {
        PrintJob.AddLine("Notes: " + address.Notes.trim());
    }
    PrintJob.AddFilledLine("-");
}

9.10 Regroupement des articles par groupe d'articles

Regroupez un billet par poste, en utilisant le premier groupe d'articles comme titre. Les articles peuvent n'avoir aucun groupe; prévoyez donc une valeur par défaut. Une bannière centrée comme ---- Entrées: 3 ---- aide le personnel de cuisine à parcourir le billet.

Ligne de bannière

function banner(label, width) {
    if (label.length >= width) { return label.substring(0, width); }
    var left = Math.floor((width - label.length) / 2);
    return "-".repeat(left) + label + "-".repeat(width - label.length - left);
}

La bannière n'est que le titre. Pour construire le billet groupé complet, répartissez d'abord les articles dans des compartiments, fusionnez les lignes identiques à l'intérieur de chaque compartiment (même description et mêmes modificateurs), puis imprimez une bannière par groupe suivie de ses articles. Les lignes d'articles centrées en double taille et le décompte final des articles constituent une mise en page courante en cuisine. DoubleWidth réduit de moitié le nombre de caractères par ligne; conservez donc la largeur de la bannière à la largeur normale de la ligne.

Regrouper, fusionner et imprimer (utilise list() et banner() de cette section)

function groupItems(items) {
  var groups = {};
  items.forEach(function (item) {
    var g = list(item.ItemGroups);
    var name = g.length > 0 ? g[0].Name : "Other"; // never assume ItemGroups[0]
    if (!groups[name]) { groups[name] = { items: [], total: 0 }; }
    // same description + same modifiers = same line
    var mods = list(item.Modifiers).map(function (m) { return m.Description; }).join(",");
    var key = item.Description + "|" + mods;
    var existing = groups[name].items.find(function (i) { return i.key === key; });
    if (existing) {
      existing.Quantity += item.Quantity;
    } else {
      groups[name].items.push(Object.assign({}, item, { key: key }));
    }
    groups[name].total += item.Quantity;
  });
  return groups;
}

function printGrouped(items) {
  var groups = groupItems(items);
  var total = 0;
  Object.keys(groups).forEach(function (name) {
    PrintJob.AddNewLine();
    PrintJob.AddCenteredLine(banner(name + ": " + groups[name].total, 42));
    PrintJob.AddNewLine();
    groups[name].items.forEach(function (item) {
      PrintJob.DoubleHeight = true;
      PrintJob.DoubleWidth = true;
      PrintJob.AddCenteredLine(item.Quantity + " " + item.Description);
      PrintJob.DoubleWidth = false;
      PrintJob.DoubleHeight = false;
      list(item.Modifiers).forEach(function (m) { PrintJob.AddCenteredLine(m.Description); });
    });
    total += groups[name].total;
  });
  PrintJob.AddNewLine();
  PrintJob.AddCenteredLine("Total Items: " + total);
}
Remarque: Ce regroupement se fait uniquement selon le premier groupe d'articles. Si un article peut appartenir à plusieurs groupes, déterminez lequel régit son emplacement avant d'adopter ce modèle. Le tri par groupe d'articles n'est pas garanti par le produit; fiez-vous à SortPriority pour l'ordre.

9.11 Mise en évidence des articles modifiés

IsEdited indique qu'un article a été modifié après son envoi à la cuisine. Marquez ces articles lorsqu'un billet est réimprimé.

Marqueur de modification

function printWithEditMarker(items) {
    items.forEach(function (item) {
        var tag = item.IsEdited ? "[EDITED]" : "[NEW]   ";
        PrintJob.AddLine(tag + " " + item.Quantity + "x " + item.Description);
    });
}

CONSEIL

IsEdited est un booléen simple une fois atteint. Pour vous protéger contre une version de la caisse où le champ n'est pas renseigné, vérifiez typeof item.IsEdited !== "undefined" avant de vous y fier.

9.12 Codes à barres, codes QR et images stockées

  • AddBarCode(data, symbology) prend en charge Code39, Ean13 et UPCA, mais chaque imprimante prend en charge un sous-ensemble différent. Transmettez le nom de la symbologie sous forme de chaîne et confirmez en aperçu la forme acceptée par votre version.

  • AddQRCode(data, moduleSize) fonctionne sur Epson, OPOS et Brother, et ne fait rien sur Star, NCR, PAR M3876, Partner et PosForDotNet.

  • AddImage(id) imprime une image déjà stockée dans la mémoire NVRAM de l'imprimante, selon son numéro d'image. Téléversez d'abord l'image au moyen du processus d'imprimante pris en charge. Cette méthode génère une erreur sur plusieurs imprimantes.

  • Faites toujours un essai de lecture de la sortie physique.

Code à barres, code QR et logo stocké

function printCodes() {
    PrintJob.AddBarCode(String(Order.Number), "Code39");
    PrintJob.AddQRCode("https://example.com/orders/" + Order.Id, 4);
    PrintJob.AddImage(1);
}

10. Exemples de scripts complets

Les scripts ci-dessous sont complets et ont été testés par rapport aux règles du moteur (mots restreints, mode strict, déclarations de niveau supérieur, fonctions requises). Exécutez chacun d'abord en aperçu, puis sur l'imprimante cible. Remplacez les valeurs propres à un magasin, comme les identifiants de groupes d'articles, par les vôtres.

REMARQUE: Les blocs « Exemple de sortie » ont été produits en exécutant chaque script avec ses données d'aperçu au moyen d'un moteur de rendu de texte de 42 colonnes. Ils montrent la mise en page prévue. Les polices, les largeurs ainsi que l'impression en rouge et en inversé dépendent de votre imprimante.

10.1 Reçu

Un reçu complet : en-tête du magasin, renseignements sur la commande, articles avec modificateurs et enfants de combos, articles annulés, rabais, frais supplémentaires, taxes, arrondi, total, modes de paiement avec pourboire et détails de la carte, et solde ou monnaie à rendre. Il suppose une imprimante thermique standard de 42 colonnes et n'appelle pas AddCut.

Script 2 : reçu de référence

/*
 * Reference receipt script (Receipt script)
 * - Receipt scripts receive Order, Store, PrintJob and PrintHelper.
 *   There is no Printer object in a receipt script.
 * - Do not call AddCut(); the receipt is fed and cut automatically after the script.
 */

function setupPreviewData() {
    Store.Id = "1234";
    Store.Name = "PAR Burger";
    Store.Address1 = "123 Main Street";
    Store.City = "Syracuse";
    Store.State = "NY";
    Store.Zip = "13202";
    Store.Phone = "315-555-0100";

    Order.Id = "AAAE6LTF9QAE";
    Order.Number = 312;
    Order.Name = "Melissa";
    Order.CreatedDate = new Date("2026-10-08T17:32:22Z");
    Order.Employee = { DisplayName: "Sam K" };
    Order.Destination = { Name: "Counter - Dine In", IsDelivery: false };
    Order.Customer = null;

    Order.Items = [
        {
            Voided: false, IsDeleted: false,
            CompositeOrderItemId: 0, CompositeOrderItems: [],
            Quantity: 2, Description: "Cheeseburger", Price: 7.50, PriceWithModifiers: 8.50,
            Modifiers: [
                { Description: "Extra Cheese", Price: 1.00, Modifiers: [] },
                { Description: "No Onion", Price: 0, Modifiers: [] }
            ]
        },
        {
            Voided: false, IsDeleted: false, CompositeOrderItemId: 0, Quantity: 1,
            Description: "Value Basket", Price: 9.99, PriceWithModifiers: 9.99,
            Modifiers: [],
            CompositeOrderItems: [
                { Quantity: 1, Description: "Fries MED", Price: 0, PriceWithModifiers: 0,
                  Modifiers: [{ Description: "Extra Salt", Modifiers: [] }] },
                { Quantity: 1, Description: "Root Beer MED", Price: 0, PriceWithModifiers: 0,
                  Modifiers: [] }
            ]
        },
        {
            Voided: true, IsDeleted: false,
            CompositeOrderItemId: 0, CompositeOrderItems: [],
            Quantity: 1, Description: "Hot Dog", Price: 3.00, PriceWithModifiers: 3.00,
            Modifiers: []
        }
    ];
    Order.Discounts = [
        { PrintedName: "Employee Meal", Name: "Employee Meal", Amount: 2.00 }
    ];
    Order.Promotions = [];
    Order.Surcharges = [{ Name: "Service Fee", Amount: 1.00 }];
    Order.SubTotal = 26.99;
    Order.Tax = 2.02;
    Order.Rounding = 0;
    Order.Total = 28.01;
    Order.Balance = 0;
    Order.Tenders = [{
        Name: "Visa", Amount: 28.01, TipAmount: 3.00, CardNumber: "************1111",
        Authorization: "A2B45", AuthorizedTenderAmount: 31.01
    }];
}

/* ---------- helpers ---------- */

function money(value) {
    return "$" + Number(value || 0).toFixed(2);
}

function formatDateTime(value) {
    // Works for a production DateTime (arrives as a JS Date) and for preview strings.
    var iso = new Date(value).toISOString();
    return PrintHelper.GetShortDate(iso) + " " + PrintHelper.GetShortTime(iso);
}

function list(collection) {
    // Null-safe copy of a collection into a real array.
    return collection ? Array.from(collection) : [];
}

function printModifiers(modifiers, level) {
    list(modifiers).forEach(function (mod) {
        PrintJob.Red = true;
        PrintJob.AddLine(" ".repeat(level * 3) + mod.Description);
        PrintJob.Red = false;
        printModifiers(mod.Modifiers, level + 1);      // sub-modifiers
    });
}

function printItem(item, isVoid) {
    var total = item.Quantity * item.PriceWithModifiers;
    var label = item.Quantity + "  " + (isVoid ? "VOID " : "") + item.Description;
    var price = isVoid ? "(" + money(total) + ")" : (total > 0 ? money(total) : "");
    PrintJob.AddLeftAndRightLine(label.substring(0, 32), price);
    list(item.CompositeOrderItems).forEach(function (child) {
        PrintJob.AddLine("   " + child.Quantity + " " + child.Description);
        printModifiers(child.Modifiers, 2);
    });
    printModifiers(item.Modifiers, 1);
}

/* ---------- print ---------- */

function print() {
    var items = list(Order.Items).filter(function (i) {
        return i.CompositeOrderItemId == 0 && !i.IsDeleted;     // top-level items only
    });
    var active = items.filter(function (i) { return !i.Voided; });
    var voided = items.filter(function (i) { return i.Voided; });

    // Header
    PrintJob.Bold = true;
    PrintJob.DoubleHeight = true;
    PrintJob.AddCenteredLine(Store.Name + " #" + Store.Id);
    PrintJob.DoubleHeight = false;
    PrintJob.Bold = false;
    PrintJob.AddCenteredLine(Store.Address1);
    PrintJob.AddCenteredLine(Store.City + ", " + Store.State + " " + Store.Zip);
    PrintJob.AddCenteredLine(Store.Phone);
    PrintJob.AddNewLine();

    // Order information
    PrintJob.AddLine(formatDateTime(Order.CreatedDate));
    PrintJob.AddLine("Destination: " + (Order.Destination ? Order.Destination.Name : ""));
    PrintJob.AddLine("Order: " + Order.Number + (Order.Name ? "  " + Order.Name : ""));
    PrintJob.AddLine("Server: " + (Order.Employee ? Order.Employee.DisplayName : ""));
    if (Order.Customer) {
        PrintJob.AddLine("Customer: " + Order.Customer.FullName);
    }
    PrintJob.AddFilledLine("-");

    // Items
    active.forEach(function (item) { printItem(item, false); });
    if (voided.length > 0) {
        PrintJob.AddNewLine();
        PrintJob.Bold = true;
        PrintJob.AddCenteredLine("VOIDED ITEMS");
        PrintJob.Bold = false;
        voided.forEach(function (item) { printItem(item, true); });
    }
    PrintJob.AddFilledLine("-");

    // Totals
    PrintJob.AddLeftAndRightLine("Subtotal", money(Order.SubTotal));
    list(Order.Discounts).forEach(function (d) {
        PrintJob.AddLeftAndRightLine(d.PrintedName || d.Name, "-" + money(d.Amount));
    });
    list(Order.Promotions).forEach(function (p) {
        PrintJob.AddLeftAndRightLine(p.PrintedName || p.Name, "-" + money(p.Amount));
    });
    list(Order.Surcharges).forEach(function (s) {
        PrintJob.AddLeftAndRightLine(s.Name, "+" + money(s.Amount));
    });
    PrintJob.AddLeftAndRightLine("Tax", money(Order.Tax));
    if (Order.Rounding != 0) {
        var sign = Order.Rounding > 0 ? "+" : "-";
        PrintJob.AddLeftAndRightLine("Rounding", sign + money(Math.abs(Order.Rounding)));
    }
    PrintJob.Bold = true;
    PrintJob.AddLeftAndRightLine("TOTAL", money(Order.Total));
    PrintJob.Bold = false;

    // Tenders
    list(Order.Tenders).forEach(function (t) {
        PrintJob.AddLeftAndRightLine(t.Name, money(t.Amount));
        if (t.TipAmount > 0) {
            PrintJob.AddLeftAndRightLine("   Tip", money(t.TipAmount));
        }
        if (t.CardNumber) {                                   // card tenders only
            PrintJob.AddRightLine("Card: " + t.CardNumber);
            if (t.Authorization) {
                PrintJob.AddRightLine("Auth: " + t.Authorization);
            }
        }
    });

    // Balance / change
    if (Order.Balance > 0) {
        PrintJob.Bold = true;
        PrintJob.AddLeftAndRightLine("BALANCE DUE", money(Order.Balance));
        PrintJob.Bold = false;
    } else if (Order.Balance < 0) {
        PrintJob.AddLeftAndRightLine("CHANGE DUE", money(Math.abs(Order.Balance)));
    }

    PrintJob.AddNewLine();
    PrintJob.AddCenteredLine("Merci de votre visite !");
}

Exemple de sortie

             PAR Burger #1234
             123, rue Principale
            Syracuse, NY 13202
               315-555-0100

8/10/2026 17 h 32
Destination : Comptoir - Sur place
OCommande : 312 Melissa
Serveur : Sam K
------------------------------------------
2  Cheeseburger                     17,00$
   Supplément fromage
  Sans oignons
1 Panier économique                      9,99$
   1 portion de frites moyennes
      ExSupplément de sel
   1 bière de racine moyenne

               ARTICLES ANNULÉS
1 Hot-dog VOID                     ((3,00 $)
------------------------------------------
Sous-total                             26,99$
Repas du personnel                    -2,00$
SFrais de service                     +1,00$
Taxes                                  2,02$
TOTAL                                  28,01$
Visa                                   28,01$
   Pourboire                            3,00$
                Carte      : ************1111
                               Auth: A2B45

        Merci de votre visite !

10.2 Billet de cuisine

Un billet qui s'adapte à Printer.ChitType : les billets sommaires regroupent les articles par groupe d'articles; les billets simples et de sac impriment les articles tels qu'ils sont énumérés. Il affiche une bannière de commande future, des marqueurs d'articles modifiés, des notes et la position du billet, et se termine par AddCut(85).

Script 3 : billet de cuisine de référence

/*
 * Reference kitchen chit script (Chit script)
 * - Chit scripts receive Order, Printer, Store, PrintJob and PrintHelper.
 * - Printer.ChitType is "SummaryChit", "SingleChit" or "Bag".
 *   SingleChit: the script runs once per item and Order.Items holds exactly that one item.
 *   SummaryChit: the script runs once per printer with that printer's items.
 *   Bag: the script runs once.
 * - Chit scripts end the ticket themselves with AddCut(85).
 */

function setupPreviewData() {
    Printer.Name = "Grill";
    Printer.ChitType = "SummaryChit";
    Printer.ChitCurrentIndex = 1;
    Printer.TotalChits = 1;

    Order.Number = 312;
    Order.Name = "Melissa";
    Order.IsFutureOrder = true;
    Order.PromiseTime = new Date("2026-10-08T18:30:00Z");
    Order.Destination = {
        Name: "Drive Thru", KitchenChitHeader: "DRIVE THRU", IsDelivery: false
    };
    Order.Items = [
        {
            Quantity: 1, Description: "WHOPPER", SortPriority: 2, IsEdited: false, Note: "",
            ItemGroups: [{ Id: 1, Name: "Entrees" }],
            CompositeOrderItems: [],
            Modifiers: [{ Description: "NO PICKLES" }, { Description: "ADD ONION" }]
        },
        {
            Quantity: 2, Description: "FRIES MED", SortPriority: 3,
            IsEdited: true, Note: "Well done",
            ItemGroups: [], CompositeOrderItems: [], Modifiers: []
        },
        {
            Quantity: 1, Description: "OREO SHAKE", SortPriority: 4,
            IsEdited: false, Note: "",
            ItemGroups: [{ Id: 2, Name: "Drinks" }], CompositeOrderItems: [], Modifiers: []
        }
    ];
}

function list(collection) {
    return collection ? Array.from(collection) : [];
}

function groupName(item) {
    var groups = list(item.ItemGroups);
    // never assume ItemGroups[0] exists
    return groups.length > 0 ? groups[0].Name : "Other";
}

function printItem(item) {
    PrintJob.Bold = true;
    PrintJob.DoubleHeight = true;
    var tag = item.IsEdited ? "[EDIT] " : "";
    PrintJob.AddLine(tag + item.Quantity + " " + item.Description);
    PrintJob.DoubleHeight = false;
    PrintJob.Bold = false;
    list(item.CompositeOrderItems).forEach(function (child) {
        PrintJob.AddLine("   " + child.Quantity + " " + child.Description);
    });
    list(item.Modifiers).forEach(function (mod) {
        PrintJob.AddLine("   " + mod.Description);
    });
    if (item.Note) {
        PrintJob.AddLine("   NOTE: " + item.Note);
    }
}

function print() {
    var chitType = Printer.ChitType;
    var items = list(Order.Items).sort(function (a, b) {
        return a.SortPriority - b.SortPriority;
    });

    // Header
    PrintJob.Bold = true;
    PrintJob.Reverse = true;
    PrintJob.AddCenteredLine(Order.Destination.KitchenChitHeader || Order.Destination.Name);
    PrintJob.Reverse = false;
    PrintJob.DoubleHeight = true;
    PrintJob.AddCenteredLine("#" + Order.Number + " " + (Order.Name || ""));
    PrintJob.DoubleHeight = false;
    PrintJob.Bold = false;
    if (Order.IsFutureOrder) {
        var promise = new Date(Order.PromiseTime).toISOString();
        PrintJob.AddCenteredLine("FUTURE - " + PrintHelper.GetShortDate(promise)
            + " " + PrintHelper.GetShortTime(promise));
    }
    PrintJob.AddLeftAndRightLine(
        Printer.Name, "Chit " + Printer.ChitCurrentIndex + " of " + Printer.TotalChits);
    PrintJob.AddFilledLine("-");

    // Body
    if (chitType == "SummaryChit") {
        var current = "";
        items.forEach(function (item) {
            var group = groupName(item);
            if (group !== current) {
                current = group;
                PrintJob.AddCenteredLine("-- " + group + " --");
            }
            printItem(item);
        });
    } else {
        items.forEach(printItem);        // SingleChit and Bag: no grouping
    }

    PrintJob.AddNewLine();
    PrintJob.AddCut(85);
}

Exemple de sortie (SummaryChit, imprimante de 40 colonnes)

               DRIVE THRU
              #312 Melissa
       FUTUR - 2026-10-08 18h30
Grill                        Bon 1 sur 1
----------------------------------------
             -- Entrees --
1 WHOPPER
   SANS CORNICHONS
   AJOUTER DES OIGNONS
              -- Autre --
[EMODIFIER] 2 FRITES MOYENNES
   NOTE : bien joué
              -- Boissons --
1 MILK-SHAKE OREO

------- COUPURE -------

Pour une exécution SingleChit, Order.Items contient exactement un article; le même script imprime donc un article par billet.

10.3 Étiquettes d'articles en boîte

Certains articles, comme les pizzas entières ou le poulet en boîte, s'impriment sur leur propre étiquette plutôt que sous forme de ligne sur le billet principal. Ce modèle identifie les articles en boîte au moyen d'un groupe d'articles, fusionne les articles identiques, imprime une étiquette par unité (ou une seule étiquette regroupée « 12x » à partir d'un seuil) et ajoute à chaque étiquette le pied de page « Box X of Y ». Associez les articles du menu à un groupe d'articles dédié et remplacez IG_BOXED par son identifiant.

Script 4 : étiquettes d'articles en boîte

/*
 * Étiquettes des articles en boîte (Chit script, SummaryChit).
 * Les articles du groupe « en boîte » s'impriment sur leur propre étiquette. ("Box X of Y");
 * Tout le reste est laissé aux cartes habituelles.
 * Remplacez l'identifiant du groupe d'éléments par celui configuré dans votre menu.
 */
var IG_BOXED = 673549520;
// À partir de cette quantité, imprimez une seule étiquette « 12x » au lieu de 12 étiquettes.
var CONSOLIDATE_AT = 10;

function setupPreviewData() {
    Printer.Name = "Box Station";
    Printer.ChitType = "SummaryChit";
    Order.Number = 312;
    Order.Name = "Melissa";
    Order.Items = [
        { ItemId: 1, Description: "PIZZA AU FROMAGE", AlternateKitchenName: "PIZZA AU FROMAGE",
          Quantity: 1, ItemGroups: [{ Id: IG_BOXED, Name: "Boxed" }],
          Modifiers: [{ Description: "Sauce légère", ItemId: 50 }] },
        { ItemId: 1, Description: "PIZZA AU FROMAGE", AlternateKitchenName: "PIZZA AU FROMAGE",
          Quantity: 1, ItemGroups: [{ Id: IG_BOXED, Name: "Boxed" }],
          Modifiers: [{ Description: "Sauce légère", ItemId: 50 }] },
        { ItemId: 2, Description: "AILE", AlternateKitchenName: "AILES",
          Quantity: 12, ItemGroups: [{ Id: IG_BOXED, Name: "Boxed" }], Modifiers: [] },
        { ItemId: 3, Description: "SOUDE", AlternateKitchenName: "SOUDE",
          Quantity: 1, ItemGroups: [], Modifiers: [] }
    ];

}

function list(c) { return c ? Array.from(c) : []; }

function hasItemGroup(item, groupId) {
    return list(item.ItemGroups).some(function (g) { return g.Id == groupId; });
}

function modifiersEqual(a, b) {
    var left = list(a).map(function (m) { return m.ItemId; }).sort().join(",");
    var right = list(b).map(function (m) { return m.ItemId; }).sort().join(",");
    return left === right;
}

function mergeBoxed(items) {
    var merged = [];
    var candidates = items.filter(function (i) { return hasItemGroup(i, IG_BOXED); });
    candidates.forEach(function (item) {
        var match = merged.find(function (m) {
            return m.ItemId === item.ItemId && modifiersEqual(m.Modifiers, item.Modifiers);
        });
        if (match) {
            match.Quantity += item.Quantity;
        } else {
            merged.push(Object.assign({}, item));
        }
    });
    return merged;
}

function print() {
    var boxed = mergeBoxed(list(Order.Items));
    var totalBoxes = boxed.reduce(function (sum, i) { return sum + i.Quantity; }, 0);
    var boxNumber = 1;

    boxed.forEach(function (item) {
        var consolidated = item.Quantity >= CONSOLIDATE_AT;
        var labels = consolidated ? 1 : item.Quantity;
        for (var n = 0; n < labels; n++) {
            PrintJob.Bold = true;
            PrintJob.AddCenteredLine("#" + Order.Number + " " + (Order.Name || ""));
            PrintJob.DoubleHeight = true;
            var prefix = consolidated ? item.Quantity + "x " : "";
            PrintJob.AddCenteredLine(prefix + item.AlternateKitchenName);
            PrintJob.DoubleHeight = false;
            PrintJob.Bold = false;
            list(item.Modifiers).forEach(function (m) {
                PrintJob.AddCenteredLine(m.Description);
            });
            if (consolidated) {
                var last = boxNumber + item.Quantity - 1;
                PrintJob.AddRightLine("Boxes " + boxNumber + "-" + last + " of " + totalBoxes);
                boxNumber += item.Quantity;
            } else {
                PrintJob.AddRightLine("Box " + boxNumber + " of " + totalBoxes);
                boxNumber += 1;
            }
            PrintJob.AddCut(85);
        }
    });
}

Exemple de sortie

               #312 Melissa
               PIZZA AU FROMAGE
               Sauce légère
                               Boîte 1 of 14
------- COUPURE -------
               #312 Melissa
               PIZZA AU FROMAGE
               Sauce légère
                               Boîte 2 of 14
------- COUPURE -------
               #312 Melissa
                12x AILES
                               Boîte 3-14 of 14
------- COUPURE -------

Types de boîtes et lignes complémentaires

Le script 4 fusionne selon ItemId et les modificateurs. Pour fusionner aussi les articles qui partagent un nom de cuisine, acceptez également une correspondance sur AlternateKitchenName. Au-delà du groupe d'articles en boîte lui-même, des groupes d'articles ou des identifiants de modificateurs supplémentaires peuvent décrire la boîte (taille ou type) et déclencher des lignes complémentaires, comme des instructions de coupe en pointes, un sachet d'assaisonnement ou des pepperoncini. Les constantes ci-dessous sont des exemples tirés du menu d'un magasin; remplacez-les par les identifiants de groupes d'articles et de modificateurs de votre propre configuration.

Constante d'exemple Représente
IG_Box8 / IG_Box10 / IG_Box12 Taille de la boîte (8 po, 10 po ou 12 po) à imprimer sur l'étiquette.
IG_BoxChicken / IG_BoxSandwich Étiquette du type de boîte (« BOÎTE À POULET», « Boîte à sandwich »).
IG_NYS Signale un article qui nécessite des instructions de coupe en pointes (par exemple, une pizza de style New York).
IG_ITSeasoning Signale un article qui nécessite une ligne complémentaire « IT Assaisonnement ».
IG_AllPizzas / IG_ThinPizzas Signale les articles de pizza, et plus précisément les pizzas à croûte mince, pour leurs lignes complémentaires respectives.
IG_AllSandwiches Signale les articles de sandwich pour leur ligne complémentaire.
I_GESC Un ItemId de modificateur précis vérifié au moyen d'une fonction d'aide hasItemModifier plutôt que d'un groupe d'articles.

Lignes complémentaires (ébauche, à appeler depuis la boucle d'étiquettes du script 4)

// Remplacez les zéros par les identifiants configurés dans votre menu.
var IG_BOX8 = 0, IG_BOX10 = 0, IG_BOX12 = 0, IG_NYS = 0, IG_SEASONING = 0;

function hasItemModifier(item, modifierItemId) {
  return list(item.Modifiers).some(function (m) { return m.ItemId == modifierItemId; });
}

function printBoxLines(item) {
  if (hasItemGroup(item, IG_BOX8))  { PrintJob.AddCenteredLine('8" box'); }
  if (hasItemGroup(item, IG_BOX10)) { PrintJob.AddCenteredLine('10" box'); }
  if (hasItemGroup(item, IG_BOX12)) { PrintJob.AddCenteredLine('12" box'); }
  if (hasItemGroup(item, IG_NYS))   { PrintJob.AddCenteredLine("WEDGE CUT"); }
  if (hasItemGroup(item, IG_SEASONING)) { PrintJob.AddCenteredLine("IT SEASONING"); }
}
CONSEIL: Exécutez la passe des articles en boîte avant d'imprimer le billet ordinaire, et excluez de ce billet ordinaire tout article déjà pris en charge par le groupe d'articles en boîte. Sinon, l'article s'imprime une fois sous forme d'étiquette et une autre fois sous forme de ligne de billet.

10.4 Étiquette de livraison Brother

Une étiquette horizontale de 812 sur 309 points avec des bordures imbriquées, une bannière d'adresse inversée, des étiquettes latérales verticales, un bloc de totaux ancré et un pied de page. Elle met en œuvre l'orientation, le curseur, les positions fixes, les cadres et les règles de réinitialisation. Exécutez-la uniquement sur une imprimante d'étiquettes Brother.

Script 5 : étiquette de livraison Brother

/*
 * Étiquette de livraison pour imprimante d'étiquettes Brother (écriture Chit, étiquette horizontale avec
* étiquettes latérales verticales). Toutes les positions sont exprimées en points d'impression. À exécuter sur une
* imprimante Brother seulement ; les imprimantes thermiques de reçus ignorent les instructions de positionnement.
 */

function setupPreviewData() {
    Store.Name = "Store 5QR4";
    Order.Name = "David Bratcher";
    Order.Number = 12;
    Order.PromiseTime = new Date(2026, 9, 8, 14, 20);
    Order.Delivery = {
        PhoneNumber: "(502)281-4877",
        Address: { Address1: "123 Main Street", Address2: "Apt 4" }
    };
    Order.SubTotal = 87.06;
    Order.Tax = 6.09;
    Order.Total = 93.15;
}

function money(v) { return "$" + Number(v || 0).toFixed(2) + "     "; }

function timeText(date) {
    var d = new Date(date);
    var h = d.getHours();
    var ampm = h >= 12 ? "pm" : "am";
    var hh = String(h % 12 || 12).padStart(2, "0");
    var mm = String(d.getMinutes()).padStart(2, "0");
    return hh + ":" + mm + ampm;
}

function print() {
    var addr = Order.Delivery && Order.Delivery.Address ? Order.Delivery.Address : {};

    PrintJob.Orientation = 1;                       // set orientation first (it carries over)

    PrintJob.SetCursorPosition(0, 0);               // top-left corner
    PrintJob.AddBox(812, 309, 2);                   // outer border
    PrintJob.MoveCursorPosition(35, 0);
    PrintJob.AddBox(746, 277, 2);                   // inner border
    PrintJob.AddBox(350, 277, 2);                   // left-side divider
    PrintJob.AddBox(746, 240, 2);
    PrintJob.AddBox(746, 100, 2);                   // lower section
    PrintJob.AddBox(646, 100, 2);
    PrintJob.AddBox(681, 35, 35);                   // thickness = height: a solid bar

    PrintJob.Reverse = true;                        // white text on the solid bar
    PrintJob.AddLine(addr.Address1 || "");
    PrintJob.SetCursorPosition(778, 0);
    PrintJob.Reverse = false;
    PrintJob.AddBox(35, 35, 2);                     // corner mark
    PrintJob.MoveCursorPosition(10, 10);
    PrintJob.AddLine("C");
    PrintJob.MoveCursorPosition(28, -12);

    PrintJob.FixXPosition = true;                   // anchor X for the next line
    PrintJob.Reverse = true;
    PrintJob.AddLeftAndRightLine(addr.Address2 || "", "");
    PrintJob.Reverse = false;
    PrintJob.FixXPosition = false;                  // release the anchor

    PrintJob.SetCursorPosition(43, 75);
    PrintJob.AddLine(Order.Name);
    PrintJob.SetCursorPosition(388, 75);
    PrintJob.AddLine(Order.Delivery.PhoneNumber);
    PrintJob.SetCursorPosition(658, 75);
    PrintJob.AddLine(timeText(Order.PromiseTime));

    PrintJob.SetCursorPosition(8, 10);              // vertical tag, left column
    PrintJob.Orientation = 2;
    PrintJob.FixYPosition = true;
    PrintJob.AddLeftAndRightLine(String(Order.Number).padStart(4, "0"), "5 box(es) ");
    PrintJob.Orientation = 1;

    PrintJob.SetCursorPosition(780, 65);            // vertical tag, right column
    PrintJob.Orientation = 2;
    PrintJob.Reverse = true;
    PrintJob.FixYPosition = true;
    PrintJob.AddLeftAndRightLine("P", " " + String(Order.Number).padStart(4, "0") + " ");
    PrintJob.FixYPosition = false;
    PrintJob.Reverse = false;
    PrintJob.Orientation = 1;

    PrintJob.SetCursorPosition(388, 108);           // totals block
    PrintJob.FixXPosition = true;
    PrintJob.AddLeftAndRightLine("Sub-Total", money(Order.SubTotal));
    PrintJob.AddLeftAndRightLine("Sales Tax", money(Order.Tax));
    PrintJob.Bold = true;
    PrintJob.AddLeftAndRightLine("TOTAL", money(Order.Total));
    PrintJob.Bold = false;                          // AddCut does not reset Bold
    PrintJob.FixXPosition = false;
    PrintJob.AddLeftAndRightLine("    THANKS FOR ORDERING", "DOWNLOAD OUR APP      ");
    PrintJob.AddCut(85);                            // ends and cuts the label
}

Ce que le script dessine

Élément Façon dont il est dessiné
Bordures extérieure et intérieure SetCursorPosition(0, 0), puis AddBox(812, 309, 2); un déplacement de 35 points, puis un AddBox(746, 277, 2) imbriqué.
Barre d'adresse pleine AddBox(681, 35, 35) : l'épaisseur égale la hauteur, la barre est donc remplie. Reverse = true imprime l'adresse en blanc sur celle-ci.
Marque de coin Un cadre de 35 sur 35 en haut à droite, avec la lettre « C » placée à l'intérieur au moyen de MoveCursorPosition(10, 10).
Rangée client, téléphone, heure Trois appels à SetCursorPosition sur la même rangée (y = 75).
Étiquettes latérales verticales Orientation = 2 avec FixYPosition pour ancrer chaque paire, puis Orientation = 1 pour revenir à l'horizontale.
Bloc de totaux FixXPosition = true pour que chaque rangée parte du même bord gauche; Bold est désactivé avant la coupe de l'étiquette.

10.5 Étiquette verticale de boîte à pizza

Une étiquette Brother avec une bordure extérieure, une marque de coin « C », une étiquette verticale de commande « P / 0006 », trois colonnes inversées de description de pizza, un séparateur simple, un cadre s'étendant jusqu'au bord de l'étiquette, un bloc vertical « SIDES: », une étiquette verticale du nombre de boîtes et un pied de page inversé avec l'adresse du client, de retour en mode horizontal. Des commentaires figurent sur les lignes qui utilisent l'orientation, les ancrages, le déplacement du curseur et les cadres. Ajoutez une fonction setupPreviewData() pour l'exécuter en aperçu, et exécutez-la uniquement sur une imprimante d'étiquettes Brother.

Script 6 : étiquette verticale de boîte à pizza

function print() {
  PrintJob.SetCursorPosition(0, 0);         // jump to the label's top-left corner
  PrintJob.AddBox(812, 307, 2);             // outer border for the whole label
  PrintJob.MoveCursorPosition(777, 0);      // move to the right edge for the corner box

  PrintJob.AddBox(35, 35, 2);               // small callout box
  PrintJob.MoveCursorPosition(10, 10);      // move inside the callout box
  PrintJob.AddLine("C");

  PrintJob.MoveCursorPosition(770, -10);    // move to where the vertical tag will start
  PrintJob.Orientation = 2;                 // switch to Vertical; keeps the current position

  PrintJob.Reverse = true;
  PrintJob.FixYPosition = true;             // anchor for the "P" / "0006" pair
  PrintJob.AddLeftAndRightLine("P", "0006");
  PrintJob.MoveCursorPosition(0, -35);      // move along the label's length before the next section
  PrintJob.FixYPosition = false;            // release the anchor

  PrintJob.Reverse = false;
  PrintJob.AddLeftAndRightLine('14" ORIGINAL', " ");
  PrintJob.Reverse = true;                  // black background for the next three lines
  PrintJob.AddLeftAndRightLine("# G-PARM SWIRL", " ");
  PrintJob.AddLeftAndRightLine("# CLEAN CUT", " ");
  PrintJob.AddLeftAndRightLine("# SQUADERE CUT", " ");
  PrintJob.Reverse = false;
  PrintJob.AddLeftAndRightLine("HAWAIIAN BBQ Chicken", "");

  PrintJob.MoveCursorPosition(30, -8);      // move past the last column before the divider
  PrintJob.AddBox(2, 307, 2);               // plain line

  PrintJob.AddBoxToAxis(0, 35, 35);         // customer address bar: spans back to the label edge without moving the cursor

  PrintJob.MoveCursorPosition(0, 40);       // move into the SIDES: block
  PrintJob.FixYPosition = true;             // anchor for the whole SIDES: block
  PrintJob.Reverse = false;
  PrintJob.AddLine("");
  PrintJob.AddLine("SIDES:");
  PrintJob.AddLine("");
  PrintJob.AddLine("+1 Garlic Sauce");
  PrintJob.AddLine("+1 Pepperoncini");

  PrintJob.SetCursorPosition(10, 40);       // jump to the box-count tag's position
  PrintJob.FixYPosition = true;             // anchor for the "031126" / "5 of 5" pair
  PrintJob.AddLeftAndRightLine("031126", "5 of 5");
  PrintJob.Orientation = 1;                 // back to Horizontal for the footer

  PrintJob.SetCursorPosition(8, 0);         // jump to the footer's starting position
  PrintJob.Reverse = true;
  PrintJob.AddLine("Customer Address: 1234");
  PrintJob.Reverse = false;                 // reset styles before the cut
  PrintJob.AddCut(85);
}

11. Essais et validation

11.1 Procédure

  1. Commencez dans un emplacement hors production ou avec un ensemble de modifications de test.

  2. Confirmez que l'indicateur de fonctionnalité PARPOS.EnableScriptPrintingConfiguration est activé pour le groupe cible.

  3. Créez le script avec un nom clair et le bon type de document.

  4. Rédigez setupPreviewData() avec des valeurs représentatives : noms longs, nombreux modificateurs, modificateurs imbriqués, combos, annulations, rabais, état de commande future, données de livraison et champs facultatifs manquants (client null, groupes d'articles vides, aucun mode de paiement).

  5. Exécutez l'aperçu et corrigez chaque erreur de validation avant d'enregistrer.

  6. Assignez le script sous Options > Impression > Reçu ou Bon.

  7. Publiez l'ensemble de modifications et confirmez que la caisse a reçu les paramètres mis à jour et que l'imprimante prévue est configurée.

  8. Effectuez un essai d'impression physique sur l'imprimante cible par le chemin de connexion réel.

  9. Comparez la sortie avec la mise en page attendue.

  10. Testez la solution de repli : désactivez l'indicateur de fonctionnalité ou retirez la sélection du script dans un environnement contrôlé et confirmez que la mise en page intégrée s'imprime.

  11. Testez les cas d'échec : script invalide, données facultatives manquantes, imprimante hors ligne, imprimante principale indisponible et fonctionnalité matérielle non prise en charge.

11.2 Ce qu'il faut vérifier sur papier

Vérification Ce qu'il faut observer
Largeur de ligne Aucune ligne coupée ou tronquée, y compris en double largeur et avec les noms d'articles réels les plus longs.
Alignement Les colonnes de gauche et de droite sont alignées; les lignes centrées sont bien centrées.
Mise en évidence Bold, Red, Reverse, la double hauteur et la double largeur apparaissent comme prévu, ou se dégradent de façon lisible lorsqu'ils ne sont pas pris en charge.
Codes Le code à barres et le code QR se lisent de façon fiable à une distance et à un contraste normaux.
Images Le logo stocké s'imprime, avec le bon numéro d'image.
Coupe et avance Un reçu est coupé exactement une fois. Les billets et les étiquettes sont coupés aux endroits prévus.
Ordre des articles Les articles, les modificateurs et les enfants de combos apparaissent dans l'ordre et avec l'indentation attendus.
Totaux Le sous-total, les rabais, les frais supplémentaires, les taxes, l'arrondi et le total concordent; le solde dû ou la monnaie à rendre est correct.
Billets multiples Chaque billet d'une tâche à billets multiples comporte le bon en-tête et le bon indice de billet.
État de l'étiquette Sur les étiquettes, rien (gras, double hauteur ou largeur, justification) ne se reporte d'une étiquette à la suivante.
IMPORTANT: Un script n'est prêt pour la production que lorsque la sortie de l'aperçu et la sortie physique ont été validées sur le modèle d'imprimante et l'émulation certifiés du client.

12. Dépannage et FAQ

12.1 Dépannage

Symptôme Cause probable Correctif
« Le script est invalide. » en aperçu Erreur de syntaxe, variable non déclarée, print() ou setupPreviewData() manquant, ou mot restreint n'importe où dans le texte. Lisez le message. Vérifiez la casse, les accolades et les noms de fonctions. Recherchez des mots restreints dans tout le script, y compris les commentaires et les chaînes.
« L'identifiant ... a déjà été déclaré » Un const ou let de niveau supérieur dans un script validé pour l'aperçu. Utilisez var au niveau supérieur, ou déplacez la déclaration dans une fonction.
« X n'est pas défini » Mode strict et variable non déclarée, ou Printer référencé dans un script de reçu. Déclarez la variable. N'utilisez Printer que dans les scripts de billets.
« Le script contient un motif non autorisé » Un mot restreint tel que document ou window dans un commentaire ou une chaîne. Reformulez-le, par exemple « Script type » au lieu de « Document type ».
L'ancienne mise en page s'imprime après la publication Indicateur désactivé, aucun script sélectionné, ensemble de modifications non publié, ou échec du script et retour silencieux de la caisse à la solution de repli. Activez l'indicateur, sélectionnez le script, publiez, actualisez les paramètres de la caisse et consultez les journaux de la caisse pour y trouver l'erreur du script.
Sortie vide print() n'effectue aucun appel à PrintJob, ou l'exécution a échoué avant la sortie. Ajoutez PrintJob.AddLine("Test"), validez, puis ajoutez la logique étape par étape.
L'impression se fait sur la mauvaise imprimante La sélection du script et l'acheminement vers l'imprimante sont des paramètres distincts. Examinez Options > Impression, la configuration de l'imprimante, la destination de cuisine, le type de billet, la file d'impression et les paramètres de connexion.
Données de billet manquantes Des champs propres aux reçus sont utilisés dans un billet, ou une valeur facultative est absente. N'utilisez les champs propres aux billets que dans les scripts de billets; protégez les propriétés facultatives.
Erreur de fonction d'aide pour les dates « non reconnu comme une date/heure valide » Un objet Date a été transmis à PrintHelper. Transmettez new Date(value).toISOString() .
AddFilledLine échoue Une chaîne de plus d'un caractère a été transmise. Transmettez un seul caractère, comme "-". Pour répéter un motif, utilisez "-".repeat(n) avec AddLine.
Mauvais symbole monétaire ConvertDecimalToCurrencyString suit la culture de l'ordinateur. Construisez le montant avec "\$" + value.toFixed(2).
Le nom du client est manquant ou génère des erreurs Order.Customer est null. Vérifiez Order.Customer avant de lire ses champs.
Le texte est tronqué ou se coupe de façon inattendue Contenu plus large que l'imprimante, ou double largeur utilisée. Raccourcissez ou divisez les lignes, utilisez les méthodes à colonnes et faites des essais sur l'imprimante.
Red ou Reverse est absent L'imprimante, le ruban, l'émulation ou le pilote ne le prend pas en charge. Confirmez le matériel et l'émulation. Prévoyez une solution de repli lisible en texte normal.
Le code QR ou le code à barres ne se lit pas, ou le script échoue Symbologie ou imprimante non prise en charge, taille, zone de silence ou qualité d'impression. Utilisez une méthode et une symbologie prises en charge pour cette imprimante et faites des essais physiques.
L'image ne s'imprime pas L'image ne se trouve pas dans la mémoire NVRAM de l'imprimante, ou le mauvais numéro a été utilisé. Certaines imprimantes génèrent une erreur avec AddImage. Stockez l'image au moyen du processus d'imprimante pris en charge et utilisez son numéro avec AddImage.
L'étiquette est pivotée ou mal placée L'orientation ou l'état du curseur s'est reporté, ou les coordonnées ont été conçues pour une autre taille d'étiquette. Définissez l'orientation explicitement au début, réinitialisez les styles et testez les coordonnées en points d'imprimante.
L'étiquette suivante commence en gras ou en double hauteur Bold, DoubleHeight, DoubleWidth ou la justification ne sont pas réinitialisés par une coupe. Désactivez-les avant AddCut .
L'imprimante principale est hors ligne Défaillance de l'imprimante physique ou de la file d'impression. Suivez la procédure de basculement d'imprimante du site. Un script ne garantit pas l'acheminement vers une imprimante de secours.

12.2 Comportement hors ligne

Lorsque la caisse est hors ligne par rapport aux services de niveau supérieur au magasin, les paramètres et les scripts qu'elle a déjà téléchargés peuvent continuer d'être utilisés, sous réserve du comportement de la mémoire cache locale des paramètres. Un script ne peut pas récupérer de nouvelles données ni appeler de services externes. Si le script n'est pas présent localement, si les paramètres sont périmés ou si l'imprimante ou la file d'impression locale est indisponible, l'impression suit le comportement existant de la caisse en cas d'échec et de repli. Validez le fonctionnement hors ligne sur le déploiement cible, car le comportement de la mémoire cache et de la file d'impression dépend de l'environnement.

12.3 Foire aux questions

L'impression par script remplace-t-elle la configuration existante des reçus et des billets?

Non. Lorsqu'il est activé et sélectionné, un script a préséance. Si l'indicateur est désactivé, qu'aucun script n'est sélectionné ou que l'exécution échoue, la configuration existante de Options > Impression est utilisée.

Puis-je appeler des API externes à partir d'un script?

Non. fetch, XMLHttpRequest et les éléments semblables sont restreints, et l'environnement isolé n'a aucun accès au réseau. Un script ne fonctionne qu'avec les données que la caisse fournit (ou les données d'aperçu).

Puis-je utiliser un même script pour les reçus et les billets?

Pas en pratique. Les scripts sont créés et assignés par type de document, les données diffèrent et Printer n'existe pas dans les scripts de reçus.

Dois-je appeler AddCut?

Dans un script de billet ou d'étiquette, oui : terminez avec PrintJob.AddCut(85). Dans un script de reçu, non : le reçu est avancé et coupé automatiquement.

Pourquoi mon reçu est-il revenu silencieusement à l'ancien format?

Une erreur de validation ou d'exécution ne renvoie rien et la caisse imprime la mise en page intégrée. L'erreur ne figure que dans les journaux. Validez de nouveau en aperçu et consultez les journaux.

AddBox est-il valide pour toutes les imprimantes?

Non. Les commandes de cadre et de curseur sont destinées aux imprimantes d'étiquettes Brother prises en charge. Utilisez AddFilledLine pour les séparateurs sur les imprimantes de reçus.

Un script contrôle-t-il l'imprimante de secours?

Pas universellement. Le contenu du script et le basculement physique sont distincts; l'acheminement vers l'imprimante de secours dépend de la configuration de l'imprimante et de la file d'impression, et doit être testé sur place.

Quelles fonctionnalités JavaScript puis-je utiliser?

La syntaxe moderne prise en charge par Jint 4.1.0, y compris les fonctions fléchées, le chaînage optionnel, les gabarits de chaînes littérales et padStart. Utilisez var au niveau supérieur.

Comment imprimer un logo stocké?

Stockez l'image dans la mémoire NVRAM de l'imprimante au moyen du processus d'imprimante pris en charge et appelez PrintJob.AddImage(id) avec son numéro d'image.

Annexe A. Données d'aperçu

Exemples pour setupPreviewData(). Les valeurs sont des valeurs fictives. En production, la caisse fournit les objets réels et n'appelle jamais setupPreviewData().

A.1 Structures des objets

Une affectation par objet imbriqué de Order, en utilisant les membres énumérés à la section 6.2. Order.Employee et Order.ClosedByEmployee partagent la même structure. Les collections qui contiennent des articles (Items, VoidItems, PreviousItems, BagItems, AllItems) partagent la structure d'article.

Commun aux scripts de reçus et de billets

function setupPreviewData() {
  Order.Customer = { FirstName: "Test", LastName: "Name", FullName: "Test Name", PhoneNumber: "12435456" };
  Order.Delivery = {
    Address: { Address1: "Address 1", Address2: "Address 2", City: "Test city", State: "Test state", PostalCode: "12345678" },
    PhoneNumber: "1243635123"
  };
  Order.Destination = {
    Id: 1, Indicator: "Test indicator", KitchenChitHeader: "TestKitchenHead",
    KitchenDescription: "Test description", IsDelivery: true, Name: "Test name"
  };
  Order.Discounts = [{ PrintedName: "TestPrintedName", Name: "TestName", Amount: 19.68 }];
  Order.Employee = { DisplayName: "DisplayTestName", FirstName: "TestFirstName", LastName: "TestLastName", IsTraining: false };
  Order.Lane = { Name: "TestLane", Prefix: "TestPrefix" };
  Order.MarketingCampaigns = [{ Name: "TestCampaignName" }];
  Order.Party = { Name: "TestParty", OrderNumber: 1234 };
  Order.Promotions = [{ PrintedName: "TestPromotionDisplayName", Name: "TestPromotionName", Amount: 11.84 }];
  Order.Surcharges = [{ Name: "TestSurcharges", Amount: 22.38 }];
  Order.Taxes = [{ Name: "TestTaxName", Amount: 14.12 }];
  Order.Terminal = { Name: "test" };
  Order.Items = [{
    Id: 1, ItemId: 1214, Voided: false, IsTaxFree: true, Quantity: 2,
    Description: "Amer - Hamburger", Price: 7.5, PriceWithModifiers: 8.5, Note: "Order Notes",
    Modifiers: [{ Id: 1, ItemId: 123214, Description: "Extra Cheese", Price: 1.0 }]
  }];
}

Scripts de billets seulement

Order.KeyIngredients = [{ Count: 2, Text: "Key ingredient 1" }];
// Premiers éléments, BagItems et AllItems utilisent tous la forme de l'objet. Sur les jetons, un modificateur
// est réduit à Description et ItemId.
Order.PreviousItems = [{
  Id: 1, ItemId: 1214, Quantity: 2, Description: "Amer - Hamburger", Price: 7.5,
  AutoNumberPrefix: "pref", AutoNumber: 1, Note: "Order Notes",
  Modifiers: [{ Description: "Extra Cheese", ItemId: 123214 }]
}];

Scripts de reçus seulement

Order.ReceiptPrintCount = 1;

A.2 Combos et articles composites sur un billet

Exemple de données avec des articles composites (combos). Chaque combo contient des CompositeOrderItems imbriqués, chacun avec ses propres ItemGroups et Modifiers, à côté d'articles autonomes qui réutilisent les mêmes identifiants d'articles du menu. Utilisez-le pour tester la logique des billets, comme le modèle d'articles en boîte de la section 10.3, par rapport à des structures de combos réalistes. Il ne définit que setupPreviewData(); ajoutez votre propre print().

Données d'aperçu d'un billet de combo

// Build one item. parentId is 0 for a top-level item, or the Id of its parent combo.
function mk(id, itemId, desc, kitchen, sort, group, parentId, children, mods) {
  return {
    Id: id, ItemId: itemId, Quantity: 1, IsDeleted: false,
    Description: desc, AlternateKitchenName: kitchen, SortPriority: sort,
    ItemGroups: group ? [group] : [],
    CompositeOrderItemId: parentId,
    CompositeOrderItems: children || [],
    Modifiers: mods || []
  };
}

function setupPreviewData() {
  Store.Name = "Culver's 99999";
  Store.Address1 = "Prairie du Sac";
  Store.State = "WI";
  Store.Phone = "608-643-7980";
  Order.CreatedDate = new Date();
  Order.Id = "AAAE6LTF9QAE";
  Order.Destination = { Name: "Online Carryout" };
  Order.Name = "John Doe";
  Order.PromiseTime = new Date();
  Order.Total = 45.99;

  var DISCOUNTABLE = { Id: 1, Name: "Discountable Items" };
  var SIDES = { Id: 3, Name: "Sides" };
  var CHICKEN = { Id: 44, Name: "CHICKEN" };

  Order.Items = [
    // Combo: Dinner (id 1) with three children
    mk(1, 1, "Dinner", "Din", 2, DISCOUNTABLE, 0, [
      mk(2, 2, "6 Piece Shrimp (Dnr)", "6 SHRIMP", 1, DISCOUNTABLE, 1, [], [
        { Id: 3, ItemId: 3, Description: "Cocktail Sauce" },
        { Id: 4, ItemId: 4, Description: "Boom Boom Sauce" }
      ]),
      mk(5, 5, "French Fries MED", "FRY", 4, SIDES, 1),
      mk(6, 6, "Coleslaw MED", "SLAW", 5, { Id: 4, Name: "Drinks" }, 1)
    ]),
    // Combo: Value Basket (id 7) with four children
    mk(7, 7, "Value Basket", "VB", 3, null, 0, [
      mk(8, 8, "Crispy Chicken Sandwich", "CRSP CHIX", 3, CHICKEN, 7),
      mk(9, 9, "Regular VB", "OLO ID: 217270 91573227520", 1, { Id: 2, Name: "Regular" }, 7),
      mk(10, 5, "French Fries MED", "FRY", 5, SIDES, 7),
      mk(11, 11, "Root Beer MED", "RT BR MED", 6, { Id: 4, Name: "DRINKS" }, 7)
    ]),
    // Standalone items that reuse ItemIds from the combos
    mk(12, 5, "French Fries MED", "FRY", 5, SIDES, 0),
    mk(13, 8, "Crispy Chicken Sandwich", "CRSP CHIX", 6, CHICKEN, 0)
  ];
}
REMARQUE:La référence aux objets de ce guide s'appuie également sur la documentation de référence antérieure des scripts d'imprimante, qui a été compilée à partir de notes locales sur les scripts d'imprimante..