Inicio ► Ayuda ► Webservice empleadores  

Documento de definición de webservices para integración entre empleadores y sistema de Licencias Médicas Electrónicas

1. Índice

2. Bitácora de cambios

Fecha Modificación
V2.0
29-02-2008		 Versión inicial del documento
V2.1
29-04-2008		 ObtenerDetalleLicencia
  • Método incorporado a webservice para entrega de información más completa a empleadores.
EnviarZonaC
  • Eliminado campo emp_glosa_comuna
  • Eliminado campo nombre_afc
  • Eliminado campo emp_fecha_envio
V3.0
12-05-008		 ObtenerDetalleLicencia
  • Método renombrado a ObtenerXMLLicencia
EstadoTransaccion
  • Agregada fecha
Tipo Licencia
  • Agregados campos tipo_licencia, dias_reposo, fecha_inicio_reposo y fecha_ultimo estado
V3.1
02-06-08		 EnviarZonaC
  • Agregado parámetro de salida “link”.
V3.2
01-08-08		 Agregado el largo de los campos de tipo string.
V3.3
19-08-08		 Creados los tipos de datos siguientes:
  • EnviarZonaCReturn
  • ObtenerLicenciaReturn
  • ObtenerXMLLicenciaReturn
Éstos tipos de datos encapsulan las respuestas anteriores de los metodos.

3. Especificaciones generales

WSDL

WSDL de ambiente de pruebas


  • http://200.0.156.44/lme_pruebas/webservices/webservicesEmpleadores.php?wsdl

WSDL de ambiente de producción


  • http://200.0.156.44/lme_produccion/webservices/webservicesEmpleadores.php?wsdl

Esquemas oficiales

Para la definición de la estructura válida de una licencia médica electrónica en formato XML, se encuentra disponible el siguiente esquema oficial, desarrollado por la Superintendencia de Seguridad Social:

http://www.lme.gov.cl/lme/LME_1.0.xsd

La lista completa de esquemas de las secciones y tipos de datos involucrados en el esquema principal, están disponibles en la siguiente carpeta de acceso web:

http://www.lme.gov.cl/lme

Tabla oficial de estados de la licencia

Estado Descripción Condiciones
1 Otorgada. Adquiere estado 1 en el momento que el sistema de información registra el otorgamiento de la licencia médica electrónica por parte del Profesional.
2 Anulada. Adquiere estado 2 en el momento que el sistema de información registra la anulación de la licencia médica electrónica por parte del Profesional.
Sólo pueden adquirir el estado 2 licencias médicas electrónicas en estado 1.
3 No tramitada. Adquiere estado 3 en el momento que el sistema de información verifica el cumplimiento de los plazos de que disponen el Empleador o el Trabajador Independiente Adscrito para tramitarla.
Sólo pueden adquirir el estado 3 licencias médicas electrónicas en estado 1 ó 6.
4 No recepcionada. Adquiere estado 4 en el momento que el sistema de información registra la expresión de motivo para no tramitarla por parte del Empleador o el Trabajador Independiente Adscrito.
Sólo pueden adquirir el estado 4 licencias médicas electrónicas en estado 1, 3 ó 6.
5 Tramitada. Adquiere estado 5 en el momento que el sistema de información registra la tramitación de la licencia médica electrónica por parte del Empleador o el Trabajador Independiente Adscrito.
Sólo pueden adquirir el estado 5 licencias médicas electrónicas en estado 1, 3 ó 6.
6 Devuelta. Adquiere estado 6 en el momento que el sistema de información registra la devolución de la licencia médica electrónica por parte de la Entidad que se pronuncia.
Sólo pueden adquirir el estado 6 licencias médicas electrónicas en estado 3, 4 ó 5.
7 Pronunciada. Adquiere estado 7 en el momento que el sistema de información registra el pronunciamiento de la licencia médica electrónica por parte de la Entidad que se pronuncia.
Sólo pueden adquirir el estado 7 licencias médicas electrónicas en estado 3, 4 ó 5, para el caso de licencias tramitadas por Empleadores o Trabajadores independientes Adscritos; o en estado 1, para el caso de licencias tramitadas por Empleadores o Trabajadores independientes no Adscritos.

4. Métodos

4.1 ObtenerLicencia

4.1.1 Objetivo

El objetivo de este método es transmitir a los sistemas de remuneraciones de los empleadores adscritos, la información sobre las últimas actualizaciones de estado en licencias médicas recibidas por sus trabajadores.

4.1.2 Parámetros de entrada

Nombre Tipo Largo Descripción
rut_empleador int 8 RUT del empleador.
dv_rut_empleador string 1 Dígito verificador del RUT del empleador.
rut_usuario int 8 RUT del usuario asistente del empleador.
dv_rut_usuario string 1 Dígito verificador del RUT del usuario asistente del empleador.
password string 64 Contraseña del usuario
fecha_proceso dateTime El método retornará licencias que hayan experimentado cambios de estado a partir de esta fecha.

4.1.3 Parámetros de salida

Nombre Tipo Largo Descripción
ObtenerLicenciaReturn ObtenerLicenciaReturn Respuesta del método

4.2 EnviarZonaC

4.2.1 Objetivo

Método utilizado para que el sistema de remuneraciones del empleador envíe los datos necesarios para completar la zona C de una licencia médica.

4.2.2 Parámetros de entrada

Nombre Tipo Largo Descripción
folio string 12 Folio de licencia médica electrónica
rut_empleador int RUT del empleador parte numérica
dv_empleador string 1 RUT del empleador parte dígito
rut_usuario int RUT del usuario del empleador parte numérica
dv_usuario string 1 RUT del usuario del empleador parte dígito
password string 64 Contraseña del usuario.
razon_social string 512 Razón social del empleador
tipo_empleador int 512
  • 1 : Dependiente
  • 2 : Independiente
    		•
    emp_dir_glosa string 1024 Glosa de la dirección
    emp_dir_comuna int Código de comuna de acuerdo al INE
    emp_fono string 16 Teléfono del empleador
    emp_email string 512 Correo electrónico del empleador
    emp_fecha_recepcion dateTime Fecha de recepción por parte del empleador
    compin int Número de compín de acuerdo a la tabla de FONASA
    codigo_actividad_laboral int Código de actividad laboral de acuerdo a tabla legal
    • 0 : Agricultura, servicios agrícolas, silvicultura y pesca
    • 1 : Minas, petróleos y canteras.
    • 2 : Industrias manufactureras.
    • 3 : Construcción.
    • 4 : Electricidad, gas y agua.
    • 5 : Comercio.
    • 6 : Transporte, almacenamiento y comunicaciones.
    • 7 : Finanzas, seguros, bienes muebles y servicios técnicos, profesionales y otros.
    • 8 : Servicios estatales, sociales, personales e internacionales.
    • 9 : Actividad no especificada.
    codigo_ocupacion int Código de ocupación de acuerdo a tabla legal
    • 11 : Ejecutivo o directivo.
    • 12 : Profesor.
    • 13 : Otro profesional.
    • 14 : Técnico.
    • 15 : Vendedor
    • 16 : Administrativo
    • 17 : Operario, trabajador manual.
    • 18 : Trabajador de casa particular.
    • 19 : Otro (especificar).
    codigo_ocupacion_otro string 64 Glosa otra ocupación (código de ocupación 19)
    codigo_regimen_previsional int Régimen previsional de acuerdo a tabla legal
    • 1 : D.L. 3501 INP
    • 2 : D.L. 3500 A.F.P.
    • (Para trabajadores sin previsión se debe enviar código 2)
    pensionado int Pensionado
    • 1 : Si
    • 2 : No
    codigo_institucion_previsional int Código de institución previsional. Para trabajadores sin previsión se debe enviar código -1)
    bis string 3 Indicador de cajas de tipo bis
    valores: (‘bis’, ‘’)
    num_bis string 1 Número de bis
    valores: (‘’, ‘1’, ‘2’,…)
    letra_institucion_previsional string 1 Letra de la institución previsional
    codigo_calidad_trabajador int Código de calidad del trabajador de acuerdo a tabla legal
    afc int Asociado al seguro de desempleo. Informar si trabajador esta afiliado a AFC
    • 1 : Si
    • 2 : No
    contrato_indefinido int Asociado al seguro de desempleo, informar si contrato del trabajador es de duración indefinida
    • 1 : Si
    • 2 : No
    codigo_estatuto int Estatuto para entes públicos
    • 0 : Sin estatuto
    • 1 : Municipal
    • 2 : Salud
    • 3 : Docente
    fecha_afiliacion dateTime Fecha de la primera afiliación
    fecha_contrato dateTime Fecha de contrato de trabajo
    porcentaje_desahucio float(5,2) Porcentaje de desahucio
    remuneración_imponible float(10) Renta imponible de salud correspondiente al mes anterior al inicio de la licencia, con tope 90 U.F. en caso de estar afiliado a AFC, y tope de 60 UF en caso contrario.
    codigo_tipo_subsidio string 1 Entidad pagadora de la licencia
    • Licencias de tipo 1,2,3,4,7:
    • A : Servicio de Salud
    • B : Isapre
    • C : CCAF
    • D : Empleador
    Licencias de tipo 5 o 6:
    • E : Servicio de Salud
    • F : Mutual
    • G : INP
    • H : Empleador
    periodos Periodos Información de remuneraciones de un período mensual
    licencias_anteriores LicenciasAnteriores licencias anteriores del tipo LicenciasAnteriores

    4.2.3 Parámetros de salida

    Nombre Tipo Largo Descripción
    EnviarZonaCReturn EnviarZonaCReturn Respuesta del método

    4.3 ObtenerXMLLicencia

    Objetivo

    El objetivo de este método es transmitir a los sistemas de remuneraciones de los empleadores adscritos, el XML generado como documento oficial para cada licencia médica.

    Parámetros de entrada

    Nombre Tipo Largo Descripción
    rut_empleador int RUT del empleador.
    dv_rut_empleador string 1 Dígito verificador de RUT del empleador.
    rut_usuario int RUT del usuario asistente del empleador.
    dv_rut_usuario string 1 Dígito verificador del RUT del usuario asistente del empleador.
    password string 64 Contraseña del usuario asistente del empleador.
    lista_folios ListaFolioLicencia Lista de folios enviados anteriormente en la lista de licencias.

    Parámetros de salida

    Nombre Tipo Largo Descripción
    ObtenerXMLLicenciaReturn ObtenerXMLLicenciaReturn Respuesta del metodo.

    5. Tipos de datos

    5.1 EnviarZonaCReturn

    Nombre Tipo Largo Descripción
    estado_transaccion EstadoTransaccion Estado de la transacción. De tipo EstadoTransaccion
    link string 512 Link para el trámite de la licencia precargada.

    5.2 EstadoTransaccion

    Nombre Tipo Largo Descripción
    tipo int Código del estado de la transacción.

    1 : Transacción exitosa
    2 : Transacción con advertencias
    3 : Transacción errónea
    glosa string 1024 Glosa del estado de la transacción.
    codigo_transaccion string 128 Código único para identificación de transacción
    fecha dateTime Fecha de la transacción

    5.3 Haber

    Nombre Tipo Largo Descripción
    monto int Monto del haber
    glosa string 64 Nombre del haber.

    5.4 Haberes

    Nombre Tipo Largo Descripción
    array(haber) Haber Arreglo de elementos de tipo Haber.

    5.5 Licencia

    Nombre Tipo Largo Descripción
    folio_licencia string 12 Folio de la licencia. Formato rut (ej. 999-7).
    rut_trabajador int RUT del trabajador.
    dv_trabajador string 1 Dígito verificador del RUT del trabajador.
    estado int Estado de la licencia. Ver en especificaciones generales tabla de estados oficiales de la licencia medica electrónica.
    fecha_emision dateTime Fecha de emisión de la licencia.
    tipo_licencia int Código de tipo de licencia.

    1 : Enfermedad o accidente común
    2 : Prórroga medicina preventiva
    3 : Licencia maternal pre y postnatal
    4 : Enfermedad grave del hijo menor de 1 año
    5 : Accidente del trabajo o del trayecto
    6 : Enfermedad profesional
    7 : Patología del embarazo
    dias_reposo int Número de días de reposo recetados por el profesional.
    fecha_inicio_reposo dateTime Fecha de inicio de reposo.
    fecha_ultimo_estado dateTime Fecha de último cambio de estado de la licencia.

    5.6 LicenciaAnterior

    Nombre Tipo Largo Descripción
    nro_dias int Número de días de duración de la licencia anterior. Debe coincidir con la operación ‘hasta’-‘desde’ +1
    desde dateTime Fecha comienzo del reposo de la licencia anterior.
    hasta dateTime Fecha final del reposo de la licencia.

    5.7 LicenciasAnteriores

    Nombre Tipo Largo Descripción
    array(licencia_anterior) LicenciaAnterior Arreglo de elementos licencia_anterior cada uno de ellos de tipo LicenciaAnterior.

    5.8 ListaXMLLicencia

    array(xml_licencia) XMLLicencia Arreglo del tipo XMLLicencia.

    5.9 ListaFolioLicencia

    Nombre Tipo Largo Descripción
    array(folio) string Arreglo que contendra los folios de las licencias.

    5.10 ObtenerLicenciaReturn

    Nombre Tipo Largo Descripción
    estado_transaccion EstadoTransaccion Estado de la transacción.
    lista_licencias ListaLicencias Lista de datos básicos de licencias.

    5.11 ObtenerXMLLicenciaReturn

    Nombre Tipo Largo Descripción
    estado_transaccion EstadoTransaccion Estado de la transacción.
    lista_xml_licencias ListaXMLLicencias Lista de licencias detalladas.

    5.12 ListaLicencias

    Nombre Tipo Largo Descripción
    array(licencia) Licencia Arreglo del tipo Licencia.

    5.13 Periodo

    Nombre Tipo Largo Descripción
    maternal int 1: Maternal
    2: No Maternal
    codigo_institucion_prev int Institución Previsional de acuerdo a tabla de AFP.
    bis string 3 Indicador de cajas de tipo bis.
    valores: (‘bis’, ‘’)
    num_bis string 1 Número de bis.
    valores: (‘’,’1’,’2’,…)
    letra_institucion_prev string 1 Letra Institución previsional.
    mes_ano dateTime Periodo de Renta.
    nro_dias int Nro. Días Trabajados.
    remuneraciones_imponibles int Monto Imponible Previsional RIS.
    imponible_desahucio int Monto Imponible Previsional RIP.
    imponible_cesantia int Monto Imponible Cesantia.
    sueldo_base int Sueldo Base Trabajador.
    subsidio_dias int Nro. Días Subsidio.
    subsidio_monto int Monto de subsidio.
    glosa_dias_faltantes string 128 Glosa explicativa en caso de que hayan dias no informados, entendiéndose por dias informados a la suma de días trabajados más los días de subsidio.
    haberes Haberes Lista de elementos del tipo Haber.

    5.12 Periodos

    Nombre Tipo Largo Descripción
    array(periodo) Periodo Arreglo de elementos periodo de tipo Periodo. En terminos generales, cada período considera datos de remuneraciones de los últimos meses.

    5.13 XMLLicencia

    Nombre Tipo Largo Descripción
    folio_licencia string 12 Folio de la licencia. Formato rut (ej. 999-7).
    xml_base_64 string 2^16 XML oficial de la licencia, codificado en base 64.
    Redireccionando
    Redireccionando, espere por favor...