Access Goodeats sales via API

The Goodtill API allows retrieving new Goodeats orders and updating their statuses.

Data flow

The following diagram shows the data flow for Goodeats integrations. New sales can be fetched by polling the API or by receiving webhook notifications. You can then update the order status via the API (eg to state that a delivery has been completed).

Order statuses can be updated from the POS or Goodeats terminal, so you should also poll or listen to changes in the order state which do not originate from your application.

See the following article for a full list of order states.

Access Goodeats sales API

Orders can be cancelled after creation

Orders can be rejected before being accepted or cancelled any time before being marked as completed. Please ensure you are handling these events to prevent actioning orders which have been rejected or cancelled.

API

Please see the following article for an overview of the API.

You can interact with Goodeats orders via the following API methods:

When using the ExternalSale methods, you will need to add an additional header to the requests:

Vendor-Id: gtc

If you are building an integration for multiple customers, you will need a set of credentials per customer.

Webhooks

You can use webhooks to be notified of new sales and sale status updates without polling. Please see the following article for an overview of webhooks.

The following events may be relevant to your integration:

  • sale.completed - A new sale has been created
  • sale.web_order_status_updated - The status of a web sale has been updated

Test accounts

We can provide a test account which will allow you to place Goodeats orders and interact with them via the API. Please contact support@thegoodtill.com with some details about your planned integration and the customer(s) you're working with.