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

Este método permite consultar el Registro Único Tributario en la Dirección Nacional de Ingresos Tributarios a un documento utilizando el servicio GET GetAccount.

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ámetro	Tipo	Descripción	Valores permitidos
AccountCode*****	String	ID Fiscal a consultar	Consultar tabla Estructura ID FiscalEstructura ID Fiscal

---

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.

---

Ejemplo de respuesta

Respuesta no satisfactoria

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
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
xmlBase64Bytes	String	XMLen base 64 retornado por la SIFEN
xmlBytes	String	XML en Bytes retornado por la SIFEN
OtherData	String	Solo en caso de que haya concluido con éxito la consulta se debe retornar con los parámetros que siguen.
BusinessNameRUC	String	dRazCons	“NOMBRE DE CLIENTE”
StatusCodeRUC	String	dCodEstCons	ejemplo "ACT"
StatusDescriptionRUC	String	dDesEstCons	ejemplo "ACTIVO"
IsBillerElectronicRUC	String	dRUCFactElec	ejemplo "S"

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