# ยกเลิกใบแจ้งหนี้

## ภาพรวม

คุณยกเลิกใบแจ้งหนี้ได้เพื่อไม่ให้ลูกค้าชำระได้อีก มีประโยชน์เมื่อใบแจ้งหนี้มีข้อผิดพลาด การยกเลิกต้องเข้าเงื่อนไขสองข้อ:

* สถานะใบแจ้งหนี้: ยังไม่ชำระ (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 | ID ของใบแจ้งหนี้ในรูปแบบ UUID | ade9550d-3dc7-4fd3-b94e-3b4c12aaaa0c | ใช่ |

## ตัวอย่างการตอบกลับ

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