مخزون بلس

الخدمة

سير العمل

1. 1جهز ملف CSV وفق الصيغة أدناه (ترميز UTF-8).
2. 2ارفع الملف إلى نقطة الرفع عبر multipart/form-data في الحقل file.
3. 3استعلم عن حالة الدفعة — تُعالج الدفعات خلال دقيقتين تقريبًا.
4. 4عند الاكتمال نزل ملف النتائج، أو ملف الرفض إن رفضت الدفعة.

صيغة الملف

يتكون الملف من صف رأس واحد يليه صف لكل طلب. صف الرأس إلزامي ويجب أن يطابق الأسماء والترتيب التاليين حرفيًا (11 عمودًا):

order_ref,recipient_name_ar,recipient_name_latin,phone,city,district,short_address,sku,qty,cod_amount_sar,notes

ملف نموذجي

نموذج صالح جاهز للرفع كما هو:

order_ref,recipient_name_ar,recipient_name_latin,phone,city,district,short_address,sku,qty,cod_amount_sar,notes
ORD-1001,محمد العتيبي,Mohammed Alotaibi,966512345678,Riyadh,العليا,RRDA2929,SKU-100,2,150,اتصال قبل التسليم
ORD-1002,نورة القحطاني,Noura Alqahtani,966598765432,Jeddah,الروضة,JEDB4411,SKU-205,1,0,
ORD-1003,خالد الشمري,Khalid Alshammari,966533221100,Dammam,الشاطئ,,SKU-100,3,89.50,تسليم مسائي

رفع دفعة

ارفع الملف عبر multipart/form-data في الحقل file. يعاد معرف الدفعة batch_id وحالتها الأولية PROCESSING.

POST /api/v1/makhzoon/batches

curl -X POST "https://manfath.example/api/v1/makhzoon/batches" \
  -H "Authorization: Bearer mnf_live_YOUR_KEY" \
  -F "file=@orders.csv"

الاستعلام عن الحالة

استعلم عن الدفعة بمعرفها حتى تتحول الحالة من PROCESSING إلى COMPLETED أو REJECTED. تُعالج الدفعات خلال دقيقتين تقريبًا، فلا حاجة إلى الاستعلام أكثر من مرة كل 15–30 ثانية.

GET /api/v1/makhzoon/batches/{batch_id}

curl "https://manfath.example/api/v1/makhzoon/batches/BATCH_ID" \
  -H "Authorization: Bearer mnf_live_YOUR_KEY"

مثال الاستجابة

{
  "batch_id": "ckz7q2m1x0001",
  "status": "COMPLETED",
  "row_count": 3,
  "accepted_count": 3,
  "rejected_count": 0,
  "result_csv": "order_ref,recipient_name_ar,...,tracking_number,status\n..."
}

حالات الدفعة