Modification Reasons
Modification Reasons is the catalog of reasons you can select when creating a Customer Credit Note, a Customer Debit Note or a Cash Return that references an already-issued invoice, to state why that invoice is being modified. In the Dominican Republic, this catalog also holds the code required by the DGII for the replacement electronic fiscal document (e-CF).
What is it and what is it for?
When you create a Customer Credit Note, a Customer Debit Note, or a Cash Return and link it to the invoice it affects, AdmCloud lets you record the Affected Invoice Modification Reason: the specific reason that invoice is being corrected, returned or adjusted.
It isn't a closed catalog: you can create as many reasons as you need, each with a Name and, optionally, a Code. In the Dominican Republic, when you set up Electronic Invoicing (e-CF), AdmCloud automatically loads the 5 official DGII codes used to identify why a fiscal document is being replaced.
Where it's used
The Affected Invoice Modification Reason field appears, next to the affected invoice, on the Customer Credit Notes, Customer Debit Notes and Cash Returns forms.
This field only shows up if your company has the Modification Reasons feature enabled; if you don't see it on those forms, that feature isn't turned on for your account.
How to use it
- Browse the catalog. Open Modification Reasons from System Administration. You'll see the name of each reason, sorted alphabetically.
- Load the official codes (Dominican Republic). If your company is set up for the Dominican Republic and uses Electronic Invoicing, the 5 official DGII reasons (codes 1 through 5) are loaded automatically when you set up the electronic fiscal document; there's no need to create them by hand.
- Add your own reasons (optional). Click Add Record, type a descriptive Name and, if it applies, its Code, then save.
- Browse or edit a reason. Click its name in the list to see its detail, then use Edit to correct the Name or the Code.
- Select it when creating the document. When you create a Customer Credit Note, a Customer Debit Note or a Cash Return that references an invoice, choose the matching reason in the Affected Invoice Modification Reason field.
Main capabilities
- Create, browse and edit your own modification reasons, with a Name and an optional Code.
- In the Dominican Republic, automatic loading of the 5 official DGII codes when you set up Electronic Invoicing (e-CF).
- Select the reason from Customer Credit Notes, Customer Debit Notes and Cash Returns, next to the affected invoice.
- You can't delete a reason that's already referenced by an existing document.
Key fields
| Field | What it is for |
|---|---|
| Name | The reason's description (for example "Corrects amounts of the modified NCF"). Required and can't repeat across reasons. |
| Code | Optional code for the reason. In the Dominican Republic it matches the numeric code (1 through 5) required by the DGII for the replacement e-CF. Can't repeat across reasons. |
Validations when saving
- Name is required: AdmCloud won't save a reason without a description.
- The Name can't repeat: if a reason with the same Name already exists, AdmCloud rejects the save and tells you the record already exists.
- The Code can't repeat: two reasons can't share the same Code.
- A reason in use can't be deleted: if any Customer Credit Note, Customer Debit Note or Cash Return already has it selected, AdmCloud blocks the deletion and shows you which documents reference it.
Availability and conditions
- The "Affected Invoice Modification Reason" field on Credit Notes, Debit Notes and Cash Returns only appears if your company has the Modification Reasons feature enabled. If you don't see it, contact AdmCloud support to confirm whether it can be enabled for your account.
- Access to this catalog screen is controlled with the "Configuration" permission of System Administration (Browse, Add, Edit and Delete levels).
- The automatic loading of the 5 official DGII codes only applies to companies set up for the Dominican Republic, when setting up Electronic Invoicing.
Tips and common mistakes
Use clear, specific names for your own reasons (for example "Early payment discount" instead of "Adjustment"), so your team always picks the right one when creating the document.
Can't see the "Modification Reason" field when creating a Credit Note, Debit Note or Cash Return? That feature must be enabled for your company; if it's missing, contact AdmCloud support.
Can't delete a reason? Check the error message: AdmCloud tells you which documents have it selected. Reassign them to another reason before you can delete it.