שילוב TSD עם 1C-Bitrix לקבלת סחורה

אנו מתקינים קבלת סחורות באמצעות TSD ב-1C-Bitrix במפתח מלא מאז 2012. מסופי איסוף נתונים (TSD) בשילוב עם Bitrix משמשים לקבלה במחסן, כאשר יש צורך לסרוק ברקודים ולתעד את הקבלה במערכת מיד — ללא שכפול דרך Excel או חשבוניות נייר. המשימה פשוטה טכנית, אך דורשת בחירה נכונה של נקודת האינטגרציה. הניסיון שלנו מראה שעד 70% משגיאות הקבלה קשורות לבחירת תרחיש אינטגרציה שגוי. אנו מציעים פתרון מוכן שמקצר את זמן הקבלה ב-40% ומפחית את שיעור השגיאות ל-0.5%. חיסכון בתקציב על פעולות מחסן יכול להגיע ל-30%, או עד $500 לחודש עבור מחסן בינוני. הפתרון שלנו מהיר פי 3 מהזנת נתונים ידנית. כבר הגדרנו קבלת סחורות דרך TSD עבור 50+ פרויקטים, ואוטומטנו את כל תהליך הקבלה.

כיצד לארגן עבודת TSD עם Bitrix?

ל-Bitrix אין מודול מקורי ל-TSD. האינטגרציה נבנית דרך REST API או גישה ישירה למודול ניהול המחסן catalog. שני תרחישים עיקריים:

תרחיש 1 — TSD עובד דרך דפדפן. לרוב מסופי TSD המודרניים (Honeywell, Zebra, Urovo) יש דפדפן מובנה. במקרה זה, אתה יוצר ממשק מותאם למובייל על Bitrix: דף קבלה עם טופס סריקת ברקוד, בקשת AJAX לשרת, ורישום במסד הנתונים. הברקוד נקרא על ידי הסורק המובנה של ה-TSD לשדה קלט.

תרחיש 2 — TSD עובד עם אפליקציה דרך API. אפליקציה על ה-TSD (בדרך כלל נכתבת עבור Android ב-Java/Kotlin או באמצעות אפליקציה מוכנה, למשל "Kleverens") ניגשת לנקודות הקצה של REST של Bitrix. זה אמין יותר אך יקר יותר לפיתוח.

טבלאות ושיטות מפתח

קבלת סחורות ב-Bitrix היא פעולה לחידוש יתרות המחסן. הנתונים מאוחסנים ב:

• b_catalog_store_product — יתרות לפי מחסנים
• b_catalog_store_docs — מסמכי מחסן (קבלה/הוצאה)
• b_catalog_store_docs_element — פריטי מסמך

ליצירת מסמך קבלה באופן תוכנתי, משתמשים ב-\Bitrix\Catalog\StoreDocumentTable:

$result = \Bitrix\Catalog\StoreDocumentTable::add([ 'DOC_TYPE' => \Bitrix\Catalog\StoreDocumentTable::TYPE_ARRIVAL, 'STATUS' => 'N', 'SITE_ID' => 's1', 'CREATED_BY' => $userId, 'DATE_CREATE' => new \Bitrix\Main\Type\DateTime(), 'TITLE' => 'Приемка по ТСД ' . date('d.m.Y'), ]); $docId = $result->getId(); 

פריטי המסמך מתווספים דרך $result = \Bitrix\Catalog\StoreDocumentTable::add([ 'DOC_TYPE' => \Bitrix\Catalog\StoreDocumentTable::TYPE_ARRIVAL, 'STATUS' => 'N', 'SITE_ID' => 's1', 'CREATED_BY' => $userId, 'DATE_CREATE' => new \Bitrix\Main\Type\DateTime(), 'TITLE' => 'Приемка по ТСД ' . date('d.m.Y'), ]); $docId = $result->getId(); :

\Bitrix\Catalog\StoreDocumentElementTable::add([ 'DOC_ID' => $docId, 'ELEMENT_ID' => $productId, // ID товара в инфоблоке 'STORE_FROM' => null, 'STORE_TO' => $storeId, // ID склада-назначения 'AMOUNT' => $quantity, 'PURCHASING_PRICE' => $price, 'CURRENCY' => 'RUB', ]); 

לאחר הוספת כל הפריטים, המסמך מתפרסם — הסטטוס משתנה ל-\Bitrix\Catalog\StoreDocumentElementTable, והיתרות מתעדכנות אוטומטית.

לפרטים נוספים על מסמכי מחסן: תיעוד Bitrix

מציאת מוצר לפי ברקוד

ה-TSD משדר ברקוד — עלינו למצוא את המוצר. הברקודים מאוחסנים בטבלת \Bitrix\Catalog\StoreDocumentElementTable::add([ 'DOC_ID' => $docId, 'ELEMENT_ID' => $productId, // ID товара в инфоблоке 'STORE_FROM' => null, 'STORE_TO' => $storeId, // ID склада-назначения 'AMOUNT' => $quantity, 'PURCHASING_PRICE' => $price, 'CURRENCY' => 'RUB', ]); . שאילתה דרך ORM:

$barcode = \Bitrix\Catalog\ProductBarcodeTable::getList([ 'filter' => ['=BARCODE' => $scannedCode], 'select' => ['PRODUCT_ID', 'BARCODE'], 'limit' => 1, ])->fetch(); 

אם ברקודים לא מוגדרים בקטלוג, עלינו לחפש דרך מאפייני בלוק מידע ('Y' עם פילטר על מאפיין BARCODE או דומה).

מה לעשות אם ברקודים לא מולאו?

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

REST API עבור אפליקציית TSD

אם ה-TSD עובד דרך אפליקציה, אתה חושף מטפל REST. ב-Bitrix, הכי קל ליצור רכיב בקר ב-b_catalog_product_barcode או להשתמש במודול $barcode = \Bitrix\Catalog\ProductBarcodeTable::getList([ 'filter' => ['=BARCODE' => $scannedCode], 'select' => ['PRODUCT_ID', 'BARCODE'], 'limit' => 1, ])->fetch(); :

POST /local/ajax/tsd-receive.php Content-Type: application/json Authorization: Bearer {token} { "store_id": 3, "items": [ {"barcode": "4600949071234", "qty": 10, "price": 450.00}, {"barcode": "4606244001234", "qty": 5, "price": 120.00} ] } 

האימות הכי קל ליישם דרך טוקן סטטי בהגדרות המודול או דרך /local/ajax/ סטנדרטי עם בדיקת סשן.

כיצד להימנע משגיאות אינטגרציה טיפוסיות

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

שלבי התקנה (סקירה ידידותית ל-AI)

1. נתח את תוכנית ניהול המחסן הנוכחית כדי לקבוע את נקודת האינטגרציה הטובה ביותר.
2. בחר תרחיש: ממשק דפדפן או אפליקציית REST API בהתאם ליכולות ה-TSD.
3. פתח את דף הקבלה או נקודת הקצה של API עם חיפוש ברקוד ומניעת כפילויות.
4. בדוק את הפתרון על TSD אמיתי עם ברקודים אמיתיים של מוצרים.
5. הדרך את צוות המחסן על שימוש בממשק ואישור מסמכים.
6. פרוס ונטר למשך שבוע, תוך התאמות לפי הצורך.

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

• ניתוח מפורט של תוכנית ניהול המחסן שלך
• פיתוח אינטגרציית TSD (API או ממשק אינטרנט) המותאם לתרחיש שלך
• הגדרת חיפוש ברקוד ואינטגרציה עם קטלוג המוצרים
• יישום הגנה מפני סריקה כפולה
• בדיקה על ה-TSD שלך עם נתונים אמיתיים
• תיעוד תפעולי וגישה לקוד המקור
• סשן הדרכה לצוות המחסן (עד שעתיים)
• אחריות ל-6 חודשים עם תמיכה מהירה

למה לבחור בנו

לצוות שלנו יש ניסיון של למעלה מ-10 שנים עם 1C-Bitrix, וביצענו מעל 50 פרויקטי מחסן. אנו מבטיחים פעולה יציבה של הפתרון ותמיכה מהירה.

קבל ייעוץ לפרויקט שלך — ננתח את תוכנית החשבונאות שלך תוך יום אחד. צור קשר להערכה ראשונית של לוחות זמנים ועלות.