MULTIPRODUCTO - Bemovil

Descripción General

Permite ver la información de productos incluye validaciones previas, formularios dinámicos y que pueden incluir subproductos (paquetes, planes u ofertas específicas). Esto garantiza que las transacciones se realicen dentro de reglas definidas, evitando errores y mejorando la experiencia del cliente.

Validaciones de Productos

Productos tienen ciertas validaciones previas:

"validations": {
  "minAmount": 2000,                 // Valor mínimo permitido
  "maxAmount": 500000,               // Valor máximo permitido
  "sameReferenceQuantity": 3,        // Límite de cantidad por referencia
  "sameReferenceEachMinutes": 360,   // Restricción de tiempo (en minutos) para repetir la misma referencia
  "availableTime": {                 
    "start": "06:00",                // Hora inicial habilitada para transaccionar
    "end": "20:00"                   // Hora final habilitada
  }
}

📌 Ejemplo:

Un producto no puede venderse fuera del rango horario 06:00–20:00.

No se puede vender más de 3 veces a la misma referencia en un periodo de 360 minutos.

Formulario

Cada producto expone un formulario en el atributo form.inputs. Estos campos son los que el integrador debe mostrar al usuario final para poder completar la transacción. form.inputs

"form": {
  "button": "Vender recarga",
  "inputs": [
    {
      "type": "cellphone",
      "label": "Celular del cliente",
      "name": "customerCellphone",  // Campo que se envía en la petición de transacción
      "icon": "cellphone",
      "required": true              // Indica si es obligatorio
    }
  ]
}

📌 Notas:

El button define el texto que se mostrará en el botón de acción.

Los inputs pueden variar según el producto (ejemplo: correo electrónico, documento de identidad, número de referencia, etc.).

Imágenes en la plataforma

La plataforma permite obtener imágenes asociadas tanto a categorías como a productos.
Categorías: Categories.image
Productos: Products.image

⚠️ Nota importante:
El valor almacenado en estos campos corresponde únicamente a la ruta relativa de la imagen.
Para acceder a la imagen de forma pública, es necesario concatenar la URL base:

  https://bemovil.net + [ruta de la imagen]

Ejemplo

Si en la base de datos el campo image contiene la ruta:

 /images/claro.png

La URL completa para visualizar la imagen será:

 https://bemovil.net/images/claro.png

Productos con subproductos

Algunos productos pueden tener subproductos, que representan diferentes planes, paquetes u opciones comerciales disponibles.
Estos se encuentran dentro de Categories.Products.

Como se muestra en la siguiente captura el producto PLAY STATION tiene dos subproductos a escoger

En el JSON de respuesta vendria especificado en Categories.Products el id escogido es el que debe enviar en la transacción

"Categories": [
                {
                    "id": 3000,
                    "name": "Xbox store",
                    "Products": [
                        {
                            "id": 104001,
                            "name": "Xbox Store",
                            "description": "Venta de pines Xbox",
                            "price": 30000,
                            "earnings": null,
                            "incentive": 0,
                            "sort": 6,
                            "options": {}
                        },
                        {
                            "id": 104002,
                            "name": "Xbox Store",
                            "description": "Venta de pines Xbox",
                            "price": 55000,
                            "earnings": null,
                            "incentive": 0,
                            "sort": 6,
                            "options": {}
                        },
                        {
                            "id": 104003,
                            "name": "Xbox Store",
                            "description": "Venta de pines Xbox",
                            "price": 100000,
                            "earnings": null,
                            "incentive": 0,
                            "sort": 6,
                            "options": {}
                        },
                        {
                            "id": 104004,
                            "name": "Xbox Store",
                            "description": "Venta de pines Xbox",
                            "price": 150000,
                            "earnings": null,
                            "incentive": 0,
                            "sort": 6,
                            "options": {}
                        }
                    ]
                },
                {
                    "id": 3001,
                    "name": "Xbox live gold",
                    "Products": [
                        {
                            "id": 105001,
                            "name": "Pin Xbox Game Pass Ultimate",
                            "description": "1 mes",
                            "price": 33900,
                            "earnings": null,
                            "incentive": 0,
                            "sort": 6,
                            "options": {}
                        },
                        {
                            "id": 105002,
                            "name": "Pin Virtual Xbox",
                            "description": "3 meses",
                            "price": 53900,
                            "earnings": null,
                            "incentive": 0,
                            "sort": 6,
                            "options": {}
                        },
                        {
                            "id": 105005,
                            "name": "Xbox Live Gold ",
                            "description": "12 meses",
                            "price": 150900,
                            "earnings": null,
                            "incentive": 0,
                            "sort": 6,
                            "options": {}
                        }
                    ]
                }
            ],

📌 Interpretación:

El producto “Xbox Store” tiene varias opciones (subproductos) que corresponden a diferentes montos de recarga.

El producto “Xbox Live Gold” permite elegir entre planes de 1 mes, 3 meses o 12 meses.

Precios referenciales

En algunos casos productos ya vienen con precio definidos solo para que el cliente final los escoja, en form.Inputs, en amount array defaultValues:

"inputs": [
            {
                "type": "text",
                "label": "Número del decodificador",
                "name": "customerCellphone",
                "icon": "cellphone",
                "required": true
            },
            {
                "type": "amount",
                "label": "Valor",
                "name": "amount",
                "icon": "price",
                "required": true,
                "defaultValues": [
                    10000,
                    20000,
                    30000,
                    50000,
                    70000,
                    100000
                ]
            }
        ]

🔑 Puntos Clave

Cada producto puede definir validaciones personalizadas para asegurar consistencia.

El formulario dinámico define los campos necesarios para completar la transacción.

Los subproductos permiten que un mismo producto tenga distintas presentaciones (montos, duración, etc.)