If you are building a Farm In integration and just ran the Integration Robot, this page is what your partners do instead of the robot. Same reservation, same statuses, same cancel — from a real partner account rather than from
gnettest.Who can see gBook
gBook appears in the GNet section of the dashboard menu for:- Vendor Partner accounts (reservation platforms)
- Operators integrating directly against the GNet API
- Internal sandbox accounts
Before the first trip
Two things have to be true between the sender and the receiver, and both are checked before anything reaches the receiver’s system.1
The two accounts are partners
Open My Partners on the sender’s dashboard. If the receiver is not listed under accepted partners, search the directory and send a request; the receiver accepts it from My Partners → Incoming on their dashboard.
2
The receiver has set the sender's account number
On the receiver’s dashboard, open My Partners, select the sender, and fill in Account Number (the “pink field”). This is the sender’s customer ID in the receiver’s reservation system — it tells the receiving system who the trip is for. Bookings fail without it, with an error naming the missing account number. See Account number: who the trip is for.If the sender should also be able to ask the receiver for quotes, tick Give Quotation Access on the same screen.
Sending the trip
1
Open gBook
Sign in at dashboard.grdd.net and choose gBook under GNet in the menu. The page has the booking form on one side and your trips in progress on the other.
2
Trip
Select the Partner who will run the trip, the Vehicle type, the Pickup date and time, and the passenger count. Choose a pickup at least a couple of hours out — receiving systems refuse pickups inside their lead time, and a test trip should never sit in the past while you are watching it. For an hourly trip, set the duration.
3
Route
Enter the pickup and drop-off with the address picker rather than typing free text. A picked address arrives at the receiver both as one full line and split into street, city, state, zip and country, which is what receiving systems match on. For an airport, switch the location type to Airport and add the airline code and flight number; tick Meet & Greet if wanted. Add stops if the trip has any.
4
Passenger
Add the passenger’s name and phone. You can pick a saved contact from your client list, and gBook will offer to save a new passenger to it before booking.
5
Show JSON (optional)
Click Show JSON to see the exact reservation GNet will deliver to the partner’s system, without sending it. The payload is produced by the same code that sends it, so what you see is what they get. This is the fastest way for an integrating platform to confirm a field mapping before a real trip goes out.
6
Book
Click Book. The reservation is delivered to the partner immediately. A confirmation appears, the form clears, and the trip shows in your list with the Sender Trip # (yours) and, once the partner’s system answers, the Receiver Trip # (theirs). If delivery fails, the error and any notes the partner’s system returned are shown above the form.
What the receiver gets, and what comes back
The receiver’s system gets a reservation withaction: "NEW", the sender’s account number, and the trip details, and answers with success: true and its own reservation number. From then on the receiver drives the trip and each status it pushes — CONFIRMED, ASSIGNED, EN_ROUTE, ON_LOCATION, PASSENGER_ON_BOARD, COMPLETE, CLOSE with final charges — appears on the sender’s dashboard under Reservations and on the trip in gBook.
For the receiving side of this exchange, see Receiving Reservations and Update Status by Reservation #.
Changing or cancelling the trip
From the trip list in gBook:- Edit reloads the trip into the form. Change the pickup time, location, or passenger details and book again; the receiver gets the same reservation with
action: "UPDATE"and your transaction ID. - Cancel Trip sends
action: "CANCEL". The receiver’s system must answer explicitly —success: trueonce cancelled in their dispatch, orsuccess: falsewith a reason — and gBook shows you which. A refused cancel means the trip is still live on their side and needs a phone call. Cancelling close to pickup may incur the partner’s late-cancellation charges, and gBook warns you before it sends.
Quotes are not orders
Get Quotations, also in the GNet menu, sends aQUOTE request, not a booking. The partner’s system prices it (or does not) and nothing is dispatched. It only lists partners who have given you quotation access, and only works with partners whose systems answer quote requests. To send an order, use gBook.
Contact Support
To enable gBook on an account, or if a booking fails and the error is not clear.