Departamento: Sistemas Tipo: Programa: Autor(es): Orange-Euskatel Asunto: IT Cobertura & Activación Proyecto: Mutualización nueva red FTTH Euskatel Fecha: Estado: Abierto Código Documento: Autor/es: David Hernández (OSP) Carolina Guevara (OSP) Revisado por: Aprobado por: Fecha: 27/02/2017 Fecha: Fecha: Modificaciones Realizadas Lista de Distribución: Control de versiones: Versión: Fecha: Descripción: 1.0 27/02/2017 Versión inicial propuesta de OSP 2.0 25/08/2017 Documentos Relacionados: Página 1 de 38 Revisión: Departamento: Sistemas Tipo: Programa: Autor(es): Orange-Euskatel 2 Proyecto: Mutualización nueva red FTTH Euskatel Estado: Abierto Código Documento: Revisión: 0.1 Objetivo .......................................................................................................... 4 0.2 Alcance........................................................................................................... 4 0.3 Definiciones .................................................................................................... 4 fichero de cobertura ............................................................................................... 5 2.1 estructura del fichero DE HOGARES (ch) ....................................................... 5 2.1.1 2.2 2.3 Ejemplos................................................................................................ 11 CTOs desmutualizadas y hogares eliminados del fichero de hogares .......... 11 2.4.1 2.5 Ejemplos................................................................................................ 10 Fichero hogares desmutualizados y eliminados del fichero de hogares ........ 10 2.3.1 2.4 Ejemplos.................................................................................................. 8 Fichero que contiene operador dueño de acometidas .................................... 8 2.2.1 Ejemplos................................................................................................ 12 Renormalización de gescales ....................................................................... 12 2.5.1 3 Fecha: Asunto: IT Cobertura & Activación Ejemplos................................................................................................ 12 2.6 Guia de uso fichero de cobertura .................................................................. 13 2.7 Listas de valores cobertura ........................................................................... 13 2.7.1 Provincias .............................................................................................. 13 2.7.2 Tipos de via ........................................................................................... 14 2.7.3 Bis/Duplicado......................................................................................... 16 2.7.4 Bloque/Finca.......................................................................................... 16 2.7.5 Escalera ................................................................................................ 16 2.7.6 Planta .................................................................................................... 16 2.7.7 Tipo Puerta ............................................................................................ 17 Servicios Activación ............................................................................................. 19 Página 2 de 38 Departamento: Sistemas Tipo: Programa: Autor(es): Orange-Euskatel 3.1 4 5 Fecha: Asunto: IT Cobertura & Activación Proyecto: Mutualización nueva red FTTH Euskatel Estado: Abierto Código Documento: Revisión: Activación ..................................................................................................... 19 3.1.1 Reserva de Recursos ............................................................................ 20 3.1.2 Cancelar Reserva de Recursos ............................................................. 21 3.1.3 Alta ........................................................................................................ 21 3.1.4 Alta Corporate Orange (Orange -> red Euskatel) ................................... 22 3.1.5 Cambio de Servicio................................................................................ 23 3.1.6 Baja ....................................................................................................... 24 3.2 Averias ................................................. Ошибка! Закладка не определена. 3.3 test Y DiagnOstico. ............................... Ошибка! Закладка не определена. 3.4 Formato de campos ...................................................................................... 24 3.5 Formato de respuesta y Códigos de rechazo................................................ 26 3.6 Lista de valores Activación ........................................................................... 27 3.7 Tipo de CTO ......................................... Ошибка! Закладка не определена. Requisitos de la implementación ......................................................................... 30 4.1 Servicios on-line ........................................................................................... 30 4.2 Conectividad ................................................................................................. 30 4.3 Pruebas ........................................................................................................ 31 4.4 Política de reintentos .................................................................................... 32 4.5 Soporte a incidencias ................................................................................... 32 4.6 Servicios ............................................... Ошибка! Закладка не определена. 4.7 Disponibilidad de servicios IT para soporte de Operaciones ......................... 33 ANEXOS.............................................................................................................. 34 5.1 Anexo 1: Ejemplos de codificación de direcciones ........................................ 34 5.2 Anexo 2: Códigos de OLT Provincia ............................................................. 36 5.3 Anexo 3: TIPOS DE PERMISO (A REVISAR) .............................................. 27 Página 3 de 38 Departamento: Sistemas Tipo: Programa: Autor(es): Orange-Euskatel 5.4 0.1 Fecha: Asunto: IT Cobertura & Activación Proyecto: Mutualización nueva red FTTH Euskatel Estado: Abierto Código Documento: Revisión: Anexo 4: PUNTOS DEL FORO A TRABAJAR/REVISAR CONJUTAMENTE 37 OBJETIVO El objetivo de este documento es hacer una definición del fichero de intercambio de domicilios y de los servicios de activación. 0.2 ALCANCE Este documento describe los campos que componen cada registro del fichero de domicilios, identificando su contenido, estructura y valores posibles. Igualmente se dan directrices de cómo se debe elaborar dicho fichero. Respecto de los servicios de activación, se detallan las llamadas y respuestas para cada servicio. 0.3 DEFINICIONES CDP Caja de Derivación de Planta CTO Caja Terminal Optica GPON Gigabit Passive Optical Network Remote_ID Código remote_ID OLT Optical Line Terminal ONT Optical Network Terminal PAI punto de Acceso Indirecto pPAI puerto del Punto de Acceso Indirecto Template código que representa el Perfil del servicio (velocidad, calidad, Vlans, modelo de provisión) TO Territory Owner TU Territory User Página 4 de 38 Departamento: Sistemas Tipo: Programa: Autor(es): Orange-Euskatel Asunto: IT Cobertura & Activación Proyecto: Mutualización nueva red FTTH Euskatel Fecha: Estado: Abierto Código Documento: Revisión: 2 FICHERO DE COBERTURA 2.1 ESTRUCTURA DEL FICHERO DE HOGARES (CH) El fichero de domicilios da los hogares en cobertura y tiene por objeto permitir la contratación del servicio al domicilio cubierto. El fichero de domicilios estará estructurado con un registro por domicilio. CAMPO Propuesta OBLIG FORMATO Lista valores ID_DOMICILIO TO Identificador del territory owner para el domicilio. El primer carácter identifica el TO SI CHAR (38) NO O – Identificador huella Orange J – Identificador huella Jazztel V – Identificador huella VOD. M -> Identificador de la huella MM Identificador único por registro Código Postal Código Postal SI CHAR (5) NO Provincia Texto de la tabla de provincias SI CHAR (22) SI Población Texto Libre en MAYUSCULAS y sin TILDES, de acuerdo con lista valores admitidos SI CHAR (255) NO Tipo de vía MAYUSCULAS y sin TILDES, de acuerdo a la lista de valores de la lista SI CHAR (17) Si Nombre de vía Texto Libre en MAYUSCULAS y sin TILDES SI CHAR (255) NO ID TECNICO DE LA VIA GESCAL12. Identificador previo de la dirección que lleva la traducción técnica de los valores (Provincia, Población, Tipo de Via y Nombre via) GESCAL 12. Si hay "0" a la izquierda se mantendrán todos en el CHAR SI CHAR (12) NO Número Número de la FINCA o VIA -Las fincas indeterminadas (S/N y los puntos Kilométricos) vendrán con 00000 y el campo observaciones pasa a ser obligatorio - Números de vía doble, se desdoblan apareciendo dos líneas una para cada uno de los números SI CHAR (5) NO NO CHAR (1) Si - Con 0 a la izquierda para completar los cinco caracteres si es necesario. Ver Ejemplo 7 y 8. Bis/Duplicado Indica si hay otro número igual que la dirección del cliente, sirve para los Bis y duplicados. Si selecciona los códigos de PK (K, X e Y), el número de la finca debe ir a "00000" y el campo observaciones es obligatorio Ver ejemplo 7 y 8 Página 5 de 38 Departamento: Sistemas Tipo: Programa: Autor(es): Orange-Euskatel Bloque de la finca Fecha: Asunto: IT Cobertura & Activación Proyecto: Mutualización nueva red FTTH Euskatel Estado: Abierto Código Documento: Bloque de la finca de la dirección del cliente. Queda como en GESCAL (BXX). - B es valor de una lista de valores - XX posteriores corresponde con el identificador de Bloque, que puede contener caracteres alfanuméricos. Revisión: NO CHAR (3) SI No se admiten bloques con ceros, es decir no admitido “B00” Ver ejemplo 5 Identificador Finca/Portal Identificador de sección dentro de una Finca. Ver ejemplo 1, 2, 3 NO CHAR (2) NO Letra de la finca Identificador de sección adicional dentro de una finca. Uso mínimo, pero en algunos casos contemplado. NO CHAR (1) NO Escalera Puede venir relleno con un valor de la lista de valores. O dos caracteres alfanuméricos. NO CHAR (2) SI* SI CHAR (3) SI* NO CHAR (4) SI NO CHAR (4) NO NO CHAR (255) NO Ver ejemplo 9 y 11 Planta Es obligatorio Puede venir relleno con un valor de la lista de valores Si se selecciona un valor de la lista, no se podrá utilizar el carácter adicional. Será el valor de la lista justificado a la izquierda con espacio a la derecha. También admite en sustitución de ese valor de la lista un dato numérico (de hasta 3 caracteres) con ceros a la izquierda Ver ejemplo: aplican todos los ejemplos Mano 1 (Tipo Puerta) Lista de valores o cuatro caracteres no combinables (o uno u otro): - Si por ejemplo 3º C, la C va en MANO1, - Si apartamento C, MANO1 lleva APTO y MANO2 lleva C (mayúscula justificado a la izquierda, rellenado con campos en blanco a la derecha) No se admiten ceros a la izquierda para evitar duplicidades de códigos Ver ejemplo 8 y 9 Mano 2 (Puerta Letra/ Numero) Cuatro caracteres - Si por ejemplo 3º C, la C va en MANO1, - Si apartamento C, MANO1 lleva APTO y MANO2 lleva C (mayúscula justificado a la izquierda, rellenado con campos en blanco a la derecha) No se admiten ceros a la izquierda para evitar duplicidades de códigos Ver ejemplo 8 y 10 Observaciones/ Comentario Texto libre para en caso de necesidad, incluir en las ordenes de instalación. Este campo es obligatorio en las fincas indeterminadas (SN y los puntos Kilométricos) Este campo irá en MAYUSCULAS y sin TILDES Este campo no debe contener separadores como “;” o “/”. Será responsabilidad del generador de información eliminarlos o sustituirlos por carácter Página 6 de 38 Departamento: Sistemas Tipo: Programa: Autor(es): Orange-Euskatel Asunto: IT Cobertura & Activación Proyecto: Mutualización nueva red FTTH Euskatel Fecha: Estado: Abierto Código Documento: Revisión: acordado si apareciesen casos. Flag dummy Marca si el hogar es repetido como consecuencia de un hogar con portal doble SI CHAR (1) SI Ver ejemplo 7 Cod INE Vía Código INE de vía NO CHAR (5) NO Codigo Censal Codigo censal 2008 NO CHAR (10) NO Codigo PAI Huella Jazztel: Código MIGA con el carácter “J” delante – Ej. J0210003 SI CHAR (18) NO Huella Vodafone: Código MIGA con el carácter “V” delante – Ej. V0810006 Huella MM: Código MIGA con el carácter “M” delante – Ej. M0870006 Codigo OLT Código de la OLT que soporta el Hogar descrito en capítulo 3.4 Formato de campos NO CHAR (23) NO Codigo CTO Código de la CTO que soporta el Hogar descrito en capítulo 3.2 Formato de campos SI CHAR (20) NO Tipo de CTO Tipo de la CTO que soporta el Hogar SI CHAR (40) SI Dirección / Ubicación CTO Dirección instalación de la CTO SI CHAR (255) NO Tipo de permiso Posibles valores: ICT, FACHADA, INTERIOR y posible de anexo 3 SI CHAR (8) SI de Tipo de caja de derivación, con dos posibles valores: "CONECTORIZADA", "NO CONECTORIZADA", “INDEFINIDO” o null NO CHAR (16) SI Nº unidades inmobiliarias Nº unidades inmobiliarias conectables asociadas al edificio que cubre la dirección SI CHAR (3) NO NO CHAR (3) NO SI CHAR (8) NO Tipo caja derivación Comentarios: se incluye locales, viviendas oficinas etc…) conectables. Nº viviendas Nº de viviendas asociadas al edificio que cubre la dirección Comentario: viviendas residenciales de ese edificio conectable o no conectable. A revisar en el foro Fecha de Alta fecha del fichero en el que se ha incorporado el registro El fichero a cargar debe ser de texto, con formato UTF-8 sin BOM Se usará un nombre de fichero con la estructura: CH_xxx_zzz_AAMMDD_VV_NNNNNNNN.csv Donde xxx (código operador origen) _zzz (operador destino) AAMMDD (fecha, timestamp) VV (versión) NNNNNNNN (nº registros).csv Página 7 de 38 Departamento: Sistemas Tipo: Programa: Autor(es): Orange-Euskatel Asunto: IT Cobertura & Activación Proyecto: Mutualización nueva red FTTH Euskatel Fecha: Estado: Abierto Código Documento: Revisión: El fichero está compuesto de una línea por cada registro. Los campos de cada registro se separarán por el carácter (;), cerrando siempre cada campo con el carácter antes indicado. Cada línea se cerrará con un (;) El carácter de control “LF” se utilizará como marca de final de línea, como establece el formato UNIX de final de línea. 2.1.1 Ejemplos CH_030_020_161030_01_00000001 J28000010285600023 0022 ;28027;MADRID;MADRID;AVENIDA;DONOSTIARRA;280000102856;00023;;;;;;002;2 ;;;0;;2807915115;J2810050;OLTZ2810050MAD112;029-28-266035;EXTERIOR 1DV16 Y 16 PUERTOS OPTITAP;Avenida Donostiarra 23;FACHADA;;74;74;20160216; Nota: Muy importante: FECHA ALTA debe contener la fecha en la que se intercambia ese hogar. Nota2: Estructura definida en tabla 2.1 Estructura Fichero 2.2 FICHERO QUE CONTIENE OPERADOR DUEÑO DE ACOMETIDAS Este fichero es una propuesta a cerrar en futuro Operational Committee. Pendiente de definir si se comparte. CAMPO Propuesta OBLIG FORMATO Lista valores Codigo del PAI que soporta el Hogar descrito en capítulo 3.2 Formato de campos SI CHAR (18) NO Código CTO de TO Codigo de la CTO que soporta el Hogar descrito en capítulo 3.2 Formato de campos SI CHAR (20) NO CTO conectada (SI/NO) Estado de conexión de la CTO SI CHAR (2) SI Código Miga Código MIGA de la Central Cabecera FTTH en la que está localizada la OLT a la que está la CTO SI CHAR (7) NO Tipo CTO Tipo de la CTO que soporta el Hogar SI CHAR (40) SI Número de hogares a los que es posible dar servicio FTTH desde la CTO SI CHAR (3) NO Provincia Texto de la tabla de provincias SI CHAR (22) SI Municipio/Población Texto Libre en MAYUSCULAS y sin TILDES, de acuerdo con lista valores admitidos SI CHAR (255) NO Número de Conectables Hogares Página 8 de 38 Departamento: Sistemas Tipo: Programa: Autor(es): Orange-Euskatel Asunto: IT Cobertura & Activación Proyecto: Mutualización nueva red FTTH Euskatel Fecha: Estado: Abierto Código Documento: Revisión: Tipo de vía MAYUSCULAS y sin TILDES, de acuerdo a la lista de valores de la lista SI CHAR (17) SI Nombre de vía Texto Libre en MAYUSCULAS y sin TILDES SI CHAR (255) NO Id técnico via ID Gescal12 CTO SI CHAR (12) NO Numero Número de vía en el que se sitúa la CTO SI CHAR (5) NO Bis/duplicado Complemento de dirección en la que se sitúa la CTO NO CHAR (1) SI Tipo de Bloque Bloque en el que se sitúa la CTO NO CHAR (3) SI Bloque Bloque en el que se sitúa la CTO. Queda como en GESCAL (BXX). NO CHAR (3) SI NO CHAR (2) NO - B es valor de una lista de valores - XX posteriores corresponde con el identificador de Bloque, que puede contener caracteres alfanuméricos. Portal/puerta Portal en el que se sitúa la CTO. Identificador de sección dentro de una Finca. No lleva nunca una Ux (es decir se elimina el poder dar puerta a nivel de finca) El campo queda como O+nº, O+letra, o dos nº, o dos letras; que se refieren a portal Letra finca Identificador de sección adicional dentro de una finca.Uso mínimo pero en algunos de direcciones complejas contemplado. NO CHAR (1) NO Observaciones Campo libre para indicar detalles de la localización de la CTO. Este campo irá en MAYUSCULAS y sin TILDES NO CHAR (255) NO Operador Gestor CTO vertical Operador gestor de la vertical y propietario de la misma SI CHAR (3) SI Operador constructor hasta módulo de operador Operador responsable de la construcción de la horizontal y módulo de operador o CTO de fachada SI CHAR (3) SI Página 9 de 38 Departamento: Sistemas Tipo: Programa: Autor(es): Orange-Euskatel Asunto: IT Cobertura & Activación Proyecto: Mutualización nueva red FTTH Euskatel Fecha: Estado: Abierto Código Documento: Revisión: Operador Adicional 1 Primer operador comercial NO CHAR (3) SI Operador Adicional 2 Segundo operador comercial NO CHAR (3) SI Operador Adicional 3 Tercer operador comercial NO CHAR (3) SI Fecha instalación operador gestor Fecha de instalación del cableado vertical por parte del Operador Gestor NO CHAR (8) NO El fichero a cargar debe ser de texto, con formato UTF-8 sin BOM. Se usará un nombre de fichero con la estructura: CC_xxx_zzz_AAMMDD_VV_NNNNNNNN.csv Donde xxx (código operador origen) _xxx (operador destino) AAMMDD (fecha, timestamp) VV (versión) NNNNNNNN (nº registros).csv El fichero está compuesto de una línea por cada registro. Los campos de cada registro se separarán por el carácter (;), cerrando siempre cada campo con el carácter antes indicado. El carácter de control “LF” se utilizará como marca de final de línea, como establece el formato UNIX de final de línea. 2.2.1 Ejemplos CC_030_xxx_161030_01_00000002 J2810002;029-28-001101;SI;2810002;EXTERIOR 1DV16 OPTITAP;7;MADRID;MADRID;CALLE;DONOSO CORTES;280000102854;00023;;;;;;;030;030;;;;20160914 Y 8 PUERTOS J0810006;029-08-121657;SI;0810006;EXTERIOR 1DV16 Y 16 PUERTOS OPTITAP;28;BARCELONA;BARCELONA;CALLE;CLOT;080001801020;00058;;;;;;;010;030;;;;2 016021 2.3 FICHERO HOGARES DESMUTUALIZADOS Y ELIMINADOS DEL FICHERO DE HOGARES Este fichero es una propuesta a cerrar en futuro Operational Committee. Pendiente de definir si se comparte. Contendrá hogares a desmutualizar/bloqueados. Página 10 de 38 Departamento: Sistemas Tipo: Programa: Autor(es): Orange-Euskatel Asunto: IT Cobertura & Activación Proyecto: Mutualización nueva red FTTH Euskatel Fecha: Estado: Abierto Código Documento: Revisión: CAMPO Propuesta OBLIG FORMATO Lista valores ID DOMICILIO TO Identificador del territory owner para el domicilio. El primer carácter identifica el TO (M para hogar desplegado por MásMóvil y J para hogar mutualizado de Jazztel). Identificador único por registro SI CHAR (38) NO SI CHAR (20) NO En caso de optar a huella Orange el identificador empezará por O. Codigo CTO Código de la CTO que soporta el Hogar descrito en capítulo 3.2 Formato de campos El fichero a cargar debe ser de texto, con formato UTF-8 sin BOM. Se usará un nombre de fichero con la estructura: HH_xxx_zzz_AAMMDD_VV_NNNNNNNN.csv Donde xxx (código operador origen) _zzz (operador destino) AAMMDD (fecha, timestamp) VV (versión) NNNNNNNN (nº registros).csv El fichero está compuesto de una línea por cada registro. Los campos de cada registro se separarán por el carácter (;), cerrando siempre cada campo con el carácter antes indicado. El carácter de control “LF” se utilizará como marca de final de línea, como establece el formato UNIX de final de línea. 2.3.1 Ejemplos HH_030_zzz_161030_01_00000001 J29000230065800013 2.4 001D ; 029-29-503853 CTOS DESMUTUALIZADAS Y HOGARES ELIMINADOS DEL FICHERO DE HOGARES Este fichero es una propuesta a cerrar en futuro Operational Committee. Pendiente de definir si se comparte. CAMPO Propuesta OBLIG FORMATO Lista valores Codigo CTO Código de la CTO que soporta el Hogar descrito en capítulo 3.2 Formato de campos SI CHAR (20) NO El fichero a cargar debe ser de texto, con formato UTF-8 sin BOM. Se usará un nombre de fichero con la estructura: CTO_xxx_zzz_AAMMDD_VV_NNNNNNNN.csv Donde xxx (código operador origen) _zzz (operador destino) AAMMDD (fecha, timestamp) VV (versión) NNNNNNNN (nº registros).csv Página 11 de 38 Departamento: Sistemas Tipo: Programa: Autor(es): Orange-Euskatel Asunto: IT Cobertura & Activación Proyecto: Mutualización nueva red FTTH Euskatel Fecha: Estado: Abierto Código Documento: Revisión: El fichero está compuesto de una línea por cada registro. Los campos de cada registro se separarán por el carácter (;), cerrando siempre cada campo con el carácter antes indicado. El carácter de control “LF” se utilizará como marca de final de línea, como establece el formato UNIX de final de línea. 2.4.1 Ejemplos CTO_030_zzz_161030_01_00000001 029-28-503853 2.5 RENORMALIZACIÓN DE GESCALES Este fichero es una propuesta a cerrar en futuro Operational Committee. Pendiente de definir si se comparte. CAMPO Propuesta OBLIG FORMATO Lista valores Gescal actual Código Gescal actual de la dirección que se desea renormalizar. En el caso de Jazztel incluirá la “J” inicial SI CHAR (38) NO Gescal nuevo Código Gescal nuevo de la dirección a renormalizar SI CHAR (38) NO El fichero a cargar debe ser de texto, con formato UTF-8 sin BOM. Se usará un nombre de fichero con la estructura: RG_zzz_xxx_AAMMDD_VV_NNNNNNNN.csv Donde zzz (código operador origen) _xxx (operador destino) AAMMDD (fecha, timestamp) VV (versión) NNNNNNNN (nº registros).csv El fichero está compuesto de una línea por cada registro. Los campos de cada registro se separarán por el carácter (;), cerrando siempre cada campo con el carácter antes indicado. El carácter de control “LF” se utilizará como marca de final de línea, como establece el formato UNIX de final de línea. 2.5.1 Ejemplos RG_030_xxx_161030_01_00000001 J46003435224400005 BA LOC 1 ; J46003435224400005 Página 12 de 38 BA LOC 2 Departamento: Sistemas Tipo: Asunto: IT Cobertura & Activación Programa: Autor(es): Orange-Euskatel 2.6 Proyecto: Mutualización nueva red FTTH Euskatel Fecha: Estado: Abierto Código Documento: Revisión: GUIA DE USO FICHERO DE COBERTURA Códigos especiales o “Ç”: Si permitido o “L•L”: Si permitida, aunque se acepta tanto con doble L geminada como sin ella. o “Ñ”: Si permitido (no usar en generación id administrativo/IUA) o “- “: Si permitido o “.”: No permitido o “ª” o “º”: No permitido o “ü o ï”: Si permitido o “()”: Si permitido o “/”: Si permitido o “;”: No permitido, se usa como separador de campos o Carácter “No permitido El Código Censal cambia de modo continúo en los municipios en función de la variación demográfica. En este sentido se ha de definir una referencia relativa al año del seccionado con el que se va a trabajar para compartir información. Se propone empezar a trabajar con el año 2008. El cambio del año de referencia se acordará por ambas partes. Flag_dummy marca si el hogar es repetido como consecuencia de un número de portal doble. De esta forma se puede comprobar que el número de hogares en cobertura en el fichero a efectos de comprobar la cobertura contenida en el fichero Los campos Tipo CTO, Dirección/ubicación de la CTO, Tipo de permiso y Tipo de caja derivación tienen por objeto el poder informar al cliente su tipo de instalación. Con tipo de CTO y su ubicación se conoce si es en fachada y donde está situada. Con el tipo de permiso si tiene ICT y con tipo de caja de derivación si tiene caja de derivación de planta (de no tenerla y ser CTO de interior, la acometida del cliente iría hasta la propia CTO). Números de vía doble se contabilizarán dos veces: los hogares estarán repetidos para cada número 2.7 LISTAS DE VALORES COBERTURA 2.7.1 Provincias Provincia CODIGO ALAVA 01 ALBACETE 02 ALICANTE 03 ALMERIA 04 ASTURIAS 33 AVILA 05 BADAJOZ 06 BALEARES 07 BARCELONA 08 BURGOS 09 CACERES 10 Página 13 de 38 Departamento: Sistemas Tipo: Asunto: IT Cobertura & Activación Programa: Autor(es): Orange-Euskatel Proyecto: Mutualización nueva red FTTH Euskatel Fecha: Estado: Abierto Código Documento: CADIZ 11 CANTABRIA 39 CASTELLON 12 CEUTA 51 CIUDAD REAL 13 CORDOBA 14 CUENCA 16 GIRONA 17 GRANADA 18 GUADALAJARA 19 GUIPUZCOA 20 HUELVA 21 HUESCA 22 JAEN 23 LA CORUÑA 15 LA RIOJA 26 LAS PALMAS 35 LEON 24 LLEIDA 25 LUGO 27 MADRID 28 MALAGA 29 MELILLA 52 MURCIA 30 NAVARRA 31 ORENSE 32 PALENCIA 34 PONTEVEDRA 36 SALAMANCA 37 SEGOVIA 40 SEVILLA 41 SORIA 42 SANTA CRUZ TENERIFE TARRAGONA DE 38 43 TERUEL 44 TOLEDO 45 VALENCIA 46 VALLADOLID 47 VIZCAYA 48 ZAMORA 49 ZARAGOZA 50 2.7.2 Tipos de via Página 14 de 38 Revisión: Departamento: Sistemas Tipo: Asunto: IT Cobertura & Activación Programa: Autor(es): Orange-Euskatel Proyecto: Mutualización nueva red FTTH Euskatel Fecha: Estado: Abierto Código Documento: Revisión: TIPOS DE VIA CONJUNTOS ACCES CALLEJA COLONIA FABRICA MERCADO POBLADO SEGUNDA TRAVESIA ACCESO CALLEJONES COMPLEJO FALDAS MERCAT POLIGON SENDA ACEQUIA CALLEJUELA CONJUNTO FINCA MIRADOR POLIGONO SENDERO ACERA CALLEJON CONVENTO FINCAS MONASTERIO PORTAL SERVENTIA AFUERA CALLIZO COOPERATIVA FUENTE MONTE PORTICO SUBIDA AGRUPACION CALZADA CORRAL GALERIA MUELLE PORTILLO TORRENT ALAMEDA CAMI CORRALILLO GLORIETA MURALLA POSADA TORRENTE ALBEREDA CAMINAL CORREDERA GRAN VIA NAVES PRADO TRANSITO ALDEA CAMINO CORREDOR GRANJA NUCLEO PRAZA TRANSVERSAL ALQUERIAS CAMIÑO CORREDORCILLO GRANJAS NUDO PRIMERA TRAVESIA TRASERA ALTO CAMPA CORTIJADA GRUP PAGO PROLONGACION TRASERAS ANDADOR CAMPING CORTIJO GRUPO PALACIO PUEBLO TRAVESIA ANGOSTA CAMPO COSTA GRUPO COOPERATIVA PANTANO PUENTE TRAVESSERA ANTEIGLESIA CANAL COSTANILLA GRUPOS PARAJE PUERTA TRAVESSIA APARTAMENTO CANTERAS COSTERA HACIENDA PARATGE PUERTO TRAVIESA APEADERO CANTINA CUADRA HIPODROMO PARC RAMAL TUNEL ARBOLEDA CANTO CUESTA HOYA PARCELAS RAMBLA URBANITZACIO ARCO CANTON DEHESA HUERTA PARQUE RAMBLETA URBANIZACION ARRABAL CARRER DISEMINADO HUERTAS PARTICULAR RAMPA VALLE ARROYO CARRERA DISEMINADO HUERTO PARTIDA RAMPAS VECINDARIO ATAJO CARRERO EDIFICI HUERTOS PASADIZO RANCHO VEGA AUTOPISTA CARRETERA EDIFICIO ISLA PASAJE RAVAL VENTA AUTOVIA CARRETERIN EDIFICIOS JARDINES PASEIO REPLACETA VENTAS AVENIDA CARRETIL EJE JARDIN PASARELA RESIDENCIA VEREDA AVINGUDA CARRIL EMBALSE LADERA PASEO RESIDENCIAL VIA BAIXADA CASA EMPRESA LAGO PASILLO RIBERA VIADUCTO BAJADA CASERIO ENTRADA LANDA PASO RIERA VIAL BALNEARIO CASETA ERMITA LLANURA PASSEIG RINCONADA VILLA BARRANCO CASETAS ESCALA LOMA PATIO RINCON VIVIENDAS BARRI CASILLA ESCALERA LOMO PINAR RONDA ZONA BARRIADA CASTILLO ESCALERAS JOKARDI PISTA RONDIN PAS BARRIO CAÑADA ESCALINATA KALEA PLACA ROTONDA PASSADIS BARRO CENTRO COMERCIAL ESPALDA LANDETXE PLAÇA RUA PASSATGE BLOQUE CERRO ESPIGO LORIO PLACETA RUSTICA BLOQUES CHALET ESTACION LUGAR PLAYA RUTA BRAZAL CINTURON ESTRADA MALECON PLAZA SALIDA BULEVAR CIRCUNVALACION EXPLANADA MASIAS PLAZOLETA SANATORIO CALEXON CMNO HONDO EXTRAMUROS MASIA PLAZUELA SANTUARIO CALLE COBERTIZO EXTRARRADIO MASIAS POBLACION SECTOR Página 15 de 38 Departamento: Sistemas Tipo: Programa: Autor(es): Orange-Euskatel Asunto: IT Cobertura & Activación Proyecto: Mutualización nueva red FTTH Euskatel Fecha: Estado: Abierto Código Documento: Revisión: * ante la eventual generación de información de ficheros por cualquiera de las dos partes donde aparecieran codificaciones distintas a las indicadas, deberá acordarse en ese momento que operador traduce el tipo de vía (o el emisor o el receptor). Lo más fácil, sería que lo hiciese el receptor en la carga de información dado que el emisor ya ha desplegado la fibra. 2.7.3 Bis/Duplicado BIS/DUPLICADO DESCRIPCION B C D K Q T X Y Bis Cuadruplicado Duplicado Kilómetro Quintuplicado Triplicado Kilómetro margen derecho Kilómetro margen izquierdo 2.7.4 Bloque/Finca BLOQUE/FINCA A B C E F G H L N P R S T Z DESCRIPCION Almacén Bloque Casa Edificio Estación Garaje Chalet Pabellón Nave Parcela Grupo Sector Torre Zona 2.7.5 Escalera ESCALERA DESCRIPCION V W X Y Z Izquierda Derecha Centro Interior Exterior PLANTA AL AM AS AT BA BU DESCRIPCION Altillo Almacén Ascensor Atico Bajo Bungalow 2.7.6 Planta Página 16 de 38 Departamento: Sistemas Tipo: Programa: Autor(es): Orange-Euskatel Fecha: PLANTA CH DU EN ET GA KI MO LO NA OF PR PT SA SE SO SS S1 S2 S3 S4 S5 S6 S7 S8 S9 TE TI X1 X2 X3 X4 X5 X6 X7 X8 X9 Proyecto: Mutualización nueva red FTTH Euskatel Estado: Abierto Código Documento: DESCRIPCION Chalet Dúplex Entresuelo Entreplanta Garaje Kiosco Modulo Local Nave Oficina Principal Puesto Sobreático Semisótano Sótano Semisótano Sótano 1 Sótano 2 Sótano 3 Sótano 4 Sótano 5 Sótano 6 Sótano 7 Sótano 8 Sótano 9 Terraza Tienda Semisótano 1 Semisótano 2 Semisótano 3 Semisótano 4 Semisótano 5 Semisótano 6 Semisótano 7 Semisótano 8 Semisótano 9 2.7.7 Tipo Puerta TIPO PUERTA APTO CTRO DCHA DPCH EXT HABI INT IZDA LOCL OFIC PTO TDA Asunto: IT Cobertura & Activación DESCRIPCION Apartamento Centro Derecha Despacho Exterior Habitación Interior Izquierda Local Oficina Puesto Tienda Página 17 de 38 Revisión: Departamento: Sistemas Tipo: Programa: Autor(es): Orange-Euskatel Fecha: Asunto: IT Cobertura & Activación Proyecto: Mutualización nueva red FTTH Euskatel Estado: Abierto Página 18 de 38 Código Documento: Revisión: Departamento: Sistemas Tipo: Programa: Autor(es): Orange-Euskatel Asunto: IT Cobertura & Activación Proyecto: Mutualización nueva red FTTH Euskatel Fecha: Estado: Abierto Código Documento: Revisión: 3 SERVICIOS ACTIVACIÓN En este apartado se describen los servicios para mutualización con EKT. Estos servicios se realizarán mediante un webservice síncrono. Los códigos propuestos para los WS son: TIPO WS Activación Descripción Reserva de Recursos Cancelar Reserva de Recursos Alta Alta Corporate Cambio de Servicio Baja Esquemáticamente se plantean las siguientes transiciones permitidas: 3.1 ACTIVACIÓN A continuación se muestra los servicios de activación. Página 19 de 38 Departamento: Sistemas Tipo: Asunto: IT Cobertura & Activación Programa: Autor(es): Orange-Euskatel Proyecto: Mutualización nueva red FTTH Euskatel Fecha: Estado: Abierto Código Documento: Revisión: 3.1.1 Reserva de Recursos El servicio de reserva de recurso tiene por objeto el que el TO asigne recursos necesarios a una petición del TU, con objeto de asegurar la provisión de los mismos en el caso que se solicite el alta. El servicio de reserva contestará con un administrativo del servicio que se deberá utilizar para solicitar el alta. Se permitirá un número máximo de reservas por hogar a configurar en un contador responsabilidad de cada TO, de la misma manera cada TO deberá contemplar, si lo estima oportuno un contador de días máximos que perdura una reserva sin activación. El valor de los contadores será acordado por ambos operadores, con las siguientes condiciones: > 1 reserva por identificado de hogar. < 7 días La petición estará formada por: CAMPO Tipo Obligatorio ID_DOMICILIO TO Identificador del HOGAR SI Template Perfil del servicio SI Remote_ID Código remote_ID SI pPAI Código pPAI SI TV_Remote_ID Código Remote ID de Televisión NO El template representa el perfil de la oferta, será un código compartido por el TO y el TU que representa los parámetros de red que deben ser activados para el acceso: velocidad, calidad de servicio, VLANes, modelo de provisión. La respuesta estará formada por: CAMPO Tipo Obligatorio Id Domicilio Identificador del HOGAR SI Id Administrativo Administrativo del Servicio SI Código de la CTO Código de la CTO SI Tipo de CTO Tipo de CTO SI Dirección/ubicación de la CTO Dirección/ubicación de la CTO SI Identificador de splitter reservado Ejemplo: SI Orange: 030-33-001268-S02 Jazztel: FTHMAD265D0186 Vodafone: 082-33-004204-S01 MasMovil: 208165.1 Página 20 de 38 Departamento: Sistemas Tipo: Programa: Autor(es): Orange-Euskatel Proyecto: Mutualización nueva red FTTH Euskatel Fecha: Tipo de splitter reservado Asunto: IT Cobertura & Activación Estado: Abierto Código Documento: Tipo de splitter reservado Revisión: SI Ejemplo Orange 1:16 Ejemplo JZZ 1:16 Ejemplo VOD 1:16 Ejemplo MM 1:8 Posición del Splitter Puerto de CTO SI Código de caja de derivación de Código de caja de derivación de planta NO Ubicación de caja de derivación de planta NO Tipo de caja derivación Tipo de caja derivación NO Código OLT Código OLT SI Modelo OLT Modelo OLT SI Versión SW de la OLT Versión SW de la OLT SI Tarjeta OLT Tarjeta OLT SI Puerto GPON Puerto GPON SI GESTOR DE LA VERTICAL GESTOR DE LA VERTICAL NO planta Ubicación de caja de derivación de planta La reserva tendrá un período de validez configurable por parte de los operadores al objeto de poder ajustarlo en el futuro. Se estima configurar un período de 7 días naturales al comienzo. Pasado ese plazo el código de reserva no será válido y se deberá realizar una nueva reserva. 3.1.2 Cancelar Reserva de Recursos El servicio de cancelación de reserva de recurso tiene por objeto el que el TO desasigne recursos reservados bajo una solicitud de reserva sin tener que esperar que expire el plazo de validez de la reserva. La petición estará formada por: CAMPO Id Administrativo Tipo Administrativo del Servicio Obligatorio SI La respuesta no contendrá información. 3.1.3 Alta El servicio de alta tiene por objeto el que el territory owner active recursos necesarios a una petición del territory user. A partir de ese momento el cliente final estará “ready for use” desde el punto de vista de acceso a la red. El servicio de alta se solicitará mediante el administrativo del servicio obtenido por el servicio de reserva de recursos, por lo que no podrán solicitarse altas sin haber solicitado previamente una reserva. La petición estará formada por: CAMPO Tipo Página 21 de 38 Obligatorio Departamento: Sistemas Tipo: Programa: Asunto: IT Cobertura & Activación Proyecto: Mutualización nueva red FTTH Euskatel Autor(es): Orange-Euskatel Fecha: Estado: Abierto Id Administrativo Administrativo del Servicio Código Documento: Revisión: SI La respuesta estará formada por: CAMPO Tipo Obligatorio Id Administrativo Administrativo del Servicio SI Código de la CTO Código de la CTO SI Tipo de CTO Tipo de CTO Dirección/ubicación de la CTO Dirección/ubicación de la CTO SI Número identificador de splitter reservado Número identificador de splitter reservado SI Tipo de splitter reservado Tipo de splitter reservado Posición del Splitter Posición del Splitter SI Código de caja de derivación de planta Código de caja de derivación de planta NO Ubicación de caja de derivación de planta Ubicación de caja de derivación de planta NO Tipo de caja derivación Tipo de caja derivación NO Código OLT Código OLT Modelo OLT Modelo OLT Versión SW de la OLT Versión SW de la OLT Tarjeta OLT Tarjeta OLT Puerto GPON Puerto GPON ONTid ONTid ONT Password ONT Password GESTOR DE LA VERTICAL SI SI SI SI SI SI SI SI SI NO GESTOR DE LA VERTICAL VLAN por la que la OLT cursa el tráfico en el punto de entrega. VLAN de red SI (puede ser 0 – cero) 3.1.4 Alta Corporate El servicio de alta tiene por objeto el que el territory owner Euskatel active recursos necesarios a una petición del territory user Orange específica para clientes Corporate. A partir de ese momento el cliente final estará “ready for use” desde el punto de vista de acceso a la red. El servicio de alta se solicitará mediante el administrativo del servicio obtenido por el servicio de reserva de recursos, por lo que no podrán solicitarse altas sin haber solicitado previamente una reserva. La petición estará formada por: CAMPO Tipo Obligatorio Página 22 de 38 Departamento: Sistemas Tipo: Programa: Asunto: IT Cobertura & Activación Proyecto: Mutualización nueva red FTTH Euskatel Autor(es): Orange-Euskatel Fecha: Estado: Abierto Código Documento: Id Administrativo Administrativo del Servicio SI c-vlan 1 Número de vlan SI c-vlan 2 Número de vlan NO c-vlan 3 Número de vlan NO c-vlan 4 Número de vlan NO c-vlan 5 Número de vlan NO a-vlan_1 Número de vlan en acceso SI a-vlan_2 Número de vlan en acceso NO a-vlan_3 Número de vlan en acceso NO a-vlan_4 Número de vlan en acceso NO a-vlan_5 Número de vlan en acceso NO s-vlan Número de vlan de servicio SI Revisión: Orange como TU hay 4 c-vlans opcionales y una obligatoria y todas ellas únicas dentro de un rango predefinido; y 4 a-vlans opcionales y 1obligatoria y no únicas. En caso contrario se devolverá un error. La respuesta estará formada de forma igual a la respuesta del Alta no corporate. 3.1.5 Cambio de Servicio El servicio de cambio de servicio tiene por objeto el que el territory owner cambie el servicio asignado al cliente en la OLT. La petición estará formada por: CAMPO Tipo Obligatorio Id Administrativo Administrativo del Servicio SI Template Etiqueta que identifica perfil SI TV_Remote_ID Código Remote ID de Televisión NO La respuesta no contendrá información. En caso de error el cliente continuará con el perfil que tenía configurado previo a la solicitud de cambio de perfil. Página 23 de 38 Departamento: Sistemas Tipo: Asunto: IT Cobertura & Activación Programa: Autor(es): Orange-Euskatel Proyecto: Mutualización nueva red FTTH Euskatel Fecha: Estado: Abierto Código Documento: Revisión: 3.1.6 Baja El servicio de baja tiene por objeto el que el territory owner efectúe la baja del acceso del cliente del territory user. La petición estará formada por: CAMPO Id Administrativo Tipo Obligatorio Administrativo del Servicio SI La respuesta no contendrá información. 3.2 FORMATO DE CAMPOS CAMPO ID_DOMICILIO TO Id Administrativo IUA Tipo CHAR (38)- Formato: “O”, “J”, “V”, “M” + 37 alfanumérico libre para cada operador. O -> Orange J -> Jazztel V -> Vodafone M -> MasMovil CHAR (12) Obligatorio primer valor una letra ( “O”, “J”, “V”, “M” (dependiendo del operador que genera el ID) Ej. Orange : O33030ACB566 Ej. Jazztel : J25030AAH422 Ej. Vodafone: V33030ACG647 Ej. MasMovil: M46030A7SQJO Template CHAR (40); Remote_ID CHAR (40 ) caracteres alfanuméricos y , “-“. TV_Remote_ID Ejemplos: EKT -> Pendiente CHAR (40 ) PAI Ejemplos: EKT -> Pendiente CHAR (18) Formato: Letra Operador + código Miga ( Jxxxxxxx, Oxxxxxxx ) a partir del código MIGA Ejemplos: Orange -> O1510004 Jazztel -> J284354 Vodafone -> V1510002 MasMovil -> M0867003 Página 24 de 38 Departamento: Sistemas Tipo: Programa: Autor(es): Orange-Euskatel Asunto: IT Cobertura & Activación Proyecto: Mutualización nueva red FTTH Euskatel Fecha: Estado: Abierto pPAI Valor Fijo: NO_APLICA CTO CHAR(20) Código Documento: Revisión: Ejemplo: Orange -> 030-47-004831 Jazztel -> 029-46-041140 Vodafone -> 082-31-000440 MasMovil. -> CTO_489-129118X Tipo de CTO CHAR (40) Dirección/ubicación de la CTO CHAR (255), texto libre identificador de splitter reservado Tipo de splitter reservado CHAR (15) Posición del Splitter NUMBER (8,0) empieza en 1, limite 128. Será el puerto de la CTO 1:2 ,1:4 1:8 , 1:16 , 1:32 , 1:64 , 1:128 Código de caja de derivación de CHAR (50), texto libre planta Ubicación de caja de derivación CHAR (250), texto libre de planta Tipo de caja derivación CONECTORIZADA, NO CONECTORIZADA o INDEFINIDO o VACIO. No se valida. OLT CHAR (23) Ejemplos: Orange O1510004OLT01 Jazztel: OLTZ4610051VAL011 Vodafone: V5019006OLT02 MasMovil: 489-46-070-01-OLT Modelo OLT Huawei/ MA5600T , ALU/7360 ISAM FX16, ZTE/C300, ZTEC300 Versión SW de la OLT CHAR (20) Tarjeta OLT (slot) NUMBER (8) Aclaración: Puerto GPON Jazztel empieza en 2 NUMBER (8) Aclaración: ONTid Jazztel empieza en 1 NUMBER (3) Aclaración: ONT Password Jazztel empieza en 1 CHAR (10) GESTOR DE LA VERTICAL XXX código de operador Página 25 de 38 Departamento: Sistemas Tipo: Asunto: IT Cobertura & Activación Programa: Autor(es): Orange-Euskatel Proyecto: Mutualización nueva red FTTH Euskatel Fecha: Estado: Abierto Código Documento: Revisión: C-VLAN CHAR (4) VLAN de red número entre 0001 y 4095 – a definir en acuerdo servicios Corporate. NUMBER (8). Siempre a 0 (cero) El Id Administrativo será único y no reutilizable, tras una cancelación de reserva o baja, el TO no podrá utilizar de nuevo el identificador. 3.3 FORMATO DE RESPUESTA Y CÓDIGOS DE RECHAZO El formato de respuesta en el caso que el servicio no tenga que devolver ningún valor o que se produzca un error. Campo resultado Valores OK NOK Tipo cadena (3) codResultado Significado Resultado de la operación, OK solo en caso de no contener información. En caso de contener aplica la respuesta especificada en el servicio Código que identifica los posibles resultados de la operación descResultado Muestra la descripción del código del resultado obtenido cadena (256) cadena (3) Los códigos de rechazo se formarán con una cadena de tres caracteres: el primero una letra y dos números. Habrá un código para “No viene dato requerido” y en la descripción se componga este texto con el nombre del campo no encontrado en primer lugar por el receptor. Habrá otro para “Dato en formato no válido” y en la descripción se compondrá este texto con el nombre del campo Se dejan explícitos los errores no existe ID_Domicilio-TO y Id_Administrativo, Template y pPAI por su importancia ya que son los códigos de llamada. La siguiente tabla es como ejemplo, los códigos definitivos se establecerán en fase de desarrollo para estar seguros de haber identificado todos los errores posibles. Resultado OK CodResultado DescResultado Proceso ejecutado correctamente NOK 000 F01 NOK F02 Error a Conexión de Base de Datos NOK F03 Error en Ejecución de Base de Datos NOK F04 No viene dato requerido “CCCCCC” NOK F05 Dato en formato no válido “CCCCCCC” NOK F07 No existen recursos NOK F08 No existe código ID_DOMICILIO TO Fallos en Argumentos de Entrada Página 26 de 38 Departamento: Sistemas Tipo: Asunto: IT Cobertura & Activación Programa: Autor(es): Orange-Euskatel Proyecto: Mutualización nueva red FTTH Euskatel Fecha: Estado: Abierto NOK F09 No existe código Id Administrativo NOK F10 No existe código template NOK F11 No existe pPAI NOK F13 Movimiento no permitido NOK F15 Error en C-VLAN NOK F99 Error interno NOK F12 +++NO USAR. COD INTERNO +++ NOK F17 Configuración No finalizada Código Documento: Revisión: Este error se devolverá en la operación de activación si las solicitudes de la reserva en los sistemas no están finalizados o en la operación de cambio de servicio si la solicitud de la activación u otro cambio de servicio anterior no está totalmente finalizado en los sistemas. Ante este error deberá aplicarse una política de reintentos. NOK Número máximo de reservas alcanzado F16 Se va a controlar en los sistemas que no se realicen más de N reservas para un mismo Gescal, de forma que se devolverá un error al alcanzar el número máximo. Este error no necesita política de reintentos. 3.4 LISTA DE VALORES ACTIVACIÓN 3.4.1 Operador Operador Código de Operador Jazztel 029 Orange 030 Vodafone 082 MásMóvil 904 3.4.2 TIPOS DE PERMISO CODIGO ARQUETA/CR FACHADA GARAJE Página 27 de 38 Departamento: Sistemas Tipo: Programa: Autor(es): Orange-Euskatel Fecha: Asunto: IT Cobertura & Activación Proyecto: Mutualización nueva red FTTH Euskatel Estado: Abierto Código Documento: Revisión: ICT INTERIOR PATIO PEDESTAL POSTE RITI RITIS TERRAZA 3.4.3 TEMPLATES Templates Down Up Página 28 de 38 Configuración Departamento: Sistemas Tipo: Programa: Autor(es): Orange-Euskatel Fecha: Asunto: IT Cobertura & Activación Proyecto: Mutualización nueva red FTTH Euskatel Estado: Abierto Página 29 de 38 Código Documento: Revisión: Departamento: Sistemas Tipo: Programa: Autor(es): Orange-Euskatel Fecha: Asunto: IT Cobertura & Activación Proyecto: Mutualización nueva red FTTH Euskatel Estado: Abierto Código Documento: Revisión: 4 REQUISITOS DE LA IMPLEMENTACIÓN 4.1 SERVICIOS ON-LINE Ambas partes proporcionaran una API de servicios web para los servicios que proporcione online. La comunicación debería ser, vía https. Adicionalmente estos servicios web deberán soporta los protocolos de Internet HTTPS 1.1. y SOAP 1.1. Todas las operaciones se realizarán de forma síncrona y no se requerirá soporte para los mecanismos de suscripciones y notificaciones en la integración. El acuerdo de interfaz se realizará mediante el acuerdo de los ficheros de descripción (WSDL y Esquemas de Datos) entre los equipos de sistemas de cada compañía. Además, se acompañará de una guía de uso que especifique el uso de dicho WSDL, indicando principalmente el esquema, obligatoriedades funcionales y posibles validaciones cruzadas a tener en cuenta por la lógica. Los ficheros dispondrán de: • Fichero NOMBRE.wsdl: Descripción de la interfaz del Servicio según lo establecido en el estándar SOAP. Este fichero no contiene la URL definitiva de invocación del Servicios Web, la aplicación cliente deberá mediante programación cambiar la URL real para la invocación del servicio. • Fichero NOMBRE.xsd: Esquema XML utilizado por el fichero anterior que describe los datos de los mensajes de entrada y salida del Servicio accedido, según lo establecido por el estándar SOAP. • Fichero NOMBRE.doc/pdf: Guía de uso con el contrato de interfaz que especifique cómo se ha de realizar dicha comunicación, indicando principalmente el esquema, obligatoriedades funcionales y posibles validaciones cruzadas a tener en cuenta por la lógica El control de acceso se realizará a través del certificado y a través de validación de la IP origen de la petición.La validación de la IP la realizará el firewall, Se utilizaran dos certificados diferentes, uno EKT Jazztel y otro Orange / Jazztel EKT. La comunicación se efectuará con https con validación mutua. Es decir, se intercambiarán los certificados y cada uno validará el del otro. Los mensajes no irán firmados. Dado el nivel de complejidad que pudieran llegar a tener tanto la parte lógica de los interfaces, como la parte de seguridad, se necesitará disponer de un entorno de pruebas donde realizar las llamadas en una primera instancia en la fase previa a la puesta en producción de los servicios. Este entorno de pruebas hará uso de los mismos WSDL’s y guías de uso, siendo la única diferencia la URL a la que realizar la llamada. PENDIENTE FICHERO WSDL Política de reintentos: No se contemplan reintentos dentro de los servicios a ofrecerse 4.2 CONECTIVIDAD Se deberá establecer un periodo de pruebas de conectividad entre las partes para garantizar la misma entre los diferentes entornos. Página 30 de 38 Departamento: Sistemas Tipo: Programa: Autor(es): Orange-Euskatel Asunto: IT Cobertura & Activación Proyecto: Mutualización nueva red FTTH Euskatel Fecha: Estado: Abierto Código Documento: Revisión: En estas pruebas, deberá de verificarse los siguientes puntos: Acceso a IP y puerto desde el Origen al destino Verificación del certificado La conectividad deberá de habilitarse entre entornos, sin poder acceder desde Certificación a Producción ni viceversa: CERTIFICACION < > CERTIFICACION PRODUCCIÓN < > PRODUCCIÓN Cada parte dará visibilidad de dos entornos, uno el operativo y otro para pruebas. El objetivo, siempre que sea técnicamente viable, es utilizar el enlace actual entre ambas compañías. Cada parte habilitará un servicio “dummy” a efectos que la otra parte pueda lanzar pruebas contra este servicio y así probar tanto la conectividad con el control de acceso. Este Servicio Dummy debería de estar listo en la fase de Desarrollo (no en la fase de pruebas). Este servicio Dummy deberá de tener las siguientes características: La IP y puerto de acceso deberá ser igual que la IP y puerto que se configure para el resto de servicios. El certificado deberá ser el mismo que se vaya a usar para el entorno en el que se vaya a probar El servicio “dummy” deberá devolver siempre un OK en las llamadas que se realice. El objetivo principal del servicio es validar las comunicaciones e identificar los problemas habituales que se suelen en las comunicaciones entre sistemas. Se propone el WS de Reserva, ya que es el que tiene una estructura más sencilla. 4.3 PRUEBAS Ambas partes compartirán la estrategia de pruebas previamente a su realización. Respecto de los datos de pruebas, cada parte proveerá un fichero de cobertura con X nº de hogares, que servirá para que la otra parte ejecute las pruebas. Se habilitará una comunicación directa entre los equipos de desarrollo para agilizar cualquier duda o necesidad. Al inicio de las pruebas, cada parte designará un interlocutor único al objeto de cara a tener un punto de contacto para el seguimiento y obtener el soporte adecuado. Se compartirá la estrategia de pruebas y se determinará las fechas y horario de ejecución de las mismas. Página 31 de 38 Departamento: Sistemas Tipo: Programa: Autor(es): Orange-Euskatel Asunto: IT Cobertura & Activación Proyecto: Mutualización nueva red FTTH Euskatel Fecha: Estado: Abierto Código Documento: Revisión: El objetivo es que cada parte sea autónoma en la realización de pruebas y que obtenga el soporte adecuado de parte de la otra. POLÍTICA DE REINTENTOS 4.4 La política de reintentos recomendada al TU frente a time-outs en los webs services es utilizar reintentos cortos y reintentos largos, que se definen de la siguiente forma: 4.5 Nº de reintentos cortos: 3 reintentos. Periodo entre reintentos cortos: cada 60 segundos. Máx Nº de reintentos largos: 5 reintentos. Periodo entre reintentos largos: cada 30 minutos. SOPORTE A INCIDENCIAS Para soporte a las incidencias de IT, se habilitará un canal de comunicación vía email, teléfono y/o trouble ticketing para apertura de tickets. El canal telefónico tendrá un horario de 24x7. Se deberá desarrollar entre ambas partes un plan progresivo de gestión con el objetivo definitivo de comunicaciones prácticamente exclusivas (tanto para individuales como masivas) a través de los sistemas TT de cada compañía reutilizando en todo lo posible el escenario IT ya existente. Se adjunta tipificaciones propuestas a contemplar en los sistemas TT de ambos operadores: Tipificación USO FTTH_PROVISION_B2B_ACTIVACION En comunicación WS de ALTA errores Fxx FTTH_PROVISION_RANGED_NO_NAVEGA ONT sincronizado, pero no navega. Postventa: Cliente con lentitud, pérdida de calidad de los servicios. Postventa: +X clientes (>10) con lentitud en la misma CTO/PON, pérdida de calidad de los servicios. FTTH NORMAL-DEGRADACION-INDIVIDUAL FTTH NORMAL-DEGRADACION-MASIVA FTTH NORMAL-CORTE-INDIVIDUAL Postventa: Cliente con corte del servicio Postventa: +X clientes (>10) con corte del servicio en la FTTH NORMAL-CORTE-MASIVA CTO/PON Es un tema de SLA por clientes empresas o cliente VIP. FTTH PREMIUM-CORTE-INDIVIDUAL Actualmente no se aplica. Es un tema de SLA por clientes empresas o cliente VIP. FTTH PREMIUM-DEGRADACION-INDIVIDUAL Actualmente no se aplica. FTTH_PROVISION_B2B_RESERVA En comunicación WS de RESERVA errores Fxx FTTH_PROVISION Cajón de sastre por si en un futuro se decidiese utilizar Página 32 de 38 Departamento: Sistemas Tipo: Asunto: IT Cobertura & Activación Programa: Autor(es): Orange-Euskatel 4.6 Fecha: DISPONIBILIDAD OPERACIONES DE Proyecto: Mutualización nueva red FTTH Euskatel Estado: Abierto SERVICIOS Código Documento: IT PARA Revisión: SOPORTE DE Se definen los indicadores de disponibilidad de Servicios de IT para soporte de operaciones como el tiempo que han estado disponibles los servicios durante el periodo de observación de los mismos SERVICIOS Tipo KPI: Disponibilidad Subtipo % Servicios IT Disponibilidad de los servicios Online (%) 99,75% Servicios IT Tiempo Respuesta APIs < 10s 95% Se establece una disponibilidad de servicios basados en unos criterios de uso. La existencia de estos criterios permite que un hipotético uso incorrecto por parte del operador invoca el servicio no afecte a la medida de disponibilidad. Estos criterios se basan en los siguientes parámetros: Criterios Tipo Valor Subtipo Cantidad Invocaciones/Hora Número máximo de invocaciones por hora 3000 Concurrencia Número máximo de invocaciones en vuelo en la plataforma 10 Se establece un período de observación semanal con reporte mensual. Los criterios de uso deberán sufrir incrementos en función de la planta instalada del operador: Por cada incremento de 250.000 clientes, 1500 invocaciones por hora y 5 invocaciones en vuelo. Adicionalmente se podrá ampliar de manera semestral estos criterios de mutuo acuerdo entre las partes. Las medidas se realizarán en el sistema de integración. Ambas áreas de IT deberán definir e indicar en el documento un : nº máximo de solicitudes por segundo. Página 33 de 38 Departamento: Sistemas Tipo: Programa: Autor(es): Orange-Euskatel Asunto: IT Cobertura & Activación Proyecto: Mutualización nueva red FTTH Euskatel Fecha: Estado: Abierto Código Documento: Revisión: 5 ANEXOS ANEXO 1: EJEMPLOS DE CODIFICACIÓN DE DIRECCIONES 5.1 Ejemplo 1: Calle Fray Luis león,3 Portal 1 3ª C Campo Id-Finca Portal: O1 Planta: 003 Mano1: C<espacio><espacio><espacio> Ejemplo 2: Calle Fray Luis león,3 Portal 13 Atico Derecha Campo Id-Finca Portal: 13 Planta: AT<espacio> Mano1: DCHA Ejemplo 3: Calle Fray Luis león,3 Portal A 3ª C Campo Id-Finca Portal: OA Planta: 003 Mano1: C<espacio><espacio><espacio> Id-Finca Portal: 0A ERROR Ejemplo 4: Calle Fray Luis león,6 5ª A Campo Id-Finca Portal: <espacio><espacio> Planta: 005 Mano1: A<espacio><espacio><espacio> Ejemplo 5: Calle Fray Luis león,6 Bis Bloque 4 Almacén 3 Campo Bis/Duplicado: B Campo Bloque: B4<espacio> Planta: AL<espacio> Mano1: 3<espacio><espacio><espacio> Ejemplo 6: Calle Fray Luis león,6 Bis Bloque A1 Chalet Campo Bis/Duplicado: B Campo Bloque: BA1 Página 34 de 38 Departamento: Sistemas Tipo: Programa: Autor(es): Orange-Euskatel Asunto: IT Cobertura & Activación Proyecto: Mutualización nueva red FTTH Euskatel Fecha: Estado: Abierto Código Documento: Revisión: Planta: CH<espacio> Ejemplo7: Avenida Diagonal 56-58 Bis Bloque A1 Chalet Numero Via: 00056 Campo Bis/Duplicado: B Campo Bloque: BA1 Planta: CH<espacio> Nota: Se deberá generar otro registro con el 58 y marcar en el fichero el campo dummy para identificar que estos dos registros en realidad es un solo domicilio. Ejemplo 8 Calle Fray Luis león,Km 56 Ático Apartamento 16 Numero Via: 00000 Campo Bis/Duplicado: K Planta: AT<espacio> Mano1: APTO Mano2: 16<espacio><espacio> Observaciones: “texto libre” obligatorio. Ejemplo 9 Calle Fray Luis león,6 Escalera 3 5ª A Campo Id-Finca Portal: <espacio><espacio> Planta: 005 Escalera: 3<espacio> Mano1: A<espacio><espacio><espacio> Ejemplo 10 Calle Fray Luis león,6 2ª Despacho 4 Planta: 002 Mano1: DPCH Mano2: 4<espacio><espacio><espacio> Ejemplo 11 Calle Fray Luis león,6 Escalera Izquierda 5ª A Campo Id-Finca Portal: <espacio><espacio> Planta: 005 Escalera: V<espacio> Mano1: A<espacio><espacio><espacio> Página 35 de 38 Departamento: Sistemas Tipo: Programa: Autor(es): Orange-Euskatel 5.2 Asunto: IT Cobertura & Activación Proyecto: Mutualización nueva red FTTH Euskatel Fecha: Estado: Abierto ANEXO 2: CÓDIGOS DE OLT PROVINCIA Provincia OLT (código 3 caracteres) Provincia Código 3 caracteres Álava Albacete Alicante ALA ALB ALI Almería Asturias Ávila Badajoz Baleares Barcelona ALM AST AVI BAD BAL BAR Burgos Cáceres Cádiz Cantabria Castellón Ceuta BUR CAC CAD CAN CAS CEU Ciudad Real Córdoba Cuenca Gerona Granada Guadalajara CIU COR CUE GER GRA GUA Guipúzcoa Huelva Huesca Jaén La Coruña La Rioja GUI HLV HUE JAE LAC LAR Las Palmas León Lérida Lugo Madrid Málaga LAP LEO LER LUG MAD MAL Melilla Murcia MEL MUR Página 36 de 38 Código Documento: Revisión: Departamento: Sistemas Tipo: Programa: Autor(es): Orange-Euskatel NAV ORE Palencia Pontevedra Salamanca Santa Cruz Tenerife Segovia Sevilla Soria Tarragona PAL PON SAL Estado: Abierto Código Documento: Revisión: de TEN SEG SEV SOR TAR Teruel Toledo Valencia Valladolid Vizcaya Zamora TER TOL VAL VLD VIZ ZAM Zaragoza ZAR 5.3 Proyecto: Mutualización nueva red FTTH Euskatel Fecha: Navarra Orense Asunto: IT Cobertura & Activación ANEXO 4: PUNTOS CONJUTAMENTE DEL FORO A TRABAJAR/REVISAR 1 - ACTUALIZACION DE INVENTARIO EN TIEMPO DE INSTALACION No se plantea en fase inicial de proyecto mutualización un proceso automatizado de cambio de puerto en fase de instalación. No obstante, es un punto que debe evaluarse y resolverse en el OC. Desde el foro técnico, la recomendación pasa por crear un proceso operativo nuevo y consensuado entre ambos operadores, que se soporte con la creación de un nuevo webservice exclusivo para tal fin. El objetivo del webservice debe ser que además de articular el cambio en sistemas, permita, tanto al operador dueño de la red como al peticionario, actualizar la información de los inventarios donde definitivamente queda instalado el cliente. 2 - Puerto de CTO (Cerrado).: Ya contemplado actualmente en remedys y se mantendrá en mutualización. Se adjunta ejemplo: Página 37 de 38 Departamento: Sistemas Tipo: Programa: Autor(es): Orange-Euskatel Asunto: IT Cobertura & Activación Proyecto: Mutualización nueva red FTTH Euskatel Fecha: Estado: Abierto Código Documento: 4 – UATs: Proceso UATs y mecánica. Conectividades entornos pruebas – ASAP Certificados Equipos de soporte preparados Pruebas b2b Maqueta 5 – Conectividades Listado de IPs lado Orange Conectividad con entornos de pruebas: (pendiente) Conectividad con entornos de producción: (pendiente) Credenciales pendiente Listado de IPs lado Euskatel Conectividad con entornos de pruebas: (pendiente) Conectividad con entornos de producción: (pendiente) Credenciales pendiente Página 38 de 38 Revisión:
