Paraguay: Método para consultar el RUT en la Entidad Tributaria (GetAccount)

Este método permite consultar información de un RUC determinado, realizando una consulta directa a los registros de SIFEN, con la finalidad de conocer el estado de un RUC y determinar si es posible emitirle documentos. El método responde si el RUC consultado existe o no en los registros de SIFEN, y en caso de existir, informa si está Activo, suspendido, bloqueado, cancelado, y si es o no facturador electrónico.

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/Account/GetAccount

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

---

¿Cómo funciona el método GetAccount?

ANTES DE INICIAR

Es importante señalar que este método debe ser habilitado por Gosocket para poder hacer uso del mismo.

Solicita el acceso con el equipo comercial de Gosocket.

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

GetAccount (request)

Parámetro	Tipo	Descripción	Valores permitidos
AccountCode	String	ID Fiscal a consultar	Consultar tabla Estructura ID FiscalEstructura ID Fiscal
countryId	String	Código del país de la empresa que realiza la consulta	py

---

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.

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

---

Ejemplos de respuesta

{
  "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
}

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

GetAccount (response)

Parámetro	Tipo	Descripción	Valores permitidos
errorMessage	String	code | description según corresponda mensajes de error retornados
isValid	Bolean	- true cuando el RUC es válido - false cuando no es válido	- True - False
statusCode	String	Código de respuesta	Consultar tabla de códigos de respuesta que se muestra a continuación.
statusDescription	String	Descripción del código
StatusMessage	String	Código de respuesta statusCode - statusDescription
xmlBase64Bytes	String	XML en base 64 retornado por la SIFEN
xmlBytes	String	null
XmlDocumentKey	String	ID Fiscal consultado
XmlFileName	String	null
ResponseType	String	Tipo de respuesta: Síncrono	Sync
OtherData	String	Solo en caso de que haya concluido con éxito la consulta se debe retornar con los parámetros que siguen: - BusinessNameRUC - StatusCodeRUC - StatusDescriptionRUC - IsBillerElectronicRUC
OtherData.BusinessNameRUC	String	dRazCons	“NOMBRE DE CLIENTE”
OtherData.StatusCodeRUC	String	dCodEstCons	Ejemplo "ACT"
OtherData.StatusDescriptionRUC	String	dDesEstCons	Ejemplo "ACTIVO"
OtherData.IsBillerElectronicRUC	String	dRUCFactElec	Ejemplo "S"
GlobalDocumentId	String	TrackId de la consulta	UUID
Timestamp	String	Fecha-hora de consulta	2025-05-02T21:50:31.7268377Z
Response	String	null
TaxDocument	String	null
PrinterXml	String	null

Códigos de respuesta

Código	Descripción
0460	Mensaje de datos de entrada del WS siConsRUC superior a 1000 KB
0500	RUC inexistente
0501	RUC no tiene permiso para utilizar el WS
0502	Éxito en la consulta