Handleiding WIP diensten

Datum 27-2-2008

Versie 3.0

Handleiding WIP diensten

Datum rapport 21-02-2008 Versie 3.0

Inhoudsopgave 1

2

3

4

Inleiding

1

1.1

Doelstelling

1

1.2

Documentbeheer

1

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

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

WLR info producten

15

4.1

Statuscodes

15

4.2

WEB GUI

17

4.3

Beschikbaarheid

17

Datum 21-02-2008 Auteur KPN FB TIE Versie 3.0

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 Versie 0.1 0.2 1.0 2.0 2.1

Documentbeheer

Omschrijving Initiële versie Aanpassingen Definitieve versie Aanpassing diverse Aanpassing WIP1 aantal netlijnen

Error! Reference source not found.

Naam R. Martosatiman M. Das R vd Vlis R vd Vlis R vd Vlis

Datum 08-12-2006 08-01-2007 05-02-2007 26-3-2007 21-02-2008

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 WIP 1 WIP 2 WIP 3 WIP 4 WIP 5 WIP 6

Omschrijving

Beschikbaar 1 Interface

Online Offline

Respons

Information validation standard Information validation activities Information validation phone number Information validation addresses Information validation new line services Line measurement request

B2B + Web B2B + Web

Online Online

1 tot 3 seconden 1 tot 3 seconden

B2B + Web

Online

1 tot 3 seconden

B2B + Web

Online

1- 150 seconden

B2B + Web

Online

1 tot 3 seconden

Online

Ca. 120 seconden

B2B + Web

2

3

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 Cformulieren staan op de KPN Wholesale website: https://www.kpn-wholesale.com/ bij het onderwerp "register" boven het loginscherm.

3


3

Online WLR diensten

X

O

X

X

X

O

X

X

O

X

X

O

X

X X

O

O

Klachtcode

Huidig/Toekomstig

X

X

Aansluitpunt

Huisnummer toevoeging

X

CGB

Huisnummer

WIP 1 WIP 2 WIP 3 WIP 4 WIP 5 WIP 6

Postcode

WLR Information services

Telefoonnummer

In onderstaande tabel staat aangeven welke gegevens minimaal benodigd zijn per WLR Info Product.

X

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: Verplicht Type Telefoonnummer Ja 10 AN Huidig / toekomstig Ja 2 EN 0 = Niet van toepassing 1 = Huidig 2 = Toekomstig Aansluitadres Postcode Ja 6 AN Huisnummer Ja 5 AN Huisnummer toevoeging Nee 4 AN De volgende inputcombinaties zijn mogelijk: 1. Telefoonnummer + postcode + huisnummer 2. Telefoonnummer + postcode + huisnummer + huidig / toekomstig Veld

WIP 1 output: Veld Statuscode Aansluitadres Straatnaam Huisnummer Huisnummer toevoeging Postcode Woonplaats CGB naam verkort 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

Voorbeeld data 0103456789 1

1234AB 10 A

Verplicht Type Voorbeeld data Ja 2N 0 Nee 24 AN Coolsingel Nee 5 AN 10 Nee 4 AN A Nee 6 AN 1234AB Nee 24 AN Rotterdam Nee 16 AN Rt-C 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 Hoofdnummer Breedband aanwezig False = geen breedband aanwezig True = breedband aanwezig Optioneel blok (gevuld als breedband = True) Breedband telco Service-id breed band Hoge capaciteit Aantal netlijnen

Nee

2 EN 1

Nee 10 AN 0103456789 Nee B False

Nee 6 AN Nee 14 AN Nee B Nee AN

BSA ABC12345 Nee 00004

Rol Status

Nee Nee

1 AN R, H, M, D, O, T 1N 0,1 , 2

Faciliteit Status

Nee 30 AN blok service 0906 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: Veld

Telefoonnummer Aansluitadres Postcode Huisnummer Huisnummer toevoeging WIP 2 output: Veld Status code 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 Geplande datum

Verplicht Type Voorbeeld data Ja 10 AN 0103456789 Ja Ja Nee

6 AN 1234AB 5 AN 10 4 AN A

Verplicht Type Voorbeeld data Ja 2N 0 Nee B True

Nee

2 EN 1

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: Veld

Telefoonnummer Huidig / toekomstig 0 = Niet van toepassing 1 = Huidig 2 = Toekomstig De volgende inputcombinaties zijn mogelijk: 3. Telefoonnummer 4. Telefoonnummer + huidig / toekomstig

Verplicht Type Voorbeeld data Ja 10 AN 0103456789 Ja 2 EN 1

Bij inputcombinatie 1 heeft het veld huidig / toekomstig de waarde 0. Specificatie Output: Veld Status code Huidig / toekomstig 0 = Niet van toepassing 1 = Huidig 2 = Toekomstig 99 = Overig Aansluitadres Straatnaam Huisnummer Huisnummer toevoeging Postcode Woonplaats

Verplicht Type Voorbeeld data Ja 2N 0 Nee 2 EN 1

Nee 24 AN Coolsingel Nee 5 AN 10 Nee 4 AN A Nee 6 AN 1234Abv 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: Veld

CGB verkort* Aansluitadres Postcode Huisnummer Huisnummer toevoeging Aansluitpunt

Verplicht Type Voorbeeld data Nee 6AN KPN WSO-N Ja Ja Nee Nee

6 AN 5 AN 4 AN 3 AN

1234Abv 10 A 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: Veld

Status code Aantal aansluitingen op adres Aansluitingen informatie CGB verkort Huidig type aansluiting: 0 = Leeg 2 = telefonie 3 = MDF access 99 = Overig Huidig service-id Huidig telefoonnummer Toekomstig type aansluiting: 0 = Leeg 2 = telefonie 3 = MDF access 99 = Overig Toekomstig service-id Toekomstig telefoonnummer

Verplicht Type Voorbeeld data Ja 2N 0 Nee 5N 34 Nee Nee

6AN LLS-N 2 EN 0

Nee 14 AN ABC12345 Nee 10 AN 0103456789 Nee 2 EN 0

Nee 14 AN ABC12345 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: Veld

Telefoonnummer Huidig / toekomstig 0 = Niet van toepassing 1 = Huidig 2 = Toekomstig Aansluitadres Postcode Huisnummer Huisnummer toevoeging

Verplicht Type Voorbeeld data Nee 10 AN 0103456789 Ja 2 EN 0

Ja Ja Nee

6 AN 1234Abv 5 AN 10 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: Veld

Status code Aansluitadres Straatnaam Huisnummer Huisnummer toevoeging Postcode Woonplaats Huidig / toekomstig 0 = Niet van toepassing 1 = Huidig 2 = Toekomstig 99 = Overig Aantal aansluitpunten Aansluitpunt informatie CGB naam verkort Aansluitpunt nummer Aansluitpunt nummer toevoeging Aansluitpunt eindpunt plaats Aansluitpunt eindpunt plaats omschrijving

Verplicht Type Voorbeeld data Ja 2N 0 Nee 24 AN Coolsingel Nee 5 AN 10 Nee 4 AN A Nee 6 AN 1234AB Nee 24 AN Rotterdam Nee 2 EN 0

Nee

2N 1

Nee 16 AN Nee 3N Nee 3 AN Nee 4 AN Nee 14 AN

Rt-C 1 B01 GAK 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: Veld

Telefoonnummer Klachtcode Output: Veld Status code Lengte vanaf HVD in meters Weerstand A naar Aarde Weerstand B naar Aarde Weerstand A B Weerstand B A Capaciteit A naar Aarde Capaciteit B naar Aarde Capaciteit A B Capaciteit B A Meetvoltage Problem Domain KPN Bovengronds Klant

Verplicht Type Voorbeeld data Ja 10 AN 0103456789 Ja Geheel buiten dienst

Verplicht Type Ja 2N Nee 5N Nee 5N Nee 5N Nee 5N Nee 5N Nee 5N Nee 5N Nee 5N Nee 5N Nee 5N 2 AN

Voorbeeld data 0 871 5678 72 1234 5678 92 n 124 14 7 10 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 0 10 11 12 13 14 15 20 21

Feedback Ja Nee Nee Nee Nee Nee Nee Nee Nee

22 Ja 23 Ja 24 25 26 27

Ja Nee Nee Nee

28 Nee 29 Ja 30 Nee 31 Nee 32 33 40 41 50 51 60 61

Nee Nee Ja Ja Nee Nee Nee Nee

Beschrijving OK CGB naam verkort niet bekend Netnummer niet bekend Aansluitpunt niet bekend Meerdere aansluitpunten bekend op adres CGB naam verkort niet bekend bij adres Meerdere cgb's bekend bij adres telefoonnummer niet bekend telefoonnummer bekend, numeriek deel postcode onjuist Telefoonnummer bekend, numeriek deel postcode juist, alfanumeriek deel postcode wijkt af Telefoonnummer bekend, gehele postcode is juist, huisnummer wijkt af Telefoonnummer bekend, numeriek deel postcode juist, alfanumeriek deel postcode en huisnummer wijkt af Postcode en huisnummer niet bekend Postcode en huisnummer bekend, huisnummer toevoeging ontbreekt Postcode en huisnummer bekend, huisnummer toevoeging niet bekend Telefoonnummer bekend, geen adres bekend in netwerkadministratie, betreft mogelijk meervoudige aansluiting Adresgegevens komen niet overeen Overschrijding toegestane aantal orders van alle telco's per beperkte tijdsperiode Overschrijding toegestane aantal telco orders van 1 telco per beperkte tijdsperiode Dienstverlening automatisch geblokkeerd wegens overschrijding toegestane aantal telco orders per maand Dienstverlening handmatig geblokkeerd, navraag bij product eigenaar Aansluiting bekend, huisnummer toevoeging ontbreekt Aansluiting bekend, huisnummer toevoeging niet bekend Originator niet bekend Originator niet geautoriseerd Geen information request answer ontvangen Answer niet clean, syntax fout

15


62 76 80 85 86 87 88 90 91 97 98 99

Nee Nee Nee Ja Ja Ja Ja Nee Nee Nee Nee Nee

Answer niet clean, veld(en) niet gevuld Geen aansluiting gevonden bij de invoervelden Geen installed base van aanvragende telco aanwezig Lijnmeting niet OK, telefoonnummer niet bekend Lijnmeting niet OK, telefoonnummer in gesprek Lijnmeting niet OK, er is een time-out opgetreden Lijnmeting niet OK, systemen niet beschikbaar Systemen niet beschikbaar Geen antwoord mogelijk Postcode is onbekend Het gebruikte transaction-id is al bekend in ons systeem 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: [email protected]. Voor alle overige vragen kunt u terecht bij uw account manager.

17

Handleiding WIP diensten

Recommend Documents