Pide el listado de productos, opcionalmente el que podría comprar desde el shopping de una PC, se usa el nombre de una PC para saber en cual número de local está presente y en cual zona, y por lo tanto solo devuelve los stocks que hay existente en dicho número de local (soporte a servidor multi-local), y lo vendible en la zona activa de dicha PC (recuerde que cada PC usa dos nombres de zona, una para la modalidad sin cuenta, y otra con cuenta).
Si no se especifica una ubicación de PC, es decir, como cuando la compra se hace de forma ONLINE vía un celular, esta función devolverá el catálogo disponible del local configurado en OnlineShoppingAttendedByLocalNumber (configurado en el servidor en la sección “Artículos y/o servicios en venta), que indica, cual local se hará cargo de las compras online presumiblemente desde fuera de un establecimiento. También, todos los productos que sean para una zona de PCs en específico no aparecerán cuando es una compra online remota, ya que solo listará los productos que no filtren según zona de compra.
En el caso de que la PC esté aún deshabilitada, si le has proveído un Sesion TokenID válido, el sistema listará según la zona con cuenta de la PC, porque permite que uses tu cuenta para realizar la compra, aún desde antes de habilitar la PC.
También, solo se listan los productos cuya existencia hay en stock y están habilitados en su configuración que son comprables desde el shopping por el cliente.
Minimum version for the target server required: v17.5.0.
Input parameters:
- CommandClass =_GETSHOPPINGPRODUCTS
- Param1 = target CyberName.
- Param2 = Opcional: PCNameID + ASCI(1) + PCToken.
- Param3 = Opcional: Session TokenID.
- Param4 = Opcional: SearchReason + ASCI(1) + CategoryFilter + ASCI(1) + StartIndex (1 = first).
Output:
[{“ResponseClass”: “ERROR”, “Param1”: “message”, … }]
[{“ResponseClass”: “LIST”,”Param1″:”ShortCode”,”Param2″:”Detalle”,”Param3″:”Precio final + null + MCOINS”,”Param4″:”ProductConfig”}]
[{“ResponseClass”: “OK”}]
Recuerde que para poder mostrar el precio correcto de cada producto debe aplicarle las políticas y el descuento según la categoría de cuenta cliente, ese factor de descuento se obtiene desde CommandClass _GETSHOPPINGPOLITICS. Ya que los precios aquí listados son los precios sin descuento según el tipo o categoría de cliente. Esto le permite mostrar el precio original tachado y mostrar el precio con descuento que pagaría el cliente al mismo tiempo siempre que las políticas configuradas en el servidor lo permitan.
Precio y MCoins está separado por un caracter null, el cliente solo podrá comprar un producto de forma directa e instantánea con MCOINS si el producto tiene precio mayor a cero en MCOINS, si es cero o menor que cero significa que no es comprable. Los descuentos por categoría de cuenta NO se aplican a la compra con MCOINS, el cual siempre valdrá el precio indicado en cada producto.
Donde “ProductConfig” es un string separado por caracteres null.
Código de barras + Null + SubComponentes + Null + ImageAvatar + Null + Nombre de categoría
- Los SubComponentes son una lista de ShortCodes separados por comas, que también se venderán si se vende el producto principal (soporte a bundling / empaquetados). Es sólo a título ilustrativo y el precio del producto principal ya incluye sumados el precio de todos los sub-productos del bundle. Si es un bundle, esta función también indicará el precio de todo el bundle (sumando todos los MCOINS parciales).
Example of usage:
Pide la lista de productos comprables para la PC01 según lo filtrado, y a partir del primer resultado posible. Solo mostrará hasta 20 productos, una posterior llamada, debería pedir a partir del producto número 21 y así.