Professional Documents
Culture Documents
Order-Direct Fulfillment Overview v1.0
Order-Direct Fulfillment Overview v1.0
Order-Direct Fulfillment Overview v1.0
This is a brief overview, for more in-depth information check the partner API definition documentation and the openAPI docs.
Checkout Order
In this scenario, Google would provide Order Direct a Checkout Intention where the Cart details would be provided. This message will then be
forwarded to the partner. This includes which products, add-ons and service (take-away or delivery) for the order.
According to the documentation, the endpoint should be responsible for the following:
If the checkout request is invalid but it is recoverable (e.g. items' price changed), the response should include:
If the checkout request is not valid but it is not recoverable (e.g. restaurant is closed), the response should include:
If the Partner is unreachable or any other error happens, we take action and reply to Google on partner's behalf, claiming service unavailability.
On all other scenarios, the message replied from the partner would be forwarded to Google as a Checkout Response.
Other technical considerations
Prices provided on a Checkout request are not structured the same way as provided on the inventory feed
A response should be provided within a 5-second frame.
Submit Order
With this call, Google is informing Order Direct that a customer decided to order a previously checked out order. Additionally, payment information
is provided. In order to properly handle this request, the endpoint should:
Update Order
Once the order has been created, there is the opportunity to update its state. Common reasons for sending an update include:
The update flow would be triggered by the partner as they would be the ones with the needed information for it such as delivery time estimations
or if the order could not be fulfilled anymore, for example.
It's not needed to provide all states and transitions but a final state is needed on every order (CONFIRMED, REJECTED, CANCELLED)
If the update is successful, there will be a respond with status code 200 with an empty body.