Rest API - Financial

Financial API operations.

Payment Conciliation

GET payments

Return a list of payments filtered by store and by payment period with merchant information and details of each payment.

Endpoint URL

Use this URL to make a request with this endpoint:

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

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

Endpoint Properties

This resource has the following properties:

Response formatsJSON
Authentication requirementsToken

Parameters

This endpoint admits the following parameters:

ParameterPathQueryDescription
store_idXThe unique identifier of store in request
page_numberXNumber of pages that you want to get
page_sizeXThe maximum size of entries in paginated responses
payment_id:eqXThe payment_id must equal its value
expected_execution_date:gteXThe expected_execution_date must be greather than or equal its value
expect_execution_date:lteXThe confirmed_payment_date must be less than or equal its value
confirmed_payment_date:gteXThe confirmed_payment_date must be greather than or equal its value
confirmed_payment_date:lteXThe confirmed_payment_date must be less than or equal its value

Status Codes

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

Sample Request

This is an example of an API request using this endpoint:

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

this is an example of the request:

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());



Sample Response

This is an example of the response:

{ "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

Returns a list of orders by payment or by store and a payment period.

Endpoint URL

Use this URL to make a request with this endpoint:

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

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

Endpoint Properties

This resource has the following properties:

Response formatsJSON
Authentication requirementsToken

Parameters

This endpoint admits the following parameters:

ParameterPathQueryDescription
store_idXThe unique identifier of store in request
page_numberXNumber of pages that you want to get
page_sizeXThe maximum size of entries in paginated responses
order_date:gteXThe order_date must be greather than or equal its value
order_date:lteXThe order_date must be less than or equal its value
order_status:eqXThe order_status must equal its value
payment_id:eqXThe payment_id must equal its value

Status Codes

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

Sample Request

This is an example of an API request using this endpoint:

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

this is an example of the request:

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());



Sample Response

This is an example of the response:

{ "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

Returns a list of order adjustments by payment or by store and a payment period.

Endpoint URL

Use this URL to make a request with this endpoint:

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

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

Endpoint Properties

This resource has the following properties:

Response formatsJSON
Authentication requirementsToken

Parameters

This endpoint admits the following parameters:

ParameterPathQueryDescription
store_idXThe unique identifier of store in request
page_numberXNumber of pages that you want to get
page_sizeXThe maximum size of entries in paginated responses
order_date:gteXThe order_date must be greather than or equal its value
order_date:lteXThe order_date must be less than or equal its value
order_status:eqXThe order_status must equal its value
payment_id:eqXThe payment_id must equal its value

Status Codes

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

Sample Request

This is an example of an API request using this endpoint:

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

this is an example of the request:

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());



Sample Response

This is an example of the response:

{ "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

Returns a list of cancellations (orders) and its details by payment or by store and a payment period.

Endpoint URL

Use this URL to make a request with this endpoint:

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

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

Endpoint Properties

This resource has the following properties:

Response formatsJSON
Authentication requirementsToken

Parameters

This endpoint admits the following parameters:

ParameterPathQueryDescription
store_idXThe unique identifier of store in request
page_numberXNumber of pages that you want to get
page_sizeXThe maximum size of entries in paginated responses
payment_id:eqXThe payment_id must equal its value
order_date:gteXThe order_date must be greather than or equal its value
order_date:lteXThe order_date must be less than or equal its value

Status Codes

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

Sample Request

This is an example of an API request using this endpoint:

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

this is an example of the request:

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());



Sample Response

This is an example of the response:

{ "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

Returns a list of store adjustments by payment or by store and a payment period.

Endpoint URL

Use this URL to make a request with this endpoint:

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

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

Endpoint Properties

This resource has the following properties:

Response formatsJSON
Authentication requirementsToken

Parameters

This endpoint admits the following parameters:

ParameterPathQueryDescription
store_idXThe unique identifier of store in request
page_numberXNumber of pages that you want to get
page_sizeXThe maximum size of entries in paginated responses
payment_id:eqXThe payment_id must equal its value
created_at:gteXThe created_at must be greather than or equal its value
created_at:lteXThe created_at must be less than or equal its value

Status Codes

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

Sample Request

This is an example of an API request using this endpoint:

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

this is an example of the request:

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());



Sample Response

This is an example of the response:

{ "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

Returns a list of loans installments by payment or by store and a payment period.

Endpoint URL

Use this URL to make a request with this endpoint:

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

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

Endpoint Properties

This resource has the following properties:

Response formatsJSON
Authentication requirementsToken

Parameters

This endpoint admits the following parameters:

ParameterPathQueryDescription
store_idXThe unique identifier of store in request
page_numberXNumber of pages that you want to get
page_sizeXThe maximum size of entries in paginated responses
payment_id:eqXThe payment_id must equal its value
created_at:gteXThe created_at must be greather than or equal its value
created_at:lteXThe created_at must be less than or equal its value

Status Codes

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

Sample Request

This is an example of an API request using this endpoint:

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

this is an example of the request:

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());



Sample Response

This is an example of the response:

{ "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

Returns information of outstanding debts from past periods by payment or by store and a payment period.

Endpoint URL

Use this URL to make a request with this endpoint:

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

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

Endpoint Properties

This resource has the following properties:

Response formatsJSON
Authentication requirementsToken

Parameters

This endpoint admits the following parameters:

ParameterPathQueryDescription
store_idXThe unique identifier of store in request
page_numberXNumber of pages that you want to get
page_sizeXThe maximum size of entries in paginated responses
payment_id:eqXThe payment_id must equal its value
created_at:gteXThe created_at must be greather than or equal its value
created_at:lteXThe created_at must be less than or equal its value

Status Codes

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

Sample Request

This is an example of an API request using this endpoint:

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

this is an example of the request:

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());



Sample Response

This is an example of the response:

{ "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

Returns a list of extra charges (fees, discounts, others) by payment or by store and a payment period.

Endpoint URL

Use this URL to make a request with this endpoint:

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

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

Endpoint Properties

This resource has the following properties:

Response formatsJSON
Authentication requirementsToken

Parameters

This endpoint admits the following parameters:

ParameterPathQueryDescription
store_idXThe unique identifier of store in request
page_numberXNumber of pages that you want to get
page_sizeXThe maximum size of entries in paginated responses
payment_id:eqXThe payment_id must equal its value
created_at:gteXThe created_at must be greather than or equal its value
created_at:lteXThe created_at must be less than or equal its value

Status Codes

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

Sample Request

This is an example of an API request using this endpoint:

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

this is an example of the request:

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());



Sample Response

This is an example of the response:

{ "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

Returns a list of taxes by payment or by store and a payment period.

Endpoint URL

Use this URL to make a request with this endpoint:

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

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

Endpoint Properties

This resource has the following properties:

Response formatsJSON
Authentication requirementsToken

Parameters

This endpoint admits the following parameters:

ParameterPathQueryDescription
store_idXThe unique identifier of store in request
page_numberXNumber of pages that you want to get
page_sizeXThe maximum size of entries in paginated responses
payment_id:eqXThe payment_id must equal its value
created_at:gteXThe created_at must be greather than or equal its value
created_at:lteXThe created_at must be less than or equal its value

Status Codes

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

Sample Request

This is an example of an API request using this endpoint:

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

this is an example of the request:

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());



Sample Response

This is an example of the response:

{ "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

Returns a list of compensations and its details by payment or by store and a payment period.

Endpoint URL

Use this URL to make a request with this endpoint:

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

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

Endpoint Properties

This resource has the following properties:

Response formatsJSON
Authentication requirementsToken

Parameters

This endpoint admits the following parameters:

ParameterPathQueryDescription
store_idXThe unique identifier of store in request
page_numberXNumber of pages that you want to get
page_sizeXThe maximum size of entries in paginated responses
created_at:gteXThe created_at must be greather than or equal its value
created_at:lteXThe created_at must be less than or equal its value

Status Codes

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

Sample Request

This is an example of an API request using this endpoint:

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

this is an example of the request:

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());



Sample Response

This is an example of the response:

{ "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

Returns a list of cancellations (orders) by store and a payment period.

Endpoint URL

Use this URL to make a request with this endpoint:

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

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

Endpoint Properties

This resource has the following properties:

Response formatsJSON
Authentication requirementsToken

Parameters

This endpoint admits the following parameters:

ParameterPathQueryDescription
store_idXThe unique identifier of store in request
page_numberXNumber of pages that you want to get
page_sizeXThe maximum size of entries in paginated responses
cancellation_date:gteXThe cancellation_date must be greather than or equal its value
cancellation_date:lteXThe cancellation_date must be less than or equal its value

Status Codes

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

Sample Request

This is an example of an API request using this endpoint:

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

this is an example of the request:

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());



Sample Response

This is an example of the response:

{ "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

Returns information about the contract conditions that underlie the charged amounts for each concept within a payment.

Endpoint URL

Use this URL to make a request with this endpoint:

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

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

Endpoint Properties

This resource has the following properties:

Response formatsJSON
Authentication requirementsToken

Parameters

This endpoint admits the following parameters:

ParameterPathQueryDescription
store_idXThe unique identifier of store in request
page_numberXNumber of pages that you want to get
page_sizeXThe maximum size of entries in paginated responses
created_at:gteXThe created_at must be greather than or equal its value
created_at:lteXThe created_at must be less than or equal its value

Status Codes

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

Sample Request

This is an example of an API request using this endpoint:

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

this is an example of the request:

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());



Sample Response

This is an example of the response:

{ "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" } ] } ] }

Payment Conciliation V2 - Multi-Store Credentials

The v2 endpoints share the same parameters, status codes, and response structure as v1. The key difference is that authentication is handled through multi-store credentials, enabling consolidated financial queries.

GET payments (v2)

Return a list of payments filtered by store and by payment period with merchant information and details of each payment.

Endpoint URL

Use this URL to make a request with this endpoint:

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

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

Endpoint Properties

This resource has the following properties:

Response formatsJSON
Authentication requirementsToken

Parameters

This endpoint admits the following parameters:

ParameterPathQueryDescription
store_idXThe unique identifier of store in request
page_numberXNumber of pages that you want to get
page_sizeXThe maximum size of entries in paginated responses
payment_id:eqXThe payment_id must equal its value
expected_execution_date:gteXThe expected_execution_date must be greather than or equal its value
expect_execution_date:lteXThe confirmed_payment_date must be less than or equal its value
confirmed_payment_date:gteXThe confirmed_payment_date must be greather than or equal its value
confirmed_payment_date:lteXThe confirmed_payment_date must be less than or equal its value

Status Codes

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

Sample Request

This is an example of an API request using this endpoint:

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

this is an example of the request:

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());



Sample Response

This is an example of the response:

{ "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] } ] }

Response Fields

FieldTypeDescription
idintegerUnique payment identifier
statusstringPayment status
period_date_startdatetimePayment period start date
period_date_enddatetimePayment period end date
expected_execution_datedatetimeExpected payment execution date
confirmed_payment_datedatetimeConfirmed payment date
total_amountnumberTotal payment amount
payment_referencestringPayment reference
frequecy_typestringPayment frequency type
frequecy_type_descripcionstringFrequency type description
balance_request_idstringBalance request ID
bank_accountobjectBank account information
bank_account.bank_namestringBank name
bank_account.account_numberstringAccount number
bank_account.bank_codestringBank code
bank_account.account_typestringAccount type
bank_account.ispbstringISPB code (Brazil)
bank_account.document.identification_typestringIdentification document type
bank_account.document.identification_numberstringDocument number
bank_account.document.holder_namestringAccount holder name
consolidated_storesarrayList of stores consolidated in the payment

GET orders (v2)

Returns a list of orders by payment or by store and a payment period.

Endpoint URL

Use this URL to make a request with this endpoint:

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

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

Endpoint Properties

This resource has the following properties:

Response formatsJSON
Authentication requirementsToken

Parameters

This endpoint admits the following parameters:

ParameterPathQueryDescription
store_idXThe unique identifier of store in request
page_numberXNumber of pages that you want to get
page_sizeXThe maximum size of entries in paginated responses
order_date:gteXThe order_date must be greather than or equal its value
order_date:lteXThe order_date must be less than or equal its value
order_status:eqXThe order_status must equal its value
payment_id:eqXThe payment_id must equal its value

Status Codes

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

Sample Request

This is an example of an API request using this endpoint:

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

this is an example of the request:

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());



Sample Response

This is an example of the response:

{ "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 } } ] }

Response Fields

FieldTypeDescription
idintegerUnique order identifier
payment_idintegerAssociated payment ID
order_datedatetimeOrder date
store_idintegerStore ID
store_namestringStore name
store_typestringStore type
order_statusstringOrder status
payment_methodstringPayment method used
is_primestringIndicates if the order is from a Prime user
itemsarrayList of order products
items[].namestringProduct name
items[].unitsstringNumber of units
amountnumberOrder amount
billing.total_ordernumberOrder total
billing.comission_productnumberProduct commission
billing.cofinsnumberCOFINS tax (Brazil)
billing.pisnumberPIS tax (Brazil)
billing.issnumberISS tax (Brazil)
billing.income_taxnumberIncome tax
billing.compensationnumberApplied compensation
billing.discount_by_marketplace_in_cashnumberMarketplace discount in cash
billing.total_order_whimnumberWhim order total
billing.free_shippingnumberFree shipping applied
billing.other_discountsnumberOther discounts
billing.meal_vouchernumberMeal voucher
billing.marketplace_fee_no_cashnumberMarketplace fee (non-cash)
billing.global_offer_couponnumberGlobal offer coupon
billing.paid_by_usernumberAmount paid by user
billing.commission_whimnumberWhim commission
billing.rappi_credits_cash_backnumberRappi credits cashback
billing.service_feenumberService fee
billing.shipping_partner_no_limitnumberPartner shipping without limit
billing.shipping_partner_limitnumberPartner shipping with limit
billing.marketplace_chargenumberMarketplace charge

GET order_adjusments (v2)

Returns a list of order adjustments by payment or by store and a payment period.

Endpoint URL

Use this URL to make a request with this endpoint:

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

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

Endpoint Properties

This resource has the following properties:

Response formatsJSON
Authentication requirementsToken

Parameters

This endpoint admits the following parameters:

ParameterPathQueryDescription
store_idXThe unique identifier of store in request
page_numberXNumber of pages that you want to get
page_sizeXThe maximum size of entries in paginated responses
order_date:gteXThe order_date must be greather than or equal its value
order_date:lteXThe order_date must be less than or equal its value
order_status:eqXThe order_status must equal its value
payment_id:eqXThe payment_id must equal its value

Status Codes

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

Sample Request

This is an example of an API request using this endpoint:

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

this is an example of the request:

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());



Sample Response

This is an example of the response:

{ "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" } ] }

Response Fields

FieldTypeDescription
idintegerUnique order identifier
payment_idintegerAssociated payment ID
order_datedatetimeOrder date
store_idintegerStore ID
store_namestringStore name
store_typestringStore type
order_statusstringOrder status
payment_methodstringPayment method used
is_primestringIndicates if the order is from a Prime user
itemsarrayList of order products
items[].namestringProduct name
items[].unitsstringNumber of units
amountnumberOrder amount
billing.total_ordernumberOrder total
billing.comission_productnumberProduct commission
billing.cofinsnumberCOFINS tax (Brazil)
billing.pisnumberPIS tax (Brazil)
billing.issnumberISS tax (Brazil)
billing.income_taxnumberIncome tax
billing.compensationnumberApplied compensation
billing.discount_by_marketplace_in_cashnumberMarketplace discount in cash
billing.total_order_whimnumberWhim order total
billing.free_shippingnumberFree shipping applied
billing.other_discountsnumberOther discounts
billing.meal_vouchernumberMeal voucher
billing.marketplace_fee_no_cashnumberMarketplace fee (non-cash)
billing.global_offer_couponnumberGlobal offer coupon
billing.paid_by_usernumberAmount paid by user
billing.commission_whimnumberWhim commission
billing.rappi_credits_cash_backnumberRappi credits cashback
billing.service_feenumberService fee
billing.shipping_partner_no_limitnumberPartner shipping without limit
billing.shipping_partner_limitnumberPartner shipping with limit
billing.marketplace_chargenumberMarketplace charge
descriptionAdjustmentstringDescription of the adjustment applied to the order

GET charged_cancellations (v2)

Returns a list of cancellations (orders) and its details by payment or by store and a payment period.

Endpoint URL

Use this URL to make a request with this endpoint:

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

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

Endpoint Properties

This resource has the following properties:

Response formatsJSON
Authentication requirementsToken

Parameters

This endpoint admits the following parameters:

ParameterPathQueryDescription
store_idXThe unique identifier of store in request
page_numberXNumber of pages that you want to get
page_sizeXThe maximum size of entries in paginated responses
payment_id:eqXThe payment_id must equal its value
order_date:gteXThe order_date must be greather than or equal its value
order_date:lteXThe order_date must be less than or equal its value

Status Codes

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

Sample Request

This is an example of an API request using this endpoint:

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

this is an example of the request:

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());



Sample Response

This is an example of the response:

{ "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" } ] }

Response Fields

FieldTypeDescription
idintegerUnique order identifier
payment_idintegerAssociated payment ID
order_datedatetimeOrder date
store_idintegerStore ID
store_namestringStore name
store_typestringStore type
order_statusstringOrder status
payment_methodstringPayment method used
is_primestringIndicates if the order is from a Prime user
itemsarrayList of order products
items[].namestringProduct name
items[].unitsstringNumber of units
amountnumberOrder amount
billing.total_ordernumberOrder total
billing.comission_productnumberProduct commission
billing.cofinsnumberCOFINS tax (Brazil)
billing.pisnumberPIS tax (Brazil)
billing.issnumberISS tax (Brazil)
billing.income_taxnumberIncome tax
billing.compensationnumberApplied compensation
billing.discount_by_marketplace_in_cashnumberMarketplace discount in cash
billing.total_order_whimnumberWhim order total
billing.free_shippingnumberFree shipping applied
billing.other_discountsnumberOther discounts
billing.meal_vouchernumberMeal voucher
billing.marketplace_fee_no_cashnumberMarketplace fee (non-cash)
billing.global_offer_couponnumberGlobal offer coupon
billing.paid_by_usernumberAmount paid by user
billing.commission_whimnumberWhim commission
billing.rappi_credits_cash_backnumberRappi credits cashback
billing.service_feenumberService fee
billing.shipping_partner_no_limitnumberPartner shipping without limit
billing.shipping_partner_limitnumberPartner shipping with limit
billing.marketplace_chargenumberMarketplace charge
cancellatioPercentagestringCancellation percentage charged
descriptionCancellationstringCancellation description
cancellation_codestringCancellation code
cancellation_descriptionstringCancellation code description

GET store_adjustments (v2)

Returns a list of store adjustments by payment or by store and a payment period.

Endpoint URL

Use this URL to make a request with this endpoint:

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

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

Endpoint Properties

This resource has the following properties:

Response formatsJSON
Authentication requirementsToken

Parameters

This endpoint admits the following parameters:

ParameterPathQueryDescription
store_idXThe unique identifier of store in request
page_numberXNumber of pages that you want to get
page_sizeXThe maximum size of entries in paginated responses
payment_id:eqXThe payment_id must equal its value
created_at:gteXThe created_at must be greather than or equal its value
created_at:lteXThe created_at must be less than or equal its value

Status Codes

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

Sample Request

This is an example of an API request using this endpoint:

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

this is an example of the request:

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());



Sample Response

This is an example of the response:

{ "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" } ] }

Response Fields

FieldTypeDescription
idintegerUnique adjustment identifier
descriptionstringAdjustment description
amountnumberAdjustment amount
created_atdateCreation date
payment_idintegerAssociated payment ID
store_idintegerStore ID
description_reasonstringAdjustment reason

GET loans (v2)

Returns a list of loans installments by payment or by store and a payment period.

Endpoint URL

Use this URL to make a request with this endpoint:

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

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

Endpoint Properties

This resource has the following properties:

Response formatsJSON
Authentication requirementsToken

Parameters

This endpoint admits the following parameters:

ParameterPathQueryDescription
store_idXThe unique identifier of store in request
page_numberXNumber of pages that you want to get
page_sizeXThe maximum size of entries in paginated responses
payment_id:eqXThe payment_id must equal its value
created_at:gteXThe created_at must be greather than or equal its value
created_at:lteXThe created_at must be less than or equal its value

Status Codes

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

Sample Request

This is an example of an API request using this endpoint:

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

this is an example of the request:

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());



Sample Response

This is an example of the response:

{ "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 } } ] }

Response Fields

FieldTypeDescription
idintegerUnique loan identifier
description_typestringLoan type
balancenumberOutstanding balance
frequencyintegerCollection frequency
created_atdateCreation date
currencystringCurrency
disbursement_datedateDisbursement date
disbursement_amountnumberDisbursed amount
deadlinedatePayment deadline
reasonstringLoan reason
storesarrayStores associated with the loan
typestringType
installment_amountnumberInstallment amount
installment_percentagenumberInstallment percentage
lastCollection_datedateLast collection date
amortizationstringAmortization type
installments.installment_amountnumberEach installment amount
installments.installment_created_atdateInstallment creation date
installments.store_idintegerInstallment store ID
installments.payment_idintegerInstallment payment ID

GET debts (v2)

Returns information of outstanding debts from past periods by payment or by store and a payment period.

Endpoint URL

Use this URL to make a request with this endpoint:

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

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

Endpoint Properties

This resource has the following properties:

Response formatsJSON
Authentication requirementsToken

Parameters

This endpoint admits the following parameters:

ParameterPathQueryDescription
store_idXThe unique identifier of store in request
page_numberXNumber of pages that you want to get
page_sizeXThe maximum size of entries in paginated responses
payment_id:eqXThe payment_id must equal its value
created_at:gteXThe created_at must be greather than or equal its value
created_at:lteXThe created_at must be less than or equal its value

Status Codes

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

Sample Request

This is an example of an API request using this endpoint:

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

this is an example of the request:

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());



Sample Response

This is an example of the response:

{ "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" } ] }

Response Fields

FieldTypeDescription
idintegerUnique debt identifier
descriptionstringDebt description
payment_debtnumberDebt amount
payment_paidnumberAmount paid on debt
store_idstringStore ID
amountnumberTotal amount
created_atdateCreation date

GET extras (v2)

Returns a list of extra charges (fees, discounts, others) by payment or by store and a payment period.

Endpoint URL

Use this URL to make a request with this endpoint:

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

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

Endpoint Properties

This resource has the following properties:

Response formatsJSON
Authentication requirementsToken

Parameters

This endpoint admits the following parameters:

ParameterPathQueryDescription
store_idXThe unique identifier of store in request
page_numberXNumber of pages that you want to get
page_sizeXThe maximum size of entries in paginated responses
payment_id:eqXThe payment_id must equal its value
created_at:gteXThe created_at must be greather than or equal its value
created_at:lteXThe created_at must be less than or equal its value

Status Codes

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

Sample Request

This is an example of an API request using this endpoint:

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

this is an example of the request:

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());



Sample Response

This is an example of the response:

{ "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" } ] }

Response Fields

FieldTypeDescription
idintegerUnique extra charge identifier
reasonstringCharge reason
descriptionstringCharge description
amountnumberCharge amount
store_idintegerStore ID
payment_idintegerAssociated payment ID
created_atdateCreation date

GET taxes (v2)

Returns a list of taxes by payment or by store and a payment period.

Endpoint URL

Use this URL to make a request with this endpoint:

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

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

Endpoint Properties

This resource has the following properties:

Response formatsJSON
Authentication requirementsToken

Parameters

This endpoint admits the following parameters:

ParameterPathQueryDescription
store_idXThe unique identifier of store in request
page_numberXNumber of pages that you want to get
page_sizeXThe maximum size of entries in paginated responses
payment_id:eqXThe payment_id must equal its value
created_at:gteXThe created_at must be greather than or equal its value
created_at:lteXThe created_at must be less than or equal its value

Status Codes

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

Sample Request

This is an example of an API request using this endpoint:

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

this is an example of the request:

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());



Sample Response

This is an example of the response:

{ "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" } ] }

Response Fields

FieldTypeDescription
idintegerUnique tax identifier
reasonstringTax reason
descriptionstringTax description
amountnumberTax amount
store_idintegerStore ID
payment_idintegerAssociated payment ID
created_atdateCreation date
flow_namestringFiscal flow/concept name

GET compensations (v2)

Returns a list of compensations and its details by payment or by store and a payment period.

Endpoint URL

Use this URL to make a request with this endpoint:

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

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

Endpoint Properties

This resource has the following properties:

Response formatsJSON
Authentication requirementsToken

Parameters

This endpoint admits the following parameters:

ParameterPathQueryDescription
store_idXThe unique identifier of store in request
page_numberXNumber of pages that you want to get
page_sizeXThe maximum size of entries in paginated responses
created_at:gteXThe created_at must be greather than or equal its value
created_at:lteXThe created_at must be less than or equal its value

Status Codes

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

Sample Request

This is an example of an API request using this endpoint:

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

this is an example of the request:

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());



Sample Response

This is an example of the response:

{ "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" } ] }

Response Fields

FieldTypeDescription
idintegerUnique compensation identifier
payment_idintegerAssociated payment ID
order_datedateOrder date
store_idintegerStore ID
store_namestringStore name
store_typestringStore type
order_statusstringOrder status
amountnumberCompensation amount
commentsstringComments
created_atdateCreation date
order_idintegerAssociated order ID
product_ids[].product_idintegerProduct ID
product_ids[].unitsstringProduct units
reasonstringCompensation reason

GET cancellations (v2)

Returns a list of cancellations (orders) by store and a payment period.

Endpoint URL

Use this URL to make a request with this endpoint:

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

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

Endpoint Properties

This resource has the following properties:

Response formatsJSON
Authentication requirementsToken

Parameters

This endpoint admits the following parameters:

ParameterPathQueryDescription
store_idXThe unique identifier of store in request
page_numberXNumber of pages that you want to get
page_sizeXThe maximum size of entries in paginated responses
cancellation_date:gteXThe cancellation_date must be greather than or equal its value
cancellation_date:lteXThe cancellation_date must be less than or equal its value

Status Codes

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

Sample Request

This is an example of an API request using this endpoint:

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

this is an example of the request:

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());



Sample Response

This is an example of the response:

{ "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" } ] }

Response Fields

FieldTypeDescription
order_idintegerCancelled order ID
cancellation_datedatetimeCancellation date
order_datedatetimeOriginal order date
store_idintegerStore ID
store_namestringStore name
store_typestringStore type
order_statusstringOrder status
payment_methodstringPayment method
cancellation_codestringCancellation code
cancellation_descriptionstringCancellation description
amountnumberCancellation amount
is_primestringIf the order was from a Prime user

GET agreements (v2)

Returns information about the contract conditions that underlie the charged amounts for each concept within a payment.

Endpoint URL

Use this URL to make a request with this endpoint:

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

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

Endpoint Properties

This resource has the following properties:

Response formatsJSON
Authentication requirementsToken

Parameters

This endpoint admits the following parameters:

ParameterPathQueryDescription
store_idXThe unique identifier of store in request
page_numberXNumber of pages that you want to get
page_sizeXThe maximum size of entries in paginated responses
created_at:gteXThe created_at must be greather than or equal its value
created_at:lteXThe created_at must be less than or equal its value

Status Codes

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

Sample Request

This is an example of an API request using this endpoint:

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

this is an example of the request:

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());



Sample Response

This is an example of the response:

{ "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" } ] } ] }

Response Fields

FieldTypeDescription
contracted_planstringContracted plan
application_fnfo.namestringApplicant name
application_fnfo.document_numberstringDocument number
application_fnfo.corporate_namestringCorporate name
application_fnfo.state_registrationstringState registration
application_fnfo.municipal_registrationstringMunicipal registration
application_fnfo.address.countrystringCountry
application_fnfo.address.statestringState/Department
application_fnfo.address.citystringCity
application_fnfo.address.districtstringDistrict
application_fnfo.address.streetstringStreet
application_fnfo.address.numberstringNumber
application_fnfo.address.zipCodestringZip code
application_fnfo.address.complementstringAddress complement
application_fnfo.address.referencestringReference
application_fnfo.contact_fnfo.contact_emailstringContact email
application_fnfo.contact_fnfo.contact_phonestringContact phone
application_fnfo.contact_fnfo.contact_namestringContact name
store_info.store_idstringStore ID
store_info.typestringStore type
store_info.documentstringStore document
store_info.namestringStore name
store_info.corporate_namestringStore corporate name
store_info.is_marketplacebooleanIf it is marketplace
store_info.address.citystringStore city
contract_info.frequency_typestringPayment frequency type
contract_info.contract_term.start_datedateContract start date
contract_info.contract_term.end_datedateContract end date
conditions[].namestringCondition name
conditions[].commisionstringCommission percentage