diff --git a/modules/customers/src/web/shared/hooks/keys.ts b/modules/customers/src/web/shared/hooks/keys.ts
index 2c28b4a6..2ca5ade1 100644
--- a/modules/customers/src/web/shared/hooks/keys.ts
+++ b/modules/customers/src/web/shared/hooks/keys.ts
@@ -2,7 +2,14 @@ import type { CriteriaDTO } from "@erp/core";
 import { INITIAL_PAGE_INDEX, INITIAL_PAGE_SIZE } from "@repo/rdx-criteria";
 import type { QueryKey } from "@tanstack/react-query";
 
+/**
+ * Prefijo base para listados
+ */
 export const LIST_CUSTOMERS_QUERY_KEY_PREFIX = ["customers"] as const;
+
+/**
+ * Query key para listado de customers
+ */
 export const LIST_CUSTOMERS_QUERY_KEY = (criteria?: CriteriaDTO): QueryKey =>
   [
     ...LIST_CUSTOMERS_QUERY_KEY_PREFIX,
@@ -16,15 +23,18 @@ export const LIST_CUSTOMERS_QUERY_KEY = (criteria?: CriteriaDTO): QueryKey =>
     },
   ] as const;
 
+/**
+ * Query key para detalle de customer
+ */
+export const CUSTOMERS_DETAIL_QUERY_KEY_PREFIX = ["customers:detail"] as const;
 export const CUSTOMER_QUERY_KEY = (customerId?: string): QueryKey => [
-  "customers:detail",
-  {
-    customerId,
-  },
+  ...CUSTOMERS_DETAIL_QUERY_KEY_PREFIX,
+  { customerId },
 ];
 
-export const CUSTOMER_CREATE_KEY = ["customers", "create"] as const;
-
-export const CUSTOMER_UPDATE_KEY = ["customers", "update"] as const;
-
-export const CUSTOMER_DELETE_KEY = ["customers", "delete"] as const;
+/**
+ * Keys para mutaciones
+ */
+export const CUSTOMER_CREATE_KEY = ["customers:create"] as const;
+export const CUSTOMER_UPDATE_KEY = ["customers:update"] as const;
+export const CUSTOMER_DELETE_KEY = ["customers:delete"] as const;
diff --git a/modules/supplier/src/web/shared/hooks/keys.ts b/modules/supplier/src/web/shared/hooks/keys.ts
index ff88f028..a6f7efb2 100644
--- a/modules/supplier/src/web/shared/hooks/keys.ts
+++ b/modules/supplier/src/web/shared/hooks/keys.ts
@@ -2,8 +2,14 @@ import type { CriteriaDTO } from "@erp/core";
 import { INITIAL_PAGE_INDEX, INITIAL_PAGE_SIZE } from "@repo/rdx-criteria";
 import type { QueryKey } from "@tanstack/react-query";
 
+/**
+ * Prefijo base para listados
+ */
 export const LIST_SUPPLIERS_QUERY_KEY_PREFIX = ["suppliers"] as const;
 
+/**
+ * Query key para listado de suppliers
+ */
 export const LIST_SUPPLIERS_QUERY_KEY = (criteria?: CriteriaDTO): QueryKey =>
   [
     ...LIST_SUPPLIERS_QUERY_KEY_PREFIX,
@@ -17,13 +23,18 @@ export const LIST_SUPPLIERS_QUERY_KEY = (criteria?: CriteriaDTO): QueryKey =>
     },
   ] as const;
 
+/**
+ * Query key para detalle de customer
+ */
+export const SUPPLIERS_DETAIL_QUERY_KEY_PREFIX = ["suppliers:detail"] as const;
 export const SUPPLIER_QUERY_KEY = (supplierId?: string): QueryKey => [
-  "suppliers:detail",
-  {
-    supplierId,
-  },
+  ...SUPPLIERS_DETAIL_QUERY_KEY_PREFIX,
+  { supplierId },
 ];
 
-export const SUPPLIER_CREATE_KEY = ["suppliers", "create"] as const;
-export const SUPPLIER_UPDATE_KEY = ["suppliers", "update"] as const;
-export const SUPPLIER_DELETE_KEY = ["suppliers", "delete"] as const;
+/**
+ * Keys para mutaciones
+ */
+export const SUPPLIER_CREATE_KEY = ["suppliers:create"] as const;
+export const SUPPLIER_UPDATE_KEY = ["suppliers:update"] as const;
+export const SUPPLIER_DELETE_KEY = ["suppliers:delete"] as const;