ربط سيستم المحل
خلك قريب من شغل محلاتك.
استورد تقرير مبيعات، أو اطلب من مزوّد نظام الكاشير توصيله بواجهة عصفورة. التوافق والربط التلقائي يحتاجان تهيئة حسب اسم وإصدار النظام.
لوحة المبيعات والفروع ←هذه معاينة لطريقة الربط. الاستيراد ومفتاح الربط يتاحان في مساحة الشركة التجارية باشتراك فعّال وتخزين دائم.
استيراد تقرير المبيعات
صدّر المبيعات من برنامج المحل، ورتب الأعمدة حسب النموذج، ثم ارفع CSV بترميز UTF-8.
تحميل نموذج الأعمدة ↓الربط التلقائي مع الكاشير
مفتاح خاص بهذه الشركة يسمح بإضافة المبيعات فقط، ولا يسمح بقراءة العملاء أو تعديل الكاشير.
تفاصيل الربط لمزوّد نظام المبيعات
إرسال JSON إلى POST عبر HTTPS فقط:
https://asfoura.app/api/retail/salesالترويسة: Authorization: Bearer YOUR_COMPANY_KEY
نوع المحتوى: application/json
الحقول المطلوبة لكل عملية: رقمها external_id، رمز الفرع branch_ref، اسمه branch_name، الوقت occurred_at مع رمز التوقيت، النوع sale أو refund، المبلغ الموجب amount، والعملة QAR.
{"sales":[{"external_id":"SALE-1001","branch_ref":"DOH","branch_name":"فرع الدوحة","occurred_at":"2026-10-01T14:30:00+03:00","kind":"sale","amount":"120.50","currency":"QAR"}]}رقم كل عملية فريد داخل الفرع، بما فيها المرتجعات. تستخدم تقارير CSV والربط التلقائي الأرقام نفسها لتجنب تكرار الحساب. الدفعة إما تُقبل كاملة أو تُرفض كاملة؛ اختلاف بيانات عملية سابقة يرجع 409 للمراجعة. CSV يقبل أيضًا وقتًا محليًا بتوقيت قطر. العملة المدعومة حاليًا الريال القطري.
عصفورة