Veelgestelde vragenDatafeed specificatiesArtikel

Algemene datafeed info en specificaties.

Om producten op ShopMania te kunnen plaatsen, moet u een datafeed aanleveren. Een datafeed is een bestand in TXT, CSV of XML formaat met daarin gedetailleerde informatie over uw producten, zoals: productnaam, prijs, categorie, etc. De velden in de datafeed moeten gescheiden worden met een pipe (vertikaal streepje), en de regels moeten gescheiden worden met een regeleinde (\n).

De standaard opmaak voor een feed in TXT en CSV is:

Categoriepath | Fabrikant | Modelnummer | Productcode | Productnaam | Beschrijving | Product URL | Afbeelding URL | Prijs | Valuta | Verzendkosten | Beschikbaarheid | GTIN (UPC/EAN/ISBN)

De volgende velden zijn verplicht: Categorie, Productcode, Productnaam, Product URL, Afbeelding URL en Prijs.
GTIN is ook verplicht voor boeken; in dit geval moet u het ISBN nummer toevoegen. Deze velden moeten niet alleen aanwezig zijn in de datafeed, maar moeten ook correcte informatie bevatten. Zo niet, dan kan uw feed afgekeurd worden. Voor een optimale vermelding van uw producten, adviseren we u om de data voor alle hierboven genoemde velden in te voeren, en niet slechts de verplichte velden.

De ingevoegde velden in de datafeed moeten de volgende data bevatten:

Veld Beschrijving Voorbeeld
Categoriepath Het complete categoriepath van het product (hoofdcategorie, subcategorie, evt subsubcategorie).

Max: 255 karakters
Electronica > Mobiele Telefoons > iPhone > Laders
Fabrikant De naam van de fabrikant of het merk.

Max: 100 karakters
Nokia
Modelnummer Het door de fabrikant bepaalde modelnummer voor het product (MPN, EAN, UPC or ISBN).

Max: 100 karakters
Voor de videokaart Gigabyte Nvidia GeForce 210 512MB DDR2, is het model "GV-N210OC-512I"
Productcode Een unieke productcode, waarmee de producten in uw winkel geïdentificeerd worden. Wij raden aan om deze code niet te wijzigen.

Max: 100 karakters
12345, 22-346, AB12457
Productnaam De naam van het product zoals het op uw site wordt weergegeven.

Max: 255 karakters
Videokaart Gigabyte Nvidia GeForce 210 512MB
Productbeschrijving De productbeschrijving; gebruik geen HTML tags, Javascript code, afbeeldingen of andere type multimedia bestanden.

Max: 200 karakters
De digitale camera D3100 neemt geweldige foto’s in een donkere omgeving en wordt met name gebruikt in de semi-professionele industrie.
Product URL De URL naar de productpagina (deeplink), eventueel voorzien van tracking variabelen. http://voorbeeld.nl/bekijk-product?prod-id=12345
Afbeelding URL De URL naar de belangrijkste foto van het product. We raden u aan hiervoor een grote foto met een goede resolutie te gebruiken (minstens 250x250 pixels).
Watermerken, logo's of andere promoties in de afbeeldingen worden afgeraden.
http://voorbeeld.nl/afbeeldingen/12345.jpg
Productprijs De productprijs is inclusief BTW maar exclusief verzendkosten. De verzendkosten worden ingevoerd in een apart veld.
We staan geen prijzen toe die alleen beschikbaar zijn voor een bepaalde categorie klanten.
In de prijs wordt nog geen valuta weergegeven.
120.45
Valuta De valuta van de prijs. EUR
Verzendkosten De verzendkosten van de producten.

Om de verzendkosten uit de feed weer te geven, moet u de optie “Verzendkosten uit datafeed” selecteren in de sectie Instellingen > Verzendinstellingen van uw account. De verzendkosten moeten worden uitgedrukt in dezelfde valuta als de productprijzen.

Gratis verzending wordt aangeduidt als nul (0.00).
2.5
Beschikbaarheid De beschikbaarheid van het product. Geaccepteerde waarden zijn:
- In stock / Op voorraad: gebruik deze waarde als u er zeker van bent dat verzending binnen 2 werkdagen zal plaatsvinden, bijvoorbeeld als u het product op voorraad heeft.
- Available for order / Bestelbaar: gebruik deze waarde als het meer dan 3 werkdagen zal duren om het product naar de klant te verzenden, bijvoorbeeld als u het product op dit moment niet op voorraad heeft maar u er zeker van bent dat het in de komende dagen geleverd wordt.
- Out of stock / Uitverkocht: op dit moment accepteert u geen bestellingen voor dit product omdat het niet leverbaar is.
- Preorder / Alvast te bestellen: het product is nog niet leverbaar, maar het kan wel alvast besteld worden.

Let op: Als u gebruikt maakt van andere waarden voor de beschikbaarheid, kunt u deze koppelen onder Instellingen > Product beschikbaarheid instellingen.
In stock / Op voorraad
GTIN (UPC/EAN/ISBN) De belangrijkste product identificatiesystemen zijn de Global Trade Item Numbers (GTINs): dit omvat UPC - Universal Product Code, EAN - European Article Number (in Europe) en ISBN - International Standard Book Number.

Deze waarden zijn erg belangrijk voor de vindbaarheid van uw producten. Voor boeken is het verplicht om een ISBN nummer in te vullen in uw feed. Wij adviseren u nadrukkelijk om GTIN indentificatiesystemen voor al uw producten in te vullen, aangezien dit wellicht verplicht wordt in de toekomst.

Meer informative over GTIN vindt u op Wikipedia.
- UPC: een uniek numeriek identificatiesysteem voor producten in de detailhandel doorgaans geassocieerd met een barcode;
12-cijferig nummer zoals 001234567891
Meer informative over UPC.

- EAN:een uniek numeriek identificatiesysteem voor producten in de detailhandel doorgaans geassocieerd met een barcode;
13-cijferig nummer zoals 1001234567891
Meer informatie over EAN.

- ISBN: een uniek numeriek identificatiesysteem voor commerciele boeken dat gevonden kan worden op de achterkant van het boek bij de barcode;
10 of 13-cijferig nummer zoals 0451524233
Als beide aanweizg zijn, gebruik dan het 13 cijferig nummer;
Meer informatie over ISBN.


XML datafeeds

We kunnen ook XML datafeeds verwerken, als deze minstens de verplichte velden bevatten. U kunt uw eigen tags gebruiken voor de datafeed velden of de tags uit ons voorbeeld.

XML datafeed voorbeeld:

<store>
<products>
...
<Product>
<MPC>12554</MPC>
<Category>Computers - Monitors</Category>
<Manufacturer>Samsung</Manufacturer >
<MPN>12350</MPN>
<Name>SyncMaster 206BW</Name>
<Description>Samsung 15.6" Widescreen LCD - 1360x768, 500... </Description>
<URL>http://www.example.com/products.php?id=a3057</URL>
<Image>http://www.example.com/products.jpg</Image>
<Price>429,95</Price>
<Currency>EUR</Currency>
<Shipping>15</Shipping>
<Availability>In stock / Op voorraad</Availability>
<GTIN>1001234567891</GTIN>
</Product>

Let op: • De rijen met producten die geen correcte data bevatten worden automatisch geweigerd. In de sectie "Product Statistieken" van uw overzicht kunt u alle informatie vinden over de geweigerde velden;
• Zorg dat alle unieke producten één keer in de datafeed voorkomen. Dubbele vermeldingen en vermeldingen van varianten (bijv. kledingmaten) worden automatisch geweigerd;
• De ontbrekende velden moeten worden gescheiden door twee achtereenvolgende karakters. Dit is een voorbeeld van een feed zonder het veld “Model”:
categorie| fabrikant | | winkelcode | productnaam | productbeschrijving | product URL | afbeelding URL | prijs | valuta | verzendkosten
• De productbeschrijving mag geen promotionele teksten, kortingen, html tags, verzendkosten of tekst met alleen maar hoofdletters bevatten;
• Het categorie path van het product moet compleet zijn: Categorie / Subcategorie / Subsubcategorie.
Voorbeeld: Computers – Randapparatuur – Monitors.
We raden aan om de categorie-indeling van uw eigen website te gebruiken, en niet de categorieën uit het ShopMania systeem;
• De product en afbeelding URL moeten compleet zijn en starten met http://
• U moet de beschikbaarheid van een product duidelijk aangeven op uw winkel product pagina door expliciet de status weer te geven(In stock / Op voorraad, Available for order / Bestelbaar, Out of stock / Uitverkocht, Preorder / Alvast te bestellen), of door aan te geven hoeveel dagen het zal duren voordat het product verzonden zal worden. Producten die niet meer verkocht worden moeten volledig van de feed worden verwijderd.

De datafeed invoeren in uw ShopMania account
Log in op uw ShopMania account en ga naar de sectie Instellingen – Datafeed Instellingen. Kies de upload methode (auto of handmatig) en voer de URL naar de datafeed in voor de automatische upload, of upload het bestand in het geval van een handmatige upload.

Upload methoden
1. Auto – voor het maken van de datafeed, biedt ShopMania automatische datafeed scripts voor de meeste populaire ecommerce platforms: 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.

Voor de websites die geen van bovengenoemde platforms gebruiken, bieden we PHP + MySQL, ASP + MySQL, ASP + SQLServer en ASP + MsAccess voorbeeld scripts aan. Deze scripts moeten worden aangepast door een programmeur om overeen te komen met de database van uw website.

Klik hier voor informatie over het installeren van het datafeed script.

2. Handmatig - u kunt zelf de productinformatie in een bestand zetten, of een export met alle informatie gebruiken. De feed moet bijgewerkt worden als er wijzigingen zijn in prijzen of voorraad, en op zijn minst elke 30 dagen. Let op: als de datafeed meer dan 30 dagen niet is bijgewerkt, zal de weergave van uw producten op de site automatisch gestaakt worden.

Het duurt tussen de 1 en 3 werkdagen voordat een datafeed goedgekeurd is en de producten te zien zijn op de website. Als u binnen afzienbare tijd geen melding van ons ontvangt betreffende de datafeed, neem dan contact met ons op via e-mail. Ons e-mailadres is support@shopmania.nl.

Geplaatst in: Datafeed specificaties