شروحات أثر

البدء مع أثر

أثر يعطي عملاء متجرك في سلة صفحة يتتبعون فيها طلباتهم بدون تسجيل دخول، ويخليهم يطلبون استرجاع أو استبدال، وأنت تدير كل شيء من لوحة وحدة.

التثبيت

1. افتح صفحة أثر في متجر تطبيقات سلة واضغط تثبيت.
2. وافق على الصلاحيات المطلوبة. أثر يحتاج قراءة الطلبات والشحنات والمنتجات عشان يعرض حالة الطلب ويقترح البدائل.
3. بعد التثبيت تبدأ التجربة المجانية مباشرة، وصفحة التتبع تظهر في متجرك تلقائيًا.

الوصول للوحة أثر

من لوحة سلة: التطبيقات ← التطبيقات المثبتة ← أثر. اللوحة فيها خمسة تبويبات: نظرة عامة، الاسترجاع والاستبدال، التقارير، المظهر، وإعدادات متقدمة.

الباقات والاستخدام

أثر فيه باقتين، والاشتراك يُدار ويُدفع من حسابك في سلة:

• الأساسية: صفحة التتبع، والتواصل مع شركة الشحن، وتخصيص الألوان والشعار، وتقارير التتبع، حتى ١٠٬٠٠٠ عملية تتبع في الشهر.
• الاحترافية: كل ما سبق بدون حد، ومعها الاسترجاع والاستبدال وحساب فرق السعر، وقوالب الردود وزر واتساب، والتقارير الكاملة والتصدير، والرسائل النصية، والتكامل، والدومين الخاص ورمز QR.

التجربة المجانية تشمل كل مزايا الاحترافية.

كيف تُحسب عمليات التتبع

نحسب كل طلب لقاه العميل بنجاح، مرة وحدة في اليوم لنفس الطلب. يعني لو فتح العميل صفحة طلبه عشر مرات في نفس اليوم تنحسب مرة وحدة، والمحاولات اللي فيها رقم خاطئ ما تنحسب. العدّاد يبدأ من أول كل شهر، وتشوفه في بطاقة «باقتك» في نظرة عامة.

كيف يتتبع العميل طلبه

1. يفتح صفحة التتبع من متجرك أو من رابط وصله.
2. يكتب رقم الطلب، ورقم الجوال أو البريد الإلكتروني المستخدم في الطلب.
3. يشوف حالة الطلب ومراحل الشحنة، ورقم التتبع عند شركة الشحن، والمنتجات وعنوان التوصيل إذا فعّلتهم.

ما يحتاج حساب ولا كلمة مرور. التحقق بالجوال أو البريد يمنع أي شخص يشوف طلب غيره بمجرد ما يعرف رقمه.

إذا الطلب فيه أكثر من شحنة، كل شحنة تظهر بحالتها. وبعد الشحن يظهر للعميل رقم شركة الشحن وواتسابها (انظر التواصل مع شركة الشحن).

أماكن ظهور التتبع

كلها من تبويب المظهر، وتقدر تفعّل أكثر من مكان:

• طريقة العرض: «نافذة منبثقة» تفتح فوق صفحة المتجر، أو «صفحة مستقلة» تنقل العميل لصفحة التتبع.
• زر عائم: زر ثابت في زاوية الشاشة (يسار أو يمين) بالنص اللي تختاره.
• روابط القوائم: رابط «تتبع طلبك» في فوتر المتجر وفي قائمة الجوال.
• صفحة الشكر بعد الطلب: بطاقة تظهر للعميل بعد ما يطلب، فيها رقم طلبه وزر «تتبع طلبي»، ويقدر يرسل الرابط لنفسه بالواتساب.

روابط التتبع والرسائل

في نظرة عامة تلقى بطاقة «روابط التتبع». فيها رابط صفحة التتبع المستقلة اللي ترسله لعميلك في أي مكان، وتقدر تختار اسمه (حروف إنجليزية صغيرة وأرقام وشرطة).

إضافة الرابط لرسائل سلة

خلّ الرابط يوصل لعميلك مع كل تحديث للطلب، ويفتح على رقم طلبه جاهز:

1. من لوحة سلة: الإعدادات ← حالات الطلبات.
2. افتح الحالة (مثل «تم الشحن» و«جاري التوصيل») وفعّل إرسال رسالة للعميل.
3. انسخ النص الجاهز من بطاقة «رابط التتبع في رسائل سلة» في أثر والصقه في الرسالة.
4. بدّل [رقم الطلب] بمتغير رقم الطلب من قائمة المتغيرات في سلة.

إذا ما لقيت متغير رقم الطلب، احذف ?order=[رقم الطلب] وخلّ الرابط بدونه، والعميل يكتب رقم طلبه بنفسه.

المظهر والتخصيص

من تبويب المظهر، ومع كل تعديل تشوف معاينة حية:

صفحة التتبع تظهر بالعربي أو الإنجليزي حسب لغة المتجر، وتدعم الوضع الداكن.

دومين خاص

بدل رابط أثر، تقدر تخلي صفحة التتبع على دومين متجرك، مثل track.mystore.com. الإعداد في إعدادات متقدمة ← دومين خاص لصفحة التتبع.

1. تأكد أن متجرك مربوط بدومين خاص في سلة (مثل mystore.com).
2. اختر اسم الرابط (مثل track) واضغط «ربط الدومين».
3. أضف سجل DNS اللي يظهر لك عند مزوّد الدومين، وارجع اضغط «تحقق».

رمز QR

في إعدادات متقدمة تلقى رمز QR يفتح صفحة التتبع مباشرة. نزّله واطبعه على كرت الشكر أو الكرتون أو الفاتورة، والعميل يمسحه بالكاميرا ويتتبع طلبه.

التواصل مع شركة الشحن

بعد ما ينشحن الطلب، يظهر للعميل في صفحة التتبع رقم شركة الشحن وواتسابها وساعات عملها وموقعها، عشان يتواصل معهم مباشرة بخصوص التوصيل.

• أثر يجهّز معلومات أشهر شركات الشحن، ويحدّثها من عندنا.
• تقدر تعدّل أي معلومة لشركة معينة من إعدادات متقدمة ← التواصل مع شركة الشحن، والحقول اللي ما عدّلتها تبقى تتحدث من أثر.
• «الرجوع للافتراضي» يلغي تعديلاتك ويرجع معلومات أثر.
• تقدر تضيف شركة شحن خاصة فيك ما هي في القائمة.
• إذا حدّثنا معلومات شركة سبق وعدّلتها، يظهر لك «تحديث جديد من أثر» عشان تراجعه.

الميزة مفعّلة افتراضيًا، وتقدر توقفها من تبويب المظهر.

تفعيل الاسترجاع والاستبدال

من تبويب الاسترجاع والاستبدال ← الإعدادات. كل واحد منهم يتفعّل لحاله:

• المدة: كم يوم بعد التوصيل يقدر العميل يطلب (الافتراضي ٧ أيام للاسترجاع و١٤ يوم للاستبدال).
• الأسباب: قائمة الأسباب اللي يختار منها العميل، وتقدر تعدّلها.
• سياسة الاسترجاع: نص يظهر للعميل قبل ما يرسل الطلب.
• التنبيهات: بريد يوصلك عند كل طلب جديد، وتقدر ترسل للعميل بريد عند تغيّر حالة طلبه.

تجربة العميل

1. بعد ما يتوصل طلبه، يظهر للعميل في صفحة التتبع زر الاسترجاع أو الاستبدال.
2. يختار المنتجات والكمية والسبب، ويقدر يرفع حتى ٣ صور.
3. يشوف ملخص المبلغ قبل الإرسال، ويتابع حالة طلبه من نفس الصفحة.

الاستبدال وخيارات البديل

العميل يختار واحد من اثنين:

• نفس المنتج بخيار ثاني: مقاس أو لون مختلف من خيارات المنتج نفسه.
• منتج آخر: يبحث في منتجات متجرك ويختار البديل، ويشوف سعره جنب اسمه.

الرسوم وحساب فرق السعر

الرسوم

لكل من الاسترجاع والاستبدال تختار: بدون رسوم، أو مبلغ ثابت، أو نسبة من قيمة المنتجات. وتقدر تحدد أسباب معفاة من الرسوم، مثل «المنتج تالف أو مكسور» و«وصلني منتج غير المطلوب».

حساب فرق سعر البديل

إذا العميل استبدل بمنتج آخر، أثر يحسب المبلغ تلقائيًا:

سعر المنتج اللي دفعه − سعر البديل بعد نفس الخصم − رسوم الاستبدال

مثال: منتج سعره ١٠٠ ريال اشتراه العميل بخصم ١٠٪ فدفع ٩٠. البديل سعره ٨٠، وبعد نفس الخصم ٧٢. ورسوم الاستبدال ٢٠ ريال.

٩٠ − ٧٢ − ٢٠ = −٢، يعني المطلوب من العميل ريالين. ولو طلع الناتج موجب، يظهر للعميل «يرجع لك».

الخيارات

• حساب المبلغ وفرق سعر البديل: لو أوقفته، تختفي الأسعار ويشوف العميل رسالة أن المتجر يتواصل معه بخصوص المبلغ.
• احسب بعد الخصم اللي استفاد منه العميل: مفعّل يعني نحسب على السعر اللي دفعه فعلًا ونطبق نفس نسبة الخصم على البديل. مغلق يعني نحسب على السعر قبل الخصم. ينطبق على الاسترجاع والاستبدال.

سعر البديل نأخذه من سلة مباشرة وقت إرسال الطلب، وتقدر تعدّل المبالغ يدويًا من بطاقة الطلب قبل الاعتماد.

إدارة الطلبات

كل الطلبات في الاسترجاع والاستبدال ← الطلبات. افتح أي طلب وغيّر حالته، وكل تغيير يظهر للعميل في صفحة التتبع.

• ما تقدر تتجاوز «تم إصدار البوليصة» بدون ما ترفع البوليصة.
• الرفض متاح بس وهو في مرحلة «استلمنا الطلب».
• تقدر تلغي أي طلب ما اكتمل، والمنتجات ترجع متاحة للعميل يطلب عليها من جديد.
• الملاحظة اللي تكتبها مع تغيير الحالة تظهر للعميل.

قوالب الردود وواتساب

في بطاقة الطلب فوق خانة الملاحظة، اختر قالب جاهز وينكتب باسم العميل ورقم طلبه. تقدر تضيف حتى ١٢ قالب من «إدارة القوالب»، واستخدم المتغيرات {name} لاسم العميل و{no} لرقم الطلب و{order} لرقم طلب المتجر.

زر أرسل عبر واتساب يفتح محادثة مع جوال العميل والرسالة مكتوبة (نص الملاحظة أو رسالة ترحيب)، وأنت تضغط إرسال من واتسابك.

التقارير والتصدير

تبويب التقارير يوريك لأي فترة تختارها:

• عمليات التتبع، والطلبات اللي لقاها العملاء.
• عدد طلبات الاسترجاع والاستبدال وحالاتها مقارنة بالفترة اللي قبلها.
• أكثر الأسباب، وأكثر المنتجات استرجاعًا واستبدالًا.
• الأداء حسب شركة الشحن: عدد الطلبات والمكتمل والمرفوض ومتوسط أيام الإنجاز.
• الطلبات اللي تحتاج متابعة لأنها واقفة من مدة.

والتصدير من إعدادات متقدمة ← بياناتك والنسخ الاحتياطي ← تصدير الطلبات بصيغة Excel أو CSV أو PDF، لفترة ونوع وحالة تختارها.

الرسائل النصية (SMS)

أرسل لعميلك رسائل نصية عن طلب الاسترجاع أو الاستبدال من اشتراكك الخاص عند مزوّد الرسائل. أثر يستدعي مزوّدك فقط، والتكلفة على حسابك عندهم.

المزوّدون المدعومون: تقنيات، ويونيفونيك، ومسجات، والجوالي.

الربط

1. من إعدادات متقدمة ← الرسائل النصية اختر المزوّد.
2. الصق بيانات الربط من حسابك عند المزوّد (مفتاح الـ API واسم المرسل المعتمد) واضغط «حفظ الربط».
3. اكتب جوالك واضغط «اختبار الاتصال». توصلك رسالة تجربة.
4. بعد نجاح الاختبار تتفعل القوالب: فعّل «إرسال رسائل SMS لعملائي» واختر الأحداث.

الأحداث والمتغيرات

تقدر ترسل رسالة عند: استلام الطلب، وإصدار بوليصة الإرجاع، وبدء المعالجة، وإنجاز الطلب، ورفضه. كل قالب تعدّله، وتستخدم فيه:

{name} اسم العميل، {no} رقم الطلب، {order} رقم طلب المتجر، {status} الحالة، {link} رابط التتبع، {store} اسم المتجر.

الرسالة العربية تحسب تقريبًا ٧٠ حرف للرسالة الوحدة، والعدّاد تحت كل قالب يوضح لك كم رسالة بتنحسب.

تحديث حالة الطلب في سلة

إذا تستخدم تطبيق واتساب في سلة (مثل كارتات) يرسل رسالة عند تغيّر حالة الطلب، أثر يقدر يحرّك حالة الطلب نفسه عشان يرسل التطبيق رسالته:

• عند إصدار بوليصة الإرجاع تصير حالة الطلب قيد الاسترجاع.
• عند إتمام الاسترجاع لكل منتجات الطلب تصير مسترجع.

الاسترجاع الجزئي (بعض منتجات الطلب) ما يغيّر حالة الطلب، والاستبدال ما يغيّرها. فعّلها من إعدادات متقدمة ← التكامل مع التطبيقات الثانية.

Webhook للمطورين

أثر يرسل كل حدث في طلبات الاسترجاع والاستبدال لرابط تحدده، عشان تربطه مع Make أو Zapier أو n8n أو نظامك. أضف الرابط من إعدادات متقدمة ← التكامل مع التطبيقات الثانية، ولازم يكون https عام.

الأحداث

return.created عند إنشاء الطلب، وreturn.waybill عند إرفاق البوليصة، وreturn.<status> عند تغيّر الحالة (مثل return.completed وreturn.rejected)، وtest من زر «إرسال تجربة».

الطلب

POST https://your-endpoint
Content-Type: application/json
X-Athar-Event: return.created
X-Athar-Timestamp: 1767225600
X-Athar-Signature: <hex>

{
  "event": "return.created",
  "store_id": "123456",
  "created_at": 1767225600,
  "request": {
    "id": "…", "no": "R-1001", "type": "return", "status": "received",
    "order_ref": "296366011",
    "customer": { "name": "…", "mobile": "9665…", "email": "…" },
    "items": [{ "id": "71", "name": "…", "qty": 1, "reason": "…", "want": "" }],
    "amounts": { "currency": "SAR", "value": 90, "fee": 20, "refund": 70, "price_diff": null },
    "link": "https://…"
  }
}

التحقق من التوقيع

التوقيع هو HMAC-SHA256 للنص timestamp + "." + body بمفتاحك السري (تلقاه في نفس البطاقة). مثال بـ Node.js:

import crypto from 'node:crypto';

function verify(req, rawBody, secret) {
  const ts = req.headers['x-athar-timestamp'];
  const sig = req.headers['x-athar-signature'];
  const expected = crypto.createHmac('sha256', secret).update(ts + '.' + rawBody).digest('hex');
  const fresh = Math.abs(Date.now() / 1000 - Number(ts)) < 300;
  return fresh && crypto.timingSafeEqual(Buffer.from(sig), Buffer.from(expected));
}

بياناتك وخصوصيتها

• طلبات الاسترجاع والاستبدال وكل خطواتها محفوظة طول ما أثر مثبت في متجرك.
• صور العملاء والبوالص المرفوعة تنحذف تلقائيًا بعد ٩٠ يوم من رفعها، وسجل الطلب يبقى.
• ننسخ بياناتك احتياطيًا كل يوم بنسخة مشفّرة.
• مفاتيح الربط (مثل الرسائل النصية والـ Webhook) محفوظة مشفّرة.
• لو حذفت التطبيق نحتفظ ببياناتك ٩٠ يوم، ولو رجعت ثبّته خلالها ترجع كما هي. بعدها تنحذف نهائيًا، ونرسل لك تنبيه بالإيميل قبلها.

والعميل ما يقدر يشوف طلب إلا إذا عرف رقمه مع الجوال أو البريد المسجل فيه.

حل المشاكل الشائعة

العميل يقول «ما لقينا الطلب»

تأكد أنه يكتب نفس الجوال أو البريد المسجل في الطلب، ورقم الطلب كما يظهر في سلة. الجوال يقبل الصيغ ٠٥ و٩٦٦ و+٩٦٦.

عدّلت المظهر وما تغيّر شيء

التغييرات تظهر خلال دقيقة إلى خمس دقائق. حدّث صفحة المتجر بعدها.

العميل ما يشوف زر الاسترجاع

الزر يظهر بس بعد ما يتوصل الطلب وخلال المدة اللي حددتها، ولازم تكون الميزة مفعّلة ومتاحة في باقتك.

البحث عن منتج بديل ما يشتغل

تأكد أن صلاحية قراءة المنتجات مفعّلة للتطبيق في سلة. بدونها يكتب العميل البديل نصيًا.

اختبار الرسائل النصية فشل

تأكد من المفتاح، وأن اسم المرسل معتمد عند المزوّد، وأن عندك رصيد. سبب الفشل يظهر تحت زر الاختبار.