יצירת קודי QR אוטומטית למוצרי 1C-Bitrix – מדריך מעשי

הגדרת יצירת קודי QR אוטומטית למוצרים ב-1C-Bitrix

כשמשיקים נקודת מכירה עם תצוגת קודי QR או מתייגים אריזות למחסן, עולה המשימה: ליצור קוד ייחודי לכל יחידת מוצר. יצירה ידנית של אלפי תמונות אינה אופציה. אנו מגדירים יצירת קודי QR אוטומטית ב-Bitrix במפתח מלא: מבחירת ספרייה ועד אינטגרציה עם תהליכי מחסן. צרו קשר כדי להעריך את הפרויקט שלכם.

הקשיים העיקריים שאנו פותרים: עומס גבוה במהלך יצירה המונית (1000+ מוצרים), צורך בתמיכה בפורמטים שונים (PNG, SVG) והבטחת קריאות הקוד על גבי אריזות. הניסיון שלנו מראה שהגדרה נכונה חוסכת עד 80% מזמן המנהל. ללא אוטומציה, מנהלים מבלים שעות ביצירת QR דרך שירותי צד שלישי, וכשמעדכנים מחירים או תיאורים, יש ליצור קודים מחדש ידנית. אנו מפתחים פתרון שמשתלב עם הקטלוג שלכם ומייצר קודים תוך כדי תנועה או לפי לוח זמנים. כתוצאה מכך, אתם מקבלים PNG מוכן להדפסה עם לוגו החברה וקישורים קצרים למעקב המרות. אוטומציה של יצירת קודי QR מחזירה את ההשקעה בממוצע תוך 2-3 חודשים של פעילות מחסן, ובמונחים כספיים, החיסכון יכול להגיע עד $360–520 לחודש. עלות הפיתוח של אינטגרציה כזו מתחילה מ-$450–650, וההשפעה הכלכלית מגיעה ל-$1.8k–2.6k בשנה.

בחירת ספרייה ליצירת QR

ל-1C-Bitrix אין מחולל קודי QR מובנה. ספריית צד שלישי מחוברת דרך Composer. שתי אפשרויות פופולריות:

endroid/qr-code מספקת פונקציונליות עשירה: תמיכה ב-PNG עם לוגו, רמות תיקון שגיאות מרובות, עבודה עם קידודים שונים. chillerlan/php-qrcode קלה ומהירה יותר, אינה דורשת את הרחבת GD. בהשוואה ל-chillerlan, endroid עשירה פי 3 בתכונות ותומכת במיתוג.

עבור רוב הפרויקטים, אנו בוחרים ב-endroid/qr-code בשל הגמישות ויכולות המיתוג שלו.

מה לקודד בקוד ה-QR

תכנים אפשריים של ה-QR:

• כתובת URL של כרטיס המוצר — אופציה אוניברסלית למעבר לאתר
• קישור UTM — עם תגי מקור לאנליטיקת המרות אופליין/אונליין
• SKU — לשימוש פנימי במחסן, נסרק על ידי טרמינל
• קישור למדריך או תעודה — לחלק התיעודי

חשוב: כתובת ה-URL חייבת להיות קצרה, אחרת ה-QR הופך צפוף וקשה יותר לקריאה עם סורקים זולים. עבור כתובות ארוכות, השתמשו במפנה משלכם: https://shop.ru/go/A123/ → הפניה → כתובת URL בפועל. שימוש בקישורים קצרים מפחית את צפיפות ה-QR ב-30%.

כיצד מיושמת היצירה ב-Bitrix

התקנת הספרייה:

composer require endroid/qr-code # или composer require chillerlan/php-qrcode 

מחלקת מחולל בסיסית עם שמירה במטמון:

namespace Custom\Catalog; use Endroid\QrCode\Builder\Builder; use Endroid\QrCode\Encoding\Encoding; use Endroid\QrCode\ErrorCorrectionLevel; use Endroid\QrCode\Writer\PngWriter; class ProductQrGenerator { private string $uploadDir; public function __construct() { $this->uploadDir = $_SERVER['DOCUMENT_ROOT'] . '/upload/qr/'; if (!is_dir($this->uploadDir)) mkdir($this->uploadDir, 0755, true); } public function generateForProduct(int $productId, string $url): string { $fileName = 'product-' . $productId . '.png'; $filePath = $this->uploadDir . $fileName; if (file_exists($filePath)) return '/upload/qr/' . $fileName; $result = Builder::create() ->writer(new PngWriter()) ->data($url) ->encoding(new Encoding('UTF-8')) ->errorCorrectionLevel(ErrorCorrectionLevel::High) ->size(400)->margin(10) ->build(); $result->saveToFile($filePath); return '/upload/qr/' . $fileName; } public function generateBatch(array $productIds): void { foreach ($productIds as $id) { $element = \CIBlockElement::GetByID($id)->GetNextElement(); if (!$element) continue; $fields = $element->GetFields(); $url = 'https://' . SITE_SERVER_NAME . $fields['DETAIL_PAGE_URL']; $this->generateForProduct($id, $url); } } } 

יצירה אוטומטית בעת הוספת מוצר דרך מטפל האירועים composer require endroid/qr-code # или composer require chillerlan/php-qrcode , כמתואר בתיעוד 1C-Bitrix:

AddEventHandler('iblock', 'OnAfterIBlockElementAdd', function(&$fields) { if ($fields['IBLOCK_ID'] != CATALOG_IBLOCK_ID) return; $generator = new \Custom\Catalog\ProductQrGenerator(); $url = 'https://' . SITE_SERVER_NAME . '/catalog/item/' . $fields['CODE'] . '/'; $generator->generateForProduct($fields['ID'], $url); }); 

הצגת קוד ה-QR בתבנית כרטיס המוצר:

<?php if (!empty($arResult['PROPERTIES']['QR_CODE_URL']['VALUE'])): ?> <div class="product-qr"> <img src="<?= $arResult['PROPERTIES']['QR_CODE_URL']['VALUE'] ?>" alt="QR-код товара" width="120" height="120"> <a href="<?= $arResult['PROPERTIES']['QR_CODE_URL']['VALUE'] ?>" download="qr-<?= $arResult['ID'] ?>.png">Скачать QR</a> </div> <?php endif; ?> 

מדוע שמירת קודי QR במטמון חשובה

יצירת כל קוד QR היא פעולה יקרה. בעת ייצוא המוני של תוויות (1000+ מוצרים), השרת עלול לא לעמוד בעומס ללא שמירה במטמון. במחלקה שלנו, נבדקת קיום הקובץ לפני יצירה מחדש. זה מפחית את העומס ב-90% בריצות חוזרות. יצירה אצווה של 500 מוצרים אורכת כ-2 דקות עם שמירה במטמון.

מה כלול בעבודה

תוצרי העבודה כוללים:

1. ניתוח הקטלוג הנוכחי ותרחישי שימוש ב-QR
2. בחירה וחיבור הספרייה דרך Composer
3. יישום מחולל עם שמירה במטמון ועיבוד אצווה
4. הגדרת יצירה אוטומטית בעת הוספה/עדכון מוצרים
5. אינטגרציה עם ייצוא תוויות (פורמטים PNG, SVG)
6. יצירת הפניות קצרות (אופציונלי)
7. תיעוד והדרכת צוות
8. קוד מקור מלא ומדריך פריסה
9. אחריות ותמיכה ל-12 חודשים

העבודה מכוסה באחריות ל-12 חודשים.

לוחות זמנים

טעויות נפוצות ביצירת קודי QR וכיצד למנוע אותן

שתי בעיות נפוצות: קוד לא קריא עקב עומס נתונים ושכפול קבצים בעת יצירה מחדש. כדי להימנע מהראשונה, השתמשו ברמות תיקון שגיאות של לפחות M, ולנתונים צפופים — H. השנייה נפתרת על ידי שמירה במטמון לפי מזהה מוצר, כפי שמוצג בקוד למעלה. רמת תיקון שגיאות H מבטיחה קריאות של 99.5% תחת נזק בינוני.

לאחר הגדרה חד-פעמית, היצירה פועלת ללא התערבות מנהל — זו אוטומציה שבה רק התוצאות מורגשות. הזמינו הגדרת יצירת QR ופשטו את עבודת המחסן. קבלו ייעוץ והערכת עלות מפורטת לפרויקט שלכם. לצוות שלנו ניסיון עם למעלה מ-50 פרויקטים של שילוב שירותים חיצוניים.