Modelos de integración

Consultas al catálogo

Este modelo de integración está enfocado a clientes que están iniciando el proceso de integración, desean únicamente consultar el catálogo de productos de Intcomex, disponibilidad de productos y precios.


Con la información obtenida pueden saber en tiempo real cuáles son los productos que pueden ofrecer a tus clientes finales, los precios que Intcomex tiene para sus distribuidores y su disponibilidad en todas las bodegas del país.


En Intcomex disponemos de dos ambientes de integración para IWS (desarrollo y producción) las URL a utilizar en cada ambiente son:

  • PRODUCCIÓN: https://intcomex-prod.apigee.net/v1/

  • DESARROLLO: https://intcomex-test.apigee.net/v1/


Consultar


Categorías


Disponibilidad


Precios


Bodegas

Módulos a desarrollar

Para implementar este modelo, se recomienda desarrollar los módulos y APIs siguientes

Catálogo

GetCatalog
GetInventory
GetPriceList
DownloadExtendedCatalog

Si das click en cada API esta te redireccionará a la documentación en donde se puede ver el detalle del formato, sintáxis y tipos de respuestas.

Construcción del catálogo de productos

GetCatalog

El API GetCatalog se utiliza para obtener información general sobre los productos de Intcomex.

Sugerencias

  • Este método deberá ser consumido una vez al día.

  • El método responde con información sobre los productos de acuerdo a lo que se requiera (categoría, marca, gabricante, dimenciones, etc.)

  • Es el portafolio de productos autorizado para cada cliente de Intcomex



Sintáxis

  • GET: /getcatalog

Para el detalle y referencia utilizar el link a la documentación.

GetCatalog

GetInventory

El API GetInventory se utiliza para obtener la disponibilidad de los productos de Intcomex.

Sugerencias

  • Este método podrá ser consumido cada hora para actualizar el inventario.

  • Para productos ESD se mantiene inventario cero ya que estos se obtienen directamente de los fabricantes en el momento de la compra.

  • Como mejores prácticas se sugiere no mostrar aquellos productos que tengan un mínimo de unidades disponibles.


Sintáxis

  • GET: /getinventory

Para el detalle y referencia utilizar el link a la documentación.

GetInventory

GetPriceList

El API GetPriceList se utiliza para obtener los precios de los productos que Intcomex tiene para ti.

Sugerencias

  • Este método podrá ser consumido una vez al día.

  • Deberás agregar el margen al precio que Intcomex te muestra antes de publicarlo en tu Ecommerce.

  • Los precios se muestran en moneda local o en dólares de acuerdo a la configuración interna del cliente.

Sintáxis

  • GET: /getpricelist

Para el detalle y referencia utilizar el link a la documentación.

GetPriceList

DownloadExtendedCatalog

El API DownloadExtendedCatalog se utiliza para obener los links de las imágenes disponibles en el catálogo de Intcomex.

Sugerencias

  • Este método deberá ser consumido una vez al día o al mes de acuerdo a la frecuencia de actualización del catálogo.

  • Entrega las URLs en donde encontrarás las imágenes de los productos.

  • Intcomex dispone de un 74% de imágenes de los productos del catálogo.

Sintáxis

  • GET: /DownloadExtendedCatalog

Para el detalle y referencia utilizar el link a la documentación.

DownloadExtendedCatalog

Módulo de gestión

Logs

Se recomienda mantener un log que registre todas las peticiones y respuestas, visible a los usuarios, en donde puedan monitorear el comportamiento, errores y peticiones en general, estos logs seran de utilidad para identificar errores más facilmente y poder reportarlos al área correspondiente.


Consumo manual

Se recomienda habilitar accesos a los usuarios para consumir y actualizar los servicios manualmente en caso de ser necesario.

¡Estás listo para dar el primer paso e iniciar con la integración a IWS y elevar tus ventas!