Datum 27-2-2008 Handleiding WIP diensten
Inhoudsopgave 1 Inleiding 1 1.1 Doelstelling 1 1.2 Documentbeheer 1 2 WIP algemeen 2 2.1 Leeswijzer 2 2.2 Overzicht aanvullend aanbod WLR informatie producten 2 2.3 Web GUI 2 2.4 B2B koppeling 2 2.5 Toegang verkrijgen tot WLR dienstverlening 3 3 Online WLR diensten 4 3.1 WIP 1 Information validation standard 5 3.2 WIP 2 Information validation current activities 8 3.3 WIP 3 Information validation phone number 9 3.4 WIP 4 Information validation addresses 10 3.5 WIP 5 information validation new line services 12 3.6 WIP 6 Line test and line length 14 4 WLR info producten 15 4.1 Statuscodes 15 4.2 WEB GUI 17 4.3 Beschikbaarheid 17
Datum Auteur KPN FB TIE 1 Inleiding 1.1 Doelstelling Dit document beschrijft op logisch niveau de geautomatiseerde Wholesale Line Rental Info Producten (WIP) die KPN in Q4 2006 introduceert. 1.2 Documentbeheer Omschrijving Naam Datum 0.1 Initiële versie R. Martosatiman 08-12-2006 0.2 Aanpassingen M. Das 08-01-2007 1.0 Definitieve versie R vd Vlis 05-02-2007 2.0 Aanpassing diverse R vd Vlis 26-3-2007 2.1 Aanpassing WIP1 aantal netlijnen R vd Vlis Error! Reference source not found. 1
2 WIP algemeen 2.1 Leeswijzer Dit hoofdstuk beschrijft per WIP dienst: De informatie die een telco moet invoeren (input); Welke mogelijke inputcombinaties zijn toegestaan indien van toepassing; De informatie die KPN terugkoppelt (output); 2.2 Overzicht aanvullend aanbod WLR informatie producten WLR Info Product Omschrijving Beschikbaar Interface 1 Online Offline Respons WIP 1 Information validation standard B2B + Web Online 1 tot 3 seconden WIP 2 Information validation activities B2B + Web Online 1 tot 3 seconden WIP 3 Information validation phone number B2B + Web Online 1 tot 3 seconden WIP 4 Information validation addresses B2B + Web Online 1-150 seconden 3 WIP 5 Information validation new line services B2B + Web Online 1 tot 3 seconden WIP 6 Line measurement request B2B + Web 2 Online Ca. 120 seconden 1) Gegevens zijn opvraagbaar middels een business-to-business koppeling én via de KPN-wholesale site. 2) Gegevens die via het web zijn aangevraagd, worden gezien de langere responstijd niet op het scherm getoond, maar naar de personal inbox van de medewerker van de telco verstuurd. 3) De responsetijden fluctueren afhankelijk van de hoeveelheid terug te koppelen gegevens. 2.3 Web GUI Gebruikers van telco s kunnen, mits zij daartoe geautoriseerd zijn, opdrachten inschieten op de KPN Wholesale website (https://www.kpn-wholesale.com/). Het antwoord wordt online getoond aan de gebruiker (met uitzondering van WIP 6 in verband met de responstijd). Tevens wordt het antwoord in de personal inbox van de medewerker van de telco geplaatst. 2.4 B2B koppeling Telco kan vanaf zijn/haar web server berichten uitwisselen met web server van KPN WSO. Voor meer informatie over de B2B-koppeling en protocollen kunt u contact opnemen met uw account manager. 2
2.5 Toegang verkrijgen tot WLR dienstverlening Telco's dienen met KPN WSO een contract af te sluiten voor gebruik van de WLR info diensten. Vervolgens moeten de WLR info diensten middels een formulier worden aangevraagd. Deze G- en C- formulieren staan op de KPN Wholesale website: https://www.kpn-wholesale.com/ bij het onderwerp "register" boven het loginscherm. 3
3 Online WLR diensten In onderstaande tabel staat aangeven welke gegevens minimaal benodigd zijn per WLR Info Product. WLR Information services Telefoonnummer Postcode Huisnummer Huisnummer toevoeging Huidig/Toekomstig CGB Aansluitpunt Klachtcode WIP 1 X X X O X WIP 2 X X X O WIP 3 X X WIP 4 X X O O O WIP 5 X X X O X WIP 6 X X X = Verplicht veld O = Optioneel veld Betekenis veldtype aanduiding: AN = Alpha numeriek B =Boolean true / false EN = enumerated N = numeriek SDT = standard date time (W3C format zonder optionele extentie (YYYY-MM-DDThh:mm:ss)) 4
3.1 WIP 1 Information validation standard De WIP 1 service geeft inzicht in aansluitlijn gegevens met als doel het vergroten van het aantal clean WLR Access orders. WIP 1 input: Telefoonnummer Ja 10 AN 0103456789 Huidig / toekomstig 0 = Niet van toepassing 1 = Huidig 2 = Toekomstig Aansluitadres Ja 2 EN 1 Postcode Ja 6 AN 1234AB Huisnummer Ja 5 AN 10 Huisnummer toevoeging Nee 4 AN A De volgende inputcombinaties zijn mogelijk: 1. Telefoonnummer + postcode + huisnummer 2. Telefoonnummer + postcode + huisnummer + huidig / toekomstig WIP 1 output: Statuscode Ja 2 N 0 Aansluitadres Straatnaam Nee 24 AN Coolsingel Huisnummer Nee 5 AN 10 Huisnummer toevoeging Nee 4 AN A Postcode Nee 6 AN 1234AB Woonplaats Nee 24 AN Rotterdam CGB naam verkort Nee 16 AN Rt-C Diensttype Telefonie 0 = Enkelvoudig PSTN (EP) 1 = Enkelvoudig ISDN (EI) 2 = Meervoudig PSTN (MP) 3 = Meervoudig ISDN (MI) 99 = Overig Huidig / toekomstig 0 = Niet van toepassing 1 = Huidig 2 = Toekomstig 99 = Overig Nee 2 EN Enkelvoudig PSTN (EP) Nee 2 EN 1 5
Status aansluiting 0 = In gebruik 1 = aanleg breedband 2 = aanleg telefonie 3 = ophef breedband 4 = ophef telefonie 5 = overige telefonie order 6 = Linesharing order 99 = Overig Nee 2 EN 1 Hoofdnummer Nee 10 AN 0103456789 Breedband aanwezig False = geen breedband aanwezig True = breedband aanwezig Optioneel blok (gevuld als breedband = True) Nee B False Breedband telco Nee 6 AN BSA Service-id breed band Nee 14 AN ABC12345 Hoge capaciteit Nee B Nee Aantal netlijnen Nee AN 00004 Rol Nee 1 AN R, H, M, D, O, T Status Nee 1N 0,1, 2 Faciliteit Nee 30 AN blok service 0906 Status Nee 1 AN 0, 1, 2 Notes: Omschrijving Rol: R= Roepnummer H= Hoofdnummer M=MSN-nummer D= Doorkiesreeks O= Onderlijn T= Telefoonnummer, zonder één van bovenstaande rollen. Klanten verhuizen vaak binnen een zelfde netnummergebied en behouden daarbij hun telefoonnummer. Dit heeft tot gevolg dat in de administratie van KPN het voorkomt dat één telefoonnummer in de KPN administratie op 2 aansluitadressen voorkomt, als 'huidig' (in dienst) op het oude adres van een klant en als 'toekomstig' (gereserveerd voor aanleg) op het nieuwe adres van een klant. Bij huidig / toekomstige situaties waarbij de telco het veld huidig/toekomstig niet heeft ingevuld worden standaard de toekomstige aansluitinggegevens opgevraagd. Bij terugkoppeling wordt dan gemeld in het veld huidig / toekomstig dat het de toekomstige situatie betreft. Er wordt door KPN alleen informatie teruggekoppeld als minimaal het opgegeven telefoonnummer en numerieke deel van de postcode overeenkomt met de registratie in de KPN administratie. 6
In het veld aantal netlijnen wordt het aantal netlijnen getoond van een meervoudige PSTN (MP) aansluiting of het aantal beschikbare kanalen bij een meervoudige ISDN (MI) aansluiting. 7
3.2 WIP 2 Information validation current activities De WIP 2 service geeft inzicht in mogelijke lopende activiteiten op een aansluiting. Indien er activiteiten zijn, wordt aangegeven wat voor een activiteit het betreft en op welke datum de activiteit zal worden uitgevoerd. WIP 2 input: Telefoonnummer Ja 10 AN 0103456789 Aansluitadres Postcode Ja 6 AN 1234AB Huisnummer Ja 5 AN 10 Huisnummer toevoeging Nee 4 AN A WIP 2 output: Status code Ja 2 N 0 Mutaties op aansluiting False = geen mutatie aanwezig True = mutatie aanwezig Mutatie informatie (maximaal 10 repeating groups) Type mutatie 1 = Aanleg 2 = Ophef 3 = Migratie 4 = Verhuizing aanleg 5 = Verhuizing ophef 99 = Overig Nee B True Nee 2 EN 1 Geplande datum Nee Date 10/03/2007 Note 1) Indien de additionele adresgegevens (huisnummertoevoeging) niet overeenkomen, verschijnt naast de outputgegevens ook de opmerking Adresgegevens komen niet overeen. 2) De output van WIP 2 is een groepering van de activiteiten + plandatum per aansluiting. Bij mutaties op meerdere aansluitingen op hetzelfde adres kunnen meerdere plandata voorkomen. 8
3.3 WIP 3 Information validation phone number De WIP 3 service geeft adresgegevens van een telefoonaansluiting. WIP 3 input: Telefoonnummer Ja 10 AN 0103456789 Huidig / toekomstig 0 = Niet van toepassing 1 = Huidig 2 = Toekomstig De volgende inputcombinaties zijn mogelijk: 3. Telefoonnummer 4. Telefoonnummer + huidig / toekomstig Ja 2 EN 1 Bij inputcombinatie 1 heeft het veld huidig / toekomstig de waarde 0. Specificatie Output: Status code Ja 2 N 0 Huidig / toekomstig 0 = Niet van toepassing 1 = Huidig 2 = Toekomstig 99 = Overig Aansluitadres Nee 2 EN 1 Straatnaam Nee 24 AN Coolsingel Huisnummer Nee 5 AN 10 Huisnummer toevoeging Nee 4 AN A Postcode Nee 6 AN 1234Abv Woonplaats Nee 24 AN Rotterdam 9
3.4 WIP 4 Information validation addresses De WIP 4 service geeft telefonie- en breedbanddiensten aan die op een adres geleverd worden. WIP 4 input: CGB verkort* Nee 6AN KPN WSO-N Aansluitadres Postcode Ja 6 AN 1234Abv Huisnummer Ja 5 AN 10 Huisnummer toevoeging Nee 4 AN A Aansluitpunt Nee 3 AN 001 De volgende inputcombinaties zijn mogelijk: 1. Aansluitadres 2. Aansluitadres + aansluitpunt 3. Aansluitadres + CGB + Aansluitpunt * Indien het CGB niet bekend is dan kan dit veld beter niet gevuld worden. 10
WIP 4 output: Status code Ja 2 N 0 Aantal aansluitingen op adres Nee 5N 34 Aansluitingen informatie CGB verkort Nee 6AN LLS-N Huidig type aansluiting: 0 = Leeg 2 = telefonie 3 = MDF access 99 = Overig Nee 2 EN 0 Huidig service-id Nee 14 AN ABC12345 Huidig telefoonnummer Nee 10 AN 0103456789 Toekomstig type aansluiting: 0 = Leeg 2 = telefonie 3 = MDF access 99 = Overig Nee 2 EN 0 Toekomstig service-id Nee 14 AN ABC12345 Toekomstig telefoonnummer Nee 10 AN 0103456789 Note: Er wordt slechts informatie teruggekoppeld als het aansluitadres exact bekend is de KPN administratie. Een aansluiting waarop een dienst in aanleg is, zal toekomstig getoond worden. 11
3.5 WIP 5 information validation new line services De WIP 5 service geeft inzicht in aansluitlijngegevens met als doel het vergroten van het aantal clean WLR Access orders. WIP 5 input: Telefoonnummer Nee 10 AN 0103456789 Huidig / toekomstig 0 = Niet van toepassing 1 = Huidig 2 = Toekomstig Aansluitadres Ja 2 EN 0 Postcode Ja 6 AN 1234Abv Huisnummer Ja 5 AN 10 Huisnummer toevoeging Nee 4 AN A Notes De volgende inputcombinaties zijn mogelijk: 1. Aansluitadres + (referentie) telefoonnummer 2. Aansluitadres + (referentie) telefoonnummer + huidig / toekomstig 3. Aansluitadres Bij inputcombinatie 1 en 3 wordt er vanuit gegaan dat het veld huidig / toekomstig waarde 0 heeft. Bij inputcombinatie 1 en 2 wordt slechts informatie teruggekoppeld als het telefoonnummer en minimaal het numerieke deel van de postcode exact overeenkomen. Bij inputcombinatie 3 wordt slechts informatie teruggekoppeld als de adresgegevens exact overeenkomen. 12
WIP 5 output: Status code Ja 2 N 0 Aansluitadres Straatnaam Nee 24 AN Coolsingel Huisnummer Nee 5 AN 10 Huisnummer toevoeging Nee 4 AN A Postcode Nee 6 AN 1234AB Woonplaats Nee 24 AN Rotterdam Huidig / toekomstig 0 = Niet van toepassing 1 = Huidig 2 = Toekomstig 99 = Overig Nee 2 EN 0 Aantal aansluitpunten Nee 2 N 1 Aansluitpunt informatie CGB naam verkort Nee 16 AN Rt-C Aansluitpunt nummer Nee 3 N 1 Aansluitpunt nummer toevoeging Nee 3 AN B01 Aansluitpunt eindpunt plaats Nee 4 AN GAK Aansluitpunt eindpunt plaats omschrijving Nee 14 AN Gangkast 13
3.6 WIP 6 Line test and line length De WIP 6 service geeft inzicht in kwaliteit en lengte vanaf de hoofdverdeler van een aansluitlijn. Input: Telefoonnummer Ja 10 AN 0103456789 Klachtcode Ja Geheel buiten dienst Output: Status code Ja 2 N 0 Lengte vanaf HVD in meters Nee 5 N 871 Weerstand A naar Aarde Nee 5 N 5678 Weerstand B naar Aarde Nee 5 N 72 Weerstand A B Nee 5 N 1234 Weerstand B A Nee 5 N 5678 Capaciteit A naar Aarde Nee 5 N 92 n Capaciteit B naar Aarde Nee 5 N 124 Capaciteit A B Nee 5 N 14 Capaciteit B A Nee 5 N 7 Meetvoltage Nee 5 N 10 Problem Domain KPN Bovengronds Klant 2 AN KPN Bovengronds WIP 6 verzoeken zijn niet mogelijk in geval van: 0800/0900 nummers Mobiele nummers PBX's Kostentellers Meervoudige aansluitingen en breedband aansluitingen 14
4 WLR info producten 4.1 Statuscodes KPN WSO zal in haar antwoord naar telco's altijd een statuscode meezenden die aangeeft hoe de transactie is verwerkt. Als de transactie succesvol is verwerkt, geeft de statuscode in een aantal gevallen aanvullende informatie over de mate waarin de door de telco opgegeven informatie overeenkomt met in de KPN systemen geregistreerde informatie. Als de transactie niet succesvol is verwerkt, geeft de statuscode de reden aan waarom de transactie niet succesvol kon worden verwerkt. Statuscodes in answer berichten Statuscode Feedback Beschrijving 0 Ja OK 10 Nee CGB naam verkort niet bekend 11 Nee Netnummer niet bekend 12 Nee Aansluitpunt niet bekend 13 Nee Meerdere aansluitpunten bekend op adres 14 Nee CGB naam verkort niet bekend bij adres 15 Nee Meerdere cgb's bekend bij adres 20 Nee telefoonnummer niet bekend 21 Nee telefoonnummer bekend, numeriek deel postcode onjuist Telefoonnummer bekend, numeriek deel postcode juist, alfanumeriek deel 22 Ja postcode wijkt af 23 Ja Telefoonnummer bekend, gehele postcode is juist, huisnummer wijkt af Telefoonnummer bekend, numeriek deel postcode juist, alfanumeriek deel 24 Ja postcode en huisnummer wijkt af 25 Nee Postcode en huisnummer niet bekend 26 Nee Postcode en huisnummer bekend, huisnummer toevoeging ontbreekt 27 Nee Postcode en huisnummer bekend, huisnummer toevoeging niet bekend Telefoonnummer bekend, geen adres bekend in netwerkadministratie, 28 Nee betreft mogelijk meervoudige aansluiting 29 Ja Adresgegevens komen niet overeen Overschrijding toegestane aantal orders van alle telco's per beperkte 30 Nee tijdsperiode Overschrijding toegestane aantal telco orders van 1 telco per beperkte 31 Nee tijdsperiode Dienstverlening automatisch geblokkeerd wegens overschrijding toegestane 32 Nee aantal telco orders per maand 33 Nee Dienstverlening handmatig geblokkeerd, navraag bij product eigenaar 40 Ja Aansluiting bekend, huisnummer toevoeging ontbreekt 41 Ja Aansluiting bekend, huisnummer toevoeging niet bekend 50 Nee Originator niet bekend 51 Nee Originator niet geautoriseerd 60 Nee Geen information request answer ontvangen 61 Nee Answer niet clean, syntax fout 15
62 Nee Answer niet clean, veld(en) niet gevuld 76 Nee Geen aansluiting gevonden bij de invoervelden 80 Nee Geen installed base van aanvragende telco aanwezig 85 Ja Lijnmeting niet OK, telefoonnummer niet bekend 86 Ja Lijnmeting niet OK, telefoonnummer in gesprek 87 Ja Lijnmeting niet OK, er is een time-out opgetreden 88 Ja Lijnmeting niet OK, systemen niet beschikbaar 90 Nee Systemen niet beschikbaar 91 Nee Geen antwoord mogelijk 97 Nee Postcode is onbekend 98 Nee Het gebruikte transaction-id is al bekend in ons systeem 99 Nee Overig 16
Note: 1 Bij blokkering wordt na een bepaalde tijdsperiode automatisch gereset. Dit wordt toegepast om overige dienstverlening (beschikbaarheid van systemen) niet in gevaar te brengen. 4.2 WEB GUI Telco's dienen per gebruiker te beschikken over een Verisign client-certificaat en een TIE-userid en password. Deze kunnen worden aangevraagd via een formulier op de KPN Wholesale website. Er is een gebruikershandleiding beschikbaar op de KPN Wholesale website. Deze kan ook bij uw accountmanager worden opgevraagd. 4.3 Beschikbaarheid De Atos TIE Support Desk is het loket voor het melden van incidenten met betrekking tot de WLR-dienstverlening (040-2667751). E-mailadres: GMNL-TIEsupport@atosorigin.com. Voor alle overige vragen kunt u terecht bij uw account manager. 17