Product schedules by SKU

Use the Utils resource to manage the Schedules configured in your stores.

The following table describes the different contents of the Schedules Utils resource:

ResourceDescription
GET sku/corridor/{corridorId}/integration/{integrationId}Returns the collection of products for the corridor and store
GET sku/schedule/{sku}/corridor/{corridorId}/integration/{integrationId}Returns the product schedules configured for the corridor and store
POST sku/schedule/{sku}/corridor/{corridorId}/integration/{integrationId}Create product schedules for the corridor and store
PUT sku/schedule/{sku}/corridor/{corridorId}/integration/{integrationId}Update product schedules for the corridor and store
DELETE sku/schedule/{sku}/corridor/{corridorId}/integration/{integrationId}/{corridorProductScheduleId}Use this endpoint to delete product schedules configured for the corridor and store.

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

Use this endpoint to retrieve the collections of products configured for the given corridor and store.

Endpoint URL

Use this URL to make a request with this endpoint:

https://{COUNTRY_DOMAIN}/api/rest-ops-utils/sku/corridor/{corridorId}/integration/{integrationId}

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

Sample Request

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

GET https://microservices.dev.rappi.com/api/rest-ops-utils/sku/corridor/123/integration/888

This is an example of the request:

URL url = new URL("https://microservices.dev.rappi.com/api/rest-ops-utils/sku/corridor/123/integration/888"); 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());



Endpoint Properties

This resource has the following properties:

Response formatsJSON
Authentication requirementsToken

Parameters

This endpoint does not permit additional parameters.

Status Codes

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

Sample Response

This is an example of the response:

[ { "sku": 789, "name": "Americano Caliente 16 oz", "description": "16 oz. Espresso con agua caliente.", "corridor_id": 123, "integration_id": "888" }, { "sku": 987, "name": "Americano Caliente 20 oz", "description": "20 oz. Espresso con agua caliente.", "corridor_id": 123, "integration_id": "888" } ]

This table describes the objects contained in the response example:

Response ObjectObject Description
sku
integer
Identifier of the product.
name
string
Name of the product.
description
string
Description of the product .
corridor_id
integer
Identifier of the corridor.
integration_id
string
Identifier of the store that contains the corridor. (The parent store identifier in case of child store request)

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

Use this endpoint to obtain product schedules configured for the corridor and store.

Endpoint URL

Use this URL to make a request with this endpoint:

https://{COUNTRY_DOMAIN}/api/rest-ops-utils/sku/schedule/{sku}/corridor/{corridorId}/integration/{integrationId}

  • {COUNTRY_DOMAIN}: Your Rappi Country Domain. See the list of Country Domains.
  • {integrationId}: This is the identifier of your store.
  • {corridorId}: This is the identifier of the corridor.
  • {sku}: This is the identifier of your product.

Endpoint Properties

This resource has the following properties:

Response formatsJSON
Authentication requirementsToken

Parameters

This endpoint does not permit additional parameters.

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://microservices.dev.rappi.com/api/rest-ops-utils/sku/schedule/{sku}/corridor/{corridorId}/integration/{integrationId}

This is an example of the request:

URL url = new URL("https://microservices.dev.rappi.com/api/rest-ops-utils/sku/schedule/987/corridor/123/integration/888"); 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:

{ "sku": 987, "corridor_id": 123, "integration_id": "888", "schedule_details": [ { "id": 4, "days": "mon,tue,wed,thu,fri,sat,sun,hol", "starts_time": "08:00:00", "ends_time": "23:00:00" } ] }

This table describes the objects contained in the response example:

Response ObjectObject Description
sku
integer
Identifier of your product.
corridor_id
integer
Identifier of the corridor.
integration_id
integer
Identifier of your store. (The parent store identifier in case of child store request)
schedule_details
array of objects
List of the schedules where product must be available.
schedule_details.id
integer
Identifier of the product schedule.
schedule_details.days
string
Days of the schedule. Days of the week: "mon,tue,wed,thu,fri,sat,sun", Holidays: "hol".
schedule_details.starts_time
string
A specific time where the product begins to be available for users. 24 hour format HH:mm:ss
schedule_details.ends_time
string
A specific time where the product becomes unavailable for users. 24 hour format HH:mm:ss

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

Use this endpoint to create schedules for your products in the corridor and store.

Endpoint URL

Use this URL to make a request with this endpoint:

https://{COUNTRY_DOMAIN}api/rest-ops-utils/sku/schedule/{sku}/corridor/{corridorId}/integration/{integrationId}

  • {COUNTRY_DOMAIN}: Your Rappi Country Domain. See the list of Country Domains.
  • {integrationId}: This is the identifier of your store.
  • {corridorId}: This is the identifier of the corridor.
  • {sku}: This is the identifier of your product.

Endpoint Properties

This resource has the following properties:

Response formatsJSON
Request body requirementsJSON
Authentication requirementsToken

Parameters

This endpoint does not permit additional parameters.

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:

POST https://microservices.dev.rappi.com/api/rest-ops-utils/sku/schedule/987/corridor/123/integration/888

This is an example of the request:

{ "schedule_details": [ { "days": "mon,tue,wed,thu,fri,sat,sun", "starts_time": "08:00:00", "ends_time": "20:00:00" }, { "days": "hol", "starts_time": "13:00:00", "ends_time": "22:00:00" } ] }
URL url = new URL("https://microservices.dev.rappi.com/api/rest-ops-utils/sku/schedule/987/corridor/123/integration/888"); HttpURLConnection connection = (HttpURLConnection) url.openConnection(); connection.setRequestMethod("POST"); connection.setRequestProperty("User-Agent", "Mozilla/5.0"); connection.setRequestProperty("Content-Type", "application/json"); connection.setRequestProperty("Accept", "application/json"); connection.setRequestProperty("x-authorization", "Bearer YOUR_TOKEN"); connection.setDoOutput(true); String jsonInputString = "{\n" + " \"schedule_details\": [\n" + " {\n" + " \"days\": \"mon,tue,wed,thu,fri,sat,sun\",\n" + " \"starts_time\": \"08:00:00\",\n" + " \"ends_time\": \"20:00:00\"\n" + " },\n" + " {\n" + " \"days\": \"hol\",\n" + " \"starts_time\": \"13:00:00\",\n" + " \"ends_time\": \"22:00:00\"\n" + " }\n" + " ]\n" + "}"; try (OutputStream os = connection.getOutputStream()) { byte[] input = jsonInputString.getBytes(StandardCharsets.UTF_8); os.write(input, 0, input.length); } try (BufferedReader br = new BufferedReader(new InputStreamReader(connection.getInputStream(), StandardCharsets.UTF_8))) { StringBuilder response = new StringBuilder(); String responseLine; while ((responseLine = br.readLine()) != null) { response.append(responseLine.trim()); } System.out.println("Response body: " + response.toString()); } System.out.println("Response Code : " + connection.getResponseCode());



This table describes the attributes that the JSON of your request requires:

AttributesRequirementDescription
schedule_details
array of objects
requiredList of the schedules for the given product.
schedule_details.days
string
requiredDays of the schedule. Days of the week: "mon,tue,wed,thu,fri,sat,sun", Holidays: "hol".
schedule_details.starts_time
strings
requiredA specific time where the product begins to be available for users. 24 hour format HH:mm:ss
schedule_details.ends_time
strings
requiredA specific time where the product becomes unavailable for users. 24 hour format HH:mm:ss

Sample Response

This is an example of the response:

{ "sku": 987, "corridor_id": 123, "integration_id": "888", "schedule_details": [ { "id": 5, "days": "mon,tue,wed,thu,fri,sat,sun", "starts_time": "08:00:00", "ends_time": "20:00:00" }, { "id": 6, "days": "hol", "starts_time": "13:00:00", "ends_time": "22:00:00" } ] }

This table describes the objects contained in the response example:

Response ObjectObject Description
sku
integer
Identifier of your product.
corridor_id
integer
Identifier of the corridor.
integration_id
integer
Identifier of your store. (The parent store identifier in case of child store request)
schedule_details
array of objects
List of the schedules where product must be available.
schedule_details.id
integer
Identifier of the product schedule.
schedule_details.days
string
Days of the schedule. Days of the week: "mon,tue,wed,thu,fri,sat,sun", Holidays: "hol".
schedule_details.starts_time
string
A specific time where the product begins to be available for users. 24 hour format HH:mm:ss
schedule_details.ends_time
string
A specific time where the product becomes unavailable for users. 24 hour format HH:mm:ss

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

Use this endpoint to update schedules for your products in the corridor and store.

Endpoint URL

Use this URL to make a request with this endpoint:

https://{COUNTRY_DOMAIN}api/rest-ops-utils/sku/schedule/{sku}/corridor/{corridorId}/integration/{integrationId}

  • {COUNTRY_DOMAIN}: Your Rappi Country Domain. See the list of Country Domains.
  • {integrationId}: This is the identifier of your store.
  • {corridorId}: This is the identifier of the corridor.
  • {sku}: This is the identifier of your product.

Endpoint Properties

This resource has the following properties:

Response formatsJSON
Request body requirementsJSON
Authentication requirementsToken

Parameters

This endpoint does not permit additional parameters.

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:

PUT https://microservices.dev.rappi.com/api/rest-ops-utils/sku/schedule/987/corridor/123/integration/888

This is an example of the request:

{ "schedule_details": [ { "id": 5, "days": "mon,tue,wed,thu,fri,sat,sun", "starts_time": "10:00:00", "ends_time": "16:00:00" } ] }
URL url = new URL("https://microservices.dev.rappi.com/api/rest-ops-utils/sku/schedule/987/corridor/123/integration/888"); HttpURLConnection connection = (HttpURLConnection) url.openConnection(); connection.setRequestMethod("PUT"); connection.setRequestProperty("User-Agent", "Mozilla/5.0"); connection.setRequestProperty("Content-Type", "application/json"); connection.setRequestProperty("Accept", "application/json"); connection.setRequestProperty("x-authorization", "Bearer YOUR_TOKEN"); connection.setDoOutput(true); String jsonInputString = "{\n" + " \"schedule_details\": [\n" + " {\n" + " \"id\": 5,\n" + " \"days\": \"mon,tue,wed,thu,fri,sat,sun\",\n" + " \"starts_time\": \"10:00:00\",\n" + " \"ends_time\": \"16:00:00\"\n" + " }\n" + " ]\n" + "}"; try (OutputStream os = connection.getOutputStream()) { byte[] input = jsonInputString.getBytes(StandardCharsets.UTF_8); os.write(input, 0, input.length); } try (BufferedReader br = new BufferedReader(new InputStreamReader(connection.getInputStream(), StandardCharsets.UTF_8))) { StringBuilder response = new StringBuilder(); String responseLine; while ((responseLine = br.readLine()) != null) { response.append(responseLine.trim()); } System.out.println("Response body: " + response.toString()); } System.out.println("Response Code : " + connection.getResponseCode());



This table describes the attributes that the JSON of your request requires:

AttributesRequirementDescription
schedule_details
array of objects
requiredList of the schedules for the given product.
schedule_details.id
integer
requiredIdentifier of the product schedule.
schedule_details.days
string
requiredDays of the schedule. Days of the week: "mon,tue,wed,thu,fri,sat,sun", Holidays: "hol".
schedule_details.starts_time
strings
requiredA specific time where the product begins to be available for users. 24 hour format HH:mm:ss
schedule_details.ends_time
strings
requiredA specific time where the product becomes unavailable for users. 24 hour format HH:mm:ss

Sample Response

This is an example of the response:

{ "sku": 987, "corridor_id": 123, "integration_id": "888", "schedule_details": [ { "id": 5, "days": "mon,tue,wed,thu,fri,sat,sun", "starts_time": "10:00:00", "ends_time": "16:00:00" } ] }

This table describes the objects contained in the response example:

Response ObjectObject Description
sku
integer
Identifier of your product.
corridor_id
integer
Identifier of the corridor.
integration_id
integer
Identifier of your store. (The parent store identifier in case of child store request)
schedule_details
array of objects
List of the schedules where product must be available.
schedule_details.id
integer
Identifier of the product schedule.
schedule_details.days
string
Days of the schedule. Days of the week: "mon,tue,wed,thu,fri,sat,sun", Holidays: "hol".
schedule_details.starts_time
string
A specific time where the product begins to be available for users. 24 hour format HH:mm:ss
schedule_details.ends_time
string
A specific time where the product becomes unavailable for users. 24 hour format HH:mm:ss

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

Use this endpoint to delete product schedules configured for the corridor and store.

Endpoint URL

Use this URL to make a request with this endpoint:

https://{COUNTRY_DOMAIN}/api/rest-ops-utils/sku/schedule/{sku}/corridor/{corridorId}/integration/{integrationId}/{corridorProductScheduleId}

  • {COUNTRY_DOMAIN}: Your Rappi Country Domain. See the list of Country Domains.
  • {corridorProductScheduleId}: This is the identifier of the product schedule.
  • {integrationId}: This is the identifier of your store.
  • {corridorId}: This is the identifier of the corridor.
  • {sku}: This is the identifier of your product.

Endpoint Properties

This resource has the following properties:

Response formatsJSON
Authentication requirementsToken

Parameters

This endpoint does not permit additional parameters.

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:

DELETE https://microservices.dev.rappi.com/api/rest-ops-utils/sku/schedule/{sku}/corridor/{corridorId}/integration/{integrationId}/{corridorProductScheduleId}

This is an example of the request:

URL url = new URL("https://microservices.dev.rappi.com/api/rest-ops-utils/sku/schedule/987/corridor/123/integration/888/254"); HttpURLConnection connection = (HttpURLConnection) url.openConnection(); connection.setRequestMethod("DELETE"); 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:

{ "sku": 987, "corridor_id": 123, "integration_id": "888", "schedule_details": [ { "id": 4, "days": "mon,tue,wed,thu,fri,sat,sun,hol", "starts_time": "08:00:00", "ends_time": "23:00:00" } ] }

This table describes the objects contained in the response example:

Response ObjectObject Description
sku
integer
Identifier of your product.
corridor_id
integer
Identifier of the corridor.
integration_id
integer
Identifier of your store. (The parent store identifier in case of child store request)
schedule_details
array of objects
List of the schedules that are still available.
schedule_details.id
integer
Identifier of the product schedule.
schedule_details.days
string
Days of the schedule. Days of the week: "mon,tue,wed,thu,fri,sat,sun", Holidays: "hol".
schedule_details.starts_time
string
A specific time where the product begins to be available for users. 24 hour format HH:mm:ss
schedule_details.ends_time
string
A specific time where the product becomes unavailable for users. 24 hour format HH:mm:ss