API Reference

The Rappi API enables you to manage the orders that the users make using the Rappi application with the new domains. The following sections describe the process to:

• Manage the workflow and status of the user orders
• Get user orders through API requests

API Reference

Use the GET orders endpoint to retrieve a list of all the orders that are in READY status for further action.

To retrieve new orders:

Make a GET request to the following URL:

URL: https://{COUNTRY_DOMAIN}/restaurants/orders/v1/orders

{COUNTRY_DOMAIN}: This is your Rappi Country Domain. See the list of Country Domains.

The system retrieves a JSON response with all the new orders of your stores. Consult the JSON response structure in the orders endpoint section of the API Reference.

When you retrieve the list of your new orders, you can take the orders.

API Reference

Use the GET stores/{storeId}/orders endpoint to retrieve a list of all the orders from a specific store that are in READY status for further action.

To retrieve new orders:

Make a GET request to the following URL:

URL: https://{COUNTRY_DOMAIN}/restaurants/orders/v1/stores/{storeId}/orders

• {COUNTRY_DOMAIN}: This is your Rappi Country Domain. See the list of Country Domains.
• {storeId}: This is the identifier of your store.

The system retrieves a JSON response with all the new orders of your stores. Consult the JSON response structure in the orders endpoint section of the API Reference.

When you retrieve the list of your new orders, you can take the orders.

API Reference

Use the GET orders/status/sent endpoint to retrieve a list of all the orders that are in SENT.

Example:

If order change status to SENT at 14:00 of 12/10/2021, and use this enpoint at 14:07, it returns the order, because 14:07 - 10 minutes = 13:57 and the status change hour was at 14:00 then is bigger than 13:57.

Another example, if order change status to SENT at 14:00 of 12/10/2021, but use this enpoint at 17:30, it returns nothing, because 17:30 - 10 minutes = 17:20, and status change hour was at 14:00 then is lower than 17:20.

To retrieve new orders:

Make a GET request to the following URL:

URL: https://{COUNTRY_DOMAIN}/restaurants/orders/v1/orders/status/sent

• {COUNTRY_DOMAIN}: This is your Rappi Country Domain. See the list of Country Domains.

The system retrieves a JSON response with all the new orders of your store. Consult the JSON response structure in the orders endpoint section of the API Reference.

When you retrieve the list of your new orders, you can take the orders.

API Reference

Use the PUT stores/{storeId}/orders/{orderId}/take endpoint to take orders that are in SENT status.

To take an order make a PUT request to the following URL:

URL: https://{COUNTRY_DOMAIN}/restaurants/orders/v1/stores/{storeId}/orders/{orderId}/take

• {COUNTRY_DOMAIN}: This is your Rappi Country Domain. See the list of Country Domains.
• {storeId}: This is the identifier of your store.
• {orderId}: This is the identifier of your order.

API Reference

Use the PUT stores/{storeId}/orders/{orderId}/cooking_time/{cookingTime}/take endpoint to take orders that are in SENT status with a specific cooking time.

To take an order make a PUT request to the following URL:

URL: https://{COUNTRY_DOMAIN}/restaurants/orders/v1/stores/{storeId}/orders/{orderId}/cooking_time/{cookingTime}/take

• {COUNTRY_DOMAIN}: This is your Rappi Country Domain. See the list of Country Domains.
• {storeId}: This is the identifier of your store.
• {orderId}: This is the identifier of your order.
• {cookingTime}: This is the new cooking time.

This function allows you to set the cooking time of an order when you take it in the POS.

What is cooking time?

Orders have three possible cooking times, which will be applied in the following order.

• Predictive CT
• CMS CT (with maximums and minimums)
• CT set up in the integration core

How does the CT work?

The system goes through each CT in the order explained above to assign the order’s CT, and if it does not find one, it will continue with the next one until a CT is assigned.

Is it possible to change the CT?

Yes, you can change the CT with a value between the minimum and maximum set up in the integration core, and in case you choose a value out of the set up range, the system will select the minimum or maximum value set up in the integration core.

API Reference

Use the endpoint GET stores/{storeId}/orders/{orderId}/handoff to obtain the confirmation code and the QR code of the order.

To obtain the QR code of the order, make a GET request to the following URL:

URL: https://{COUNTRY_DOMAIN}/restaurants/orders/v1/stores/{storeId}/orders/{orderId}/handoff

• {COUNTRY_DOMAIN}: This is your Rappi Country Domain. See the list of Country Domains.
• {storeId}: This is the identifier of your store.
• {orderId}: This is the identifier of your order.

The system retrieves a JSON response that will contain the code, the QR, the order_id, and the store_id of the order. Consult the JSON response structure in the orders endpoint section of the API Reference.

API Reference

Use the endpoint POST stores/{storeId}/orders/{orderId}/bag-drink-confirmation to confirm the number of bags and if there are any drinks outside the bags in the order.

To confirm the number of bags and if there are drinks outside the bags in the order, make a POST request to the following URL:

URL: https://{COUNTRY_DOMAIN}/restaurants/orders/v1/stores/{storeId}/orders/{orderId}/bag-drink-confirmation

• {COUNTRY_DOMAIN}: This is your Rappi Country Domain. See the list of Country Domains.
• {storeId}: This is the identifier of your store.
• {orderId}: This is the identifier of your order.

The system retrieves a JSON response that that will contain the order ID, the entity that made the confirmation (indicated in the last_updated_by field, which can be “store” for the store or “storekeeper” for the delivery person), the number of bags, the presence of drinks outside the bags, and the creation and last update dates. Consult the JSON response structure in the orders endpoint section of the API Reference.

API Reference

If your stores have manual notification settings, use the POST stores/{storeId}/orders/{orderId}/ready-for-pickup endpoint to notify the Rappi application when an order is ready for pickup.

Upon making the first request:

• If there is no courier assigned, the system will speed up the assignment process.
• If there is a courier assigned, the system will send a notification to the assigned courier.
• Depending on the current order status, the system will change the order status to READY_FOR_PICKUP.

Upon making the second request:

• If there is a courier assigned, the system will send a notification to the assigned courier.

To notify Rappi when an order is ready for pickup, make a POST request to the following URL:

URL: https://{COUNTRY_DOMAIN}/restaurants/orders/v1/stores/{storeId}/orders/{orderId}/ready-for-pickup

• {COUNTRY_DOMAIN}: This is your Rappi Country Domain. See the list of Country Domains.
• {orderId}: This is the identifier of your order.

The system retrieves a JSON response with the confirmation message "Order successfully updated".

API Reference

Use the endpoint PUT stores/{storeId}/orders/{orderId}/cancel_type/{cancelType}/reject to reject an order.

To reject an order, make a PUT request to the following URL:

URL: https://{COUNTRY_DOMAIN}/restaurants/orders/v1/stores/{storeId}/orders/{orderId}/cancel_type/{cancelType}/reject

• {COUNTRY_DOMAIN}: This is your Rappi country domain. See the list of country domains.
• {storeId}: This is your store identifier.
• {orderId}: This is your order identifier.
• {cancelType}: Corresponds to the cancellation type of your order.

In the following section, the cancellation types you can use to reject an order are described.

A cancellation for STORE_CLOSED is made when the restaurant is closed and cannot accept the order.

{
  "description": "ORDER RECEIVED OUT OF HOURS",
  "additional_info": {}
}

A cancellation for ITEM_STOCKOUT is made when the restaurant does not have enough stock to complete the order.

{
  "description": "Insufficient stock on some items",
  "additional_info": {
    "items": ["sku-123", "sku-23"],
    "identity_type": "RAPPI/SKU"
  }
}

A cancellation for POS_OFFLINE is made when the integrator receives an order and cannot connect to the POS or Terminal.

{
  "description": "The restaurant is having issues and cannot receive the order",
  "additional_info": {}
}

A cancellation for POS_INTERNAL_ERROR is made when there is an internal error in the POS or Terminal.

{
  "description": "Technical issue in server",
  "additional_info": {}
}

A cancellation for INTEGRATOR_ERROR is made when the integrator cannot process the order received by Rappi.

{
  "description": "Error in converting the order from Rappi",
  "additional_info": {}
}

A cancellation for DELIVERY_METHOD_NOT_SUPPORTED is made when the integrator receives an order and cannot process it because the delivery method is not supported.

{
  "description": "Delivery method not supported",
  "additional_info": {
    "received_value": "pickup",
    "available_options": ["delivery", "marketplace", "pickup"]
  }
}

A cancellation for ORDER_TOTAL_INCORRECT is made when the order total does not match the accounting in the integrator's systems.

{
  "description": "Incorrect totals",
  "additional_info": {
    "received_value": 123.13,
    "expected_value": 130.23
  }
}

A cancellation for ORDER_CHARGES_INCORRECT is made when there is an error in the order charges, such as the service fee or delivery.

{
  "description": "The delivery value is incorrect",
  "additional_info": {}
}

A cancellation for ORDER_DISCOUNTS_INCORRECT is made when there is an error in the discounts applied to the order.

{
  "description": "The value of one or several discounts is incorrect",
  "additional_info": {}
}

A cancellation for OUTSIDE_DELIVERY_AREA is made when the integrator receives an order and needs to cancel it because the user is outside the delivery area.

{
  "description": "Outside delivery area",
  "additional_info": {}
}

A cancellation for ITEM_PRICE_INCORRECT is made when the integrator needs to validate the unit prices of each product, but they do not match the prices in the POS.

{
  "description": "The price of sku-23 is incorrect",
  "additional_info": {
    "offending_items": [
      {
        "identifier": "sku-23",
        "identity_type": "RAPPI/SKU",
        "received_value": 123.13,
        "expected_value": 130.23
      }
    ]
  }
}

A cancellation for ITEM_NOT_FOUND is made when the integrator receives an order and some of the product identifiers are not recognized by the POS.

{
  "description": "The products sku-123 and sku-23 were not found in the system",
  "additional_info": {
    "items": ["sku-123", "sku-23"],
    "identity_type": "RAPPI/SKU"
  }
}

A cancellation for CUSTOMER_INFO_INCORRECT is made when the integrator considers there are issues with the user's information.

{
  "description": "Incorrect customer information",
  "additional_info": {}
}