---
title: "قراءة حالة مهمة الفاتورة"
method: GET
path: "/api/v1/orders/{id}/invoice/jobs/{jobId}"
---

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

`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

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

## Query parameters

- `download` string

## Response `200`

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

- InvoiceJob
  - `jobId` string, uuid, required: المعرّف الفريد للمهمة غير المتزامنة (job identifier).
  - `orderId` integer, required
  - `status` 'queued' | 'processing' | 'succeeded' | 'failed', required: الحالة الحالية للمهمة. القيم النهائية succeeded وfailed.
  - `statusUrl` string, uri, required: رابط المتابعة (polling URL) لقراءة حالة المهمة حتى اكتمالها.
  - `invoiceUrl` string, uri: رابط تنزيل الفاتورة بعد اكتمال المهمة.
  - `downloadUrl` string, uri: رابط تنزيل PDF المباشر من مورد المهمة عند النجاح.
  - `retryAfter` integer: عدد الثواني المقترح قبل إعادة الاستعلام.
  - `createdAt` string, date-time
  - `updatedAt` string, date-time
  - `error` string

## Other responses

- `404`: طلب غير صالح

---

[API](https://skmtc.dev/alshhbaa/apis/alshhbaa-copperware-api.md) · [All operations](https://skmtc.dev/alshhbaa/apis/alshhbaa-copperware-api/llms.txt) · [OpenAPI document](https://skmtc.dev/alshhbaa/apis/alshhbaa-copperware-api/revisions/eaa2e33e878f?raw)