> ## 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.

# Receiving Reservations

> Consume GNet's object model to receive trips on the provider side

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`](/platform-api/provider-updates/update-by-resno) on GNet. This endpoint should be called whenever there is a change in Status, Driver Info, Vehicle Info, Charge line items, or Total.

<Note>
  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.
</Note>

## 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:

| Action   | Meaning                        |
| -------- | ------------------------------ |
| `NEW`    | A new trip.                    |
| `UPDATE` | An update of an existing trip. |
| `CANCEL` | A request to cancel a trip.    |

## Key fields

| Field                                 | Description                                                                                    |
| ------------------------------------- | ---------------------------------------------------------------------------------------------- |
| `affiliateReservation.requesterId`    | The GNet ID of the sending company.                                                            |
| `affiliateReservation.requesterResNo` | The reservation number of the sending company.                                                 |
| `affiliateReservation.providerId`     | The GNet ID of the receiving company.                                                          |
| `affiliateReservation.providerResNo`  | The 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`](/platform-api/provider-updates/update-by-resno) or [`providerUpdateStatusByTransactionId`](/platform-api/provider-updates/update-by-transaction-id). Send an update whenever any of the following change:

* Status Code (see [Status Codes](/platform-api/reference/status-codes))
* Driver / Chauffeur info
* Vehicle info
* Charge line items (fees)
* Total amount

<Card title="Webhook Callbacks" icon="bell" href="/platform-api/reference/webhook-callbacks">
  GNet relays these updates back to the original sender via real-time webhook callbacks.
</Card>