@thorprovider/types 5.7.2 → 5.7.4

package/dist/index.d.mts

@@ -4552,6 +4552,14 @@ interface DropshipperFinancialSummary {
     original_order_total: number;
     transaction_total: number;
     accounting_total: number;
+    /** Valores reconciliados por el backend: incorpora las capturas de Medusa
+     *  (`paid_total`) y los cobros confirmados por el dropshipper fuera del
+     *  backend (`metadata.paid_amount`). `paid_amount` nunca supera `paid_total`,
+     *  por lo que `effective.paid_total = max(paid_total, paid_amount)`. */
+    effective: {
+        paid_total: number;
+        pending_difference: number;
+    };
 }
 /** Pickup location */
 interface DropshipperPickupLocation {
@@ -4582,6 +4590,12 @@ interface DropshipperShippingMethod {
     products?: string[];
     shipping_profile_id?: string;
     stock_location_id?: string;
+    /** Creation date of the shipping method (for ordering in the breakdown). */
+    created_at?: string | null;
+    /** The order-shipping link; return_id set when the method belongs to a return. */
+    detail?: {
+        return_id?: string | null;
+    } | null;
 }
 /** An outbound item added to the order by an exchange or a claim */
 interface DropshipperOrderChangeItem {
@@ -4617,6 +4631,8 @@ interface DropshipperOrderClaim {
     refund_amount: number;
     created_at: string;
     canceled_at: string | null;
+    /** Return with the inbound items being claimed, when the claim returns product */
+    return_id?: string | null;
     /** Outbound items added by the claim (replacement items) */
     additional_items: DropshipperOrderChangeItem[];
     /** Inbound items being claimed */
@@ -4658,11 +4674,11 @@ interface DropshipperOrderFulfillment {
  *
  * All monetary fields across the payload (order totals, items, shipping
  * methods, payment collections, returns, exchanges/claims, transactions,
- * financial summary, timeline `amount`) are expressed in MINOR units of the
- * order's `currency_code` (e.g. cents for two-decimal currencies; the raw
- * integer for zero-decimal currencies such as JPY). Consumers must NOT apply
- * a fixed `/100`; divide by `10^minorDigits(currencyCode)` only at the
- * presentation boundary.
+ * financial summary, timeline `amount`) are expressed in MAJOR units of the
+ * order's `currency_code` (e.g. USD 180 for `180`). Consumers render the
+ * values directly with their currency formatter and must NOT apply any
+ * `/100` or `10^minorDigits` conversion. (The catalog/pricing layer keeps
+ * its own scale — that exception does not apply to this contract.)
  */
 interface DropshipperOrderDetail {
     id: string;

package/dist/index.d.ts

@@ -4552,6 +4552,14 @@ interface DropshipperFinancialSummary {
     original_order_total: number;
     transaction_total: number;
     accounting_total: number;
+    /** Valores reconciliados por el backend: incorpora las capturas de Medusa
+     *  (`paid_total`) y los cobros confirmados por el dropshipper fuera del
+     *  backend (`metadata.paid_amount`). `paid_amount` nunca supera `paid_total`,
+     *  por lo que `effective.paid_total = max(paid_total, paid_amount)`. */
+    effective: {
+        paid_total: number;
+        pending_difference: number;
+    };
 }
 /** Pickup location */
 interface DropshipperPickupLocation {
@@ -4582,6 +4590,12 @@ interface DropshipperShippingMethod {
     products?: string[];
     shipping_profile_id?: string;
     stock_location_id?: string;
+    /** Creation date of the shipping method (for ordering in the breakdown). */
+    created_at?: string | null;
+    /** The order-shipping link; return_id set when the method belongs to a return. */
+    detail?: {
+        return_id?: string | null;
+    } | null;
 }
 /** An outbound item added to the order by an exchange or a claim */
 interface DropshipperOrderChangeItem {
@@ -4617,6 +4631,8 @@ interface DropshipperOrderClaim {
     refund_amount: number;
     created_at: string;
     canceled_at: string | null;
+    /** Return with the inbound items being claimed, when the claim returns product */
+    return_id?: string | null;
     /** Outbound items added by the claim (replacement items) */
     additional_items: DropshipperOrderChangeItem[];
     /** Inbound items being claimed */
@@ -4658,11 +4674,11 @@ interface DropshipperOrderFulfillment {
  *
  * All monetary fields across the payload (order totals, items, shipping
  * methods, payment collections, returns, exchanges/claims, transactions,
- * financial summary, timeline `amount`) are expressed in MINOR units of the
- * order's `currency_code` (e.g. cents for two-decimal currencies; the raw
- * integer for zero-decimal currencies such as JPY). Consumers must NOT apply
- * a fixed `/100`; divide by `10^minorDigits(currencyCode)` only at the
- * presentation boundary.
+ * financial summary, timeline `amount`) are expressed in MAJOR units of the
+ * order's `currency_code` (e.g. USD 180 for `180`). Consumers render the
+ * values directly with their currency formatter and must NOT apply any
+ * `/100` or `10^minorDigits` conversion. (The catalog/pricing layer keeps
+ * its own scale — that exception does not apply to this contract.)
  */
 interface DropshipperOrderDetail {
     id: string;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@thorprovider/types",
-  "version": "5.7.2",
+  "version": "5.7.4",
   "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

@@ -778,6 +778,14 @@ export interface DropshipperFinancialSummary {
   original_order_total: number;
   transaction_total: number;
   accounting_total: number;
+  /** Valores reconciliados por el backend: incorpora las capturas de Medusa
+   *  (`paid_total`) y los cobros confirmados por el dropshipper fuera del
+   *  backend (`metadata.paid_amount`). `paid_amount` nunca supera `paid_total`,
+   *  por lo que `effective.paid_total = max(paid_total, paid_amount)`. */
+  effective: {
+    paid_total: number;
+    pending_difference: number;
+  };
 }
 
 /** Pickup location */
@@ -810,6 +818,10 @@ export interface DropshipperShippingMethod {
   products?: string[];
   shipping_profile_id?: string;
   stock_location_id?: string;
+  /** Creation date of the shipping method (for ordering in the breakdown). */
+  created_at?: string | null;
+  /** The order-shipping link; return_id set when the method belongs to a return. */
+  detail?: { return_id?: string | null } | null;
 }
 
 /** An outbound item added to the order by an exchange or a claim */
@@ -849,6 +861,8 @@ export interface DropshipperOrderClaim {
   refund_amount: number;
   created_at: string;
   canceled_at: string | null;
+  /** Return with the inbound items being claimed, when the claim returns product */
+  return_id?: string | null;
   /** Outbound items added by the claim (replacement items) */
   additional_items: DropshipperOrderChangeItem[];
   /** Inbound items being claimed */
@@ -894,11 +908,11 @@ export interface DropshipperOrderFulfillment {
  *
  * All monetary fields across the payload (order totals, items, shipping
  * methods, payment collections, returns, exchanges/claims, transactions,
- * financial summary, timeline `amount`) are expressed in MINOR units of the
- * order's `currency_code` (e.g. cents for two-decimal currencies; the raw
- * integer for zero-decimal currencies such as JPY). Consumers must NOT apply
- * a fixed `/100`; divide by `10^minorDigits(currencyCode)` only at the
- * presentation boundary.
+ * financial summary, timeline `amount`) are expressed in MAJOR units of the
+ * order's `currency_code` (e.g. USD 180 for `180`). Consumers render the
+ * values directly with their currency formatter and must NOT apply any
+ * `/100` or `10^minorDigits` conversion. (The catalog/pricing layer keeps
+ * its own scale — that exception does not apply to this contract.)
  */
 export interface DropshipperOrderDetail {
   id: string;