
# Introducción

Esta página explica cómo los desarrolladores pueden comenzar a usar las APIs de Rappi para la integración con restaurantes.

<aside class="notice">
    <p>NOTA</p>
    Estamos en proceso de mejorar nuestras APIs públicas, por lo que te pedimos que siempre estés atento a nuestra documentación oficial.
</aside>

## Requisitos de Integración

Dado que la integración con nuestra API requiere contacto directo con nuestro equipo, sigue estos pasos para comenzar.

### 1. Contacto Inicial

Para conocer los pasos para registrarte como aliado de Rappi, comunícate con tu principal punto de contacto en Rappi.

### 2. Creación de Credenciales

Una vez que tu solicitud sea aprobada, recibirás credenciales de acceso a nuestro entorno de pruebas.

### 3. Revisión de Documentación

Antes de comenzar el desarrollo, recomendamos revisar los siguientes recursos:

- [Documentación de referencia de la API](https://dev-portal.rappi.com/es/content)
- [Guía de autenticación](/es/api-reference/authentication)

### 4. Consideraciones para esta API

Esta documentación de referencia de la API está diseñada para ayudarte a comprender los endpoints disponibles, sus parámetros y cómo usarlos de manera efectiva. Incluye descripciones detalladas de cada endpoint, incluidos los formatos de solicitud y respuesta, parámetros requeridos y ejemplos.

También proporciona información sobre cómo autenticar tus solicitudes, manejar errores y gestionar la paginación.

### 4.1 Etiquetas de Endpoints

- `NEW`: Esta etiqueta indica que el endpoint es nuevo.
- `STABLE`: Esta etiqueta indica que el endpoint es estable y ha estado en uso durante mucho tiempo. Se recomienda utilizar endpoints estables en las integraciones.
- `DEPRECATED`: Esta etiqueta indica que el endpoint está obsoleto y puede eliminarse en futuras versiones de la API. Se recomienda evitar el uso de endpoints obsoletos en nuevas integraciones.

### 4.2 Deprecación de Endpoints

Los endpoints que están marcados como `DEPRECATED` seguirán funcionando durante un período de tiempo, pero pueden eliminarse en futuras versiones de la API. Recomendamos evitar el uso de endpoints obsoletos en nuevas integraciones y migrar a endpoints estables o nuevos lo antes posible.

### 5. Pruebas en el Entorno de Desarrollo

Después de registrarte como aliado integrado de Rappi, recibirás tus credenciales de Rappi, que consisten en lo siguiente:

- `client_id`
- `client_secret`

Usa estas credenciales de Rappi para crear tu Access Token con el endpoint [`POST token/login/integrations`](/es/api-reference/authentication/#post-login-de-integraciones).

Una vez que hayas generado tu Access Token, puedes comenzar a usar la API de Rappi.


Introducción

Requisitos de Integración

API Endpoints

Utils Endpoints

Dominios

Nuevos Dominios

Contenido de la guia

POST login de integraciones

POST login de utlis

NEW Autenticación

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

Órdenes

GET menu

POST menu

GET menu/approved/{storeId}

GET menu/rappi/{storeId}

Menús

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

Disponibilidad

GET stores-pa

PUT store-pa integrated status

GET store current menu

GET stores-pa check in code

Stores

GET webhook

PUT webhook - Agregar Stores

PUT webhook - Cambiar 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 Rests API de Órdenes

GET Menú de tienda por ID de tienda

POST Subir menú de tienda

GET Menús por ID de tienda

POST Insertar menú por ID de tienda

DELETE Menú por ID de tienda

GET Menú por ID de tienda

GET Categorías por ID de Tienda

POST Crear o Actualizar Categorías por ID de Tienda

DELETE Eliminar Categorías por ID de Tienda

GET Categoría por ID de Tienda

GET Items por ID de tienda

POST Insertar item por ID de tienda

DELETE Items por ID de tienda

GET Item por ID de tienda

NEW Rests API de Menu

PATCH Disponibilidad de productos por SKU o ID

POST Validar disponibilidad de productos por SKU o ID

PATCH Disponibilidad de toppings por SKU o ID

POST Validar disponibilidad de toppings por SKU o ID

PATCH Disponibilidad de articulos por SKU o ID

POST Validar disponibilidad de articulos por SKU o ID

Rests API de Disponibilidad

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 de 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}

PUT 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

IntroducciónEsta página explica cómo los desarrolladores pueden comenzar a usar las APIs de Rappi para la integración con restaurantes.Requisitos de IntegraciónDado que la integración con nuestra API requiere contacto directo con nuestro equipo, sigue estos pasos para comenzar.1. Contacto InicialPara conocer los pasos para registrarte como aliado de Rappi, comunícate con tu principal punto de contacto en Rappi.2. Creación de CredencialesUna vez que tu solicitud sea aprobada, recibirás credenciales de acceso a nuestro entorno de pruebas.3. Revisión de DocumentaciónAntes de comenzar el desarrollo, recomendamos revisar los siguientes recursos:Documentación de referencia de la APIGuía de autenticación4. Consideraciones para esta APIEsta documentación de referencia de la API está diseñada para ayudarte a comprender los endpoints disponibles, sus parámetros y cómo usarlos de manera efectiva. Incluye descripciones detalladas de cada endpoint, incluidos los formatos de solicitud y respuesta, parámetros requeridos y ejemplos.También proporciona información sobre cómo autenticar tus solicitudes, manejar errores y gestionar la paginación.4.1 Etiquetas de EndpointsNEW: Esta etiqueta indica que el endpoint es nuevo.STABLE: Esta etiqueta indica que el endpoint es estable y ha estado en uso durante mucho tiempo. Se recomienda utilizar endpoints estables en las integraciones.DEPRECATED: Esta etiqueta indica que el endpoint está obsoleto y puede eliminarse en futuras versiones de la API. Se recomienda evitar el uso de endpoints obsoletos en nuevas integraciones.4.2 Deprecación de EndpointsLos endpoints que están marcados como DEPRECATED seguirán funcionando durante un período de tiempo, pero pueden eliminarse en futuras versiones de la API. Recomendamos evitar el uso de endpoints obsoletos en nuevas integraciones y migrar a endpoints estables o nuevos lo antes posible.5. Pruebas en el Entorno de DesarrolloDespués de registrarte como aliado integrado de Rappi, recibirás tus credenciales de Rappi, que consisten en lo siguiente:client\_idclient\_secretUsa estas credenciales de Rappi para crear tu Access Token con el endpoint POST token/login/integrations.Una vez que hayas generado tu Access Token, puedes comenzar a usar la API de Rappi.


Después de registrarte como aliado integrado de Rappi, recibirás tus credenciales de Rappi, que consisten en lo siguiente:client\_secretclient\_id.POST token/login/integrationsUsa estas credenciales de Rappi para crear tu Access Token con el endpoint Una vez que hayas generado tu Access Token, puedes comenzar a usar la API de Rappi.


5. Pruebas en el Entorno de Desarrollo

seguirán funcionando durante un período de tiempo, pero pueden eliminarse en futuras versiones de la API. Recomendamos evitar el uso de endpoints obsoletos en nuevas integraciones y migrar a endpoints estables o nuevos lo antes posible.DEPRECATEDLos endpoints que están marcados como


4.2 Deprecación de Endpoints

: Esta etiqueta indica que el endpoint está obsoleto y puede eliminarse en futuras versiones de la API. Se recomienda evitar el uso de endpoints obsoletos en nuevas integraciones.DEPRECATED: Esta etiqueta indica que el endpoint es estable y ha estado en uso durante mucho tiempo. Se recomienda utilizar endpoints estables en las integraciones.STABLE: Esta etiqueta indica que el endpoint es nuevo.NEW


4.1 Etiquetas de Endpoints

Esta documentación de referencia de la API está diseñada para ayudarte a comprender los endpoints disponibles, sus parámetros y cómo usarlos de manera efectiva. Incluye descripciones detalladas de cada endpoint, incluidos los formatos de solicitud y respuesta, parámetros requeridos y ejemplos.También proporciona información sobre cómo autenticar tus solicitudes, manejar errores y gestionar la paginación.


4. Consideraciones para esta API

Antes de comenzar el desarrollo, recomendamos revisar los siguientes recursos:Guía de autenticaciónDocumentación de referencia de la API


3. Revisión de Documentación

Una vez que tu solicitud sea aprobada, recibirás credenciales de acceso a nuestro entorno de pruebas.


2. Creación de Credenciales

Para conocer los pasos para registrarte como aliado de Rappi, comunícate con tu principal punto de contacto en Rappi.


1. Contacto Inicial

Dado que la integración con nuestra API requiere contacto directo con nuestro equipo, sigue estos pasos para comenzar.


Esta página explica cómo los desarrolladores pueden comenzar a usar las APIs de Rappi para la integración con restaurantes.
NOTA
Estamos en proceso de mejorar nuestras APIs públicas, por lo que te pedimos que siempre estés atento a nuestra documentación oficial.


Las siguientes tablas contienen todos los recursos disponibles para usar con Utils API:                                                                                                                  | Retorna la lista de productos y toppings mostrando el estado de los items y su disponibilidad. |           |GET menu/integration/{integrationId}                                       | Estado de productos                                                                             | Elimina un dia especial                                                                        |           |
| DELETE store/schedule/{storeId}/special/{specialDayId}                                                                                                                  | Elimina una franja horaria                                                                     |           |
|                                                                                                | DELETE store/schedule/{storeId}/{storeScheduleId}                                                                                                                        | Actualiza una franja horaria                                                                   |           |
|                                                                                                | PUT store/schedule/{storeId}/{storeScheduleId}                                                                                                         | Crea una franja horaria en un día especial de la tienda                                        |           |
|                                                                                                | POST store/schedule/{storeId}/special/{specialDayId}                                                                                                                             | Crea un día especial de la tienda                                                              |           |
|                                                                                                | POST store/schedule/{storeId}/special                                                                                                         | Crea una franja horaria en un día feriado                                                      |           |
|                                                                                                | POST store/schedule/{storeId}/holiday/{holidayDayId}                                                                                                                                        | Crea una franja horaria en un día de horario regular de la tienda                              |           |
|                                                                                                | POST store/schedule/{storeId}                                                                                                                          | Retorna todo el horario de dias especiales de la tienda                                        |           |
|                                                                                                | GET store/schedule/{storeId}/special                                                                                                                          | Retorna todo el horario de dias festivos                                                       |           |
|                                                                                                | GET store/schedule/{storeId}/holiday                                                                                                                                          | Retorna todo el horario regular de la tienda                                                   |           |
|                                                                                                | GET store/schedule/{storeId}                                  | Horarios de las tiendas | Elimina los horarios del producto asociados al corredor y la tienda                            |           |
| DELETE sku/schedule/{sku}/corridor/{corridorId}/integration/{integrationId}/{corridorProductScheduleId}                                   | Actualiza los horarios del producto asociados al corredor y la tienda                          |           |
|                                                                                                | PUT sku/schedule/{sku}/corridor/{corridorId}/integration/{integrationId}                                 | Crea los horarios del producto asociados al corredor y la tienda                               |           |
|                                                                                                | POST sku/schedule/{sku}/corridor/{corridorId}/integration/{integrationId}                                   | Retorna los horarios del producto configurado en la tienda                                     |           |
|                                                                                                | GET sku/schedule/{sku}/corridor/{corridorId}/integration/{integrationId}                                                               | Retorna la lista de producto por corredor y por tienda                                         |           |
|                                                                                                | GET sku/corridor/{corridorId}/integration/{integrationId}                   | Horarios de productos por SKU            | Elimina los horarios del producto asociados al corredor y la tienda                            |           |
| DELETE product/schedule/{productId}/corridor/{corridorId}/store/{storeId}/{corridorProductScheduleId}                                              | Actualiza los horarios del producto asociados al corredor y la tienda                          |           |
|                                                                                                | PUT product/schedule/{productId}/corridor/{corridorId}/store/{storeId}                                            | Crea los horarios del producto asociados al corredor y la tienda                               |           |
|                                                                                                | POST product/schedule/{productId}/corridor/{corridorId}/store/{storeId}                                              | Retorna los horarios del producto configurado en la tienda                                     |           |
|                                                                                                | GET product/schedule/{productId}/corridor/{corridorId}/store/{storeId}                                                                                      | Retorna la lista de producto por corredor y por tienda                                         |           |
|                                                                                                | GET product/corridor/{corridorId}/store/{storeId}                           | Horarios de productos por ID          | Elimina los horarios del corredor en la tienda                                                 |           |
| DELETE corridor/schedule/{corridorId}/integration/{integrationId}/{corridorProductScheduleId}                                            | Actualiza los horarios del corredor en la tienda                                               |           |
|                                                                                                | PUT corridor/schedule/{corridorId}/integration/{integrationId}                                          | Crea los horarios del corredor en la tienda                                                    |           |
|                                                                                                | POST corridor/schedule/{corridorId}/integration/{integrationId}                                            | Retorna los horarios del corredor configurado en la tienda                                     |           |
|                                                                                                | GET corridor/schedule/{corridorId}/integration/{integrationId}                                                                                       | Retorna de los corredores de la tienda                                                         |           |
|                                                                                                | GET corridor/integration/{integrationId} | Horarios de corredores por integración                                                 | Elimina los horarios del corredor en la tienda                                                 |           |
| DELETE corridor/schedule/{corridorId}/store/{storeId}/{corridorProductScheduleId}                                                                                   | Actualiza los horarios del corredor en la tienda                                               |           |
|                                                                                                | PUT corridor/schedule/{corridorId}/store/{storeId}                                                                                 | Crea los horarios del corredor en la tienda                                                    |           |
|                                                                                                | POST corridor/schedule/{corridorId}/store/{storeId}                                                                                   | Retorna los horarios del corredor configurado en la tienda                                     |           |
|                                                                                                | GET corridor/schedule/{corridorId}/store/{storeId}                                                                                                                              | Retorna la lista de los corredores de la tienda                                                |           |
|                                                                                                | GET corridor/store/{storeId}                     | Horarios de corredores por tienda |
| NUEVO                                                                                                                              | Utilice este punto final para generar un token de acceso para los servicios de utilidades      | POST /restaurants/auth/v1/token/login/utils                                            | Authentication| API Resource                                                                                   | Endpoint                                                                                                                                                                                                                         | Endpoint Description                                                                           |           |
| ---------------------------------------------------------------------------------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ---------------------------------------------------------------------------------------------- | --------- |
|


La tabla siguiente contiene todos los recursos disponibles de nuestra API:                                                                                             | Habilita o deshabilita Webhooks para una lista de tiendas                                                        |           |PUT webhook/{event}/change-status y genera uno nuevo al cliente autenticado                                                   |           |
|                                                     | secret                                                                                               | Reinicia el PUT webhook/{event}/reset-secret                                                                                                     | Elimina stores del webhook especificado                                                                          |           |
|                                                     | DELETE webhook/{event}/remove-stores                                                                                                                               | Crea un nuevo Webhook para una lista de tiendas del cliente autenticado                                          |           |
|                                                     | POST webhook                                                                                                   | Cambia la url para una lista de stores                                                                           |           |
|                                                     | PUT webhook/{event}/change-url                                                                                                   | Agrega tiendas al evento del webhook especificado                                                                |           |
|                                                     | PUT webhook/{event}/add-stores                                                                                                                         | Regresa los Webhooks configurados de todas las tiendas del cliente autenticado                                   |           |
|                                                     | GET webhook/{event}             | Webhooks |
| NUEVO                                             | Maneja de forma asincrónica la disponibilidad de los productos y toppings por SKU o por ID en la app de Rappi    | PATCH restaurants/menu/v1/stores/{STORE\_ID}/items/{IDENTITY\_TYPE}/stock |
|                                                     | NUEVO                                       | Maneja de forma asincrónica la disponibilidad de los toppings por SKU o por ID en la app de Rappi                | PATCH restaurants/menu/v1/stores/{STORE\_ID}/toppings/{IDENTITY\_TYPE}/stock |
|                                                     | NUEVO                                       | Maneja de forma asincrónica la disponibilidad de los productos por SKU o por ID en la app de Rappi               | PATCH restaurants/menu/v1/stores/{STORE\_ID}/products/{IDENTITY\_TYPE}/stock                                                                                       | Maneja de forma sincrónica la disponibilidad de la tienda en la app de Rapppi                                    |           |
|                                                     | PUT availability/stores/enable                                                                       | Maneja de forma asincrónica la disponibilidad de la tienda en la app de Rappi                                    |           |
|                                                     | PUT availability/stores/enable/massive                                                                                                     | Controla la disponibilidad de la tienda en la aplicación                                                         |           |
|                                                     | PUT availability/stores                                                                             | Controla la disponibilidad de los articulos en la aplicación por su ID                                           |           |
|                                                     | PUT availability/stores/items/rappi                                                                                         | Controla la disponibilidad de los articulos en la aplicación por su SKU                                          |           |
|                                                     | PUT availability/stores/items                                                                           | Controla la disponibilidad de los articulos en la aplicación por su ID                                           |           |
|                                                     | POST availability/items/rappi/status                                                                                             | Actualiza una tienda a integrada o no integrada                                                                  |           |
|                                                     | PUT stores-pa/{storeId}/status                                                                                                                               | Devuelve la lista de tiendas del cliente autenticado                                                             |           |
|                                                     | GET stores-pa                | Tiendas |
| NUEVO | Utilice este punto final para confirmar la cantidad de bolsas y si hay bebidas fuera de las bolsas en el pedido. | POST restaurants/orders/v1/stores/{storeId}/orders/{orderId}/bag-drink-confirmation |
|                                                     | NUEVO                                 | Utilice este punto final para tomar un pedido para que la tienda pueda comenzar a prepararlo.                    | GET restaurants/orders/v1/stores/{storeId}/orders/{orderId}/handoff                                                                                                    | Devuelve los ultimos eventos de las ordenes                                                                      |           |
|                                                     | GET orders/{orderId}/events                                                                              | Confirma que la orden esta lista para ser recogida                                                               |           |
|                                                     | POST orders/{orderId}/ready-for-pickup                                                                                                    | Rechaza una orden                                                                                                |           |
|                                                     | PUT orders/{orderId}/reject                                                                             | Toma una orden para ser preparada                                                                                |           |
|                                                     | PUT orders/{orderId}/take/{cookingTime}                                                    |           |
|                                                     | SENT                                                                                                             | Devuelve una lista de nuevas ordenes creadas en estado GET orders/status/sent                                                                                                                                     | Devuelve una lista de nuevas ordenes creadas                                                                     |           |
|                                                     | GET orders                | Órdenes |
| NUEVO                | Devuelve la disponibilidad de productos y toppings por SKU o ID en la app de Rappi                               | POST /restaurants/menu/v1/stores/{storeId}/items/{identityType}/stock/status |
|                                                     | NUEVO                             | Gestiona de forma asincrónica la disponibilidad de productos y toppings por SKU o ID en la app de Rappi          | PATCH /restaurants/menu/v1/stores/{storeId}/items/{identityType}/stock |
|                                                     | NUEVO              | Devuelve la disponibilidad de toppings por SKU o ID en la app de Rappi                                           | POST /restaurants/menu/v1/stores/{storeId}/toppings/{identityType}/stock/status |
|                                                     | NUEVO                           | Gestiona de forma asincrónica la disponibilidad de toppings por SKU o ID en la app de Rappi                      | PATCH /restaurants/menu/v1/stores/{storeId}/toppings/{identityType}/stock |
|                                                     | NUEVO             | Devuelve la disponibilidad de productos por SKU o ID en la app de Rappi                                          | POST /restaurants/menu/v1/stores/{storeId}/products/{identityType}/stock/status |
|                                                     | NUEVO                          | Gestiona de forma asincrónica la disponibilidad de productos por SKU o ID en la app de Rappi                     | PATCH /restaurants/menu/v1/stores/{storeId}/products/{identityType}/stock                                                                                                           | Devuelve el ultimo menú creado para una tienda                                                                   |           |
|                                                     | GET menu/rappi/{storeId}                                                                                                     | Devuelve el estado de aprobación actual de un menú                                                               |           |
|                                                     | GET menu/approved/{storeId}                                                                                                                                        | Añade o actualiza un menú en una tienda                                                                          |           |
|                                                     | POST menu                                                                                                                                          | Devuelve la colección de menús creados por el aliado autenticado                                                 |           |
|                                                     | GET menu                   | Menús |
| NUEVO                                                                        | Utilice este punto final para generar un token de acceso para los servicios de integración                       | POST /restaurants/auth/v1/token/login/integrations | Authentication| Recurso API                                         | Endpoint                                                                                                                                                                                 | Descripción del Endpoint                                                                                         |           |
| --------------------------------------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ---------------------------------------------------------------------------------------------------------------- | --------- |
|


EL API de Rappi incluye todos los recursos, puntos finales y métodos que le permiten integrarse con la aplicación Rappi, asi como manejar todos sus productos, menus, ordenes, horarios de menus, disponibilidad de productos.


AutenticaciónPara autenticarte al realizar solicitudes API a la API de Rappi, necesitas un Token de acceso.El API de Rappi utiliza un esquema de Bearer authentication, como método de autenticación HTTP para solicitudes de API.Para realizar solicitudes a la API, envía el token en un encabezado customizado para interactuar con los recursos protegidos.Rappi utiliza el siguiente esquema para la autenticación Bearer:| Key               | Value                    |
| ----------------- | ------------------------ |
| x-authorization | Bearer: \<access\_token> |La siguiente tabla describe los diferentes contenidos del recurso de autenticación:| Recursos                                                           | Descripcion                                                                                  | Observaciones |
| ------------------------------------------------------------------ | -------------------------------------------------------------------------------------------- | ------------- |
| POST v1/token/login/integrations | Utilice este punto final para generar un token de acceso para los servicios de integraciones |               |
| POST v1/token/login/utils                | Utilice este punto final para generar un token de acceso para los servicios de utils         |               |POST login de integracionesUtilice este punto de conexión para generar un token de acceso. Este token le permite autenticarse al realizar solicitudes de API para integraciones.URL del endpointUtilice las siguientes URL para realizar una solicitud con este punto final: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.Propiedades del endpointEste recurso tiene las siguientes propiedades:|                        |        |
| ---------------------- | ------ |
| Cuerpo de la solicitud | json |
| Cuerpo de la respuesta | json |ParametrosEste endpoint no permite parámetros adicionales.Codigos de respuestaEstos son los posibles códigos de estado de la respuesta para este endpoint:200 Correcto403 No autorizadoEjemplo de solicitudEste es un ejemplo de una solicitud de API que utiliza este endpoint:POST https://api.dev.rappi.com/restaurants/auth/v1/token/login/integrationsEste es un ejemplo de la solicitud:Esta tabla describe los atributos que requiere el JSON de su solicitud:| Atributos       |          | Requerido | Descripcion                                 |
| --------------- | -------- | --------- | ------------------------------------------- |
| client\_id     | string | true    | Client Id de tus credenciales de Rappi.     |
| client\_secret | string | true    | Client Secret de tus credenciales de Rappi. |Ejemplo de respuestaEste es un ejemplo de la respuesta:Esta tabla describe los objetos contenidos en el ejemplo de respuesta:| Response Object |           | Object Description                               |
| --------------- | --------- | ------------------------------------------------ |
| access\_token  | string  | Token de acceso para acceder a endpoint seguros. |
| token\_type    | string  | Tipo de token.                                   |
| expires\_in    | integer | Tiempo de validez del token en segundos.         |POST login de utlisUtilice este punto final para generar un token de acceso. Este token le permite autenticarse al realizar solicitudes de API para utilidades.URL del endpointUtilice las siguientes URL para realizar una solicitud con este 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.Propiedades del endpointEste recurso tiene las siguientes propiedades:|                        |        |
| ---------------------- | ------ |
| Cuerpo de la solicitud | json |
| Cuerpo de la respuesta | json |ParametrosEste endpoint no permite parámetros adicionales.Codigos de respuestaEstos son los posibles códigos de estado de la respuesta para este endpoint:200 Correcto403 No autorizadoEjemplo de solicitudEste es un ejemplo de una solicitud de API que utiliza este endpoint:POST https://api.dev.rappi.com/restaurants/auth/v1/token/login/integrationsEste es un ejemplo de la solicitud:Esta tabla describe los atributos que requiere el JSON de su solicitud:| Atributos       |          | Requerido | Descripcion                                 |
| --------------- | -------- | --------- | ------------------------------------------- |
| client\_id     | string | true    | Client Id de tus credenciales de Rappi.     |
| client\_secret | string | true    | Client Secret de tus credenciales de Rappi. |Ejemple de respuestaEste es un ejemplo de la respuesta:Esta tabla describe los objetos contenidos en el ejemplo de respuesta:| Response Object |           | Object Description                               |
| --------------- | --------- | ------------------------------------------------ |
| access\_token  | string  | Token de acceso para acceder a endpoint seguros. |
| token\_type    | string  | Tipo de token.                                   |
| expires\_in    | integer | Tiempo de validez del token en segundos.         |


Este es un ejemplo de la respuesta:{
"access\_token": "eyJhbGciOiJIUzI1NiIsInR5cCI6IkpeyJhbGciOiJIUzI1NiIsInR5cCI6IkpeyJhbGciOiJIUzI1NiIsInR5cCI6Ikp",
"token\_type": "Bearer",
"expires\_in": 604798
}Esta tabla describe los objetos contenidos en el ejemplo de respuesta: | Tiempo de validez del token en segundos.         |integer    | expires\_in  | Tipo de token.                                   |
| string    | token\_type  | Token de acceso para acceder a endpoint seguros. |
| string  | access\_token| Response Object |           | Object Description                               |
| --------------- | --------- | ------------------------------------------------ |
|


Ejemple de respuesta

Este es un ejemplo de una solicitud de API que utiliza este endpoint:POST https://api.dev.rappi.com/restaurants/auth/v1/token/login/integrationsEste es un ejemplo de la solicitud:{
"client\_id": "7iCfjZCO4bTns3OjqLK4de2GV3sp6Ymd",
"client\_secret": "40iFFYJV9A1LrVmJsaIeARW40iFFYJV9A1LrVmJsaIeARW40iFFYJV9A1LrVmJsaIeARW"
} de su solicitud:JSONEsta tabla describe los atributos que requiere el     | Client Secret de tus credenciales de Rappi. |true | string | client\_secret    | Client Id de tus credenciales de Rappi.     |
| true | string     | client\_id| Atributos       |          | Requerido | Descripcion                                 |
| --------------- | -------- | --------- | ------------------------------------------- |
| 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() {}


Ejemplo de solicitud

Estos son los posibles códigos de estado de la respuesta para este endpoint: Correcto200


Codigos de respuesta

Este endpoint no permite parámetros adicionales.


Parametros

Este recurso tiene las siguientes propiedades: |json |
| Cuerpo de la respuesta | json|                        |        |
| ---------------------- | ------ |
| Cuerpo de la solicitud |


Propiedades del endpoint

Utilice las siguientes URL para realizar una solicitud con este 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
Para ejemplos de solicitudes de API en este sitio, utilizamos el dominio del desarrollador: https://api.dev.rappi.com
IMPORTANTE:  Su token de acceso tiene una validez de 1 semana


URL del endpoint

Utilice este punto final para generar un token de acceso. Este token le permite autenticarse al realizar solicitudes de API para utilidades.


Este es un ejemplo de la respuesta:{
"access\_token": "eyJhbGciOiJIUzI1NiIsInR5cCI6IkpeyJhbGciOiJIUzI1NiIsInR5cCI6IkpeyJhbGciOiJIUzI1NiIsInR5cCI6Ikp",
"token\_type": "Bearer",
"expires\_in": 86400
}Esta tabla describe los objetos contenidos en el ejemplo de respuesta: | Tiempo de validez del token en segundos.         |integer    | expires\_in  | Tipo de token.                                   |
| string    | token\_type  | Token de acceso para acceder a endpoint seguros. |
| string  | access\_token| Response Object |           | Object Description                               |
| --------------- | --------- | ------------------------------------------------ |
|


Ejemplo de respuesta

Este es un ejemplo de una solicitud de API que utiliza este endpoint:POST https://api.dev.rappi.com/restaurants/auth/v1/token/login/integrationsEste es un ejemplo de la solicitud:{
"client\_id": "7iCfjZCO4bTns3OjqLK4de2GV3sp6Ymd",
"client\_secret": "40iFFYJV9A1LrVmJsaIeARW40iFFYJV9A1LrVmJsaIeARW40iFFYJV9A1LrVmJsaIeARW"
} de su solicitud:JSONEsta tabla describe los atributos que requiere el     | Client Secret de tus credenciales de Rappi. |true | string | client\_secret    | Client Id de tus credenciales de Rappi.     |
| true | string     | client\_id| Atributos       |          | Requerido | Descripcion                                 |
| --------------- | -------- | --------- | ------------------------------------------- |
| 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() {}


Utilice las siguientes URL para realizar una solicitud con este punto final: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}
NOTA
Para ejemplos de solicitudes de API en este sitio, utilizamos el dominio del desarrollador: https://api.dev.rappi.com
IMPORTANTE:  Su token de acceso tiene una validez de 1 semana


Utilice este punto de conexión para generar un token de acceso. Este token le permite autenticarse al realizar solicitudes de API para integraciones.


.Token de accesoPara autenticarte al realizar solicitudes API a la API de Rappi, necesitas un , como método de autenticación HTTP para solicitudes de API.Bearer authenticationEl API de Rappi utiliza un esquema de  para interactuar con los recursos protegidos.encabezado customizadoPara realizar solicitudes a la API, envía el token en un Rappi utiliza el siguiente esquema para la autenticación Bearer: |Bearer: \<access\_token> | x-authorization| Key               | Value                    |
| ----------------- | ------------------------ |
| La siguiente tabla describe los diferentes contenidos del recurso de autenticación:                | Utilice este punto final para generar un token de acceso para los servicios de utils         |               |POST v1/token/login/utils | Utilice este punto final para generar un token de acceso para los servicios de integraciones |               |
| POST v1/token/login/integrations| Recursos                                                           | Descripcion                                                                                  | Observaciones |
| ------------------------------------------------------------------ | -------------------------------------------------------------------------------------------- | ------------- |
|


Autenticación

Este es un ejemplo de la respuesta:\[
{
"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"
}
}
]Esta tabla describe los objetos dentro de la respuesta de ejemplo: Tiempo estimado de llegada del repartidor a la tienda | Tiempo estimado de llegada del repartidor a la tienda.                             |stringadditional\_information.eta\_to\_store    | Información adicional de la orden. El formato puede variar dependiendo del evento. |
| array of objectsadditional\_information'Z'.                        |
| HH:mm:ss.SSS'T'yyyy-MM-dd                          | Hora del evento. Formato: stringevent\_time                               | Último evento de la orden.                                                         |
| stringevent| Objeto en la respuesta                             | Descripción del objeto                                                             |
| -------------------------------------------------- | ---------------------------------------------------------------------------------- |
|


Ejemplo de Respuesta

Estos son los posibles códigos de respuesta en este endpoint: Llamada exitosa200 Credenciales inválidas401 Orden no encontrada404


Códigos de Respuesta

Este es un ejemplo de una llamada API usando este endpoint:GET https://microservices.dev.rappi.com/api/v2/restaurants-integrations-public-api/orders/392625/eventsEste es un ejemplo de la llamada: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() {}


Ejemplo de Llamada

Este recurso tiene las siguientes propiedades: |
| Requerimientos de autenticación | Token  |JSON|                                 |        |
| ------------------------------- | ------ |
| Formato de respuesta            |


Propiedades del Endpoint

Utiliza esta URL para hacer llamadas con este endpoint:https://{COUNTRY\_DOMAIN}/api/v2/restaurants-integrations-public-api/orders/{orderId}/events: Este es el identificador de tu orden.{orderId} Mira la lista de dominios por país.: Este es tu Dominio por País de Rappi. {COUNTRY\_DOMAIN}


URL del Endpoint

Usa este endpoint para para obtener las últimas actualizaciones de una orden.


Este endpoint regresa unicamente un código de respuesta.


Este es un ejemplo de una llamada API usando este endpoint:POST https://microservices.dev.rappi.com/api/v2/restaurants-integrations-public-api/orders/392625/ready-for-pickupEste es un ejemplo de la llamada: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() {}


Estos son los posibles códigos de respuesta en este endpoint: Orden actualizada200 Estado de transición inválido400 Credenciales inválidas401 Orden no encontrada404


Este endpoint no permite parámetros adicionales.!!! important
Para evitar el uso indebido del endpoint, nos reservamos el derecho de revocar el acceso a aquellos clientes que lo utilicen de manera inapropiada. Es por ello que después de tres solicitudes, el sistema dejará de ejecutar acciones adicionales, por lo que cualquier intento posterior será considerado un uso incorrecto del endpoint.


Parámetros

Usa esta URL para hacer llamadas con este endpoint:https://{COUNTRY\_DOMAIN}/api/v2/restaurants-integrations-public-api/orders/{orderId}/ready-for-pickup: Este es el identificador de la orden.{orderId} Mira la lista de dominios por país.: Este es tu Dominio por País de Rappi. {COUNTRY\_DOMAIN}


. En la segunda solicitud, si el repartidor ya está asignado, se enviará una nueva notificación al repartidor asignado.READY\_FOR\_PICKUPUsa este endpoint para notificar al repartidor en la app de Rappi que su orden está lista para ser recogida.
Al realizar la primera solicitud, si no hay un repartidor asignado, el sistema acelerará el proceso de asignación; si ya hay un repartidor asignado, se le enviará una notificación y el estado de la orden cambiará a


Este endpoint regresa solo un código de respuesta.


Este es un ejemplo de una llamada API usando este endpoint:PUT https://microservices.dev.rappi.com/api/v2/restaurants-integrations-public-api/orders/392625/rejectEste es un ejemplo de la llamada:{
"reason": "The order has invalid items"
}Este es un ejemplo de la llamada con items con error:{
"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() {} de tu llamada requiere:JSONEsta tabla describe los atributos que el  | Razón por la que la orden se rechazó |requerido | stringreason| Atributos             | Requerido   | Descripción                          |
| --------------------- | ----------- | ------------------------------------ |
|


Estos son los posibles códigos de respuesta en este endpoint: Orden rechazada200 Estado de transición inválido400 Credenciales inválidas401 Orden no encontrada404


|"ORDER\_TOTAL\_INCORRECT", "ORDER\_MISSING\_ADDRESS\_INFORMATION", "ORDER\_MISSING\_INFORMATION", "ITEM\_OUT\_OF\_STOCK", "ITEM\_NOT\_FOUND", "ITEM\_WRONG\_PRICE" | Enum: requerido | enumerable stringcancel\_type  | Lista de skus de los items con error. Aca se envia el sku                                                                                                              |
| opcional           | array of stringitems\_skus  | Lista de los ids de los items con error. Aca se envia el rappi id                                                                                                      |
| opcional            | array of stringitems\_ids | Rechaza una orden en especifico.                                                                                                                                       |
| requerido                       | stringorderId| Nombre                                       | Requerido   | Descripción                                                                                                                                                            |
| -------------------------------------------- | ----------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| 


Este recurso tiene las siguientes propiedades: |
| Requerimientos de autenticación         | Token  |JSON para llamadas | body |
| Requerimientos del JSON|                                         |        |
| --------------------------------------- | ------ |
| Formato de respuesta                    |


Utiliza esta URL para hacer llamadas con este endpoint:https://{COUNTRY\_DOMAIN}/api/v2/restaurants-integrations-public-api/orders/{orderId}/reject: Este es el identificador de la orden.{orderId} Mira la lista de dominios por país.: Este es tu Dominio por país de Rappi. {COUNTRY\_DOMAIN}


Usa este endpoint para rechazar una orden.


Este endpoint únicamente regresa un código de estado.


Este es un ejemplo de una llamada API usando este endpoint:PUT https://microservices.dev.rappi.com/api/v2/restaurants-integrations-public-api/orders/392625/take/20Este es un ejemplo de la llamada: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() {}


Estos son los posibles códigos de respuesta en este endpoint: Orden exitosamente tomada200 Estado de transición inválido400 Credenciales inválidas401 Orden no encontrada404


Utiliza esta URL para hacer una llamada con este endpoint:https://{COUNTRY\_DOMAIN}/api/v2/restaurants-integrations-public-api/orders/{orderId}/take/{cookingTime}: Este es el nuevo tiempo de preparación de la orden. Puedes dejar este campo vacío para mantener el tiempo de preparación por defecto.{cookingTime}: Este es el identificador de la orden.{orderId}Mira la lista de dominios por país.: Este es tu Dominio por País de Rappi. {COUNTRY\_DOMAIN}


Usa este endpoint para tomar una orden para que la tienda comience a pepararla.


Este es un ejemplo de una llamada API usando este endpoint:GET https://microservices.dev.rappi.com/api/v2/restaurants-integrations-public-api/orders/status/sentEste es un ejemplo de la llamada: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() {}


Estos son los posibles códigos de respuesta en este endpoint: Llamada exitosa200 La tienda no pertenece al appClient del id especificado.400 Credenciales inválidas401 Tienda no encontrada.404


Este endpoint acepta los siguientes parametros opcionales: de una tienda |SENT | Regresa únicamente las órdenes en estado {storeId}| Parámetro   | Descripción                                                   |
| ----------- | ------------------------------------------------------------- |
|


Este recurso tienes las siguiente propiedades: |
| Requerimientos de autenticación | Token  |JSON|                                 |        |
| ------------------------------- | ------ |
| Formato de respuesta            |


Usa esta URL para hacer una llamada con este endpoint:https://{COUNTRY\_DOMAIN}/api/v2/restaurants-integrations-public-api/orders/status/sentMira la lista de Dominios por país.: Este es tu Dominio por País de Rappi. {COUNTRY\_DOMAIN}


Usa este endpoint para obtener una lista con las nuevas órdenes en estado SENT para las tiendas del aliado autenticado.


Este es un ejemplo de una llamada API usando este endpoint:GET https://microservices.dev.rappi.com/api/v2/restaurants-integrations-public-api/ordersEste es un ejemplo de la llamada: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() {}


Este endpoint acepta los siguientes parámetros opcionales: | Regresa únicamente las órdenes de una tienda |{storeId}| Parámetro   | Descripción                                  |
| ----------- | -------------------------------------------- |
|


Usa esta URL para hacer una llamada con este endpoint:https://{COUNTRY\_DOMAIN}/api/v2/restaurants-integrations-public-api/ordersMira la lista de Dominios por país.: Este es tu Dominio por País de Rappi. {COUNTRY\_DOMAIN}


Usa este endpoint para obtener una lista con las nuevas órdenes para las tiendas del aliado autenticado.


Los recursos de órdenes te permiten interactuar con las opciones de órdenes de tus artículos y tiendas.!!! important
Dada la expansión y mejoras, se han introducido nuevos endpoints o recursos que amplían las capacidades de órdenes para interactuar con distintas opciones de artículos y tiendas; debido a estos avances, ahora esta sección se divide en dos partes distintas, cada una con su propia lista de dominios por país. Es esencial destacar que la sección de órdenes actual sigue plenamente operativa y contiene los recursos tradicionales que han manejado las opciones de órdenes establecidas previamente.
