Gebruikershandleiding Wholesale PreSelection
Gebruikershandleiding Wholesale PreSelection
versie 2.1 (december 2011)
Inhoudsopgave Inhoudsopgave ................................................................................................................................ 1 1 1.1
Inleiding ..................................................................................................................... 3 Doel van dit document .............................................................................................. 3
2 2.1 2.2 2.3
Toegang tot TIE .......................................................................................................... 4 Aanvragen autorisatie voor TIE .................................................................................. 4 Inloggen ..................................................................................................................... 4 Uitloggen .................................................................................................................... 5
3 3.1 3.2 3.3 3.4
Wholesale PreSelection ............................................................................................. 6 CPS order invoeren .................................................................................................... 6 Correctie batches ....................................................................................................... 6 Extra Batches ............................................................................................................. 7 Voortgang van de orders ........................................................................................... 7
4
WPS nummerinformatie ............................................................................................ 9
5 5.1 5.2
Storingen, incidenten en Trouble Tickets ................................................................ 10 Trouble Ticketing CPS via TIE ................................................................................... 10 Storingen en incidenten ........................................................................................... 11
6
Overzicht van foutmeldingen van TIE ...................................................................... 13
7 7.1 7.2 7.3 7.4
Wholesale PreSelection orderbestand .................................................................... 14 Formaat Wholesale PreSelection orderbestand ...................................................... 14 Gebruik velden ......................................................................................................... 15 Voorbeelden ............................................................................................................ 16 Validaties op ingestuurde bestanden ...................................................................... 17
8 8.1 8.2 8.3
Wholesale PreSelection resultaatbestand ............................................................... 19 Formaat Wholesale PreSelection resultaatbestand ................................................ 19 Gebruik velden ......................................................................................................... 21 Voorbeelden ............................................................................................................ 21
9 9.1 9.2
Specificatie A-nummer lijsten .................................................................................. 22 Specificaties "niet-gespecificeerde A-nummer Rapportage" .................................. 22 Specificaties "gespecificeerde A-nummer Rapportage" .......................................... 24
Gebruikershandleiding Wholesale PreSelection
versie 2.1 (december 2011)
1 Inleiding 1.1
Doel van dit document Deze gebruikershandleiding geeft uitleg over hoe een telco gebruik kan maken van de dienst Wholesale PreSelection (WPS). In deze handleiding gaan we er vanuit dat u bekend bent met de dienst CPS en het werken met internet browsers.
Gebruikershandleiding Wholesale PreSelection Versie 2.1 (december 2011)
3
2 Toegang tot TIE Om TIE te kunnen gebruiken, heeft de gebruiker een internetverbinding en Microsoft Internet Explorer (of een compatible browser) nodig.
2.1
Aanvragen autorisatie voor TIE U kunt zelf de benodigde formulieren downloaden vanaf de website en ingevuld opsturen naar uw accountmanager. U krijgt vervolgens per e-mail bericht dat een account voor u is aangemaakt.
2.2
Inloggen De TIE website is te openen via de KPN Wholesale website https://www.kpnwholesale.com/. Voer het adres in uw browser in en druk op enter. De startpagina van KPN Wholesale verschijnt nu op uw scherm. In de werkbalk klikt u nu op [Inloggen].
Vul in veld [login name] uw gebruikersnaam in, ga met TAB naar het veld [password] en vul uw wachtwoord in. Bevestig vervolgens uw invoer door op de knop [secure logon] te klikken. Bij een foutieve aanmelding verschijnt de volgende boodschap op het scherm: Login failed. Your account may be locked. Bevestig dit bericht door op de knop [ok] te klikken. Herhaal de inlogprocedure met de juiste gegevens om verder te gaan. Na 3x foutief inloggen wordt uw account geblokkeerd, u kunt dan contact opnemen met de Wholesale Service Desk om het probleem op te lossen. De services vermeld onder Processes kunt u gebruiken omdat u daarvoor bent aangemeld en van de services vermeld onder Other Processes kunt u alleen informatie opvragen omdat u daarvoor niet bent aangemeld.
Gebruikershandleiding Wholesale PreSelection Versie 2.1 (december 2011)
4
2.3
Uitloggen Voor het afsluiten van TIE Gateway moet u uitloggen. In het frame aan de linkerzijde kunt u uitloggen door op de knop [logoff] te klikken. Deze knop is alleen beschikbaar als u ingelogd bent op TIE Gateway.
Gebruikershandleiding Wholesale PreSelection Versie 2.1 (december 2011)
5
3 Wholesale PreSelection 3.1
CPS order invoeren Nadat u bent ingelogd op TIE Gateway en u heeft gekozen voor de service [Wholesale PreSelection] en [WPS Ordering] verschijnt het volgende scherm:
Middels een orderbestand kunt u per werkdag maximaal 5.500 CLI's aanbieden. In hoofdstuk 7 van deze handleiding vindt u het formaat volgens welke de reguliere orderbestanden moeten worden ingediend. De stappen om een Wholesale PreSelection order in te voeren zijn hieronder gegeven. 1. U kiest [Bladeren…] om de directory waarin u het orderbestand heeft geplaatst te selecteren en vervolgens het orderbestand aan te klikken. U kunt ook zelf het volledige pad invullen. 2. U kiest [Add] om het bestand toe te voegen aan de lijst. U kunt per prefix één order per dag aanbieden. De bestandsnaam verschijnt in de lijst, samen met het aantal CPS orderregels in uw orderbestand. U heeft de mogelijkheid om het zojuist toegevoegde bestand in te zien of te verwijderen. 3. U kunt [View] kiezen om het zojuist toegevoegde bestand in te zien. Mocht u niet het juiste bestand hebben gekozen, kiest u [delete] om het bestand uit de lijst te verwijderen. 4. Als u tevreden bent met de keuze van het bestand kiest u [Submit] om de Wholesale PreSelection order daadwerkelijk te verzenden. Na het invoeren van de Wholesale PreSelection order verschijnt een bevestiging.
3.2
Correctie batches Mocht u een CPS instelling ongedaan willen maken dan kunt u een correctiebatch aanleveren. Een correctiebatch dient per e-mail aangeboden te worden op het volgende adres:
[email protected]. Een correctiebatch moet in hetzelfde formaat worden aangeleverd als een reguliere batch. In het onderwerp van u mail neemt u de woorden "correctie batch" op. In de bestandsnaam dienen de letters CB tussengevoegd te worden op de volgende wijze: TELC-CB16XY-20110804.csv.
Gebruikershandleiding Wholesale PreSelection Versie 2.1 (december 2011)
6
In de naam van het bestand staat dus de prefix waarvan de a-nummers weggeschakeld moeten worden. In de bestandsregels moet U de prefixen invullen naar welke het telefoonnummer teruggeschakeld moet worden. Voor KPN kiest u 1655. Over de resultaten van de verwerking van uw correctiebatch wordt u per e-mail geïnformeerd. U mag meerdere correctie batches per dag insturen, mits de totale markt niet meer dan 1.000 cli's in stuurt. Als u voor 12.00 uur op een werkdag uw correctiebatch in stuurt, vindt de verwerking meestal binnen 24 uur plaats. Voor correctie batches geldt een afwijkend tarief.
3.3
Extra Batches Mocht u niet uitkomen met het aantal CLI's dat u kunt aanbieden via de reguliere batches (5.500 CLI's per werkdag) dan is er de mogelijkheid om in overleg een extra batch aan te leveren. Na overleg en afstemming met uw accountmanager kunt u de extra batch op de afgesproken dag per e-mail op sturen naar
[email protected]. Een extra batch moet in hetzelfde formaat worden aangeleverd als een reguliere batch. In de bestandsnaam dienen de letters EX tussengevoegd te worden op de volgende wijze: TELC-EX16XY-20110804.csv
3.4
Voortgang van de orders Terugkoppeling over de voortgang van CPS orders In de verwerking van een CPS order via TIE zijn de volgende stappen te herkennen: 1. Orderacceptatie door TIE (controle op formaat en gebruik prefix), terugkoppeling op het beeldscherm direct na invoeren. 2. Orderacceptatie (controle formaat, dubbele orders, lopende cps orders en postcode/huisnummer check), terugkoppeling via resultaatbestand via TIE 3. Orderacceptatie (controle op KPN abonnement, geschiktheid aansluiting, carrier select blokkering, lopende orders), terugkoppeling via een resultaatbestand via TIE. 4. Plaatsen van de CPS settings voor het gevraagde telefoonnummer, u ontvangt de terugkoppeling via de A-nummerrapportage per e-mail. De verzending van de Anummerlijst vindt elke werkdag s óchtends plaats. De voortgang van orders kan worden gevolgd in de TIE Inbox.
De resultaatbestanden worden in de Inbox geplaatst. U ontvangt een bevestiging van deze plaatsing per email. Voor het bekijken van de bestanden gaat u naar Processes en kiest daar voor Inbox. N.B. De Inbox verschijnt automatisch nadat u bent ingelogd. Indien er geen berichten in de Inbox staan verschijnt de volgende melding: There are no messages in your Inbox at this moment.
Gebruikershandleiding Wholesale PreSelection Versie 2.1 (december 2011)
7
Per service of process kunt u informatie bekijken door op de betreffende service te klikken. Wanneer u nogmaals op de service klikt dan klapt de inbox van de service weer dicht en kunt u desgewenst de inbox van een andere service openen. U kunt niet meer dan één inbox van een service tegelijkertijd openen. Opschonen van uw Mailbox U kunt een informatieverzoek met de status completed verwijderen door de box voor het betreffende informatieverzoek te selecteren en op de knop [Delete Marked Messages] te klikken.
Gebruikershandleiding Wholesale PreSelection Versie 2.1 (december 2011)
8
4 WPS nummerinformatie Met de WPS nummer informatie dienst kunt alle telefoonnummers opvragen die bij KPN bekend zijn van een eindgebruiker. U kunt alle telefoonnummers opvragen door één nummer van de eindgebruiker in te geven. WPS nummer informatie is op te vragen wanneer er binnen de TIE Gateway autorisatie is aangevraagd voor WPS.
Gebruikershandleiding Wholesale PreSelection Versie 2.1 (december 2011)
9
5 Storingen, incidenten en Trouble Tickets 5.1
Trouble Ticketing CPS via TIE Om een snellere afhandeling van vragen over instellingen via WPS mogelijk te maken, met minder kansen op fouten, is de functionaliteit Trouble Ticketing CPS op TIE geïntroduceerd. Trouble Ticketing is tevens bedoeld voor vragen over de inhoud en ontvangst van CPS a-nummerlijsten. Voor deze faciliteit moet naast de dienst WPS ook de dienst Trouble Ticketing aangekruist worden op het TIE Formulier G. Per Trouble Ticket kunt u één telefoonnummer opgeven of een groep telefoonnummers die bij één ITCIS nummer horen. Voor de dienst Trouble Ticketing via TIE kunnen per Telco meerdere gebruikers aangemeld worden, echter terugkoppeling vindt per Telco plaats naar 1 persoon.
Gebruikershandleiding Wholesale PreSelection Versie 2.1 (december 2011)
10
5.2
Storingen en incidenten TIE niet of maar beperkt bereikbaar, autorisatieproblemen Indien er een verstoring optreedt in de dienstverlening, wordt u daarvan op de hoogte gebracht via een melding op uw scherm. Voor Ondersteuning bij gebruikersvragen of incidenten over TIE kunt u terecht bij de Wholesale Service Desk (WSD). Storingen in het Trouble Ticket systeem dienen eerst (per e-mail) gemeld te worden bij de WSD. Email format (zie onderstaande tabel) voor TIE meldingen (in het Engels) opsturen naar:
[email protected] De telefonische ingang van de WSD Servicedesk is 0800-0307, vanuit het buitenland 00 31 35 6727803
Gebruikershandleiding Wholesale PreSelection Versie 2.1 (december 2011)
11
Probleem met CPS a-nummerlijsten Problemen met / vragen over CPS a-nummerlijsten dienen (per e-mail) gemeld te worden bij de WSD. Email format (zie onderstaande tabel) voor TIE meldingen (in het Engels) opsturen naar:
[email protected] De telefonische ingang van de WSD Servicedesk is 0800-0307, vanuit het buitenland 00 31 35 6727803 CPS a-number incident report (Please fill in English) Which Internet browser do you use? What is the version of your internet browser? Please add screenshot if possible.
Please add screen shot if possible
CPS prefix
16xy OR 10xyz
UserID for SFTP account
kpn-cps-16xy OR kpn-cps-10xyz
Password
(only for login issues)
Telco name Netcode / Operator code Phone number E-mail address Reference ticket number Complaint
Short description of problem
Category of the problem
1. Cannot login to the SFTP server 2. I have not received the CPS a-number report 3. Problem with the content of the a-number report 4. I have not received the specified CPS a-number report / problem with content specified a-number report 5. Other problem: …
Frequency of the problem Actions when error occurred Start date/time incident/error
Inhoudelijke vragen en problemen m.b.t. orders en informatie op de site Voor inhoudelijk vragen over de afhandeling van uw order, CPS a-nummerlijsten, de terugkoppeling op uw Trouble Ticket, kunt u terecht bij de Wholesale Service Desk (WSD 0800-0307). Voor vragen over uw contract, factuur en of de dienst WPS in zijn algemeen kunt u contact opnemen met uw accountmanager.
Gebruikershandleiding Wholesale PreSelection Versie 2.1 (december 2011)
12
6 Overzicht van foutmeldingen van TIE Melding Login failed: your account may be locked. To unlock, please contact the administrator Please contact the server’s administrator if this problem persists The Web server cannot find the file or script your asked for. Please check the URL to ensure that the path is correct. (N.B.: bovenstaande tekst is één mogelijkheid. De exacte tekst die op uw scherm zal verschijnen, is afhankelijk van de versie en taal van uw browser. De inhoud van de boodschap zal echter altijd vergelijkbaar zijn) Please specify a file before pressing Add. TIE Gateway webpage not found. Please contact KPN.
(A) Oorzaak (B) Oplossing (A) U heeft driemaal een onsuccesvolle inlogpoging gedaan. Uw account is vergrendeld. (B) Neem contact op met de Service Desk TIE. (A) Een dergelijke verstoring kan een aantal oorzaken hebben: 1. De TIE webserver is buiten gebruik; 2. Er is een probleem opgetreden in uw internettoegang; 3. Er is een probleem met uw provider. (B) Controleer of andere webpagina's wel bereikbaar zijn.. Andere internetpagina’s zijn ook niet opvraagbaar: Krijgt u bij het opvragen van een andere internetpagina dezelfde melding, dan wordt de storing niet veroorzaakt door de webserver van TIE. In dat geval zult u het probleem moeten aanmelden bij de verantwoordelijke organisatie, bijvoorbeeld uw netwerk operator of uw eigen storingsafdeling. Andere internetpagina’s wel opvraagbaar: Kunt u wel contact krijgen met een andere internetpagina dan is er waarschijnlijk een probleem met de TIE webserver. Neem dan contact op met de Service Desk TIE. (A) (B) (A) (B)
Unauthorised: your account is probably locked. Please contact the administrator. Undefined error.
(A)
Your request could not be completed at this time. Please try again or contact the KPN Helpdesk. Your session has become invalid. Close your browser and try again.
(A)
(B) (A) (B)
(B) (A) (B)
Gebruikershandleiding Wholesale PreSelection Versie 2.1 (december 2011)
U heeft geen bestandsnaam ingevoerd. Voer een bestandsnaam in. De gezochte webpagina is niet gevonden Indien u zelf het internetadres heeft ingetypt, controleer of dit correct is. Probeer de pagina nogmaals op te vragen. Blijft de foutmelding verschijnen, neemt u dan contact op met de Service Desk TIE.. U bent niet geautoriseerd voor deze actie of uw account is geblokkeerd. Indien u wel geautoriseerd bent voor deze actie; neem dan contact op met de Service Desk TIE. Er is een onverwachte fout opgetreden. Ga terug naar het vorige formulier door op de [BACK] knop te klikken en herhaal de actie. Neem contact op met de Service Desk TIE indien deze foutmelding zich blijft herhalen. TIE Gateway of het Wholesale PreSelection systeem van KPN is helaas niet beschikbaar. Herhaal de actie. Indien deze boodschap blijft verschijnen, neem dan contact op met de Service Desk TIE . De verbinding met TIE Gateway is verbroken. Sluit uw browser, start deze vervolgens weer op en log opnieuw in bij TIE Gateway. Blijft deze boodschap verschijnen, neem dan contact op met de Service Desk TIE.
13
7 Wholesale PreSelection orderbestand 7.1
Formaat Wholesale PreSelection orderbestand Het Wholesale PreSelection attachment bevat CPS orderregels waarbij in een regel de volgende velden zijn vereist: Format voor CPS-aanbieders die geen verkeerscategorie "Overig" aanbieden: Field Name
Format
Contents
VOLG_NUMMER
Alphanumeric (max. 25)
Volgnummer van de orderregel
A_NUMMER
Numeric (10)
A-nummer waarop de CPS beschakeling moet worden uitgevoerd
POST_CODE
Numeric (4)+ Alphanumeric(2)
Postcode behorend bij het Anummer*
HUIS_NUMMER
Numeric (max. 5)
Huisnummer behorend bij het Anummer*
PREFIX_INTERNATIONAAL
Numeric (5)
CPS prefix voor de categorie internationaal
PREFIX_BINNEN_BASIS
Numeric (5)
CPS prefix voor de categorie binnen basis
PREFIX_BUITEN_BASIS
Numeric (5)
CPS prefix voor de categorie buiten basis
PREFIX_VAST_MOBIEL
Numeric (5)
CPS prefix voor de categorie vastmobiel
Format voor CPS-aanbieders die ook verkeerscategorie "Overig" aanbieden: Field Name
Format
Contents
VOLG_NUMMER
Alphanumeric (max. 25)
Volgnummer van de orderregel
A_NUMMER
Numeric (10)
A-nummer* waarop de CPS beschakeling moet worden uitgevoerd
POST_CODE
Numeric (4)+ Alphanumeric(2)
Postcode behorend bij het Anummer**
HUIS_NUMMER
Numeric (max. 5)
Huisnummer behorend bij het Anummer**
PREFIX_INTERNATIONAAL
Numeric (5)
CPS prefix voor de categorie internationaal
PREFIX_BINNEN_BASIS
Numeric (5)
CPS prefix voor de categorie binnen basis
PREFIX_BUITEN_BASIS
Numeric (5)
CPS prefix voor de categorie buiten basis
PREFIX_VAST_MOBIEL
Numeric (5)
CPS prefix voor de categorie vast_mobiel
PREFIX_OVERIG
Numeric (5)
CPS prefix voor de categorie Overig (06760, 0800, 090x, 084, 087, semafonie, 00800)
Gebruikershandleiding Wholesale PreSelection Versie 2.1 (december 2011)
14
-
7.2
De naamgeving van een WPS orderbestand dient er als volgt uit te zien : [netcode telco]-[prefix]-[datum=JJJJMMDD].csv. Vb. TELC-1699-20110804.csv. Indien de naamgeving van het bestand niet correct is, kan de order niet worden verwerkt De velden in het WPS orderbestand moeten zijn gescheiden door puntkomma’s (;). De velden mogen inhoudelijk geen leestekens bevatten. Het WPS orderbestand moet tenminste één CPS orderregel bevatten. Het WPS orderbestand mag maximaal 5500 CPS orderregels bevatten. Elke CPS orderregel moet worden afgesloten met een carriage-return/line feed.
Gebruik velden VOLG_NUMMER :
Het gebruik van het volg_nummer is vrij. Door KPN wordt dit gegeven niet gebruikt. Met dit veld kunnen de CPS orders worden gekenmerkt.
A_NUMMER :
Bij een meervoudige aansluiting zal voor elk daar toe behorend telefoonnummer een CPS orderregel moeten worden aangemaakt.
POST_CODE:
De vier cijfers en de twee letters dienen zonder spatie ertussen te worden ingevuld Vb. 1111AB
HUIS_NUMMER :
Bij huisnummers met een toevoeging wordt alleen het numerieke deel van het huisnummer ingevuld. Vb. 14b invullen 14 , Bij een huisnummerreeks wordt altijd het laagst vermelde huisnummer ingevuld. Vb. 10-15 invullen 10.
PREFIX_INTERNATIONAAL :
Hierin wordt de gewenste prefix voor de categorie internationaal ingevuld. Indien dit veld leeg gelaten wordt zal de bestaande instelling voor deze categorie ongewijzigd blijven**.
PREFIX_BINNEN_BASIS :
Hierin wordt de gewenste prefix voor de categorie binnen_basis ingevuld. Indien dit veld leeg gelaten wordt zal de bestaande instelling voor deze categorie ongewijzigd blijven**.
PREFIX_BUITEN_BASIS :
Hierin wordt de gewenste prefix voor de categorie buiten_basis ingevuld. Indien dit veld leeg gelaten wordt zal de bestaande instelling voor deze categorie ongewijzigd blijven**.
PREFIX_VAST_MOBIEL :
Hierin wordt de gewenste prefix voor de categorie vast_mobiel ingevuld. Indien dit veld leeg gelaten wordt zal de bestaande instelling voor deze categorie ongewijzigd blijven**.
PREFIX_OVERIG :
Hierin wordt de gewenste prefix voor de categorie Overig ingevuld. Indien dit veld leeg gelaten wordt zal de bestaande instelling voor deze categorie ongewijzigd blijven**.
Gebruikershandleiding Wholesale PreSelection Versie 2.1 (december 2011)
15
* De in het orderbestand ingevulde postcode/huisnummer combinatie zal worden gecontroleerd tegen het bij KPN bekende contractantadres, vestigingsadres en factuuradres behorend bij het ingevoerde telefoonnummer. Wanneer de ingevoerde postcode/huisnummer/telefoonnummer combinatie overeenkomt met de gegevens uit minimaal één van de drie genoemde adresbestanden worden deze geaccepteerd.
** CPS orders waarbij geen van de verkeerscategorieën zijn ingevuld, zullen worden teruggekoppeld met de resultaatcode 011 (reeds beschakeld naar gevraagde prefix)
7.3
Voorbeelden Hieronder volgt een aantal inhoudelijk voorbeelden van CPS orderregels uit een Wholesale PreSelection bestand:
Alle categorieën worden geschakeld naar prefix 1699 voor een CPS-aanbieder die geen categorie Overig aanbiedt: SCR00012;0105643561;3422AA;14;1699;1699;1699;1699
Alle categorieën worden geschakeld naar prefix 1699 voor een CPS-aanbieder die ook categorie Overig aanbiedt: SCR00212;0105643549;3103CC;9;1699;1699;1699;1699;1699
De categorie internationaal blijft ongewijzigd en alle overige categorieën worden geschakeld naar prefix 1699 voor een CPS-aanbieder die geen categorie Overig aanbiedt: SCR00234;0205623551;1002DD;324;;1699;1699;1699
De categorie vast_mobiel blijft ongewijzigd en alle overige categorieën worden geschakeld naar prefix 1699 voor een CPS-aanbieder die geen categorie Overig aanbiedt: AW100012;0735643563;6390SS;374;1699;1699;1699;
De categorie binnen_basis en buiten_basis blijven ongewijzigd en alle overige categorieën worden geschakeld naar prefix 1699 voor een CPS-aanbieder die geen categorie Overig aanbiedt: S1R00012;0355663361;9812WE;6;1699;;;1699
De categorie Overig wijzigt naar prefix 1699, terwijl de andere categorieën niet wijzigen voor een CPS-aanbieder die ook categorie Overig aanbiedt: S1R00014;0355665432;9810GH;3;;;;;1699
Tip: Beschreven bestandsformaat kan worden gegeneerd met Microsoft Excel door elk beschreven veld in een kolom te plaatsen en vervolgens menu-item "Opslaan als…" in menu "Bestand" te kiezen en het bestand op te slaan in het formaat "CSV (MS-DOS) (*.csv)".
Gebruikershandleiding Wholesale PreSelection Versie 2.1 (december 2011)
16
7.4
Validaties op ingestuurde bestanden
Filenaamonderdeel
Omschrijving
TELCO
Bevat de netcode van de telco.
PREFIX
Bevat de prefix waar het bestand voor ingeschoten wordt. Als het bestand wordt ingeschoten via LDO zijn er verschillende mogelijkheden: of een CB (correctiebatch) of een EX (extra-batch). In het geval van een EX of CB staat de prefix van de telco achter de EX/CB (dus bijvoorbeeld EX1620). Hiernaast is het ook mogelijk dat er voor EX of CB batches nog een code na de prefix staat, bijvoorbeeld EX1611AC. Dit wordt gebruikt in het factureringsproces. Voor de controles worden alle niet-numerieke waarden uit dit veld gehaald. Het is dan ook belangrijk om nooit een batch in te schieten als EX1611E7. Dit vertaald de programmatuur naar een prefix 16117.
YYYYMMDD
Jaar maand dag, waarop het bestand wordt ingediend, bijvoorbeeld 20110701 voor 1 juli 2011
De volgende validaties worden uitgevoerd op de bestandsnaam: Validatie
Omschrijving
Foutcode
Environment
Controle of de omgeving ok is.
[POLLING] Can not admin in directory :
Filename-length
Lengte van filename minimaal 16 chars.
Filename must be at least x characters and have the format : Telco-cpsprefix-yyyyMMdd.csv .
TELCO in Filename
Netcode moet overeenkomen met netcode in autorisatie.
The telco code in the filename does not match your telco (...).
Extensie in Filename
Extensie moet csv of CSV zijn.
The filename must end with csv.
YYYMMDD in Filename
YYYMMDD moet de datum van vandaag zijn.
The date in the filename is not correct.
General format in filename
Check op het algemene format.
The filename is not correct, it should be like Telco-cpsprefixyyyyMMdd.csv .
PREFIX in Filename
Controle op de prefix in filename. Deze moet bij de netcode behoren indien cps-prefix-check op true staat.
Submitted prefix PREFIX is not a valid prefix for TELCO
Duplicate
Controle of het bestand al eerder is geupload.
File already exists, file upload limit exceeded.
Gebruikershandleiding Wholesale PreSelection Versie 2.1 (december 2011)
17
Hierna wordt de inhoud van het bestand gevalideerd. Validatie van een normale batch: Validatie
Omschrijving
Foutcode
Prefix authorisation
Controle op voorkomen van prefix in de filename bij de netwerkcode
The prefix in the file (PREFIX) is not authorised for file
Prefix check
Een in de batch voorkomende prefix moet overeenkomen met de prefix in de filename
No authorisation for prefix PREFIX on line x.
Prefix position
Er moeten het aantal geconfigureerde prefixen aangeboden worden.
Not enough or too many fields on linenumber x.
File size
File moet minimaal 1 record bevatten van meer dan 5 tekens.
File is empty. Processing not started and upload failed.
File size
File bevat meer dan 5500 regels.
Filesize is too large. No more than 5500 recs are allowed.
Validatie van een extra batch: Validatie
Omschrijving
Foutcode
Prefix authorisation
Controle op voorkomen van prefix in de filename (zonder EX) bij de netwerkcode
The prefix in the file (PREFIX) is not authorised for file
Prefix check
Een in de batch voorkomende prefix moet overeenkomen met de prefix in de filename (zonder EX,)
No authorisation for prefix PREFIX on line x.
Prefix position
Er moeten het aantal geconfigureerde prefixen aangeboden worden.
Not enough or too many fields on linenumber x.
File size
File moet minimaal 1 record bevatten van meer dan 5 tekens.
File is empty. Processing not started and upload failed.
File size
File bevat meer dan 5500 regels.
Filesize is too large. No more than 5500 recs are allowed.
Gebruikershandleiding Wholesale PreSelection Versie 2.1 (december 2011)
18
8 Wholesale PreSelection resultaatbestand 8.1
Formaat Wholesale PreSelection resultaatbestand Het resultaat van een WPS order zal via de Inbox module in TIE worden teruggekoppeld. De terugkoppeling gebeurt in stappen. Als eerste ontvangt u het result_05.csv bestand waarin we de foutmeldingen met betrekking tot dubbele records, formaat fouten, lopende orders en postcode/huisnummercheck terugkoppelen. Vervolgens ontvangt u het result_01.csv bestand waarin u een totaaloverzicht vindt van fout en acceptatiecodes. Het result_01.csv bestand heeft een langere doorlooptijd, en kan afhankelijk van de drukte in de leverstraat 2 werkdagen duren. Format resultaatbestand voor CPS aanbieder die geen categorie Overig aanbiedt: Field Name
Format
Contents
VOLG_NUMMER
Alphanumeric (max. 25)
Een volgnummer van de orderregel = waarde uit het orderbestand
A_NUMMER
Numeric (10)
A-nummer waar de CPS beschakeling moet worden uitgevoerd
POST_CODE
Numeric (4)+ Alphanumeric(2 )
Postcode = waarde uit het orderbestand
HUIS_NUMMER
Numeric (max. 5)
Huis nummer = waarde uit het orderbestand
PREFIX_INTERNATIONAAL
Numeric (5)
CPS prefix voor de categorie internationaal = waarde uit het orderbestand
PREFIX_BINNEN_BASIS
Numeric (5)
CPS prefix voor de categorie binnen basis = waarde uit het orderbestand
PREFIX_BUITEN_BASIS
Numeric (5)
CPS prefix voor de categorie buiten basis = waarde uit het orderbestand
PREFIX_VAST_MOBIEL
Numeric (5)
CPS prefix voor de categorie vast_mobiel = waarde uit het orderbestand
RESULTAAT_CODE_1
Numeric (3)
Resultaatcode uit de CPS leverstraat bij order-intake
RESULTAAT_CODE_2
Numeric (3)
Wordt niet meer gebruikt. Als u hier een waarde aantreft wordt u verzocht een incident aan te maken. Dit veld wordt met de waarde "000" gevuld indien het vorige veld RESULTCODE_CODE_1 ook gevuld is met "000" (= communicatie fout in de interface)
DATUM_AANGEBODEN
Date (DD-MMYYYY)
Datum waarop de CPS order is aangeboden aan de CPS leverstraat.
Gebruikershandleiding Wholesale PreSelection Versie 2.1 (december 2011)
19
Format resultaatbestand voor CPS aanbieder die ook categorie Overig aanbiedt: Field Name
Format
Contents
VOLG_NUMMER
Alphanumeric (max. 25)
Een volgnummer van de orderregel = waarde uit het orderbestand
A_NUMMER
Numeric (10)
A-nummer waar de CPS beschakeling moet worden uitgevoerd
POST_CODE
Numeric (4)+ Alphanumeric(2 )
Postcode = waarde uit het orderbestand
HUIS_NUMMER
Numeric (max. 5)
Huis nummer = waarde uit het orderbestand
PREFIX_INTERNATIONAAL
Numeric (5)
CPS prefix voor de categorie internationaal = waarde uit het orderbestand
PREFIX_BINNEN_BASIS
Numeric (5)
CPS prefix voor de categorie binnen basis = waarde uit het orderbestand
PREFIX_BUITEN_BASIS
Numeric (5)
CPS prefix voor de categorie buiten basis = waarde uit het orderbestand
PREFIX_VAST_MOBIEL
Numeric (5)
CPS prefix voor de categorie vast_mobiel = waarde uit het orderbestand
PREFIX_OVERIG
Numeric (5)
CPS prefix voor de categorie Overig (06760, 0800, 090x, 084, 087, semafonie)
RESULTAAT_CODE_1
Numeric (3)
Resultaatcode uit de CPS leverstraat bij order-intake
RESULTAAT_CODE_2
Numeric (3)
Wordt niet meer gebruikt. Als u hier een waarde aantreft wordt u verzocht een incident aan te maken. Dit veld wordt met de waarde "000" gevuld indien het vorige veld RESULTCODE_CODE_1 ook gevuld is met "000" (= communicatie fout in de interface)
DATUM_AANGEBODEN
Date (DD-MMYYYY)
Datum waarop de CPS order is aangeboden aan de CPS leverstraat.
-
De naamgeving van een resultaat bestand is als volgt: [netcode telco]-[prefix][datum=JJJJMMDD]_ result_xx.csv (xx = 01 of 05) De velden in het WPS resultaatbestand zijn gescheiden door puntkomma’s (;). Elke CPS orderregel is afgesloten met een carriage-return/line feed.
Gebruikershandleiding Wholesale PreSelection Versie 2.1 (december 2011)
20
8.2
Gebruik velden RESULTAAT_CODE_1 :
Code 000 003 004 006 007 008 011 100 101 102 103 200
8.3
Hierin staan de resultaatcodes die door de CPS leverstraat zijn teruggekoppeld. De volgende resultaatcodes voor het veld RESULTAAT_CODE_1 zijn gedefinieerd:
Betekenis Communicatie fout Geen KPN abonnement Aansluiting ongeschikt Order geaccepteerd Lopende opdracht op aansluiting CPS blokkering Reeds beschakeld naar gevraagde prefix Order voldoet niet aan het juiste formaat Order komt reeds eerder voor in orderbestand Lopende CPS opdracht Afwijzing op basis van Postcode huisnummer check Order in onderzoek
Voorbeelden Hieronder volgen een aantal inhoudelijk voorbeelden die kunnen voorkomen in een Wholesale PreSelection resultaatbestand:
Voorbeelden voor een CPS aanbieder die geen categorie Overig aanbiedt:
SCR00012;0105643561;3422AA;14;1655;1655;1655;1655;006;;04-08-2011 AW100012;0735643563;6390SS;374;1655;1655;1655;;007;;04-08-2011
Voorbeelden CPS aanbieder die ook categorie Overig aanbiedt:
SCR00012;0105643561;3422AA;14;1655;1655;1655;1655;1655;006;;04-08-2011 AW100012;0735643563;6390SS;374;1655;1655;1655;;;007;;04-08-2011
Gebruikershandleiding Wholesale PreSelection Versie 2.1 (december 2011)
21
9 Specificatie A-nummer lijsten 9.1
Specificaties "niet-gespecificeerde A-nummer Rapportage" Het bestand bestaat uit één header, detail en trailerrecord. De velden worden door puntkomma’s gescheiden: “character separated values”.
Header: Nr
Veldnaam
Veldtype
Lengte
Beschrijving waarde
1
Type_bestand
AN
12
Bevat de waarde “CPS verslag”
2
Prefix_1
N
6
Prefix van de betreffende telco
3
Datum
N
8
Datum verwerking
4
Clausule_1
AN
52
Bevat; “alleen voor gebruik t.b.v. technisch dienstenbeheer”
Beschrijving waarde
Detailrecord: Nr
Veldnaam
Veldtype
Lengte
1
CPS_schakeling
N
1
2
A_nummer
N
10
A_nummer volgens-notatie met netnummer en abonneenummer
3
Tijd
N
4
tijdstip van schakeling op die dag
Waarde-indicatie “1” betekent activatie Waarde-indicatie “9” betekent deactivatie
internationaal=”2" biba= “3” 4
CPS_categorie
N
1
buba=”4” vamo= “5” overig=”6”
Gebruikershandleiding Wholesale PreSelection Versie 2.1 (december 2011)
22
Trailerrecord: Nr
Veldnaam
Veldtype
Lengte
Beschrijving waarde
1
Trailer_type
AN
12
Bevat de waarde “CPS trailer”
2
Prefix_2
N
6
Prefix van de betreffende telco bijv. “1602”
3
Aantal_biba_aan
N
8
Totaal aantal biba aan
4
Aantal_buba_aan
N
8
Totaal aantal buba aan
5
Aantal_vamo_aan
N
8
Totaal aantal vast mobiel aan
6
Aantal_int_aan
N
8
Totaal aantal internationaal aan
7
Aantal-ov-aan
N
8
Totaal aantal overig aan
8
Aantal_biba_uit
N
8
Totaal aantal biba uit;
9
Aantal_buba_uit
N
8
Totaal aantal buba uit;
10
Aantal_vamo_uit
N
8
Totaal aantal vast mobiel uit;
11
Aantal_int_uit
N
8
Totaal aantal internationaal uit;
12
Aantal_ov_uit
N
8
Totaal aantal overig uit;
13
Clausule_2
AN
52
Clausule bevat: “ alleen voor gebruik t.b.v. technisch dienstenbeheer”
Geen prefix-wijzigingen Indien er géén prefix-wijzigingen aanwezig zijn voor een te leveren bestand, wordt er een bestand geleverd met alleen header en trailer. Sortering Het bestand wordt niet op veldnaam gesorteerd.
Gebruikershandleiding Wholesale PreSelection Versie 2.1 (december 2011)
23
9.2
Specificaties "gespecificeerde A-nummer Rapportage" Het bestand bestaat uit één header, detail en trailerrecord. Het bestand heeft geen vaste lengte, de velden zijn d.m.v. een puntkomma gescheiden: “character separated values”. De regel is niet afgesloten met een puntkomma.
Header record: attribuut
veldty pe
posit ie
omschrijving
Titel
CHAR
n.v.t.
"CPS verslag"
Prefix
CHAR
n.v.t.
Prefix waarover wordt gerapporteerd (16xy of 10xyx)
Datum rapportage
CHAR
n.v.t.
De datum waarover gerapporteerd wordt. Formaat: YYYYMMDD
Notitie
CHAR
n.v.t.
"alleen voor gebruik t.b.v. technisch dienstenbeheer"
attribuut
veldty pe
posit ie
omschrijving
Schakelrichting
CHAR
n.v.t.
Telefoonnummer
CHAR
n.v.t.
Het 10-cijferige telefoonnummer
Datum/Tijdstip
CHAR
n.v.t.
YYYYMMDDHHMMSS (HH is 24 uurs)
Detail record:
"1" er wordt naar de prefix toe geschakeld = activatie "9" er wordt van de prefix weg geschakeld = deactivatie
2 = Internationaal; 3 = BinnenBasis; Verkeerssoort
CHAR
n.v.t.
4 = BuitenBasis; 5 = VastMobiel 6 = Overig
Oorzaak CPS mutatie
CHAR
n.v.t.
Gebruikershandleiding Wholesale PreSelection Versie 2.1 (december 2011)
Specificatie reden van de schakeling (max. 15 karakters) **
24
Trailer record: Attribuut
veldtype
positie
omschrijving
Titel
CHAR
n.v.t.
"CPS trailer"
Prefix
CHAR
n.v.t.
Prefix waarover wordt gerapporteerd (16xy of 10xyx)
subtotaal_verkeerssoort2_heen
NUMBER
n.v.t.
Totaal aantal records voor verkeerssoort 2 met beschakeling naar prefix toe
subtotaal_verkeerssoort3_heen
NUMBER
n.v.t.
Totaal aantal records voor verkeerssoort 3 met beschakeling naar prefix toe
subtotaal_verkeerssoort4_heen
NUMBER
n.v.t.
Totaal aantal records voor verkeerssoort 4 met beschakeling naar prefix toe
subtotaal_verkeerssoort5_heen
NUMBER
n.v.t.
Totaal aantal records voor verkeerssoort 5 met beschakeling naar prefix toe
subtotaal_verkeerssoort6_heen
NUMBER
n.v.t.
Totaal aantal records voor verkeerssoort 6 met beschakeling naar prefix toe
subtotaal_verkeerssoort2_weg
NUMBER
n.v.t.
Totaal aantal records voor verkeerssoort 2 met beschakeling van prefix weg
subtotaal_verkeerssoort3_weg
NUMBER
n.v.t.
Totaal aantal records voor verkeerssoort 3 met beschakeling van prefix weg
subtotaal_verkeerssoort4_weg
NUMBER
n.v.t.
Totaal aantal records voor verkeerssoort 4 met beschakeling van prefix weg
subtotaal_verkeerssoort5_weg
NUMBER
n.v.t.
Totaal aantal records voor verkeerssoort 5 met beschakeling van prefix weg
subtotaal_verkeerssoort6_weg
NUMBER
n.v.t.
Totaal aantal records voor verkeerssoort 6 met beschakeling van prefix weg
Notitie
CHAR
n.v.t.
"alleen voor gebruik t.b.v. technisch dienstenbeheer"
** De specificaties die kunnen voorkomen zijn: WPS; VRS; Verhuizing; (Re)Migratie ; Ophef; Ophef wegens wanbetaling; Uitportering; Nummerwijziging; BelBudget; Service
Gebruikershandleiding Wholesale PreSelection Versie 2.1 (december 2011)
25
Gegevenslevering A-nummer rapportages
Gegevenslevering Aanleverfrequentie
Dagelijks: een niet-gespecificeerde A-nummer lijst van de dag ervoor (1 bestand per dag behalve op maandag dan worden 3 bestanden verstuurd, inclusief de ongespecificeerde bestanden over het weekend) de nieuwe gespecificeerde A-nummer lijst van drie dagen ervoor (1 bestand per dag behalve op donderdag dan worden 3 bestanden verstuurd, inclusief de gespecificeerde bestanden over het weekend) NB: Het kan voorkomen dat de gespecificeerde A-nummer lijst, die op een later tijdstip geproduceerd wordt dan de niet-gespecificeerde A-nummer lijst over dezelfde datum, enkele schakelingen meer bevat dan de niet-gespecificeerde A-nummer lijst.
Bestandsnaam
niet-gespecificeerde A-nummer lijst: CP16MMDD gespecificeerde A-nummer lijst: CP16xyMMDD
Methode van aanlevering
niet-gespecificeerde A-nummer lijst: via de SFTP server gespecificeerde A-nummer lijst: via de TIE gateway
Gebruikershandleiding Wholesale PreSelection Versie 2.1 (december 2011)
26