Titulo (1)

Subdirección de Administración

Jefatura de Servicios de Recursos Humanos

SISTEMA MAESTRO AVALÚOS SMA-SHF-FOVISSSTE

JEFATURA DE SERVICIOS DE OFERTA DE VIVIENDA

Febrero 2015

Manual Técnico para la comunicación de los Servicios Web con las Unidades de

Valuación

SOCIEDAD HIPOTECARIA FEDERAL, S.N.C.

Av Ejército Nacional 180, Ciudad de México, D.F.

México, D.F. 11590

www.shf.gob.mx

Requerimientos

• Acceso a Internet de banda ancha

• Contar con un navegador de internet reciente

• Contar con un Certificado Digital de Unidad de Valuación vigente expedido por una Agencia

• Certificadora avalada por Secretaría de Economía

• Clave privada del certificado Digital de la Unidad de Valuación

Introducción

1. Primero se debe de obtener el Número de Autorización de Elaboración deAvalúos (NAEA) Si la Unidad de Valuación tiene permitido emitir avalúos elServicio enviará un Número de Autorización compuesto de 23 caracteres, de locontrario enviará un código de error. Esta clave tendrá una vigencia de 240 horas(10 días) a partir del momento de su emisión.

2. Una vez que se obtuvo el Número de Autorización de Elaboración de Avalúo(NAEA) se procede a Obtener la Clave SHF, Esta se debe de obtener antes de laFirma Digital del Avalúo. En este paso se solicitará el Avalúo sin firmas y con lapropiedad de la Clave SHF vacía. El Servicio regresará la Clave SHF con el prefijo“CLAVE SHF GENERADA:” o en caso de error regresará un código de error.

3. Por último se realiza la Entrega del Avalúo, ya cuando se tiene la Clave SHFGenerada, se debe de integrar a los datos del Avalúo Digital y se procede a lafirma por parte de las Unidad de Valuación.

Pasos para el procedimiento

NOTA IMPORTANTE: Como proceso alternativo, un avalúo se puede cancelar, a

este servicio se debe de enviar la Clave SHF del Avalúo Digital que se cancelará.

Servicios Web

La aplicación para el envío vía Servicios Web de información de los avalúosrealizados, ya se encuentra disponible. Para tal fin, las especificaciones técnicas delos diferentes servicios, tanto URL, WSDL, y campos así como las validaciones quese deben aplicar a cada uno de los servicios se encuentran en las secciones:

• Servicio para Obtener Número de Autorización de Elaboración de Avalúo (NAEA)

• Servicio para Obtener la Clave SHF

• Servicio para realizar la Entrega del Avalúo

• Servicio para realizar la Cancelación del Avalúo

Canal SeguroLos Servicios Web serán consultados desde un servidor mediante una Capa deConexión Segura (SSL o Secure Socket Layer). Para establecer el canal seguro, laUnidad de Valuación deberá utilizar su Certificado Digital de Unidad de Valuaciónpara autenticarse a los servicios Web. El canal seguro permite que la informaciónviaje encriptada.

• Servicio para Obtener Número de Autorización de Elaboración de Avalúo (NAEA)

• Servicio para Obtener la Clave SHF

• Servicio para realizar la Entrega del Avalúo

• Servicio para realizar la Cancelación del Avalúo

Para acceder al sistema, requiere acceder al Servicio Web en a la siguiente URL https://189.202.225.45/AvaluoServicio.svc

Web ServicesLos Servicios Web contienen un archivo llamado WSDL (Lenguaje dedescripción de Servicios Web por sus siglas en inglés) esta es una descripcióndetallada de cómo funciona el servicio, que métodos contiene y que datosespera que le sean enviados y que datos regresarán cada uno de los métodos.Para acceder al WSDL o Definición del Servicio Web lea el Anexo I (Como leerun WSDL que requiere certificados)

Por su atención.

¡Muchas gracias!

Para acceder al Manual Técnico en versión PDF. Puede acceder a la ligahttp://www.shf.gob.mx/sobreshf/unidval/Documents/Manual%20de%20T%C3%A9cnico%20para%20la%20comunicaci%C3%B3n%20de%20los%20Servicios%20Web%20con%20las%20Unidades%20de%20Valuaci%C3%B3n.pdf

SOCIEDAD HIPOTECARIA FEDERAL, S.N.C.

Av Ejército Nacional 180, Ciudad de México, D.F.

México, D.F. 11590

www.shf.gob.mx

Servicio para Obtener la Clave SHF

SOCIEDAD HIPOTECARIA FEDERAL, S.N.C.

Av Ejército Nacional 180, Ciudad de México, D.F.

México, D.F. 11590

www.shf.gob.mx

MétodoEl método utilizado es: ObtenClaveSHF

Parámetros de entrada

Parámetros de Salida

Tabla de Errores

Servicio para realizar la Cancelación del Avalúo

SOCIEDAD HIPOTECARIA FEDERAL, S.N.C.

Av Ejército Nacional 180, Ciudad de México, D.F.

México, D.F. 11590

www.shf.gob.mx

MétodoEl método utilizado es: Cancelacion

Parámetros de entrada

Parámetros de Salida

Tabla de Errores

Servicio para realizar la Entrega del Avalúo

SOCIEDAD HIPOTECARIA FEDERAL, S.N.C.

Av Ejército Nacional 180, Ciudad de México, D.F.

México, D.F. 11590

www.shf.gob.mx

MétodoEl método utilizado es: Entrega

Parámetros de entrada

Parámetros de Salida

Tabla de Errores

Servicio para Obtener Número de Autorización de Elaboración de Avalúo

(NAEA)

SOCIEDAD HIPOTECARIA FEDERAL, S.N.C.

Av Ejército Nacional 180, Ciudad de México, D.F.

México, D.F. 11590

www.shf.gob.mx

MétodoEl método utilizado es: ObtenNAEA

Parámetros de entrada

Parámetros de Salida

Tabla de Errores

VINCULACIÓN AVALÚOS FOVISSSTE

OPERACIÓN

Domicilio Geográfico

Errores comunes

Datos del Número exterior

1.- Numero Exterior (<numeroExteriorNum>).- Dato

obligatorio, en caso de no tener se deberá enviar un cero.

2.- Numero Exterior Alfanumérico (<numeroExteriorAlfa>).-

Parte Alfanumérica del Número Exterior

Ejemplos

Campo Valor

numeroExteriorNum

120

numExteriorAlfa B

Dato: 120-B

Campo Valor

numeroExteriorNum

0

numExteriorAlfa Domicilio conocido

Dato: Domicilio conocido

Campo Valor

numeroExteriorNum

5

numExteriorAlfa

Dato: 5

Datos del Número interior

1.- Numero Interior(<numeroInteriorNum>).- Dato opcional

2.- Numero Interior Alfanumérico (<numeroInteriorAlfa>).-

Parte Alfanumérica del Número interior

Ejemplos

Campo Valor

numeroInteriorNum

numInteriorAlfa

Dato: 15

Campo Valor

numeroInteriorNum 3

numInteriorAlfa

Dato: 15 int-3

Campo Valor

numeroInteriorNum 3

numInteriorAlfa b

Dato: 15 int-3b

Tipos de domicilio

• Urbano = 1

• Rural = 2

• Carretera = 3

• Camino = 4

Tipos de domicilio

Urbano y Rural

Tipo de vialidad (de acuerdo a catálogo)

Nombre de vialidad

Carretera

Termino genérico (de acuerdo a catálogo)

Administración (ESTATAL, FEDERAL, MUNICIPAL, PARTICULAR)

Derecho de transito ( CUOTA, LIBRE)

Tramo (Poblaciones Origen-Destino que limitan al tramo)

Cadenamiento ( Kilometro en el que se ubica el domicilio geográfico)

Camino

Termino genérico (de acuerdo a catálogo)

Tramo (Poblaciones Origen-Destino que limitan al tramo)

Margen (derecho o izquierdo en funsión del tramo)

Cadenamiento ( Kilometro en el que se ubica el domicilio geográfico)

Vialidades de referencia

Vialidades de Referencia.- Los campos de Tipo de

Vialidad de Referencia y Nombre de Vialidad de

Referencia son obligatorios

<tipoVialidadIdRef1>5</tipoVialidadIdRef1>

<nombreVialidadRef1>PENSAMIENTO</nombreVialidadRef1

>

<tipoVialidadIdRef2>3</tipoVialidadIdRef2>

<nombreVialidadRef2>AZAHARES</nombreVialidadRef2>

<tipoVialidadIdRef3>2</tipoVialidadIdRef3>

<nombreVialidadRef3>GARDENIA</nombreVialidadRef3>

El tipo vialidad de referencia se debe de llenar con el

siguiente catalogo

Vialidades de referencia

cve_tipo_vial descripcion

1 AMPLIACIÓN

2 ANDADOR

3 AVENIDA

4 BOULEVARD

5 CALLE

6 CALLEJÓN

7 CALZADA

8 CERRADA

9 CIRCUITO

10 CIRCUNVALACIÓN

11 CONTINUACIÓN

12 CORREDOR

13 DIAGONAL

14 EJE VIAL

15 PASAJE

16 PEATONAL

17 PERIFÉRICO

18 PRIVADA

19 PROLONGACIÓN

20 RETORNO

21 VIADUCTO

22 CARRETERA

0 NINGUNO

23 BRECHA

24 CAMINO

25 TERRACERÍA

26 VEREDA

COMUNICACIÓN FOVISSSTE

Por cuestiones de operatividad, se mantendrá en funcionamiento la plataforma que utilizan actualmente las unidades de valuación hasta el 31 de marzo de los corrientes, ambos web services operaran en paralelo,

imperando la siguientes reglas:

Avalúos elaborados con fechas anteriores al 1 de marzo se recibirán en la comunicación directa del web serviceUnidad de valuación – FOVISSSTE y el documento impreso contendrá las firmas autógrafas, avalúos con fecha

posterior al 1 de marzo que intenten enviarse por este servicio, les enviará el siguiente mensaje: "Avalúos elaborados a partir del 2 de marzo, se recibirán desde el Sistema Maestro de Avalúos operado por la SHF."

Avalúos elaborados con fecha 2 de marzo, se recibirán desde el sistema maestro de avalúos operado por la SHF, web service Unidad de Valuación- SHF-FOVISSSTE y el documento impreso tendrá la firma electrónica (cadena

de caracteres autenticada por la SHF)

No prescindimos del avalúo impreso, por lo que permanece la entrega del documento en físico.

Cualquier duda sobre la comunicación con SHF favor de enviarla a través del correo infosma@shf.gob.mx dudas sobre la operación FOVISSSTE al correo miriam.texta@fovissste.gob.mx