Skip to main content

Documentation Index

Fetch the complete documentation index at: https://docs.grdd.dev/llms.txt

Use this file to discover all available pages before exploring further.

If an existing API does not already exist for GNet integration, you can consume GNet’s object model for receiving trips. GNet requires one web service on the receive side to accept NEW, UPDATE, and CANCEL requests — all in a single endpoint. To provide status updates for incoming trips, you call providerUpdateStatusByResNo on GNet. This endpoint should be called whenever there is a change in Status, Driver Info, Vehicle Info, Charge line items, or Total.
The GNet team will work with your technical team to determine how to communicate with your web service, capture confirmation numbers, and capture error messages in case a trip has to be rejected.

Interpreting the payload

The web service receiving trip payloads from GNet must look at the affiliateReservation section to determine whether the payload is requesting a NEW trip, or whether it is an UPDATE or CANCEL for an existing trip. affiliateReservation.action tells your web service what needs to be done:
ActionMeaning
NEWA new trip.
UPDATEAn update of an existing trip.
CANCELA request to cancel a trip.

Key fields

FieldDescription
affiliateReservation.requesterIdThe GNet ID of the sending company.
affiliateReservation.requesterResNoThe reservation number of the sending company.
affiliateReservation.providerIdThe GNet ID of the receiving company.
affiliateReservation.providerResNoThe reservation number of the receiving company. Populated when action = UPDATE or CANCEL.

Providing status updates

Once you have received and accepted a trip, push status changes back to GNet by calling providerUpdateStatusByResNo or providerUpdateStatusByTransactionId. Send an update whenever any of the following change:
  • Status Code (see Status Codes)
  • Driver / Chauffeur info
  • Vehicle info
  • Charge line items (fees)
  • Total amount

Webhook Callbacks

GNet relays these updates back to the original sender via real-time webhook callbacks.