دليل الاستخدام
ربط إيزي أوردر بباشكاتب
إيزي أوردر بيشتغل بالـ Webhook — يعني الأوردر بيوصلك أول ما يحصل من غير ما تزامن بإيدك.
إزاي أربط إيزي أوردر بباشكاتب؟
من الإدارة ← التكاملات اضغط ربط متجر جديد، اختار إيزي أوردر، واكتب مفتاح API وسر الـ Webhook. بعد الحفظ، انسخ رابط الـ Webhook اللي هيظهرلك وحطه في إعدادات إيزي أوردر.
البيانات المطلوبة
| الخانة | إجبارية؟ | التفاصيل |
|---|---|---|
| اسم التكامل | ✅ | اسم بتختاره للتنظيم |
| مفتاح API | ✅ | من لوحة إيزي أوردر |
| سر الـ Webhook | ✅ | بيتأكد إن الطلبات فعلاً من إيزي أوردر |
النظام بيتحقق من الاتنين قبل الحفظ.
الوضع القديم بالإيميل وكلمة السر متوقف. إيزي أوردر بيشتغل بمفتاح API بس. لو شفت رسالة بتقول كده، ده مقصود مش عطل.
من فين تجيب البيانات
الاتنين من لوحة البائع في إيزي أوردر.
مفتاح API
- ادخل على لوحة البائع بتاعتك في إيزي أوردر.
- افتح إعدادات الحساب.
- روح لقسم Public API.
- اضغط Create New API Key.
- اكتب اسم للمفتاح واحفظه.
- انسخه فورًا — مش هيظهرلك تاني.
الـ Webhook وسره
- في نفس قسم Public API، افتح Webhooks.
- اضغط Create Webhook.
- اكتب رابط الـ endpoint — وده رابط الـ Webhook اللي باشكاتب بيوريهولك بعد ما تحفظ التكامل.
- أول ما تعمله، إيزي أوردر بيولّد مفتاح سري. ده هو سر الـ Webhook اللي بتحطه في باشكاتب.
توثيق إيزي أوردر الرسمي:
مفتاح API بيظهر مرة واحدة بس. لو ضاع منك، اعمل واحد جديد وحدّثه في باشكاتب.
خطوة الـ Webhook مهمة جدًا
إيزي أوردر مابيشتغلش زي شوبيفاي. بدل ما باشكاتب يروح يسأل على الأوردرات، إيزي أوردر هو اللي بيبعتها أول ما تحصل.
عشان ده يشتغل، لازم تقوله يبعت فين.
بعد ما تحفظ التكامل، النظام بيوريك رابط الـ Webhook بتاعك. انسخه بالظبط وحطه في إعدادات Webhooks جوه لوحة إيزي أوردر.
⚠️ لو نسيت الخطوة دي، الأوردرات مش هتوصلك. التكامل هيبان متظبط بس مافيش حاجة هتنزل.
سر الـ Webhook
السر ده بيثبت إن الطلب الجاي فعلاً من إيزي أوردر. باشكاتب بيتحقق منه قبل ما يقبل أي أوردر.
لازم يكون نفس السر في المكانين — في باشكاتب وفي إعدادات إيزي أوردر. لو مختلفين، الأوردرات هتترفض.
اختبر الاتصال
اضغط اختبار الاتصال بعد الحفظ عشان تتأكد إن مفتاح API شغال.
ملاحظة: الاختبار ده بيتأكد من المفتاح بس — مش بيتأكد إن رابط الـ Webhook متظبط في إيزي أوردر. تأكد من ده بنفسك، وأسهل طريقة إنك تعمل أوردر تجريبي وتشوفه بيوصل ولا لأ.
المزامنة اليدوية
حتى مع الـ Webhook، تقدر تعمل مزامنة يدوية:
- مزامنة الطلبات والعملاء — لو فاتك أوردرات وقت انقطاع.
- مزامنة المنتجات فقط — لبناء الكتالوج أول مرة.
- تحديد فترة — لجلب أوردرات شهر معين.
استخدمها لو الـ Webhook كان متوقف فترة، أو أول ما تربط عشان تجيب الأوردرات القديمة.
إيه اللي بيحصل لكل أوردر
زي كل التكاملات:
- فاتورة مبيعات بتتعمل، مصدرها متسجّل باسم إيزي أوردر.
- رقم الأوردر الأصلي بيتحفظ كمعرّف فريد — مافيش تكرار.
- العميل بيتطابق بالتليفون أو الإيميل، أو بيتعمل جديد.
- الأصناف والمجموعات الناقصة بتتعمل تلقائي.
متابعة
القايمة بتوريك آخر مزامنة وحالة التكامل. لو الحالة خطأ، آخر رسالة خطأ بتتسجّل.
راجع الحالة كل كام يوم. الـ Webhook بيتعطّل بهدوء لو الرابط اتغيّر أو السر اتبدّل.
الأسئلة الشائعة
يعني إيه Webhook؟
طريقة تخلي إيزي أوردر يبعتلك الأوردر أول ما يحصل، بدل ما أنت تروح تسأل عليه. يعني الأوردرات بتوصل باشكاتب لحظيًا من غير ما تضغط زرار مزامنة.
نسيت أحط رابط الـ Webhook — هيحصل إيه؟
الأوردرات مش هتوصلك تلقائي. الرابط ده هو اللي بيخلي إيزي أوردر يعرف يبعت فين. لازم تحطه في إعدادات Webhooks جوه لوحة إيزي أوردر.
أقدر أستخدم الإيميل وكلمة السر بدل مفتاح API؟
لأ. الوضع القديم بالإيميل وكلمة السر متوقف. إيزي أوردر بيشتغل بمفتاح API وسر Webhook بس.
سر الـ Webhook ده إيه فايدته؟
بيتأكد إن الطلب الجاي فعلاً من إيزي أوردر مش من حد تاني. باشكاتب بيستخدمه في التحقق قبل ما يقبل أي أوردر — فلازم يكون نفسه في المكانين.
روابط مرتبطة
جرّب باشكاتب على بياناتك الحقيقية
ابدأ التجربة المجانية أو شاهد الصفحة المناسبة لمرحلة مشروعك، ثم طبّق ما قرأته على الفواتير والمخزون والتقارير داخل النظام.