@thorprovider/types 5.6.0 → 5.6.2

package/dist/index.d.mts

@@ -4558,6 +4558,76 @@ interface DropshipperShippingMethod {
     shipping_profile_id?: string;
     stock_location_id?: string;
 }
+/** An outbound item added to the order by an exchange or a claim */
+interface DropshipperOrderChangeItem {
+    /** Id of the added order line item (order_item.id) */
+    item_id: string;
+    quantity: number;
+    note?: string | null;
+}
+/** An inbound claim item (what is being returned under the claim) */
+interface DropshipperClaimItem extends DropshipperOrderChangeItem {
+    reason?: string | null;
+}
+/** An exchange on an order (read-only; created and managed by the provider) */
+interface DropshipperOrderExchange {
+    id: string;
+    display_id: number;
+    /** Live state of the linked order change (pending, confirmed, canceled, ...) */
+    status: string;
+    difference_due: number;
+    created_at: string;
+    canceled_at: string | null;
+    /** Return associated with the exchange inbound items, when present */
+    return_id?: string | null;
+    additional_items: DropshipperOrderChangeItem[];
+}
+/** A claim on an order (read-only; created and managed by the provider) */
+interface DropshipperOrderClaim {
+    id: string;
+    display_id: number;
+    type: 'refund' | 'replace';
+    /** Live state of the linked order change (pending, confirmed, canceled, ...) */
+    status: string;
+    refund_amount: number;
+    created_at: string;
+    canceled_at: string | null;
+    /** Outbound items added by the claim (replacement items) */
+    additional_items: DropshipperOrderChangeItem[];
+    /** Inbound items being claimed */
+    items: DropshipperClaimItem[];
+}
+/** An item shipped as part of a fulfillment */
+interface DropshipperFulfillmentItem {
+    /** Order line item id this fulfillment item was created from */
+    item_id: string | null;
+    title: string;
+    sku: string | null;
+    quantity: number;
+}
+/** A shipping label attached to a fulfillment */
+interface DropshipperFulfillmentLabel {
+    id: string;
+    tracking_number: string | null;
+    tracking_url: string | null;
+    label_url: string | null;
+}
+/** A fulfillment on an order (read-only; the dropshipper does not manage shipments) */
+interface DropshipperOrderFulfillment {
+    id: string;
+    /** Computed from dates: pending, packed, shipped, delivered, canceled */
+    status: string;
+    created_at: string | null;
+    packed_at: string | null;
+    shipped_at: string | null;
+    delivered_at: string | null;
+    canceled_at: string | null;
+    provider_id: string | null;
+    /** Name of the stock location the fulfillment ships from, when resolvable */
+    location_name: string | null;
+    items: DropshipperFulfillmentItem[];
+    labels: DropshipperFulfillmentLabel[];
+}
 /** Full order detail as returned by GET /admin/thor/dropshipper/orders/:id */
 interface DropshipperOrderDetail {
     id: string;
@@ -4579,6 +4649,12 @@ interface DropshipperOrderDetail {
     shipping_methods: DropshipperShippingMethod[];
     payment_collections: DropshipperPaymentCollection[];
     returns: DropshipperReturn[];
+    /** Exchanges on the order, read-only (contract v3, optional) */
+    exchanges?: DropshipperOrderExchange[];
+    /** Claims on the order, read-only (contract v3, optional) */
+    claims?: DropshipperOrderClaim[];
+    /** Fulfillments on the order, read-only (optional) */
+    fulfillments?: DropshipperOrderFulfillment[];
     transactions: DropshipperTransaction[];
     financial_summary: DropshipperFinancialSummary;
     timeline: DropshipperOrderTimelineEvent[];

package/dist/index.d.ts

@@ -4558,6 +4558,76 @@ interface DropshipperShippingMethod {
     shipping_profile_id?: string;
     stock_location_id?: string;
 }
+/** An outbound item added to the order by an exchange or a claim */
+interface DropshipperOrderChangeItem {
+    /** Id of the added order line item (order_item.id) */
+    item_id: string;
+    quantity: number;
+    note?: string | null;
+}
+/** An inbound claim item (what is being returned under the claim) */
+interface DropshipperClaimItem extends DropshipperOrderChangeItem {
+    reason?: string | null;
+}
+/** An exchange on an order (read-only; created and managed by the provider) */
+interface DropshipperOrderExchange {
+    id: string;
+    display_id: number;
+    /** Live state of the linked order change (pending, confirmed, canceled, ...) */
+    status: string;
+    difference_due: number;
+    created_at: string;
+    canceled_at: string | null;
+    /** Return associated with the exchange inbound items, when present */
+    return_id?: string | null;
+    additional_items: DropshipperOrderChangeItem[];
+}
+/** A claim on an order (read-only; created and managed by the provider) */
+interface DropshipperOrderClaim {
+    id: string;
+    display_id: number;
+    type: 'refund' | 'replace';
+    /** Live state of the linked order change (pending, confirmed, canceled, ...) */
+    status: string;
+    refund_amount: number;
+    created_at: string;
+    canceled_at: string | null;
+    /** Outbound items added by the claim (replacement items) */
+    additional_items: DropshipperOrderChangeItem[];
+    /** Inbound items being claimed */
+    items: DropshipperClaimItem[];
+}
+/** An item shipped as part of a fulfillment */
+interface DropshipperFulfillmentItem {
+    /** Order line item id this fulfillment item was created from */
+    item_id: string | null;
+    title: string;
+    sku: string | null;
+    quantity: number;
+}
+/** A shipping label attached to a fulfillment */
+interface DropshipperFulfillmentLabel {
+    id: string;
+    tracking_number: string | null;
+    tracking_url: string | null;
+    label_url: string | null;
+}
+/** A fulfillment on an order (read-only; the dropshipper does not manage shipments) */
+interface DropshipperOrderFulfillment {
+    id: string;
+    /** Computed from dates: pending, packed, shipped, delivered, canceled */
+    status: string;
+    created_at: string | null;
+    packed_at: string | null;
+    shipped_at: string | null;
+    delivered_at: string | null;
+    canceled_at: string | null;
+    provider_id: string | null;
+    /** Name of the stock location the fulfillment ships from, when resolvable */
+    location_name: string | null;
+    items: DropshipperFulfillmentItem[];
+    labels: DropshipperFulfillmentLabel[];
+}
 /** Full order detail as returned by GET /admin/thor/dropshipper/orders/:id */
 interface DropshipperOrderDetail {
     id: string;
@@ -4579,6 +4649,12 @@ interface DropshipperOrderDetail {
     shipping_methods: DropshipperShippingMethod[];
     payment_collections: DropshipperPaymentCollection[];
     returns: DropshipperReturn[];
+    /** Exchanges on the order, read-only (contract v3, optional) */
+    exchanges?: DropshipperOrderExchange[];
+    /** Claims on the order, read-only (contract v3, optional) */
+    claims?: DropshipperOrderClaim[];
+    /** Fulfillments on the order, read-only (optional) */
+    fulfillments?: DropshipperOrderFulfillment[];
     transactions: DropshipperTransaction[];
     financial_summary: DropshipperFinancialSummary;
     timeline: DropshipperOrderTimelineEvent[];

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@thorprovider/types",
-  "version": "5.6.0",
+  "version": "5.6.2",
   "description": "Shared TypeScript types for Thor Commerce ecosystem - Framework-agnostic type definitions",
   "main": "dist/index.js",
   "types": "dist/index.d.ts",

package/src/admin/DropshippingAdmin.ts

@@ -792,6 +792,83 @@ export interface DropshipperShippingMethod {
   stock_location_id?: string;
 }
 
+/** An outbound item added to the order by an exchange or a claim */
+export interface DropshipperOrderChangeItem {
+  /** Id of the added order line item (order_item.id) */
+  item_id: string;
+  quantity: number;
+  note?: string | null;
+}
+
+/** An inbound claim item (what is being returned under the claim) */
+export interface DropshipperClaimItem extends DropshipperOrderChangeItem {
+  reason?: string | null;
+}
+
+/** An exchange on an order (read-only; created and managed by the provider) */
+export interface DropshipperOrderExchange {
+  id: string;
+  display_id: number;
+  /** Live state of the linked order change (pending, confirmed, canceled, ...) */
+  status: string;
+  difference_due: number;
+  created_at: string;
+  canceled_at: string | null;
+  /** Return associated with the exchange inbound items, when present */
+  return_id?: string | null;
+  additional_items: DropshipperOrderChangeItem[];
+}
+
+/** A claim on an order (read-only; created and managed by the provider) */
+export interface DropshipperOrderClaim {
+  id: string;
+  display_id: number;
+  type: 'refund' | 'replace';
+  /** Live state of the linked order change (pending, confirmed, canceled, ...) */
+  status: string;
+  refund_amount: number;
+  created_at: string;
+  canceled_at: string | null;
+  /** Outbound items added by the claim (replacement items) */
+  additional_items: DropshipperOrderChangeItem[];
+  /** Inbound items being claimed */
+  items: DropshipperClaimItem[];
+}
+
+/** An item shipped as part of a fulfillment */
+export interface DropshipperFulfillmentItem {
+  /** Order line item id this fulfillment item was created from */
+  item_id: string | null;
+  title: string;
+  sku: string | null;
+  quantity: number;
+}
+
+/** A shipping label attached to a fulfillment */
+export interface DropshipperFulfillmentLabel {
+  id: string;
+  tracking_number: string | null;
+  tracking_url: string | null;
+  label_url: string | null;
+}
+
+/** A fulfillment on an order (read-only; the dropshipper does not manage shipments) */
+export interface DropshipperOrderFulfillment {
+  id: string;
+  /** Computed from dates: pending, packed, shipped, delivered, canceled */
+  status: string;
+  created_at: string | null;
+  packed_at: string | null;
+  shipped_at: string | null;
+  delivered_at: string | null;
+  canceled_at: string | null;
+  provider_id: string | null;
+  /** Name of the stock location the fulfillment ships from, when resolvable */
+  location_name: string | null;
+  items: DropshipperFulfillmentItem[];
+  labels: DropshipperFulfillmentLabel[];
+}
+
 /** Full order detail as returned by GET /admin/thor/dropshipper/orders/:id */
 export interface DropshipperOrderDetail {
   id: string;
@@ -811,6 +888,12 @@ export interface DropshipperOrderDetail {
   shipping_methods: DropshipperShippingMethod[];
   payment_collections: DropshipperPaymentCollection[];
   returns: DropshipperReturn[];
+  /** Exchanges on the order, read-only (contract v3, optional) */
+  exchanges?: DropshipperOrderExchange[];
+  /** Claims on the order, read-only (contract v3, optional) */
+  claims?: DropshipperOrderClaim[];
+  /** Fulfillments on the order, read-only (optional) */
+  fulfillments?: DropshipperOrderFulfillment[];
   transactions: DropshipperTransaction[];
   financial_summary: DropshipperFinancialSummary;
   timeline: DropshipperOrderTimelineEvent[];