توثيق المستودع المتنقل وماسح الباركود لأودو (مستودع بلا ورق)

1. فُكّ ضغط الحزمة. بداخلها taqnix_wms_barcode.zip؛ فُكّه لتحصل على المجلد taqnix_wms_barcode.
2. انسخ المجلد إلى أحد مجلدات addons_path في خادم أودو وأعد تشغيل أودو.
3. سجّل الدخول كمدير وفعّل وضع المطوّر ثم افتح التطبيقات واضغط تحديث قائمة التطبيقات.
4. أزل مرشح «التطبيقات» وابحث عن Mobile WMS واضغط تثبيت.

# or from the command line
./odoo-bin -c odoo.conf -d YOUR_DATABASE -i taqnix_wms_barcode --stop-after-init

1. فُكّ ضغط flutter-app-source.zip وافتح الطرفية في المجلد.
2. نزّل الحزم: flutter pub get. طبقة قاعدة البيانات (Drift) مولَّدة ومضمَّنة أصلًا؛ لا تشغّل dart run build_runner build --delete-conflicting-outputs إلا إذا غيّرت الجداول. وبعد تعديل نصوص التطبيق يعيد الأمر python3 tool/l10n_src.py && flutter gen-l10n توليد الترجمات.
3. افحص المشروع: flutter analyze وflutter test (توصَف المجموعة في الفصل 26).
4. شغّله على جهاز أندرويد موصول أو على محاكٍ: flutter run --dart-define=SITE_URL=https://odoo.example.com. المتغير SITE_URL اختياري: وبدونه تعرض شاشة الدخول حقل عنوان الخادم.
5. ابنِ تطبيق أندرويد للأجهزة الصناعية: flutter build apk --release --dart-define=SITE_URL=https://odoo.example.com. ثبّت الحزمة APK بواسطة USB أو نظام إدارة الأجهزة (Zebra StageNow وHoneywell Enterprise Provisioner وSOTI...) أو من رابط تنزيل. يُوقَّع APK الإصدار بمفتاح التصحيح إلى أن تنشئ android/key.properties كما في دليل التوقيع القياسي لـ Flutter: افعل ذلك قبل توزيعه.
6. ابنِ تطبيق الآيفون على جهاز Mac بواسطة Xcode: flutter build ios --release --dart-define=SITE_URL=https://odoo.example.com (يستخدم الآيفون الكاميرا، انظر الفصل 8).
7. افتح التطبيق. سجّل الدخول باسم مستخدم وكلمة مرور لمستخدم من المجموعة إدارة المستودع المتنقل / مشغّل. ينزّل التطبيق البيانات الرئيسية (المنتجات وباركود التعبئة والخانات والمنصات والدفعات) ويصبح جاهزًا للمسح، حتى دون شبكة بعد ذلك.
8. في الإعدادات ← الماسح تحقق من ملف الماسح (الفصلان 7 و8).

1. افتح تطبيق DataWedge واضغط New profile وسمِّه TaqnixWMS.
2. في Associated apps أضف com.taqnix.wmsscanner مع النشاط *.
3. في Barcode input أبقِ Enabled وحدّد أنواع الرموز التي تستخدمها: EAN-13 وEAN-8 وUPC-A وUPC-E وCode 128 وGS1-128 وDataMatrix وQR إن كنت تستخدمها في الملصقات.
4. في Keystroke output اجعل Enabled متوقفًا: يجب ألا يُكتب المسح في أي مكان.
5. في Intent output اجعل Enabled مفعّلًا. الإجراء com.taqnix.wms.SCAN (أو ما كتبته في التطبيق) والفئة android.intent.category.DEFAULT وIntent delivery: Broadcast intent.
6. اختبر: افتح الإعدادات ← اختبار الماسح في التطبيق واسحب الزناد. يظهر الرمز ونوع الباركود والنيّة الخام على الشاشة.

1. افتح المخزون ← الإعداد ← أنواع العمليات وافتح الاستلامات وأوامر التسليم والتحويلات الداخلية وفعّل إدارة المستودع المتنقل في التبويب الجديد الذي يحمل الاسم نفسه (الخيارات في الجدول أدناه).
2. أعطِ الخانات باركودها وممرها وقسمها ومستواها وأرقام التحقق (الفصل 10) واطبع ملصقات الخانات (الفصل 24).
3. أنشئ مستخدمي فريق المستودع وامنحهم المجموعة «إدارة المستودع المتنقل / مشغّل»؛ ويحصل المشرفون على «إدارة المستودع المتنقل / مدير» (الفصل 22).
4. افتح الإعدادات ← إدارة المستودع المتنقل وراجع هامش التسامح وقواعد الانتهاء وحدود الجرد وبادئات الباركود (الفصل 23).
5. للمنتجات ذات الدفعة أو الرقم التسلسلي تأكد من ضبط التتبع؛ وفعّل اطلب تاريخ الانتهاء عند الاستلام على المنتجات ذات مدة الصلاحية.
6. اطبع باركود المنتجات وسجّل الدخول بالتطبيق.

1. افتح بلاطة الاستلامات واختر عملية النقل (أو امسح رقم أمر الشراء: يفتح استلامه).
2. امسح خانة التجهيز إذا كان نوع العملية لديك يطلبها. في الاستلام بـ3 خطوات هذا هو موقع الإدخال.
3. امسح المنتجات. كل مسح يضيف وحدة؛ ولوحة الكمية في التطبيق تغيّر المقدار؛ وباركود الكرتون يضيف كمية عبوته.
4. للمنتج ذي الدفعة يطلب الماسح الدفعة (أو يقرؤها من باركود GS1). وإذا احتاج المنتج إلى تاريخ انتهاء فإن الماسح يطلبه ما لم يوفره AI 17.
5. اضغط اعتماد. عملية النقل غير المكتملة تسأل هل تُنشئ أمرًا مؤجلًا.

1. افتح التسليم. يُستلم لك للعمل عليه: لا أحد غيرك يستطيع المسح عليه (يستطيع المدير).
2. امسح الخانة. إذا كان للخانة أرقام تحقق يطلبها التطبيق. مسح خانة غير المقترحة مقبول ويُعلَّم بـ wrong_location.
3. امسح المنتج (والدفعة). تُقترح الدفعة المحجوزة؛ ودفعة أخرى مقبولة وتُعلَّم بـ substitute_lot.
4. عند اكتمال كل السطور يعرض التطبيق نغمة الإنجاز. اضغط اعتماد.

1. افتح تحويلًا داخليًا، أو استخدم تحرك حر في التطبيق لنقل المخزون دون أمر.
2. امسح خانة المصدر، ثم المنتج (أو المنصة)، ثم خانة الوجهة وأرقام تحققها.
3. مسح المنصة (حزمة) ينقل كل محتواها بمسح واحد: كل منتج ودفعة وكمية في الحزمة. وتُرفض المنصة كلها إذا كان فيها منتج ليس في عملية النقل.
4. اعتمد. تنتقل الكميات في المخزون بدقة وتحتفظ المنصة بهويتها في خانة الوجهة.

1. افتح إدارة المستودع المتنقل ← عمليات النقل وحدّد عمليات النقل الجاهزة من نوع عملية واحد واختر إجراء ← إنشاء موجة. أو أنشئ موجة واضغط إضافة عمليات نقل: يقترح المعالج عمليات النقل الجاهزة من النوع نفسه التي ليست في موجة أخرى.
2. اضغط بدء. يستلم الملتقِط (أو أنت إذا بدأتها) الموجة وكل عمليات نقلها للعمل عليها.
3. يفتح الملتقِط الموجة في التطبيق. المحطات هي الخانات مرتبة بتسلسل الالتقاط، وفي كل منها سطور كل الطلبات؛ وتُدمج للعرض سطور المنتج نفسه في الخانة نفسها.
4. يذهب مسح الوحدة إلى أول طلب، بحسب الأولوية والموعد النهائي والتاريخ، ما زال يحتاج إلى المنتج؛ وتُوزَّع الكمية الأكبر على الطلبات بالترتيب نفسه.
5. اضغط اعتماد: يسأل المعالج ماذا تفعل بعمليات النقل غير المكتملة (أمر مؤجل أو إلغاء المتبقي). عمليات النقل التي بلا أي مسح تغادر الموجة وتبقى مفتوحة.

1. أنشئ جردًا (إدارة المستودع المتنقل ← الجرد الدوري) بنطاقه واضغط بدء العد، أو دع المشغّل ينشئ جردًا في التطبيق. عند البدء تُجمَّد الكمية المتوقعة لكل منتج ودفعة وحزمة ضمن النطاق.
2. يمسح المشغّل رفًّا ثم الأصناف، ويكتب الكمية أو يمسحها. الصنف غير المتوقع يُضاف بالكمية التي كانت في الدفاتر في تلك اللحظة.
3. إرسال للمراجعة. الأصناف التي توقعتها الدفاتر في خانة جرى جردها ولم يمسحها أحد تُعدّ صفرًا (مفقود). أما الخانات التي لم تُمس أبدًا فلا تُجرد إطلاقًا.
4. يراجع المدير الفروق. يبيّن عمود الانحراف ما دخل الخانة أو خرج منها منذ البدء، فلا يُخلط بين استلام وصل أثناء الجرد وبين خسارة. يستطيع المدير تصحيح كمية أو طلب إعادة العد.
5. اعتماد وتسجيل. تسوية مخزون واحدة لكل سطر، بالفرق الذي وجده العادّ (المعدود ناقص المتوقع)، فتبقى الحركات التي جرت في الأثناء محفوظة. يصبح الجرد منجزًا ولا يمكن تطبيقه مرتين.

# is the server reachable? (no sign-in)
curl https://odoo.example.com/api/wms/v1/ping
# {"ok": true, "api_version": 1, "server_time": "2026-10-28T08:00:00Z"}

# sign in as a warehouse operator (returns a token, the configuration and the GS1 rules)
curl -X POST https://odoo.example.com/api/wms/v1/auth/login -H 'Content-Type: application/json' \
  -d '{"login": "omar", "password": "...", "device": {"id": "TC52-0147", "name": "TC52 dock 1", "platform": "android", "scanner": "zebra"}}'

# what is this barcode? (GS1-128 with GTIN, lot and expiry; the answer says which product, which lot and which date)
curl -X POST https://odoo.example.com/api/wms/v1/resolve -H "Authorization: Bearer $TOKEN" -H 'Content-Type: application/json' \
  -d '{"barcode": "010629105000040710L2610A\u001d17261118", "context": {"picking_id": 12}}'

# push the queued operations: every operation has a uuid and a local_seq, a repeat changes nothing
curl -X POST https://odoo.example.com/api/wms/v1/sync -H "Authorization: Bearer $TOKEN" -H 'Content-Type: application/json' \
  -d '{"device_id": "TC52-0147", "ops": [{"uuid": "9d1c...", "type": "scan", "local_seq": 41, "device_time": "2026-10-28T08:01:00Z",
        "payload": {"picking_id": 12, "barcode": "6291050000407", "qty": 6, "location_id": 31}}]}'

# the engine of the module, in a shell or in your own code
env["wms.barcode.resolver"].resolve("010629105000040710L2610A\x1d17261118", {"picking_id": 12})
# {"hits": [{"type": "product", "id": 9209, "lot_name": "L2610A", "expiration_date": "2026-11-18", ...}, {"type": "lot", "exists": False, ...}],
#  "primary": {...}, "gs1": {"parsed": [{"ai": "01", "value": "..."}, ...], "raw": "..."}, "warnings": [], "ms": 2.7}

استبدل المجلد بالإصدار الجديد وأعد تشغيل أودو ونفّذ -u taqnix_wms_barcode. تبقى الخانات والتسلسلات والإعدادات والموجات وعمليات الجرد وسجل المسح. حدّث التطبيق على الأجهزة بالبناء الجديد؛ ويتخاطب التطبيق والوحدة بإصدار الواجهة البرمجية 1.

المساعدة في التثبيت وإصلاح الأخطاء مشمولان لمدة 6 أشهر مع تحديثات مدى الحياة. تواصل معنا عبر صفحة السوق التي اشتريت منها الوحدة أو راسل support@taqnix.com مع إصدار أودو ولقطة شاشة.