تخطَّ إلى المستندات
API

الحصول على فاتورة دفعة

رابط ملف PDF، بصيغة JSON.

GET/billing/invoices/{orderId}

ينفّذ الاستدعاء الحقيقي على مساحة عملك.

GET /billing/invoices/{orderId}

رابط ملف PDF، بصيغة JSON.

مثال

يتطلب billing:read. الفاتورة التي لم تُكتب بعد تُكتب أولًا، من بيانات الفوترة في الدفعة أو في الحساب، وقد يستغرق ذلك بضع ثوانٍ.

curl
curl "$OE/billing/invoices/8c51f0d2-3b7e-4a19-b6c4-0e9d2f7a1c38" -H "$AUTH"
الاستجابة
{  "object": "invoice_link",  "orderId": "8c51f0d2-3b7e-4a19-b6c4-0e9d2f7a1c38",  "url": "https://files.example.com/invoices/acme-0007.pdf?signature=5f2c9a",  "fileName": "Invoice-ACME-0007.pdf"}

الرابط موقَّع من مزوّد الدفع، وينزّل ملف PDF ويتوقف عن العمل بعد مدة، فاجلبه من جديد بدل الاحتفاظ به.

الدفعة التي لا اسم ولا عنوان فوترة لها تعيد 409 billing_details_required، والدفعة المسودة أو الملغاة تعيد 409 invoice_unavailable، والفاتورة التي ما زالت تُكتب تعيد 504 invoice_not_ready.

المرجع