Vraag en antwoord toepassing van het datamodel CDB

Wij kunnen geen voorbeeld XML bestanden aanleveren. U bent als aanbieder is zelf verantwoordelijk voor het lezen en volgen van de documentatie. Wij verwachten van u als aanbieder dat u binnen de kaders,  uw eigen technische oplossingen implementeert. Validatie van correcte implementatie is één van de activiteiten tijdens de Integratietest CDB.

Het element Bet_XY in XSD bestand WOK_Bet_v1.01.xsd en de elementen Deposit_Amount, Participation_Amount en Balance_Amount in het XSD bestand WOK_Player_Limits_v1.01.xsd zijn gelimiteerd door het datatype xs:integer. Formeel heeft dit type geen minimum en maximum waarde waardoor er onduidelijkheid is over de toelaatbare minimum en maximum limieten.

Het bedoelde technische bereik is -2,147,483,647 tot 2,147,483,647 wat het bereik is van een regulier geheel getal ook wel bekend als een 32 bits integer. Let op dat de waarde van de velden in Euro zijn.

Player_Profile_EOD_Balance bevat het saldo - in euro’s - op de spelersrekening aan het einde van de dag (UTC).

De waarde van Player_Profile_EOD_Balance wordt bepaald door transacties die plaatsvinden, zoals een storting, inzet, winstuitkering of toekenning van een bonus.

Het CDB Datamodel bevat een onduidelijkheid over het veld Player_Profile_EOD_Balance. Het gaat om de trigger en frequentie van rapportage van dit veld (als onderdeel van het overkoepelende bestand WOK_Player_Profile. Onderstaande is de situatie zoals bedoeld:

Dagelijks

Van alle spelers met tenminste 1 transactie (of correctie daarop) gedurende 1 dag, stuurt u einde van die dag een WOK_Player_Profile.

• Neem daarin op: de Player_Profile_EOD_Balance van die betreffende dag.
• Zorg dat deze WOK_Player_Profile in de CDB wordt geplaatst om 00:01 UTC.

Jaarlijks

Van alle spelers in uw klantadministratie stuurt u een WOK_Player_Profile.

• Neem daarin op: de Player_Profile_EOD_Balance van 30 september.
• Zorg dat deze op 1 oktober in uw CDB wordt geplaatst om 00:01 UTC.

Situatie afhankelijk

1. Bij ingebruikname van een geheel nieuwe CDB stuurt u een WOK_Player_Profile van alle aanwezige spelers op eerste moment van ingebruikname. Zorg dat u deze direct na ingebruikname in uw CDB plaatst.
2. Bij een nieuwe speler plaatst u een WOK_Player_Profile direct na registratie - als de speler zijn profiel opslaat en bewaart,  ook als het profiel niet volledig is gevuld.
3. Bij een bestaande speler die zijn profiel wijzigt, plaatst u een WOK_Player_Profile direct na wijziging - als de speler zijn profiel opslaat en bewaart.

In de gevallen a, b, c kan het onmogelijk zijn om een Player_Profile_EOD_Balance van de betreffende dag te bepalen, neemt u die gevallen de Player_Profile_EOD_Balance van de vorige dag.

Als u een correctie toepast, bijvoorbeeld op een transactie, rekent u deze toe aan de Player_Profile_EOD_Balance op de dag waarop u de correctie uitvoert. U past een Player_Profile_EOD_Balance dus niet met terugwerkende kracht aan.

Zowel bij het gebruik van ‘cancellation’ als bij ‘replacement’ moeten uw oorspronkelijke records voor tenminste 12 maanden in uw CDB blijven. Dat is in lijn met de daarvoor geldende termijnen uit wet- en regelgeving.

Als u ons een correctie verstuurt via ‘cancellation’ geeft u daarmee aan dat een record ongeldig is. Er is dan geen nieuw record. Bij een ‘replacement of delta’ is er wel een nieuw record met een nieuwe of aangepaste waarde.

Ja. Maar Delta mag alleen worden toegepast in XML databestanden WOK_Player_Account_Transaction en WWFT_Player_Account_Transaction.

Let op. Aangezien de records WOK_Player_Account_Transaction en WWFT_Player_Account_Transaction een sterke samenhang kennen, moet u altijd corrigeren op beide records (of geen van beide).

Het is niet verplicht om Delta te gebruiken, voor deze twee recordtypes kan ook nog steeds een Replacement correctie worden gebruikt. Ook in dat geval moet u altijd corrigeren op beide type records.

Als u het deltacorrectietype wilt gebruiken, moet u exact dezelfde gegevens opnemen die in het oorspronkelijke record zijn gerapporteerd (Transaction_ID, Transaction_Type, Player_ID, enz.). Het is belangrijk om dezelfde Transaction_ID te gebruiken zoals u gerapporteert in de oorspronkelijke transactie waarover u een correctie wilt rapporteren.

De enige velden die zullen verschillen zijn:

• Record_ID, dit moet altijd uniek zijn, dus anders zijn dan de oorspronkelijke Record _ID
• Transaction_Datetime, bij een Delta is dit het tijdstip waarop de transactie is gecorrigeerd.
• Transaction_Amount

Vul Transaction_Amount in met het deltabedrag dat u wilt corrigeren. Het bedrag kan positief of negatief zijn, bijvoorbeeld:

• Als het in het eerste record gerapporteerde bedrag 20 was en de waarde na correctie 30 zou moeten zijn, dan is het gerapporteerde deltabedrag '10'
• Als het in het eerste record gerapporteerde bedrag 20 was en de waarde na correctie 15 zou moeten zijn, dan is het gerapporteerde deltabedrag "-5"
• Als het in het eerste record gerapporteerde bedrag -16 (bv. “stake”) was en de waarde na correctie -10 zou moeten zijn, dan is het gerapporteerde deltabedrag '6'

Let op: plusteken is een “invalid character”, daarom is gebruik niet toegestaan.
Let op: als deltarecords worden ingediend, moet rekening worden gehouden met het gerapporteerde Transaction_Amount voor de berekening van:

• Het EOD-saldo van wok_player_profile van de dag dat de delta is ingediend
• De gegevens in wok_operator van de dag waarop de delta is ingediend

Twijfelt u of u 1 - 0 of true - false moet gebruiken bij datatype Boolean? Wij willen graag dat u true - false gebruikt, in lijn met de canonieke mapping volgens de W3C XML-schema standaard.

Het veld Login_Duration onder Limit_Login in Wok_player_limits moet worden gevuld in uren. Het data type is een float om weergave in fracties van uren mogelijk te maken. Hiermee kunnen verschillende soorten tijdsduur worden ondersteund. Bijvoorbeeld: een speler heeft 93 minuten ingesteld in deze limiet, dan volgt daaruit een Login_Duration waarde van 1,55 (93 minuten gedeeld door 60 minuten).

• Gebruik de WOK_Player_Account_Transaction en WWFT_Player_Account_Transaction records. Gebruik altijd beide of corrigeer op beide.
• Een niet-geslaagde transactie moet net als een geslaagde transactie worden geadministreerd in de controledatabank. Neem daarbij de gebruikelijke gegevens op. Zoals een uniek recordID, een Transanction_Type enzovoorts.
• Indien de transactie bijvoorbeeld een WITHDRAWAL betreft, blijft dat het Transaction_Type. Of de transactie nu geslaagd is of niet.
• Gebruik in geval van een niet-geslaagde transactie hetzelfde Transaction_ID zoals dat al is gerapporteerd in de initiële poging tot een transactie.
• Neem de Transaction_Datetime op van het moment waarop de transactie is geslaagd, mislukt of waarop de annulering heeft plaatsgevonden.

Het kan voorkomen dat een transactie is gestart maar dat het lang duurt voordat een uitkomst bekend wordt. In deze situatie is de transactie simpelweg hangende in het proces. Het is voor de Kansspelautoriteit niet relevant waar in het proces een transactie zich bevindt: het gaat om de uitkomst (geslaagd, niet geslaagd of geannuleerd). Dit staat los van de reden waarom de transactie gestart is, die u moet opgeven in het veld transaction_type.