الطلبات

إنشاء طلب

POST/api/v1/orders

ابعت كل طلب أول ما يتعمل. يودوو بيحفظه ويشغّل أتوميشن الطلبات بتاعة المتجر: رسالة التأكيد المناسبة لطريقة الدفع الأول. لو بعت نفس الـ id تاني الطلب بيتحدّث بدل ما يتعمل طلب تاني، فإعادة الإرسال دايماً آمنة.

curl -X POST https://app.yudoo.io/api/v1/orders \
  -H "Authorization: Bearer wp_live_your_api_key" \
  -H "Content-Type: application/json" \
  -d '{
    "id": "1042",
    "number": "1042",
    "status": "pending",
    "customer": { "name": "Mohamed Ali", "phone": "201001234567", "email": "mohamed@example.com" },
    "currency": "EGP",
    "total": 540,
    "shipping_total": 40,
    "payment_method": "cod",
    "shipping_address": { "address1": "12 Tahrir St", "city": "Cairo", "province": "Cairo", "country": "EG" },
    "items": [
      { "name": "Cotton T-shirt", "variant": "White / L", "quantity": 1, "price": 250, "sku": "TS-WH-L" },
      { "name": "Sport socks", "quantity": 2, "price": 125 }
    ],
    "note": "Please deliver after 5 pm"
  }'
الحقلالنوعالوصف
idstringمطلوب. رقم الطلب عندك في منصتك. لو بعت نفس الـ id تاني، الطلب ده بيتحدّث.
customer.phonestringمطلوب. بالصيغة الدولية بكود الدولة، أرقام بس (201001234567). رسايل واتساب بتروح للرقم ده.
customer.namestringاسم العميل ({{customer_first_name}} في الرسايل).
customer.emailstringاختياري.
numberstringالرقم اللي العميل عارفه ("1042" ← #1042). لو مابعتوش بيبقى #id.
statusstringpending (الافتراضي)، processing، shipped، delivered، cancelled… شوف حالات الطلب.
payment_methodstringcod، bank_transfer، instapay، vodafone_cash، card… بيحدد رسالة التأكيد اللي الطلب ياخدها. شوف طرق الدفع.
currencystringكود ISO من 3 حروف: EGP، SAR، AED، USD…
totalnumberإجمالي الطلب شامل الشحن.
shipping_totalnumberمصاريف الشحن.
items[]arrayلحد 200 سطر: name (مطلوب)، quantity، price، variant، sku، product_id، image_url (https).
shipping_addressobjectaddress1، address2، city، province، postal_code، country (كود من حرفين أو الاسم).
notestringملاحظة العميل على الطلب.
trackingobjectnumber، url، carrier — لو الطلب اتشحن خلاص.
placed_atstringتاريخ ISO 8601. لو مابعتوش بيبقى وقت وصول الطلب ليودوو.

الرد بيبقى 201 Created ومعاه الطلب (200 لو الـ id اتبعت قبل كده):

json
{
  "order": {
    "id": "1042",
    "number": "#1042",
    "status": "pending",
    "confirmation": { "status": "pending", "at": null, "cancel_reason": null },
    "customer": { "name": "Mohamed Ali", "phone": "201001234567", "email": "mohamed@example.com" },
    "currency": "EGP",
    "total": 540,
    "payment_method": "cod",
    "items": [
      { "name": "Cotton T-shirt", "variant": "White / L", "quantity": 1, "price": 250, "sku": "TS-WH-L", "product_id": null },
      { "name": "Sport socks", "variant": null, "quantity": 2, "price": 125, "sku": null, "product_id": null }
    ],
    "tracking": null,
    "created_at": "2026-11-04T10:00:00.000Z",
    "updated_at": "2026-11-04T10:00:00.000Z"
  }
}

واقف في حاجة، أو محتاج حقل مش موجود؟ فريقنا بيرد على واتساب.

اسألنا على واتسابافتح تطبيق يودوو