قراءة حالة مهمة الفاتورة

يقرأ حالة المهمة غير المتزامنة. القيم queued وprocessing تعني أن العمل مستمر — أعد الاستعلام بعد Retry-After. القيمة succeeded تعني أن الفاتورة جاهزة عبر invoiceUrl أو downloadUrl. أضف download=1 لتنزيل PDF مباشرة من مورد المهمة.

get/api/v1/orders/{id}/invoice/jobs/{jobId}

Request

  • Base URL: https://shop.alshhbaa.com
  • URL: https://shop.alshhbaa.com/api/v1/orders/{id}/invoice/jobs/{jobId}
  • Auth: none required

Query parameters

downloadstring

استخدم 1 لتنزيل PDF عند اكتمال المهمة

Response

حالة المهمة الحالية. تابع الاستعلام حتى الوصول لحالة نهائية.

jobIdstring uuid required

المعرّف الفريد للمهمة غير المتزامنة (job identifier).

orderIdinteger required
status'queued' | 'processing' | 'succeeded' | 'failed' required

الحالة الحالية للمهمة. القيم النهائية succeeded وfailed.

statusUrlstring uri required

رابط المتابعة (polling URL) لقراءة حالة المهمة حتى اكتمالها.

invoiceUrlstring uri

رابط تنزيل الفاتورة بعد اكتمال المهمة.

downloadUrlstring uri

رابط تنزيل PDF المباشر من مورد المهمة عند النجاح.

retryAfterinteger

عدد الثواني المقترح قبل إعادة الاستعلام.

createdAtstring date-time
updatedAtstring date-time
errorstring

Changes

No recorded changes to this operation across all 1 revision of this API.