Credit note rejected — reason code and reference errors
Fix the most common credit note rejection causes: missing reason code, missing original invoice reference, and wrong document type.
UAE credit notes have three extra requirements beyond a standard invoice:
- Document type code must be
381(not380). - Original invoice reference (IBT-25): the invoice number and issue date.
- Reason code (IBR-001-AE / IBR-158-AE): one of the six defined codes.
Allowed reason codes
| Code | Meaning |
|---|---|
DL8.61.1.A |
Goods returned or services cancelled |
DL8.61.1.B |
Pricing or calculation error |
DL8.61.1.C |
Contractual discount or rebate |
DL8.61.1.D |
Partial supply — quantity short-shipped |
DL8.61.1.E |
Early payment discount applied |
VD |
Void / full cancellation |
Common rule failures
| Rule | What's wrong | Fix |
|---|---|---|
| IBR-055-AE | Preceding invoice number missing | Set the billing reference to the original invoice number |
| IBR-001-AE | Preceding invoice issue date missing | Add the original invoice date next to the invoice number |
| IBR-158-AE | Reason code missing or invalid | Use one of the six codes above |
| IBR-175-AE | Preceding document ID does not match the original | Copy the invoice number exactly, including any prefix |
| IBR-124-AE | Tax point date present (only allowed on invoices, not credit notes) | Remove the tax point date |
Steps to issue a correct credit note
- In the portal, open the original invoice and click Issue credit note.
- Select the reason code from the dropdown.
- Adjust the quantities or amounts being credited.
- Review — the preceding invoice reference is filled automatically.
- Submit.
See also: Validation rules · Scenario finder — credit note.