getProductsPriceByPageUrl

Busca información sobre productos y precios para la categoría seleccionada.

Descripción

Este método busca información sobre productos y precios para la categoría seleccionada, basado en los parámetros de consulta proporcionados (userQuery). Devuelve una Promesa que se resuelve en un objeto IProductsInfo.

Products.getProductsPriceByPageUrl( url, langCode, userQuery );

Esquema de parámetros

Esquema

url: string
URL de la página
ejemplo: "23-laminat-floorwood-maxima"

langCode: string
Código de idioma. Por defecto: "en_US"
ejemplo: "en_US"

userQuery: IProductsPriceQuery
Conjunto de parámetros de consulta opcionales
ejemplo:

{
  "limit": 30,
  "offset": 0,
  "sortOrder": "DESC",
  "signPrice": "orders",
  "statusMarker": "in_stock"
}

userQuery.offset: number
Parámetro para paginación. Por defecto: 0.

userQuery.limit: number
Parámetro para paginación. Por defecto: 30.

userQuery.sortOrder: string
Orden de clasificación "DESC" | "ASC". Por defecto: "DESC".

userQuery.signPrice: string
Marcador de almacenamiento de pedidos para la fijación de precios.

userQuery.statusMarker: string | null
Marcador de estado de la página del producto, por defecto null.
ejemplo: "in_stock"

Por defecto, puedes recuperar 10 objetos. Esto se debe al límite de registros en la configuración de permisos del módulo.
Para que la paginación funcione correctamente, necesitas configurar Permisos del módulo de acuerdo a tus necesidades en la sección correspondiente.

💲 signPrice bloquea el precio devuelto por un tiempo limitado — configúralo con tu marcador de almacenamiento de pedidos. Consulta Fijación del precio (signPrice).

Ejemplos

Ejemplo mínimo

const response = await Products.getProductsPriceByPageUrl('catalog');

Ejemplo con atributos

const userQuery = {
  "offset": 0,
  "limit": 30,
  "statusMarker": "in_stock",
  "conditionValue": "new",
  "conditionMarker": "equals",
  "attributeMarker": "color",
  "sortOrder": "DESC",
  "sortKey": "id",
};

const response = await Products.getProductsPriceByPageUrl('catalog', 'en_US', userQuery);

Usa filtros para encontrar productos específicos:

attributeMarker: El identificador de texto del atributo indexado por el cual se filtran los valores. conditionMarker: El tipo de condición que se aplica al valor del atributo.

Marcador	Significado	Ejemplo
eq	Igual	statusId = 1 (solo activos)
neq	No igual	role ≠ "Viewer"
in	Contiene (uno de)	role in ["Editor", "Manager"]
nin	No contiene	email not in ["@temp.com"]
exs	Existe (tiene valor)	Tiene lastLogin
nexs	No existe	Nunca ha iniciado sesión
pat	Coincide con el patrón	el identificador coincide con "man"
same	Coincide exactamente con el valor	el identificador es exactamente "admin1"
same_part	Coincide con una parte del valor exactamente	parte del identificador es exactamente "adm"

conditionValue: El valor con el que comparar.

Ejemplo de respuesta

{
  "items": [
    {
      "id": 2960,
      "price": 180
    },
    {
      "id": 3445,
      "price": 150
    },
    {
      "id": 2957,
      "price": 150
    },
    "..."
  ],
  "total": 6
}

Esquema de respuesta

Esquema: IProductsInfo

total: number
El número total de productos encontrados.
ejemplo: 100

items: IProductInfo[]
Un array de objetos de información de productos.
ejemplo:

[
  {
    "id": 12345,
    "price": 150
  },
  {
    "id": 67890,
    "price": 200
  }
]

items.id: number
El identificador único del producto.
ejemplo: 12345

items.price: number
El precio del producto.
ejemplo: 150

items.signedPrice: string
El precio firmado (fijo) del producto, devuelto cuando signPrice está configurado.
ver: Precio fijo del producto
ejemplo: "eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9..."

---