Productos
Este servicio deberá exponer la información de todos los productos que deban ser publicados en el catálogo de Fenicio.
IMPORTANTE: Si la integración es completa, los datos viajan todos desde el ERP menos las imágenes que van por FTP. No existe la posibilidad de híbrido.
GET
https://{ApiURL}/productos
En los casos de integración parcial, la información retornada podrá limitarse a los datos de precio y stock (según se indica más abajo).
Request
desde
Int(6)
Posición del primer producto solicitado. Se considera que al primer producto del catálogo le corresponde la posición cero.
total
Int(6)
Cantidad de productos a retornar.
Ejemplo
Funcionamiento del paginado
Los parámetros desde y total indicados arriba en el request, son utilizados para que Fenicio realice un paginado de las solicitudes al servicio.
Una vez que una llamada retorna menos cantidad de productos que el total solicitado en el parámetro total, Fenicio considera que se ha completado la importación. De lo contrario, continuará hacia la siguiente página.
Por esto es importante que no se retornen menos productos que los solicitados, salvo que efectivamente se haya llegado al final del catálogo a publicar.
Response
En las integraciones parciales, Fenicio únicamente tomará en cuenta los campos marcados con un asterisco (*).
desde*
Int(6)
Posición del primer producto solicitado.
total*
Int(6)
Cantidad de productos incluidos en la respuesta.
productos*
Lista de productos.
Producto
codigo*
Código del producto base.
nombre
String(128)
Nombre del producto base.
fechaCreacion
Fecha de creación del producto base.
prioridad
Int(6)
Permite definir la prioridad en los listados de productos. Los productos se listan de mayor a menor prioridad.
guiaTalles
String(32) | null
Código de guía de talles. Este código debe corresponder a una guía de talles ya creada en la gestión de Fenicio.
monedaPredeterminada
String(4)
Moneda con la cual se mostrará inicialmente el producto.
impuesto
Numeric
Porcentaje correspondiente al impuesto con el que está gravado el producto. Valores posibles: de 0 a 100.
atributos
Object
Objeto con claves/valores para cada atributo disponible. Nota 1: En los atributos se deben incluir datos tales como la categoría, la marca, las características, el género y otros datos relevantes. Nota 2: En las claves de los atributos solo se admiten caracteres alfanuméricos básicos (sin acentos) y guión medio. No se aceptan espacios, guion bajo ni otros símbolos.
variantes*
Lista con las variantes del producto base.
Variante
codigo*
Código de la variante.
nombre
String(128)
Nombre de la variante.
orden
Int(6)
Permite definir el orden de las variantes dentro del producto. Las variantes con menor valor se muestran primero.
referencia
String(32)
Código de referencia de la variante. Si la clave no es enviada o es vacía, Fenicio automáticamente lo ingresa como:
[CODIGO BASE]-[CODIGO VARIANTE].
atributos
Object
Objeto con claves/valores para cada atributo disponible. Nota 1 - Atributos:
En los atributos se deben incluir datos tales como color, sale, outlet y otros datos relevantes a la propia variante. Nota 2 - Claves:
En las claves de los atributos solo se admiten caracteres alfanuméricos básicos (sin acentos) y guion medio. No se aceptan espacios, guion bajo ni otros símbolos.
Nota 3 - Descripción corta: Descripción corta soporta texto plano hasta 255 caracteres.
Nota 4 - Descripción ampliada:
La descripción ampliada acepta en los textos etiquetas de encabezados tipo (<h2>, <h3>, etc), párrafos (<p>) y span (<span>). Para definir estilos en línea se sugiere el uso de clases y asignarlos a los elementos. No se aceptan etiquetas HTML obsoletas y no es necesario enviar las etiquetas <html>, <head> ni <body>. El máximo de tamaño del campo es de 65K.
presentaciones*
Lista con las presentaciones (talles) de una variante.
Presentación
codigo*
Código de la presentación.
nombre*
String(128)
Nombre de la presentación.
String(128)
Código único que identifica al artículo.
stock*
Int(6)
Cantidad de unidades disponibles para venta web.
precioLista*
Price | null
Precio original del producto, sin descuentos, rebajas, con impuestos aplicados. Si se omite el precio de lista (o es cero), se utilizará el precio de lista histórico. Éste será el valor más alto de todos los precios de lista que haya manejado Fenicio en algún momento para ese producto.
precioVenta*
Price | null
Precio efectivo de comercialización del producto, con impuestos aplicados.
preciosAlternativos
Lista de precios alternativos para la presentación.
identificadores*
Lista de identificadores internacionales de producto.
Precio alternativo
codigo
Código del precio.
precioLista
Price
Precio original del producto, sin descuentos, rebajas, con impuestos aplicados.
precioVenta
Price
Precio efectivo de comercialización del producto, con impuestos aplicados.
Identificador
codigo
String(16)
Valores posibles: GTIN, MPN.
valor
String(128)
Valor del identificador para el artículo. Por favor verificar el formato correspondiente según el estándar requerido de cada identificador.
Ejemplo integración completa
Ejemplo integración parcial
Consideraciones
El tiempo total de respuesta del servicio (considerando todas las páginas) no deberá superar en ningún caso los 5 minutos.
Si el rango de la solicitud excede la cantidad de registros disponibles, el servicio deberá retornar una lista vacía o con la cantidad de productos encontrados, aunque esta sea menor a la cantidad solicitada.
Para comercios que operen en dos monedas, el servicio deberá proporcionar cada precio en ambas monedas utilizadas. Fenicio rechazará la importación de los artículos que no contemplen este punto.
Es importante que se envíen los productos con todas las variantes y presentaciones que se desee que Fenicio conozca, aunque estas no tengan stock. Por ejemplo, si una presentación (o talle) no se incluye en el servicio, no se mostrará en la ficha del producto, impidiendo que el visitante conozca todas las opciones existentes (con y sin stock) para ese producto. De la misma manera se vería afectada la consulta de ubicar en tienda para un producto dado, ya que únicamente se mostraría la información correspondiente a las presentaciones que Fenicio conoce.
Los productos con variantes únicas deberán indicar como código de variante el mismo código que el del producto base.
Los productos con presentaciones únicas deberán indicar como código de presentación la letra u mayúscula (
U).En el caso de integración parcial, la moneda predeterminada para los productos debe indicarse desde el panel de gestión de Fenicio. Por defecto, los productos tendrán como moneda principal predeterminada la indicada en la configuración general del sistema.
Los productos sin marca o categoría no se visualizarán en el sitio. La marca y la categoría (o los datos necesarios para su correcto mapeo) deben incluirse dentro de la clave
atributosen Producto. Ante dudas, por favor consultar con el consultor asignado de Fenicio.
Última actualización
¿Te fue útil?