Información general del servicio
Descripción
Este servicio expone datos referentes a los asegurados inscriptos en los registros del IPS.
Observaciones
Servicio de uso exclusivo para instituciones públicas.
Proveedor
Instituto de Previsión Social (IPS).
Ambiente de Publicación
Producción
Mecanismo de autorización
Presentar Formulario de Solicitud del SII firmado por la máxima autoridad al MITIC y una nota para el productor, informando sobre el uso que se le dará a sus datos.
Gestión de Documentos en Línea (GDL)
Servicio Habilitado
Tipo de servicio
REST: https://sii.paraguay.gov.py/frontend-ips/api/ REST: https://sii.paraguay.gov.py/ips-rest/api/
Documentación
—
Parámetros de cabecera
Authorization String (header)* requerido Accept String (header)* requerido
Métodos
Método 1 – Servicio Para obtener listado de empresas por rango de fecha de inscripción
https://sii.paraguay.gov.py/frontend-ips/api/ips/findEmpresasXFechaInscripcion/{fechaInscripcionIni}/{fechaInscripcionFin}
Parámetros
fechaInscripcionIni String (path) * requerido fechaInscripcionFin String (path) * requerido
Respuesta
Modelo
RetornoEmpresasXFechaInscripcion{
lstEmpresas [ListaEmpresas{
des_actpri string
des_emplea string
des_sucurs string
des_tipemp string
dig_verificador integer
fec_iniact string
fec_inscri string
ide_emplea integer
ind_estemp string
ind_tipemp string
nro_patron string
nro_ruc string
}]
returnCode integer
returnMessage string
}
Método 2
https://sii.paraguay.gov.py/frontend-ips/api/ips/findEmpresasXFechaInactivacion/{fechaInactivacionIni}/{fechaInactivacionFin}
Parámetros
fechaInactivacionIni string (path) * requerido fechaInactivacionFin string (path) * requerido
Respuesta
Modelo
RetornoEmpresasXFechaInactivacion{
lstEmpresas [ListaEmpresas{
des_actpri string
des_emplea string
des_sucurs string
des_tipemp string
dig_verificador integer
fec_iniact string
fec_inscri string
ide_emplea integer
ind_estemp string
ind_tipemp string
nro_patron string
nro_ruc string
}]
returnCode integer
returnMessage string
}
Método 3 – Servicio Para obtener datos del asegurado
https://sii.paraguay.gov.py/frontend-ips/api/ips/findDatosAsegurado/{nroDocumento}
Parámetros
nroDocumento string (path) * requerido
Respuesta
Modelo
RetornoDatosAsegurado{
lstDatosAsegurado [DatosAsegurado{
aporteJubilacion string
cantidadBeneficiariosActivos integer
empleador string
estado string
fechaInscripcion string
mesesAporte integer
numeroCI string
tipoAsegurado string
vigente string
}]
returnCode integer
returnMessage string
}
Método 4 – Servicio Para obtener salario del asegurad
https://sii.paraguay.gov.py/frontend-ips/api/ips/findDatosSalario/{nroDocumento}
Parámetros
nroDocumento string (path) * requerido
Respuesta
Modelo
RetornoDatosSalario{
lstDatosSalario [DatosSalario{
empleador string
fecha string
mesesAporte integer
numeroCI string
salario integer
}]
returnCode integer
returnMessage string
}
Método 5
https://sii.paraguay.gov.py/frontend-ips/api/ips/findConstanciaInscripcionPatronal?nroRuc=xx&codZona=xx&codActivi=xxx&nroEmplea=xxx
Parámetros de Entrada
nroRuc string (query param) * requerido codZona integer (query param) * requerido codActivi integer (query param) * requerido nroEmplea integer (query param) * requerido
Respuesta
Modelo
RetornoDatosAOP{
lstDatosAOP [ListaDatosAOP{
des_actpri string
des_emplea string
des_sucurs string
des_tipemp string
dig_verificador integer
fec_iniact string
fec_inscri string
ide_emplea integer
ind_tipemp string
nro_patron string
nro_ruc string
usu_ultmod string
}]
returnCode integer
returnMessage string
}
Método 6 – Servicio Lista de empleados por ruc
https://sii.paraguay.gov.py/ips-rest/api/ips/findListaEmpleadosByRUC/{ruc}/{pagina}
Parámetros de Entrada
ruc string (path)* requerido pagina integer (path)* requerido
Respuesta
Modelo
IPSResult{
[asegurados{
apellido string
nombre string
nroCedula string
tipoSeguro string
}]
[empleadores{
desEmpleador string
nroPatronal string
ultimoPeriodo string
}]
cantPaginas integer
mensaje string
}
Método 7
https://sii.paraguay.gov.py/frontend-ips/api/ips/findDatosAseguradoPatronal/{numeroRuc}
Parámetros de Entrada
numeroRuc string (path param) * requerido
Respuesta
Modelo
"RetornoDatosAseguradoPatronal": {
"type": "object",
"properties": {
"lstDatosAseguradoPatronal": {
"type": "array",
"items": {
"DatosAseguradoPatronal": {
"type": "object",
"properties": {
"apellido": {
"type": "string"
},
"fechaEntrada": {
"type": "string"
},
"nombre": {
"type": "string"
},
"numeroCedula": {
"type": "string"
},
"numeroPatronal": {
"type": "string"
},
"razonSocial": {
"type": "string"
},
"remuneracion": {
"type": "string"
}
}
}
}
},
"returnCode": {
"type": "integer",
"format": "int32"
},
"returnMessage": {
"type": "string"
}
}
}
Método 8
https://sii.paraguay.gov.py/frontend-ips/api/ips/findDatosAseguradoFecha?fechaDesde=yyyy/mm/dd&fechaHasta=yyyy/mm/dd&pagina=n
Parámetros de Entrada
fechaDesde string (query param) * requerido fechaHasta integer (query param) * requerido pagina integer (query param) * requerido
Respuesta
Modelo
"WsDatosAseguradoFechaResponse": {
"type": "object",
"properties": {
"retornoDatosAseguradoFecha": {
"RetornoDatosAseguradoFecha": {
"type": "object",
"properties": {
"datosAseguradoFecha": {
"type": "array",
"items": {
"DatosAseguradoFecha": {
"type": "object",
"properties": {
"aporteJubilacion": {
"type": "string"
},
"callePrincipal": {
"type": "string"
},
"calleSecundaria": {
"type": "string"
},
"correo": {
"type": "string"
},
"departamento": {
"type": "string"
},
"empleador": {
"type": "string"
},
"estado": {
"type": "string"
},
"fechaEntrada": {
"type": "string",
"format": "date-time"
},
"fechaInscripcion": {
"type": "string",
"format": "date-time"
},
"fechaSalida": {
"type": "string",
"format": "date-time"
},
"fechaVigencia": {
"type": "string",
"format": "date-time"
},
"localidad": {
"type": "string"
},
"mesesAporte": {
"type": "integer",
"format": "int32"
},
"nroPatronal": {
"type": "string"
},
"numeroCI": {
"type": "string"
},
"remuneracion": {
"type": "string"
},
"ruc": {
"type": "string"
},
"telefono": {
"type": "string"
},
"tipoAsegurado": {
"type": "string"
},
"vigente": {
"type": "string"
}
}
}
}
},
"returnCode": {
"type": "integer",
"format": "int32"
},
"returnMessage": {
"type": "string"
}
}
}
}
}
}
Método 9 – Estado de pago de la patronal
https://sii.paraguay.gov.py/ips-rest/api/ips/estadoPatronal/{ruc}
Parámetros
ruc String (path param) * requerido
Respuesta
Modelo
"EstadoPatronalResult": {
"type": "object",
"properties": {
"id_consulta": {
"type": "integer",
"format": "int32"
},
"data": {
"type": "object",
"properties": {
"estado": {
"type": "string"
},
"fecha_de_emi": {
"type": "string"
},
"empresas": {
"type": "array",
"items": {
"Empresa": {
"type": "object",
"properties": {
"actividad": {
"type": "string"
},
"id_emplea": {
"type": "string"
},
"fecha_de_inscrip": {
"type": "string"
},
"ruc": {
"type": "string"
},
"cant_de_emplea": {
"type": "string"
},
"nombre": {
"type": "string"
}
}
}
}
}
}
},
"http_response": {
"HTTP_Response": {
"type": "object",
"properties": {
"message": {
"type": "string"
},
"code": {
"type": "string"
}
}
}
}
}
}
Método 10 – Servicio para obtener Listado tipo de empresa
https://sii.paraguay.gov.py/ips-rest/api/ips/WsInscripcionPatronal/api/listado/tipoempresa
Parámetros
Ninguno
Respuesta
Modelo
"EstadoPatronalResult": {
"type": "object",
"properties": {
"id": "integer",
"ideTipDoc": "string",
"DesTipEmp": "string"
)
}
Método 11 – Servicio Listado de sucursales
https://sii.paraguay.gov.py/ips-rest/api/ips/WsInscripcionPatronal/api/listado/sucursalParámetros
Ninguno
Respuesta
Modelo
"EstadoPatronalResult": {
"type": "object",
"properties": {
"id": "numeric",
"codSucurs": "string",
"desSucurs": "string"
)
}
Método 12 – Servicio Listado de sexo
https://sii.paraguay.gov.py/ips-rest/api/ips/WsInscripcionPatronal/api/listado/sexo
Parámetros
Ninguno
Respuesta
Modelo
"EstadoPatronalResult": {
"type": "object",
"properties": {
"codSexo": "string",
"desSexo": "string"
)
}
Método 13 – Servicio Listado de tipo de sucursal
https://sii.paraguay.gov.py/ips-rest/api/ips/WsInscripcionPatronal/api/listado/tiposucursal
Parámetros
Ninguno
Respuesta
Modelo
"EstadoPatronalResult": {
"type": "object",
"properties": {
"codTipSuc": "string",
"desTipSuc": "string"
)
}
Método 14 – Servicio Listado de países
https://sii.paraguay.gov.py/ips-rest/api/ips/WsInscripcionPatronal/api/listado/paisParámetros
Ninguno
Respuesta
Modelo
"EstadoPatronalResult": {
"type": "object",
"properties": {
"id": "string",
"codPais": "string",
"desPais": "string"
)
}
Método 15 – Servicio Consulta de asegurado por número de cédula
https://sii.paraguay.gov.py/ips-rest/api/ips/WsInscripcionPatronal/api/asegurado/consulta/{nrocic}
Parámetros
nrocic string (path) * requerido
Respuesta
Modelo
"EstadoPatronalResult": {
"type": "object",
"properties": {
"ideAsecot": "string",
"nroCic": "string",
"nroAsegur": "string",
"apeAsegur": "string",
"nomAsegur": "string",
"indSexo": "string",
"fecNacimi": "fecha",
"indEstciv": "string",
"codNacion": "string",
"fecDefusi": "Fecha",
"fecUltmod": "Fecha",
"calPrinci": "string",
"nroDomic": "string",
"nomBarrio": "string"
)
}
Método 16 – Servicio Listado de tipo de movimiento
https://sii.paraguay.gov.py/ips-rest/api/ips/WsInscripcionPatronal/api/listado/tipomovimiento
Parámetros
Ninguno
Respuesta
Modelo
"EstadoPatronalResult": {
"type": "object",
"properties": {
"codTipMov": "numeric",
"desTipMov": "string"
)
}
Método 17 – Servicio Listado de tipo de asegurado
https://sii.paraguay.gov.py/ips-rest/api/ips/WsInscripcionPatronal/api/listado/tipoaseguradoParámetros
Ninguno
Respuesta
Modelo
"EstadoPatronalResult": {
"type": "object",
"properties": {
"codTipAse": "string",
"desTipase": "string"
)
}
Método 18 – Servicio Listado de regímenes
https://sii.paraguay.gov.py/ips-rest/api/ips/WsInscripcionPatronal/api/listado/regimen
Parámetros
Ninguno
Respuesta
Modelo
"EstadoPatronalResult": {
"type": "object",
"properties": {
"codRegEmp": "string",
"desRegEmp": "string"
)
}
Método 19 – Servicio Listado de nacionalidades
https://sii.paraguay.gov.py/ips-rest/api/ips/WsInscripcionPatronal/api/listado/nacionalidad
Parámetros
Ninguno
Respuesta
Modelo
"EstadoPatronalResult": {
"type": "object",
"properties": {
"ideNacion": "string",
"desNacion": "string",
"codPais": "string",
"desPais": "string"
)
}
Método 20 – Servicio Listado de código de zonas
https://sii.paraguay.gov.py/ips-rest/api/ips/WsInscripcionPatronal/api/listado/codigozona
Parámetros
Ninguno
Respuesta
Modelo
"EstadoPatronalResult": {
"type": "object",
"properties": {
"codZona": "string",
"desZona": "string"
)
}
Método 21 – Servicio Listado de estado civil
https://sii.paraguay.gov.py/ips-rest/api/ips/WsInscripcionPatronal/api/listado/estadocivil
Parámetros
Ninguno
Respuesta
Modelo
"EstadoPatronalResult": {
"type": "object",
"properties": {
"codEstCivil": "string",
"desEstCivil": "string"
)
}
Método 22 – Servicio Listado de ciudades
https://sii.paraguay.gov.py/ips-rest/api/ips/WsInscripcionPatronal/api/listado/ciudad
Parámetros
Ninguno
Respuesta
Modelo
"EstadoPatronalResult": {
"type": "object",
"properties": {
"codLocali": "string",
"desLocali": "string",
"codPais": "string"
)
}
Método 23 – Servicio Listado de localidad
https://sii.paraguay.gov.py/ips-rest/api/ips/WsInscripcionPatronal/api/listado/localidadpy
Parámetros
Ninguno
Respuesta
Modelo
"EstadoPatronalResult": {
"type": "object",
"properties": {
"id": "numeric",
"codLocali": "string",
"desLocali": "string",
"codPais": "string"
)
}
Nivel de calidad del servicio
Disponibilidad
99,99%
Tiempo de respuesta
menos de 1 segundo
Volumen de carga máx.
—
Fecha de Actualización
05/09/2024