Method to obtain taxpayer information (GetAccount)

Method that allows you to know whether the queried Tax Identifier is active, and additionally, allows you to obtain taxpayer information, such as name, address, and email, depending on the country where the query is being executed.

This method must be enabled by Gosocket in order to use it, and it uses a per-company usage counter, which accrues monthly to facilitate billing.

If you want to use the method, get in touch with the Gosocket sales team.

The method is of type GET.

Environments

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

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

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

How does the GetAccount method work?

Depending on the country of execution, the parameters and behavior of the method vary:

🇨🇴 Colombia

Allows querying the data of a given purchaser or buyer, by making a direct query to the service of the Dirección de Impuestos y Aduanas Nacionales (DIAN), specifying the document type and number.

The method reports whether the queried document exists or not in DIAN's records, and if it exists, reports the name and email address.

🇬🇹 Guatemala

Allows querying the data of a given client, in the catalog provided by SAT, specifying the document type and number.

The method reports whether the queried document exists or not in SAT's records, and if it exists, reports the name, and for NIT queries, also reports the address.

🇵🇦 Panama

Allows querying the data of a given taxpayer, specifying the document type and number.

The method reports whether the queried document exists or not in the DGI's records, and if it exists, reports the name, check digit, and whether the taxpayer is enrolled in the SFE.

🇵🇾 Paraguay

Allows obtaining information about a given RUC, by making a direct query to SIFEN's records, in order to know the status of a RUC and determine whether it is possible to issue documents to it.

The method reports whether the queried RUC exists or not in SIFEN's records, and if it exists, reports whether it is Active, suspended, blocked, canceled, and whether or not it is an electronic biller.

🇺🇾 Uruguay

Allows querying denomination and fiscal address data by specifying the taxpayer's type and number.

The method reports whether the queried document exists or not in the DGI's records, and if it exists, reports the denomination, the fiscal address, or the certificate status.