Preguntas frecuentesEspecificaciones acerca del fichero de datosArtículo

¿Qué es un fichero de datos?

Para publicar los productos en ShopMania debes crear y enviarnos un fichero de datos. Un fichero de datos es un fichero en formato txt, CSV o XML, que contiene información detallada sobre tus productos, como: nombre del producto, precio, categoría etc. Los campos en el fichero de datos deben ser delimitados por barra vertical (|), y las filas por nueva fila (\n).

Este es el formato estándar para un fichero txt o CSV:

categoría con el camino completo | fabricante | modelo | código del producto | nombre del producto | descripción | URL del producto | URL de la imagen | precio | divisa | coste de envío | disponibilidad | GTIN (UPC/EAN/ISBN)

Los siguientes campos son obligatorios: Categoría, Código del producto, Nombre del producto, URL del producto, URL de la imagen y Precio. GTIN es obligatorio para libros; en este caso debes añadir el código ISBN. No es suficiente con solo incluir estos campos, sino que es necesario que dichos campos tengan información válida y correcta. De otra forma el fichero no será considerado válido. De todas formas, para la publicación correcta de tus productos te recomendamos incluir información en todos los campos mencionados, no solamente en los que son obligatorios.

Los campos del fichero deben incluir la siguiente información:

Campo Descripción Ejemplo
Categoría Debe contener las categorías de tu web, con el camino completo, desde la categoría principal hasta la subcategoría en la que están listados los productos.

Límite: 255 caracteres
Electrodomésticos > Pequeños electrodomésticos para el cuidado personal > Afeitadoras
Fabricante El nombre del fabricante o la marca del producto.

Límite: 100 caracteres
Nokia
Modelo El código del fabricante asignado a cada producto (MPN, EAN, UPC o ISBN).

Límite: 100 caracteres
Para las tarjetas gráficas Gigabyte Nvidia GeForce 210 512MB DDR2, el modelo es "GV-N210OC- 512I"
Código del producto El código único por el que un producto está identificado en la base de datos de la tienda. Es recomendable no cambiarlo con el tiempo.

Límite: 100 caracteres
12345, 12346, 123457
Nombre del producto El nómbre del producto tal como aparece en tu web.

Límite: 255 caracteres
Tarjeta gráfica Gigabyte Nvidia GeForce 210 512MB
Descripción del producto La descripción del producto no debe contener tags HTML, código Javascript, imágenes u otro tipo de ficheros multimedia.

Límite: 200 caracteres
La cámara digital D3100 saca fotos de alta calidad en condiciones de oscuridad y se usa sobretodo en la industria semi-profesional.
URL producto La URL hacia la página del producto. http://ejemplo.com/view-product?prod-id=12345
URL imagen La URL hacia la imagen principal del producto. Recomendamos enviar imágenes grandes, con una buena calidad.
No aceptamos imágenes con información tipo marcas de agua, logo o texto promocional.
http://ejemplo.com/images/12345.jpg
Precio del producto El precio del producto debe incluir todos los impuestos, sin los costes de envío, que están en otro campo.
No permitimos precios que estén disponibles solamente para cierta categoría de clientes.
El precio no debe incluir la divisa: MXN.
120.45
Divisa La moneda usada en tu país. MXN
Costes de envío Los costes de envío del producto.

Para mostrar los costes de envío incluídos en el fichero debes marcar la opción "Costes de envío por productos individuales" en la sección Configuración envíos de tu panel de control. Los costes de envío deben ser expresados en la misma moneda que los precios.

El envío gratuito se debe indicar con el valor cero (0.00).
2.5
Disponibilidad Contiene información con respecto a la disponibilidad del producto. Los valores aceptados para este campo son:
- In stock / En stock: Usa este valor si estás seguro de poder enviar el producto en 3 días hábiles o menos. Por ejemplo, si tienes el producto en tu almacén.
- Available for order / Disponible bajo demanda: Usa este valor si tardas 4 o más días en enviar el pedido a tu cliente. Por ejemplo, cuando no lo tienes en tu almacén en ese momento, pero estás seguro de que lo recibirás dentro de poco días. Para productos que no están al mercado usa el valor Preorder / Pedido anticipado.
- Out of stock / Agotado: Por el momento no aceptas pedidos para ese producto.
- Preorder / Pedido anticipado: Aceptas pedidos para el producto, pero éste no está al mercado todavía.

Nota: Si usas otros valores de disponibilidad en tu fichero debes acceder a tu panel de control de ShopMania para hacer la correspondencia con los valores usados en nuestro sistema.
In stock / En stock
GTIN (UPC/EAN/ISBN) Los identificadores únicos más importantes son los códigos GTIN (Global Trade Item Numbers), que incluyen UPC - Universal Product Code, EAN - European Article Number (in Europe) e ISBN - International Standard Book Number.

Estos valores son muy importantes para la correspondencia con las búsquedas de los usuarios. Es obligatorio enviar el ISBN para libros. Te recomendamos proporcionar códigos GTIN para todos los productos, porque estos pueden ser obligatorios en el futuro.

Puedes encontrar más información sobre los códigos GTIN en Wikipedia.
- UPC: un número de identificación comercial asociado a un código de barras imprimido en los productos;
número de 12 dígitos tipo 001234567891
Puedes encontrar más información sobre UPC en Wikipedia.

- EAN: un número de identificación comercial asociado a un código de barras imprimido en los productos;
número de 13 dígitos tipo 1001234567891
Puedes encontrar más información sobre EAN en Wikipedia.

- ISBN: un número de identificación comercial imprimido en los libros junto al código de barras;
número de 10 o 13 dígitos tipo 0451524233
Si tiene ambos códigos incluye solamente el número de 13 dígitos;
Puedes encontrar más información sobre ISBN en Wikipedia.


Ficheros XML

También podemos procesar ficheros XML, si contienen por lo menos los campos obligatorios. Puedes definir tus propios tags para el fichero o puedes usar los de nuestro ejemplo.

Ejemplo de fichero XML:

<store>
<products>
...
<Product>
<MPC>12554</MPC>
<Category>Ordenadores - Monitores</Category>
<Manufacturer>Samsung</Manufacturer >
<MPN>12350</MPN>
<Name>SyncMaster 206BW</Name>
<Description>Samsung 15.6" Widescreen LCD - 1360x768, 500... </Description>
<URL>http://www.ejemplo.com/products.php?id=a3057</URL>
<Image>http://www.ejemplo.com/products.jpg</Image>
<Price>431</Price>
<Currency>MXN</Currency>
<Shipping>15</Shipping>
<Availability>In stock / En stock</Availability>
<GTIN>1001234567891</GTIN>
</Product>


Notas:

- Las filas que no contienen información válida estarán automáticamente rechazadas. En tu panel de control en la sección "Estadísticas productos" puedes encontrar toda la información sobre las filas rechazadas;
- Los campos que no tienen información deben dejarse libres. Este es un ejemplo que no tiene información en el campo Modelo: categoría| fabricante | | código del producto | nombre del producto | descripción del producto | URL del producto | URL de la imagen | precio | divisa | costes de envío
- La descripción no debe contener lenguaje promocional, precios con descuento, tags html, costes de envío o texto escrito solamente en mayusculas;
- Antes de enviar el fichero debes eliminar todas las nuevas filas u otros caracteres usados como separadores de campos;
- El camino de la categoría debe ser completo: Categoría / Subcategoría1 / Subcategoría2. Ejemplo: Ordenadores – Periféricos – Monitores. Solamente aceptamos ficheros que contienen las categorías usadas en la web de la tienda, no las que usamos en Shopmania;
- Las URLs de las imágenes y de los productos deben ser completas y empezar por http://
- Debes indicar claramente la disponibilidad de un elemento de tu tienda en la página del producto mencionado o el estado (In stock / En stock, Available for order / Disponible bajo demanda, Out of stock / Agotado, Preorder / Pedido anticipado), o el número de días para el envío. Los productos que ya no se venden deben ser completamente eliminados.

Subir el fichero de datos desde tu panel de control ShopMania

Debes iniciar sesión en Shopmania e ir la sección Método de subida. En function del tipo de fichero de datos que tienes, debes elegir la forma de subirlo (auto o manual). Para la forma auto debes ingresar la URL y para la forma manual debes subir un archivo.

Métodos de subida

1. Auto – para crear el fichero, ShopMania pone a la disposición de las tiendas scripts para las plataformas ecommerce más populares: OSCommerce, OSCommerce v3, ZenCart, Virtuemart, Virtuemart 2, JoomShopping, phpShop, CSCart, CSCart 4, XCart, CubeCart, SunShop, OpenCart, PHPMass, OOS Shop, xtCommerce, Interspire, PrestaShop, Magento, Shop-Script, Shop-Script Premium, Creloaded, QuickCart, PinnacleCart, Ubercart, TomatoCart, eShop, ShopperPress, WP e-Commerce, WP e-Commerce 3.8, WP Online Store, WP Store, WP StoreBox, WooCommerce, LogiVert, INDIGO Shop, PHP + MySQL, ASP + MySQL.

Para las webs que no usan ninguna de las plataformas de arriba tenemos modelos de scrips PHP + MySQL, ASP + MySQL, ASP + SQLServer y ASP + MsAccess. Estos scripts deben ser personalizados por un programador para corresponder a la base de datos de tu web.

Haz clic aquí para más detalles sobre como instalar los scripts para el fichero de datos.

2. Manual - es recomendable incluir no más de 50 productos en el fichero. El fichero debe ser actualizado cada vez que haya cambios de precio o stoc y por lo menos una vez a cada 30 días. Nota que si no actualizas el fichero cada 30 días, tu tienda será suspendida automáticamente.

El fichero necesita entre 1 y 3 días laborales para ser aprobado y procesado y para que los productos se puedan ver en nuestro portal. Si no recibes una notificación con respecto a la publicación en mucho tiempo, por favor contacta con nosotros a support@shopmania.com.mx.

Listado en: Especificaciones acerca del fichero de datos