Rest API - Financial

Operaciones de la API Financial.

Conciliación de Pagos

GET payments

Devuelve una lista de pagos filtrados por tienda y por período de pago con información del comerciante y detalles de cada pago.

Endpoint URL

Utilice esta URL para realizar una consulta con este endpoint:

https://{COUNTRY_DOMAIN}/restaurants/finance/v1/stores/{store_id}/payments

{COUNTRY_DOMAIN}: Este es tu dominio país Rappi. Ver la lista de Dominios de Países.

Propiedades del Endpoint

Este recurso tiene las siguientes propiedades:

Formatos de respuestaJSON
Requisitos de autenticaciónToken

Parámetros

Este endpoint admite los siguientes parámetros:

ParámetroPathQueryDescripción
store_idXEl identificador único de la tienda solicitada.
page_numberXNúmero de páginas que desea obtener
page_sizeXEl tamaño máximo de entradas en respuestas paginadas
payment_id:eqXEl payment_id debe ser igual a su valor
expected_execution_date:gteXEl expected_execution_date debe ser mayor o igual a su valor
expect_execution_date:lteXEl confirmed_payment_date debe ser menor o igual a su valor
confirmed_payment_date:gteXEl confirmed_payment_date debe ser mayor o igual a su valor
confirmed_payment_date:lteXEl confirmed_payment_date debe ser menor o igual a su valor

Códigos de Estados

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

Ejemplo de Solicitud

Este es un ejemplo de una solicitud de API utilizando este endpoint:

GET https://api.dev.rappi.com/restaurants/finance/v1/stores/1234/payments

este es un ejemplo de la solicitud:

URL url = new URL("https://api.dev.rappi.com/restaurants/finance/v1/stores/1234/payments"); 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());



Ejemplo de Respuesta

Este es un ejemplo de la respuesta:

{ "page_number": 1, "page_size": 10, "order_by": "string", "order_type": "string", "total_pages": 0, "total_entries": 0, "entries": [ { "id": 1000, "status": "string", "period_date_start": "2023-11-07T22:02:47.009Z", "period_date_end": "2023-11-07T22:02:47.009Z", "expected_execution_date": "2023-11-07T22:02:47.009Z", "confirmed_payment_date": "2023-11-07T22:02:47.009Z", "total_amount": 0, "payment_reference": "string", "frequecy_type": "string", "frequecy_type_descripcion": "string", "balance_request_id": "string", "bank_account": { "bank_name": "string", "account_number": "string", "bank_code": "string", "account_type": "string", "ispb": "string", "document": { "identification_type": "string", "identification_number": "string", "holder_name": "string" } }, "consolidated_stores": [1000] } ] }

GET orders

Devuelve una lista de pedidos por pago o por tienda y un período de pago.

Endpoint URL

Utilice esta URL para realizar una consulta con este endpoint:

https://{COUNTRY_DOMAIN}/restaurants/finance/v1/stores/{store_id}/orders

{COUNTRY_DOMAIN}: Este es tu dominio país Rappi. Ver la lista de Dominios de Países.

Propiedades del Endpoint

Este recurso tiene las siguientes propiedades:

Formatos de respuestaJSON
Requisitos de autenticaciónToken

Parámetros

Este endpoint admite los siguientes parámetros:

ParámetroPathQueryDescripción
store_idXEl identificador único de la tienda solicitada.
page_numberXNúmero de páginas que desea obtener
page_sizeXEl tamaño máximo de entradas en respuestas paginadas.
order_date:gteXEl order_date debe ser mayor o igual a su valor
order_date:lteXEl order_date debe ser menor o igual a su valor
order_status:eqXEl order_status debe ser igual a su valor
payment_id:eqXEl payment_id debe ser igual a su valor

Códigos de Estados

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

Ejemplo de Solicitud

Este es un ejemplo de una solicitud de API utilizando este endpoint:

GET https://api.dev.rappi.com/restaurants/finance/v1/stores/1234/orders

este es un ejemplo de la solicitud:

URL url = new URL("https://api.dev.rappi.com/restaurants/finance/v1/stores/1234/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());



Ejemplo de Respuesta

Este es un ejemplo de la respuesta:

{ "page_number": 1, "page_size": 10, "order_by": "string", "order_type": "string", "total_pages": 0, "total_entries": 0, "entries": [ { "id": 0, "payment_id": 0, "order_date": "2023-11-07T23:01:44.394Z", "store_id": 0, "store_name": "string", "store_type": "string", "order_status": "string", "payment_method": "string", "is_prime": "string", "items": [ { "name": "string", "units": "string" } ], "amount": 0, "billing": { "total_order": 0, "comission_product": 0, "cofins": 0, "pis": 0, "iss": 0, "income_tax": 0, "compensation": 0, "discount_by_marketplace_in_cash": 0, "total_order_whim": 0, "free_shipping": 0, "other_discounts": 0, "meal_voucher": 0, "marketplace_fee_no_cash": 0, "global_offer_coupon": 0, "paid_by_user": 0, "commission_whim": 0, "rappi_credits_cash_back": 0, "service_fee": 0, "shipping_partner_no_limit": 0, "shipping_partner_limit": 0, "marketplace_charge": 0 } } ] }

GET order_adjusments

Devuelve una lista de ajustes de pedidos por pago o por tienda y un período de pago.

Endpoint URL

Utilice esta URL para realizar una consulta con este endpoint:

https://{COUNTRY_DOMAIN}/restaurants/finance/v1/stores/{store_id}/order_adjusments

{COUNTRY_DOMAIN}: Este es tu dominio país Rappi. Ver la lista de Dominios de Países.

Propiedades del Endpoint

Este recurso tiene las siguientes propiedades:

Formatos de respuestaJSON
Requisitos de autenticaciónToken

Parámetros

Este endpoint admite los siguientes parámetros:

ParámetroPathQueryDescripción
store_idXEl identificador único de la tienda solicitada.
page_numberXNúmero de páginas que desea obtener
page_sizeXEl tamaño máximo de entradas en respuestas paginadas
order_date:gteXEl order_date debe ser mayor o igual a su valor
order_date:lteXEl order_date debe ser menor o igual a su valor
order_status:eqXEl order_status debe ser igual a su valor
payment_id:eqXEl payment_id debe ser igual a su valor

Códigos de Estados

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

Ejemplo de Solicitud

Este es un ejemplo de una solicitud de API utilizando este endpoint:

GET https://api.dev.rappi.com/restaurants/finance/v1/stores/1234/order_adjusments

este es un ejemplo de la solicitud:

URL url = new URL("https://api.dev.rappi.com/restaurants/finance/v1/stores/1234/order_adjusments"); 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());



Ejemplo de Respuesta

Este es un ejemplo de la respuesta:

{ "page_number": 1, "page_size": 10, "order_by": "string", "order_type": "string", "total_pages": 0, "total_entries": 0, "entries": [ { "id": 0, "payment_id": 0, "order_date": "2023-11-07T23:03:55.722Z", "store_id": 0, "store_name": "string", "store_type": "string", "order_status": "string", "payment_method": "string", "is_prime": "string", "items": [ { "name": "string", "units": "string" } ], "amount": 0, "billing": { "total_order": 0, "comission_product": 0, "cofins": 0, "pis": 0, "iss": 0, "income_tax": 0, "compensation": 0, "discount_by_marketplace_in_cash": 0, "total_order_whim": 0, "free_shipping": 0, "other_discounts": 0, "meal_voucher": 0, "marketplace_fee_no_cash": 0, "global_offer_coupon": 0, "paid_by_user": 0, "commission_whim": 0, "rappi_credits_cash_back": 0, "service_fee": 0, "shipping_partner_no_limit": 0, "shipping_partner_limit": 0, "marketplace_charge": 0 }, "descriptionAdjustment": "string" } ] }

GET charged_cancellations

Devuelve una lista de cancelaciones (pedidos) y su detalle por pago o por tienda y un periodo de pago.

Endpoint URL

Utilice esta URL para realizar una consulta con este endpoint:

https://{COUNTRY_DOMAIN}/restaurants/finance/v1/stores/{store_id}/charged_cancellations

{COUNTRY_DOMAIN}: Este es tu dominio país Rappi. Ver la lista de Dominios de Países.

Propiedades del Endpoint

Este recurso tiene las siguientes propiedades:

Formatos de respuestaJSON
Requisitos de autenticaciónToken

Parámetros

Este endpoint admite los siguientes parámetros:

ParámetroPathQueryDescripción
store_idXEl identificador único de la tienda solicitada.
page_numberXNúmero de páginas que desea obtener
page_sizeXEl tamaño máximo de entradas en respuestas paginadas
payment_id:eqXEl payment_id debe ser igual a su valor
order_date:gteXEl order_date debe ser mayor o igual a su valor
order_date:lteXEl order_date debe ser menor o igual a su valor

Códigos de Estados

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

Ejemplo de Solicitud

Este es un ejemplo de una solicitud de API utilizando este endpoint:

GET https://api.dev.rappi.com/restaurants/finance/v1/stores/1234/charged_cancellations

este es un ejemplo de la solicitud:

URL url = new URL("https://api.dev.rappi.com/restaurants/finance/v1/stores/1234/charged_cancellations"); 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());



Ejemplo de Respuesta

Este es un ejemplo de la respuesta.:

{ "page_number": 1, "page_size": 10, "order_by": "string", "order_type": "string", "total_pages": 0, "total_entries": 0, "entries": [ { "id": 0, "payment_id": 0, "order_date": "2023-11-07T23:09:48.153Z", "store_id": 0, "store_name": "string", "store_type": "string", "order_status": "string", "payment_method": "string", "is_prime": "string", "items": [ { "name": "string", "units": "string" } ], "amount": 0, "billing": { "total_order": 0, "comission_product": 0, "cofins": 0, "pis": 0, "iss": 0, "income_tax": 0, "compensation": 0, "discount_by_marketplace_in_cash": 0, "total_order_whim": 0, "free_shipping": 0, "other_discounts": 0, "meal_voucher": 0, "marketplace_fee_no_cash": 0, "global_offer_coupon": 0, "paid_by_user": 0, "commission_whim": 0, "rappi_credits_cash_back": 0, "service_fee": 0, "shipping_partner_no_limit": 0, "shipping_partner_limit": 0, "marketplace_charge": 0 }, "cancellatioPercentage": "string", "descriptionCancellation": "string", "cancellation_code": "string", "cancellation_description": "string" } ] }

GET store_adjustments

Devuelve una lista de ajustes de tienda por pago o por tienda y un período de pago.

Endpoint URL

Utilice esta URL para realizar una consulta con este endpoint:

https://{COUNTRY_DOMAIN}/restaurants/finance/v1/stores/{store_id}/store_adjustments

{COUNTRY_DOMAIN}: Este es tu dominio país Rappi. Ver la lista de Dominios de Países.

Propiedades del Endpoint

Este recurso tiene las siguientes propiedades:

Formatos de respuestaJSON
Requisitos de autenticaciónToken

Parámetros

Este endpoint admite los siguientes parámetros:

ParámetroPathQueryDescripción
store_idXEl identificador único de la tienda solicitada.
page_numberXNúmero de páginas que desea obtener
page_sizeXEl tamaño máximo de entradas en respuestas paginadas.
payment_id:eqXEl payment_id debe ser igual a su valor
created_at:gteXEl created_at debe ser mayor o igual a su valor
created_at:lteXEl created_at debe ser menor o igual a su valor

Códigos de Estados

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

Ejemplo de Solicitud

Este es un ejemplo de una solicitud de API utilizando este endpoint:

GET https://api.dev.rappi.com/restaurants/finance/v1/stores/1234/store_adjustments

este es un ejemplo de la solicitud:

URL url = new URL("https://api.dev.rappi.com/restaurants/finance/v1/stores/1234/store_adjustments"); 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());



Ejemplo de Respuesta

Este es un ejemplo de la respuesta:

{ "page_number": 1, "page_size": 10, "order_by": "string", "order_type": "string", "total_pages": 0, "total_entries": 0, "entries": [ { "id": 0, "description": "string", "amount": 0, "created_at": "2023-11-07", "payment_id": 0, "store_id": 0, "description_reason": "string" } ] }

GET loans

Devuelve una lista de cuotas de préstamos por pago o por tienda y un período de pago.

Endpoint URL

Utilice esta URL para realizar una consulta con este endpoint:

https://{COUNTRY_DOMAIN}/restaurants/finance/v1/stores/{store_id}/loans

{COUNTRY_DOMAIN}: Este es tu dominio país Rappi. Ver la lista de Dominios de Países.

Propiedades del Endpoint

Este recurso tiene las siguientes propiedades:

Formatos de respuestaJSON
Requisitos de autenticaciónToken

Parámetros

Este endpoint admite los siguientes parámetros:

ParámetroPathQueryDescripción
store_idXEl identificador único de la tienda solicitada
page_numberXNúmero de páginas que desea obtener
page_sizeXEl tamaño máximo de entradas en respuestas paginadas
payment_id:eqXEl payment_id debe ser igual a su valor
created_at:gteXEl created_at debe ser mayor o igual a su valor
created_at:lteXEl created_at debe ser menor o igual a su valor

Códigos de Estados

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

Ejemplo de Solicitud

Este es un ejemplo de una solicitud de API utilizando este endpoint:

GET https://api.dev.rappi.com/restaurants/finance/v1/stores/1234/loans

este es un ejemplo de la solicitud:

URL url = new URL("https://api.dev.rappi.com/restaurants/finance/v1/stores/1234/loans"); 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());



Ejemplo de Respuesta

Este es un ejemplo de la respuesta:

{ "page_number": 1, "page_size": 10, "order_by": "string", "order_type": "string", "total_pages": 0, "total_entries": 0, "entries": [ { "id": 0, "description_type": "string", "balance": 0, "frequency": 0, "created_at": "2023-11-07", "currency": "string", "disbursement_date": "2023-11-07", "disbursement_amount": 0, "deadline": "2023-11-07", "reason": "string", "stores": ["string"], "type": "string", "installment_amount": 0, "installment_percentage": 0, "lastCollection_date": "2023-11-07", "amortization": "string", "installments": { "installment_amount": 0, "installment_created_at": "2023-11-07", "store_id": 0, "payment_id": 0 } } ] }

GET debts

Devuelve información de deudas pendientes de periodos pasados por pago o por tienda y un periodo de pago.

Endpoint URL

Utilice esta URL para realizar una consulta con este endpoint:

https://{COUNTRY_DOMAIN}/restaurants/finance/v1/stores/{store_id}/debts

{COUNTRY_DOMAIN}: Este es tu dominio país de Rappi. Ver la lista de Dominios de Países.

Propiedades del Endpoint

Este recurso tiene las siguientes propiedades:

Formatos de respuestaJSON
Requisitos de autenticaciónToken

Parámetros

Este endpoint admite los siguientes parámetros:

ParámetroPathQueryDescripción
store_idXEl identificador único de la tienda solicitada
page_numberXNúmero de páginas que desea obtener
page_sizeXEl tamaño máximo de entradas en respuestas paginadas
payment_id:eqXThe payment_id debe ser igual a su valor
created_at:gteXThe created_at debe ser mayor o igual a su valor
created_at:lteXThe created_at debe ser menor o igual a su valor

Códigos de Estados

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

Ejemplo de Solicitud

Este es un ejemplo de una solicitud de API utilizando este endpoint:

GET https://api.dev.rappi.com/restaurants/finance/v1/stores/1234/debts

este es un ejemplo de la solicitud:

URL url = new URL("https://api.dev.rappi.com/restaurants/finance/v1/stores/1234/debts"); 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());



Ejemplo de Respuesta

Este es un ejemplo de la respuesta:

{ "page_number": 1, "page_size": 10, "order_by": "string", "order_type": "string", "total_pages": 0, "total_entries": 0, "entries": [ { "id": 0, "description": "string", "payment_debt": 0, "payment_paid": 0, "store_id": "string", "amount": 0, "created_at": "2023-11-07" } ] }

GET extras

Devuelve un listado de cargos extras (tarifas, descuentos, otros) por pago o por tienda y un periodo de pago.

Endpoint URL

Utilice esta URL para realizar una consulta con este endpoint:

https://{COUNTRY_DOMAIN}/restaurants/finance/v1/stores/{store_id}/extras

{COUNTRY_DOMAIN}: Este es tu dominio país de Rappi. Ver la lista de Dominios de Países.

Propiedades del Endpoint

Este recurso tiene las siguientes propiedades:

Formatos de respuestaJSON
Requisitos de autenticaciónToken

Parámetros

Este endpoint admite los siguientes parámetros:

ParámetroPathQueryDescripción
store_idXEl identificador único de la tienda solicitada
page_numberXNúmero de páginas que desea obtener
page_sizeXEl tamaño máximo de entradas en respuestas paginadas
payment_id:eqXThe payment_id debe ser igual a su valor
created_at:gteXThe created_at debe ser mayor o igual a su valor
created_at:lteXThe created_at debe ser menor o igual a su valor

Códigos de Estados

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

Ejemplo de Solicitud

Este es un ejemplo de una solicitud de API utilizando este endpoint:

GET https://api.dev.rappi.com/restaurants/finance/v1/stores/1234/extras

este es un ejemplo de la solicitud:

URL url = new URL("https://api.dev.rappi.com/restaurants/finance/v1/stores/1234/extras"); 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());



Ejemplo de Respuesta

Este es un ejemplo de la respuesta:

{ "page_number": 1, "page_size": 10, "order_by": "string", "order_type": "string", "total_pages": 0, "total_entries": 0, "entries": [ { "id": 0, "reason": "string", "description": "string", "amount": 0, "store_id": 0, "payment_id": 0, "created_at": "2023-11-07" } ] }

GET taxes

Devuelve una lista de impuestos por pago o por tienda y un período de pago.

Endpoint URL

Utilice esta URL para realizar una consulta con este endpoint:

https://{COUNTRY_DOMAIN}/restaurants/finance/v1/stores/{store_id}/taxes

{COUNTRY_DOMAIN}: Este es tu dominio país de Rappi. Ver la lista de Dominios de Países.

Propiedades del Endpoint

Este recurso tiene las siguientes propiedades:

Formatos de respuestaJSON
Requisitos de autenticaciónToken

Parámetros

Este endpoint admite los siguientes parámetros:

ParámetroPathQueryDescripción
store_idXEl identificador único de la tienda solicitada
page_numberXNúmero de páginas que desea obtener
page_sizeXEl tamaño máximo de entradas en respuestas paginadas
payment_id:eqXEl payment_id debe ser igual a su valor
created_at:gteXEl created_at debe ser mayor o igual a su valor
created_at:lteXEl created_at debe ser menor o igual a su valor

Códigos de Estados

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

Ejemplo de Solicitud

Este es un ejemplo de una solicitud de API utilizando este endpoint:

GET https://api.dev.rappi.com/restaurants/finance/v1/stores/1234/taxes

este es un ejemplo de la solicitud:

URL url = new URL("https://api.dev.rappi.com/restaurants/finance/v1/stores/1234/taxes"); 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());



Ejemplo de Respuesta

Este es un ejemplo de la respuesta:

{ "page_number": 1, "page_size": 10, "order_by": "string", "order_type": "string", "total_pages": 0, "total_entries": 0, "entries": [ { "id": 0, "reason": "string", "description": "string", "amount": 0, "store_id": 0, "payment_id": 0, "created_at": "2023-11-07", "flow_name": "string" } ] }

GET compensations

Devuelve una lista de compensaciones y su detalle por pago o por tienda y un periodo de pago.

Endpoint URL

Utilice esta URL para realizar una consulta con este endpoint:

https://{COUNTRY_DOMAIN}/restaurants/finance/v1/stores/{store_id}/compensations

{COUNTRY_DOMAIN}: Este es tu dominio país de Rappi. Ver la lista de Dominios de Países.

Propiedades del Endpoint

Este recurso tiene las siguientes propiedades:

Formatos de respuestaJSON
Requisitos de autenticaciónToken

Parámetros

Este endpoint admite los siguientes parámetros:

ParámetroPathQueryDescripción
store_idXEl identificador único de la tienda solicitada
page_numberXNúmero de páginas que desea obtener
page_sizeXEl tamaño máximo de entradas en respuestas paginadas
created_at:gteXEl created_at debe ser mayor o igual a su valor
created_at:lteXEl created_at debe ser menor o igual a su valor

Códigos de Estados

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

Ejemplo de Solicitud

Este es un ejemplo de una solicitud de API utilizando este endpoint:

GET https://api.dev.rappi.com/restaurants/finance/v1/stores/1234/compensations

este es un ejemplo de la solicitud:

URL url = new URL("https://api.dev.rappi.com/restaurants/finance/v1/stores/1234/compensations"); 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());



Ejemplo de Respuesta

Este es un ejemplo de la respuesta:

{ "page_number": 1, "page_size": 10, "order_by": "string", "order_type": "string", "total_pages": 0, "total_entries": 0, "entries": [ { "id": 0, "payment_id": 0, "order_date": "2023-11-07", "store_id": 0, "store_name": "string", "store_type": "string", "order_status": "string", "amount": 0, "comments": "string", "created_at": "2023-11-07", "order_id": 0, "product_ids": [ { "product_id": 0, "units": "string" } ], "reason": "string" } ] }

GET cancellations

Devuelve una lista de cancelaciones (pedidos) por tienda y un período de pago.

Endpoint URL

Utilice esta URL para realizar una consulta con este endpoint:

https://{COUNTRY_DOMAIN}/restaurants/finance/v1/stores/{store_id}/cancellations

{COUNTRY_DOMAIN}: Este es tu dominio país de Rappi. Ver la lista de Dominios de Países.

Propiedades del Endpoint

Este recurso tiene las siguientes propiedades:

Formatos de respuestaJSON
Requisitos de autenticaciónToken

Parámetros

Este endpoint admite los siguientes parámetros:

ParámetroPathQueryDescripción
store_idXEl identificador único de la tienda solicitada
page_numberXNúmero de páginas que desea obtener
page_sizeXEl tamaño máximo de entradas en respuestas paginadas
cancellation_date:gteXEl cancellation_date debe ser mayor o igual a su valor
cancellation_date:lteXEl cancellation_date debe ser menor o igual a su valor

Códigos de Estados

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

Ejemplo de Solicitud

Este es un ejemplo de una solicitud de API utilizando este endpoint:

GET https://api.dev.rappi.com/restaurants/finance/v1/stores/1234/cancellations

este es un ejemplo de la solicitud:

URL url = new URL("https://api.dev.rappi.com/restaurants/finance/v1/stores/1234/cancellations"); 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());



Ejemplo de Respuesta

Este es un ejemplo de la respuesta:

{ "page_number": 1, "page_size": 10, "order_by": "string", "order_type": "string", "total_pages": 0, "total_entries": 0, "entries": [ { "order_id": 0, "cancellation_date": "2023-11-07T23:35:38.537Z", "order_date": "2023-11-07T23:35:38.537Z", "store_id": 0, "store_name": "string", "store_type": "string", "order_status": "string", "payment_method": "string", "cancellation_code": "string", "cancellation_description": "string", "amount": 0, "is_prime": "string" } ] }

GET agreements

Devuelve información sobre las condiciones del contrato que subyacen a los importes cobrados por cada concepto dentro de un pago.

Endpoint URL

Utilice esta URL para realizar una consulta con este endpoint:

https://{COUNTRY_DOMAIN}/restaurants/finance/v1/stores/{store_id}/agreements

{COUNTRY_DOMAIN}: Este es tu dominio país de Rappi. Ver la lista de Dominios de Países.

Propiedades del Endpoint

Este recurso tiene las siguientes propiedades:

Formatos de respuestaJSON
Requisitos de autenticaciónToken

Parámetros

Este endpoint admite los siguientes parámetros:

ParámetroPathQueryDescripción
store_idXEl identificador único de la tienda solicitada
page_numberXNúmero de páginas que desea obtener
page_sizeXEl tamaño máximo de entradas en respuestas paginadas
created_at:gteXEl created_at debe ser mayor o igual a su valor
created_at:lteXEl created_at debe ser menor o igual a su valor

Códigos de Estados

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

Ejemplo de Solicitud

Este es un ejemplo de una solicitud de API utilizando este endpoint:

GET https://api.dev.rappi.com/restaurants/finance/v1/stores/1234/agreements

este es un ejemplo de la solicitud:

URL url = new URL("https://api.dev.rappi.com/restaurants/finance/v1/stores/1234/agreements"); 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());



Ejemplo de Respuesta

Este es un ejemplo de la respuesta:

{ "page_number": 1, "page_size": 10, "order_by": "string", "order_type": "string", "total_pages": 0, "total_entries": 0, "entries": [ { "contracted_plan": "string", "application_fnfo": { "name": "string", "document_number": "string", "corporate_name": "string", "state_registration": "string", "municipal_registration": "string", "address": { "country": "string", "state": "string", "city": "string", "district": "string", "street": "string", "number": "string", "zipCode": "string", "complement": "string", "reference": "string" }, "contact_fnfo": { "contact_email": "user@example.com", "contact_phone": "string", "contact_name": "string" } }, "store_info": { "store_id": "string", "type": "string", "document": "string", "name": "string", "corporate_name": "string", "is_marketplace": true, "address": { "city": "string" } }, "contract_info": { "frequency_type": "string", "contract_term": { "start_date": "2023-11-07", "end_date": "2023-11-07" } }, "conditions": [ { "name": "string", "commision": "string" } ] } ] }

Conciliacion de Pagos V2 - Credenciales Multi-Tienda

GET payments (V2)

Devuelve una lista de pagos filtrados por tienda y por período de pago con información del comerciante y detalles de cada pago.

Endpoint URL

Utilice esta URL para realizar una consulta con este endpoint:

https://{COUNTRY_DOMAIN}/restaurants/finance/v2/stores/{store_id}/payments

{COUNTRY_DOMAIN}: Este es tu dominio país Rappi. Ver la lista de Dominios de Países.

Propiedades del Endpoint

Este recurso tiene las siguientes propiedades:

Formatos de respuestaJSON
Requisitos de autenticaciónToken

Parámetros

Este endpoint admite los siguientes parámetros:

ParámetroPathQueryDescripción
store_idXEl identificador único de la tienda solicitada.
page_numberXNúmero de páginas que desea obtener
page_sizeXEl tamaño máximo de entradas en respuestas paginadas
payment_id:eqXEl payment_id debe ser igual a su valor
expected_execution_date:gteXEl expected_execution_date debe ser mayor o igual a su valor
expect_execution_date:lteXEl confirmed_payment_date debe ser menor o igual a su valor
confirmed_payment_date:gteXEl confirmed_payment_date debe ser mayor o igual a su valor
confirmed_payment_date:lteXEl confirmed_payment_date debe ser menor o igual a su valor

Códigos de Estados

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

Ejemplo de Solicitud

Este es un ejemplo de una solicitud de API utilizando este endpoint:

GET https://api.dev.rappi.com/restaurants/finance/v2/stores/1234/payments

este es un ejemplo de la solicitud:

URL url = new URL("https://api.dev.rappi.com/restaurants/finance/v2/stores/1234/payments"); 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());



Ejemplo de Respuesta

Este es un ejemplo de la respuesta:

{ "page_number": 1, "page_size": 10, "order_by": "string", "order_type": "string", "total_pages": 0, "total_entries": 0, "entries": [ { "id": 1000, "status": "string", "period_date_start": "2023-11-07T22:02:47.009Z", "period_date_end": "2023-11-07T22:02:47.009Z", "expected_execution_date": "2023-11-07T22:02:47.009Z", "confirmed_payment_date": "2023-11-07T22:02:47.009Z", "total_amount": 0, "payment_reference": "string", "frequecy_type": "string", "frequecy_type_descripcion": "string", "balance_request_id": "string", "bank_account": { "bank_name": "string", "account_number": "string", "bank_code": "string", "account_type": "string", "ispb": "string", "document": { "identification_type": "string", "identification_number": "string", "holder_name": "string" } }, "consolidated_stores": [1000] } ] }

Campos de Respuesta

CampoTipoDescripción
idintegerIdentificador único del pago
statusstringEstado del pago
period_date_startdatetimeFecha de inicio del período de pago
period_date_enddatetimeFecha de fin del período de pago
expected_execution_datedatetimeFecha esperada de ejecución del pago
confirmed_payment_datedatetimeFecha confirmada del pago
total_amountnumberMonto total del pago
payment_referencestringReferencia del pago
frequecy_typestringTipo de frecuencia de pago
frequecy_type_descripcionstringDescripción del tipo de frecuencia
balance_request_idstringID de la solicitud de balance
bank_accountobjectInformación de la cuenta bancaria
bank_account.bank_namestringNombre del banco
bank_account.account_numberstringNúmero de cuenta
bank_account.bank_codestringCódigo del banco
bank_account.account_typestringTipo de cuenta
bank_account.ispbstringCódigo ISPB (Brasil)
bank_account.document.identification_typestringTipo de documento de identificación
bank_account.document.identification_numberstringNúmero de documento
bank_account.document.holder_namestringNombre del titular
consolidated_storesarrayLista de tiendas consolidadas en el pago

GET orders (V2)

Devuelve una lista de pedidos por pago o por tienda y un período de pago.

Endpoint URL

Utilice esta URL para realizar una consulta con este endpoint:

https://{COUNTRY_DOMAIN}/restaurants/finance/v2/stores/{store_id}/orders

{COUNTRY_DOMAIN}: Este es tu dominio país Rappi. Ver la lista de Dominios de Países.

Propiedades del Endpoint

Este recurso tiene las siguientes propiedades:

Formatos de respuestaJSON
Requisitos de autenticaciónToken

Parámetros

Este endpoint admite los siguientes parámetros:

ParámetroPathQueryDescripción
store_idXEl identificador único de la tienda solicitada.
page_numberXNúmero de páginas que desea obtener
page_sizeXEl tamaño máximo de entradas en respuestas paginadas.
order_date:gteXEl order_date debe ser mayor o igual a su valor
order_date:lteXEl order_date debe ser menor o igual a su valor
order_status:eqXEl order_status debe ser igual a su valor
payment_id:eqXEl payment_id debe ser igual a su valor

Códigos de Estados

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

Ejemplo de Solicitud

Este es un ejemplo de una solicitud de API utilizando este endpoint:

GET https://api.dev.rappi.com/restaurants/finance/v2/stores/1234/orders

este es un ejemplo de la solicitud:

URL url = new URL("https://api.dev.rappi.com/restaurants/finance/v2/stores/1234/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());



Ejemplo de Respuesta

Este es un ejemplo de la respuesta:

{ "page_number": 1, "page_size": 10, "order_by": "string", "order_type": "string", "total_pages": 0, "total_entries": 0, "entries": [ { "id": 0, "payment_id": 0, "order_date": "2023-11-07T23:01:44.394Z", "store_id": 0, "store_name": "string", "store_type": "string", "order_status": "string", "payment_method": "string", "is_prime": "string", "items": [ { "name": "string", "units": "string" } ], "amount": 0, "billing": { "total_order": 0, "comission_product": 0, "cofins": 0, "pis": 0, "iss": 0, "income_tax": 0, "compensation": 0, "discount_by_marketplace_in_cash": 0, "total_order_whim": 0, "free_shipping": 0, "other_discounts": 0, "meal_voucher": 0, "marketplace_fee_no_cash": 0, "global_offer_coupon": 0, "paid_by_user": 0, "commission_whim": 0, "rappi_credits_cash_back": 0, "service_fee": 0, "shipping_partner_no_limit": 0, "shipping_partner_limit": 0, "marketplace_charge": 0 } } ] }

Campos de Respuesta

CampoTipoDescripción
idintegerIdentificador único de la orden
payment_idintegerID del pago asociado
order_datedatetimeFecha de la orden
store_idintegerID de la tienda
store_namestringNombre de la tienda
store_typestringTipo de tienda
order_statusstringEstado de la orden
payment_methodstringMétodo de pago utilizado
is_primestringIndica si la orden es de un usuario Prime
itemsarrayLista de productos de la orden
items[].namestringNombre del producto
items[].unitsstringCantidad de unidades
amountnumberMonto de la orden
billing.total_ordernumberTotal de la orden
billing.comission_productnumberComisión por producto
billing.cofinsnumberImpuesto COFINS (Brasil)
billing.pisnumberImpuesto PIS (Brasil)
billing.issnumberImpuesto ISS (Brasil)
billing.income_taxnumberImpuesto sobre la renta
billing.compensationnumberCompensación aplicada
billing.discount_by_marketplace_in_cashnumberDescuento del marketplace en efectivo
billing.total_order_whimnumberTotal de la orden Whim
billing.free_shippingnumberEnvío gratis aplicado
billing.other_discountsnumberOtros descuentos
billing.meal_vouchernumberVale de comida
billing.marketplace_fee_no_cashnumberComisión del marketplace (no efectivo)
billing.global_offer_couponnumberCupón de oferta global
billing.paid_by_usernumberMonto pagado por el usuario
billing.commission_whimnumberComisión Whim
billing.rappi_credits_cash_backnumberCashback en créditos Rappi
billing.service_feenumberTarifa de servicio
billing.shipping_partner_no_limitnumberEnvío del partner sin límite
billing.shipping_partner_limitnumberEnvío del partner con límite
billing.marketplace_chargenumberCargo del marketplace

GET order_adjusments (V2)

Devuelve una lista de ajustes de pedidos por pago o por tienda y un período de pago.

Endpoint URL

Utilice esta URL para realizar una consulta con este endpoint:

https://{COUNTRY_DOMAIN}/restaurants/finance/v2/stores/{store_id}/order_adjusments

{COUNTRY_DOMAIN}: Este es tu dominio país Rappi. Ver la lista de Dominios de Países.

Propiedades del Endpoint

Este recurso tiene las siguientes propiedades:

Formatos de respuestaJSON
Requisitos de autenticaciónToken

Parámetros

Este endpoint admite los siguientes parámetros:

ParámetroPathQueryDescripción
store_idXEl identificador único de la tienda solicitada.
page_numberXNúmero de páginas que desea obtener
page_sizeXEl tamaño máximo de entradas en respuestas paginadas
order_date:gteXEl order_date debe ser mayor o igual a su valor
order_date:lteXEl order_date debe ser menor o igual a su valor
order_status:eqXEl order_status debe ser igual a su valor
payment_id:eqXEl payment_id debe ser igual a su valor

Códigos de Estados

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

Ejemplo de Solicitud

Este es un ejemplo de una solicitud de API utilizando este endpoint:

GET https://api.dev.rappi.com/restaurants/finance/v2/stores/1234/order_adjusments

este es un ejemplo de la solicitud:

URL url = new URL("https://api.dev.rappi.com/restaurants/finance/v2/stores/1234/order_adjusments"); 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());



Ejemplo de Respuesta

Este es un ejemplo de la respuesta:

{ "page_number": 1, "page_size": 10, "order_by": "string", "order_type": "string", "total_pages": 0, "total_entries": 0, "entries": [ { "id": 0, "payment_id": 0, "order_date": "2023-11-07T23:03:55.722Z", "store_id": 0, "store_name": "string", "store_type": "string", "order_status": "string", "payment_method": "string", "is_prime": "string", "items": [ { "name": "string", "units": "string" } ], "amount": 0, "billing": { "total_order": 0, "comission_product": 0, "cofins": 0, "pis": 0, "iss": 0, "income_tax": 0, "compensation": 0, "discount_by_marketplace_in_cash": 0, "total_order_whim": 0, "free_shipping": 0, "other_discounts": 0, "meal_voucher": 0, "marketplace_fee_no_cash": 0, "global_offer_coupon": 0, "paid_by_user": 0, "commission_whim": 0, "rappi_credits_cash_back": 0, "service_fee": 0, "shipping_partner_no_limit": 0, "shipping_partner_limit": 0, "marketplace_charge": 0 }, "descriptionAdjustment": "string" } ] }

Campos de Respuesta

CampoTipoDescripción
idintegerIdentificador único de la orden
payment_idintegerID del pago asociado
order_datedatetimeFecha de la orden
store_idintegerID de la tienda
store_namestringNombre de la tienda
store_typestringTipo de tienda
order_statusstringEstado de la orden
payment_methodstringMétodo de pago utilizado
is_primestringIndica si la orden es de un usuario Prime
itemsarrayLista de productos de la orden
items[].namestringNombre del producto
items[].unitsstringCantidad de unidades
amountnumberMonto de la orden
billing.total_ordernumberTotal de la orden
billing.comission_productnumberComisión por producto
billing.cofinsnumberImpuesto COFINS (Brasil)
billing.pisnumberImpuesto PIS (Brasil)
billing.issnumberImpuesto ISS (Brasil)
billing.income_taxnumberImpuesto sobre la renta
billing.compensationnumberCompensación aplicada
billing.discount_by_marketplace_in_cashnumberDescuento del marketplace en efectivo
billing.total_order_whimnumberTotal de la orden Whim
billing.free_shippingnumberEnvío gratis aplicado
billing.other_discountsnumberOtros descuentos
billing.meal_vouchernumberVale de comida
billing.marketplace_fee_no_cashnumberComisión del marketplace (no efectivo)
billing.global_offer_couponnumberCupón de oferta global
billing.paid_by_usernumberMonto pagado por el usuario
billing.commission_whimnumberComisión Whim
billing.rappi_credits_cash_backnumberCashback en créditos Rappi
billing.service_feenumberTarifa de servicio
billing.shipping_partner_no_limitnumberEnvío del partner sin límite
billing.shipping_partner_limitnumberEnvío del partner con límite
billing.marketplace_chargenumberCargo del marketplace
descriptionAdjustmentstringDescripción del ajuste aplicado a la orden

GET charged_cancellations (V2)

Devuelve una lista de cancelaciones (pedidos) y su detalle por pago o por tienda y un periodo de pago.

Endpoint URL

Utilice esta URL para realizar una consulta con este endpoint:

https://{COUNTRY_DOMAIN}/restaurants/finance/v2/stores/{store_id}/charged_cancellations

{COUNTRY_DOMAIN}: Este es tu dominio país Rappi. Ver la lista de Dominios de Países.

Propiedades del Endpoint

Este recurso tiene las siguientes propiedades:

Formatos de respuestaJSON
Requisitos de autenticaciónToken

Parámetros

Este endpoint admite los siguientes parámetros:

ParámetroPathQueryDescripción
store_idXEl identificador único de la tienda solicitada.
page_numberXNúmero de páginas que desea obtener
page_sizeXEl tamaño máximo de entradas en respuestas paginadas
payment_id:eqXEl payment_id debe ser igual a su valor
order_date:gteXEl order_date debe ser mayor o igual a su valor
order_date:lteXEl order_date debe ser menor o igual a su valor

Códigos de Estados

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

Ejemplo de Solicitud

Este es un ejemplo de una solicitud de API utilizando este endpoint:

GET https://api.dev.rappi.com/restaurants/finance/v2/stores/1234/charged_cancellations

este es un ejemplo de la solicitud:

URL url = new URL("https://api.dev.rappi.com/restaurants/finance/v2/stores/1234/charged_cancellations"); 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());



Ejemplo de Respuesta

Este es un ejemplo de la respuesta.:

{ "page_number": 1, "page_size": 10, "order_by": "string", "order_type": "string", "total_pages": 0, "total_entries": 0, "entries": [ { "id": 0, "payment_id": 0, "order_date": "2023-11-07T23:09:48.153Z", "store_id": 0, "store_name": "string", "store_type": "string", "order_status": "string", "payment_method": "string", "is_prime": "string", "items": [ { "name": "string", "units": "string" } ], "amount": 0, "billing": { "total_order": 0, "comission_product": 0, "cofins": 0, "pis": 0, "iss": 0, "income_tax": 0, "compensation": 0, "discount_by_marketplace_in_cash": 0, "total_order_whim": 0, "free_shipping": 0, "other_discounts": 0, "meal_voucher": 0, "marketplace_fee_no_cash": 0, "global_offer_coupon": 0, "paid_by_user": 0, "commission_whim": 0, "rappi_credits_cash_back": 0, "service_fee": 0, "shipping_partner_no_limit": 0, "shipping_partner_limit": 0, "marketplace_charge": 0 }, "cancellatioPercentage": "string", "descriptionCancellation": "string", "cancellation_code": "string", "cancellation_description": "string" } ] }

Campos de Respuesta

CampoTipoDescripción
idintegerIdentificador único de la orden
payment_idintegerID del pago asociado
order_datedatetimeFecha de la orden
store_idintegerID de la tienda
store_namestringNombre de la tienda
store_typestringTipo de tienda
order_statusstringEstado de la orden
payment_methodstringMétodo de pago utilizado
is_primestringIndica si la orden es de un usuario Prime
itemsarrayLista de productos de la orden
items[].namestringNombre del producto
items[].unitsstringCantidad de unidades
amountnumberMonto de la orden
billing.total_ordernumberTotal de la orden
billing.comission_productnumberComisión por producto
billing.cofinsnumberImpuesto COFINS (Brasil)
billing.pisnumberImpuesto PIS (Brasil)
billing.issnumberImpuesto ISS (Brasil)
billing.income_taxnumberImpuesto sobre la renta
billing.compensationnumberCompensación aplicada
billing.discount_by_marketplace_in_cashnumberDescuento del marketplace en efectivo
billing.total_order_whimnumberTotal de la orden Whim
billing.free_shippingnumberEnvío gratis aplicado
billing.other_discountsnumberOtros descuentos
billing.meal_vouchernumberVale de comida
billing.marketplace_fee_no_cashnumberComisión del marketplace (no efectivo)
billing.global_offer_couponnumberCupón de oferta global
billing.paid_by_usernumberMonto pagado por el usuario
billing.commission_whimnumberComisión Whim
billing.rappi_credits_cash_backnumberCashback en créditos Rappi
billing.service_feenumberTarifa de servicio
billing.shipping_partner_no_limitnumberEnvío del partner sin límite
billing.shipping_partner_limitnumberEnvío del partner con límite
billing.marketplace_chargenumberCargo del marketplace
cancellatioPercentagestringPorcentaje de cancelación cobrado
descriptionCancellationstringDescripción de la cancelación
cancellation_codestringCódigo de la cancelación
cancellation_descriptionstringDescripción del código de cancelación

GET store_adjustments (V2)

Devuelve una lista de ajustes de tienda por pago o por tienda y un período de pago.

Endpoint URL

Utilice esta URL para realizar una consulta con este endpoint:

https://{COUNTRY_DOMAIN}/restaurants/finance/v2/stores/{store_id}/store_adjustments

{COUNTRY_DOMAIN}: Este es tu dominio país Rappi. Ver la lista de Dominios de Países.

Propiedades del Endpoint

Este recurso tiene las siguientes propiedades:

Formatos de respuestaJSON
Requisitos de autenticaciónToken

Parámetros

Este endpoint admite los siguientes parámetros:

ParámetroPathQueryDescripción
store_idXEl identificador único de la tienda solicitada.
page_numberXNúmero de páginas que desea obtener
page_sizeXEl tamaño máximo de entradas en respuestas paginadas.
payment_id:eqXEl payment_id debe ser igual a su valor
created_at:gteXEl created_at debe ser mayor o igual a su valor
created_at:lteXEl created_at debe ser menor o igual a su valor

Códigos de Estados

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

Ejemplo de Solicitud

Este es un ejemplo de una solicitud de API utilizando este endpoint:

GET https://api.dev.rappi.com/restaurants/finance/v2/stores/1234/store_adjustments

este es un ejemplo de la solicitud:

URL url = new URL("https://api.dev.rappi.com/restaurants/finance/v2/stores/1234/store_adjustments"); 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());



Ejemplo de Respuesta

Este es un ejemplo de la respuesta:

{ "page_number": 1, "page_size": 10, "order_by": "string", "order_type": "string", "total_pages": 0, "total_entries": 0, "entries": [ { "id": 0, "description": "string", "amount": 0, "created_at": "2023-11-07", "payment_id": 0, "store_id": 0, "description_reason": "string" } ] }

Campos de Respuesta

CampoTipoDescripción
idintegerIdentificador único del ajuste
descriptionstringDescripción del ajuste
amountnumberMonto del ajuste
created_atdateFecha de creación
payment_idintegerID del pago asociado
store_idintegerID de la tienda
description_reasonstringRazón del ajuste

GET loans (V2)

Devuelve una lista de cuotas de préstamos por pago o por tienda y un período de pago.

Endpoint URL

Utilice esta URL para realizar una consulta con este endpoint:

https://{COUNTRY_DOMAIN}/restaurants/finance/v2/stores/{store_id}/loans

{COUNTRY_DOMAIN}: Este es tu dominio país Rappi. Ver la lista de Dominios de Países.

Propiedades del Endpoint

Este recurso tiene las siguientes propiedades:

Formatos de respuestaJSON
Requisitos de autenticaciónToken

Parámetros

Este endpoint admite los siguientes parámetros:

ParámetroPathQueryDescripción
store_idXEl identificador único de la tienda solicitada
page_numberXNúmero de páginas que desea obtener
page_sizeXEl tamaño máximo de entradas en respuestas paginadas
payment_id:eqXEl payment_id debe ser igual a su valor
created_at:gteXEl created_at debe ser mayor o igual a su valor
created_at:lteXEl created_at debe ser menor o igual a su valor

Códigos de Estados

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

Ejemplo de Solicitud

Este es un ejemplo de una solicitud de API utilizando este endpoint:

GET https://api.dev.rappi.com/restaurants/finance/v2/stores/1234/loans

este es un ejemplo de la solicitud:

URL url = new URL("https://api.dev.rappi.com/restaurants/finance/v2/stores/1234/loans"); 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());



Ejemplo de Respuesta

Este es un ejemplo de la respuesta:

{ "page_number": 1, "page_size": 10, "order_by": "string", "order_type": "string", "total_pages": 0, "total_entries": 0, "entries": [ { "id": 0, "description_type": "string", "balance": 0, "frequency": 0, "created_at": "2023-11-07", "currency": "string", "disbursement_date": "2023-11-07", "disbursement_amount": 0, "deadline": "2023-11-07", "reason": "string", "stores": ["string"], "type": "string", "installment_amount": 0, "installment_percentage": 0, "lastCollection_date": "2023-11-07", "amortization": "string", "installments": { "installment_amount": 0, "installment_created_at": "2023-11-07", "store_id": 0, "payment_id": 0 } } ] }

Campos de Respuesta

CampoTipoDescripción
idintegerIdentificador único del préstamo
description_typestringTipo de préstamo
balancenumberSaldo pendiente
frequencyintegerFrecuencia de cobro
created_atdateFecha de creación
currencystringMoneda
disbursement_datedateFecha de desembolso
disbursement_amountnumberMonto desembolsado
deadlinedateFecha límite de pago
reasonstringRazón del préstamo
storesarrayTiendas asociadas al préstamo
typestringTipo
installment_amountnumberMonto de la cuota
installment_percentagenumberPorcentaje de la cuota
lastCollection_datedateFecha del último cobro
amortizationstringTipo de amortización
installments.installment_amountnumberMonto de cada cuota
installments.installment_created_atdateFecha de creación de la cuota
installments.store_idintegerID de la tienda de la cuota
installments.payment_idintegerID del pago de la cuota

GET debts (V2)

Devuelve información de deudas pendientes de periodos pasados por pago o por tienda y un periodo de pago.

Endpoint URL

Utilice esta URL para realizar una consulta con este endpoint:

https://{COUNTRY_DOMAIN}/restaurants/finance/v2/stores/{store_id}/debts

{COUNTRY_DOMAIN}: Este es tu dominio país de Rappi. Ver la lista de Dominios de Países.

Propiedades del Endpoint

Este recurso tiene las siguientes propiedades:

Formatos de respuestaJSON
Requisitos de autenticaciónToken

Parámetros

Este endpoint admite los siguientes parámetros:

ParámetroPathQueryDescripción
store_idXEl identificador único de la tienda solicitada
page_numberXNúmero de páginas que desea obtener
page_sizeXEl tamaño máximo de entradas en respuestas paginadas
payment_id:eqXThe payment_id debe ser igual a su valor
created_at:gteXThe created_at debe ser mayor o igual a su valor
created_at:lteXThe created_at debe ser menor o igual a su valor

Códigos de Estados

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

Ejemplo de Solicitud

Este es un ejemplo de una solicitud de API utilizando este endpoint:

GET https://api.dev.rappi.com/restaurants/finance/v2/stores/1234/debts

este es un ejemplo de la solicitud:

URL url = new URL("https://api.dev.rappi.com/restaurants/finance/v2/stores/1234/debts"); 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());



Ejemplo de Respuesta

Este es un ejemplo de la respuesta:

{ "page_number": 1, "page_size": 10, "order_by": "string", "order_type": "string", "total_pages": 0, "total_entries": 0, "entries": [ { "id": 0, "description": "string", "payment_debt": 0, "payment_paid": 0, "store_id": "string", "amount": 0, "created_at": "2023-11-07" } ] }

Campos de Respuesta

CampoTipoDescripción
idintegerIdentificador único de la deuda
descriptionstringDescripción de la deuda
payment_debtnumberMonto de la deuda
payment_paidnumberMonto pagado de la deuda
store_idstringID de la tienda
amountnumberMonto total
created_atdateFecha de creación

GET extras (V2)

Devuelve un listado de cargos extras (tarifas, descuentos, otros) por pago o por tienda y un periodo de pago.

Endpoint URL

Utilice esta URL para realizar una consulta con este endpoint:

https://{COUNTRY_DOMAIN}/restaurants/finance/v2/stores/{store_id}/extras

{COUNTRY_DOMAIN}: Este es tu dominio país de Rappi. Ver la lista de Dominios de Países.

Propiedades del Endpoint

Este recurso tiene las siguientes propiedades:

Formatos de respuestaJSON
Requisitos de autenticaciónToken

Parámetros

Este endpoint admite los siguientes parámetros:

ParámetroPathQueryDescripción
store_idXEl identificador único de la tienda solicitada
page_numberXNúmero de páginas que desea obtener
page_sizeXEl tamaño máximo de entradas en respuestas paginadas
payment_id:eqXThe payment_id debe ser igual a su valor
created_at:gteXThe created_at debe ser mayor o igual a su valor
created_at:lteXThe created_at debe ser menor o igual a su valor

Códigos de Estados

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

Ejemplo de Solicitud

Este es un ejemplo de una solicitud de API utilizando este endpoint:

GET https://api.dev.rappi.com/restaurants/finance/v2/stores/1234/extras

este es un ejemplo de la solicitud:

URL url = new URL("https://api.dev.rappi.com/restaurants/finance/v2/stores/1234/extras"); 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());



Ejemplo de Respuesta

Este es un ejemplo de la respuesta:

{ "page_number": 1, "page_size": 10, "order_by": "string", "order_type": "string", "total_pages": 0, "total_entries": 0, "entries": [ { "id": 0, "reason": "string", "description": "string", "amount": 0, "store_id": 0, "payment_id": 0, "created_at": "2023-11-07" } ] }

Campos de Respuesta

CampoTipoDescripción
idintegerIdentificador único del cargo extra
reasonstringRazón del cargo
descriptionstringDescripción del cargo
amountnumberMonto del cargo
store_idintegerID de la tienda
payment_idintegerID del pago asociado
created_atdateFecha de creación

GET taxes (V2)

Devuelve una lista de impuestos por pago o por tienda y un período de pago.

Endpoint URL

Utilice esta URL para realizar una consulta con este endpoint:

https://{COUNTRY_DOMAIN}/restaurants/finance/v2/stores/{store_id}/taxes

{COUNTRY_DOMAIN}: Este es tu dominio país de Rappi. Ver la lista de Dominios de Países.

Propiedades del Endpoint

Este recurso tiene las siguientes propiedades:

Formatos de respuestaJSON
Requisitos de autenticaciónToken

Parámetros

Este endpoint admite los siguientes parámetros:

ParámetroPathQueryDescripción
store_idXEl identificador único de la tienda solicitada
page_numberXNúmero de páginas que desea obtener
page_sizeXEl tamaño máximo de entradas en respuestas paginadas
payment_id:eqXEl payment_id debe ser igual a su valor
created_at:gteXEl created_at debe ser mayor o igual a su valor
created_at:lteXEl created_at debe ser menor o igual a su valor

Códigos de Estados

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

Ejemplo de Solicitud

Este es un ejemplo de una solicitud de API utilizando este endpoint:

GET https://api.dev.rappi.com/restaurants/finance/v2/stores/1234/taxes

este es un ejemplo de la solicitud:

URL url = new URL("https://api.dev.rappi.com/restaurants/finance/v2/stores/1234/taxes"); 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());



Ejemplo de Respuesta

Este es un ejemplo de la respuesta:

{ "page_number": 1, "page_size": 10, "order_by": "string", "order_type": "string", "total_pages": 0, "total_entries": 0, "entries": [ { "id": 0, "reason": "string", "description": "string", "amount": 0, "store_id": 0, "payment_id": 0, "created_at": "2023-11-07", "flow_name": "string" } ] }

Campos de Respuesta

CampoTipoDescripción
idintegerIdentificador único del impuesto
reasonstringRazón del impuesto
descriptionstringDescripción del impuesto
amountnumberMonto del impuesto
store_idintegerID de la tienda
payment_idintegerID del pago asociado
created_atdateFecha de creación
flow_namestringNombre del flujo/concepto fiscal

GET compensations (V2)

Devuelve una lista de compensaciones y su detalle por pago o por tienda y un periodo de pago.

Endpoint URL

Utilice esta URL para realizar una consulta con este endpoint:

https://{COUNTRY_DOMAIN}/restaurants/finance/v2/stores/{store_id}/compensations

{COUNTRY_DOMAIN}: Este es tu dominio país de Rappi. Ver la lista de Dominios de Países.

Propiedades del Endpoint

Este recurso tiene las siguientes propiedades:

Formatos de respuestaJSON
Requisitos de autenticaciónToken

Parámetros

Este endpoint admite los siguientes parámetros:

ParámetroPathQueryDescripción
store_idXEl identificador único de la tienda solicitada
page_numberXNúmero de páginas que desea obtener
page_sizeXEl tamaño máximo de entradas en respuestas paginadas
created_at:gteXEl created_at debe ser mayor o igual a su valor
created_at:lteXEl created_at debe ser menor o igual a su valor

Códigos de Estados

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

Ejemplo de Solicitud

Este es un ejemplo de una solicitud de API utilizando este endpoint:

GET https://api.dev.rappi.com/restaurants/finance/v2/stores/1234/compensations

este es un ejemplo de la solicitud:

URL url = new URL("https://api.dev.rappi.com/restaurants/finance/v2/stores/1234/compensations"); 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());



Ejemplo de Respuesta

Este es un ejemplo de la respuesta:

{ "page_number": 1, "page_size": 10, "order_by": "string", "order_type": "string", "total_pages": 0, "total_entries": 0, "entries": [ { "id": 0, "payment_id": 0, "order_date": "2023-11-07", "store_id": 0, "store_name": "string", "store_type": "string", "order_status": "string", "amount": 0, "comments": "string", "created_at": "2023-11-07", "order_id": 0, "product_ids": [ { "product_id": 0, "units": "string" } ], "reason": "string" } ] }

Campos de Respuesta

CampoTipoDescripción
idintegerIdentificador único de la compensación
payment_idintegerID del pago asociado
order_datedateFecha de la orden
store_idintegerID de la tienda
store_namestringNombre de la tienda
store_typestringTipo de tienda
order_statusstringEstado de la orden
amountnumberMonto de la compensación
commentsstringComentarios
created_atdateFecha de creación
order_idintegerID de la orden asociada
product_ids[].product_idintegerID del producto
product_ids[].unitsstringUnidades del producto
reasonstringRazón de la compensación

GET cancellations (V2)

Devuelve una lista de cancelaciones (pedidos) por tienda y un período de pago.

Endpoint URL

Utilice esta URL para realizar una consulta con este endpoint:

https://{COUNTRY_DOMAIN}/restaurants/finance/v2/stores/{store_id}/cancellations

{COUNTRY_DOMAIN}: Este es tu dominio país de Rappi. Ver la lista de Dominios de Países.

Propiedades del Endpoint

Este recurso tiene las siguientes propiedades:

Formatos de respuestaJSON
Requisitos de autenticaciónToken

Parámetros

Este endpoint admite los siguientes parámetros:

ParámetroPathQueryDescripción
store_idXEl identificador único de la tienda solicitada
page_numberXNúmero de páginas que desea obtener
page_sizeXEl tamaño máximo de entradas en respuestas paginadas
cancellation_date:gteXEl cancellation_date debe ser mayor o igual a su valor
cancellation_date:lteXEl cancellation_date debe ser menor o igual a su valor

Códigos de Estados

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

Ejemplo de Solicitud

Este es un ejemplo de una solicitud de API utilizando este endpoint:

GET https://api.dev.rappi.com/restaurants/finance/v2/stores/1234/cancellations

este es un ejemplo de la solicitud:

URL url = new URL("https://api.dev.rappi.com/restaurants/finance/v2/stores/1234/cancellations"); 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());



Ejemplo de Respuesta

Este es un ejemplo de la respuesta:

{ "page_number": 1, "page_size": 10, "order_by": "string", "order_type": "string", "total_pages": 0, "total_entries": 0, "entries": [ { "order_id": 0, "cancellation_date": "2023-11-07T23:35:38.537Z", "order_date": "2023-11-07T23:35:38.537Z", "store_id": 0, "store_name": "string", "store_type": "string", "order_status": "string", "payment_method": "string", "cancellation_code": "string", "cancellation_description": "string", "amount": 0, "is_prime": "string" } ] }

Campos de Respuesta

CampoTipoDescripción
order_idintegerID de la orden cancelada
cancellation_datedatetimeFecha de la cancelación
order_datedatetimeFecha original de la orden
store_idintegerID de la tienda
store_namestringNombre de la tienda
store_typestringTipo de tienda
order_statusstringEstado de la orden
payment_methodstringMétodo de pago
cancellation_codestringCódigo de cancelación
cancellation_descriptionstringDescripción de la cancelación
amountnumberMonto de la cancelación
is_primestringSi la orden era de un usuario Prime

GET agreements (V2)

Devuelve información sobre las condiciones del contrato que subyacen a los importes cobrados por cada concepto dentro de un pago.

Endpoint URL

Utilice esta URL para realizar una consulta con este endpoint:

https://{COUNTRY_DOMAIN}/restaurants/finance/v2/stores/{store_id}/agreements

{COUNTRY_DOMAIN}: Este es tu dominio país de Rappi. Ver la lista de Dominios de Países.

Propiedades del Endpoint

Este recurso tiene las siguientes propiedades:

Formatos de respuestaJSON
Requisitos de autenticaciónToken

Parámetros

Este endpoint admite los siguientes parámetros:

ParámetroPathQueryDescripción
store_idXEl identificador único de la tienda solicitada
page_numberXNúmero de páginas que desea obtener
page_sizeXEl tamaño máximo de entradas en respuestas paginadas
created_at:gteXEl created_at debe ser mayor o igual a su valor
created_at:lteXEl created_at debe ser menor o igual a su valor

Códigos de Estados

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

Ejemplo de Solicitud

Este es un ejemplo de una solicitud de API utilizando este endpoint:

GET https://api.dev.rappi.com/restaurants/finance/v2/stores/1234/agreements

este es un ejemplo de la solicitud:

URL url = new URL("https://api.dev.rappi.com/restaurants/finance/v2/stores/1234/agreements"); 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());



Ejemplo de Respuesta

Este es un ejemplo de la respuesta:

{ "page_number": 1, "page_size": 10, "order_by": "string", "order_type": "string", "total_pages": 0, "total_entries": 0, "entries": [ { "contracted_plan": "string", "application_fnfo": { "name": "string", "document_number": "string", "corporate_name": "string", "state_registration": "string", "municipal_registration": "string", "address": { "country": "string", "state": "string", "city": "string", "district": "string", "street": "string", "number": "string", "zipCode": "string", "complement": "string", "reference": "string" }, "contact_fnfo": { "contact_email": "user@example.com", "contact_phone": "string", "contact_name": "string" } }, "store_info": { "store_id": "string", "type": "string", "document": "string", "name": "string", "corporate_name": "string", "is_marketplace": true, "address": { "city": "string" } }, "contract_info": { "frequency_type": "string", "contract_term": { "start_date": "2023-11-07", "end_date": "2023-11-07" } }, "conditions": [ { "name": "string", "commision": "string" } ] } ] }

Campos de Respuesta

CampoTipoDescripción
contracted_planstringPlan contratado
application_fnfo.namestringNombre del aplicante
application_fnfo.document_numberstringNúmero de documento
application_fnfo.corporate_namestringRazón social
application_fnfo.state_registrationstringRegistro estatal
application_fnfo.municipal_registrationstringRegistro municipal
application_fnfo.address.countrystringPaís
application_fnfo.address.statestringEstado/Departamento
application_fnfo.address.citystringCiudad
application_fnfo.address.districtstringDistrito/Barrio
application_fnfo.address.streetstringCalle
application_fnfo.address.numberstringNúmero
application_fnfo.address.zipCodestringCódigo postal
application_fnfo.address.complementstringComplemento de dirección
application_fnfo.address.referencestringReferencia
application_fnfo.contact_fnfo.contact_emailstringEmail de contacto
application_fnfo.contact_fnfo.contact_phonestringTeléfono de contacto
application_fnfo.contact_fnfo.contact_namestringNombre de contacto
store_info.store_idstringID de la tienda
store_info.typestringTipo de tienda
store_info.documentstringDocumento de la tienda
store_info.namestringNombre de la tienda
store_info.corporate_namestringRazón social de la tienda
store_info.is_marketplacebooleanSi es marketplace
store_info.address.citystringCiudad de la tienda
contract_info.frequency_typestringTipo de frecuencia de pago
contract_info.contract_term.start_datedateFecha de inicio del contrato
contract_info.contract_term.end_datedateFecha de fin del contrato
conditions[].namestringNombre de la condición
conditions[].commisionstringPorcentaje de comisión