افزودن بارکد و کد QR به قالب‌ها

این راهنما نشان می‌دهد چگونه بارکد‌های قابل‌اسکن یا کدهای QR را به قالب‌های چاپ خود اضافه کنید تا مشتریان، کارکنان یا سیستم‌ها بتوانند سریع داده‌های سند، محصول یا تماس را دسترسی پیدا کرده یا شناسایی کنند.

قبل از شروع:

• شما باید اجازه ویرایش قالب‌های چاپ را داشته باشید.
• تصمیم بگیرید که هر بارکد چه داده‌ای را رمزگذاری کند: شماره فاکتور، کد محصول، شناسه مشتری، نسخه یا URL.
• اطمینان حاصل کنید که قالب شما متغیرهای لازم را دارد (مثلاً {{invoice.number}}، {{product.barcode_value}}). اگر مطمئن نیستید، راهنمای متغیرها را مشاوره کنید.
• برای تست خروجی، اسکن‌کننده بارکد یا گوشی‌هوشمند با برنامه خواننده QR داشته باشید.

افزودن بارکد یا کد QR:

1. ویرایشگر قالب را باز کنید. به تنظیمات → قالب‌های چاپ بروید و قالبی را که می‌خواهید ویرایش کنید انتخاب کنید.

2. مکانی را پیدا کنید که می‌خواهید کد را اضافه کنید. بخش HTML را پیدا کنید جایی که می‌خواهید بارکد یا کد QR ظاهر شود (مثلاً پاصفحه، گوشه بالا راست، زیر جزئیات مشتری).

3. کمک‌دهنده بارکد را اضافه کنید. یکی از کمک‌دهندگان Handlebars زیر را به HTML خود درج کنید:

   برای بارکد (خطی، بهترین برای کدهای محصول یا شماره‌های فاکتور):

   {{barcode variable_name type="code128"}}
   

   نمونه:

   <img src="{{barcode invoice.number type='code128'}}" alt="بارکد فاکتور" />
   

   برای کد QR (مربعی، بهترین برای URL یا داده‌های طولانی‌تر):

   {{qrcode variable_name}}
   

   نمونه:

   <img src="{{qrcode invoice_url}}" alt="کد QR فاکتور" />
   

4. اطمینان حاصل کنید که متغیر داده را شامل می‌شود. متغیری که استفاده می‌کنید باید در سند شما موجود باشد و داده‌ای را شامل کند که می‌خواهید رمزگذاری شود. برای مثال:

   • {{barcode invoice.number}} شماره فاکتور را رمزگذاری می‌کند.
   • {{qrcode customer.contact_url}} URL تماس مشتری را رمزگذاری می‌کند.
   • اگر متغیر در سند خالی باشد، بارکد/کد QR نمایش داده نخواهد شد.

5. خروجی را تست کنید. قالب خود را ذخیره کنید و سند آزمایشی را چاپ یا پیش‌نمایش کنید. بارکد یا کد QR را با تجهیزات مناسب اسکن کنید تا تأیید کنید که داده صحیح را رمزگذاری می‌کند.

انواع بارکد رایج:

برای مشخص کردن فرمت بارکد از پارامتر type= استفاده کنید:

بهترین عمل‌های کد QR:

• برای URL استفاده کنید: پیوند به درگاه فاکتور آنلاین، درگاه مشتری یا صفحه پرداخت را رمزگذاری کنید. نمونه: {{qrcode invoice_payment_url}}.
• برای داده تماس استفاده کنید: اطلاعات مشتری یا تامین‌کننده را به فرمت vCard رمزگذاری کنید. نمونه: {{qrcode contact.vcard_url}}.
• برای داده‌های طولانی استفاده کنید: کدهای QR می‌توانند داده بیشتری نسبت به بارکدهای خطی (تا ~4000 کاراکتر) را حفظ کنند، بنابراین برای اطلاعات پیچیده ایده‌آل هستند.

اندازه‌گذاری بارکد یا کد QR:

بارکد را در برچسب <div> یا <img> بپیچید و از CSS برای کنترل اندازه آن استفاده کنید:

<div style="text-align: center; margin: 10px 0;">
  <img src="{{qrcode invoice.number}}" alt="QR فاکتور" style="width: 100px; height: 100px;" />
</div>

نکات و اشتباهات رایج:

• مطمئن شوید متغیر وجود دارد. اگر از {{qrcode undefined_variable}} استفاده کنید، کد QR نمایش داده نخواهد شد. همیشه به متغیرهایی ارجاع دهید که در نوع سند شما موجود هستند.
• قبل از چاپ در مقیاس بزرگ تست کنید. تأیید کنید که بارکدها/کدهای QR با سخت‌افزار واقعی (اسکن‌کنندگان، گوشی‌های هوشمند) به‌درستی اسکن می‌شوند قبل از درج قالب برای تمام سازمان.
• به‌وضوح مکان تعیین کنید. بارکدها و کدهای QR را در مکانی برجسته، آسان‌اسکن (مثلاً گوشه بالا راست، پاصفحه) قرار دهید و اطمینان حاصل کنید که توسط محتوای دیگری مسدود نیستند.
• فقط بر رنگ متکی نباشید. اگرچه می‌توانید رنگ را به ناحیه بارکد اضافه کنید، تباین کافی برای اسکن ایجاد کنید. بارکدهای سیاه روی پس‌زمینه سفید قابل‌اعتماد‌ترند.