Merge branch 'ml/BP-21748/v102' into 'main'

Release 1.0.2

Closes BP-21748

See merge request grab-transport/mex/store-ops/openapi-sdk/grabfood-api-sdk-go!7

Author: muhamad-lukman-grab

CHANGELOG.md

@@ -1,5 +1,16 @@
 # Changelog
 
+## [1.0.2] - 2025-03-04
+
+### Added
+- Get orders by orderIDs
+
+### Changed
+
+### Deprecated
+
+[1.0.2]: https://github.com/grab/grabfood-api-sdk-go/releases/tag/v1.0.2
+
 ## [1.0.1] - 2025-01-13
 
 ### Added

README.md

@@ -4,7 +4,7 @@
 This API client was generated by the [OpenAPI Generator](https://openapi-generator.tech) project.  By using the [OpenAPI-spec](https://www.openapis.org/) from a remote server, you can easily generate an API client.
 
 - API version: 1.1.3
-- Package version: 1.0.1
+- Package version: 1.0.2
 - Generator version: 7.8.0
 - Build package: org.openapitools.codegen.languages.GoClientCodegen
 

api/openapi.yaml

@@ -23,6 +23,12 @@ tags:
   x-displayName: Go
 - name: java
   x-displayName: Java
+- name: node.js
+  x-displayName: Node.js
+- name: python
+  x-displayName: Python
+- name: php
+  x-displayName: PHP
 - name: get-oauth-grab
   x-displayName: Get GrabFood access token
 - name: get-oauth-partner-webhook
@@ -937,21 +943,36 @@ paths:
       - explode: true
         in: query
         name: date
-        required: true
+        required: false
         schema:
           $ref: '#/components/schemas/date'
         style: form
-      - description: Specify the page number for the report.
+      - description: Specify the page number for the report. Required if orderIDs
+          is not provided.
         example: 1
         explode: true
         in: query
         name: page
-        required: true
+        required: false
         schema:
           type: integer
         style: form
+      - description: "List of order IDs. If provided, date and page are not required."
+        example:
+        - 123-CYNKLPCVRN5
+        - 456-PCVRN5CYNKL
+        explode: true
+        in: query
+        name: orderIDs
+        required: false
+        schema:
+          items:
+            type: string
+          maxItems: 10
+          type: array
+        style: form
       responses:
-        "2xx":
+        "200":
           content:
             application/json:
               schema:
@@ -962,11 +983,17 @@ paths:
       - list-orders
       x-codeSamples:
       - lang: cURL
-        label: CLI
+        label: CLI by date
         source: |
           curl -X GET \
           https://partner-api.grab.com/grabfood/partner/v1/orders?merchantID=1-C3VEJY6CMEEGUE&date=2020-01-20&page=0 \
           -H 'Authorization: Bearer <BEARER_TOKEN_HERE>'
+      - lang: cURL
+        label: CLI by orderIDs
+        source: |
+          curl -X GET \
+          https://partner-api.grab.com/grabfood/partner/v1/orders?merchantID=1-C3VEJY6CMEEGUE&orderIDs=123-CYNKLPCVRN5&orderIDs=456-PCVRN5CYNKL \
+          -H 'Authorization: Bearer <BEARER_TOKEN_HERE>'
   /partner/v1/orders/{orderID}:
     put:
       operationId: edit-order
@@ -3600,7 +3627,7 @@ components:
       title: AcceptOrderRequest
       type: object
     date:
-      description: The date of your report.
+      description: The date of your report. Required if orderIDs is not provided.
       example: 2020-01-20
       title: date
       type: string
@@ -5781,6 +5808,8 @@ components:
           - SGD
           - THB
           - VND
+          - KHR
+          - MMK
           example: SGD
           maxLength: 3
           type: string
@@ -5794,12 +5823,14 @@ components:
           - S$
           - ฿
           - ₫
+          - ៛
+          - K
           example: S$
           maxLength: 3
           type: string
         exponent:
           description: |
-            The log base 10 of the number of times we have to multiply the major unit to get the minor unit. Should be 0 for VN and 2 for other countries (SG/MY/ID/TH/PH/KH).
+            The log base 10 of the number of times we have to multiply the major unit to get the minor unit. Should be 0 for VN and 2 for other countries (`SG`/`MY`/`ID`/`TH`/`PH`/`KH`/`MM`).
           example: 2
           type: integer
       required:
@@ -7721,6 +7752,9 @@ x-tagGroups:
   - sdk-intro
   - go
   - java
+  - node.js
+  - python
+  - php
 - name: Authorisation
   tags:
   - get-oauth-grab

api_list_orders.go

@@ -6,7 +6,7 @@ Name | Type | Description | Notes
 ------------ | ------------- | ------------- | -------------
 **Code** | **string** | The three-letter ISO currency code. This is the currency that is associated with the payment amount.  | 
 **Symbol** | **string** | The currency symbol.  | 
-**Exponent** | **int32** | The log base 10 of the number of times we have to multiply the major unit to get the minor unit. Should be 0 for VN and 2 for other countries (SG/MY/ID/TH/PH/KH).  | 
+**Exponent** | **int32** | The log base 10 of the number of times we have to multiply the major unit to get the minor unit. Should be 0 for VN and 2 for other countries (`SG`/`MY`/`ID`/`TH`/`PH`/`KH`/`MM`).  | 
 
 ## Methods
 

configuration.go

@@ -10,7 +10,7 @@ Method | HTTP request | Description
 
 ## ListOrders
 
-> ListOrdersResponse ListOrders(ctx).Authorization(authorization).MerchantID(merchantID).Date(date).Page(page).Execute()
+> ListOrdersResponse ListOrders(ctx).Authorization(authorization).MerchantID(merchantID).Date(date).Page(page).OrderIDs(orderIDs).Execute()
 
 List orders
 
@@ -29,12 +29,13 @@ import (
 func main() {
 	authorization := "Bearer <ACCESS_TOKEN_HERE>" // string | Specify the generated authorization token of the bearer type.
 	merchantID := "1-CYNGRUNGSBCCC" // string | The merchant's ID that is in GrabFood's database.
-	date := "date_example" // string | 
-	page := int32(1) // int32 | Specify the page number for the report.
+	date := "date_example" // string |  (optional)
+	page := int32(1) // int32 | Specify the page number for the report. Required if orderIDs is not provided. (optional)
+	orderIDs := []string{"Inner_example"} // []string | List of order IDs. If provided, date and page are not required. (optional)
 
 	configuration := grabfood.NewConfiguration()
 	apiClient := grabfood.NewAPIClient(configuration)
-	resp, r, err := apiClient.ListOrdersAPI.ListOrders(context.Background()).Authorization(authorization).MerchantID(merchantID).Date(date).Page(page).Execute()
+	resp, r, err := apiClient.ListOrdersAPI.ListOrders(context.Background()).Authorization(authorization).MerchantID(merchantID).Date(date).Page(page).OrderIDs(orderIDs).Execute()
 	if err != nil {
 		fmt.Fprintf(os.Stderr, "Error when calling `ListOrdersAPI.ListOrders``: %v\n", err)
 		fmt.Fprintf(os.Stderr, "Full HTTP response: %v\n", r)
@@ -58,7 +59,8 @@ Name | Type | Description  | Notes
  **authorization** | **string** | Specify the generated authorization token of the bearer type. | 
  **merchantID** | **string** | The merchant&#39;s ID that is in GrabFood&#39;s database. | 
  **date** | **string** |  | 
- **page** | **int32** | Specify the page number for the report. | 
+ **page** | **int32** | Specify the page number for the report. Required if orderIDs is not provided. | 
+ **orderIDs** | **[]string** | List of order IDs. If provided, date and page are not required. | 
 
 ### Return type