This is an old revision of the document!
To retrieve detailed data of teetime reservations (called flights). This function is meant for operational purposes, not for management info or statistics.
parameters:
auth | the authorisation code you received from Intogolf BV (mandatory) |
fltnr | internal id of the flight |
relnr | internal id of a golfer within the domain of ikgagolfen |
relnrlocal | local id of a golfer within the domain of the golfcourse |
startdate | date the flightreservation is made for (format YYYYMMDD) |
starttime | time the flightreservation is made for in minutes since midnight (600 = 10 o'clock, 720 is noon) |
At least one of the parameters fltnr, relnr, relnrlocal, startdate, strttime is needs to be provided, otherwise the return code 449 - Retry with valid parameters is returned.
If the parameters fltnr and/or startdate are nort provided, the resultset will always be limited to startdates >= today
If the parameter fltnr is provided all other selection parameters are ignored.
If the parameter fltnr is not provided, only non-canceled flights are returned.
If the result set is longer than 1000 records, it will be truncated.
If a wrong authorisation code is provided, the backend will return 401,“Unauthorized”
example: https://backend.intogolf.com/itg/getflight?auth=<your authorisation code>&relnr=659764&startdate=20130530
To obtain the flight for the golfer with id 659764 (see igg/getgolfer) for may 30th, 2013
result (shortened for readability):
{ { "getflight": [ { "fltnr": 3436124, "startdate": 20130530, "starttimebooked": 510, "starttimefixed": false, "starttime": 510, "breaktime": 0, "time2": 630, "crlnr1": 44, "crlnr2": 70, "nrofplayers": 3, "nomerging": false, "origin": 1, "timestamp": "2013-05-23T16:07:45+02:00", "carnr": 0, "carname": null, "players": [ { "flpnr": 11162606, "relnr": 659764, "relnrlocal": 12590, "name": "knol-pas, s.a.w.", "phone": "0135159339", "handicap": 54.0, "grfnr": 4, "grfname": "lid (gratis)", "greenfee": 0.0, "grfnrdiscount": 0, "grfnamediscount": null, "discount": 0.0, "gfcnr": 0, "gfcnrdiscount": 0, "scorecardnr": 0, "qualifyingnr": 0, "carnr": 0, "rentals": [ { "rentalnr": 155200, "rentaltypenr": 121, "rentaltype": "handicart", "rentalitemnr": 93, "rentalitem": "handicart 2", "rentaltimefrom": 510, "rentaltimeto": 750, "extratimebefore": 10, "extratimeafter": 15, "extrainfo": "", "rentalprice": 0.0, "checkedin": false } ] }, { "flpnr": 11162607, "relnr": 701160, "relnrlocal": 193732, "name": "knol, r.j.w.", "phone": "0135159339", "handicap": 54.0, "grfnr": 57, "grfname": "greenfee", "greenfee": 47.25, "grfnrdiscount": 48, "grfnamediscount": "bonus", "discount": 5.0, "gfcnr": 0, "gfcnrdiscount": 0, "scorecardnr": 0, "qualifyingnr": 0, "carnr": 0, "rentals": [ { "rentalnr": 155199, "rentaltypenr": 36, "rentaltype": "trolley", "rentalitemnr": null, "rentalitem": null, "rentaltimefrom": 510, "rentaltimeto": 750, "extratimebefore": 0, "extratimeafter": 0, "extrainfo": "", "rentalprice": 0.0, "checkedin": false } ] }, { "flpnr": 11162608, "relnr": 243520, "relnrlocal": 22359, "name": "aikema, annerie", "phone": "0118561413", "handicap": 45.0, "grfnr": 340, "grfname": "10 rittenkaart", "greenfee": 0.0, "grfnrdiscount": 0, "grfnamediscount": null, "discount": 0.0, "gfcnr": 12365, "gfcnrdiscount": 0, "scorecardnr": 0, "qualifyingnr": 0, "carnr": 0, "gfcname": "10 rittenkaart", "gfcdatefrom": 20130501, "gfcdateto": 20140430, "totalrounds": 10, "usedrounds": 0, "rentals": [ ] } ] } ] }
Flight info:
fltnr | internal id of this flight |
startdate | date at which the golfround will be played in YYYYMMDD format |
starttimebooked | teetime that was booked in minutes since midnight |
starttimefixed | if true, this teetime is not allowed to shift for teesheet optimization |
starttime | teetime (same as starttimebooked unless automatic teesheet optimization is enabled) |
breaktime | pauze in minutes between 9th hole and 10th tee |
time2 | teetime on the second course loop (10th tee) |
crlnr1 | internal id of first courseloop |
crlnr2 | internal id of 2nd courseloop. If 0 only 9 holes are played |
nrofplayers | number of players in the flight (can be more than 4) |
nomerging | if true it is not possible to add another booking to fill up the 4 places in a flight |
origin | 1 - phone/reception, 2 - internet |
timestamp | date and time the booking was made |
carnr | internal id of reason if the booking was canceled |
carname | description of cancelreason |
Players (if the parameter fltnr was provided, these subrecords may also include players that have canceled (carnr>0):
flpnr | internal id of the flight player |
relnr | global id of the golfer (can be 0 if the golfer is not known globally) |
relnrlocal | local id of the golfer for this golfcourse (can be 0 if the golfer is not known locally) |
name | name of the golfer |
phone | phone number |
handicap | handicap of the golfer |
grfnr | internal id of the greenfee |
grfname | name of the greenfee |
greenfee | greenfee price |
grfnrdiscount | internal id of discount |
grfnamediscount | name of discount |
discount | discount amount |
gfcnr | internal id of greenfeecard |
gfcname | name of the greenfeecard |
gfcdatefrom | date the greenfeecard became valid |
gfcdateto | date after which the greenfeecard is expired |
totalrounds | total value of the greenfeecard |
usedrounds | used up value of the greenfeecard (totalrounds - usedrounds = balance). Beware that this value will only include the current flight if the player has checked in |
gfcnrdiscount | internal id of discountcard |
gfcdatefrom | date the greenfeecard became valid |
gfcdateto | date after which the greenfeecard is expired |
totalrounds | total value of the greenfeecard |
usedrounds | used up value of the greenfeecard (totalrounds - usedrounds = balance). Beware that this value will only include the current flight if the player has checked in |
scorecardnr | internal id of scorecard if the player has checked in (use this to test if the player has checked in and payed) |
qualifyingnr | internal id of qualifying card |
carnr | internal id of cancel reason if this player was canceled |