@teemill/orders 1.26.0 → 1.28.2

package/docs/OrderImportCounts.md

@@ -0,0 +1,32 @@
+# OrderImportCounts
+
+
+## Properties
+
+Name | Type | Description | Notes
+------------ | ------------- | ------------- | -------------
+**total** | **number** |  | [default to undefined]
+**pending** | **number** |  | [default to undefined]
+**processing** | **number** |  | [default to undefined]
+**success** | **number** |  | [default to undefined]
+**failed** | **number** |  | [default to undefined]
+**cancelled** | **number** |  | [default to undefined]
+**completed** | **number** |  | [default to undefined]
+
+## Example
+
+```typescript
+import { OrderImportCounts } from '@teemill/orders';
+
+const instance: OrderImportCounts = {
+    total,
+    pending,
+    processing,
+    success,
+    failed,
+    cancelled,
+    completed,
+};
+```
+
+[[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/OrderImportError.md

@@ -0,0 +1,30 @@
+# OrderImportError
+
+
+## Properties
+
+Name | Type | Description | Notes
+------------ | ------------- | ------------- | -------------
+**code** | [**OrderImportErrorCode**](OrderImportErrorCode.md) |  | [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]
+**suggestedFix** | **string** | A human-readable suggestion for how to resolve the error. | [optional] [default to undefined]
+**referenceCode** | **string** | A unique reference code for this error occurrence, useful for support enquiries. | [optional] [default to undefined]
+
+## Example
+
+```typescript
+import { OrderImportError } from '@teemill/orders';
+
+const instance: OrderImportError = {
+    code,
+    message,
+    fieldPath,
+    sku,
+    suggestedFix,
+    referenceCode,
+};
+```
+
+[[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/OrderImportErrorCode.md

@@ -0,0 +1,17 @@
+# OrderImportErrorCode
+
+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 
+
+## Enum
+
+* `VariantNotFound` (value: `'VARIANT_NOT_FOUND'`)
+
+* `MissingSku` (value: `'MISSING_SKU'`)
+
+* `ShippingMethodUnavailable` (value: `'SHIPPING_METHOD_UNAVAILABLE'`)
+
+* `TransientSystemError` (value: `'TRANSIENT_SYSTEM_ERROR'`)
+
+* `ImportFailed` (value: `'IMPORT_FAILED'`)
+
+[[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/OrderImportGroup.md

@@ -0,0 +1,40 @@
+# OrderImportGroup
+
+
+## Properties
+
+Name | Type | Description | Notes
+------------ | ------------- | ------------- | -------------
+**id** | **string** | Unique object identifier | [default to undefined]
+**status** | [**OrderImportGroupStatus**](OrderImportGroupStatus.md) |  | [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]
+
+## Example
+
+```typescript
+import { OrderImportGroup } from '@teemill/orders';
+
+const instance: OrderImportGroup = {
+    id,
+    status,
+    merchantReference,
+    resultReference,
+    message,
+    rowsCount,
+    skus,
+    errors,
+    createdAt,
+    startedAt,
+    finishedAt,
+};
+```
+
+[[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/OrderImportGroupStatus.md

@@ -0,0 +1,17 @@
+# OrderImportGroupStatus
+
+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) 
+
+## Enum
+
+* `Pending` (value: `'pending'`)
+
+* `Processing` (value: `'processing'`)
+
+* `Success` (value: `'success'`)
+
+* `Failed` (value: `'failed'`)
+
+* `Cancelled` (value: `'cancelled'`)
+
+[[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/OrderImportGroupsResponse.md

@@ -0,0 +1,22 @@
+# OrderImportGroupsResponse
+
+
+## Properties
+
+Name | Type | Description | Notes
+------------ | ------------- | ------------- | -------------
+**groups** | [**Array<OrderImportGroup>**](OrderImportGroup.md) |  | [optional] [default to undefined]
+**nextPageToken** | **number** |  | [optional] [default to undefined]
+
+## Example
+
+```typescript
+import { OrderImportGroupsResponse } from '@teemill/orders';
+
+const instance: OrderImportGroupsResponse = {
+    groups,
+    nextPageToken,
+};
+```
+
+[[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/OrderImportStatus.md

@@ -0,0 +1,19 @@
+# OrderImportStatus
+
+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 
+
+## Enum
+
+* `Queued` (value: `'queued'`)
+
+* `Processing` (value: `'processing'`)
+
+* `CompletedSuccess` (value: `'completedSuccess'`)
+
+* `CompletedPartial` (value: `'completedPartial'`)
+
+* `CompletedFailed` (value: `'completedFailed'`)
+
+* `Cancelled` (value: `'cancelled'`)
+
+[[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/OrderImportsResponse.md

@@ -0,0 +1,22 @@
+# OrderImportsResponse
+
+
+## Properties
+
+Name | Type | Description | Notes
+------------ | ------------- | ------------- | -------------
+**imports** | [**Array<OrderImport>**](OrderImport.md) |  | [optional] [default to undefined]
+**nextPageToken** | **number** |  | [optional] [default to undefined]
+
+## Example
+
+```typescript
+import { OrderImportsResponse } from '@teemill/orders';
+
+const instance: OrderImportsResponse = {
+    imports,
+    nextPageToken,
+};
+```
+
+[[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/OrdersApi.md

@@ -10,8 +10,11 @@ All URIs are relative to *https://api.localhost:8080*
 |[**downloadInvoice**](#downloadinvoice) | **GET** /v1/orders/{orderId}/invoice | Download order invoice|
 |[**exportOrders**](#exportorders) | **GET** /v1/orders/export | Export orders|
 |[**getOrder**](#getorder) | **GET** /v1/orders/{orderId} | Get order|
+|[**getOrderImport**](#getorderimport) | **GET** /v1/orders/imports/{importId} | Get order import|
 |[**getOrders**](#getorders) | **GET** /v1/orders | List orders|
-|[**importOrders**](#importorders) | **POST** /v1/orders/import | Import orders|
+|[**importOrders**](#importorders) | **POST** /v1/orders/imports | Import orders|
+|[**listOrderImportGroups**](#listorderimportgroups) | **GET** /v1/orders/imports/{importId}/groups | List order import groups|
+|[**listOrderImports**](#listorderimports) | **GET** /v1/orders/imports | List order imports|
 |[**retryPlatformPayment**](#retryplatformpayment) | **POST** /v1/orders/{orderId}/retryPlatformPayment | Retry|
 
 # **cancelOrder**
@@ -283,12 +286,14 @@ let project: string; //The project identifier to scope the request to. (default
 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)
+let dateFilterType: 'createdAt' | 'updatedAt' | 'paidAt' | 'statusChangedAt' | 'completedAt' | 'refundedAt' | 'quoteAt'; //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.exportOrders(
     project,
     start,
     end,
-    search
+    search,
+    dateFilterType
 );
 ```
 
@@ -300,6 +305,7 @@ const { status, data } = await apiInstance.exportOrders(
 | **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|
+| **dateFilterType** | [**&#39;createdAt&#39; | &#39;updatedAt&#39; | &#39;paidAt&#39; | &#39;statusChangedAt&#39; | &#39;completedAt&#39; | &#39;refundedAt&#39; | &#39;quoteAt&#39;**]**Array<&#39;createdAt&#39; &#124; &#39;updatedAt&#39; &#124; &#39;paidAt&#39; &#124; &#39;statusChangedAt&#39; &#124; &#39;completedAt&#39; &#124; &#39;refundedAt&#39; &#124; &#39;quoteAt&#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'|
 
 
 ### Return type
@@ -391,6 +397,65 @@ const { status, data } = await apiInstance.getOrder(
 
 [[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)
 
+# **getOrderImport**
+> OrderImport getOrderImport()
+
+Gets the latest status and summary for an order import.
+
+### 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 importId: string; //Unique identifier of an order import (default to undefined)
+
+const { status, data } = await apiInstance.getOrderImport(
+    project,
+    importId
+);
+```
+
+### Parameters
+
+|Name | Type | Description  | Notes|
+|------------- | ------------- | ------------- | -------------|
+| **project** | [**string**] | The project identifier to scope the request to. | defaults to undefined|
+| **importId** | [**string**] | Unique identifier of an order import | defaults to undefined|
+
+
+### Return type
+
+**OrderImport**
+
+### Authorization
+
+[session-oauth](../README.md#session-oauth), [api-key](../README.md#api-key)
+
+### HTTP request headers
+
+ - **Content-Type**: Not defined
+ - **Accept**: application/json
+
+
+### HTTP response details
+| Status code | Description | Response headers |
+|-------------|-------------|------------------|
+|**200** | Summary status for a single order import. |  -  |
+|**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)
+
 # **getOrders**
 > OrdersResponse getOrders()
 
@@ -416,7 +481,7 @@ let ids: Array<string>; //Filter to specific order IDs. Only orders matching the
 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')
+let dateFilterType: 'createdAt' | 'updatedAt' | 'paidAt' | 'statusChangedAt' | 'completedAt' | 'refundedAt' | 'quoteAt'; //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(
     project,
@@ -445,7 +510,7 @@ const { status, data } = await apiInstance.getOrders(
 | **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'|
+| **dateFilterType** | [**&#39;createdAt&#39; | &#39;updatedAt&#39; | &#39;paidAt&#39; | &#39;statusChangedAt&#39; | &#39;completedAt&#39; | &#39;refundedAt&#39; | &#39;quoteAt&#39;**]**Array<&#39;createdAt&#39; &#124; &#39;updatedAt&#39; &#124; &#39;paidAt&#39; &#124; &#39;statusChangedAt&#39; &#124; &#39;completedAt&#39; &#124; &#39;refundedAt&#39; &#124; &#39;quoteAt&#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'|
 
 
 ### Return type
@@ -476,7 +541,7 @@ const { status, data } = await apiInstance.getOrders(
 # **importOrders**
 > ImportOrders202Response importOrders()
 
-Initiates an order import from a CSV file. The import is processed asynchronously.
+Initiates an order import from a CSV file. The import is processed asynchronously. Use the returned `importId` with the GET endpoints to track progress.
 
 ### Example
 
@@ -532,6 +597,132 @@ const { status, data } = await apiInstance.importOrders(
 
 [[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)
 
+# **listOrderImportGroups**
+> OrderImportGroupsResponse listOrderImportGroups()
+
+Lists group-level outcomes for a specific order import. Each group represents one order from the CSV (grouped by merchant reference).
+
+### 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 importId: string; //Unique identifier of an order import (default to undefined)
+let pageToken: number; //Page reference token (optional) (default to 1)
+let pageSize: number; //Max page size for import endpoints. This is the maximum that will be returned, but it might be smaller. (optional) (default to 25)
+
+const { status, data } = await apiInstance.listOrderImportGroups(
+    project,
+    importId,
+    pageToken,
+    pageSize
+);
+```
+
+### Parameters
+
+|Name | Type | Description  | Notes|
+|------------- | ------------- | ------------- | -------------|
+| **project** | [**string**] | The project identifier to scope the request to. | defaults to undefined|
+| **importId** | [**string**] | Unique identifier of an order import | defaults to undefined|
+| **pageToken** | [**number**] | Page reference token | (optional) defaults to 1|
+| **pageSize** | [**number**] | Max page size for import endpoints. This is the maximum that will be returned, but it might be smaller. | (optional) defaults to 25|
+
+
+### Return type
+
+**OrderImportGroupsResponse**
+
+### Authorization
+
+[session-oauth](../README.md#session-oauth), [api-key](../README.md#api-key)
+
+### HTTP request headers
+
+ - **Content-Type**: Not defined
+ - **Accept**: application/json
+
+
+### HTTP response details
+| Status code | Description | Response headers |
+|-------------|-------------|------------------|
+|**200** | Paginated group-level outcomes for an order import. |  -  |
+|**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)
+
+# **listOrderImports**
+> OrderImportsResponse listOrderImports()
+
+Lists recent order imports for this project, ordered by most recent first.
+
+### 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 pageToken: number; //Page reference token (optional) (default to 1)
+let pageSize: number; //Max page size for import endpoints. This is the maximum that will be returned, but it might be smaller. (optional) (default to 25)
+
+const { status, data } = await apiInstance.listOrderImports(
+    project,
+    pageToken,
+    pageSize
+);
+```
+
+### Parameters
+
+|Name | Type | Description  | Notes|
+|------------- | ------------- | ------------- | -------------|
+| **project** | [**string**] | The project identifier to scope the request to. | defaults to undefined|
+| **pageToken** | [**number**] | Page reference token | (optional) defaults to 1|
+| **pageSize** | [**number**] | Max page size for import endpoints. This is the maximum that will be returned, but it might be smaller. | (optional) defaults to 25|
+
+
+### Return type
+
+**OrderImportsResponse**
+
+### Authorization
+
+[session-oauth](../README.md#session-oauth), [api-key](../README.md#api-key)
+
+### HTTP request headers
+
+ - **Content-Type**: Not defined
+ - **Accept**: application/json
+
+
+### HTTP response details
+| Status code | Description | Response headers |
+|-------------|-------------|------------------|
+|**200** | Paginated list of order imports and their status summaries. |  -  |
+|**400** | Failed validation |  -  |
+|**401** | Not authorised to access this resource |  -  |
+|**403** | Refuse to authorize |  -  |
+|**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()
 

package/index.ts

@@ -1,10 +1,10 @@
 /* tslint:disable */
 /* eslint-disable */
 /**
- * Orders API
+ * 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.26.0
+ * The version of the OpenAPI document: 1.28.2
  * 
  *
  * NOTE: This class is auto generated by OpenAPI Generator (https://openapi-generator.tech).

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@teemill/orders",
-  "version": "1.26.0",
+  "version": "1.28.2",
   "description": "OpenAPI client for @teemill/orders",
   "author": "OpenAPI-Generator Contributors",
   "repository": {