28/04/2017 Superintendencia de Riesgos del Trabajo

Versión 1.9 Depto. de Desarrollo

Especificación Técnica del

Web Service Establecimientos

Área Depto. de Desarrollo

Versión 1.9

Fecha 28/04/2017

Autor Hegykozi, Hernán Javier

WS Establecimiento Página 1 de 13
28/04/2017 Superintendencia de Riesgos del Trabajo
Versión 1.9 Depto. de Desarrollo

Índice

1 Historial de Cambios.......................................................................... 3
2 Introducción ...................................................................................... 3
2.1 Propósito ............................................................................................................ 3
2.2 Descripción general del servicio ........................................................................ 3
2.3 Referencias......................................................................................................... 4
3 Manejo de Errores ............................................................................. 5
3.1 Estructura de Respuesta con Error .................................................................... 5
3.2 Como capturar un Error con C# 2010 ................................................................ 5
4 WebService Establecimientos ............................................................ 6
4.1 Flujo Principal..................................................................................................... 6
4.1.1 Solicitud del Ticket para el Servicio Establecimientos................................ 6
4.1.2 Agregar el TA en el Header del mensaje SOAP........................................... 6
4.1.3 Realizar el consumo del servicio................................................................. 6
4.2 Datos a Remitir .................................................................................................. 7
4.2.1 Establecimiento .......................................................................................... 7
4.2.2 EstablecimientoEmpresa ............................................................................ 8
4.3 Especificación del servicio ................................................................................. 9
4.4 Anexos .............................................................................................................. 11
4.4.1 Tablas de Errores ...................................................................................... 11
4.4.2 Tablas de Referencia................................................................................. 13

WS Establecimiento Página 2 de 13
28/04/2017 Superintendencia de Riesgos del Trabajo
Versión 1.9 Depto. de Desarrollo

1 Historial de Cambios
Versión Autor Fecha Descripción
1.0 Hegykozi, Hernán Javier 12/06/2013 Versión Inicial.
Cambios en estructura y
1.5 Hegykozi, Hernán Javier 20/03/2014
métodos.
Agregado de tabla de
1.7 Hegykozi, Hernán Javier 20/01/2015
descripción de campos
Agrega nuevo método al
1.8 Duro, Ariel 15/12/2015
servicio
Agrega Propiedad
1.9 Duro, Ariel 28/04/2017 NombreFantasia a la
entidad Establecimiento

2 Introducción

2.1 Propósito
En el presente documento se especifican los aspectos técnicos del servicio de Establecimientos
(WSE) perteneciente a la SRT. Dicho servicio es necesario para que entes externos (EE)
accedan a las consultas ofrecidas por la Superintendencia de Riesgos del Trabajo.

2.2 Descripción general del servicio

El webservices de Establecimientos es un servicio B2B (business to businnes) que permite
realizar consultas que brinda la SRT, de manera que se intercambie información en forma
directa sin intervención de operadores. En dicha tarea intervienen los siguientes componentes:

 Un cliente WS desarrollado por EE siguiendo las especificaciones de este documento.

 El WSA, publicado por la SRT. Este implementa la autenticación de los servidores de

entes externos (SEE) mediante certificados digitales x.509 y la autorización del mismo
como consumidor de un determinado WebService de Negocio (WSN).

 El certificado cliente otorgado por la SRT, en formato PKCS#12 con clave de acceso
para el organismo requeridor.

 El WSN, publicado por la SRT.

Para que un SEE pueda utilizar un WSN de la SRT, deberá solicitar un “ticket de acceso” (TA)
por medio del WSA. Dicho requerimiento se realiza mediante el envío de un “ticket de
requerimiento de acceso” (TRA) del SEE, mediante mensajería SOAP al WSA.

WS Establecimiento Página 3 de 13
28/04/2017 Superintendencia de Riesgos del Trabajo
Versión 1.9 Depto. de Desarrollo

El WSA realiza la verificación de TRA y si el requerimiento es correcto, devuelve un mensaje

que contiene el TA que habilita al SEE a utilizar el WSN solicitado. El TA deberá ser utilizado por
el SEE para acceder al WSN.

Para acceder a los servicios que brinda la SRT, es necesario utilizar WSDL según la URL definida
por la SRT. A partir de WSDL el EE puede construir un cliente, para poder consumir el WSN
correspondiente.

2.3 Referencias
Para mejor entendimiento de la presente especificación, se recomienda estar familiarizado con
los siguientes estandares:

PKI: Public Key Infrastructure.

XML: Extensible Markup Language, http://www.xml.org/
SOAP: Simple Object Access Protocol, http://www.w3.org/TR/soap/
WSDL: Web Services Description Language, http://www.w3.org/TR/wsdl
CMS: Cryptographic Message Syntax, http://www.ietf.org/rfc/rfc3852.txt
NTP: Network Time Protocol, http://www.ntp.org/

WS Establecimiento Página 4 de 13
28/04/2017 Superintendencia de Riesgos del Trabajo
Versión 1.9 Depto. de Desarrollo

3 Manejo de Errores
En caso de encontrarse algun error, el servicio devolverá un SoapException conteniendo
código y descripción del error producido.
La descripción podrá contener adicionalmente datos más específicos del error (ej: el ticket
expiró).
Los códigos de error propios de cada WSN se especificarán en los respectivos anexos.

3.1 Estructura de Respuesta con Error

El detalle del error será devuelto dentro de la estructura del SoapException:
SoapException.Detail.OuterXml

<Error xmlns="WSSoapException">
<ErrorNumber>AT02</ErrorNumber>
<ErrorMessage>Ticket Expirado</ErrorMessage>
</Error>

3.2 Como capturar un Error con C# 2010

try
{
//Codigo de acceso al webservice
}
catch (SoapException soapEx)
{
XmlDocument doc = new XmlDocument();
doc.LoadXml(soapEx.Detail.OuterXml);
XmlNamespaceManager nsManager = new
XmlNamespaceManager(doc.NameTable);
nsManager.AddNamespace("errorNS", "WSSoapException");
XmlNode Node = doc.DocumentElement.SelectSingleNode("errorNS:Error",
nsManager);
string errorNumber = Node.SelectSingleNode("errorNS:ErrorNumber",
nsManager).InnerText;
string errorMessage = Node.SelectSingleNode("errorNS:ErrorMessage",
nsManager).InnerText;
MessageBox.Show(errorNumber + " - " + errorMessage);
}

WS Establecimiento Página 5 de 13
28/04/2017 Superintendencia de Riesgos del Trabajo
Versión 1.9 Depto. de Desarrollo

4 WebService Establecimientos
4.1 Flujo Principal
A continuación se describen los pasos a seguir para consumir el WSE.
Cada uno de estos pasos son explicados detalladamente en los siguientes apartados:
1. Solicitud del TA (Ticket de Acceso) para el Servicio Consultas.
2. Agregar el TA en el Header del mensaje SOAP.
3. Realizar el consumo del servicio.

4.1.1 Solicitud del Ticket para el Servicio Establecimientos

Un TA se solicita a traves de un TRA (Ticket de Requerimiento de Acceso) al WSA (WebService
de Autenticación).

4.1.2 Agregar el TA en el Header del mensaje SOAP

Este paso implica la inserción del TA en el Header del mensaje Soap utilizado para realizar el
consumo del WSE.
Ejemplo de cómo agregar un TA al Header en C#

Establecimientos _establecimiento = new Establecimientos();

WSEstablecimiento.TicketHeader ta = new WSEstablecimiento.TicketHeader();
ta.securityticket = "MIIIlQYJKoZIhvcNAQcCoIIIh.........";
_establecimiento.TicketHeaderValue = ta;
_establecimiento.Metodo();

4.1.3 Realizar el consumo del servicio

Una vez realizado el paso anterior, se está en condiciones de consumir el servicio ejecutando el
método deseado.

Nota: el ticket deberá generarse para un sólo servicio y para un sólo ente externo (EE) pero
podrá utilizarse más de una vez limitándolo solo por tiempo.
Si el mismo ente externo (EE) precisara acceder a más de un servicio, debera requerir un ticket
para cada uno.
El ticket se generará con una “vida útil” asignada dinámicamente. La vida útil es el tiempo
mientras el cual el ticket sigue siendo válido. Su duración máxima se establecerá en función de
la criticidad de información. Si un servicio falla por caducidad del ticket (al terminar su vida
útil), el EE deberá solicitar nuevamente otro, como si fuera la primera vez, para seguir
utilizando el servicio.
El EE deberá administrar la persistencia de los tickets en sus aplicaciones para evitar la solicitud
indiscriminada de estos.

WS Establecimiento Página 6 de 13
28/04/2017 Superintendencia de Riesgos del Trabajo
Versión 1.9 Depto. de Desarrollo

4.2 Datos a Remitir

4.2.1 Establecimiento
Necesarios para
Nombre del campo Descripción Formato la Aceptación del Tipo
Registro
Código único del Establecimiento Sin guiones ni signos de Obligatorio para
Codigo Numérico
provisto por la SRT puntuación. Modificar datos
CUIT empresa dueña del Sin guiones ni signos de
CUIT Obligatorio Numérico
establecimiento puntuación
Numero de 4 dígitos informado por Sin guiones ni signos de
NumeroEstablecimiento Opcional Numérico
ART para clave de intercambio puntuación.
Descripcion Descripción del establecimiento Texto libre Opcional Texto
Completar con mayúsculas y
Calle Nombre de la Calle o Ruta espacios en blancos, sin Obligatorio Alfanumérico
puntos ni guiones
Completar con mayúsculas y
Nombre de la Calle o Ruta de
interseccion espacios en blancos, sin Opcional Alfanumérico
intersección
puntos ni guiones
Sin guiones ni signos de
Altura Altura de calle o kilómetro de ruta Obligatorio Numérico
puntuación.
Sin guiones ni signos de
Piso Piso del establecimiento Opcional Alfanumérico
puntuación.
Sin guiones ni signos de
Dpto Departamento del establecimiento Opcional Alfanumérico
puntuación.
Completar según tabla de
LocalidadId Código de la localidad Obligatorio Numérico
localidades
Completar con mayúsculas y
Localidad Localidad del establecimiento espacios en blancos, sin Opcional Alfanumérico
puntos ni guiones
Completar según tabla de
ProvinciaId Código de la provincia Obligatorio Numérico
provincias
Obligatorio
Completar según tabla de
CPA CPA cuando no Alfanumérico
códigos postales
informa CP
Obligatorio
Completar según tabla de
CP Código Postal cuando no Numérico
códigos postales
informa CPA
Latitud Latitud en decimal 12,3456789 Opcional Decimal
Longitud Longitud en decimal 12,3456789 Opcional Decimal
Completar según tabla de Obligatorio para
MotivoBaja Código del motivo de baja Numérico
motivos de baja BAJAS

Completar según tabla de

TipoEstablecimiento Código del tipo de establecimiento Obligatorio Numérico
tipos de establecimientos

Indica si el establecimiento es la casa

Principal ‘0’= No; ‘1’=Si Obligatorio Lógico
matriz

Descripción libre para la Sin guiones ni signos de

NombreFantasia Opcional Alfanumérico
identificación del Establecimiento puntuación.

WS Establecimiento Página 7 de 13
28/04/2017 Superintendencia de Riesgos del Trabajo
Versión 1.9 Depto. de Desarrollo

4.2.2 EstablecimientoEmpresa
Necesarios para
Nombre del campo Descripción Formato la Aceptación del Tipo
Registro
Código único del Establecimiento – Sin guiones ni signos de Obligatorio para
Codigo Numérico
Empresa provisto por la SRT puntuación. Modificar datos
CUIT empresa dueña del Sin guiones ni signos de
CUIT Obligatorio Numérico
establecimiento puntuación
Clasificación Industrial Internacional
CIIU Completar según tabla de CIIU Obligatorio Numérico
Uniforme
Fecha de inicio de actividad en
FechaInicioActividad DD/MM/AAAA Obligatorio Fecha
establecimiento
Fecha de finalización de actividad en
FechaFinActividad DD/MM/AAAA Obligatorio Fecha
el establecimiento
Completar según tabla de Obligatorio para
MotivoBaja Código del motivo de baja Numérico
motivos de baja BAJAS
Indica si el establecimiento
Propio corresponde a la empresa o a ‘0’= No; ‘1’=Si Obligatorio Lógico
terceros

WS Establecimiento Página 8 de 13
28/04/2017 Superintendencia de Riesgos del Trabajo
Versión 1.9 Depto. de Desarrollo

4.3 Especificación del servicio

Nombre Establecimientos.asmx
Ubicación https://serviciosweb.srt.gob.ar/Establecimientos/Establecimientos.asmx
Descripción Obtiene el establecimiento por el código

Parámetro Descripción Tipo

Parámetros de
ObtenerEstablecimiento Código de
entrada código int
Establecimiento
Retorno Entidad Establecimiento

Descripción Consulta Establecimientos para un cuit

Parámetros de Parámetro Descripción Tipo

ConsultaEstablecimientosPorCuit
entrada cuit Cuit del empleador string

Retorno Lista Entidad EstablecimientoEmpresa

Descripción Consulta Establecimientos Por CPA o CP

Parámetro Descripción Tipo

Parámetros de Código postal
ConsultaEstablecimientosPorCPA CPA string
entrada argentino
CP Código Postal int

Retorno Lista Entidad EstablecimientoEmpresa

Descripción Alta de Nuevo Establecimiento

Parámetro Descripción Tipo

Parámetros de Entidad
AltaEstablecimientos EstablecimientoEm
entrada EstablecimientoEm
WebMethods

presa
presa
Retorno Entidad EstablecimientoEmpresa

Descripción Elimina un Establecimiento Activo

Parámetro Descripción Tipo

Parámetros de
EliminarEstablecimiento Entidad
entrada Establecimiento
Establecimiento
Retorno Boolean (Avisa operación correcta/incorrecta)

Descripción Modifica Establecimiento Activo

Parámetro Descripción Tipo

Parámetros de
RectificarEstablecimiento Entidad
entrada Establecimiento
Establecimiento
Retorno Boolean (Avisa operación correcta/incorrecta)

Descripción Alta de Nuevo Establecimiento Empresa

Parámetro descripción tipo

Parámetros de Entidad
AltaEstablecimientoEmpresa EstablecimientoEm
entrada EstablecimientoEm
presa
presa
Retorno Entidad EstablecimientoEmpresa

Descripción Elimina un Establecimiento Empresa Activo

Parámetro Descripción Tipo

EliminarEstablecimientoEmpresa Entidad
EstablecimientoEm
EstablecimientoEm
presa
presa
Retorno Boolean (Avisa operación correcta/incorrecta)

WS Establecimiento Página 9 de 13
28/04/2017 Superintendencia de Riesgos del Trabajo
Versión 1.9 Depto. de Desarrollo

Descripción Modifica Establecimiento Empresa Activo

Parámetro Descripción Tipo

Parámetros de Entidad
RectificarEstablecimientoEmpresa EstablecimientoEm
entrada EstablecimientoEm
presa
presa
Retorno Boolean (Avisa operación correcta/incorrecta)

Descripción Verifica la existencia de un establecimiento

Parámetro Descripción Tipo

Parámetros de
VerificarEstablecimiento Entidad
entrada Establecimiento
Establecimiento
Retorno Entidad Establecimiento o Null si no existiese

Descripción Reactiva un Establecimiento dado de baja

Parámetro Descripción Tipo

Parámetros de
ReactivarEstablecimiento Entidad
entrada Establecimiento
Establecimiento
Retorno Entidad Establecimiento

Descripción Reactiva un EstablecimientoEmpresa dado de baja

Parámetro Descripción Tipo

Parámetros de Entidad
ReactivarEstablecimientoEmpresa EstablecimientoEm
entrada EstablecimientoEm
presa
presa
Retorno Entidad EstablecimientoEmpresa
Consulta establecimientos declarados en SR por CUIT, Nro.de
Descripción
Establecimiento y Programa Muestra.
Parámetro Descripción Tipo
CUIT del
cuit string
Empleador
Nro. de
Parámetros de nroEstablecimie
ConsultaEstablecimientoSR Establecimiento de int
entrada nto
la ART
Nro. de Programa
idProgramaMue Muestra de
int
stra acuerdo a la tabla
de Referencias
Retorno Lista Entidad EstablecimientoEmpresa

Descripción Consulta Establecimientos por Cuit y Estado

Parámetro Descripción Tipo

ConsultaEstablecimientosPorCuit Parámetros de CUIT del
cuit string
YEstado entrada Empleador
metodoBusque Todos / Activos /
enum
da Baja / Temporales
Retorno Lista Entidad EstablecimientoEmpresa

Descripción Modifica la Propiedad temporal del establecimiento

Parámetro Descripción Tipo

Parámetros de CUIT del
RatificarEstablecimientoTemporal cuit string
entrada Empleador
Codigo de
codigo int
Establecimiento
Retorno Boolean (Avisa operación correcta/incorrecta)

WS Establecimiento Página 10 de 13
28/04/2017 Superintendencia de Riesgos del Trabajo
Versión 1.9 Depto. de Desarrollo

4.4 Anexos
4.4.1 Tablas de Errores

Para WSA se especifican dos tablas de errores:

 Tablas de errores WebService Establecimientos
 Tabla de errores de Ticket y validación: esta tabla lista los códigos de errores asociados
al menejo del ticket y la validación del los servicios en los WSN.

Errores Genéricos
Código Descripción
CC01 Datos de CUIT no Encontrados.

Errores Establecimientos
Código Descripción
ES01 El Establecimiento ya existe
ES02 El Establecimiento no existe
ES03 Faltan datos del Establecimiento o los datos no son validos
ES04 No se ha podido procesar la consulta de Establecimientos
ES05 El tipo de establecimientos no existe
ES06 El motivo de baja no existe
ES07 El código de provincia no existe
ES08 El código de localidad no existe

Errores Establecimiento Empresa

Código Descripción
EM01 El Establecimiento Empresa ya existe
EM02 El Establecimiento Empresa no existe
EM03 Faltan datos del Establecimiento Empresa o los datos no son validos

WS Establecimiento Página 11 de 13
28/04/2017 Superintendencia de Riesgos del Trabajo
Versión 1.9 Depto. de Desarrollo

Validación del ticket y servicios

Código Descripción
AC01 No se ha encontrado el certificado de firma en el CMS
AC02 El CMS (Cryptographic Message Syntax) nos es valido
AC03 Firma inválida o algoritmo no soportado
AC04 Certificado con fecha de generación posterior a la actual
AC05 Certificado Expirado
AT01 Ticket Invalido
AT02 Ticket Expirado
AT03 No se encontró el ticket en el requerimiento.
AX01 No se ha podido interpretar el XML contra el SCHEMA.
AX02 No se ha podido encontrar el SCHEMA.
AO01 Organismo o Servicio no Disponible
AM01 El Método no se encuentra activo.
AT06 Ticket no Encontrado

WS Establecimiento Página 12 de 13
28/04/2017 Superintendencia de Riesgos del Trabajo
Versión 1.9 Depto. de Desarrollo

4.4.2 Tablas de Referencia

Entidad Propiedad Referencia

Tabla LOCALIDADES
Localidad
Campo ID
Establecimiento

Tabla PROVINCIAS
Provincia
Campo ID
Tabla MOTIVOSBAJA
MotivoBaja
Campo ID
Tabla TIPOSORGANISMO
TipoOrganismo
Campo ID
Tabla TIPOSORGANISMO
EstablecimientoEmpresa TipoOrganismo
Campo ID

WS Establecimiento Página 13 de 13