Método para descargar el XML (DownloadDocumentXml)

Este método permite descargar el archivo XML de un documento utilizando el servicio GET DownloadDocumentXml.

Por medio de este método, se obtiene el archivo XML codificado en base 64 del documento consultado.

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/File/DownloadDocumentXml

SANDBOXhttps://developers-sbx.gosocket.net/api/v1/File/DownloadDocumentXml

Para realizar la petición, el método tiene los siguientes parámetros:

DownloadDocumentXml (request)
Parámetro	Tipo	Descripción	Valores permitidos
globalDocumentId*	String	Identificación de documento en Gosocket.	UUID de 36 caracteres alfanuméricos xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx
type	String	Tipo de xml a descargar	Ver tabla de Tipos de archivos a descargar

*Requerido

Tipos de Archivos a descargar
Type	Descripción	Paises donde aplica
original	XML Fiscal (Tributario): XML que se envía a la Entidad Tributaria. Solo incluye los personalizados en los paises que la Entidad los soporta dentro del XML.	AR, BO, CO, CR, DO, EC, PA, PE, PY, UY
default	XML de Gosocket: XML que se almacena en Inbox, incluye los campos personalizados	Todos
response	Respuesta Entidad Tributaria: Archivo con la respuesta de la Entidad Tributaria para el documento emitido.	Todos
smartsupply	XML de Smart Supply: XML que incluye los campos relacionados con la funcionalidad de SS.	Todos los paises donde esté implementado SS
distribution	XML de Distribución: XML que se distribuye de forma obligatoria	CO
addenda	XML Addenda Comercial: XML con el nodo de Addenda	MX
integration	Archivo JSON de integración: Archivo con el request enviado a la API para la emisión del documento	Todos

Ejemplo de petición

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

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

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

Puede convertir la respuesta del parámetro Base64Content cuyo resultado, para este ejemplo, es el siguiente:

Puede convertir la respuesta del parámetro Base64Content cuyo resultado, para este ejemplo, es el siguiente:

Puede convertir la respuesta del parámetro Base64Content cuyo resultado, para este ejemplo, es el siguiente:

Nota: A diferencia de los otros tipos de XML, no contiene campos personalizados.

Puede convertir la respuesta del parámetro Base64Content cuyo resultado, para este ejemplo, es el siguiente:

DownloadDocumentXml (response)
Parámetro	Tipo	Descripción	Valores permitidos
Name	String	Nombre del archivo XML descargado	globalDocumentId.xml
Description	String	Descripción del evento realizado.	Xml Content for GlobalDocumentId xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx
Base64Content	String	Archivo XML codificado en base 64
TimeStamp	String	Fecha y hora de creación del documento	aaaa-mm-ddThh:mm:ss
Type	String	Tipo de archivo	“xml”

Cuando no existe el Id del documento (globalDocumentId), el sistema responde un mensaje de error:
Se puede descargar el archivo tantas veces como sea necesario.
Cuando no se especifica el parámetro type o se pone un valor fuera de la lista, la API responde con el XML tipo default.
El XML de distribución tiene doble codificación, por lo que será necesario decodificarlo 2 veces.