# انوائس منسوخ کریں

## جائزہ

آپ انوائس منسوخ کر سکتے ہیں تاکہ گاہک اسے مزید ادا نہ کر سکے۔ یہ اس وقت کام آتا ہے جب انوائس میں کوئی غلطی ہو۔ منسوخی کے لیے دو شرطیں ہیں:

* انوائس کا اسٹیٹس: غیر ادا شدہ (Unpaid)
* ادائیگی کے صفحے کے ویوز: 0

اگر انوائس کسی دوسرے پروجیکٹ کی ہے اور کلید کسی پروجیکٹ تک محدود ہے، تو میتھڈ `Restricted project` کے ساتھ جواب دیتا ہے۔ اگر آپ کے پاس اس شناخت والی کوئی انوائس نہیں — `Invoice not found`۔ اگر انوائس مل جائے لیکن منسوخی کی شرائط پوری نہ ہوں — `Invoice cannot be canceled`۔

## درخواست

```bash
curl -X POST https://api.bitsby.app/invoices/cancel \
  -H "Authorization: Token MSvL2ltaDZdWVjmZURURMVWhqSJLT2NURjhL2Fla1Z1T1IxQTltKs1T3Ay" \
	-F "invoiceId=ade9550d-3dc7-4fd3-b94e-3b4c12aaaa0c"
```

## درخواست کے پیرامیٹرز

| پیرامیٹر   | ڈیٹا کی قسم | تفصیل               | مثال                              | لازمی؟ |
| ----------- | --------- | ------------------------- | ------------------------------------ | --------- |
| `invoiceId` | UUID      | UUID فارمیٹ میں انوائس ID | ade9550d-3dc7-4fd3-b94e-3b4c12aaaa0c | ہاں       |

## جواب کی مثال

```json
{
   "result":"success",
   "data":"Invoice canceled"
}
```