@redotech/redo-api-schema 2.2.172 → 2.2.178

package/lib/openapi.d.ts

@@ -53,6 +53,20 @@ export interface paths {
       };
     };
   };
+  "/returns/{returnId}/process": {
+    /**
+     * Process return
+     * @description **BETA**: This endpoint is in beta and subject to change.
+     *
+     * Trigger processing of a return with specified products.
+     */
+    post: operations["Return process"];
+    parameters: {
+      path: {
+        returnId: components["parameters"]["return-id.param"];
+      };
+    };
+  };
   "/returns/{returnId}/status": {
     /**
      * Get return status
@@ -661,6 +675,11 @@ export interface components {
        * @description Return identifier.
        */
       id: string;
+      /**
+       * Internal Created By Name
+       * @description Name of the internal team member who created this return
+       */
+      internalCreatedByName?: string;
       /** @description Return items */
       items: {
           /** @description Customer's comment about the return */
@@ -1420,6 +1439,66 @@ export interface operations {
       };
     };
   };
+  /**
+   * Process return
+   * @description **BETA**: This endpoint is in beta and subject to change.
+   *
+   * Trigger processing of a return with specified products.
+   */
+  "Return process": {
+    parameters: {
+      path: {
+        returnId: components["parameters"]["return-id.param"];
+      };
+    };
+    requestBody: {
+      content: {
+        "application/json": {
+          /** @description Notes to send to customer. These can be rejection notes or processing notes. */
+          customerNotes?: string;
+          /** @description Whether to mark the return as reviewed before processing */
+          markAsReviewed?: boolean;
+          /** @description Array of products to process with their processing or rejection details */
+          products: ({
+              /**
+               * @description Product ID
+               * @example 64e4d5e837572a4813b73e41
+               */
+              _id: string;
+              processInput?: ({
+                /** @description Adjustment amount. This will be the amount that is credited to the customer. */
+                newMerchantAdjustment?: number | null;
+                /** @description Whether to restock the item */
+                restock?: boolean;
+              }) | null;
+            })[];
+        };
+      };
+    };
+    responses: {
+      /** @description Processing request completed */
+      200: {
+        content: {
+          "application/json": {
+            /** @description Status message */
+            message?: string;
+          };
+        };
+      };
+      /** @description Bad request (e.g., missing products array) */
+      400: {
+        content: {
+          "application/problem+json": components["schemas"]["error.schema"];
+        };
+      };
+      /** @description Error */
+      default: {
+        content: {
+          "application/problem+json": components["schemas"]["error.schema"];
+        };
+      };
+    };
+  };
   /**
    * Get return status
    * @description Get return status.

package/lib/openapi.yaml

@@ -657,6 +657,10 @@ components:
             - 64df65d4c5a4ca3eff4b4e43
           title: Identifier
           type: string
+        internalCreatedByName:
+          description: Name of the internal team member who created this return
+          title: Internal Created By Name
+          type: string
         items:
           description: Return items
           items:
@@ -1599,6 +1603,86 @@ paths:
       tags:
         - Returns
     summary: Return comment
+  /returns/{returnId}/process:
+    description: Process return.
+    parameters:
+      - $ref: '#/components/parameters/return-id.param'
+    post:
+      description: |
+        **BETA**: This endpoint is in beta and subject to change.
+
+        Trigger processing of a return with specified products.
+      operationId: Return process
+      requestBody:
+        content:
+          application/json:
+            schema:
+              properties:
+                customerNotes:
+                  description: Notes to send to customer. These can be rejection notes or processing notes.
+                  type: string
+                markAsReviewed:
+                  description: Whether to mark the return as reviewed before processing
+                  type: boolean
+                products:
+                  description: Array of products to process with their processing or rejection details
+                  items:
+                    properties:
+                      _id:
+                        description: Product ID
+                        example: 64e4d5e837572a4813b73e41
+                        type: string
+                      processInput:
+                        nullable: true
+                        properties:
+                          newMerchantAdjustment:
+                            description: Adjustment amount. This will be the amount that is credited to the customer.
+                            nullable: true
+                            type: number
+                          restock:
+                            description: Whether to restock the item
+                            type: boolean
+                        type: object
+                    required:
+                      - _id
+                    type: object
+                  type: array
+              required:
+                - products
+              type: object
+        required: true
+      responses:
+        '200':
+          content:
+            application/json:
+              schema:
+                properties:
+                  message:
+                    description: Status message
+                    examples:
+                      - Processing triggered successfully
+                      - Successfully prepared some products to be processed
+                    type: string
+                type: object
+          description: Processing request completed
+        '400':
+          content:
+            application/problem+json:
+              schema:
+                $ref: '#/components/schemas/error.schema'
+          description: Bad request (e.g., missing products array)
+        default:
+          content:
+            application/problem+json:
+              schema:
+                $ref: '#/components/schemas/error.schema'
+          description: Error
+      security:
+        - Bearer: []
+      summary: Process return
+      tags:
+        - Returns
+    summary: Process return
   /returns/{returnId}/status:
     description: Return status.
     get:

package/package.json

@@ -31,5 +31,5 @@
       ]
     }
   },
-  "version": "2.2.172"
+  "version": "2.2.178"
 }