@teemill/orders 1.24.1 → 1.26.0

package/docs/CustomsInformation.md

@@ -6,10 +6,10 @@ Customs information for the order. **Note:** Adding customs information to an or
 
 Name | Type | Description | Notes
 ------------ | ------------- | ------------- | -------------
-**preRegistrationType** | **string** | Pre-registration type | [optional] [default to undefined]
-**preRegistrationNumber** | **string** | Pre-registration number | [optional] [default to undefined]
-**vatNumber** | **string** | VAT number | [optional] [default to undefined]
-**eoriNumber** | **string** | EORI number | [optional] [default to undefined]
+**preRegistrationType** | **string** | The type of tax pre-registration (e.g. IOSS for EU imports). | [optional] [default to undefined]
+**preRegistrationNumber** | **string** | The pre-registration number associated with the registration type. | [optional] [default to undefined]
+**vatNumber** | **string** | The shipper\'s VAT registration number. | [optional] [default to undefined]
+**eoriNumber** | **string** | The shipper\'s EORI number for customs declarations. | [optional] [default to undefined]
 
 ## Example
 

package/docs/CustomsInformation1.md

@@ -1,14 +1,15 @@
 # CustomsInformation1
 
+Customs and tax registration details for international shipments.
 
 ## Properties
 
 Name | Type | Description | Notes
 ------------ | ------------- | ------------- | -------------
-**preRegistrationType** | **string** |  | [optional] [default to undefined]
-**preRegistrationNumber** | **string** |  | [optional] [default to undefined]
-**vatNumber** | **string** |  | [optional] [default to undefined]
-**eoriNumber** | **string** |  | [optional] [default to undefined]
+**preRegistrationType** | **string** | The type of tax pre-registration (e.g. IOSS for EU imports). | [optional] [default to undefined]
+**preRegistrationNumber** | **string** | The pre-registration number associated with the registration type. | [optional] [default to undefined]
+**vatNumber** | **string** | The shipper\'s VAT registration number. | [optional] [default to undefined]
+**eoriNumber** | **string** | The shipper\'s EORI number for customs declarations. | [optional] [default to undefined]
 
 ## Example
 

package/docs/DeliveryEstimates.md

@@ -1,13 +1,14 @@
 # DeliveryEstimates
 
+Estimated delivery window for this shipping method.
 
 ## Properties
 
 Name | Type | Description | Notes
 ------------ | ------------- | ------------- | -------------
-**isPriority** | **boolean** | Whether this is a priority shipping method. Fulfillments with priority methods aim for same day dispatch when ordered before 1pm, and typically offer faster delivery times. | [optional] [default to undefined]
-**min** | **string** | ISO 8601 Timestamp | [optional] [default to undefined]
-**max** | **string** | ISO 8601 Timestamp | [optional] [default to undefined]
+**isPriority** | **boolean** | Whether this is a priority shipping method. Fulfillments with priority methods aim for same-day dispatch when ordered before 1pm, and typically offer faster delivery times. | [optional] [default to undefined]
+**min** | **string** | The earliest estimated delivery date. | [optional] [default to undefined]
+**max** | **string** | The latest estimated delivery date. | [optional] [default to undefined]
 
 ## Example
 

package/docs/Fulfiller.md

@@ -0,0 +1,25 @@
+# Fulfiller
+
+The fulfiller that will produce and ship this package.
+
+## Properties
+
+Name | Type | Description | Notes
+------------ | ------------- | ------------- | -------------
+**id** | **string** | Unique identifier of the fulfiller. | [optional] [default to undefined]
+**location** | [**FulfillerLocation**](FulfillerLocation.md) |  | [optional] [default to undefined]
+**canFulfillImmediately** | **boolean** | Whether the fulfiller has the stock and capacity to begin processing immediately. | [optional] [default to undefined]
+
+## Example
+
+```typescript
+import { Fulfiller } from '@teemill/orders';
+
+const instance: Fulfiller = {
+    id,
+    location,
+    canFulfillImmediately,
+};
+```
+
+[[Back to Model list]](../README.md#documentation-for-models) [[Back to API list]](../README.md#documentation-for-api-endpoints) [[Back to README]](../README.md)

package/docs/FulfillerLocation.md

@@ -0,0 +1,23 @@
+# FulfillerLocation
+
+The geographic location of the fulfiller.
+
+## Properties
+
+Name | Type | Description | Notes
+------------ | ------------- | ------------- | -------------
+**city** | **string** | The city where the fulfiller is located. | [optional] [default to undefined]
+**country** | **string** | The country code where the fulfiller is located (ISO 3166-1 alpha-2). | [optional] [default to undefined]
+
+## Example
+
+```typescript
+import { FulfillerLocation } from '@teemill/orders';
+
+const instance: FulfillerLocation = {
+    city,
+    country,
+};
+```
+
+[[Back to Model list]](../README.md#documentation-for-models) [[Back to API list]](../README.md#documentation-for-api-endpoints) [[Back to README]](../README.md)

package/docs/Fulfillment.md

@@ -1,19 +1,20 @@
 # Fulfillment
 
+A fulfillment group within an order. Each fulfillment represents a package that will be shipped separately, potentially from a different fulfiller.
 
 ## Properties
 
 Name | Type | Description | Notes
 ------------ | ------------- | ------------- | -------------
-**id** | **string** | Unique fulfillment id | [optional] [default to undefined]
-**status** | [**Status**](Status.md) |  | [optional] [default to undefined]
-**fulfiller** | [**FulfillmentFulfiller**](FulfillmentFulfiller.md) |  | [optional] [default to undefined]
-**items** | [**Array<FulfillmentItem>**](FulfillmentItem.md) |  | [optional] [default to undefined]
+**id** | **string** | Unique identifier for this fulfillment. | [optional] [default to undefined]
+**status** | [**Status**](Status.md) | The current status of this fulfillment. | [optional] [default to undefined]
+**fulfiller** | [**Fulfiller**](Fulfiller.md) |  | [optional] [default to undefined]
+**items** | [**Array<FulfillmentItem>**](FulfillmentItem.md) | The items included in this fulfillment package. | [optional] [default to undefined]
 **tracking** | [**OrderTracking**](OrderTracking.md) |  | [optional] [default to undefined]
-**shippingMethod** | [**ShippingMethod**](ShippingMethod.md) | Shipping method currently set | [optional] [default to undefined]
-**availableShippingMethods** | [**Array<ShippingMethod>**](ShippingMethod.md) | Shipping methods available for this fulfillment. One of these should be used to confirm the fulfillment. | [optional] [default to undefined]
-**packageWeight** | **number** | Weight of the package being shipped in grams | [optional] [default to undefined]
-**platformRef** | **string** | A reference to the resource location | [optional] [default to undefined]
+**shippingMethod** | [**ShippingMethod**](ShippingMethod.md) | The shipping method currently assigned to this fulfillment. | [optional] [default to undefined]
+**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]
 
 ## Example
 

package/docs/FulfillmentItem.md

@@ -5,9 +5,9 @@
 
 Name | Type | Description | Notes
 ------------ | ------------- | ------------- | -------------
-**id** | **string** | Unique fulfillment item id | [optional] [default to undefined]
-**itemId** | **string** | Id of the order item being fulfilled | [optional] [default to undefined]
-**quantity** | **number** | Number of this item being fulfilled | [optional] [default to undefined]
+**id** | **string** | Unique identifier for this fulfillment item. | [optional] [default to undefined]
+**itemId** | **string** | The ID of the order item being fulfilled. | [optional] [default to undefined]
+**quantity** | **number** | The number of units of this item included in the fulfillment. | [optional] [default to undefined]
 
 ## Example
 

package/docs/Image.md

@@ -1,15 +1,15 @@
 # Image
 
-Image description
+A product image associated with an order item.
 
 ## Properties
 
 Name | Type | Description | Notes
 ------------ | ------------- | ------------- | -------------
-**id** | **string** | Unique object identifier | [optional] [default to undefined]
-**src** | **string** |  | [optional] [default to undefined]
-**alt** | **string** |  | [optional] [default to undefined]
-**sortOrder** | **number** |  | [optional] [default to undefined]
+**id** | **string** | Unique identifier for this image. | [optional] [default to undefined]
+**src** | **string** | The URL of the image. | [optional] [default to undefined]
+**alt** | **string** | Alternative text describing the image content. | [optional] [default to undefined]
+**sortOrder** | **number** | The display order of this image relative to other images for the same item. | [optional] [default to undefined]
 
 ## Example
 

package/docs/ImportOrders202Response.md

@@ -0,0 +1,20 @@
+# ImportOrders202Response
+
+
+## Properties
+
+Name | Type | Description | Notes
+------------ | ------------- | ------------- | -------------
+**importId** | **string** | Id of the order import | [optional] [default to undefined]
+
+## Example
+
+```typescript
+import { ImportOrders202Response } from '@teemill/orders';
+
+const instance: ImportOrders202Response = {
+    importId,
+};
+```
+
+[[Back to Model list]](../README.md#documentation-for-models) [[Back to API list]](../README.md#documentation-for-api-endpoints) [[Back to README]](../README.md)

package/docs/Order.md

@@ -1,5 +1,6 @@
 # Order
 
+Represents a print-on-demand order placed on a project. An order contains items, fulfillment details, pricing, and status tracking.
 
 ## Properties
 
@@ -7,26 +8,26 @@ 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]
-**status** | [**Status**](Status.md) |  | [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** | [**PaymentMethod**](PaymentMethod.md) |  | [optional] [default to undefined]
-**shippingAddress** | [**Address**](Address.md) |  | [default to undefined]
+**paymentMethod** | [**OrderPaymentMethod**](OrderPaymentMethod.md) |  | [optional] [default to undefined]
+**shippingAddress** | [**Address**](Address.md) | The address the order will be shipped to. | [default to undefined]
 **customsInformation** | [**CustomsInformation1**](CustomsInformation1.md) |  | [optional] [default to undefined]
-**createdAt** | **string** | ISO 8601 Timestamp | [optional] [default to undefined]
-**updatedAt** | **string** | ISO 8601 Timestamp | [optional] [default to undefined]
-**statusChangedAt** | **string** | ISO 8601 Timestamp | [optional] [default to undefined]
-**merchantReference** | **string** | A custom reference to the merchant\'s order. | [optional] [default to undefined]
-**fulfillments** | [**Array<Fulfillment>**](Fulfillment.md) |  | [optional] [readonly] [default to undefined]
-**items** | [**Array<OrderItem>**](OrderItem.md) |  | [default to undefined]
-**totalPrice** | [**Price**](Price.md) |  | [optional] [default to undefined]
-**taxPrice** | [**Price**](Price.md) |  | [optional] [default to undefined]
-**subtotalPrice** | [**Price**](Price.md) |  | [optional] [default to undefined]
-**discountPrice** | [**Price**](Price.md) |  | [optional] [default to undefined]
-**coupon** | [**Coupon**](Coupon.md) |  | [optional] [default to undefined]
-**shippingPrice** | [**Price**](Price.md) |  | [optional] [default to undefined]
+**createdAt** | **string** | When the order was created. | [optional] [default to undefined]
+**updatedAt** | **string** | When the order was last updated. | [optional] [default to undefined]
+**statusChangedAt** | **string** | When the order status last changed. | [optional] [default to undefined]
+**merchantReference** | **string** | Your own reference for this order, such as an order number from your storefront. | [optional] [default to undefined]
+**fulfillments** | [**Array<Fulfillment>**](Fulfillment.md) | The fulfillment groups for this order. Each fulfillment represents a package that will be shipped separately. | [optional] [readonly] [default to undefined]
+**items** | [**Array<OrderItem>**](OrderItem.md) | The line items included in this order. | [default to undefined]
+**totalPrice** | [**Price**](Price.md) | The total price of the order including tax and after discounts. | [optional] [default to undefined]
+**taxPrice** | [**Price**](Price.md) | The total tax amount for the order. | [optional] [default to undefined]
+**subtotalPrice** | [**Price**](Price.md) | The net items price excluding tax and before discounts. | [optional] [default to undefined]
+**discountPrice** | [**Price**](Price.md) | The total discount amount applied to the order. | [optional] [default to undefined]
+**coupon** | [**Coupon**](Coupon.md) | The coupon applied to the order, if any. | [optional] [default to undefined]
+**shippingPrice** | [**Price**](Price.md) | The total shipping cost for the order. | [optional] [default to undefined]
 **origin** | [**Origin**](Origin.md) |  | [optional] [default to undefined]
-**statusHistory** | [**Array<StatusHistoryItem>**](StatusHistoryItem.md) |  | [optional] [default to undefined]
-**paymentAttempts** | [**Array<PaymentAttempt>**](PaymentAttempt.md) |  | [optional] [default to undefined]
+**statusHistory** | [**Array<StatusHistoryItem>**](StatusHistoryItem.md) | A chronological list of status changes for this order. | [optional] [default to undefined]
+**paymentAttempts** | [**Array<PaymentAttempt>**](PaymentAttempt.md) | A list of payment attempts made for this order. | [optional] [default to undefined]
 
 ## Example
 

package/docs/OrderItem.md

@@ -1,21 +1,22 @@
 # OrderItem
 
+A line item in an order, representing a specific product variant and quantity.
 
 ## Properties
 
 Name | Type | Description | Notes
 ------------ | ------------- | ------------- | -------------
-**id** | **string** | Unique object identifier | [optional] [readonly] [default to undefined]
+**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]
-**quantity** | **number** |  | [default to undefined]
-**name** | **string** | The name of the product | [optional] [default to undefined]
-**images** | [**Array<Image>**](Image.md) | Images | [optional] [default to undefined]
-**totalPrice** | [**Price**](Price.md) |  | [optional] [readonly] [default to undefined]
-**taxPrice** | [**Price**](Price.md) | This is an estimate until the order has been confirmed | [optional] [readonly] [default to undefined]
-**subtotalPrice** | [**Price**](Price.md) |  | [optional] [readonly] [default to undefined]
-**discountPrice** | [**Price**](Price.md) |  | [optional] [readonly] [default to undefined]
-**recipientCost** | [**Price**](Price.md) | The price you charged the recipient for each item. It\'s highly recommended if you have international orders as it aids customs issues. | [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]
+**totalPrice** | [**Price**](Price.md) | The total price for this line item including tax and after discounts. | [optional] [readonly] [default to undefined]
+**taxPrice** | [**Price**](Price.md) | The tax amount for this line item. This is an estimate until the order has been confirmed. | [optional] [readonly] [default to undefined]
+**subtotalPrice** | [**Price**](Price.md) | The net price for this line item, excluding tax and before discounts. | [optional] [readonly] [default to undefined]
+**discountPrice** | [**Price**](Price.md) | The discount amount applied to this line item. | [optional] [readonly] [default to undefined]
+**recipientCost** | [**Price**](Price.md) | The price you charged the recipient for each item. Highly recommended for international orders as it aids customs declarations. | [optional] [default to undefined]
 
 ## Example
 

package/docs/OrderPaymentMethod.md

@@ -0,0 +1,21 @@
+# OrderPaymentMethod
+
+The payment method used for this order.
+
+## Properties
+
+Name | Type | Description | Notes
+------------ | ------------- | ------------- | -------------
+**type** | **string** | The type of payment method used. | [optional] [default to undefined]
+
+## Example
+
+```typescript
+import { OrderPaymentMethod } from '@teemill/orders';
+
+const instance: OrderPaymentMethod = {
+    type,
+};
+```
+
+[[Back to Model list]](../README.md#documentation-for-models) [[Back to API list]](../README.md#documentation-for-api-endpoints) [[Back to README]](../README.md)

package/docs/OrderTracking.md

@@ -1,13 +1,14 @@
 # OrderTracking
 
+Shipment tracking information. Available once the fulfillment has been dispatched.
 
 ## Properties
 
 Name | Type | Description | Notes
 ------------ | ------------- | ------------- | -------------
-**courier** | **string** |  | [optional] [default to undefined]
-**code** | **string** |  | [optional] [default to undefined]
-**url** | **string** |  | [optional] [default to undefined]
+**courier** | **string** | The name of the courier service. | [optional] [default to undefined]
+**code** | **string** | The tracking code provided by the courier. | [optional] [default to undefined]
+**url** | **string** | A URL to track the shipment on the courier\'s website. | [optional] [default to undefined]
 
 ## Example
 

package/docs/OrdersApi.md

@@ -11,6 +11,7 @@ All URIs are relative to *https://api.localhost:8080*
 |[**exportOrders**](#exportorders) | **GET** /v1/orders/export | Export orders|
 |[**getOrder**](#getorder) | **GET** /v1/orders/{orderId} | Get order|
 |[**getOrders**](#getorders) | **GET** /v1/orders | List orders|
+|[**importOrders**](#importorders) | **POST** /v1/orders/import | Import orders|
 |[**retryPlatformPayment**](#retryplatformpayment) | **POST** /v1/orders/{orderId}/retryPlatformPayment | Retry|
 
 # **cancelOrder**
@@ -29,7 +30,7 @@ import {
 const configuration = new Configuration();
 const apiInstance = new OrdersApi(configuration);
 
-let project: string; //What project it is (default to undefined)
+let project: string; //The project identifier to scope the request to. (default to undefined)
 let orderId: string; //Unique identifier of an order (default to undefined)
 let fields: string; //Specifies which fields to return, separated by commas (optional) (default to undefined)
 
@@ -44,7 +45,7 @@ const { status, data } = await apiInstance.cancelOrder(
 
 |Name | Type | Description  | Notes|
 |------------- | ------------- | ------------- | -------------|
-| **project** | [**string**] | What project it is | defaults to undefined|
+| **project** | [**string**] | The project identifier to scope the request to. | defaults to undefined|
 | **orderId** | [**string**] | Unique identifier of an order | defaults to undefined|
 | **fields** | [**string**] | Specifies which fields to return, separated by commas | (optional) defaults to undefined|
 
@@ -92,9 +93,9 @@ import {
 const configuration = new Configuration();
 const apiInstance = new OrdersApi(configuration);
 
-let project: string; //What project it is (default to undefined)
+let project: string; //The project identifier to scope the request to. (default to undefined)
 let orderId: string; //Unique identifier of an order (default to undefined)
-let confirmOrderRequest: ConfirmOrderRequest; //ConfirmFulfillment schema
+let confirmOrderRequest: ConfirmOrderRequest; //Confirm an order by specifying shipping methods for each fulfillment. This submits the order for payment processing and production. Orders should be confirmed promptly after creation — the longer an order remains unconfirmed, the greater the chance that stock availability changes. If stock is no longer available at the time of confirmation, the request will fail and you will need to create a new order.
 let fields: string; //Specifies which fields to return, separated by commas (optional) (default to undefined)
 
 const { status, data } = await apiInstance.confirmOrder(
@@ -109,8 +110,8 @@ const { status, data } = await apiInstance.confirmOrder(
 
 |Name | Type | Description  | Notes|
 |------------- | ------------- | ------------- | -------------|
-| **confirmOrderRequest** | **ConfirmOrderRequest**| ConfirmFulfillment schema | |
-| **project** | [**string**] | What project it is | defaults to undefined|
+| **confirmOrderRequest** | **ConfirmOrderRequest**| Confirm an order by specifying shipping methods for each fulfillment. This submits the order for payment processing and production. Orders should be confirmed promptly after creation — the longer an order remains unconfirmed, the greater the chance that stock availability changes. If stock is no longer available at the time of confirmation, the request will fail and you will need to create a new order. | |
+| **project** | [**string**] | The project identifier to scope the request to. | defaults to undefined|
 | **orderId** | [**string**] | Unique identifier of an order | defaults to undefined|
 | **fields** | [**string**] | Specifies which fields to return, separated by commas | (optional) defaults to undefined|
 
@@ -133,7 +134,7 @@ const { status, data } = await apiInstance.confirmOrder(
 | Status code | Description | Response headers |
 |-------------|-------------|------------------|
 |**200** | Order schema |  -  |
-|**400** | Failed validation |  -  |
+|**400** | Failed validation for the confirm request. When the error relates to item fulfillment issues (e.g. stock or availability problems), the response includes an `errors` array with details on each affected item.  |  -  |
 |**401** | Not authorised to access this resource |  -  |
 |**403** | Refuse to authorize |  -  |
 |**404** | Resource not found |  -  |
@@ -158,7 +159,7 @@ import {
 const configuration = new Configuration();
 const apiInstance = new OrdersApi(configuration);
 
-let project: string; //What project it is (default to undefined)
+let project: string; //The project identifier to scope the request to. (default to undefined)
 let createOrder: CreateOrder; //Create Order schema
 let fields: string; //Specifies which fields to return, separated by commas (optional) (default to undefined)
 
@@ -174,7 +175,7 @@ const { status, data } = await apiInstance.createOrder(
 |Name | Type | Description  | Notes|
 |------------- | ------------- | ------------- | -------------|
 | **createOrder** | **CreateOrder**| Create Order schema | |
-| **project** | [**string**] | What project it is | defaults to undefined|
+| **project** | [**string**] | The project identifier to scope the request to. | defaults to undefined|
 | **fields** | [**string**] | Specifies which fields to return, separated by commas | (optional) defaults to undefined|
 
 
@@ -219,7 +220,7 @@ import {
 const configuration = new Configuration();
 const apiInstance = new OrdersApi(configuration);
 
-let project: string; //What project it is (default to undefined)
+let project: string; //The project identifier to scope the request to. (default to undefined)
 let orderId: string; //Unique identifier of an order (default to undefined)
 
 const { status, data } = await apiInstance.downloadInvoice(
@@ -232,7 +233,7 @@ const { status, data } = await apiInstance.downloadInvoice(
 
 |Name | Type | Description  | Notes|
 |------------- | ------------- | ------------- | -------------|
-| **project** | [**string**] | What project it is | defaults to undefined|
+| **project** | [**string**] | The project identifier to scope the request to. | defaults to undefined|
 | **orderId** | [**string**] | Unique identifier of an order | defaults to undefined|
 
 
@@ -278,9 +279,9 @@ import {
 const configuration = new Configuration();
 const apiInstance = new OrdersApi(configuration);
 
-let project: string; //What project it is (default to undefined)
-let start: string; //Start of date range to filter by when orders were placed (default to undefined)
-let end: string; //End of date range (optional) (default to undefined)
+let project: string; //The project identifier to scope the request to. (default to undefined)
+let start: string; //Start of the date range to filter by when orders were placed. (default to undefined)
+let end: string; //End of date range filter. Which date field this applies to is controlled by the `dateFilterType` parameter. (optional) (default to undefined)
 let search: string; //Search term to filter based on order reference, customer name and email (optional) (default to undefined)
 
 const { status, data } = await apiInstance.exportOrders(
@@ -295,9 +296,9 @@ const { status, data } = await apiInstance.exportOrders(
 
 |Name | Type | Description  | Notes|
 |------------- | ------------- | ------------- | -------------|
-| **project** | [**string**] | What project it is | defaults to undefined|
-| **start** | [**string**] | Start of date range to filter by when orders were placed | defaults to undefined|
-| **end** | [**string**] | End of date range | (optional) defaults to undefined|
+| **project** | [**string**] | The project identifier to scope the request to. | defaults to undefined|
+| **start** | [**string**] | Start of the date range to filter by when orders were placed. | defaults to undefined|
+| **end** | [**string**] | End of date range filter. Which date field this applies to is controlled by the `dateFilterType` parameter. | (optional) defaults to undefined|
 | **search** | [**string**] | Search term to filter based on order reference, customer name and email | (optional) defaults to undefined|
 
 
@@ -344,7 +345,7 @@ import {
 const configuration = new Configuration();
 const apiInstance = new OrdersApi(configuration);
 
-let project: string; //What project it is (default to undefined)
+let project: string; //The project identifier to scope the request to. (default to undefined)
 let orderId: string; //Unique identifier of an order (default to undefined)
 let fields: string; //Specifies which fields to return, separated by commas (optional) (default to undefined)
 
@@ -359,7 +360,7 @@ const { status, data } = await apiInstance.getOrder(
 
 |Name | Type | Description  | Notes|
 |------------- | ------------- | ------------- | -------------|
-| **project** | [**string**] | What project it is | defaults to undefined|
+| **project** | [**string**] | The project identifier to scope the request to. | defaults to undefined|
 | **orderId** | [**string**] | Unique identifier of an order | defaults to undefined|
 | **fields** | [**string**] | Specifies which fields to return, separated by commas | (optional) defaults to undefined|
 
@@ -406,15 +407,15 @@ import {
 const configuration = new Configuration();
 const apiInstance = new OrdersApi(configuration);
 
-let project: string; //What project it is (default to undefined)
+let project: string; //The project identifier to scope the request to. (default to undefined)
 let fields: string; //Specifies which fields to return, separated by commas (optional) (default to undefined)
 let pageToken: number; //Page reference token (optional) (default to 1)
 let pageSize: number; //Max page size. This is the maximum page size that will be returned, but it might be smaller. (optional) (default to 100)
 let search: string; //Search term to filter based on order reference, customer name and email (optional) (default to undefined)
-let ids: Array<string>; //Specify fulfillment IDs to list (optional) (default to undefined)
-let statuses: Array<Status>; //Filter by fulfillment status (optional) (default to undefined)
-let start: string; //Start of date range (optional) (default to undefined)
-let end: string; //End of date range (optional) (default to undefined)
+let ids: Array<string>; //Filter to specific order IDs. Only orders matching these IDs will be returned. (optional) (default to undefined)
+let statuses: Array<Status>; //Filter by order status. Only orders matching one of the given statuses will be returned. (optional) (default to undefined)
+let start: string; //Start of date range filter. Which date field this applies to is controlled by the `dateFilterType` parameter. (optional) (default to undefined)
+let end: string; //End of date range filter. Which date field this applies to is controlled by the `dateFilterType` parameter. (optional) (default to undefined)
 let dateFilterType: 'createdAt' | 'updatedAt' | 'statusChangedAt'; //Specifies the type of date range filter to apply. Determines which date field the `start` and `end` fields should query. (optional) (default to 'createdAt')
 
 const { status, data } = await apiInstance.getOrders(
@@ -435,15 +436,15 @@ const { status, data } = await apiInstance.getOrders(
 
 |Name | Type | Description  | Notes|
 |------------- | ------------- | ------------- | -------------|
-| **project** | [**string**] | What project it is | defaults to undefined|
+| **project** | [**string**] | The project identifier to scope the request to. | defaults to undefined|
 | **fields** | [**string**] | Specifies which fields to return, separated by commas | (optional) defaults to undefined|
 | **pageToken** | [**number**] | Page reference token | (optional) defaults to 1|
 | **pageSize** | [**number**] | Max page size. This is the maximum page size that will be returned, but it might be smaller. | (optional) defaults to 100|
 | **search** | [**string**] | Search term to filter based on order reference, customer name and email | (optional) defaults to undefined|
-| **ids** | **Array&lt;string&gt;** | Specify fulfillment IDs to list | (optional) defaults to undefined|
-| **statuses** | **Array&lt;Status&gt;** | Filter by fulfillment status | (optional) defaults to undefined|
-| **start** | [**string**] | Start of date range | (optional) defaults to undefined|
-| **end** | [**string**] | End of date range | (optional) defaults to undefined|
+| **ids** | **Array&lt;string&gt;** | Filter to specific order IDs. Only orders matching these IDs will be returned. | (optional) defaults to undefined|
+| **statuses** | **Array&lt;Status&gt;** | Filter by order status. Only orders matching one of the given statuses will be returned. | (optional) defaults to undefined|
+| **start** | [**string**] | Start of date range filter. Which date field this applies to is controlled by the &#x60;dateFilterType&#x60; parameter. | (optional) defaults to undefined|
+| **end** | [**string**] | End of date range filter. Which date field this applies to is controlled by the &#x60;dateFilterType&#x60; parameter. | (optional) defaults to undefined|
 | **dateFilterType** | [**&#39;createdAt&#39; | &#39;updatedAt&#39; | &#39;statusChangedAt&#39;**]**Array<&#39;createdAt&#39; &#124; &#39;updatedAt&#39; &#124; &#39;statusChangedAt&#39;>** | Specifies the type of date range filter to apply. Determines which date field the &#x60;start&#x60; and &#x60;end&#x60; fields should query. | (optional) defaults to 'createdAt'|
 
 
@@ -472,6 +473,65 @@ const { status, data } = await apiInstance.getOrders(
 
 [[Back to top]](#) [[Back to API list]](../README.md#documentation-for-api-endpoints) [[Back to Model list]](../README.md#documentation-for-models) [[Back to README]](../README.md)
 
+# **importOrders**
+> ImportOrders202Response importOrders()
+
+Initiates an order import from a CSV file. The import is processed asynchronously.
+
+### Example
+
+```typescript
+import {
+    OrdersApi,
+    Configuration
+} from '@teemill/orders';
+
+const configuration = new Configuration();
+const apiInstance = new OrdersApi(configuration);
+
+let project: string; //The project identifier to scope the request to. (default to undefined)
+let file: File; //CSV file containing order data (default to undefined)
+
+const { status, data } = await apiInstance.importOrders(
+    project,
+    file
+);
+```
+
+### Parameters
+
+|Name | Type | Description  | Notes|
+|------------- | ------------- | ------------- | -------------|
+| **project** | [**string**] | The project identifier to scope the request to. | defaults to undefined|
+| **file** | [**File**] | CSV file containing order data | defaults to undefined|
+
+
+### Return type
+
+**ImportOrders202Response**
+
+### Authorization
+
+[session-oauth](../README.md#session-oauth), [api-key](../README.md#api-key)
+
+### HTTP request headers
+
+ - **Content-Type**: multipart/form-data
+ - **Accept**: application/json
+
+
+### HTTP response details
+| Status code | Description | Response headers |
+|-------------|-------------|------------------|
+|**202** | CSV file was accepted; orders will be imported asynchronously. |  -  |
+|**400** | Failed validation |  -  |
+|**401** | Not authorised to access this resource |  -  |
+|**403** | Refuse to authorize |  -  |
+|**404** | Resource not found |  -  |
+|**500** | Unknown server error |  -  |
+
+[[Back to top]](#) [[Back to API list]](../README.md#documentation-for-api-endpoints) [[Back to Model list]](../README.md#documentation-for-models) [[Back to README]](../README.md)
+
 # **retryPlatformPayment**
 > Order retryPlatformPayment()
 
@@ -488,7 +548,7 @@ import {
 const configuration = new Configuration();
 const apiInstance = new OrdersApi(configuration);
 
-let project: string; //What project it is (default to undefined)
+let project: string; //The project identifier to scope the request to. (default to undefined)
 let orderId: string; //Unique identifier of an order (default to undefined)
 let fields: string; //Specifies which fields to return, separated by commas (optional) (default to undefined)
 
@@ -503,7 +563,7 @@ const { status, data } = await apiInstance.retryPlatformPayment(
 
 |Name | Type | Description  | Notes|
 |------------- | ------------- | ------------- | -------------|
-| **project** | [**string**] | What project it is | defaults to undefined|
+| **project** | [**string**] | The project identifier to scope the request to. | defaults to undefined|
 | **orderId** | [**string**] | Unique identifier of an order | defaults to undefined|
 | **fields** | [**string**] | Specifies which fields to return, separated by commas | (optional) defaults to undefined|
 

package/docs/Origin.md

@@ -1,12 +1,13 @@
 # Origin
 
+The marketing or acquisition source of the order, such as `facebook_cpc`, `google_cpc`, or `organic`.
 
 ## Properties
 
 Name | Type | Description | Notes
 ------------ | ------------- | ------------- | -------------
-**code** | **string** |  | [optional] [default to undefined]
-**isPaid** | **boolean** |  | [optional] [default to undefined]
+**code** | **string** | A short identifier for the acquisition source, such as `facebook_cpc`, `google_cpc`, `instagram_cpc`, or `organic`. | [optional] [default to undefined]
+**isPaid** | **boolean** | Whether this origin represents paid advertising traffic. | [optional] [default to undefined]
 
 ## Example
 

package/docs/PaymentAttempt.md

@@ -1,15 +1,14 @@
 # PaymentAttempt
 
-List of payment attempts for this order
 
 ## Properties
 
 Name | Type | Description | Notes
 ------------ | ------------- | ------------- | -------------
-**paymentProvider** | **string** |  | [optional] [default to undefined]
-**status** | **string** |  | [optional] [default to undefined]
-**transactionId** | **string** |  | [optional] [default to undefined]
-**message** | **string** |  | [optional] [default to undefined]
+**paymentProvider** | **string** | The payment provider used. | [optional] [default to undefined]
+**status** | **string** | The outcome of the payment attempt. | [optional] [default to undefined]
+**transactionId** | **string** | The transaction ID from the payment provider. | [optional] [default to undefined]
+**message** | **string** | A human-readable message describing the payment result. | [optional] [default to undefined]
 **createdAt** | **string** | ISO 8601 Timestamp | [optional] [default to undefined]
 
 ## Example