@teemill/orders 1.29.0 → 1.29.3

package/dist/base.js

@@ -5,7 +5,7 @@
  * Orders
  * Use this API to create and retrieve updates for print-on-demand orders. Use it to request fulfillment for variants of products attached to the given project. You can fetch details and references to these products and variants from the Product Catalog API.
  *
- * The version of the OpenAPI document: 1.29.0
+ * The version of the OpenAPI document: 1.29.3
  *
  *
  * NOTE: This class is auto generated by OpenAPI Generator (https://openapi-generator.tech).

package/dist/common.d.ts

@@ -2,7 +2,7 @@
  * Orders
  * Use this API to create and retrieve updates for print-on-demand orders. Use it to request fulfillment for variants of products attached to the given project. You can fetch details and references to these products and variants from the Product Catalog API.
  *
- * The version of the OpenAPI document: 1.29.0
+ * The version of the OpenAPI document: 1.29.3
  *
  *
  * NOTE: This class is auto generated by OpenAPI Generator (https://openapi-generator.tech).

package/dist/common.js

@@ -5,7 +5,7 @@
  * Orders
  * Use this API to create and retrieve updates for print-on-demand orders. Use it to request fulfillment for variants of products attached to the given project. You can fetch details and references to these products and variants from the Product Catalog API.
  *
- * The version of the OpenAPI document: 1.29.0
+ * The version of the OpenAPI document: 1.29.3
  *
  *
  * NOTE: This class is auto generated by OpenAPI Generator (https://openapi-generator.tech).

package/dist/configuration.d.ts

@@ -2,7 +2,7 @@
  * Orders
  * Use this API to create and retrieve updates for print-on-demand orders. Use it to request fulfillment for variants of products attached to the given project. You can fetch details and references to these products and variants from the Product Catalog API.
  *
- * The version of the OpenAPI document: 1.29.0
+ * The version of the OpenAPI document: 1.29.3
  *
  *
  * NOTE: This class is auto generated by OpenAPI Generator (https://openapi-generator.tech).

package/dist/configuration.js

@@ -4,7 +4,7 @@
  * Orders
  * Use this API to create and retrieve updates for print-on-demand orders. Use it to request fulfillment for variants of products attached to the given project. You can fetch details and references to these products and variants from the Product Catalog API.
  *
- * The version of the OpenAPI document: 1.29.0
+ * The version of the OpenAPI document: 1.29.3
  *
  *
  * NOTE: This class is auto generated by OpenAPI Generator (https://openapi-generator.tech).

package/dist/esm/api.d.ts

@@ -2,7 +2,7 @@
  * Orders
  * Use this API to create and retrieve updates for print-on-demand orders. Use it to request fulfillment for variants of products attached to the given project. You can fetch details and references to these products and variants from the Product Catalog API.
  *
- * The version of the OpenAPI document: 1.29.0
+ * The version of the OpenAPI document: 1.29.3
  *
  *
  * NOTE: This class is auto generated by OpenAPI Generator (https://openapi-generator.tech).
@@ -140,12 +140,15 @@ export interface ContactInformation1 {
  */
 export interface Coupon {
     /**
-     * Unique object identifier
+     * The unique identifier of the coupon.
      */
     'id': string;
+    /**
+     * The discount code entered by the customer.
+     */
     'code': string;
     /**
-     * Reference to the discount. **Note:** Requires the discounts integration to see the reference.
+     * A URI reference to the discount resource. Requires the discounts integration.
      */
     'ref'?: string | null;
 }
@@ -321,10 +324,22 @@ export interface Fulfillment {
      */
     'frozen'?: boolean;
     /**
-     * List of reason codes why this fulfillment is frozen.
+     * List of reason codes why this fulfillment is frozen. - `moderation` - Held for content moderation review. - `internal_screen_print` - Awaiting internal screen print processing. - `manual` - Manually frozen by a user. - `client_credit_control` - The client is under credit control. - `factory_credit_control` - The factory fulfilling the order is under credit control. - `billing_failed` - Payment for this order failed. - `pickface_flagged` - Flagged on the pickface for review. - `flow_frozen` - Frozen by internal production flow handling. - `fraud` - Frozen due to fraud checks.
      */
-    'frozenReasons'?: Array<string>;
+    'frozenReasons'?: Array<FulfillmentFrozenReasonsEnum>;
 }
+export declare const FulfillmentFrozenReasonsEnum: {
+    readonly Moderation: "moderation";
+    readonly InternalScreenPrint: "internal_screen_print";
+    readonly Manual: "manual";
+    readonly ClientCreditControl: "client_credit_control";
+    readonly FactoryCreditControl: "factory_credit_control";
+    readonly BillingFailed: "billing_failed";
+    readonly PickfaceFlagged: "pickface_flagged";
+    readonly FlowFrozen: "flow_frozen";
+    readonly Fraud: "fraud";
+};
+export type FulfillmentFrozenReasonsEnum = typeof FulfillmentFrozenReasonsEnum[keyof typeof FulfillmentFrozenReasonsEnum];
 export interface FulfillmentItem {
     /**
      * Unique identifier for this fulfillment item.
@@ -362,7 +377,7 @@ export interface Image {
 }
 export interface ImportOrders202Response {
     /**
-     * Unique object identifier
+     * Unique identifier of the created import. Use this with the GET /v1/orders/imports/{importId} endpoint to track progress.
      */
     'importId'?: string;
 }
@@ -381,11 +396,11 @@ export interface Option {
  */
 export interface Order {
     /**
-     * Unique object identifier
+     * The unique identifier of the order.
      */
     'id'?: string;
     /**
-     * A reference to the resource location
+     * A URI reference to this order resource.
      */
     'ref'?: string;
     /**
@@ -457,21 +472,39 @@ export interface Order {
      */
     'paymentAttempts'?: Array<PaymentAttempt>;
 }
+/**
+ * Represents a bulk order import job, tracking the progress and outcome of importing orders from a CSV file.
+ */
 export interface OrderImport {
     /**
-     * Unique object identifier
+     * The unique identifier of this import job.
      */
     'importId': string;
+    /**
+     * The current lifecycle status of this import.
+     */
     'status': OrderImportStatus;
     'counts': OrderImportCounts;
     /**
-     * ISO 8601 Timestamp
+     * The timestamp when the import was created.
      */
     'createdAt': string;
+    /**
+     * The timestamp when the import was cancelled. Null if the import has not been cancelled.
+     */
     'cancelledAt'?: string | null;
+    /**
+     * The timestamp when the import started processing. Null if processing has not yet begun.
+     */
     'startedAt'?: string | null;
+    /**
+     * The timestamp when the import finished processing. Null if processing has not yet completed.
+     */
     'finishedAt'?: string | null;
 }
+/**
+ * Counts of import groups in each processing state.
+ */
 export interface OrderImportCounts {
     'total': number;
     'pending': number;
@@ -481,7 +514,13 @@ export interface OrderImportCounts {
     'cancelled': number;
     'completed': number;
 }
+/**
+ * An error encountered while processing an import group, including a machine-readable code and human-readable message.
+ */
 export interface OrderImportError {
+    /**
+     * A machine-readable error code identifying the type of import failure.
+     */
     'code': OrderImportErrorCode;
     /**
      * A human-readable description of the error.
@@ -515,11 +554,17 @@ export declare const OrderImportErrorCode: {
     readonly ImportFailed: "IMPORT_FAILED";
 };
 export type OrderImportErrorCode = typeof OrderImportErrorCode[keyof typeof OrderImportErrorCode];
+/**
+ * A single group (order) within a bulk import, representing one merchant reference and its processing outcome.
+ */
 export interface OrderImportGroup {
     /**
-     * Unique object identifier
+     * Unique identifier for this import group.
      */
     'id': string;
+    /**
+     * The current lifecycle status of this import group.
+     */
     'status': OrderImportGroupStatus;
     /**
      * The merchant reference from the CSV rows belonging to this group.
@@ -545,8 +590,17 @@ export interface OrderImportGroup {
      * Errors encountered while processing this group. Empty when the group succeeded.
      */
     'errors': Array<OrderImportError>;
+    /**
+     * The timestamp when this group was created. Null if not yet set.
+     */
     'createdAt'?: string | null;
+    /**
+     * The timestamp when this group started processing. Null if processing has not yet begun.
+     */
     'startedAt'?: string | null;
+    /**
+     * The timestamp when this group finished processing. Null if processing has not yet completed.
+     */
     'finishedAt'?: string | null;
 }
 /**
@@ -589,11 +643,11 @@ export interface OrderItem {
      */
     'id'?: string;
     /**
-     * A reference to the variant being ordered
+     * A reference to the product variant being ordered.
      */
     'variantRef': string;
     /**
-     * Options associated to an order item\'s variant, such as color and size.
+     * The variant attributes (e.g. Colour, Size) for this line item.
      */
     'options'?: Array<Option>;
     /**
@@ -727,6 +781,9 @@ export interface Price {
  * The item cannot be fulfilled at all — either it is out of stock entirely, or the assigned fulfiller cannot produce it (e.g. missing machinery or variant not configured).
  */
 export interface ProductUnavailableError {
+    /**
+     * The error code identifying this as a product unavailable error.
+     */
     'code': ProductUnavailableErrorCodeEnum;
     /**
      * Human-readable description including the product name.
@@ -737,11 +794,11 @@ export interface ProductUnavailableError {
      */
     'productTitle': string;
     /**
-     * Unique object identifier
+     * The unique identifier of the unavailable variant.
      */
     'variantId': string;
     /**
-     * A reference to the variant being ordered
+     * A URI reference to the unavailable variant.
      */
     'variantRef': string;
     /**
@@ -843,6 +900,7 @@ export interface StatusHistoryItem {
 }
 /**
  * @type StockConflictError
+ * An error indicating that one or more items in the order cannot be fulfilled due to stock or product availability issues. Use the \'code\' field to determine the specific error type.
  */
 export type StockConflictError = {
     code: 'PRODUCT_UNAVAILABLE';
@@ -853,6 +911,9 @@ export type StockConflictError = {
  * The requested quantity exceeds available stock. The item can still be ordered in a smaller quantity.
  */
 export interface StockUnavailableError {
+    /**
+     * The error code identifying this as a stock unavailable error.
+     */
     'code': StockUnavailableErrorCodeEnum;
     /**
      * Human-readable description including the product name and available quantity.
@@ -863,11 +924,11 @@ export interface StockUnavailableError {
      */
     'productTitle': string;
     /**
-     * Unique object identifier
+     * The unique identifier of the variant with insufficient stock.
      */
     'variantId': string;
     /**
-     * A reference to the variant being ordered
+     * A URI reference to the variant with insufficient stock.
      */
     'variantRef': string;
     /**
@@ -1011,7 +1072,7 @@ export declare const OrdersApiAxiosParamCreator: (configuration?: Configuration)
     listOrderImports: (project: string, pageToken?: number, pageSize?: number, options?: RawAxiosRequestConfig) => Promise<RequestArgs>;
     /**
      * Retries failed platform payment, so fulfillment can proceed.
-     * @summary Retry
+     * @summary Retry platform payment
      * @param {string} project The project identifier to scope the request to.
      * @param {string} orderId Unique identifier of an order
      * @param {string} [fields] Specifies which fields to return, separated by commas
@@ -1144,7 +1205,7 @@ export declare const OrdersApiFp: (configuration?: Configuration) => {
     listOrderImports(project: string, pageToken?: number, pageSize?: number, options?: RawAxiosRequestConfig): Promise<(axios?: AxiosInstance, basePath?: string) => AxiosPromise<OrderImportsResponse>>;
     /**
      * Retries failed platform payment, so fulfillment can proceed.
-     * @summary Retry
+     * @summary Retry platform payment
      * @param {string} project The project identifier to scope the request to.
      * @param {string} orderId Unique identifier of an order
      * @param {string} [fields] Specifies which fields to return, separated by commas
@@ -1247,7 +1308,7 @@ export declare const OrdersApiFactory: (configuration?: Configuration, basePath?
     listOrderImports(requestParameters: OrdersApiListOrderImportsRequest, options?: RawAxiosRequestConfig): AxiosPromise<OrderImportsResponse>;
     /**
      * Retries failed platform payment, so fulfillment can proceed.
-     * @summary Retry
+     * @summary Retry platform payment
      * @param {OrdersApiRetryPlatformPaymentRequest} requestParameters Request parameters.
      * @param {*} [options] Override http request option.
      * @throws {RequiredError}
@@ -1584,7 +1645,7 @@ export declare class OrdersApi extends BaseAPI {
     listOrderImports(requestParameters: OrdersApiListOrderImportsRequest, options?: RawAxiosRequestConfig): Promise<import("axios").AxiosResponse<OrderImportsResponse, any, {}>>;
     /**
      * Retries failed platform payment, so fulfillment can proceed.
-     * @summary Retry
+     * @summary Retry platform payment
      * @param {OrdersApiRetryPlatformPaymentRequest} requestParameters Request parameters.
      * @param {*} [options] Override http request option.
      * @throws {RequiredError}

package/dist/esm/api.js

@@ -4,7 +4,7 @@
  * Orders
  * Use this API to create and retrieve updates for print-on-demand orders. Use it to request fulfillment for variants of products attached to the given project. You can fetch details and references to these products and variants from the Product Catalog API.
  *
- * The version of the OpenAPI document: 1.29.0
+ * The version of the OpenAPI document: 1.29.3
  *
  *
  * NOTE: This class is auto generated by OpenAPI Generator (https://openapi-generator.tech).
@@ -35,6 +35,17 @@ export const ConfirmOrderValidationErrorCodeEnum = {
 export const CustomsInformationPreRegistrationTypeEnum = {
     Ioss: 'IOSS',
 };
+export const FulfillmentFrozenReasonsEnum = {
+    Moderation: 'moderation',
+    InternalScreenPrint: 'internal_screen_print',
+    Manual: 'manual',
+    ClientCreditControl: 'client_credit_control',
+    FactoryCreditControl: 'factory_credit_control',
+    BillingFailed: 'billing_failed',
+    PickfaceFlagged: 'pickface_flagged',
+    FlowFrozen: 'flow_frozen',
+    Fraud: 'fraud',
+};
 /**
  * Machine-readable error code identifying the type of import failure: - `VARIANT_NOT_FOUND` — The SKU does not match any variant in the project\'s catalog - `MISSING_SKU` — A required SKU field was empty or missing - `SHIPPING_METHOD_UNAVAILABLE` — No shipping methods are available for the fulfillment - `TRANSIENT_SYSTEM_ERROR` — A temporary system issue occurred; the import may succeed on retry - `IMPORT_FAILED` — A general import failure that does not match a more specific code
  */
@@ -649,7 +660,7 @@ export const OrdersApiAxiosParamCreator = function (configuration) {
         }),
         /**
          * Retries failed platform payment, so fulfillment can proceed.
-         * @summary Retry
+         * @summary Retry platform payment
          * @param {string} project The project identifier to scope the request to.
          * @param {string} orderId Unique identifier of an order
          * @param {string} [fields] Specifies which fields to return, separated by commas
@@ -908,7 +919,7 @@ export const OrdersApiFp = function (configuration) {
         },
         /**
          * Retries failed platform payment, so fulfillment can proceed.
-         * @summary Retry
+         * @summary Retry platform payment
          * @param {string} project The project identifier to scope the request to.
          * @param {string} orderId Unique identifier of an order
          * @param {string} [fields] Specifies which fields to return, separated by commas
@@ -1044,7 +1055,7 @@ export const OrdersApiFactory = function (configuration, basePath, axios) {
         },
         /**
          * Retries failed platform payment, so fulfillment can proceed.
-         * @summary Retry
+         * @summary Retry platform payment
          * @param {OrdersApiRetryPlatformPaymentRequest} requestParameters Request parameters.
          * @param {*} [options] Override http request option.
          * @throws {RequiredError}
@@ -1170,7 +1181,7 @@ export class OrdersApi extends BaseAPI {
     }
     /**
      * Retries failed platform payment, so fulfillment can proceed.
-     * @summary Retry
+     * @summary Retry platform payment
      * @param {OrdersApiRetryPlatformPaymentRequest} requestParameters Request parameters.
      * @param {*} [options] Override http request option.
      * @throws {RequiredError}

package/dist/esm/base.d.ts

@@ -2,7 +2,7 @@
  * Orders
  * Use this API to create and retrieve updates for print-on-demand orders. Use it to request fulfillment for variants of products attached to the given project. You can fetch details and references to these products and variants from the Product Catalog API.
  *
- * The version of the OpenAPI document: 1.29.0
+ * The version of the OpenAPI document: 1.29.3
  *
  *
  * NOTE: This class is auto generated by OpenAPI Generator (https://openapi-generator.tech).

package/dist/esm/base.js

@@ -4,7 +4,7 @@
  * Orders
  * Use this API to create and retrieve updates for print-on-demand orders. Use it to request fulfillment for variants of products attached to the given project. You can fetch details and references to these products and variants from the Product Catalog API.
  *
- * The version of the OpenAPI document: 1.29.0
+ * The version of the OpenAPI document: 1.29.3
  *
  *
  * NOTE: This class is auto generated by OpenAPI Generator (https://openapi-generator.tech).

package/dist/esm/common.d.ts

@@ -2,7 +2,7 @@
  * Orders
  * Use this API to create and retrieve updates for print-on-demand orders. Use it to request fulfillment for variants of products attached to the given project. You can fetch details and references to these products and variants from the Product Catalog API.
  *
- * The version of the OpenAPI document: 1.29.0
+ * The version of the OpenAPI document: 1.29.3
  *
  *
  * NOTE: This class is auto generated by OpenAPI Generator (https://openapi-generator.tech).

package/dist/esm/common.js

@@ -4,7 +4,7 @@
  * Orders
  * Use this API to create and retrieve updates for print-on-demand orders. Use it to request fulfillment for variants of products attached to the given project. You can fetch details and references to these products and variants from the Product Catalog API.
  *
- * The version of the OpenAPI document: 1.29.0
+ * The version of the OpenAPI document: 1.29.3
  *
  *
  * NOTE: This class is auto generated by OpenAPI Generator (https://openapi-generator.tech).

package/dist/esm/configuration.d.ts

@@ -2,7 +2,7 @@
  * Orders
  * Use this API to create and retrieve updates for print-on-demand orders. Use it to request fulfillment for variants of products attached to the given project. You can fetch details and references to these products and variants from the Product Catalog API.
  *
- * The version of the OpenAPI document: 1.29.0
+ * The version of the OpenAPI document: 1.29.3
  *
  *
  * NOTE: This class is auto generated by OpenAPI Generator (https://openapi-generator.tech).

package/dist/esm/configuration.js

@@ -3,7 +3,7 @@
  * Orders
  * Use this API to create and retrieve updates for print-on-demand orders. Use it to request fulfillment for variants of products attached to the given project. You can fetch details and references to these products and variants from the Product Catalog API.
  *
- * The version of the OpenAPI document: 1.29.0
+ * The version of the OpenAPI document: 1.29.3
  *
  *
  * NOTE: This class is auto generated by OpenAPI Generator (https://openapi-generator.tech).

package/dist/esm/index.d.ts

@@ -2,7 +2,7 @@
  * Orders
  * Use this API to create and retrieve updates for print-on-demand orders. Use it to request fulfillment for variants of products attached to the given project. You can fetch details and references to these products and variants from the Product Catalog API.
  *
- * The version of the OpenAPI document: 1.29.0
+ * The version of the OpenAPI document: 1.29.3
  *
  *
  * NOTE: This class is auto generated by OpenAPI Generator (https://openapi-generator.tech).

package/dist/esm/index.js

@@ -4,7 +4,7 @@
  * Orders
  * Use this API to create and retrieve updates for print-on-demand orders. Use it to request fulfillment for variants of products attached to the given project. You can fetch details and references to these products and variants from the Product Catalog API.
  *
- * The version of the OpenAPI document: 1.29.0
+ * The version of the OpenAPI document: 1.29.3
  *
  *
  * NOTE: This class is auto generated by OpenAPI Generator (https://openapi-generator.tech).

package/dist/index.d.ts

@@ -2,7 +2,7 @@
  * Orders
  * Use this API to create and retrieve updates for print-on-demand orders. Use it to request fulfillment for variants of products attached to the given project. You can fetch details and references to these products and variants from the Product Catalog API.
  *
- * The version of the OpenAPI document: 1.29.0
+ * The version of the OpenAPI document: 1.29.3
  *
  *
  * NOTE: This class is auto generated by OpenAPI Generator (https://openapi-generator.tech).

package/dist/index.js

@@ -5,7 +5,7 @@
  * Orders
  * Use this API to create and retrieve updates for print-on-demand orders. Use it to request fulfillment for variants of products attached to the given project. You can fetch details and references to these products and variants from the Product Catalog API.
  *
- * The version of the OpenAPI document: 1.29.0
+ * The version of the OpenAPI document: 1.29.3
  *
  *
  * NOTE: This class is auto generated by OpenAPI Generator (https://openapi-generator.tech).

package/docs/Coupon.md

@@ -6,9 +6,9 @@ Coupon applied to the order.
 
 Name | Type | Description | Notes
 ------------ | ------------- | ------------- | -------------
-**id** | **string** | Unique object identifier | [default to undefined]
-**code** | **string** |  | [default to undefined]
-**ref** | **string** | Reference to the discount. **Note:** Requires the discounts integration to see the reference. | [optional] [default to undefined]
+**id** | **string** | The unique identifier of the coupon. | [default to undefined]
+**code** | **string** | The discount code entered by the customer. | [default to undefined]
+**ref** | **string** | A URI reference to the discount resource. Requires the discounts integration. | [optional] [default to undefined]
 
 ## Example
 

package/docs/Fulfillment.md

@@ -16,7 +16,7 @@ Name | Type | Description | Notes
 **packageWeight** | **number** | The estimated weight of the package in grams. | [optional] [default to undefined]
 **platformRef** | **string** | Reference to the source platform of this fulfillment. | [optional] [default to undefined]
 **frozen** | **boolean** | Whether the fulfillment is frozen. This will prevent the fulfillment from being picked. | [optional] [readonly] [default to undefined]
-**frozenReasons** | **Array<string>** | List of reason codes why this fulfillment is frozen. | [optional] [readonly] [default to undefined]
+**frozenReasons** | **Array<string>** | List of reason codes why this fulfillment is frozen. - `moderation` - Held for content moderation review. - `internal_screen_print` - Awaiting internal screen print processing. - `manual` - Manually frozen by a user. - `client_credit_control` - The client is under credit control. - `factory_credit_control` - The factory fulfilling the order is under credit control. - `billing_failed` - Payment for this order failed. - `pickface_flagged` - Flagged on the pickface for review. - `flow_frozen` - Frozen by internal production flow handling. - `fraud` - Frozen due to fraud checks.  | [optional] [readonly] [default to undefined]
 
 ## Example
 

package/docs/ImportOrders202Response.md

@@ -5,7 +5,7 @@
 
 Name | Type | Description | Notes
 ------------ | ------------- | ------------- | -------------
-**importId** | **string** | Unique object identifier | [optional] [default to undefined]
+**importId** | **string** | Unique identifier of the created import. Use this with the GET /v1/orders/imports/{importId} endpoint to track progress. | [optional] [default to undefined]
 
 ## Example
 

package/docs/Order.md

@@ -6,8 +6,8 @@ Represents a print-on-demand order placed on a project. An order contains items,
 
 Name | Type | Description | Notes
 ------------ | ------------- | ------------- | -------------
-**id** | **string** | Unique object identifier | [optional] [default to undefined]
-**ref** | **string** | A reference to the resource location | [optional] [default to undefined]
+**id** | **string** | The unique identifier of the order. | [optional] [default to undefined]
+**ref** | **string** | A URI reference to this order resource. | [optional] [default to undefined]
 **status** | [**Status**](Status.md) | The current status of the order. | [optional] [default to undefined]
 **contactInformation** | [**ContactInformation**](ContactInformation.md) |  | [default to undefined]
 **paymentMethod** | [**OrderPaymentMethod**](OrderPaymentMethod.md) |  | [optional] [default to undefined]

package/docs/OrderImport.md

@@ -1,17 +1,18 @@
 # OrderImport
 
+Represents a bulk order import job, tracking the progress and outcome of importing orders from a CSV file.
 
 ## Properties
 
 Name | Type | Description | Notes
 ------------ | ------------- | ------------- | -------------
-**importId** | **string** | Unique object identifier | [default to undefined]
-**status** | [**OrderImportStatus**](OrderImportStatus.md) |  | [default to undefined]
+**importId** | **string** | The unique identifier of this import job. | [default to undefined]
+**status** | [**OrderImportStatus**](OrderImportStatus.md) | The current lifecycle status of this import. | [default to undefined]
 **counts** | [**OrderImportCounts**](OrderImportCounts.md) |  | [default to undefined]
-**createdAt** | **string** | ISO 8601 Timestamp | [default to undefined]
-**cancelledAt** | **string** |  | [optional] [default to undefined]
-**startedAt** | **string** |  | [optional] [default to undefined]
-**finishedAt** | **string** |  | [optional] [default to undefined]
+**createdAt** | **string** | The timestamp when the import was created. | [default to undefined]
+**cancelledAt** | **string** | The timestamp when the import was cancelled. Null if the import has not been cancelled. | [optional] [default to undefined]
+**startedAt** | **string** | The timestamp when the import started processing. Null if processing has not yet begun. | [optional] [default to undefined]
+**finishedAt** | **string** | The timestamp when the import finished processing. Null if processing has not yet completed. | [optional] [default to undefined]
 
 ## Example
 

package/docs/OrderImportCounts.md

@@ -1,5 +1,6 @@
 # OrderImportCounts
 
+Counts of import groups in each processing state.
 
 ## Properties
 

package/docs/OrderImportError.md

@@ -1,11 +1,12 @@
 # OrderImportError
 
+An error encountered while processing an import group, including a machine-readable code and human-readable message.
 
 ## Properties
 
 Name | Type | Description | Notes
 ------------ | ------------- | ------------- | -------------
-**code** | [**OrderImportErrorCode**](OrderImportErrorCode.md) |  | [default to undefined]
+**code** | [**OrderImportErrorCode**](OrderImportErrorCode.md) | A machine-readable error code identifying the type of import failure. | [default to undefined]
 **message** | **string** | A human-readable description of the error. | [default to undefined]
 **fieldPath** | **string** | Dot-notation path to the field that caused the error (e.g. `items.sku`). | [optional] [default to undefined]
 **sku** | **string** | The SKU that triggered the error, if applicable. | [optional] [default to undefined]

package/docs/OrderImportGroup.md

@@ -1,21 +1,22 @@
 # OrderImportGroup
 
+A single group (order) within a bulk import, representing one merchant reference and its processing outcome.
 
 ## Properties
 
 Name | Type | Description | Notes
 ------------ | ------------- | ------------- | -------------
-**id** | **string** | Unique object identifier | [default to undefined]
-**status** | [**OrderImportGroupStatus**](OrderImportGroupStatus.md) |  | [default to undefined]
+**id** | **string** | Unique identifier for this import group. | [default to undefined]
+**status** | [**OrderImportGroupStatus**](OrderImportGroupStatus.md) | The current lifecycle status of this import group. | [default to undefined]
 **merchantReference** | **string** | The merchant reference from the CSV rows belonging to this group. | [optional] [default to undefined]
 **resultReference** | **string** | A URI reference to the order created by this group. Only present when the group status is `success`. | [optional] [default to undefined]
 **message** | **string** | A human-readable message describing the outcome of this group. | [optional] [default to undefined]
 **rowsCount** | **number** | The number of CSV rows that belong to this group. | [default to undefined]
 **skus** | **Array<string>** | The distinct SKUs referenced by rows in this group. | [default to undefined]
 **errors** | [**Array<OrderImportError>**](OrderImportError.md) | Errors encountered while processing this group. Empty when the group succeeded. | [default to undefined]
-**createdAt** | **string** |  | [optional] [default to undefined]
-**startedAt** | **string** |  | [optional] [default to undefined]
-**finishedAt** | **string** |  | [optional] [default to undefined]
+**createdAt** | **string** | The timestamp when this group was created. Null if not yet set. | [optional] [default to undefined]
+**startedAt** | **string** | The timestamp when this group started processing. Null if processing has not yet begun. | [optional] [default to undefined]
+**finishedAt** | **string** | The timestamp when this group finished processing. Null if processing has not yet completed. | [optional] [default to undefined]
 
 ## Example
 

package/docs/OrderItem.md

@@ -7,8 +7,8 @@ A line item in an order, representing a specific product variant and quantity.
 Name | Type | Description | Notes
 ------------ | ------------- | ------------- | -------------
 **id** | **string** | Unique identifier for this order item. | [optional] [readonly] [default to undefined]
-**variantRef** | **string** | A reference to the variant being ordered | [default to undefined]
-**_options** | [**Array<Option>**](Option.md) | Options associated to an order item\'s variant, such as color and size. | [optional] [default to undefined]
+**variantRef** | **string** | A reference to the product variant being ordered. | [default to undefined]
+**_options** | [**Array<Option>**](Option.md) | The variant attributes (e.g. Colour, Size) for this line item. | [optional] [default to undefined]
 **quantity** | **number** | The number of units of this variant to order. | [default to undefined]
 **name** | **string** | The display name of the product. | [optional] [readonly] [default to undefined]
 **images** | [**Array<Image>**](Image.md) | Product images associated with this item. | [optional] [readonly] [default to undefined]