Method for marking documents as received (ConfirmReceivedDocument)

This method allows you to mark documents as received for the company using the POST ConfirmReceivedDocument service.

Using this method, you can mark one or several of the documents received for the company, using the unique ID (globalDocumentId) of each document received via the GetReceivedDocument method.

To connect to this functionality, you must enter the URL according to the environment you want to use:

PRODUCTIONhttps://developers.gosocket.net/api/v1/Document/ConfirmReceivedDocument

SANDBOXhttps://developers-sbx.gosocket.net/api/v1/Document/ConfirmReceivedDocument

Note: This method must be activated through your assigned consultant.

---

How does the ConfirmReceivedDocument method work?

To make the request, the method has one parameter of array type, in which the parameter only contains the array of documents to confirm, without specifying a name for the parameter, as shown below:

ConfirmReceivedDocument (request)
Type	Description	Example values
Array	List of Ids (globalDocumentId) of the documents to be marked as received or downloaded	Can be 1 or n [ "xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx", "yyyyyyyy-yyyy-yyyy-yyyy-yyyyyyyyyyyy" ]

---

Request example

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

For this method we use the Body tab, select raw, and verify 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 parameter shown in the previous table with its corresponding value.
4. Press Send.

---

Response example

To correctly interpret the API response, take into account the following criteria:

Note: Response parameters not specified in the table always come back empty or null because this is a batch or bulk process.

---

Characteristics of the ConfirmReceivedDocument method

You can mark 1 or n documents as received.

• This method must be used together with the GetReceivedDocument method, in order to get the Ids (globalDocumentId) of the documents to mark as received.
• When the request is made for a valid document, the process response in OtherData will be "OK".
• When the request is made several times for the same document, the process response in OtherData will be: "Document with GlobalDocumentId 025eb8e4-9d79-59c6-a40b-87e1ad6ce320 downloaded."
• When the request is made with an Id that does not exist, the process response in OtherData will be: "Document with GlobalDocumentId 00000000-0000-0000-0000-000000000001 not found".