@redotech/redo-api-schema 2.2.432 → 2.2.447

package/lib/openapi.d.ts

@@ -810,10 +810,10 @@ export interface components {
       /**
        * Created at
        * Format: date-time
-       * @description Timestamp when the customer was created.
+       * @description Timestamp when the customer was created. May be null for older customers created before this field was tracked.
        */
-      createdAt: string;
-      /** @description Custom field values as key-value pairs, where keys are field names and values can be strings, numbers, or booleans. */
+      createdAt?: string | null;
+      /** @description Custom field values as key-value pairs, where keys are field names and values can be strings, numbers, or booleans. DATE custom field values are returned as ISO 8601 datetime strings (e.g., "2026-01-15T12:00:00.000Z"), not Date objects. */
       customFields?: {
         [key: string]: string | number | boolean;
       };
@@ -834,9 +834,9 @@ export interface components {
       /**
        * Updated at
        * Format: date-time
-       * @description Timestamp when the customer was last updated.
+       * @description Timestamp when the customer was last updated. May be null for older customers created before this field was tracked.
        */
-      updatedAt: string;
+      updatedAt?: string | null;
     };
     /** @description Email subscription updates */
     "customer-subscription-email.schema": {
@@ -884,12 +884,19 @@ export interface components {
      */
     "customer-upsert-request.schema": {
       /**
-       * @description Custom field values as key-value pairs. Keys are field names and values can be strings, numbers, or booleans. New fields are created automatically if they don't exist yet.
+       * @description Custom field values as key-value pairs. Keys are field names and values can be strings, numbers, or booleans. The field type is determined automatically based on the value:
+       * - String values → STRING custom field
+       * - Number values → NUMBER custom field
+       * - Boolean values → BOOLEAN custom field
+       * - ISO 8601 datetime strings (e.g., "2026-02-24T12:15:00.000Z") → DATE custom field (auto-detected)
+       *
+       * If a field name does not already have a declaration, one is created automatically. For STRING fields, unique values are tracked as options (used for segment filtering dropdowns). NUMBER, BOOLEAN, and DATE fields do not track options.
        * @example {
        *   "subscription_source": "web",
        *   "status": "Active",
        *   "loyalty_points": 1250,
-       *   "vip_member": true
+       *   "vip_member": true,
+       *   "signup_date": "2026-02-24T12:15:00.000Z"
        * }
        */
       customFields?: {
@@ -1171,6 +1178,32 @@ export interface components {
        */
       name: string;
     };
+    /**
+     * Return Dropoff
+     * @description Dropoff entry for returns using QR-code-based drop-off methods (e.g. BlueYonder/FedEx Easy Returns)
+     */
+    "return-dropoff.schema": {
+      /**
+       * Provider
+       * @description Dropoff provider name (e.g. "FedEx Easy Returns", "Virtual")
+       */
+      provider: string;
+      /**
+       * QR Code
+       * @description Raw QR code data
+       */
+      qrCode?: string;
+      /**
+       * QR Code URL
+       * @description URL to a rendered QR code image
+       */
+      qrCodeUrl?: string;
+      /**
+       * Shipment Group ID
+       * @description ID of the shipment group this dropoff belongs to
+       */
+      shipmentGroupId: string;
+    };
     /**
      * Return
      * @description Return read.
@@ -1204,6 +1237,11 @@ export interface components {
          */
         phoneNumber?: components["schemas"]["phone-number.schema"];
       };
+      /**
+       * Dropoffs
+       * @description Array of QR-code-based dropoff entries for returns using drop-off methods such as BlueYonder/FedEx Easy Returns. Empty for standard label-based returns.
+       */
+      dropoffs?: components["schemas"]["return-dropoff.schema"][];
       /**
        * Exchange
        * @description Exchange order

package/lib/openapi.yaml

@@ -1943,7 +1943,7 @@ components:
         location:
           $ref: '#/components/schemas/customer-location.schema'
         customFields:
-          description: Custom field values as key-value pairs, where keys are field names and values can be strings, numbers, or booleans.
+          description: Custom field values as key-value pairs, where keys are field names and values can be strings, numbers, or booleans. DATE custom field values are returned as ISO 8601 datetime strings (e.g., "2026-01-15T12:00:00.000Z"), not Date objects.
           type: object
           additionalProperties:
             oneOf:
@@ -1955,25 +1955,28 @@ components:
               status: Active
               loyalty_points: 1250
               vip_member: true
+              signup_date: '2026-02-24T12:15:00.000Z'
         createdAt:
-          description: Timestamp when the customer was created.
+          description: Timestamp when the customer was created. May be null for older customers created before this field was tracked.
           format: date-time
           title: Created at
           examples:
             - '2026-02-20T18:30:00.000Z'
-          type: string
+          type:
+            - string
+            - 'null'
         updatedAt:
-          description: Timestamp when the customer was last updated.
+          description: Timestamp when the customer was last updated. May be null for older customers created before this field was tracked.
           format: date-time
           title: Updated at
           examples:
             - '2026-02-24T12:15:00.000Z'
-          type: string
+          type:
+            - string
+            - 'null'
       required:
         - id
         - email
-        - createdAt
-        - updatedAt
       title: Customer
       type: object
     customer-upsert-request.schema:
@@ -1998,7 +2001,14 @@ components:
         location:
           $ref: '#/components/schemas/customer-location.schema'
         customFields:
-          description: Custom field values as key-value pairs. Keys are field names and values can be strings, numbers, or booleans. New fields are created automatically if they don't exist yet.
+          description: |-
+            Custom field values as key-value pairs. Keys are field names and values can be strings, numbers, or booleans. The field type is determined automatically based on the value:
+            - String values → STRING custom field
+            - Number values → NUMBER custom field
+            - Boolean values → BOOLEAN custom field
+            - ISO 8601 datetime strings (e.g., "2026-02-24T12:15:00.000Z") → DATE custom field (auto-detected)
+
+            If a field name does not already have a declaration, one is created automatically. For STRING fields, unique values are tracked as options (used for segment filtering dropdowns). NUMBER, BOOLEAN, and DATE fields do not track options.
           type: object
           additionalProperties:
             oneOf:
@@ -2010,6 +2020,7 @@ components:
             status: Active
             loyalty_points: 1250
             vip_member: true
+            signup_date: '2026-02-24T12:15:00.000Z'
       required:
         - email
       title: Customer Upsert Request
@@ -2680,6 +2691,30 @@ components:
           type: string
       title: Return Shipment
       type: object
+    return-dropoff.schema:
+      description: Dropoff entry for returns using QR-code-based drop-off methods (e.g. BlueYonder/FedEx Easy Returns)
+      properties:
+        shipmentGroupId:
+          description: ID of the shipment group this dropoff belongs to
+          title: Shipment Group ID
+          type: string
+        provider:
+          description: Dropoff provider name (e.g. "FedEx Easy Returns", "Virtual")
+          title: Provider
+          type: string
+        qrCode:
+          description: Raw QR code data
+          title: QR Code
+          type: string
+        qrCodeUrl:
+          description: URL to a rendered QR code image
+          title: QR Code URL
+          type: string
+      required:
+        - shipmentGroupId
+        - provider
+      title: Return Dropoff
+      type: object
     return-status.schema:
       description: |
         Return status.
@@ -3157,6 +3192,12 @@ components:
             $ref: '#/components/schemas/return-shipment.schema'
           title: Shipments
           type: array
+        dropoffs:
+          description: Array of QR-code-based dropoff entries for returns using drop-off methods such as BlueYonder/FedEx Easy Returns. Empty for standard label-based returns.
+          items:
+            $ref: '#/components/schemas/return-dropoff.schema'
+          title: Dropoffs
+          type: array
         shopifyOrderIds:
           description: Array of Shopify order IDs (deprecated, use externalOrderIds)
           items:

package/package.json

@@ -31,5 +31,5 @@
       ]
     }
   },
-  "version": "2.2.432"
+  "version": "2.2.447"
 }