WS Establecimientos v1 9 1

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
Í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
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.
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/
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);
}
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.
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
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.
Piso Piso del establecimiento Opcional Alfanumérico
puntuación.
Dpto Departamento del establecimiento Opcional Alfanumérico
puntuación.
Completar según tabla de
LocalidadId Código de la localidad Obligatorio Numérico
localidades
Localidad Localidad del establecimiento espacios en blancos, sin Opcional Alfanumérico
puntos ni guiones
ProvinciaId Código de la provincia Obligatorio Numérico
provincias
Obligatorio
CPA CPA cuando no Alfanumérico
códigos postales
informa CP
Obligatorio
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

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.
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
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ámetros de Código postal
ConsultaEstablecimientosPorCPA CPA string
entrada argentino
CP Código Postal int
Descripción Alta de Nuevo Establecimiento

Parámetros de Entidad
AltaEstablecimientos EstablecimientoEm
entrada EstablecimientoEm
WebMethods
presa
presa
Retorno Entidad EstablecimientoEmpresa
Descripción Elimina un Establecimiento Activo

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

Parámetros de
RectificarEstablecimiento Entidad
Establecimiento
Descripción Alta de Nuevo Establecimiento Empresa
Parámetro descripción tipo

AltaEstablecimientoEmpresa EstablecimientoEm
presa
presa
Descripción Elimina un Establecimiento Empresa Activo

EliminarEstablecimientoEmpresa Entidad
EstablecimientoEm
EstablecimientoEm
presa
presa
Descripción Modifica Establecimiento Empresa Activo

RectificarEstablecimientoEmpresa EstablecimientoEm
presa
presa
Descripción Verifica la existencia de un establecimiento

Parámetros de
VerificarEstablecimiento Entidad
Establecimiento
Retorno Entidad Establecimiento o Null si no existiese
Descripción Reactiva un Establecimiento dado de baja

Parámetros de
ReactivarEstablecimiento Entidad
Establecimiento
Retorno Entidad Establecimiento
Descripción Reactiva un EstablecimientoEmpresa dado de baja

ReactivarEstablecimientoEmpresa EstablecimientoEm
presa
presa
Consulta establecimientos declarados en SR por CUIT, Nro.de
Descripción
Establecimiento y Programa Muestra.
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
Descripción Consulta Establecimientos por Cuit y Estado

ConsultaEstablecimientosPorCuit Parámetros de CUIT del
cuit string
YEstado entrada Empleador
metodoBusque Todos / Activos /
enum
da Baja / Temporales
Descripción Modifica la Propiedad temporal del establecimiento

Parámetros de CUIT del
RatificarEstablecimientoTemporal cuit string
entrada Empleador
Codigo de
codigo int
Establecimiento
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
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

EM01 El Establecimiento Empresa ya existe
EM02 El Establecimiento Empresa no existe
EM03 Faltan datos del Establecimiento Empresa o los datos no son validos
Validación del ticket y servicios

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
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 Establecimientos v1 9 1

Cargado por

Información del documento

Derechos de autor

Formatos disponibles

Compartir este documento

Compartir o incrustar documentos

Opciones para compartir

¿Le pareció útil este documento?

¿Este contenido es inapropiado?

Copyright:

Formatos disponibles

WS Establecimientos v1 9 1

Cargado por

Copyright:

Formatos disponibles

28/04/2017 Superintendencia de Riesgos del Trabajo

Versión 1.9 Depto. de Desarrollo

Especificación Técnica del

Área Depto. de Desarrollo

Autor Hegykozi, Hernán Javier

2.2 Descripción general del servicio

 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

 El WSN, publicado por la SRT.

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

PKI: Public Key Infrastructure.

3.1 Estructura de Respuesta con Error

3.2 Como capturar un Error con C# 2010

4.1.1 Solicitud del Ticket para el Servicio Establecimientos

4.1.2 Agregar el TA en el Header del mensaje SOAP

Establecimientos _establecimiento = new Establecimientos();

4.1.3 Realizar el consumo del servicio

4.2 Datos a Remitir

Completar según tabla de

Indica si el establecimiento es la casa

Descripción libre para la Sin guiones ni signos de

4.3 Especificación del servicio

Parámetro Descripción Tipo

Descripción Consulta Establecimientos para un cuit

Parámetros de Parámetro Descripción Tipo

Retorno Lista Entidad EstablecimientoEmpresa

Descripción Consulta Establecimientos Por CPA o CP

Parámetro Descripción Tipo

Retorno Lista Entidad EstablecimientoEmpresa

Descripción Alta de Nuevo Establecimiento

Parámetro Descripción Tipo

Descripción Elimina un Establecimiento Activo

Parámetro Descripción Tipo

Descripción Modifica Establecimiento Activo

Parámetro Descripción Tipo

Descripción Alta de Nuevo Establecimiento Empresa

Parámetro descripción tipo

Descripción Elimina un Establecimiento Empresa Activo

Parámetro Descripción Tipo

Descripción Modifica Establecimiento Empresa Activo

Parámetro Descripción Tipo

Descripción Verifica la existencia de un establecimiento

Parámetro Descripción Tipo

Descripción Reactiva un Establecimiento dado de baja

Parámetro Descripción Tipo

Descripción Reactiva un EstablecimientoEmpresa dado de baja

Parámetro Descripción Tipo

Descripción Consulta Establecimientos por Cuit y Estado

Parámetro Descripción Tipo

Descripción Modifica la Propiedad temporal del establecimiento

Parámetro Descripción Tipo

Para WSA se especifican dos tablas de errores:

Errores Establecimiento Empresa

Validación del ticket y servicios

4.4.2 Tablas de Referencia

Entidad Propiedad Referencia

También podría gustarte