الدومين والروابط

تعديل الدومين من متغيرات البيئة على Render: PUBLIC_BASE_URL

أسعار التوصيل (كشك + استبدال)

التعديل يُطبَّق فوراً على الكشك عند تثبيت الطلب وعلى خطوات الاستبدال في إدارة الطلبات.

شركة التوصيل — الوسيط

الملاحظة الثابتة (تُرسل مع كل طلب للوسيط)

تُطبَّق على الكشك عند خطوة ملاحظات التوصيل وعلى تثبيت الطلب والاستبدال.

الدفع الإلكتروني

حالياً الطلبات تُسجّل في Shopify كـ دفع عند الاستلام. ربط بوابة دفع (زين كاش، بطاقة، إلخ) يمكن إضافته لاحقاً.

Shopify Payments / بوابة محلية — من إعدادات المتجر في Shopify Admin.

رسائل واتساب (WasenderAPI)

المتغيرات على الخادم: WHATSAPP_API_KEY, WHATSAPP_PROVIDER, PUBLIC_BASE_URL

الربط مع الصفحات

فصل ربط الرد على المحادثات عن ربط حساب النشر — تطبيقان Meta منفصلان حتى لا تُستهلك حصة الاتصالات.

تغذية منتجات Meta (Commerce Manager)

الصق هذا الرابط في Meta عند اختيار «Use a URL»:

https://ai.ookydoky.com/api/meta/product-feed.csv

يُحدَّث على الخادم كل 30 دقيقة بشكل متسلسل (دفعات صغيرة) دون التأثير على السيرفر. في Meta اختر أقرب جدولة متاحة (غالباً كل ساعة).

نقطة البيع POS

إعدادات الفاتورة والمسح — فتح POS

اسم المتجر العنوان الهاتف تعليمات أعلى الفاتورة تعليمات أسفل الفاتورة إظهار الشعار أكواد الخصم السماح بالإرجاع طباعة تلقائية بعد البيع البيع رغم نفاد المخزون حفظ إعدادات POS

الأجهزة والطابعات

طابعات الخادم (USB/Windows) · طابعات الهاتف (بلوتوث · AirPrint · WiFi) · طابعات الشبكة (IP).

طابعة ملصقات الشحن (الوسيط) — اختر طابعة — طابعة الفواتير (POS) — اختر طابعة — طابعة ملصقات المنتجات — اختر طابعة — طباعة ملصق الشحن تلقائياً بعد تجهيز الطلب على الهاتف: استخدم طابعات الجهاز (بلوتوث/WiFi) تلقائياً

طابعة «طابعات الخادم» = طباعة مباشرة بدون معاينة على جهاز الخادم. للبلوتوث/WiFi على الهاتف: اختر «طباعة من هذا الجهاز».

إضافة طابعة (هاتف / شبكة)

ماسحات الباركود (Scan)

USB · بلوتوث · WiFi (وضع لوحة المفاتيح/HID) · كاميرا الموبايل أو الكمبيوتر.

الماسح الافتراضي — اختر ماسح — تركيز حقل المسح تلقائياً عند التجهيز (HID/USB/بلوتوث/WiFi)

ماسحات USB/بلوتوث/WiFi تعمل كلوحة مفاتيح — وجّه المؤشر للحقل وامسح. للكاميرا: اضغط زر 📷 في شاشة التجهيز.

إضافة ماسح مخصص

مفاتيح API للبرامج الخارجية

أنشئ مفتاحاً وحدّد الصلاحيات (منتجات · زبائن · طلبات) لربط أنظمة المحاسبة أو التطبيقات الأخرى.

المفاتيح النشطة

مسارات API (v1)

GET /api/v1/health · GET /api/v1/me
GET /api/v1/products · GET /api/v1/products/:id
PUT /api/v1/products/:id/inventory (كتابة)
GET /api/v1/customers · GET /api/v1/customers/:id
GET /api/v1/orders · GET /api/v1/orders/:id
POST /api/v1/orders/:id/prepare (كتابة)
المصادقة: Authorization: Bearer oka_... أو X-Api-Key: oka_...

مكتبة الملفات

عرض جميع صور المنتجات والصور المرفوعة. عند تحرير منتج يمكنك اختيار الصور من هنا بدلاً من رفعها من الجهاز فقط.

استيراد متكامل من Shopify → نظام محلي

يُستورد كل شيء محلياً على السيرفر: صور · قياسات وألوان · SKU · كولكشنات · خصومات · زبائن · طلبات — للاستقلال لاحقاً عن Shopify.

إذا كان الكتالوج مستورداً مسبقاً، يُحدَّث الخزين فقط عند تكرار الاستيراد (ما لم تفعّل إعادة الاستيراد الكامل). أغلق اتصال Shopify بعد الانتهاء للعمل محلياً.