manual técnico para la comunicación de los servicios web con las unidades de valuaciónsistema...
TRANSCRIPT
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 [email protected] dudas sobre la operación FOVISSSTE al correo [email protected]