שילוב 1C-Bitrix עם סורקי ברקוד
תארו לעצמכם: במחסן, מנהל סורק ברקוד של קופסה, אבל המערכת לא מוצאת את הפריט—למרות שהברקוד קיים, הוא מקושר למוצר הלא נכון. או שהסורק מזין את הקוד אבל השדה לא בפוקוס, והנתונים הולכים לאיבוד. נתקלנו בזה עשרות פעמים במשך יותר מ-10 שנות ניסיון בשילובים ו-50+ פרויקטים מוצלחים. הפתרון טמון בטיפול נכון בסריקה בצד של Bitrix, לא בסורק עצמו. הניסיון שלנו מראה ש-90% מהבעיות נפתרות על ידי הגדרת הסיומת והפוקוס.
סורק ברקוד הוא הציוד ההיקפי הפשוט ביותר: הוא מחקה מקלדת ומזין את הקוד הסרוק לשדה הפעיל. הבעיה האמיתית היא מה המערכת עושה עם הקוד הזה: חיפוש מוצר, הוספה להזמנה, אימות פריט במהלך קטיף. שילוב הוא בעיקר על טיפול נכון בסריקה בצד של Bitrix, לא על הגדרת הסורק עצמו. אנו מבטיחים שאחרי ההתקנה שלנו, המערכת תעבוד ללא תקלות.
סוגי סורקים ושיטות חיבור
| סוג | חיבור | אמולציית מקלדת | יישום |
|---|---|---|---|
| USB HID | USB | כן | קופה, קבלה |
| Bluetooth HID | Bluetooth | כן | תחנה ניידת |
| COM-port | RS-232 | לא, עבודה ישירה עם הפורט | ציוד ישן |
| 2D imager (Honeywell, Symbol) | USB/BT | כן | QR + ברקוד |
| מובנה ב-TSD | USB/WiFi | דרך API של המכשיר | מחסן |
לרוב משימות Bitrix: סורק USB HID עובד הכי טוב—הם מתחברים ללא דרייברים. אין צורך בהגדרה מיוחדת בצד של Bitrix—רק לטפל בקלט בטופס בצורה נכונה. עם זאת, פורטים COM דורשים עבודה ישירה עם הפורט דרך API—זה יותר מורכב, אבל המומחיות המוסמכת שלנו מאפשרת לנו ליישם את זה ביומיים.
איך למצוא מוצר לפי ברקוד ב-Bitrix?
ברקודים ב-Bitrix מאוחסנים בטבלה b_catalog_product_barcode. Bitrix API Reference: b_catalog_product_barcode table לכל מוצר יכולים להיות מספר ברקודים (לדוגמה, אריזות שונות: פריט בודד וקופסה של 12 עם EAN שונים).
קוד PHP לחיפוש ברקוד
public static function findByBarcode(string $barcode): ?array
{
$result = \Bitrix\Catalog\EO_ProductBarcode_Collection::wakeUp(
\Bitrix\Catalog\ProductBarcodeTable::getList([
'filter' => ['=BARCODE' => $barcode],
'select' => ['PRODUCT_ID', 'BARCODE'],
])
);
$row = $result->fetch();
if (!$row) return null;
// Загружаем данные товара из каталога
$product = \CIBlockElement::GetByID($row['PRODUCT_ID'])->GetNext();
return [
'product_id' => $row['PRODUCT_ID'],
'name' => $product['NAME'],
'sku' => $product['PROPERTY_ARTICLE_VALUE'],
'price' => \CCatalogProduct::GetOptimalPrice($row['PRODUCT_ID'])['PRICE']['PRICE'] ?? 0,
'stock' => \CCatalogProduct::GetByID($row['PRODUCT_ID'])['QUANTITY'],
];
}אם הברקוד לא נמצא ב-public static function findByBarcode(string $barcode): ?array { $result = \Bitrix\Catalog\EO_ProductBarcode_Collection::wakeUp( \Bitrix\Catalog\ProductBarcodeTable::getList([ 'filter' => ['=BARCODE' => $barcode], 'select' => ['PRODUCT_ID', 'BARCODE'], ]) ); $row = $result->fetch(); if (!$row) return null; // Загружаем данные товара из каталога $product = \CIBlockElement::GetByID($row['PRODUCT_ID'])->GetNext(); return [ 'product_id' => $row['PRODUCT_ID'], 'name' => $product['NAME'], 'sku' => $product['PROPERTY_ARTICLE_VALUE'], 'price' => \CCatalogProduct::GetOptimalPrice($row['PRODUCT_ID'])['PRICE']['PRICE'] ?? 0, 'stock' => \CCatalogProduct::GetByID($row['PRODUCT_ID'])['QUANTITY'], ]; } , אנו מחפשים במאפיין אינפובלוק b_catalog_product_barcode (חלק מהפרויקטים מאחסנים ברקודים כמאפיין). אנו מאחדים דרך שיטת חיפוש אחת. הניסיון שלנו מראה ש-30% מהפרויקטים מאחסנים ברקודים רק במאפיינים—זה פי שניים איטי יותר מטבלת הברקודים.
הוספה לסל לפי ברקוד
רכיב הוספה מהירה לקופה או לסעיפי B2B מקל על פונקציונליות הוספה מהירה לסל.
JavaScript להוספה מהירה
// Обработчик ввода в поле поиска
const barcodeInput = document.getElementById('barcode-input');
barcodeInput.addEventListener('keydown', (e) => {
if (e.key === 'Enter') {
const barcode = e.target.value.trim();
if (!barcode) return;
fetch('/api/catalog/by-barcode/', {
method: 'POST',
headers: {
'Content-Type': 'application/json',
'X-Bitrix-Csrf-Token': BX.bitrix_sessid()
},
body: JSON.stringify({barcode})
})
.then(r => r.json())
.then(data => {
if (data.error) {
showError('Товар не найден: ' + barcode);
return;
}
addToCart(data.product_id, 1);
barcodeInput.value = '';
barcodeInput.focus();
});
}
});
נקודה חשובה: שדה הזנת הברקוד חייב להיות תמיד בפוקוס. לקופה, אנו מיישמים פוקוס אוטומטי עם PROPERTY_BARCODE—הסורק עשוי להזין קוד בכל רגע. בלי זה, 80% מהסריקות היו מתעלמות. צרו קשר—ניישם את זה במפתח מלא תוך 7–9 ימים.
אימות פריטים במהלך קטיף הזמנות
במהלך קטיף הזמנות במחסן: המנהל פותח את ההזמנה בפאנל הניהול של Bitrix, סורק את הברקוד של כל פריט. המערכת מדגישה את השורה שנמצאה בהזמנה ומסמנת תיבת סימון 'נקטף'. תהליך זה מהיר פי 3 מאימות ידני.
דף מותאם אישית ב-// Обработчик ввода в поле поиска const barcodeInput = document.getElementById('barcode-input'); barcodeInput.addEventListener('keydown', (e) => { if (e.key === 'Enter') { const barcode = e.target.value.trim(); if (!barcode) return; fetch('/api/catalog/by-barcode/', { method: 'POST', headers: {'Content-Type': 'application/json', 'X-Bitrix-Csrf-Token': BX.bitrix_sessid()}, body: JSON.stringify({barcode}) }) .then(r => r.json()) .then(data => { if (data.error) { showError('Товар не найден: ' + barcode); return; } addToCart(data.product_id, 1); barcodeInput.value = ''; barcodeInput.focus(); }); } }); :
מטפל PHP AJAX לסריקה
// AJAX-обработчик сканирования
if ($_REQUEST['action'] === 'scan_barcode') {
$barcode = trim($_REQUEST['barcode']);
$orderId = (int)$_REQUEST['order_id'];
$product = BarcodeService::findByBarcode($barcode);
if (!$product) {
echo json_encode(['status' => 'not_found', 'barcode' => $barcode]);
exit;
}
// Ищем товар в позициях заказа
$order = \Bitrix\Sale\Order::load($orderId);
$basket = $order->getBasket();
foreach ($basket as $item) {
if ($item->getProductId() === $product['product_id']) {
// Обновляем счётчик собранных
AssemblyProgressTable::increment($orderId, $product['product_id']);
echo json_encode(['status' => 'ok', 'item_id' => $item->getId()]);
exit;
}
}
echo json_encode(['status' => 'not_in_order', 'product' => $product['name']]);
exit;
}מלאי דרך סורק USB
למלאי משרדי ללא TSD: דף מיוחד עם טבלה שבה המנהל סורק ברקודים עם כמות קבועה. כל סריקה היא בקשת AJAX שמגדילה את מונה הפריט. בסוף הסשן, השוו עם המלאי ב-setInterval וייצאו פערים. הפתרון שלנו מאיץ את המלאי פי 3 בהשוואה לספירה ידנית, וחוסך עד $10,000 בשנה למחסן בינוני (5000 SKU). זה חלק מרכזי בניהול מחסן Bitrix ואוטומציית מחסן Bitrix.
איך ליישם סורק ברקוד ב-Bitrix (שלב אחר שלב)
- חברו את סורק הברקוד: בחרו סורק USB HID Bitrix להגדרה הקלה ביותר.
- הגדירו סיומת Enter לסורק: הגדירו את הסורק לשלוח Enter אחרי כל ברקוד.
- יישמו חיפוש מוצר לפי ברקוד: השתמשו בטבלת
/bitrix/admin/order_assembly.php(ראו קוד למעלה). - צרו רכיב הוספה מהירה לסל עם פוקוס אוטומטי.
- בנו ממשק קטיף הזמנות עם סורק.
- פיתחו מודול מלאי עם סורק ודוחות.
- בדקו עם סורק אמיתי והכשירו עובדים.
מה לעשות אם הסורק מוסיף תווים נוספים?
חלק מהסורקים מוסיפים כברירת מחדל תווים אחרי הברקוד (Tab, Enter + Carriage Return). הגדרות הסורק משתנות בדרך כלל על ידי סריקת ברקוד תצורה מהמדריך של היצרן. ל-Bitrix, אנו ממליצים: סיומת Enter לסורק, ללא קידומת, ללא CR. אם התווים נמשכים, הבזיקו מחדש את הסורק באמצעות ברקודי התצורה שסופקו. זה פותר 95% מהבעיות מיד.
תוצרים (מה אתם מקבלים)
- פיתוח API לחיפוש מוצר לפי ברקוד (יום אחד)
- רכיב הוספה מהירה לסל עם פוקוס אוטומטי (1-2 ימים)
- ממשק קטיף הזמנות עם סורק ומעקב התקדמות (2-3 ימים)
- מודול מלאי עם דוחות פערים (יומיים)
- בדיקה עם סורק אמיתי (יום אחד)
- תיעוד על הגדרת סורק והכשרת עובדים
- חודש תמיכה לאחר ההשקה
לוחות זמנים
| שלב | משך |
|---|---|
| API לחיפוש מוצר לפי ברקוד | יום אחד |
| רכיב הוספה מהירה לסל | 1–2 ימים |
| ממשק קטיף הזמנות עם סורק | 2–3 ימים |
| מודול מלאי | יומיים |
| בדיקה עם סורק אמיתי | יום אחד |
| סה"כ | 7–9 ימים |
למה לבחור בנו
עם יותר מ-10 שנות ניסיון, 50+ שילובי ברקוד מוצלחים, ורקורד של 5 שנים בשוק, אנו מבטיחים איכות ועמידה בלוחות זמנים. הפתרונות שלנו במפתח מלא מתחילים מ-$2,500 ובדרך כלל מחזירים את עצמם תוך 3 חודשים דרך הפחתת שגיאות והאצת מהירות. חשבו על החיסכון בעלות שילוב ברקוד: פרויקט טיפוסי מחזיר את עצמו במהירות.
הזמינו שילוב במפתח מלא—נעריך את הפרויקט שלכם ביום אחד. צרו קשר לייעוץ.