Uruguay: Acceptance and Rejection of Documents

Through the ChangeDocumentStatus method, we can also issue acknowledgments of acceptance or rejection for received documents through the API.

Let's see how to issue these events.

The request parameters to issue these events are as follows:

ChangeDocumentStatus (request)
Parameter	Type	Description	Allowed values
globalDocumentId	String	Document identification in Gosocket. Required if countryDocumentId is not provided	36-character alphanumeric UUID xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx
countryDocumentId	String	Country-level tax identifier of the document, also known as CUFE, CLAVE, UUID, ID Required if globalDocumentId is not provided	See the Country Document ID Structure table
countryId*	String	Country code of the document's country of issuance	uy
status*	Integer	Acceptance or rejection code	Acceptance: 033 or 33 Rejection: 31 or 031
Description*	String	Acknowledgment comments	Free text
code*	String	Rejection code (required only in case of rejection)	See the Rejection Codes table

*Required

Rejection Codes
Code	Description
E20	Expired purchase order
E21	Goods in poor condition
E22	Supplier disabled by controlling body
E23	Consideration not received
E24	Difference in prices and/or discounts
E25	Invoice with calculation error
E26	Difference in terms

---

Request example

Note: Remember that before using the method, you must authenticate within the Authorization tab.

For this method we use the Body tab, select raw, and check or select JSON in Postman.

1. Select the method type. In this case, you must select POST.
2. Enter the method URL.
3. Enter the parameters shown in the table above with their corresponding values.
4. Press Send.

---

Response example

---

Once the acknowledgment has been generated, the following elements are shown within the document preview, which can be viewed from the Gosocket Inbox:

In the notes section of the preview we will find:

1. Event generation, along with the user who generated it.
2. The commercial event generated, which can be acceptance or rejection.
3. A list of the email addresses to which the email was sent, or a note with the error explaining why the email could not be sent.

Additionally, within the Attachments section, we see the following:

4. XML of the event generated for the document.

From the received documents query screen within the Inbox, the acceptance () or rejection () icon is shown among the statuses on the Received documents query screen.

---

Characteristics

• Acknowledgments can only be generated for documents approved by the ET (AuthorityStatus=2)
• Acknowledgments can only be generated for documents when the document's issuance date does not exceed 20 calendar days from the current date.
• The event is sent with the acknowledgment XML attached via email.
• The acknowledgment is not sent to the Tax Authority.