اربط نظام نقاط البيع بـ Mise

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

1. احصل على مفتاح ومعرّف الموقع

يفتح مسؤول المطعم الإدارة ← مفاتيح API في Mise، وينشئ مفتاحًا وينسخه (يظهر مرة واحدة)، وينسخ من الصفحة نفسها معرّف الموقع الذي تتبعه نقطة البيع. يعمل المفتاح لهذه المؤسسة وحدها.

2. أرسل المبيعات

POST https://www.miseapp.app/api/pos
Authorization: Bearer mise_pos_xxxxxxxxxxxxxxxx
Content-Type: application/json

{
  "location_id": "3f0c2a9e-…",
  "pos_provider": "my-pos",
  "sales": [
    {
      "pos_item_id": "BURGER-01",
      "quantity_sold": 2,
      "revenue": 58.00,
      "currency": "SAR",
      "sold_at": "2026-10-22T13:05:00Z",
      "pos_reference": "ORDER-8812-1"
    }
  ]
}

• location_id: مطلوب، ويجب أن يتبع مؤسسة المفتاح.
• sales: من 1 إلى 500 سطر في الطلب الواحد.
• pos_item_id (أو menu_item_id): معرّف الصنف لديك، مطلوب.
• quantity_sold: عدد صحيح، 1 على الأقل.
• revenue: إجمالي السطر، صفر أو أكثر.
• currency: ثلاثة أحرف، وتكون SAR إن لم تُرسل.
• sold_at: بصيغة ISO 8601، ووقت الطلب إن لم يُرسل.
• pos_reference: معرّفك الفريد للسطر. نوصي به بشدة، انظر أدناه.
• pos_provider: اسم قصير لنظامك.

3. اقرأ الرد

{
  "success": true,
  "records_inserted": 1,
  "duplicates_skipped": 0,
  "records_mapped": 1,
  "stock_lines_deducted": 4,
  "stock_lines_skipped": 0
}

الدفعة تُقبل كاملة أو تُرفض كاملة: إن كان سطر واحد غير صالح لا يُكتب شيء، ويكون الرد 400 مع ما يصل إلى 20 من details تذكر السطر والسبب. المفتاح الخاطئ أو الملغى يعطي 401.

إعادة الإرسال آمنة

السطر الذي سبق استلام pos_reference الخاص به من نفس pos_provider يُتخطى مع المخزون، ويُحسب في duplicates_skipped. أرسل مرجعًا مع كل سطر وستتمكن من إعادة أي دفعة بعد انقطاع دون احتساب البيع مرتين. الأسطر بلا مرجع لا يمكن التعرف عليها مجددًا.

ربط الأصناف بالوصفات

يخصم Mise المخزون للأصناف التي يعرفها فقط. يربط المطعم كل معرّف صنف في نقاط البيع بوصفته من الإدارة ← ربط نقاط البيع. بيع صنف غير مرتبط يُسجَّل دون خصم أي شيء من المخزون، ويظهر كغير مرتبط في records_mapped.

الحدود

• 60 طلبًا في الدقيقة لكل مفتاح، و120 في الدقيقة لكل عنوان IP.
• عند تجاوز الحد يكون الرد 429 مع ترويسة Retry-After بالثواني.
• أرسل مرة في الدقيقة على الأكثر لكل نقطة بيع؛ دفعة عند نهاية كل طلب أو كل ساعة تكفي.

المساعدة

للأسئلة أو لإخبارنا بتكامل تبنيه: support@miseapp.app.