Integraciones no estándar

Aquellas integraciones que no se adapten a la modalidad estándar definida en las secciones de arriba, deberán sí cumplir con ciertos requisitos mínimos que se detallan a continuación.

Consideraciones generales

Conexión

• La autenticación de las conexiones deberá realizarse restringiendo el acceso por IP y/o token de seguridad (tipo api key) a incluirse en el header de la petición.

• No se implementarán conexiones a través de VPN.

• Los servicios se deberán disponibilizar a través de nombres de dominio fijos (no se admitirán conexiones por dirección IP o dominios dinámicos tipo DynDNS).

Ambiente de testing

Es necesario que el comercio brinde un ambiente de testing al cual puedan estar conectados todos los servicios necesarios de Fenicio y que puedan efectuarse pruebas sin alterar la operativa normal. Este ambiente de testing debe ser un reflejo del ambiente de producción, ya que de esa manera se asegura replicar el flujo real de la integración.

SKUs

El SKU debe seguir un criterio uniforme para todos los productos, tal que permita a Fenicio pueda identificar el código del producto base, la variante y la presentación. El comercio deberá indicar el criterio utilizado para codificar los productos.

Ejemplo: 123456_AZ_LG.

En este ejemplo, el criterio sería que los primeros 6 dígitos son el código del producto, los 2 siguientes el color y los 2 últimos el talle, separados por guión bajo.

Carga de imágenes

En los casos de integración completa, las imágenes de los productos deberán cargarse a través de FTP, siguiendo lo indicado en la sección Carga de imágenes.

En caso de integración parcial (precio y stock), las imágenes deben cargarse directamente en el backoffice de Fenicio.

Servicios

Productos

El servicio que retorna los productos deberá estar paginado para evitar timeouts o sobrecarga en el procesamiento (sugerimos 100 items por página).

Fenicio puede procesar hasta dos servicios distintos con información de los productos (por ejemplo uno para información general y otro para precio y stock). En ese caso, ambos servicios deben indicar el código del producto (SKU) para que Fenicio realice correctamente la asociación, además de estar ambos paginados según lo indicado arriba.

Fenicio deberá recibir los siguientes datos en los servicios de productos:

• SKU*

• Precio*

• Stock*

• Nombre

• Marca

• Categoría

• Atributos

En caso de integraciones parciales (precio y stock), solo deberán incluirse los campos marcados con *.

Stock en tiempo real

El servicio de stock en tiempo real debe permitir que mandar un array de SKUs en la misma consulta. Este servicio se usa para control de stock al agregar al carrito y al momento de comprar.

Registro de orden

El servicio de registro de orden debe aceptar todos los datos de la orden en una única consulta:

• Productos incluidos

• Datos del comprador

• Datos de entrega

• Descuentos

• Información de los productos

• Etc.

Revisar la documentación del servicio estándar de registro de orden como referencia de los datos a incluirse.