Éditeur de code des reçus imprimés pour votre Shopify POS

Avant d’utiliser l’éditeur de code des reçus, examinez les considérations suivantes :

Restrictions d’accès

• Vous pouvez utiliser l’éditeur de code uniquement depuis votre interface administrateur Shopify sur un ordinateur de bureau.
• L’éditeur de code n’est disponible pour aucun emplacement POS en Italie ou en France.
• Aucune nouvelle boutique et aucun nouvel emplacement ne peuvent être ajoutés à l’éditeur de code. L’éditeur de code reste disponible pour les boutiques dont les personnalisations existantes n’ont pas été migrées.

Où les modifications s’appliquent

• Les modifications de code que vous apportez s’appliquent uniquement à l’emplacement sélectionné.
• Les personnalisations dans l’éditeur de code s’appliquent uniquement aux emplacements POS Pro. Si vous utilisez l’éditeur de code et que vous avez des emplacements qui n’utilisent pas POS Pro, vous pouvez utiliser l’éditeur visuel pour personnaliser l’en-tête et le pied de page de ces emplacements.
• Vous pouvez personnaliser les reçus imprimés qui disposent d’un modèle dans l’éditeur de code, tels que les reçus de vente, les reçus de cadeau, les reçus de carte-cadeau ainsi que les reçus de retour et d’échange.

Langages de code

• Les fichiers qui composent vos reçus contiennent du Liquid, le langage de modélisation de Shopify. En savoir plus sur l’utilisation de Liquid.
• Pour modifier les modèles dans l’éditeur de code des reçus, vous devez bien connaître le HTML, le CSS et Liquid. L’assistance technique pour les thèmes Shopify ne peut pas modifier vos modèles de reçu de manière approfondie, mais elle peut vous aider à apporter des modifications mineures aux thèmes Shopify gratuits dans le cadre de la Politique de conception de Shopify. Pour des modifications plus complexes, envisagez d’engager un Partenaire Shopify.

Limites de personnalisation

• Vous ne pouvez pas prévisualiser les reçus dans différentes tailles d’imprimante depuis l’éditeur de code. Pour les prévisualiser par taille d’imprimante, utilisez l’éditeur visuel.
• Les descriptions de produits ne sont pas disponibles en tant que variable dans les modèles de reçus et ne peuvent pas être ajoutées aux reçus imprimés.

Maintenance du modèle

• Les modèles de reçus dans l’éditeur de code ne reçoivent plus de mises à jour. Les propriétés ajoutées après le 1er juin 2026 ne sont disponibles que dans l’éditeur visuel.
• La réinitialisation d’un modèle à sa version par défaut n’est plus prise en charge. Pour revenir à un modèle par défaut, effectuez une migration vers l’éditeur visuel.

Les étapes pour passer d’un éditeur à l’autre diffèrent légèrement selon que tous vos emplacements POS sont admissibles à l’éditeur de code, ou que seuls certains de vos emplacements POS le sont. Par exemple, si certains de vos emplacements POS n’utilisent pas POS Pro ou sont situés en Italie ou en France.

Étapes :

Vous pouvez utiliser des fichiers, tels que des ressources d’images, que vous chargez dans votre interface administrateur Shopify pour personnaliser vos reçus imprimés.

Un fichier doit être importé dans votre interface administrateur Shopify avant de pouvoir être utilisé dans un reçu imprimé. En savoir plus sur l’importation de fichiers.

Étapes :

1. Depuis votre interface administrateur Shopify, accédez à Contenu > Fichiers.

2. À côté du fichier que vous souhaitez inclure dans le code de votre reçu imprimé, cliquez sur pour copier le lien.

3. Accès à l’éditeur de code.

4. Incluez le lien de la ressource dans votre modèle.

La réinitialisation d’un modèle à sa version par défaut n’est pas prise en charge dans l’éditeur de code de reçus. Pour revenir à un modèle de reçu imprimé par défaut, effectuez une migration vers l’éditeur visuel de reçus, qui fournit un modèle par défaut avec tous les champs standards.

Les variables Liquid suivantes sont fournies à titre de référence pour vous aider à comprendre vos personnalisations de reçus existantes lors de la migration. Les nouvelles personnalisations doivent être créées dans l’éditeur visuel de reçus.

Les objets de données suivants sont disponibles dans l’éditeur de code des reçus :

Objets de reçu

shop

location

order

return

gift_card

Objet de commande

id

created_at

source_identifier

change_due

balance_due

name

note

line_items

subtotal_price

total_price

total_tip_received

discounts

transactions

taxes_included

tax_lines

customer

shipping_address

shipping_groups

Objet de retour

name

created_at

is_unverified

is_exchange

exchange_type

return_discount

return_subtotal

return_total

exchange_subtotal

exchange_total

total_cash_rounding_adjustment

total_adjusted_amount

net_total

return_line_items

exchange_line_items

return_tax_lines

exchange_tax_lines

shipping_refund_amount

tip_refund_amount

transactions

Objet de groupe d’expédition

destination

products

Objet d’article du panier

id

name

variant_title

price

is_gift_card

discount

total_price

selling_plan_name

tax_rates

custom_attributes

variant_title

variant_id

variant_metafields

staff_member_description

product_metafields

Objet d’article du panier retourné

Inclut tout ce qui se trouve dans l’objet d’article du panier, ainsi que les propriétés suivantes :

return_reason

return_reason_note

Vous pouvez utiliser des filtres Liquid pour ajuster les informations de vos modèles de reçus. Par exemple, vous pouvez modifier le format d’une devise ou la mise en majuscule d’un texte spécifique, comme un code des impôts.

Pour appliquer un filtre, ajoutez une barre verticale |, puis le filtre dans le bloc de code Liquid entre les doubles accolades {{ }}. Les filtres ne peuvent être appliqués qu’aux blocs de code Liquid.

Dans l’exemple suivant, le filtre convertit le code de taxe de minuscules en majuscules.

{{ tax_line.title | upcase }}

Dans l’exemple de bloc de code, product est l’objet, title est sa propriété et upcase est le filtre appliqué. Le filtre upcase met en majuscules la valeur de tax_line.title. Par exemple, si la valeur de tax_line.title est Hst, le filtre upcase la convertit en HST.

Consultez la section Filtres de la documentation de référence Liquid pour les thèmes Shopify pour en savoir plus sur l’utilisation des filtres Liquid.

Les filtres suivants sont disponibles dans l’éditeur de code de reçu :

t

money

escape

barcode

qrcode

Vous pouvez utiliser Liquid pour ajouter une messagerie conditionnelle. Cette fonctionnalité est similaire à l’enregistrement pour un seul emplacement avec l’éditeur visuel. Par exemple, votre entreprise a démarré avec un seul emplacement et vous disposez désormais de plusieurs nouveaux emplacements. Vous souhaitez mettre en évidence votre boutique d’origine sur vos reçus imprimés.

Vous pouvez ajouter un message personnalisé au modèle header.liquid dans le dossier Sections de l’éditeur de code, et utiliser Liquid pour afficher le message uniquement pour votre emplacement phare.

Le code suivant vérifie le nom de l’emplacement, dans ce cas votre emplacement d’origine appelé « Home », et affiche le message « Bienvenue dans notre boutique d’origine, ouverte en 1972. » si le nom de l’emplacement correspond. Les reçus imprimés depuis vos autres emplacements affichent plutôt le message « Bienvenue dans notre boutique. ».

{% if location.name == 'Home' %}
  Welcome to our original store, opened in 1972.
{% else %}
  Welcome to our store.
{% endif %}

Vous pouvez prévisualiser les modifications apportées à vos reçus imprimés dans l’éditeur de code POS de l’interface administrateur Shopify.

Selon le fichier Liquid sélectionné, la fenêtre d’aperçu met en surbrillance la partie du reçu (design ou section) modifiée par le fichier. Par défaut, la fenêtre d’aperçu affiche le contenu de votre commande POS la plus récente. Vous pouvez sélectionner une commande spécifique à utiliser comme contenu de reçu dans la fenêtre d’aperçu pour tous les fichiers Liquid, à l’exception du fichier gift-card.liquid, qui n’affiche que les différents emplacements en tant qu’options d’aperçu sélectionnables.

Étapes :