Bienvenidos a la API REST de Blue Diamond Innovation

¡Bienvenidos! Esta API REST ha sido desarrollada por Blue Diamond Innovation para el Programa de Resellers, específicamente para el servicio de Integración Corporativa. Nuestra API ofrece una solución integral y segura para la gestión de datos y recursos de comercio electrónico, compartiendo información y servicios de Ingram Micro. Estos datos pueden ser utilizados por los clientes que contratan este servicio, facilitando la integración y el manejo de inventarios y pedidos en sus propias plataformas.

Modos de Servicio

Nuestra API ofrece dos modos de servicio para adaptarse a las necesidades de desarrollo y producción:

Modo Sandbox: Ideal para pruebas iniciales y desarrollo. Este modo permite a los usuarios probar y validar sus integraciones sin afectar los datos reales.
Testing: Solo disponible para Sandbox.

Modo Producción: Una vez completada la fase de pruebas, los clientes migrarán al modo de producción, donde las operaciones serán aplicadas a datos reales y utilizadas en el entorno final de sus plataformas.
Developing: Disponible para todo el desarrollo.

Pendiente: Servicios o endpoints que se encuentran en fase de implementación y aún no están disponibles para uso general.
Pending: En proceso de desarrollo.

Nota: Se recomienda utilizar el modo Sandbox al iniciar y asegurarse de que la integración esté funcionando correctamente antes de pasar al modo de producción.

Servicios Disponibles

1. Marcas

El servicio de Marcas permite a los usuarios acceder a la lista completa de marcas disponibles o consultar una marca específica mediante su ID.

Funcionalidades de Marcas

Obtener la lista completa de marcas.

Consultar información detallada de una marca específica usando el idMarca.

Filtrar marcas según criterios específicos.

Mantener un catálogo actualizado de fabricantes.

2. Categorías

La sección de Categorías organiza los productos en grupos específicos, facilitando la navegación y la búsqueda de productos para los usuarios. Se puede acceder a todas las categorías o consultar categorías específicas.

Funcionalidades de Categorías

Obtener la lista completa de categorías.

Consultar una categoría específica utilizando el idCategoria.

Acceso a subcategorías mediante el parent_id para una clasificación más precisa.

Organización jerárquica de productos según las necesidades del comercio.

3. Productos

El servicio de Productos permite acceder a la información detallada de los artículos en el catálogo de varias formas, además de ofrecer precios personalizados por cliente y datos en tiempo real.

Formas de Obtener Productos:

Lista Completa: Acceso a todos los productos disponibles en el catálogo.

Por IngramPartNumber: Consulta de un producto específico utilizando su número de parte único proporcionado por Ingram Micro.

Por Arreglo de IngramPartNumber: Búsqueda múltiple de productos especificando un arreglo de números de parte.

Funcionalidades de Productos

Consultar precios y disponibilidad de productos.

Obtener precios específicos por cliente, reflejando acuerdos personalizados.

Acceso en tiempo real a precios y cantidades disponibles.

Consultar especificaciones detalladas y descripciones.

Funciones de búsqueda y filtrado por atributos como marca, categoría y precio.

4. Imágenes

Imágenes es el servicio encargado de gestionar los archivos visuales asociados a los productos. Para proteger la seguridad de los datos, las imágenes son accesibles únicamente a través de URLs temporales generadas con un token de acceso.

Funcionalidades de Imágenes

URLs temporales protegidas con tokens de acceso.

Integración con un proxy que asegura que los datos se obtienen de forma controlada.

Evita el consumo indebido de recursos al limitar el acceso directo a la ubicación de almacenamiento.

5. Fichas Técnicas

Las Fichas Técnicas proporcionan especificaciones detalladas de cada producto y, al igual que las imágenes, están protegidas mediante URLs temporales con tokens de acceso.

Funcionalidades de Fichas Técnicas

Acceso a fichas técnicas a través de URLs temporales generadas con tokens.

Protección adicional mediante un proxy que filtra las solicitudes y entrega solo los datos necesarios.

Evita el consumo indebido de recursos al limitar el acceso directo a la ubicación de almacenamiento.

6. Estimador de Envío

El Estimador de Envío permite a los clientes calcular una estimación del costo de envío en función de los productos seleccionados y la ubicación del cliente final. Este servicio está disponible únicamente en modo Producción.

Funcionalidades del Estimador de Envío

Calcular el costo estimado de envío para un conjunto de productos.

Personalización de las estimaciones basadas en la dirección y ubicación del cliente final.

Integración en tiempo real para obtener tarifas actualizadas.

Proporciona una experiencia informada al cliente antes de completar su pedido.

7. Estado de Pedidos

El servicio de Estado de Pedidos y permite a los clientes consultar el estado de las órdenes enviadas.

Funcionalidades del Estado de Pedidos

Consultar el estado actual de una orden o pedido.

Acceso a actualizaciones en tiempo real del progreso de la orden.

Soporte para rastrear el flujo completo de una orden, desde su creación hasta su finalización.

Acceso Seguro con Token de Autenticación

Para utilizar estos servicios, los usuarios deben autenticarse con un token que obtienen mediante credenciales válidas. Este token tiene una validez de 24 horas, después de lo cual debe renovarse para continuar usando la API sin interrupciones.

Ventajas del Acceso con Token:
Seguridad: Garantiza que solo los usuarios autenticados puedan acceder a los datos.
Autorización Controlada: Permite acceso personalizado basado en permisos.
Eficiencia: Facilita el acceso durante 24 horas sin necesidad de autenticación continua.

Nota Importante

Las credenciales utilizadas para generar el token de acceso son globales para ambos modos (Sandbox y Producción). Sin embargo, el token de acceso generado determinará a qué modo se podrá acceder. En caso de perder el token de acceso global y no poder generar un token temporal, por favor solicita uno nuevo directamente al equipo de Blue Diamond Innovation.

Nos enorgullece ofrecerte esta API REST como parte del Programa de Resellers para Integración Corporativa. ¡Comienza a explorar nuestros servicios y descubre cómo nuestra API puede mejorar la eficiencia de tu operación de comercio electrónico!

Blue Diamond Innovation

Introducción a Nexus API REST

Bienvenidos a la API REST de Blue Diamond Innovation#

Modos de Servicio#

Servicios Disponibles#

1. Marcas#

Funcionalidades de Marcas#

2. Categorías#

Funcionalidades de Categorías#

3. Productos#

Formas de Obtener Productos:#

Funcionalidades de Productos#

4. Imágenes#

Funcionalidades de Imágenes#

5. Fichas Técnicas#

Funcionalidades de Fichas Técnicas#

6. Estimador de Envío#

Funcionalidades del Estimador de Envío#

7. Estado de Pedidos#

Funcionalidades del Estado de Pedidos#

Acceso Seguro con Token de Autenticación#

Nota Importante#