With this function you can create / fill in a handicapcard. On the back of this page you find a tutorial for this function (in dutch).
Function: getcourses
parameters: relationid, courseid, holesid,teeid,cardtype,playingdate, starttime, partyid, marker, description, categoryid
Optional parameters: mutationid, countrycode, totalpoints, hole1hits, hole2hits, hole3hits, hole4hits, hole5hits, hole6hits, hole7hits, hole8hits, hole9hits, hole10hits, hole11hits, hole12hits, hole13hits, hole14hit, hole15hits, hole16hits, hole17hits, hole18hits
Extra infromation: holeid – 1 = 18 hole card, 0 = 9 holes card. Courseid and teeid and categoryid can be found by using the function getcourses
Example: https://backend.prowaregolf.nl/api/sethandicapmutatie/key/<your authrisation code here>/relationid/<relationid>/partyId/<Party ID>/playingdate/<date of playing>/marker/<marker>/description/<description>/courseid/<course id>/holesid/<hole ID>/teeid/<Tee ID>/cardtype/<cardtype>/starttime/<Start time>/categoryid/<category ID>
result:
Example without mutationid :
{
"setHandicapMutatie":[
{
"Mutatie_inr":"6686",
"Datum":"2015-03-23",
"Kaart_nummer":"",
"Exact_oud":"15.2",
"Exact_nieuw":"15.3",
"Punten":"0",
"NGF_nummer":null,
"Tijd":"09:00",
"Baan_code":"36",
"Verwerkt":"N",
"Lidnummer":"1",
"Qualifying":"J",
"Club_Code":"36",
"Handicap_Soort_Code":"1",
"KaartType":"2",
"Bron":"0",
"Lus":"1",
"CSA":"-99",
"ReductionOnly":"0",
"HCPActief":"1",
"archived":"N",
"Teesoort":"12",
"CR":"65.7",
"SR":"112.0",
"TeeOmschr":" Oranje (heren)",
"Marker":"",
"PartyId":null,
"Par":"36",
"RequestCard":"0",
"h1_si":"17",
"h1_lng":"243",
"h1_par":"4",
"h1_sl":"0",
"h2_si":"7",
"h2_lng":"99",
"h2_par":"3",
"h2_sl":"0",
"h3_si":"1",
"h3_lng":"277",
"h3_par":"4",
"h3_sl":"0",
"h4_si":"3",
"h4_lng":"259",
"h4_par":"4",
"h4_sl":"0",
"h5_si":"15",
"h5_lng":"331",
"h5_par":"5",
"h5_sl":"0",
"h6_si":"11",
"h6_lng":"227",
"h6_par":"4",
"h6_sl":"0",
"h7_si":"5",
"h7_lng":"258",
"h7_par":"4",
"h7_sl":"0",
"h8_si":"9",
"h8_lng":"117",
"h8_par":"3",
"h8_sl":"0",
"h9_si":"13",
"h9_lng":"336",
"h9_par":"5",
"h9_sl":"0",
"h10_si":"14",
"h10_lng":"277",
"h10_par":"4",
"h10_sl":"0",
"h11_si":"16",
"h11_lng":"91",
"h11_par":"3",
"h11_sl":"0",
"h12_si":"2",
"h12_lng":"235",
"h12_par":"4",
"h12_sl":"0",
"h13_si":"4",
"h13_lng":"260",
"h13_par":"4",
"h13_sl":"0",
"h14_si":"12",
"h14_lng":"124",
"h14_par":"3",
"h14_sl":"0",
"h15_si":"10",
"h15_lng":"252",
"h15_par":"4",
"h15_sl":"0",
"h16_si":"18",
"h16_lng":"328",
"h16_par":"5",
"h16_sl":"0",
"h17_si":"6",
"h17_lng":"346",
"h17_par":"5",
"h17_sl":"0",
"h18_si":"8",
"h18_lng":"249",
"h18_par":"4",
"h18_sl":"0",
"LastUpdatedBy":null,
"aOmschrijving":null,
"Afgekeurd":"N",
"M_Punten_Netto":null,
"M_Punten_Bruto":null,
"update_trigger":"0",
"notes":null,
"DateOfEntry":null,
"h1_hcpsl":"0",
"h2_hcpsl":"1",
"h3_hcpsl":"1",
"h4_hcpsl":"1",
"h5_hcpsl":"0",
"h6_hcpsl":"0",
"h7_hcpsl":"1",
"h8_hcpsl":"0",
"h9_hcpsl":"0",
"h10_hcpsl":"0",
"h11_hcpsl":"0",
"h12_hcpsl":"0",
"h13_hcpsl":"0",
"h14_hcpsl":"0",
"h15_hcpsl":"0",
"h16_hcpsl":"0",
"h17_hcpsl":"0",
"h18_hcpsl":"0",
"playinghcp":"4",
"Land":null,
"ngfTee":"104",
"ngfCategory":"12"
}
]
}
Example with mutationid :
{
"setHandicapMutatie":[
{
"Mutatie_inr":"6686",
"Datum":"2015-03-23",
"Kaart_nummer":"",
"Exact_oud":"15.6",
"Exact_nieuw":"15.7",
"Punten":"21",
"NGF_nummer":null,
"Tijd":"09:00",
"Baan_code":"36",
"Verwerkt":"N",
"Lidnummer":"1",
"Qualifying":"J",
"Club_Code":"36",
"Handicap_Soort_Code":"1",
"KaartType":"2",
"Bron":"0",
"Lus":"1",
"CSA":"-99",
"ReductionOnly":"0",
"HCPActief":"1",
"archived":"N",
"Teesoort":"12",
"CR":"65.7",
"SR":"112.0",
"TeeOmschr":" Oranje (heren)",
"Marker":"123456",
"PartyId":null,
"Par":"36",
"RequestCard":"0",
"h1_si":"17",
"h1_lng":"243",
"h1_par":"4",
"h1_sl":"3",
"h2_si":"7",
"h2_lng":"99",
"h2_par":"3",
"h2_sl":"0",
"h3_si":"1",
"h3_lng":"277",
"h3_par":"4",
"h3_sl":"0",
"h4_si":"3",
"h4_lng":"259",
"h4_par":"4",
"h4_sl":"0",
"h5_si":"15",
"h5_lng":"331",
"h5_par":"5",
"h5_sl":"0",
"h6_si":"11",
"h6_lng":"227",
"h6_par":"4",
"h6_sl":"0",
"h7_si":"5",
"h7_lng":"258",
"h7_par":"4",
"h7_sl":"0",
"h8_si":"9",
"h8_lng":"117",
"h8_par":"3",
"h8_sl":"0",
"h9_si":"13",
"h9_lng":"336",
"h9_par":"5",
"h9_sl":"0",
"h10_si":"14",
"h10_lng":"277",
"h10_par":"4",
"h10_sl":"0",
"h11_si":"16",
"h11_lng":"91",
"h11_par":"3",
"h11_sl":"0",
"h12_si":"2",
"h12_lng":"235",
"h12_par":"4",
"h12_sl":"0",
"h13_si":"4",
"h13_lng":"260",
"h13_par":"4",
"h13_sl":"0",
"h14_si":"12",
"h14_lng":"124",
"h14_par":"3",
"h14_sl":"0",
"h15_si":"10",
"h15_lng":"252",
"h15_par":"4",
"h15_sl":"0",
"h16_si":"18",
"h16_lng":"328",
"h16_par":"5",
"h16_sl":"0",
"h17_si":"6",
"h17_lng":"346",
"h17_par":"5",
"h17_sl":"0",
"h18_si":"8",
"h18_lng":"249",
"h18_par":"4",
"h18_sl":"0",
"LastUpdatedBy":null,
"aOmschrijving":"qkaart",
"Afgekeurd":"N",
"M_Punten_Netto":null,
"M_Punten_Bruto":null,
"update_trigger":"0",
"notes":null,
"DateOfEntry":null,
"h1_hcpsl":"0",
"h2_hcpsl":"1",
"h3_hcpsl":"1",
"h4_hcpsl":"1",
"h5_hcpsl":"0",
"h6_hcpsl":"0",
"h7_hcpsl":"1",
"h8_hcpsl":"1",
"h9_hcpsl":"0",
"h10_hcpsl":"0",
"h11_hcpsl":"0",
"h12_hcpsl":"0",
"h13_hcpsl":"0",
"h14_hcpsl":"0",
"h15_hcpsl":"0",
"h16_hcpsl":"0",
"h17_hcpsl":"0",
"h18_hcpsl":"0",
"playinghcp":"5",
"Land":null,
"ngfTee":"104",
"ngfCategory":"12"
}
]
}
Extra uitleg:
Parameters algemeen:
De functie “sethandicapmutatie” kan voor verschillende doeleinden worden gebruikt. Hieronder een opsomming van de functionaliteiten.
De kunt de functie voor de volgende zaken gebruiken: 1. Aanmaken van een kaart op de eigen baan 2. Aanmaken van kaarten op een andere baan gespeeld. 3. Aanmaken van kaarten gespeeld in het buitenland 4. Het verrijken van bestaande kaarten
Soorten kaarten:
Je kunt met deze functie 2 soorten kaarten aanmaken.
De volgende soorten kaarten kun je aanmaken: 1. Q-Kaart ⇒ Kaarttype 1 2. Externe Wedstrijdkaart ⇒ Kaarttype 3
Minimale parameters bij aanmaken nieuwe kaart:
Wanneer je een nieuwe kaart aanmaakt moeten minimaal de volgende parameters worden meegegeven: 1. relationid → Lidnummer 2. courseid → NGF nummer van de club deze is op te halen via de functie “getcourses” 3. holesid → Is een vast waarde van '1' voor 18 holes en een '0' voor 9 holes 4. teeid → Dit is de nummer van de baanlus. Deze kan worden opgehaald met behulp van de functie “getcourselus” 5. cardtype → Dit is het soort kaart wat wordt gekozen. Hierbij is 1 een Q-Kaart en 3 een wedstrijd gelopen op een andere baan. Wedstrijden op de eigen baan gaat via de wedstrijdleiding. 6. playingdate → De datum waarop de kaart is gespeeld 7. starttime → De tijd dat de kaart gespeeld is. 8. categoryid → Dit is het nummer om de kleur van de tee te kunnen aangeven. Deze krijg je uit de functie “getcourselustees “
Parameter bij ophalen van een bestaande kaart:
Wanneer je een oude kaart wilt ophalen geef je alleen de volgende parameter mee: 1. mutationid
Het vullen van de slagen in een binnenlandse kaart:
Wanneer je de slagen per hole mee wilt sturen, voor een nederlandse kaart, dan kan dit met de volgende parameters: 1. hole1hits 2. hole2hits 3. hole3hits 4. hole4hits 5. hole5hits 6. hole6hits 7. hole7hits 8. hole8hits 9. hole9hits 10. hole10hits 11. hole11hits 12. hole12hits 13. hole13hits 14. hole14hits 15. hole15hits 16. hole16hits 17. hole17hits 18. hole18hits
Het vullen van de resultaat in een buitenlandse kaart:
Wanneer het gaat om een buitenlandsekaart mag je alleen het totaal aantal stableford punten meegeven.
De parameter hiervoor is: 1. totalpoints
De parameter voor het toekennen van de CBA is : cba
De parameter voor het toekennen van de reduction only is : reductiononly
Je kunt in een wedstrijdkaart (kaarttype 3) een CBA meegegeven
Met de CBA mag je de volgende waarde meegeven: 1 0 -1 -2 -3 -4
Wanneer de CBA -4 gekozen is mag je ook de reduction only van 1 meegeven. Alle andere waarde kunnen geen reduction only hebben.