ยกเลิกใบแจ้งหนี้
ภาพรวม
คุณยกเลิกใบแจ้งหนี้ได้เพื่อไม่ให้ลูกค้าชำระได้อีก มีประโยชน์เมื่อใบแจ้งหนี้มีข้อผิดพลาด การยกเลิกต้องเข้าเงื่อนไขสองข้อ:
- สถานะใบแจ้งหนี้: ยังไม่ชำระ (Unpaid)
- จำนวนการดูหน้าชำระเงิน: 0
หากใบแจ้งหนี้เป็นของโปรเจกต์อื่นและคีย์ถูกจำกัดไว้กับโปรเจกต์ เมธอดจะตอบกลับด้วย Restricted project หากคุณไม่มีใบแจ้งหนี้ตามตัวระบุนั้น — Invoice not found หากพบใบแจ้งหนี้แต่ไม่เข้าเงื่อนไขการยกเลิก — Invoice cannot be canceled
คำขอ
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 | ใช่ |
ตัวอย่างการตอบกลับ
{
"result":"success",
"data":"Invoice canceled"
}