---
title: "بدء مهمة فاتورة غير متزامنة"
method: POST
path: "/api/orders/{id}/invoice/jobs"
---

# بدء مهمة فاتورة غير متزامنة

`POST /api/orders/{id}/invoice/jobs`

## Request

- Base URL: `https://shop.alshhbaa.com`
- URL: `https://shop.alshhbaa.com/api/orders/{id}/invoice/jobs`
- Auth: none required

يبدأ عرض فاتورة PDF الطويلة في الخلفية ويعيد 202 Accepted فوراً مع معرّف المهمة (jobId) ورابط المتابعة (statusUrl). تابع GET /api/orders/{id}/invoice/jobs/{jobId} حتى تصبح الحالة succeeded ثم نزّل الفاتورة.

## Path parameters

- `id` integer, required

## Query parameters

- `token` string, required

## Response `202`

قُبلت المهمة للمعالجة. تابع رابط المتابعة حتى الاكتمال.

- 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)