Auteur AB TIE Versie 2.1. Interfacebeschrijving geautomatiseerde MIP diensten

12-11-2008 Auteur AB TIE Versie 2.1

Interfacebeschrijving geautomatiseerde MIP diensten


Inhoudsopgave

1

2

3

4

Inleiding

2

1.1

Doelstelling

2

1.2

Afkortingen

3

MIP+ algemeen

4

2.1

Leeswijzer

4

2.2

Overzicht aanvullend aanbod MDF informatie producten

4

2.3

Wijze van aanbieden

5

2.4

Web GUI

5

2.5

B2B koppeling

5

2.6

Toegang verkrijgen tot MIP dienstverlening

6

Online MIP diensten

7

3.1

MIP 7 Line test and line length

7

3.2

MIP 15a Information validation standard

3.3

MIP 15b Information validation current activities

10

3.3.1

MIP 15y Information validation phone number

12

3.3.2

MIP 15z Information validation addresses

13

3.4

MIP 16 information validation new line services

14

3.5

MIP 18a Installed base MDF

17

3.6

MIP 18b Installed base addresses

19

3.7

MIP 18c Installed base services

20

3.8

MIP 22 Meervoudige telefonie informatie

22

8

MIP+ producten

23

4.1

Statuscodes

23

4.2

B2B-koppeling

27

4.3

WEB GUI

27

4.4

Facturering

27

4.5

Beschikbaarheid

27

1


1

Inleiding

1.1

Doelstelling

Dit document beschrijft op logisch niveau de geautomatiseerde MDF Info Producten (MIP). Deze MIP producten zijn bedoeld om:  Verkoopproces van telco's te ondersteunen (MIP 7)  Clean order / validatie proces te ondersteunen (MIP 15a, 15b, 15y, 15z, 16, 22)  Installatie proces bij eindgebruikers ondersteunen (MIP 18a)  Navraag op installed base te ondersteunen (MIP 18a, 18b, 18c)

2


1.2

Afkortingen

Afkorting B2B HTTPS MIP NLS SOAP XML XSL XTL

Omschrijving Business to Business HyperText Transfer Protocol Secure MDF Info Product New Line Service Simple Object Access Protocol Extended Markup Language XDSL Shared Line XDSL Transmission Line

3


2

MIP+ algemeen

2.1

Leeswijzer

Dit hoofdstuk beschrijft per MIP 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 MDF informatie producten

MDF Info Product

Omschrijving

MIP 7

Line test and line length

MIP 15a MIP 15b

Information validation standard Information validation activities Information validation phone number Information validation addresses Information validation new line services Installed base information MDF Installed base information adresses Installed base information services Information phone number relations

MIP 15y MIP 15z MIP 16 MIP 18a MIP 18b MIP 18c MIP 22

Beschikbaa 1 r Interface

Online Offline

Respons

2

Online

Ca. 120 seconden

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

B2B + Web

Online

1 tot 3 seconden

B2B + Web

Online

1- 150 seconden

B2B + Web

Online

1 tot 3 seconden

B2B + Web

Online

1 tot 3 seconden

B2B + Web

1)

Gegevens zijn opvraagbaar middels een business-to-business koppeling én via de KPN-wholesale site. 2)

Gegevens via web aangevraagd worden, gezien de langere responstijd niet op het scherm getoond, maar naar de personal inbox van de medewerker van de telco verstuurd. De medewerker van de telco wordt hiervan, middels een mail, op de hoogte gesteld. 3) De responsetijden fluctueren afhankelijk van de hoeveelheid terug te koppelen gegevens. Bijvoorbeeld: MIP15z met 400 aansluitpuntgegevens zal een responsetijd kennen van rond de 150 seconden.

4


2.3

Wijze van aanbieden

Om een pre-qualificatie te kunnen uitvoeren voordat een telco een order plaatst bij Operator Toegang stelt W & O op gerichte vragen van telco's informatie uit haar systemen ter beschikking. Middels de prekwalificatie kan de telco vooraf een check uitvoeren of zij een clean order gaat inschieten, hierdoor kan de uitval in de interface tussen telco's en Operator Toegang voor het plaatsen van MDF orders worden beperkt. Information request Dit bericht wordt door telco's gestuurd naar W & O om gegevens van telefoon of MDF aansluitingen te verifiëren / op te vragen. Information request answer Dit bericht wordt door W & O naar telco terug gestuurd en bevat het antwoord op het information request van de telco. 2.4

Web GUI

Gebruikers van telco's kunnen mits zij daartoe geautoriseerd zijn opdrachten inschieten op de Ewholesale website van KPN. Het antwoord wordt online getoond aan de gebruiker (met uitzondering van MIP 7 in verband met de responstijd). Tevens wordt het antwoord in de personal inbox van de medewerker van de telco geplaatst. Zie voor verdere informatie de gebruikershandleiding voor de web GUI. 2.5

B2B koppeling

Telco kan vanaf zijn/haar web server berichten uitwisselen met web server van W & O. HTTPS, SOAP en XML de protocollen die door W & O worden gebruikt om de informatie uit te wisselen zodat MIP producten in een geautomatiseerd proces van telco's kunnen worden gebruikt. W & O heeft gekozen markt standaarden (XML en SOAP) voor web services te kiezen om kosten te minimaliseren en maximale compatibiliteit na te streven.

5


Telco

Public Internet

LLS

Information request

Start http(s) sessie

Vraag Information request answer Antwoord

End SOAP / XML berichten

XSD's waarin de XML berichten staan beschreven zijn toegevoegd in de bijlagen. Berichten ten behoeven van MIP diensten Nr. Omschrijving 1. MIPXX_request 2. MIPXX_respons

Verzender Telco KPN

Ontvanger KPN Telco

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)) Tevens wordt indien van toepassing de maximum toegestane lengte aangegeven. 2.6

Toegang verkrijgen tot MIP dienstverlening

Telco's dienen met KPN een contract af te sluiten voor gebruik van MIP diensten. Vervolgens moeten de MIP diensten middels een formulier worden aangevraagd. Deze formulieren staan op de KPN-wholesale website van KPN. https://www.kpn-wholesale.com/ onder het onderwerp "register" boven het loginscherm.

6


3

Online MIP diensten

3.1

MIP 7 Line test and line length

MIP7 geeft inzicht in kwaliteit en lengte vanaf de hoofdverdeler van een aansluitlijn. Input: Veld Telefoonnummer 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

Verplicht Type Voorbeeld data Ja 10 AN 0103456789

Vulling Ja Nee Nee Nee Nee Nee Nee Nee Nee Nee Nee

Type 2N 5N 5N 5N 5N 5N 5N 5N 5N 5N 5N

Voorbeeld data 0 871 5678 72 1234 5678 92 n 124 14 7 10

MIP7 verzoeken zijn niet mogelijk in geval van:  0800/0900 nummers  Mobiele nummers  PBX's  Kostentellers  Meervoudige aansluitingen en breedband aansluitingen Indicatie voor interpretatie waarden van weerstanden:  Weerstand waarden groter dan 10 M Ohm, werkende lijn  Weerstand waarden tussen 1 en 10 M Ohm, lichte fout, werkende lijn  Weerstand waarden kleiner dan 1 M Ohm, kans op storing Indicatie voor interpretatie waarden van capaciteit:  Waarden normaal circa 32 nF per kilometer

7


Algemeen:  Indien de lengte vanaf de HVD 0 is duidt dit op een fout in de aansluiting, veroorzaakt door het feit dat geen afstand te bepalen door een storing. Dit zijn niet alleen fouten rondom de HVD. 3.2

MIP 15a Information validation standard

MIP15a geeft inzicht in aansluitlijn gegevens met als doel het vergroten van het aantal clean MDF Access orders. MIP 15a input: Veld Telefoonnummer Huidig / toekomstig 0 = Niet van toepassing 1 = Huidig 2 = Toekomstig Service-id Aansluitadres Postcode Huisnummer Huisnummer toevoeging 1 Verplicht als service-id niet gevuld is anders leeg 2 Verplicht als telefoonnummer niet gevuld is anders leeg

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

2

Ja

Ja Ja Nee

14 AN ABC12345 6 AN 1234AB 5 AN 10 4 AN A

De volgende inputcombinaties zijn mogelijk: 1. Aansluitadres + telefoonnummer 2. Aansluitadres + telefoonnummer + huidig / toekomstig 3. Aansluitadres + service-id MIP 15a output: Veld Statuscode Aansluitadres Straatnaam Huisnummer Huisnummer toevoeging Postcode Woonplaats CGB naam verkort Diensttype Telefonie 0 = Enkelvoudig PSTN (EP)

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 0

8


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

Nee

2 EN 1

Nee

2 EN 0

Nee 10 AN 0103456789 Nee B False

Nee 6 AN BSA Nee 14 AN ABC12345

Notes:  Klanten verhuizen vaak binnen een zelfde netnummer gebied 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. Huidig / toekomstig situaties zijn alleen relevant bij aanvraag op basis van telefoonnummer.  Bij huidig / toekomstig situaties waarbij de telco het veld huidig/toekomstig niet heeft ingevuld worden standaard de toekomstige aansluitinggegevens opgevraagd (vaak de relevante situaties bij aanleg waarvoor MIP 15a is bedoeld bij aanvraag met het telefoonnummer in de input). Bij terugkoppeling wordt dan gemeld in het veld huidig / toekomstig aangegeven dat het de toekomstige situatie betreft.  MIP 15a vervangt het huidige MIP 15 product op KPN Wholesale site. De huidige versie (versie 1) van MIP 15 zal middels de B2B koppeling nog gedurende een periode van maximaal 6 maanden na de introductie van MIP 15a worden ondersteund.

9








3.3

Als bij opvragen op service-id geen telefoonnummer wordt teruggekoppeld betreft het een xTL aansluiting (volledige ontbundeling). Het veld diensttype telefonie zal in dat geval gevuld zijn met 'overig'. Er wordt door KPN alleen informatie teruggekoppeld als minimaal het telefoonnummer of serviceid en als numerieke deel van de postcode zoals door de telco opgegeven overeenkomt met de registratie van KPN. Bij inputcombinatie service-id zal het diensttype telefonie met 'overig' zijn gevuld. Overigens worden wel degelijk de telefonie gegevens in geval van linesharing aangeleverd.

MIP 15b Information validation current activities

MIP15b 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. MIP 15b input: Veld Verplicht Type 1 Telefoonnummer Ja 10 AN 2 Service-id Ja 14 AN Aansluitadres Postcode Ja 6 AN Huisnummer Ja 5 AN Huisnummer toevoeging Nee 4 AN 1 Verplicht als service-id niet gevuld is anders leeg 2 Verplicht als telefoonnummer niet gevuld is anders leeg

Voorbeeld data 0103456789 ABC12345 1234AB 10 A

De volgende inputcombinaties zijn mogelijk: 1. Aansluitadres + telefoonnummer 2. Aansluitadres + service-id MIP 15b 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

Verplicht Type Voorbeeld data Ja 2N 0 Nee B True

Nee

2 EN 1

10


4 = Verhuizing aanleg 5 = Verhuizing ophef 99 = Overig Plandatum mutatie

Nee

Date 10-03-2002

Note 1) Er worden alleen mutaties teruggekoppeld waarvan het telefoonnummer of service-id en het adres exact overeenkomen en er mutaties zijn. 2) De output van MIP15b is een groepering van de activiteiten + plandatum per aansluiting. Bij mutaties op meerdere aansluitingen op hetzelfde adres kunnen meerdere plandata voorkomen

11


3.3.1

MIP 15y Information validation phone number

MIP15y geeft adres gegevens van een telefoonaansluiting. MIP 15y input: Veld Telefoonnummer Huidig / toekomstig 0 = Niet van toepassing 1 = Huidig 2 = Toekomstig De volgende inputcombinaties zijn mogelijk: 1. Telefoonnummer 2. Telefoonnummer + huidig / toekomstig

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

Bij inputcombinatie 1 heeft het veld huidig / toekomstig waarde 0 heeft. 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 0

Nee 24 AN Coolsingel Nee 5 AN 10 Nee 4 AN A Nee 6 AN 1234Abv Nee 24 AN Rotterdam

Note Om misbruik te voorkomen zal MIP 15y slechts in beperkte aantallen opvraagbaar zijn voor telco.

12


3.3.2

MIP 15z Information validation addresses

MIP15z geeft telefonie en breedbanddiensten aan die op een adres geleverd worden. MIP 15z input: Veld Aansluitadres Postcode Huisnummer Huisnummer toevoeging CGB verkort Aansluitpunt

Verplicht Ja Ja Nee Nee Nee

Type 6 AN 5 AN 4 AN 6AN 3 AN

Voorbeeld data 1234Abv 10 A LLS-N 001

De volgende inputcombinaties zijn mogelijk: 1. Aansluitadres 2. Aansluitadres + aansluitpunt 3. Aansluitadres + CGB + Aansluitpunt MIP 15z output: Veld Status code Aantal aansluitingen op adres Aansluitingen informatie CGB verkort Huidig type aansluiting: 0 = Leeg 1 = VV 2 = TF 3 = MDF 99 = Overig Huidig service-id Huidig telefoonnummer Toekomstig type aansluiting: 0 = Leeg 1 = VV 2 = TF 3 = MDF 99 = Overig Toekomstig service-id Toekomstig telefoonnummer

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

6AN LLS-N 2 EN 2

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

Nee 14 AN ABC12345 Nee 10 AN 0103456789

13


Note: 

Alle aansluitingen zullen worden getoond.



Er wordt slechts informatie teruggekoppeld als het aansluitadres exact bekend is de KPN administratie.



Als er sprake is van gedeeld gebruik van een aansluiting (linesharing) zal het type aansluiting gevuld zijn als 3 (MDF) en zal zowel het telefoonnummer en het service-id gevuld zijn.



Een aansluiting waarop een dienst in aanleg is zal toekomstig getoond worden.



Daar waar velden Huidig en Toekomstig "leeg" (volledig lege regel) zijn is er geen mutatie bij KPN bekend, en kan de aansluiting gezien worden als een vrije ader die gebruikt kan worden voor oa een MDF aansluiting (NLS type 1).



Daar waar het veld 'type aansluiting' de waarde 2 (Telefonie) heeft en er is geen telefoonnummer gevuld in het veld 'huidig telefoonnummer' en de velden toekomstig zijn leeg, dan kan deze aansluiting gezien worden als een 'voorbereide aansluiting' of 'volledig voorbereide aansluiting', waarop oa een MDF aansluiting (NLS type 1) aangevraagd kan worden



Een aansluiting met status opheffen wordt niet getoond. Mutaties op aansluitingen worden getoond in MIP15b



Om misbruik te voorkomen zal MIP 15z slechts in beperkte aantallen opvraagbaar zijn voor een telco.

3.4

MIP 16 information validation new line services

MIP16 geeft inzicht in aansluitlijn gegevens met als doel het vergroten van het aantal clean MDF Access orders. MIP 16 input: Veld Telefoonnummer Huidig / toekomstig 0 = Niet van toepassing 1 = Huidig 2 = Toekomstig Aansluitadres Postcode Huisnummer

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

Ja Ja

6 AN 1234Abv 5 AN 10

14


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 adres exact overeenkomt.

15


MIP 16 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

Notes:  MIP 16 vervangt het huidige MIP 16 product op KPN Wholesale site. De huidige versie (versie 1) van MIP 16 zal middels de B2B koppeling nog gedurende een periode van maximaal 6 maanden na de introductie van MIP 16 worden ondersteund.  Alle aansluitingen zullen getoond worden.

16


3.5

MIP 18a Installed base MDF

MIP 18a input: Veld Verplicht Type Voorbeeld data 1 Service-id Ja 14 AN ABC12345 2 CGB-naam verkort Ja 15 AN Rt-C 2 Kast Ja 8 AN SIP AAB 2 Stijl Ja 3N 1 2 Cassette Ja 2N 2 2 Stift Ja 3 N 12 Ja 2 EN 0 Huidig / toekomstig 0 = Niet van toepassing 1 = Huidig 2 = Toekomstig 1 Verplicht als CGB-naam verkort + kast + stijl + cassette + stift niet gevuld zijn anders leeg 2 Verplicht als service-id niet gevuld is anders leeg Verplicht De volgende inputcombinaties zijn mogelijk: 1. Service-id 2. CGB-naam verkort + kast + stijl + cassette + stift 3. CGB-naam verkort + kast + stijl + cassette + stift + huidig / toekomstig Specificatie Output: Veld Status code Aansluitadres Straatnaam Huisnummer Huisnummer toevoeging Postcode Woonplaats Aansluitpunt informatie Aansluitpunt nummer Aansluitpunt nummer toevoeging Aansluitpunt eindpunt plaats Aansluitpunt eindpunt plaats omschrijving ISRA-stift CGB naam verkort Service-id

Verplicht Type Voorbeeld data Ja 2N 0 Nee 24 AN Coolsingel Nee 5 AN 10 Nee 4 AN A Nee 6 AN 1234Abv Nee 24 AN Rotterdam Nee 3N Nee 3 AN Nee 4 AN Nee 14 AN Nee 4N Nee 16 AN Nee 14 AN

1 B01 GAK Gangkast 0003 Rt-C ABC12345

17


Huidig / toekomstig 0 = Niet van toepassing 1 = Huidig 2 = Toekomstig 99 = Overig Diensttype MDF 1 = ASL 2 = ATL 3 = HTL 4 = ITL 5 = PTL 6 = STL 99 = Overig Status aansluiting: 0 = Gereserveerd voor aanleg 1 = In gebruik 2 = Gereserveerd voor ophef 99 = Overig Breedband stift gegevens Kast Stijl Cassette Stift Smalband stift gegevens (optioneel blok) Kast Stijl Cassette Stift SIP stift relatie type 1 = Niet van toepassing 2 = Exploitatief 3 = Voorraadvormend 99 = Overig Telefonie: False = geen telefonie op aansluitlijn aanwezig True = telefonie op aansluitlijn aanwezig Indien Telefonie = true Telefoonnummer

Nee

2 EN 0

Nee

2 EN 1

Nee

2 EN 1

Nee Nee Nee Nee

8 AN 3 AN 2 AN 3 AN

SIPAAA 001 02 012

Nee Nee Nee Nee Nee

8 AN 3 AN 2 AN 3 AN 2 EN

SIPAAB 001 02 012 3

Nee

B False

Nee 10 AN 0123456789

Note Er wordt alleen informatie teruggekoppeld als de aansluiting tot MDF installed base van de aanvragende telco behoort.

18


3.6

MIP 18b Installed base addresses

MIP18 geeft inzicht in diensten die door telco op een adres geleverd worden. MIP 18b input: Veld Aansluitadres Postcode Huisnummer Huisnummer toevoeging CGB verkort Aansluitpunt nummer

Verplicht Ja Ja Nee Nee Nee

Type 6 AN 5 AN 4 AN 6AN 3N

Voorbeeld data 1234AB 10 A LLS-N 1

De volgende inputcombinaties zijn mogelijk: 1. Aansluitadres 2. Aansluitadres + aansluitpunt 3. Aansluitadres + CGB+aansluitpunt MIP 18b output: Veld Status code Aantal aansluitingen op adres Aansluiting informatie CGB verkort Huidig diensttype MDF 1 = ASL 2 = ATL 3 = HTL 4 = ITL 5 = PTL 6 = STL 99 = Overig Huidig service-id 1 Huidig telefoonnummer Toekomstig diensttype MDF 1 = ASL 2 = ATL 3 = HTL 4 = ITL 5 = PTL

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

6AN LLS-N 2 EN 1

Nee 14 AN ABC12345 Nee 10 AN 0123456789 Nee 2 EN 1

19


6 = STL 99 = Overig Toekomstig service-id 1 Toekomstig telefoonnummer 1 Alleen gevuld als diensttype MDF is 1

Nee 14 AN ABC12345 Nee 10 AN 0123456789

Notes:  Er wordt alleen informatie teruggekoppeld als de aansluiting tot MDF installed base van de aanvragende telco behoort.  Een aansluiting waarop een dienst in aanleg is zal toekomstig getoond worden.  Daar waar velden toekomstig "leeg" zijn is er geen mutatie bij KPN bekend  Om misbruik te voorkomen zal MIP 18b slechts in beperkte aantallen opvraagbaar zijn voor een telco.  Alle aansluitingen zullen getoond worden. 3.7

MIP 18c Installed base services

MIP18c geeft inzicht in geleverde dienst gegevens door een telco op een adres met als doel het vergroten van het aantal clean MDF Access orders. MIP 18c input: Veld Telefoonnummer Huidig / toekomstig 0 = Niet van toepassing 1 = Huidig 2 = Toekomstig Service-id 1 Verplicht als service-id niet gevuld is anders leeg 2 Verplicht als telefoonnummer niet gevuld is anders leeg

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

Ja

2

14 AN ABC12345

De volgende logische inputcombinaties zijn mogelijk: 1. Telefoonnummer 2. Telefoonnummer + huidig / toekomstig 3. Service-id MIP 18c output: Veld Statuscode Aansluitadres Straatnaam

Verplicht Type Voorbeeld data Ja 2N 0 Nee 24 AN Coolsingel

20


Huisnummer Nee 5 AN 10 Huisnummer toevoeging Nee 4 AN A Postcode Nee 6 AN 1234AB Woonplaats Nee 24 AN Rotterdam Diensttype Telefonie Nee 2 EN 0 0 = Enkelvoudig PSTN (EP) 1 = Enkelvoudig ISDN (EI) 2 = Meervoudig PSTN (MP) 3 = Meervoudig ISDN (MI) 99 = Overig Huidig / toekomstig Nee 2 EN 0 0 = Niet van toepassing 1 = Huidig 2 = Toekomstig 99 = Overig Status aansluiting Nee 2 EN 0 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 Nee 10 AN 0103456789 Nee Breedband aanwezig B False False = geen breedband aanwezig True = breedband aanwezig Optioneel blok (gevuld als breedband = true) Breedband provider Nee 6 AN BSA Service-id breedband Nee 14 AN ABC12345 Notes  Er wordt alleen informatie teruggekoppeld als de aansluiting tot MDF installed base van de aanvragende telco behoort.  Als bij opvragen op service-id geen telefoonnummer wordt teruggekoppeld betreft het een xTL aansluiting (volledige ontbundeling). Het veld diensttype telefonie zal in dat geval gevuld zijn met 'overig'.

21


3.8

MIP 22 Meervoudige telefonie informatie

MIP22 geeft inzicht in samenhang van telefoonnummers op meervoudige aansluitingen. MIP 22 input: Veld Telefoonnummer Huidig / toekomstig 0 = Niet van toepassing 1 = Huidig 2 = Toekomstig

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

De volgende inputcombinaties zijn mogelijk: 1. Telefoonnummer 2. Telefoonnummer + huidig / toekomstig MIP22 output: Veld Status code Huidig / toekomstig 0 = Niet van toepassing 1 = Huidig 2 = Toekomstig 99 = Overig Hoofdnummer Diensttype Telefonie 0 = Enkelvoudig PSTN (EP) 1 = Enkelvoudig ISDN (EI) 2 = Meervoudig PSTN (MP) 3 = Meervoudig ISDN (MI) 99 = Overig Repeating group met gerelateerde nummers Telefoonnummer

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

Nee 10 AN 345678 Nee 2 EN 1

Nee 10 AN 345678

Notes  In de repeterende groep wordt nogmaals het hoofdnummer getoond.

22


4

MIP+ producten

4.1

Statuscodes

KPN 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 de in 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 Status code 0 10 11 12 13 14 15 20 21

Feedback Ja Nee Nee Nee Nee Nee Nee Nee Nee

MIP-Dienst Allen 18a 15a, 15y, 16, 18c, 22 15z, 18b 15z, 18b 15z, 18b 15z, 18b 15a, 15y, 16, 18c, 22 15a, 16

22

Ja

15a, 16

23

Ja

15a, 16

24

Ja

15a, 16

25 26

Nee Nee

15b, 15z, 16, 18b 15z, 16, 18b

27

Nee

15z, 16, 18b

28

Nee

15a, 16

Omschrijving 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

23


30

Nee

Allen

31

Nee

Allen

32

Nee

Allen

33

Nee

Allen

40

Ja

15a, 16

41

Ja

15a, 16

50 51 70 71

Nee Nee Nee Nee

Allen Allen 15a, 18c 15a

72

Ja

15a

73

Ja

15a

74

Ja

15a

75

Nee

18a

80

Nee

18a, 18b, 18c

85

Nee

7

86 87

Nee Nee

7 7

88 90 91 97 98

Nee Nee Nee Nee Nee

7 Allen Allen 15z, 16, 18b Allen

99

Nee

Allen

meervoudige aansluiting 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 Service-id niet bekend Service-id bekend, numeriek deel postcode onjuist Service-id bekend, numeriek deel postcode juist, alfanumeriek deel postcode wijkt af Service-id bekend, gehele postcode is juist, huisnummer wijkt af Service-id bekend, numeriek deel postcode juist, alfanumeriek deel postcode en huisnummer wijkt af SIP-identificatie onbekend 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 (mapping met back-end systemen geeft

24


onbekende waardes) 3

25


Note: 1

Bij blokkering wordt na een bepaalde tijdsperiode automatisch gereset en wordt toegepast om overige dienstverlening (beschikbaarheid van systemen) niet in gevaar te brengen. 2

Ter informatie. Bij deze status codes wordt in principe ook de applicatiebeheerder van KPN geïnformeerd. 3

Ter informatie. Bij deze status codes wordt in principe ook de applicatiebeheerder van KPN geïnformeerd. In deze gevallen zal namelijk worden onderzocht waardoor een onvoorziene situatie is ontstaan die middels tabel aanpassing naar een bestaande statuscode of mogelijk naar een nieuwe statuscodes moet worden vertaald. Als in de kolom "Feedback" een "N" staat dan betreft het een status waarbij KPN niet aanvullende informatie terugkoppelt. Dergelijke MIP aanvragen worden niet bij de telco in rekening gebracht. Als in de kolom "Feedback" een "J" staat dan betreft het een status waarbij KPN wel aanvullende informatie terugkoppelt. Dergelijke MIP aanvragen worden wel bij de telco in rekening gebracht.

26


Technische specificatie 4.2

B2B-koppeling

De WSDL files zijn beschikbaar op de site https://www.kpn-wholesale.com, keyword search WSDL. Tevens is een procedure-document beschikbaar om een B2B-connectie te realiseren op genoemde site, keyword search B2B. 4.3

WEB GUI

De in dit document beschreven diensten worden ook, overeenkomstig bestaande MIP producten, middels genoemde site aangeboden. Telco's dienen per gebruiker te beschikken over een Verisign client-certificaat en een TIE-userid + password. Deze kunnen worden aangevraagd middels een formulier op genoemde site. Klik op ‘register’ om de benodigde G- en C-formulieren te downloaden. Volg de instructies in de formulieren voor het indienen van de aanvraag..

4.4

Facturering

Het aantal afgenomen billable MIP diensten (zie statuscode tabel) zal maandelijks aan telco's worden gefactureerd. Afgenomen billable MIP diensten zullen per dienst apart op de factuur worden gemeld. 4.5

Beschikbaarheid

De beschikbaarheid van MIP dienstverlening wordt beschreven in Parameter Schedule van de MDF Access Services. De TIE Support Desk is het loket voor vragen met betrekking verstoringen van de MIP dienstverlening (040-2667751).

27

Auteur AB TIE Versie 2.1. Interfacebeschrijving geautomatiseerde MIP diensten

Recommend Documents