تعديل فاتورة

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 قيمة لا تطابق نوع خاصيتها، أو أُرسل حقل يضعه نظام علاقات بنفسه.