
# Getting Started

This page explains how developers can get started using Rappi APIs for Restaurants Integration.

<aside class="notice">
    <p><b>NOTE</b></p>
    We are in the process of improving our public APIs, which is why we ask you to always be aware of our official documentation.
</aside>

## Integration Requirements

Since integrating with our API requires direct contact with our team, follow these steps to get started.

### 1. Initial Contact

To know the steps to sign up as a Rappi ally, contact your main Rappi point of contact.

### 2. Credential Creation

Once your request is approved, you will receive access credentials for our development environment.

### 3. Documentation Review

Before starting development, we recommend reviewing the following resources:

- [API reference documentation](https://dev-portal.rappi.com/en/content)
- [Authentication guide](/en/api-reference/authentication)

### 4. Considerations for this api

This API reference documentation is designed to help you understand the available endpoints, their parameters, and how to use them effectively. It includes detailed descriptions of each endpoint, including request and response formats, required parameters, and examples.

It also provides information on how to authenticate your requests, handle errors, and manage pagination.

### 4.1 Endpoint Tags

- `NEW`: This tag indicates that the endpoint is new.
- `STABLE`: This tag indicates that the endpoint is stable and has been in use for a long time. It is recommended to use stable endpoints in integrations.
- `DEPRECATED`: This tag indicates that the endpoint is deprecated and may be removed in future versions of the API. It is recommended to avoid using deprecated endpoints in new integrations.

### 4.2 Endpoint Deprecation

Endpoints that are marked as `DEPRECATED` will continue to function for a period of time, but they may be removed in future versions of the API. We recommend that you avoid using deprecated endpoints in new integrations and migrate to stable or new endpoints as soon as possible.

### 5. Testing in the Developer Environment

After signing up as a Rappy ally, you receive your Rappi credentials that consist of the following:

- `client_id`
- `client_secret`

Use these Rappi Credentials to create your Access Token with the [`POST token/login/integrations`](/en/api-reference/authentication/#post-integrations-login).

After generating your Access Token, you can start using the Rappi API.


Getting Started

Integration Requirements

API Endpoints

Utils Endpoints

Domains

New Domains

Contents of the guide

POST integrations login

POST utils login

NEW Authentication

GET orders

GET orders status sent

PUT orders/{orderId}/take/{cookingTime}

PUT orders/{orderId}/reject

POST orders/{orderId}/ready-for-pickup

GET orders/{orderId}/events

Orders

GET menu

POST menu

GET menu/approved/{storeId}

GET menu/rappi/{storeId}

Menus

POST availability/items/status

POST availability/items/rappi/status

PUT availability/stores/items

PUT availability/stores/items/rappi

POST availability/stores

PUT availability/stores

PUT availability/stores/enable/massive

PUT availability/stores/enable

Availability

GET stores-pa

PUT store-pa integrated status

GET store current menu

GET stores-pa check in code

Stores

GET webhook

PUT webhook Add Stores

PUT webhook Change Url

POST webhook

DELETE webhook

PUT webhook reset secret

PUT webhook change status

Webhooks

GET stores/{storeId}/orders

GET orders/status/sent

PUT stores/{storeId}/orders/{orderId}/take

PUT stores/{storeId}/orders/{orderId}/cooking_time/{cookingTime}/take

GET stores/{storeId}/orders/{orderId}/handoff

POST stores/{storeId}/orders/{orderId}/bag-drink-confirmation

PUT stores/{storeId}/orders/{orderId}/cancel_type/{cancelType}/reject

NEW Rest API of Orders

GET Store Menu By Store ID

POST Upload Store Menu

GET Menus By Store ID

POST Upsert Menu By Store ID

DELETE Menu By Store ID

GET Menu By Store ID

GET Categories By Store ID

POST Upsert Categories By Store ID

DELETE Categories By Store ID

GET Category By Store ID

GET Items By Store ID

POST Upsert Items By Store ID

DELETE Items By Store ID

GET Item By Store ID

NEW Rest API of Menu

PATCH Products availability by SKU or ID

POST Validate products availability by SKU or ID

PATCH Toppings availability by SKU or ID

POST Validate toppings availability by SKU or ID

PATCH Items availability by SKU or ID

POST Validate items availability by SKU or ID

Rest API of Availability

GET payments

GET order_adjusments

GET charged_cancellations

GET store_adjustments

GET loans

GET debts

GET extras

GET taxes

GET compensations

GET cancellations

GET agreements

Rest API of Financial

GET corridor/store/{storeId}

GET corridor/schedule/{corridorId}/store/{storeId}

POST corridor/schedule/{corridorId}/store/{storeId}

PUT corridor/schedule/{corridorId}/store/{storeId}

DELETE corridor/schedule/{corridorId}/store/{storeId}/{corridorProductScheduleId}

GET corridor/integration/{integrationId}

GET corridor/schedule/{corridorId}/integration/{integrationId}

POST corridor/schedule/{corridorId}/integration/{integrationId}

DELETE corridor/schedule/{corridorId}/integration/{integrationId}/{corridorProductScheduleId}

GET product/corridor/{corridorId}/store/{storeId}

GET product/schedule/{productId}/corridor/{corridorId}/store/{storeId}

POST product/schedule/{productId}/corridor/{corridorId}/store/{storeId}

PUT product/schedule/{productId}/corridor/{corridorId}/store/{storeId}

DELETE product/schedule/{productId}/corridor/{corridorId}/store/{storeId}/{corridorProductScheduleId}

GET sku/corridor/{corridorId}/integration/{integrationId}

GET sku/schedule/{sku}/corridor/{corridorId}/integration/{integrationId}

POST sku/schedule/{sku}/corridor/{corridorId}/integration/{integrationId}

PUT sku/schedule/{sku}/corridor/{corridorId}/integration/{integrationId}

DELETE sku/schedule/{sku}/corridor/{corridorId}/integration/{integrationId}/{corridorProductScheduleId}

GET menu/integration/{integrationId}

GET store/schedule/{storeId}

GET store/schedule/{storeId}/holiday

GET store/schedule/{storeId}/special

POST store/schedule/{storeId}

POST store/schedule/{storeId}/holiday/{holidayDayId}

POST store/schedule/{storeId}/special

POST store/schedule/{storeId}/special/{specialDayId}

PUT store/schedule/{storeId}/{storeScheduleId}

DELETE store/schedule/{storeId}/{storeScheduleId}

DELETE store/schedule/{storeId}/special/{specialDayId}

DEPRECATED Utils

Getting StartedThis page explains how developers can get started using Rappi APIs for Restaurants Integration.Integration RequirementsSince integrating with our API requires direct contact with our team, follow these steps to get started.1. Initial ContactTo know the steps to sign up as a Rappi ally, contact your main Rappi point of contact.2. Credential CreationOnce your request is approved, you will receive access credentials for our development environment.3. Documentation ReviewBefore starting development, we recommend reviewing the following resources:API reference documentationAuthentication guide4. Considerations for this apiThis API reference documentation is designed to help you understand the available endpoints, their parameters, and how to use them effectively. It includes detailed descriptions of each endpoint, including request and response formats, required parameters, and examples.It also provides information on how to authenticate your requests, handle errors, and manage pagination.4.1 Endpoint TagsNEW: This tag indicates that the endpoint is new.STABLE: This tag indicates that the endpoint is stable and has been in use for a long time. It is recommended to use stable endpoints in integrations.DEPRECATED: This tag indicates that the endpoint is deprecated and may be removed in future versions of the API. It is recommended to avoid using deprecated endpoints in new integrations.4.2 Endpoint DeprecationEndpoints that are marked as DEPRECATED will continue to function for a period of time, but they may be removed in future versions of the API. We recommend that you avoid using deprecated endpoints in new integrations and migrate to stable or new endpoints as soon as possible.5. Testing in the Developer EnvironmentAfter signing up as a Rappy ally, you receive your Rappi credentials that consist of the following:client\_idclient\_secretUse these Rappi Credentials to create your Access Token with the POST token/login/integrations.After generating your Access Token, you can start using the Rappi API.


After signing up as a Rappy ally, you receive your Rappi credentials that consist of the following:client\_secretclient\_id.POST token/login/integrationsUse these Rappi Credentials to create your Access Token with the After generating your Access Token, you can start using the Rappi API.


5. Testing in the Developer Environment

will continue to function for a period of time, but they may be removed in future versions of the API. We recommend that you avoid using deprecated endpoints in new integrations and migrate to stable or new endpoints as soon as possible.DEPRECATEDEndpoints that are marked as


4.2 Endpoint Deprecation

: This tag indicates that the endpoint is deprecated and may be removed in future versions of the API. It is recommended to avoid using deprecated endpoints in new integrations.DEPRECATED: This tag indicates that the endpoint is stable and has been in use for a long time. It is recommended to use stable endpoints in integrations.STABLE: This tag indicates that the endpoint is new.NEW


4.1 Endpoint Tags

This API reference documentation is designed to help you understand the available endpoints, their parameters, and how to use them effectively. It includes detailed descriptions of each endpoint, including request and response formats, required parameters, and examples.It also provides information on how to authenticate your requests, handle errors, and manage pagination.


4. Considerations for this api

Before starting development, we recommend reviewing the following resources:Authentication guideAPI reference documentation


3. Documentation Review

Once your request is approved, you will receive access credentials for our development environment.


2. Credential Creation

To know the steps to sign up as a Rappi ally, contact your main Rappi point of contact.


1. Initial Contact

Since integrating with our API requires direct contact with our team, follow these steps to get started.


This page explains how developers can get started using Rappi APIs for Restaurants Integration.
NOTE
We are in the process of improving our public APIs, which is why we ask you to always be aware of our official documentation.


The following tables contains all the resources available to use with Utils API:                                                                                                                  | Return the list of products and toppings with status and their availability |         |GET menu/integration/{integrationId}                                       | Product Status                                                                             | Delete a special day                                                        |         |
| DELETE store/schedule/{storeId}/special/{specialDayId}                                                                                                                  | Delete a time slot                                                          |         |
|                                                                                           | DELETE store/schedule/{storeId}/{storeScheduleId}                                                                                                                        | Update a time slot                                                          |         |
|                                                                                           | PUT store/schedule/{storeId}/{storeScheduleId}                                                                                                         | Create a time slot on a store's special day                                 |         |
|                                                                                           | POST store/schedule/{storeId}/special/{specialDayId}                                                                                                                             | Create a special day for the store                                          |         |
|                                                                                           | POST store/schedule/{storeId}/special                                                                                                         | Create a time slot on a holiday                                             |         |
|                                                                                           | POST store/schedule/{storeId}/holiday/{holidayDayId}                                                                                                                                        | Create a time slot on a regular schedule day of the store                   |         |
|                                                                                           | POST store/schedule/{storeId}                                                                                                                          | Returns all the hours of the store's special days                           |         |
|                                                                                           | GET store/schedule/{storeId}/special                                                                                                                          | Returns all holiday hours                                                   |         |
|                                                                                           | GET store/schedule/{storeId}/holiday                                                                                                                                          | Returns all regular store hours                                             |         |
|                                                                                           | GET store/schedule/{storeId}                                         | Store hours | Delete product schedules for the corridor and store                         |         |
| DELETE sku/schedule/{sku}/corridor/{corridorId}/integration/{integrationId}/{corridorProductScheduleId}                                   | Update product schedules for the corridor and store                         |         |
|                                                                                           | PUT sku/schedule/{sku}/corridor/{corridorId}/integration/{integrationId}                                 | Create product schedules for the corridor and store                         |         |
|                                                                                           | POST sku/schedule/{sku}/corridor/{corridorId}/integration/{integrationId}                                   | Returns the product schedules configured for the corridor and store         |         |
|                                                                                           | GET sku/schedule/{sku}/corridor/{corridorId}/integration/{integrationId}                                                               | Returns the collection of products for the corridor and store               |         |
|                                                                                           | GET sku/corridor/{corridorId}/integration/{integrationId}                   | Product Schedules by SKU            | Delete product schedules for the corridor and store                         |         |
| DELETE product/schedule/{productId}/corridor/{corridorId}/store/{storeId}/{corridorProductScheduleId}                                              | Update product schedules for the corridor and store                         |         |
|                                                                                           | PUT product/schedule/{productId}/corridor/{corridorId}/store/{storeId}                                            | Create product schedules for the corridor and store                         |         |
|                                                                                           | POST product/schedule/{productId}/corridor/{corridorId}/store/{storeId}                                              | Returns the product schedules configured for the corridor and store         |         |
|                                                                                           | GET product/schedule/{productId}/corridor/{corridorId}/store/{storeId}                                                                                      | Returns the collection of products for the corridor and store               |         |
|                                                                                           | GET product/corridor/{corridorId}/store/{storeId}                                 | Product Schedules          | Delete corridor schedules for the store                                     |         |
| DELETE corridor/schedule/{corridorId}/integration/{integrationId}/{corridorProductScheduleId}                                            | Update corridor schedules for the store                                     |         |
|                                                                                           | PUT corridor/schedule/{corridorId}/integration/{integrationId}                                          | Create corridor schedules for the store                                     |         |
|                                                                                           | POST corridor/schedule/{corridorId}/integration/{integrationId}                                            | Returns the corridor schedules configured for the store                     |         |
|                                                                                           | GET corridor/schedule/{corridorId}/integration/{integrationId}                                                                                       | Returns the collection of corridors for the store                           |         |
|                                                                                           | GET corridor/integration/{integrationId} | Corridor Schedules by Integration                                                 | Delete corridor schedules for the store                                     |         |
| DELETE corridor/schedule/{corridorId}/store/{storeId}/{corridorProductScheduleId}                                                                                   | Update corridor schedules for the store                                     |         |
|                                                                                           | PUT corridor/schedule/{corridorId}/store/{storeId}                                                                                 | Create corridor schedules for the store                                     |         |
|                                                                                           | POST corridor/schedule/{corridorId}/store/{storeId}                                                                                   | Returns the corridor schedules configured for the store                     |         |
|                                                                                           | GET corridor/schedule/{corridorId}/store/{storeId}                                                                                                                              | Returns the collection of corridors for the store                           |         |
|                                                                                           | GET corridor/store/{storeId}                               | Corridor Schedules |
| NEW                                                                                                                              | Use this endpoint to generate an access token for utils services            | POST /restaurants/auth/v1/token/login/utils                                       | Authentication| API Resource                                                                              | Endpoint                                                                                                                                                                                                                         | Endpoint Description                                                        |         |
| ----------------------------------------------------------------------------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | --------------------------------------------------------------------------- | ------- |
|


The following table contains all the resources available to use with our API:                                                                                              | Enables or disables the webhooks for a list of stores                                                  |         |PUT webhook/{event}/change-status                                                                                                | Restarts the secret and generates a new one for the authenticated client                               |         |
|                                                     | PUT webhook/{event}/reset-secret                                                                                                      | Deletes stores from your webhook                                                                       |         |
|                                                     | DELETE webhook/{event}/remove-stores                                                                                                                                | Creates a new webhook for a list of stores for the authenticated client                                |         |
|                                                     | POST webhook                                                                                                    | Change url from stores                                                                                 |         |
|                                                     | PUT webhook/{event}/change-url                                                                                                    | Add stores to a specific webhook event                                                                 |         |
|                                                     | PUT webhook/{event}/add-stores                                                                                                                          | Returns the webhooks configured for all the stores of the authenticated client                         |         |
|                                                     | GET webhook/{event}             | Webhooks                                                                                        | Manage store availability synchronously in the application                                             |         |
| PUT availability/stores/enable                                                                        | Manage store availability asynchronously in the application                                            |         |
|                                                     | PUT availability/stores/enable/massive                                                                                                      | Manage store availability in the application                                                           |         |
|                                                     | PUT availability/stores                                                                              | Manage item availability in the application by Item ID                                                 |         |
|                                                     | PUT availability/stores/items/rappi                                                                                          | Manage item availability in the application by Item SKU                                                |         |
|                                                     | PUT availability/stores/items                                                                            | Returns the availability of items by Item ID                                                           |         |
|                                                     | POST availability/items/rappi/status                                                                                        | Returns the availability of items by Item SKU                                                          |         |
|                                                     | POST availability/items/status     | Availability                                                                                              | Update a store to integrated or not integrated                                                         |         |
| PUT stores-pa/{storeId}/status                                                                                                                                | Returns the list of stores for the authenticated client                                                |         |
|                                                     | GET stores-pa                 | Stores |
| NEW | Use this endpoint to confirm the number of bags and if there are drinks outside the bags in the order. | POST /restaurants/orders/v1/stores/{storeId}/orders/{orderId}/bag-drink-confirmation |
|                                                     | NEW                                 | Use this endpoint to take an order so that the store can start preparing it.                           | GET /restaurants/orders/v1/stores/{storeId}/orders/{orderId}/handoff                                                                                                     | Returns the latest events from the orders                                                              |         |
|                                                     | GET orders/{orderId}/events                                                                               | Confirms that the order is ready for pickup                                                            |         |
|                                                     | POST orders/{orderId}/ready-for-pickup                                                                                                     | Rejects an order                                                                                       |         |
|                                                     | PUT orders/{orderId}/reject                                                                              | Takes an order to start preparing                                                                      |         |
|                                                     | PUT orders/{orderId}/take/{cookingTime}                                                         |         |
|                                                     | SENT                                                                                                              | Returns a list of new orders created in GET orders/status/sent                                                                                                                                      | Returns a list of new orders created                                                                   |         |
|                                                     | GET orders                 | Orders |
| NEW                         | Returns the availability of products and toppings by SKU or ID in the Rappi app                        | POST /restaurants/menu/v1/stores/{storeId}/items/{identityType}/stock/status |
|                                                     | NEW                               | Asynchronously manages the availability of products and toppings by SKU or ID in the Rappi app         | PATCH /restaurants/menu/v1/stores/{storeId}/items/{identityType}/stock |
|                                                     | NEW                   | Returns the availability of toppings by SKU or ID in the Rappi app                                     | POST /restaurants/menu/v1/stores/{storeId}/toppings/{identityType}/stock/status |
|                                                     | NEW                         | Asynchronously manages the availability of toppings by SKU or ID in the Rappi app                      | PATCH /restaurants/menu/v1/stores/{storeId}/toppings/{identityType}/stock |
|                                                     | NEW                   | Returns the availability of products by SKU or ID in the Rappi app                                     | POST /restaurants/menu/v1/stores/{storeId}/products/{identityType}/stock/status |
|                                                     | NEW                                 | Asynchronously manages the availability of products by SKU or ID in the Rappi app                      | PATCH /restaurants/menu/v1/stores/{storeId}/products/{identityType}/stock                                                                                                            | Returns the last menu created for a store                                                              |         |
|                                                     | GET menu/rappi/{storeId}                                                                                                      | Returns the current approval status of a menu                                                          |         |
|                                                     | GET menu/approved/{storeId}                                                                                                                                         | Creates or updates a menu in a store                                                                   |         |
|                                                     | POST menu                                                                                                                                           | Returns the collection of menus created by the authenticating ally                                     |         |
|                                                     | GET menu                   | Menus |
| NEW                                                                         | Use this endpoint to generate an access token for integrations services                                | POST /restaurants/auth/v1/token/login/integrations | Authentication| API Resource                                        | Endpoint                                                                                                                                                                                  | Endpoint Description                                                                                   |         |
| --------------------------------------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------ | ------- |
|


The Rappi API includes all the resources, endpoints, and methods that allow you to integrate with the Rappi app, as well as manage all your products, menus, orders, menu schedules, and product availability.


AuthenticationTo authenticate when making API requests to the Rappi API, you require an Access Token.The Rappi API uses a Bearer authentication scheme, as the HTTP authentication method for API requests.To make API requests, send the token in a customer header to interact with protected resources.Rappi uses the following scheme for the Bearer authentication:| Key               | Value                    |
| ----------------- | ------------------------ |
| x-authorization | Bearer: \<access\_token> |The following table describes the different contents of the Authentication resource:| Resource                                                       | Description                                                             | Observations |
| -------------------------------------------------------------- | ----------------------------------------------------------------------- | ------------ |
| POST v1/token/login/integrations | Use this endpoint to generate an access token for integrations services | \_New\_      |
| POST v1/token/login/utils               | Use this endpoint to generate an access token for utils services        | \_new\_      |POST integrations loginUse this endpoint to generate an access token. This token allows you to authenticate when making API requests for integrations.Endpoint URLUse the following URLs to make a request with this endpoint:URL: https://{NEW\_DOMAIN}/restaurants/auth/v1/token/login/integrations{NEW\_DOMAIN}: This is your new Rappi Country Domain. See the list of new Country Domains.Endpoint PropertiesThis resource has the following properties:|                 |        |
| --------------- | ------ |
| request body  | json |
| response body | json |ParametersThis endpoint does not permit additional parameters.Sample RequestThis is an example of an API request using this endpoint:POST https://api.dev.rappi.com/restaurants/auth/v1/token/login/integrationsThis is an example of the request:This table describes the attributes that the JSON of your request requires:| Attributes      |          | Requested | Description                              |
| --------------- | -------- | --------- | ---------------------------------------- |
| client\_id     | string | true    | Client Id of your Rappi Credentials.     |
| client\_secret | string | true    | Client Secret of your Rappi Credentials. |Status CodesThese are the possible status codes of the response for this endpoint:200 Success403 UnauthorizedSample ResponseThis is an example of the response:This table describes the objects contained in the response example:| Response Object |           | Object Description                       |
| --------------- | --------- | ---------------------------------------- |
| access\_token  | string  | Access token to access secure endpoints. |
| token\_type    | string  | Token type.                              |
| expires\_in    | integer | Token expiration time in seconds.        |POST utils loginUse this endpoint to generate an access token. This token allows you to authenticate when making API requests for utils.Endpoint URLUse the following URLs to make a request with this endpoint:URL: https://{NEW\_DOMAIN}/restaurants/auth/v1/token/login/utils{NEW\_DOMAIN}: This is your new Rappi Country Domain. See the list of new Country Domains.Endpoint PropertiesThis resource has the following properties:|                 |        |
| --------------- | ------ |
| request body  | json |
| response body | json |ParametersThis endpoint does not permit additional parameters.Sample RequestThis is an example of an API request using this endpoint:POST https://api.dev.rappi.com/restaurants/auth/v1/token/login/utilsThis is an example of the request:This table describes the attributes that the JSON of your request requires:| Attributes      |          | Requirement | Description                              |
| --------------- | -------- | ----------- | ---------------------------------------- |
| client\_id     | string | required  | Client Id of your Rappi Credentials.     |
| client\_secret | string | required  | Client Secret of your Rappi Credentials. |Status CodesThese are the possible status codes of the response for this endpoint:200 Success403 UnauthorizedSample ResponseThis is an example of the response:This table describes the objects contained in the response example:| Response Object |           | Object Description                       |
| --------------- | --------- | ---------------------------------------- |
| access\_token  | string  | Access token to access secure endpoints. |
| token\_type    | string  | Token type.                              |
| expires\_in    | integer | Token expiration time in seconds.        |


This is an example of the response:{
"access\_token": "eyJhbGciOiJIUzI1NiIsInR5cCI6IkpeyJhbGciOiJIUzI1NiIsInR5cCI6IkpeyJhbGciOiJIUzI1NiIsInR5cCI6Ikp",
"token\_type": "Bearer",
"expires\_in": 604798
}This table describes the objects contained in the response example: | Token expiration time in seconds.        |integer    | expires\_in  | Token type.                              |
| string    | token\_type  | Access token to access secure endpoints. |
| string  | access\_token| Response Object |           | Object Description                       |
| --------------- | --------- | ---------------------------------------- |
|


Sample Response

These are the possible status codes of the response for this endpoint: Success200


Status Codes

This is an example of an API request using this endpoint:POST https://api.dev.rappi.com/restaurants/auth/v1/token/login/utilsThis is an example of the request:{
"client\_id": "7iCfjZCO4bTns3OjqLK4de2GV3sp6Ymd",
"client\_secret": "40iFFYJV9A1LrVmJsaIeARW40iFFYJV9A1LrVmJsaIeARW40iFFYJV9A1LrVmJsaIeARW"
} of your request requires:JSONThis table describes the attributes that the   | Client Secret of your Rappi Credentials. |required | string | client\_secret  | Client Id of your Rappi Credentials.     |
| required | string     | client\_id| Attributes      |          | Requirement | Description                              |
| --------------- | -------- | ----------- | ---------------------------------------- |
| curl --location 'https://api.dev.rappi.com/restaurants/auth/v1/token/login/utils'&#x20;
\--header 'Content-Type: application/json'&#x20;
\--data
'{
"client\_id": "4jleVdIkQm3yeZsSeu57BgZGbqGJ50h9",
"client\_secret": "pulfNKGM-4SfsEJJukF9b-bgPFMOA4x92axJs5yzooyLRn5wMdLNRIg\_AP6o5LYq"
}'URL url = new URL("https://api.dev.rappi.com/restaurants/auth/v1/token/login/utils");HttpURLConnection connection = (HttpURLConnection) url.openConnection();
connection.setRequestMethod("POST");
connection.setRequestProperty("User-Agent", "Mozilla/5.0");
connection.setRequestProperty("Content-Type", "application/json");
connection.setRequestProperty("Accept", "application/json");
connection.setDoOutput(true);final String jsonInputString = "{\n" +
"   "client\_id":"7iCfjZCO4bTns3OjqLK4de2GV3sp6Ymd",\n" +
"   "client\_secret":"40iFFYJV9A1LrVmJsaIeARW40iFFYJV9A1LrVmJsaIeARW40iFFYJV9A1LrVmJsaIeARW"\n" +
"}";try (OutputStream os = connection.getOutputStream()) {
byte\[] input = jsonInputString.getBytes(StandardCharsets.UTF\_8);
os.write(input, 0, input.length);
}try (BufferedReader br = new BufferedReader(new InputStreamReader(connection.getInputStream(), StandardCharsets.UTF\_8))) {
StringBuilder response = new StringBuilder();
String responseLine;
while ((responseLine = br.readLine()) != null) {
response.append(responseLine.trim());
}
System.out.println("Response body: " + response.toString());
}
System.out.println("Response Code : " + connection.getResponseCode());import requestsurl = "https://api.dev.rappi.com/restaurants/auth/v1/token/login/utils"payload = "{ "client\_id":"7iCfjZCO4bTns3OjqLK4de2GV3sp6Ymd","&#x20;
""client\_secret":"40iFFYJV9A1LrVmJsaIeARW40iFFYJV9A1LrVmJsaIeARW40iFFYJV9A1LrVmJsaIeARW" }"
headers = { 'Content-Type': 'application/json' }response = requests.request("POST", url, headers=headers, data=payload)print(response.text.encode('utf8'))var https = require("https");var options = {
method: "POST",
hostname: "api.dev.rappi.com",
path: "/restaurants/auth/v1/token/login/utils?",
headers: {
"Content-Type": "application/json",
},
};var req = https.request(options, function (res) {
var chunks = \[];res.on("data", function (chunk) {
chunks.push(chunk);
});res.on("end", function (chunk) {
var body = Buffer.concat(chunks);
console.log(body.toString());
});res.on("error", function (error) {
console.error(error);
});
});var postData = JSON.stringify({
client\_id: "7iCfjZCO4bTns3OjqLK4de2GV3sp6Ymd",
client\_secret:
"40iFFYJV9A1LrVmJsaIeARW40iFFYJV9A1LrVmJsaIeARW40iFFYJV9A1LrVmJsaIeARW",
});req.write(postData);req.end();package mainimport (
"fmt"
"io/ioutil"
"net/http"
"strings"
)func main() {}


Sample Request

This endpoint does not permit additional parameters.


Parameters

This resource has the following properties: |json | response body |
| json  | request body|                 |        |
| --------------- | ------ |
|


Endpoint Properties

Use the following URLs to make a request with this endpoint:https://{NEW\_DOMAIN}/restaurants/auth/v1/token/login/utils: URL.See the list of new Country Domains: This is your new Rappi Country Domain. {NEW\_DOMAIN}
NOTE
For samples of API requests on this site, we use the Developer domain: https://api.dev.rappi.com
IMPORTANT:  Your access token has a validity of 1 week


Endpoint URL

Use this endpoint to generate an access token. This token allows you to authenticate when making API requests for utils.


This is an example of the response:{
"access\_token": "eyJhbGciOiJIUzI1NiIsInR5cCI6IkpeyJhbGciOiJIUzI1NiIsInR5cCI6IkpeyJhbGciOiJIUzI1NiIsInR5cCI6Ikp",
"token\_type": "Bearer",
"expires\_in": 86400
}This table describes the objects contained in the response example: | Token expiration time in seconds.        |integer    | expires\_in  | Token type.                              |
| string    | token\_type  | Access token to access secure endpoints. |
| string  | access\_token| Response Object |           | Object Description                       |
| --------------- | --------- | ---------------------------------------- |
|


This is an example of an API request using this endpoint:POST https://api.dev.rappi.com/restaurants/auth/v1/token/login/integrationsThis is an example of the request:{
"client\_id": "7iCfjZCO4bTns3OjqLK4de2GV3sp6Ymd",
"client\_secret": "40iFFYJV9A1LrVmJsaIeARW40iFFYJV9A1LrVmJsaIeARW40iFFYJV9A1LrVmJsaIeARW"
} of your request requires:JSONThis table describes the attributes that the     | Client Secret of your Rappi Credentials. |true | string | client\_secret    | Client Id of your Rappi Credentials.     |
| true | string     | client\_id| Attributes      |          | Requested | Description                              |
| --------------- | -------- | --------- | ---------------------------------------- |
| curl --location 'https://api.dev.rappi.com/restaurants/auth/v1/token/login/integrations'&#x20;
\--header 'Content-Type: application/json'&#x20;
\--data
'{
"client\_id": "4jleVdIkQm3yeZsSeu57BgZGbqGJ50h9",
"client\_secret": "pulfNKGM-4SfsEJJukF9b-bgPFMOA4x92axJs5yzooyLRn5wMdLNRIg\_AP6o5LYq"
}'URL url = new URL("https://api.dev.rappi.com/restaurants/auth/v1/token/login/integrations");HttpURLConnection connection = (HttpURLConnection) url.openConnection();
connection.setRequestMethod("POST");
connection.setRequestProperty("User-Agent", "Mozilla/5.0");
connection.setRequestProperty("Content-Type", "application/json");
connection.setRequestProperty("Accept", "application/json");
connection.setDoOutput(true);final String jsonInputString = "{\n" +
"   "client\_id":"7iCfjZCO4bTns3OjqLK4de2GV3sp6Ymd",\n" +
"   "client\_secret":"40iFFYJV9A1LrVmJsaIeARW40iFFYJV9A1LrVmJsaIeARW40iFFYJV9A1LrVmJsaIeARW"\n" +
"}";try (OutputStream os = connection.getOutputStream()) {
byte\[] input = jsonInputString.getBytes(StandardCharsets.UTF\_8);
os.write(input, 0, input.length);
}try (BufferedReader br = new BufferedReader(new InputStreamReader(connection.getInputStream(), StandardCharsets.UTF\_8))) {
StringBuilder response = new StringBuilder();
String responseLine;
while ((responseLine = br.readLine()) != null) {
response.append(responseLine.trim());
}
System.out.println("Response body: " + response.toString());
}
System.out.println("Response Code : " + connection.getResponseCode());import requestsurl = "https://api.dev.rappi.com/restaurants/auth/v1/token/login/integrations"payload = "{ "client\_id":"7iCfjZCO4bTns3OjqLK4de2GV3sp6Ymd","&#x20;
""client\_secret":"40iFFYJV9A1LrVmJsaIeARW40iFFYJV9A1LrVmJsaIeARW40iFFYJV9A1LrVmJsaIeARW" }"
headers = { 'Content-Type': 'application/json' }response = requests.request("POST", url, headers=headers, data=payload)print(response.text.encode('utf8'))var https = require("https");var options = {
method: "POST",
hostname: "api.dev.rappi.com",
path: "/restaurants/auth/v1/token/login/integrations?",
headers: {
"Content-Type": "application/json",
},
};var req = https.request(options, function (res) {
var chunks = \[];res.on("data", function (chunk) {
chunks.push(chunk);
});res.on("end", function (chunk) {
var body = Buffer.concat(chunks);
console.log(body.toString());
});res.on("error", function (error) {
console.error(error);
});
});var postData = JSON.stringify({
client\_id: "7iCfjZCO4bTns3OjqLK4de2GV3sp6Ymd",
client\_secret:
"40iFFYJV9A1LrVmJsaIeARW40iFFYJV9A1LrVmJsaIeARW40iFFYJV9A1LrVmJsaIeARW",
});req.write(postData);req.end();package mainimport (
"fmt"
"io/ioutil"
"net/http"
"strings"
)func main() {}


Use the following URLs to make a request with this endpoint:https://{NEW\_DOMAIN}/restaurants/auth/v1/token/login/integrations: URL.See the list of new Country Domains: This is your new Rappi Country Domain. {NEW\_DOMAIN}
NOTE
For samples of API requests on this site, we use the Developer domain: https://api.dev.rappi.com
IMPORTANT:  Your access token has a validity of 1 week


Use this endpoint to generate an access token. This token allows you to authenticate when making API requests for integrations.


.Access TokenTo authenticate when making API requests to the Rappi API, you require an  scheme, as the HTTP authentication method for API requests.Bearer authenticationThe Rappi API uses a  to interact with protected resources.customer headerTo make API requests, send the token in a Rappi uses the following scheme for the Bearer authentication: |Bearer: \<access\_token> | x-authorization| Key               | Value                    |
| ----------------- | ------------------------ |
| The following table describes the different contents of the Authentication resource:      |new               | Use this endpoint to generate an access token for utils services        | POST v1/token/login/utils      |
| New | Use this endpoint to generate an access token for integrations services | POST v1/token/login/integrations| Resource                                                       | Description                                                             | Observations |
| -------------------------------------------------------------- | ----------------------------------------------------------------------- | ------------ |
|


Authentication

This is an example of the response:\[
{
"event": "canceled\_with\_charge",
"event\_time": "2020-05-28T12:31:12.501Z",
"additional\_information": {}
},
{
"event": "taken\_visible\_order",
"event\_time": "2020-05-28T12:30:12.501Z",
"additional\_information": {
"eta\_to\_store": "15"
}
}
]This table describes the objects contained in the response example: | Courier estimated time of arrival to the store.                                   |stringadditional\_information.eta\_to\_store    | Additional information for the order. The format can vary depending on the event. |
| array of objectsadditional\_information'Z'.                      |
| HH:mm:ss.SSS'T'yyyy-MM-dd                          | Time of the event. Format: stringevent\_time                               | Latest order event.                                                               |
| stringevent| Response Object                                    | Object Description                                                                |
| -------------------------------------------------- | --------------------------------------------------------------------------------- |
|


These are the possible status codes of the response for this endpoint: Success200 Invalid credentials401 Order not found404


This is an example of an API request using this endpoint:GET https://microservices.dev.rappi.com/api/v2/restaurants-integrations-public-api/orders/392625/eventsThis is an example of the request:final Integer orderId = 392625;URL url = new URL(String.format("https://microservices.dev.rappi.com/api/v2/restaurants-integrations-public-api/orders/%s/events", orderId));HttpURLConnection connection = (HttpURLConnection) url.openConnection();
connection.setRequestMethod("GET");
connection.setRequestProperty("User-Agent", "Mozilla/5.0");
connection.setRequestProperty("Content-Type", "application/json");
connection.setRequestProperty("Accept", "application/json");
connection.setRequestProperty("x-authorization", "Bearer YOUR\_TOKEN");try (BufferedReader br = new BufferedReader(new InputStreamReader(connection.getInputStream(), StandardCharsets.UTF\_8))) {
StringBuilder response = new StringBuilder();
String responseLine;
while ((responseLine = br.readLine()) != null) {
response.append(responseLine.trim());
}
System.out.println("Response body: " + response.toString());
}
System.out.println("Response Code : " + connection.getResponseCode());var https = require("https");var options = {
method: "GET",
hostname: "microservices.dev.rappi.com",
path: "/api/v2/restaurants-integrations-public-api/orders/392625/events",
headers: {
"Content-Type": "application/json",
"x-authorization": "Bearer YOUR\_TOKEN",
},
};var req = https.request(options, function (res) {
var chunks = \[];res.on("data", function (chunk) {
chunks.push(chunk);
});res.on("end", function (chunk) {
var body = Buffer.concat(chunks);
console.log(body.toString());
});res.on("error", function (error) {
console.error(error);
});
});req.end();import requestsurl = "https://microservices.dev.rappi.com/api/v2/restaurants-integrations-public-api/orders/392625/events"payload = {}
headers = {
'Content-Type': 'application/json',
'x-authorization': 'Bearer YOUR\_TOKEN'
}response = requests.request("GET", url, headers=headers, data=payload)print(response.text.encode('utf8'))package mainimport (
"fmt"
"net/http"
"io/ioutil"
)func main() {}


This resource has the following properties: |
| Authentication requirements | Token  |JSON|                             |        |
| --------------------------- | ------ |
| Response formats            |


Use this URL to make a request with this endpoint:https://{COUNTRY\_DOMAIN}/api/v2/restaurants-integrations-public-api/orders/{orderId}/events: This is the identifier of your order.{orderId}See the list of Country Domains.: This is your Rappi Country Domain. {COUNTRY\_DOMAIN}


Use this endpoint to retrieve the latest status updates from your orders.


This endpoint returns a status response code only.


This is an example of an API request using this endpoint:POST https://microservices.dev.rappi.com/api/v2/restaurants-integrations-public-api/orders/392625/ready-for-pickupThis is an example of the request:final Integer orderId = 392625;URL url = new URL(String.format("https://microservices.dev.rappi.com/api/v2/restaurants-integrations-public-api/orders/%s/ready-for-pickup", orderId));HttpURLConnection connection = (HttpURLConnection) url.openConnection();
connection.setRequestMethod("POST");
connection.setRequestProperty("User-Agent", "Mozilla/5.0");
connection.setRequestProperty("Content-Type", "application/json");
connection.setRequestProperty("Accept", "application/json");
connection.setRequestProperty("x-authorization", "Bearer YOUR\_TOKEN");System.out.println("Response Code : " + connection.getResponseCode());var https = require("https");var options = {
method: "POST",
hostname: "microservices.dev.rappi.com",
path: "/api/v2/restaurants-integrations-public-api/orders/392625/ready-for-pickup",
headers: {
"Content-Type": "application/json",
"x-authorization": "Bearer YOUR\_TOKEN",
},
};var req = https.request(options, function (res) {
var chunks = \[];res.on("data", function (chunk) {
chunks.push(chunk);
});res.on("end", function (chunk) {
var body = Buffer.concat(chunks);
console.log(body.toString());
});res.on("error", function (error) {
console.error(error);
});
});req.end();import requestsurl = "https://microservices.dev.rappi.com/api/v2/restaurants-integrations-public-api/orders/392625/ready-for-pickup"payload = {}
headers = {
'Content-Type': 'application/json',
'x-authorization': 'Bearer YOUR\_TOKEN'
}response = requests.request("POST", url, headers=headers, data=payload)print(response.text.encode('utf8'))package mainimport (
"fmt"
"net/http"
"io/ioutil"
)func main() {}


These are the possible status codes of the response for this endpoint: Order successfully updated200 Invalid state transition400 Invalid credentials401 Order not found404


This endpoint does not permit additional parameters.!!! important
To prevent misuse of the endpoint, we reserve the right to revoke access to clients who use it improperly. Therefore, after three requests, the system will stop executing additional actions, and any further attempts will be considered improper use of the endpoint.


Use this URL to make a request with this endpoint:https://{COUNTRY\_DOMAIN}/api/v2/restaurants-integrations-public-api/orders/{orderId}/ready-for-pickup: This is the identifier of your order.{orderId}See the list of Country Domains.: This is your Rappi Country Domain. {COUNTRY\_DOMAIN}


Use this endpoint to notify the courier in the Rappi application that the order is ready for pickup.
When the first request is made, if no courier is assigned, the system will speed up the assignment process; if a courier is already assigned, a notification will be sent to them, and the order status will change to READY\_FOR\_PICKUP. On the second request, if a courier is already assigned, a new notification will be sent to the assigned courier.


This is an example of an API request using this endpoint:PUT https://microservices.dev.rappi.com/api/v2/restaurants-integrations-public-api/orders/392625/rejectThis is an example of the request:{
"reason": "The order has invalid items"
}This is an example of the request with offending items:{
"reason": "The order has invalid items",
"cancel\_type": "ITEM\_NOT\_FOUND",
"items\_skus": \["sku1", "sku2"]
}final Integer orderId = 3320025;URL url = new URL(String.format("https://microservices.dev.rappi.com/api/v2/restaurants-integrations-public-api/orders/%s/reject", orderId));HttpURLConnection connection = (HttpURLConnection) url.openConnection();
connection.setRequestMethod("PUT");
connection.setRequestProperty("User-Agent", "Mozilla/5.0");
connection.setRequestProperty("Content-Type", "application/json");
connection.setRequestProperty("Accept", "application/json");
connection.setRequestProperty("x-authorization", "Bearer YOUR\_TOKEN");
connection.setDoOutput(true);String jsonInputString = "{"reason":"The order has invalid items"}";try (OutputStream os = connection.getOutputStream()) {
byte\[] input = jsonInputString.getBytes(StandardCharsets.UTF\_8);
os.write(input, 0, input.length);
}System.out.println("Response Code : " + connection.getResponseCode());var https = require("https");var options = {
method: "PUT",
hostname: "microservices.dev.rappi.com",
path: "/api/v2/restaurants-integrations-public-api/orders/392625/reject",
headers: {
"Content-Type": "application/json",
"x-authorization": "Bearer YOUR\_TOKEN",
},
maxRedirects: 20,
};var req = https.request(options, function (res) {
var chunks = \[];res.on("data", function (chunk) {
chunks.push(chunk);
});res.on("end", function (chunk) {
var body = Buffer.concat(chunks);
console.log(body.toString());
});res.on("error", function (error) {
console.error(error);
});
});var postData = JSON.stringify({ reason: "The order has invalid items" });req.write(postData);req.end();import requestsurl = "https://microservices.dev.rappi.com/api/v2/restaurants-integrations-public-api/orders/392625/reject"payload = "{"reason":"The order has invalid items"}"
headers = {
'Content-Type': 'application/json',
'x-authorization': 'Bearer YOUR\_TOKEN'
}response = requests.request("PUT", url, headers=headers, data=payload)print(response.text.encode('utf8'))package mainimport (
"fmt"
"strings"
"net/http"
"io/ioutil"
)func main() {} of your request requires:JSONThis table describes the attributes that the   | Reason to reject the order |required | stringreason| Attributes            | Requirement | Description                |
| --------------------- | ----------- | -------------------------- |
|


These are the possible status codes of the response for this endpoint: Order successfully rejected200 Invalid state transition400 Invalid credentials401 Order not found404


|"ORDER\_TOTAL\_INCORRECT", "ORDER\_MISSING\_ADDRESS\_INFORMATION", "ORDER\_MISSING\_INFORMATION", "ITEM\_OUT\_OF\_STOCK", "ITEM\_NOT\_FOUND", "ITEM\_WRONG\_PRICE"  | Enum: required | enumerable stringcancel\_type  | List of offending items skus. Here you should use your skus                                                                                                            |
| optional           | array of stringitems\_skus  | List of offending items ids. Here you should use the rappi ids                                                                                                         |
| optional            | array of stringitems\_ids  | Rejects a specific order.                                                                                                                                              |
| required                       | stringorderId| Name                                         | Requirement | Description                                                                                                                                                            |
| -------------------------------------------- | ----------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| 


This resource has the following properties: |
| Authentication requirements | Token  |JSON |
| Request body requirements   | JSON|                             |        |
| --------------------------- | ------ |
| Response formats            |


Use this URL to make a request with this endpoint:https://{COUNTRY\_DOMAIN}/api/v2/restaurants-integrations-public-api/orders/{orderId}/reject: This is the identifier of the order.{orderId}See the list of Country Domains.: This is your Rappi Country Domain. {COUNTRY\_DOMAIN}


This is an example of an API request using this endpoint:PUT https://microservices.dev.rappi.com/api/v2/restaurants-integrations-public-api/orders/392625/take/20this is an example of the request:final Integer orderId = 392625;
final Integer cookingTime = 20;URL url = new URL(String.format("https://microservices.dev.rappi.com/api/v2/restaurants-integrations-public-api/orders/%s/take/%s", orderId, cookingTime));HttpURLConnection connection = (HttpURLConnection) url.openConnection();
connection.setRequestMethod("PUT");
connection.setRequestProperty("User-Agent", "Mozilla/5.0");
connection.setRequestProperty("Content-Type", "application/json");
connection.setRequestProperty("Accept", "application/json");
connection.setRequestProperty("x-authorization", "Bearer YOUR\_TOKEN");
connection.setDoOutput(true);System.out.println("Response Code : " + connection.getResponseCode());var https = require("https");var options = {
method: "PUT",
hostname: "microservices.dev.rappi.com",
path: "/api/v2/restaurants-integrations-public-api/orders/392625/take/20",
headers: {
"Content-Type": "application/json",
"x-authorization": "Bearer YOUR\_TOKEN",
},
};var req = https.request(options, function (res) {
var chunks = \[];res.on("data", function (chunk) {
chunks.push(chunk);
});res.on("end", function (chunk) {
var body = Buffer.concat(chunks);
console.log(body.toString());
});res.on("error", function (error) {
console.error(error);
});
});req.end();import requestsurl = "https://microservices.dev.rappi.com/api/v2/restaurants-integrations-public-api/orders/392625/take/20"payload = {}
headers = {
'Content-Type': 'application/json',
'x-authorization': 'Bearer YOUR\_TOKEN'
}response = requests.request("PUT", url, headers=headers, data=payload)print(response.text.encode('utf8'))package mainimport (
"fmt"
"net/http"
"io/ioutil"
)func main() {}


These are the possible status codes of the response for this endpoint: Order successfully taken200 Invalid state transition400 Invalid credentials401 Order not found404


Use this URL to make a request with this endpoint:https://{COUNTRY\_DOMAIN}/api/v2/restaurants-integrations-public-api/orders/{orderId}/take/{cookingTime}: This is the new cooking time of the order. You can leave this field empty to keep the default cooking time of the order.{cookingTime}: This is the identifier of the order.{orderId}See the list of Country Domains.: This is your Rappi Country Domain. {COUNTRY\_DOMAIN}


Use this endpoint to take an order, so the store commences preparing it.


This is an example of an API request using this endpoint:GET https://microservices.dev.rappi.com/api/v2/restaurants-integrations-public-api/orders/status/sentthis is an example of the request:URL url = new URL("https://microservices.dev.rappi.com/api/v2/restaurants-integrations-public-api/orders/status/sent");HttpURLConnection connection = (HttpURLConnection) url.openConnection();
connection.setRequestMethod("GET");
connection.setRequestProperty("User-Agent", "Mozilla/5.0");
connection.setRequestProperty("Content-Type", "application/json");
connection.setRequestProperty("Accept", "application/json");
connection.setRequestProperty("x-authorization", "Bearer YOUR\_TOKEN");try (BufferedReader br = new BufferedReader(new InputStreamReader(connection.getInputStream(), StandardCharsets.UTF\_8))) {
StringBuilder response = new StringBuilder();
String responseLine;
while ((responseLine = br.readLine()) != null) {
response.append(responseLine.trim());
}
System.out.println("Response body: " + response.toString());
}
System.out.println("Response Code : " + connection.getResponseCode());var https = require("https");var options = {
method: "GET",
hostname: "microservices.dev.rappi.com",
path: "/api/v2/restaurants-integrations-public-api/orders/status/sent",
headers: {
"Content-Type": "application/json",
"x-authorization": "Bearer YOUR\_TOKEN",
},
};var req = https.request(options, function (res) {
var chunks = \[];res.on("data", function (chunk) {
chunks.push(chunk);
});res.on("end", function (chunk) {
var body = Buffer.concat(chunks);
console.log(body.toString());
});res.on("error", function (error) {
console.error(error);
});
});req.end();import requestsurl = "https://microservices.dev.rappi.com/api/v2/restaurants-integrations-public-api/orders/status/sent"payload = {}
headers = {
'Content-Type': 'application/json',
'x-authorization': 'Bearer YOUR\_TOKEN'
}response = requests.request("GET", url, headers=headers, data=payload)print(response.text.encode('utf8'))package mainimport (
"fmt"
"net/http"
"io/ioutil"
)func main() {}


These are the possible status codes of the response for this endpoint: Success200 The store don't belong to the appClient of given id400 Invalid credentials401 Store not found404


This endpoint admits the following optional additional parameters: | Returns only the orders from a specific store |{storeId}| Parameter   | Description                                   |
| ----------- | --------------------------------------------- |
|


Use this URL to make a request with this endpoint:https://{COUNTRY\_DOMAIN}/api/v2/restaurants-integrations-public-api/orders/status/sentSee the list of Country Domains.: This is your Rappi Country Domain. {COUNTRY\_DOMAIN}


for the stores of the authenticating ally.SENTUse this endpoint to return a collection of all the new orders status


This is an example of an API request using this endpoint:GET https://microservices.dev.rappi.com/api/v2/restaurants-integrations-public-api/ordersthis is an example of the request:URL url = new URL("https://microservices.dev.rappi.com/api/v2/restaurants-integrations-public-api/orders");HttpURLConnection connection = (HttpURLConnection) url.openConnection();
connection.setRequestMethod("GET");
connection.setRequestProperty("User-Agent", "Mozilla/5.0");
connection.setRequestProperty("Content-Type", "application/json");
connection.setRequestProperty("Accept", "application/json");
connection.setRequestProperty("x-authorization", "Bearer YOUR\_TOKEN");try (BufferedReader br = new BufferedReader(new InputStreamReader(connection.getInputStream(), StandardCharsets.UTF\_8))) {
StringBuilder response = new StringBuilder();
String responseLine;
while ((responseLine = br.readLine()) != null) {
response.append(responseLine.trim());
}
System.out.println("Response body: " + response.toString());
}
System.out.println("Response Code : " + connection.getResponseCode());var https = require("https");var options = {
method: "GET",
hostname: "microservices.dev.rappi.com",
path: "/api/v2/restaurants-integrations-public-api/orders",
headers: {
"Content-Type": "application/json",
"x-authorization": "Bearer YOUR\_TOKEN",
},
};var req = https.request(options, function (res) {
var chunks = \[];res.on("data", function (chunk) {
chunks.push(chunk);
});res.on("end", function (chunk) {
var body = Buffer.concat(chunks);
console.log(body.toString());
});res.on("error", function (error) {
console.error(error);
});
});req.end();import requestsurl = "https://microservices.dev.rappi.com/api/v2/restaurants-integrations-public-api/orders"payload = {}
headers = {
'Content-Type': 'application/json',
'x-authorization': 'Bearer YOUR\_TOKEN'
}response = requests.request("GET", url, headers=headers, data=payload)print(response.text.encode('utf8'))package mainimport (
"fmt"
"net/http"
"io/ioutil"
)func main() {}


Use this URL to make a request with this endpoint:https://{COUNTRY\_DOMAIN}/api/v2/restaurants-integrations-public-api/ordersSee the list of Country Domains.: This is your Rappi Country Domain. {COUNTRY\_DOMAIN}


Use this endpoint to return a collection of all the new orders for the stores of the authenticating ally.


The Orders resource enables you to interact with the orders of your stores.!!! important
Due to expansion and improvements, new endpoints or resources have been introduced that expand the capabilities for interacting with various item and store order options. Because of these advancements, this section is now divided into two distinct parts, each with its own List of Country Domains. It's essential to note that the current order section remains fully operational and contains the traditional resources that have previously handled the established order options.


This is an example of the response "Success 200":{
"storeId": "900111978",
"items": \[
{
"name": "Naked Cake con frutos",
"description": "Naked cake decorado con frutos. Cubierta de trufa derretida (ganache) y decorada con frutos del bosque.",
"sku": "8569874",
"type": "PRODUCT",
"price": 75.0,
"category": {
"id": "3",
"name": "Tortas",
"minQty": 0,
"maxQty": 0,
"sortingPosition": 0
},
"imageUrl": "https://image.com/image1.jpg",
"children": \[
{
"name": "Chocolate",
"description": "",
"sku": "8569874-159",
"type": "TOPPING",
"price": 0.0,
"category": {
"id": "1",
"name": "Sabor",
"minQty": 0,
"maxQty": 1,
"sortingPosition": 0
},
"imageUrl": "https://image.com/image10.jpg",
"children": \[],
"rappiIds": \["340948822"],
"sortingPosition": 1,
"maxLimit": 1
}
],
"rappiIds": \["2135527868"],
"sortingPosition": 0,
"maxLimit": 1
},
{
"name": "Snowman",
"description": "Linda lata de Snowman con productos variadosIncluye:Galletas mantequilla 350 gr, 6 brookies y 4 trufas de brownie.",
"sku": "856887",
"type": "PRODUCT",
"price": 75.0,
"category": {
"id": "9",
"name": "Navidad",
"minQty": 0,
"maxQty": 0,
"sortingPosition": 0
},
"imageUrl": "https://image.com/image2.jpg",
"children": \[],
"rappiIds": \["2135524472"],
"sortingPosition": 0,
"maxLimit": 1
}
]
}This is an example of the response "Invalid credentials 401":{
"message": "Not a valid token"
}Get Menu.The context of the attribute response were mentionend before in


This is an example of an API request using this endpoint:GET https://microservices.dev.rappi.com/api/v2/restaurants-integrations-public-api/menu/rappi/251This is an example of the request:final Integer storeId = 251;URL url = new URL(String.format("https://microservices.dev.rappi.com/api/v2/restaurants-integrations-public-api/menu/rappi/%s", storeId));HttpURLConnection connection = (HttpURLConnection) url.openConnection();
connection.setRequestMethod("GET");
connection.setRequestProperty("User-Agent", "Mozilla/5.0");
connection.setRequestProperty("Content-Type", "application/json");
connection.setRequestProperty("Accept", "application/json");
connection.setRequestProperty("x-authorization", "Bearer YOUR\_TOKEN");try (BufferedReader br = new BufferedReader(new InputStreamReader(connection.getInputStream(), StandardCharsets.UTF\_8))) {
StringBuilder response = new StringBuilder();
String responseLine;
while ((responseLine = br.readLine()) != null) {
response.append(responseLine.trim());
}
System.out.println("Response body: " + response.toString());
}
System.out.println("Response Code : " + connection.getResponseCode());var https = require("https");var options = {
method: "GET",
hostname: "microservices.dev.rappi.com",
path: "/api/v2/restaurants-integrations-public-api/menu/rappi/251",
headers: {
"Content-Type": "application/json",
"x-authorization": "Bearer YOUR\_TOKEN",
},
};var req = https.request(options, function (res) {
var chunks = \[];res.on("data", function (chunk) {
chunks.push(chunk);
});res.on("end", function (chunk) {
var body = Buffer.concat(chunks);
console.log(body.toString());
});res.on("error", function (error) {
console.error(error);
});
});req.end();import requestsurl = "https://microservices.dev.rappi.com/api/v2/restaurants-integrations-public-api/menu/rappi/251"payload = {}
headers = {
'Content-Type': 'application/json',
'x-authorization': 'Bearer YOUR\_TOKEN'
}response = requests.request("GET", url, headers=headers, data=payload)print(response.text.encode('utf8'))package mainimport (
"fmt"
"net/http"
"io/ioutil"
)func main() {}


This table contains the possible response codes for this endpoint: Success200


Use this URL to make a request with this endpoint:https://{COUNTRY\_DOMAIN}/api/v2/restaurants-integrations-public-api/menu/rappi/{storeId}: This is the identifier of your store integration.{storeId}See the list of Country Domains.: This is your Rappi Country Domain. {COUNTRY\_DOMAIN}


Use this endpoint to return the last menu created for a specific store.


This endpoint returns a status response code only.401 Invalid Credentials:{
"message": "Not a valid token"
}


This is an example of an API request using this endpoint:GET https://microservices.dev.rappi.com/api/v2/restaurants-integrations-public-api/menu/approved/251This is an example of the request:final Integer storeId = 251;URL url = new URL(String.format("https://microservices.dev.rappi.com/api/v2/restaurants-integrations-public-api/menu/approved/%s", storeId));HttpURLConnection connection = (HttpURLConnection) url.openConnection();
connection.setRequestMethod("GET");
connection.setRequestProperty("User-Agent", "Mozilla/5.0");
connection.setRequestProperty("Content-Type", "application/json");
connection.setRequestProperty("Accept", "application/json");
connection.setRequestProperty("x-authorization", "Bearer YOUR\_TOKEN");try (BufferedReader br = new BufferedReader(new InputStreamReader(connection.getInputStream(), StandardCharsets.UTF\_8))) {
StringBuilder response = new StringBuilder();
String responseLine;
while ((responseLine = br.readLine()) != null) {
response.append(responseLine.trim());
}
System.out.println("Response body: " + response.toString());
}
System.out.println("Response Code : " + connection.getResponseCode());var https = require("https");var options = {
method: "GET",
hostname: "microservices.dev.rappi.com",
path: "/api/v2/restaurants-integrations-public-api/menu/approved/251",
headers: {
"Content-Type": "application/json",
"x-authorization": "Bearer YOUR\_TOKEN",
},
};var req = https.request(options, function (res) {
var chunks = \[];res.on("data", function (chunk) {
chunks.push(chunk);
});res.on("end", function (chunk) {
var body = Buffer.concat(chunks);
console.log(body.toString());
});res.on("error", function (error) {
console.error(error);
});
});req.end();import requestsurl = "https://microservices.dev.rappi.com/api/v2/restaurants-integrations-public-api/menu/approved/251"payload = {}
headers = {
'Content-Type': 'application/json',
'x-authorization': 'Bearer YOUR\_TOKEN'
}response = requests.request("GET", url, headers=headers, data=payload)print(response.text.encode('utf8'))package mainimport (
"fmt"
"net/http"
"io/ioutil"
)func main() {}


Use this URL to make a request with this endpoint:https://{COUNTRY\_DOMAIN}/api/v2/restaurants-integrations-public-api/menu/approved/{storeId}See the list of Country Domains.: This is your Rappi Country Domain. {COUNTRY\_DOMAIN}


Use this endpoint to return the approval status of a menu.


404 Store not found:{
"message": "StoreId 9001035324: not found associated Stores"
}This table describes the attributes from JSON response: | Store not found |stringmessage| Attributes             | Description     |
| ---------------------- | --------------- |
|


Sample response "404 Store not found"

401 Invalid Credentials:{
"message": "Not a valid token"
}This table describes the attributes from JSON response: | Not a valid token |stringmessage| Attributes             | Description       |
| ---------------------- | ----------------- |
|
