PUT https://app.alaaqat.com/api/invoices/{invoice_id}
حيث invoice_id هو قيمة _id للفاتورة. تغيّر هذه النقطة قيم الخصائص التي ترسلها، وتبقى الخصائص الأخرى كما هي. يحتاج مفتاح واجهة التطبيق البرمجية إلى الإمكانية invoice-update، ويحتاج عضو الفريق الذي أنشأ المفتاح إلى صلاحية تعديل الفواتير.
{
"Accept": "application/json",
"Content-Type": "application/json"
}
قيم الخصائص نفسها المذكورة في إنشاء فاتورة: كل مفتاح هو internal_name لخاصية، ويجب أن تطابق كل قيمة نوعها. أرسل الخصائص التي تريد تغييرها فقط، ولإفراغ قيمة أرسل null.
{
"status": "paid"
}
إذا لم ترسل items تبقى البنود كما هي. وإذا أرسلتها، تحلّ القائمة المرسلة محل القائمة الحالية، فأرسل كل بند تريد إبقاءه مع name وunit_price وquantity الخاصة به.
يعيد نظام علاقات حساب amount مع كل تعديل. راجع البنود والمبلغ.
200 OK، ويأتي السجل كاملاً ضمن data.
{
"data": {
"properties": {
"_id": "6657c1d2e3f4a5b6c7d8e901",
"title": "Office chairs, October order",
"status": "paid",
"currency": "JOD",
"discount_rate": 5,
"tax_rate": 16,
"invoice_number": "INV-1001",
"amount": 523.45,
"created_by": 12,
"updated_at": "2026-10-21T08:40:12.000000Z",
"created_at": "2026-10-20T09:30:00.000000Z"
},
"account_id": 1024,
"items": [
{
"net_price": 440,
"name": "Ergonomic office chair",
"unit_price": 120,
"quantity": 4,
"description": "Black mesh back",
"unit_discount": 10,
"tax_rate": 0
},
{
"net_price": 35,
"name": "Delivery and assembly",
"unit_price": 35,
"quantity": 1,
"description": null,
"unit_discount": 0,
"tax_rate": 0
}
]
},
"message": "Entity was modified successfully."
}
| الرمز | المعنى |
|---|---|
| 403 | عضو الفريق الذي أنشأ المفتاح لا يستطيع تعديل إلا الفواتير التي يملكها هو أو فرقه، وهذا السجل ليس منها. |
| 404 | لا يوجد في حسابك سجل بقيمة _id هذه. |
| 422 | قيمة لا تطابق نوع خاصيتها، أو أُرسل حقل يضعه نظام علاقات بنفسه. |