@teemill/orders 1.28.4 → 1.29.2

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.28.4
+ * The version of the OpenAPI document: 1.29.2
  *
  *
  * 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;
 }
@@ -316,7 +319,26 @@ export interface Fulfillment {
      * Reference to the source platform of this fulfillment.
      */
     'platformRef'?: string;
+    /**
+     * Whether the fulfillment is frozen. This will prevent the fulfillment from being picked.
+     */
+    'frozen'?: boolean;
+    /**
+     * 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. - `credit_control` - Client 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<FulfillmentFrozenReasonsEnum>;
 }
+export declare const FulfillmentFrozenReasonsEnum: {
+    readonly Moderation: "moderation";
+    readonly InternalScreenPrint: "internal_screen_print";
+    readonly Manual: "manual";
+    readonly CreditControl: "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.
@@ -354,7 +376,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;
 }
@@ -373,11 +395,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;
     /**
@@ -449,21 +471,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;
@@ -473,7 +513,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.
@@ -507,11 +553,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.
@@ -537,8 +589,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;
 }
 /**
@@ -581,11 +642,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>;
     /**
@@ -719,6 +780,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.
@@ -729,11 +793,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;
     /**
@@ -835,6 +899,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';
@@ -845,6 +910,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.
@@ -855,11 +923,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;
     /**
@@ -1003,7 +1071,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
@@ -1136,7 +1204,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
@@ -1239,7 +1307,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}
@@ -1576,7 +1644,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.28.4
+ * The version of the OpenAPI document: 1.29.2
  *
  *
  * NOTE: This class is auto generated by OpenAPI Generator (https://openapi-generator.tech).
@@ -30,10 +30,20 @@ export const ConfirmOrderValidationErrorCodeEnum = {
     BadRequest: 'BAD_REQUEST',
     PaymentFailed: 'PAYMENT_FAILED',
     Conflict: 'CONFLICT',
-    ActionRequired: 'ACTION_REQUIRED'
+    ActionRequired: 'ACTION_REQUIRED',
 };
 export const CustomsInformationPreRegistrationTypeEnum = {
-    Ioss: 'IOSS'
+    Ioss: 'IOSS',
+};
+export const FulfillmentFrozenReasonsEnum = {
+    Moderation: 'moderation',
+    InternalScreenPrint: 'internal_screen_print',
+    Manual: 'manual',
+    CreditControl: '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
@@ -43,7 +53,7 @@ export const OrderImportErrorCode = {
     MissingSku: 'MISSING_SKU',
     ShippingMethodUnavailable: 'SHIPPING_METHOD_UNAVAILABLE',
     TransientSystemError: 'TRANSIENT_SYSTEM_ERROR',
-    ImportFailed: 'IMPORT_FAILED'
+    ImportFailed: 'IMPORT_FAILED',
 };
 /**
  * The lifecycle status of a single group (order) within an import: - `pending` — Group is queued and has not started processing - `processing` — Group is currently being processed - `success` — Order was created and confirmed successfully - `failed` — Order creation or confirmation failed - `cancelled` — Group was cancelled (e.g. parent import was cancelled)
@@ -53,7 +63,7 @@ export const OrderImportGroupStatus = {
     Processing: 'processing',
     Success: 'success',
     Failed: 'failed',
-    Cancelled: 'cancelled'
+    Cancelled: 'cancelled',
 };
 /**
  * The lifecycle status of an order import: - `queued` — Import has been accepted but no groups have started processing yet - `processing` — One or more groups are currently being processed - `completedSuccess` — All groups were imported successfully - `completedPartial` — Some groups succeeded but others failed or were cancelled - `completedFailed` — All groups failed or were cancelled, with none succeeding - `cancelled` — The entire import was cancelled before completion
@@ -64,24 +74,24 @@ export const OrderImportStatus = {
     CompletedSuccess: 'completedSuccess',
     CompletedPartial: 'completedPartial',
     CompletedFailed: 'completedFailed',
-    Cancelled: 'cancelled'
+    Cancelled: 'cancelled',
 };
 export const PaymentAttemptPaymentProviderEnum = {
     Stripe: 'stripe',
     Paypal: 'paypal',
-    Wallet: 'wallet'
+    Wallet: 'wallet',
 };
 export const PaymentAttemptStatusEnum = {
     Success: 'success',
     Failed: 'failed',
     Pending: 'pending',
-    Cancelled: 'cancelled'
+    Cancelled: 'cancelled',
 };
 export const ProductUnavailableErrorCodeEnum = {
-    ProductUnavailable: 'PRODUCT_UNAVAILABLE'
+    ProductUnavailable: 'PRODUCT_UNAVAILABLE',
 };
 export const ProductUnavailableErrorAvailableQuantityEnum = {
-    NUMBER_0: 0
+    NUMBER_0: 0,
 };
 /**
  * The lifecycle status of an order or fulfillment: - `new` — Order has been created but not yet confirmed or paid - `paid` — Payment has been received, awaiting fulfillment - `processing` — Order is being produced or packed - `complete` — Order has been shipped - `refunded` — Order has been refunded - `quote` — Order is a draft quote, not yet submitted - `moderation` — Order is held for review
@@ -93,10 +103,10 @@ export const Status = {
     Complete: 'complete',
     Refunded: 'refunded',
     Quote: 'quote',
-    Moderation: 'moderation'
+    Moderation: 'moderation',
 };
 export const StockUnavailableErrorCodeEnum = {
-    StockUnavailable: 'STOCK_UNAVAILABLE'
+    StockUnavailable: 'STOCK_UNAVAILABLE',
 };
 /**
  * OrdersApi - axios parameter creator
@@ -649,7 +659,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 +918,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 +1054,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 +1180,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}
@@ -1186,7 +1196,7 @@ export const ExportOrdersDateFilterTypeEnum = {
     StatusChangedAt: 'statusChangedAt',
     CompletedAt: 'completedAt',
     RefundedAt: 'refundedAt',
-    QuoteAt: 'quoteAt'
+    QuoteAt: 'quoteAt',
 };
 export const GetOrdersDateFilterTypeEnum = {
     CreatedAt: 'createdAt',
@@ -1195,5 +1205,5 @@ export const GetOrdersDateFilterTypeEnum = {
     StatusChangedAt: 'statusChangedAt',
     CompletedAt: 'completedAt',
     RefundedAt: 'refundedAt',
-    QuoteAt: 'quoteAt'
+    QuoteAt: 'quoteAt',
 };

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.28.4
+ * The version of the OpenAPI document: 1.29.2
  *
  *
  * 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.28.4
+ * The version of the OpenAPI document: 1.29.2
  *
  *
  * 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.28.4
+ * The version of the OpenAPI document: 1.29.2
  *
  *
  * 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.28.4
+ * The version of the OpenAPI document: 1.29.2
  *
  *
  * 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.28.4
+ * The version of the OpenAPI document: 1.29.2
  *
  *
  * 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.28.4
+ * The version of the OpenAPI document: 1.29.2
  *
  *
  * 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.28.4
+ * The version of the OpenAPI document: 1.29.2
  *
  *
  * 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.28.4
+ * The version of the OpenAPI document: 1.29.2
  *
  *
  * 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.28.4
+ * The version of the OpenAPI document: 1.29.2
  *
  *
  * 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.28.4
+ * The version of the OpenAPI document: 1.29.2
  *
  *
  * 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

@@ -15,6 +15,8 @@ Name | Type | Description | Notes
 **availableShippingMethods** | [**Array<ShippingMethod>**](ShippingMethod.md) | Shipping methods available for this fulfillment. Use one of these IDs when confirming the order. | [optional] [default to undefined]
 **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. - `moderation` - Held for content moderation review. - `internal_screen_print` - Awaiting internal screen print processing. - `manual` - Manually frozen by a user. - `credit_control` - Client 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
 
@@ -31,6 +33,8 @@ const instance: Fulfillment = {
     availableShippingMethods,
     packageWeight,
     platformRef,
+    frozen,
+    frozenReasons,
 };
 ```
 

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