Ordering API Guidelines

The purpose of this guide is to explain the usage of the Ordering API in a straightforward manner. We will delve into the key usage points of the API along with some illustrative examples.

For more detailed information, the complete API documentation can be found at: https://get.ordering.help/reference/welcome-to-our-ordering-api

Ordering.co is the best and easiest way to build any kind of Ordering Solution. You can even create your Online Ordering Marketplace; our APIs include all the power of our backend, so you don't need to build one to create amazing Apps or Ordering Solutions.

Like any API, certain functions are defined that can be used to interact with your Ordering project and utilize its resources.

You can obtain the list of orders that belong to your project and apply filters to them

https://apiv4.ordering.co/v400/<language_code>/<project_id>/orders?orderBy=-id&page=1&page_size=10&mode=dashboard

Usage example

Image link: https://d.pr/i/jnphHc

It's possible to retrieve the list of orders using specific filters. This allows for more specific order retrieval. Some of the filters that can be used include:

You can obtain the complete list of your businesses from your project. This section of the documentation provides more detailed information about the attributes contained in the business: https://get.ordering.help/reference/business-model

Usage example:

The easiest way to request the list of businesses is through the following endpoint: https://apiv4.ordering.co/v400/<langue_code>/<project_id>/business?mode=dashboard

NOTE: Don't forget to replace "<project_id>" with your project's identifier and <language_code> with “en” or with the code of your language.

Now, you simply need to use the endpoint using the "GET" request type and add your "x-api-key" as the "Authorization" of the request.

https://d.pr/i/h43mHg

When attempting this, you may encounter an error due to the potentially high payload of requested data in JSON format. To address this, parameters should be used.

For example, if we only want to request the "name" value of the business, we can add these parameters to the request. Additionally, we include "page=1&page_size=10" to limit the result per page:

https://apiv4.ordering.co/v400/en/<project_id>/business?page=1&page_size=10&params=name&mode=dashboard

Image link: https://d.pr/i/qkSXD9

The API will return reduced information, including only some minimal data. If you want to add additional data, you just need to include it, for example, the external_id.

Image link: https://d.pr/i/XEpz4F

We can also observe that the same endpoint is used in the dashboard but with additional parameters added. This can be useful for comparing information regarding the usage of certain endpoints:

Imagen link: https://d.pr/i/nEPzWa

Image link: https://d.pr/i/dHUslt

Some parameters compatible with the business endpoint are:

To get categories and product info, the following endpoint can be used:

https://apiv4.ordering.co/v400/en/{{project}}/business/{{business_slug}}?params=id,categories,name,slug,description&mode=dashboard

To send this request, a "GET" method is used, and it requires using the Authorization with an x-api-key, as you can see in the following image:

Image link: https://d.pr/i/9KfZh1

You can view the products within each category.

To create orders using the API, this currently involves two steps:

1. First, create the cart or add the products.

2. Second, Place or complete the cart.

Please see the following steps as an example to achieve this:

1. In Postman, when the request is sent, the response returns a cart identifier (UUID), which should be used in step 2: https://d.pr/i/NynuCo

2. Use the cart identifier to send the request and complete the order: https://d.pr/i/eed6tf

To update prices, the following endpoint can be used:

https://apiv4.ordering.co/v400/en/{{project}}/business/{{business_id}}/categories/{{category_id}}/products/{{product_id}}

This will directly update the product price. It is necessary to know the business ID, category, and product.

Body - Payload

{"price":{{price}}}

In this example, the price was updated to “17”

Image link: ​​https://d.pr/i/mPpbTs

The following endpoint can be used to update product quantities:

https://apiv4.ordering.co/v400/en/{{project}}/business/{{business_id}}/categories/{{category_id}}/products/{{product_id}}

This will directly update the product quantity. It is necessary to know the business ID, category, and product.

Body - Payload

{"quantity":{{quantity}}}

Image link: https://d.pr/i/y82Esd

In this example, the price was updated to “25”

NOTE: To use the product inventory, the "inventoried" attribute must be enabled.

{"inventoried":true}

​
​
​