Método para ver los documentos recibidos (GetReceivedDocument)

Este método permite ver los documentos recibidos que tiene una empresa utilizando el servicio GET GetReceivedDocument.

Por medio de este método, se obtiene la lista de documentos recibidos con un límite a 50 documentos por consulta para la empresa. Cuando existen más documentos recibidos que el límite de la consulta (50), se deben marcar los documentos recuperados a fin de que en la próxima consulta no vuelvan a aparecer, y se dé lugar a nuevos documentos recibidos.

Cada documento tiene asignado un ID (globalDocumentId) con el cual es posible marcarlo como recibido usando el método POST ConfirmReceivedDocument que puede ver dando clic aquí.

Nota: Este método lo debe activar a través de su consultor asignado.

Para conectarse a esta funcionalidad será necesario que ingrese la URL de acuerdo con el ambiente a consumir:

PRODUCCIÓNhttps://developers.gosocket.net/api/v1/Document/GetReceivedDocument

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

---

¿Cómo funciona el método GetReceivedDocument?

Para realizar la petición, el método tiene el siguiente parámetro:

accountCode

GetReceivedDocument (request)
Parámetro	Tipo	Descripción	Valores permitidos
AccountCode	String	ID fiscal de la empresa	Ver tabla Estructura ID Fiscal

---

Ejemplo de petición

Para este método utilizamos la pestaña Params de Postman.

1. Seleccione el tipo de método. En este caso, se debe seleccionar GET.
2. Ingrese la URL del método.
3. Ingrese los parámetros que se muestran en la tabla anterior con sus valores correspondientes.
4. Presione Send.

Nota: Recuerde que antes de utilizar el método, debe realizar su autenticación dentro de la pestaña Authorization.

---

Ejemplo de respuesta

Para interpretar correctamente la respuesta de la API, tome en cuenta los siguientes criterios:

---

Características del método GetReceivedDocument

• El límite de resultados a mostrar en la consulta es de 50 documentos.
• Este método debe ser utilizado junto con el método ConfirmReceivedDocument.
• Se puede realizar varias veces la consulta y siempre dará el mismo resultado hasta que se marquen los documentos como recibidos usando el método ConfirmReceivedDocument.
• Luego de marcar los documentos, la consulta traerá los documentos recibidos pendientes por marcar.

---

El Salvador

Para el caso particular de El Salvador, hay que tener una consideración adicional ya que esta localidad tiene la particularidad de utilizar el formato JSON como estándar para la emisión de documentos electrónicos (a diferencia de las demás localidades que usan XML).

Al ser de esta forma y considerando la respuesta de este método (respuesta XML), se devuelve el XML estándar de Gosocket que contiene la información del documento recibido y en un elemento personalizado se incluye en base64 el archivo JSON original (tributario).

---

Ejemplo de respuesta

{
"Error": false,
"Description": null,
"CData": [
{
"GlobalDocumentId": "84bca6f4-eae2-18b8-44dd-70a6a5670486",
"XmlString": "<DTE version=\"DTE_v1.9\">...<campoString name=\"json\">ew0KICAiaWRlbnRpZmljYWNpb24iOiB7DQogICAgInZlcnNpb24iOiAxLA0KICAgICJhbWJpZW50ZSI6ICIwMCIsDQo...=</campoString>...</DTE>"
}
],
"Code": 200
}

Como se puede observar, la respuesta contiene un XML en el cual en el elemento <campoString name="json"> se incluye el archivo JSON en formato base64.

Ejemplo del contenido XML retornado en XmlString:

<DTE version="DTE_v1.9">
<Documento ID="ID_1">
<Encabezado>
<IdDoc>
<Ambiente>00</Ambiente>
<Version>1</Version>
<Tipo>07</Tipo>
<Numero>000000000000001</Numero>
<FechaEmis>2023-12-05T21:13:37.00</FechaEmis>
</IdDoc>
</Encabezado>
<Detalle>
<NroLinDet>1</NroLinDet>
<DscItem>Retencion aplicada sobre la factura</DscItem>
</Detalle>
</Documento>
<Personalizados>
<DocPersonalizado>
<campoString name="json">ew0KICAiaWRlbnRpZmljYWNpb24iOiB7DQogICAgInZlcnNpb24iOiAxLA0KICAgICJhbWJpZW50ZSI6ICIwMCIsDQo...=</campoString>
</DocPersonalizado>
</Personalizados>
</DTE>