Saltar al contenido principal

Colombia: Método para consultar datos del adquiriente (GetAccount)

Este método permite consultar los datos de “Nombre o Razón Social” y “Correo Electrónico” de un adquiriente o comprador, en el servicio de la Dirección de Impuestos y Aduanas Nacionales (DIAN), especificando tipo y número documento por medio del método GET GetAccount.

 La DIAN entrega la información de acuerdo con los registros actualizados de los adquirientes correspondientes a los años 2023 y 2024.

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

  • API en ambiente de Sandbox

https://developers-sbx.gosocket.net/api/v1/Account/GetAccount

  • API en ambiente de Producción

https://developers.gosocket.net/api/v1/Account/GetAccount

¿Cómo funciona el método GetAccount?​

Antes de explicar su funcionamiento es importante señalar que este método debe ser habilitado por Gosocket para poder hacer uso del mismo.

Si quiere hacer uso del método Acérquese con el equipo comercial de Gosocket.

Para realizar la petición, el método tiene el siguiente parámetro en formato JSON con la siguiente estructura:

GetAccount (request)
ParámetroTipoDescripciónValores permitidos
AccountCode*****StringID Fiscal de la empresa que realiza la consulta. Requerido para verificar que la empresa pueda hacer uso del servicio.Consultar tabla Estructura ID Fiscal
identificationType*****StringTipo de documento de identificación del adquiriente a consultarVer tabla Tipos de documento
receiverCode*****StringNúmero de identificación del adquiriente a consultarConsultar tabla Estructura ID Fiscal

* Todos los parámetros son requeridos

Tipos de documento
CódigoDescripción
11Registro civil
12Tarjeta de identidad
13Cédula de ciudadanía
21Tarjeta de extranjería
22Cédula de extranjería
31NIT
41Pasaporte
42Documento de identificación extranjero
47PEP (Permiso Especial de Permanencia)
48PPT (Permiso Protección Temporal)
50NIT de otro país
91NUIP

Ejemplo de petición​

image-20250506-144239.png

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.

  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.

Ejemplo de respuesta​

Respuesta no satisfactoria: Empresa No Habilitada

image-20250506-145019.png

{
    "ErrorMessage": null,
    "IsValid": false,
    "StatusCode": "500",
    "StatusDescription": "Empresa no activa para utilizar el evento GetAccount",
    "StatusMessage": "Empresa no activa para utilizar el evento GetAccount",
    "XmlBase64Bytes": null,
    "XmlBytes": null,
    "XmlDocumentKey": null,
    "XmlFileName": null,
    "ResponseType": null,
    "OtherData": null,
    "GlobalDocumentId": "00000000-0000-0000-0000-000000000000",
    "Timestamp": null,
    "Response": null,
    "TaxDocument": null,
    "PrinterXml": null
}

Respuesta satisfactoria: Adquiriente Encontrado

image-20250506-145703.png

{
    "ErrorMessage": null,
    "IsValid": true,
    "StatusCode": "200",
    "StatusDescription": "Adquiriente encontrado",
    "StatusMessage": "Código de respuesta 200 - Adquiriente encontrado",
    "XmlBase64Bytes": "PD94bWwgdmVyc2lvbj0iMS4wIiBlbmNvZGluZz0idXRmLTE2Ij8+DQo8QWRxdWlyaWVudGVSZXNwb25zZSB4bWxuczp4c2Q9Imh0dHA6Ly93d3cudzMub3JnLzIwMDEvWE1MU2NoZW1hIiB4bWxuczp4c2k9Imh0dHA6Ly93d3cudzMub3JnLzIwMDEvWE1MU2NoZW1hLWluc3RhbmNlIj4NCiAgPEV4dGVuc2lvbkRhdGEgLz4NCiAgPFJlY2VpdmVyRW1haWw+TWFpbF9Dw6lkdWxhIGRlIGNpdWRhZGFuw61hXzFAbWFpbC5jb208L1JlY2VpdmVyRW1haWw+DQogIDxSZWNlaXZlck5hbWU+Tm9tYnJlIEPDqWR1bGEgZGUgY2l1ZGFkYW7DrWEgMTwvUmVjZWl2ZXJOYW1lPg0KICA8U3RhdHVzQ29kZT4yMDA8L1N0YXR1c0NvZGU+DQo8L0FkcXVpcmllbnRlUmVzcG9uc2U+",
    "XmlBytes": null,
    "XmlDocumentKey": null,
    "XmlFileName": null,
    "ResponseType": "Sync",
    "OtherData": {
        "ReceiverName": "Nombre Cédula de ciudadanía 1",
        "ReceiverEmail": "Mail_Cédula de ciudadanía_1@mail.com"
    },
    "GlobalDocumentId": "00000000-0000-0000-0000-000000000000",
    "Timestamp": 2025-05-02T21:45:31.7268377Z,
    "Response": null,
    "TaxDocument": null,
    "PrinterXml": null
}

Respuesta no satisfactoria: Adquiriente No Encontrado

image-20250506-150041.png

{
    "ErrorMessage": [
        "404|Adquiriente no existe"
    ],
    "IsValid": false,
    "StatusCode": "404",
    "StatusDescription": "Adquiriente no existe",
    "StatusMessage": "Código de respuesta 404 - Adquiriente no existe",
    "XmlBase64Bytes": null,
    "XmlBytes": null,
    "XmlDocumentKey": null,
    "XmlFileName": null,
    "ResponseType": "Sync",
    "OtherData": null,
    "GlobalDocumentId": "00000000-0000-0000-0000-000000000000",
    "Timestamp": "2025-05-02T21:50:31.7268377Z",
    "Response": null,
    "TaxDocument": null,
    "PrinterXml": null
}

Respuesta no satisfactoria: Error interno

image-20250506-150323.png

{
    "ErrorMessage": [
        "Error al consultar Compliance",
        "A task was canceled."
    ],
    "IsValid": false,
    "StatusCode": "500",
    "StatusDescription": "Error al consultar Compliance",
    "StatusMessage": null,
    "XmlBase64Bytes": null,
    "XmlBytes": null,
    "XmlDocumentKey": null,
    "XmlFileName": null,
    "ResponseType": "Sync",
    "OtherData": null,
    "GlobalDocumentId": "00000000-0000-0000-0000-000000000000",
    "Timestamp": null,
    "Response": null,
    "TaxDocument": null,
    "PrinterXml": null
}

Para interpretar adecuadamente esta respuesta, tome en cuenta los siguientes parámetros:

GetAccount (response)
ParámetroTipoDescripciónValores permitidos
errorMessage*Stringcodedescription según corresponda mensajes de error retornados
isValidBoleanRsultado de la petición: * true cuando el adquiriente existe * false cuando no existe el adquirienteTrue False
statusCodeStringCódigo de respuesta404: Adquiriente no existe 200: Adquiriente encontrado 500: Error al consultar Compliance
statusDescriptionStringDescripción del código
xmlBase64BytesStringXML en base 64 de la respuesta retornada por la DIAN cuando existe el adquiriente.* null * XML en base 64
xmlBytesStringnull
XmlDocumentKeyStringnull
XmlFileNameStringnull
ResponseTypeStringTipo de respuesta contra el servicio de la DIAN: síncronaSync
OtherDataStringSolo en caso de que haya concluido con éxito la consulta, y el adquiriente haya sido encontrado, se retorna con los 2 parámetros que siguen: * ReceiverName * ReceiverMail* null * { "ReceiverName": "Nombre Cédula de ciudadanía 1", "ReceiverEmail": "Mail@dominio.com" }
ReceiverNameStringNombre o razón social del adquiriente consultado“NOMBRE DE CLIENTE”
ReceiverMailStringCorreo electrónico del adquiriente consultadoejemplo "mail@dominio.com"
GlobalDocumentIdString00000000-0000-0000-0000-00000000000000000000-0000-0000-0000-000000000000
TimestampStringFecha-hora de consulta2025-05-02T21:50:31.7268377Z
ResponseStringnull
TaxDocumentStringnull
PrinterXmlStringnull