Siirry sisältöön
mervo Suomi

Syötteen määrittely

Lähetä syöte, jonka jo teet Prisjaktille, PriceRunnerille tai Google Shoppingille; luemme alla luetellut sarakkeet.

Tämä artikkeli odottaa äidinkielisen tarkastajan tarkistusta.

Muodot

Luemme seuraavia muotoja: Prisjakt-muoto (CSV tai XML), PriceRunner-muoto (CSV tai XML), Google Shopping (RSS tai Atom, g:-nimiavaruus), CSV tai muu erotinmerkein eroteltu teksti, muu XML ja JSON.

Tunnistamme syntaksin itse tiedostosta. Erotinmerkein eroteltusta tekstistä etsimme erottimen (pilkku, puolipiste, sarkain tai pystyviiva). XML- ja JSON-tiedostoista luemme suurimman tuoteluettelon. Google-syötteet tunnistetaan nimiavaruudesta, ja jos kenttä toistuu maittain, käytämme maasi merkintää.

Merkistö ja pakkaus

Merkistöt: UTF-8, UTF-16, ISO-8859-1, Windows-1252. Ensisijaisesti ratkaisee tavujärjestysmerkki (BOM) tai XML-esittely. Ilman niitä kokeilemme merkistöä UTF-8, ja muuten luemme tiedoston merkistönä Windows-1252.

Merkistöä Latin-1 käyttävät pohjoismaiset syötteet toimivat: luemme ne merkistönä Windows-1252, jossa ovat samat Å, Ä, Ö, Æ ja Ø ja lisäksi € ja kaarevat lainausmerkit.

Pakkaus: gzip, zip. Zip-tiedostossa on oltava tasan yksi syötetiedosto.

Osoite, koko ja ajoitus

Syötteesi on oltava pysyvässä https://- tai ftp://-osoitteessa, joka palauttaa aina uusimman syötteesi. Osoitteet, joissa on päivämäärä tai aikaleima, hylätään.

Enintään 200 MB. Haemme syötteen 6 tunnin välein, ja jokaisen kaupan hakuaika on sijoitettu eri kohtaan vuorokautta.

Hinnat

Kaikki hinnat valuutassa EUR arvonlisäveroineen, kuten asiakkaasi ne näkevät. Jos hinta- tai valuuttasarakkeessa on muu valuutta, koko tuonti pysähtyy. "kr" hyväksytään, kunhan se on valuuttasi.

Kirjoita hinnat samoin kuin kaupassasi: kaikki toimii, olipa desimaalierottimena pilkku tai piste, tuhaterottimena välilyönti tai piste tai tasasummien merkintänä ":-" tai ",-".

Kentät

Kentät, jotka luemme, ja toimivat sarake- tai elementtinimet
KenttäPakollinenSarake- tai elementtinimet
Tuotetunnuksenne (SKU)Kylläproduktid, merchantproductid, awproductid, sku, id, artnr, artikelnr, artikelnummer, productid, itemid, varenummer, varenr, tuotenumero, tuotekoodi, tuotetunnus, merchantsku, shopsku
Tuotteen nimiKylläname, productname, produktnamn, produktnavn, tuotenimi, nimi, title, producttitle, produkttitel, benamning, benaevnelse
Tuotesivun URLKyllävareurl, merchantdeeplink, url, producturl, link, produkturl, deeplink, produktlink, tuotelinkki, linkki, tuoteurl, produktlank
HintaKyllänypris, searchprice, storeprice, productprice, price, pris, prisinklmoms, priceinclvat, pricewithvat, currentprice, hinta, myyntihinta, salgspris, priskr, nuvarandepris
TarjoushintaEisaleprice, kampanjpris, reapris, tilbudspris, tarjoushinta, erbjudandepris, specialprice
Aiempi hintaEiglpris, gammelpris, oldprice, productpriceold, ordinariepris, ordpris, normalpris, forpris, tidigarepris, normaalihinta, aiempihinta, alkuperainenhinta, regularprice, originalprice, wasprice, compareatprice, beforeprice, referenceprice
JäsenhintaEiloyaltyprice, loyaltyprogramprice, memberprice, clubprice, medlemspris, klubbpris, kundeklubbpris, klubpris, medlemspriser, jasenhinta, kantaasiakashinta
Alennus prosentteinaEirabatt, rabattprocent, rabattpct, rabat, rabatprocent, discount, discountpct, discountpercent, discountpercentage, alennus, alennusprosentti, alennuspct, prosentrabatt, rabattprosent
ValuuttaEicurrency, valuta, valuutta, currencycode, pricecurrency
ToimituskulutEifragtomk, fragtomkostninger, deliverycost, shipping, shippingcost, shippingprice, frakt, fraktkostnad, fraktpris, fragt, fragtpris, porto, toimituskulut, toimitusmaksu, postikulut, leveringspris
VarastotilanneEilagerantal, stockquantity, stockstatus, stock, lagerstatus, lager, instock, availability, tillganglighet, palager, lagerbeholdning, varastotilanne, varastossa, saatavuus, lagersaldo
ToimitusaikaEideliverytime, leveranstid, leveringstid, leveringstiddage, toimitusaika, shippingtime, deliverydays, leveranstiddagar
EAN/GTINEiean, gtin, ean13, eancode, eangtin, streckkod, stregkode, strekkode, viivakoodi, upc
Valmistajan tuotenumeroEimpn, manufacturersku, manufacturerpartnumber, tillverkarartnr, tillverkarsku, producentsku, produsentsku, valmistajansku, tillverkarensartikelnummer, producentvarenummer, produsentvarenummer, valmistajankoodi, valmistajantuotekoodi
Merkki tai valmistajaEibrandname, manufacturer, brand, tillverkare, varumarke, marke, producent, fabrikat, valmistaja, merkki, produsent, merke, tuotemerkki
Kuvan URLEibilledurl, merchantimageurl, awimageurl, imageurl, image, imagelink, bildurl, bild, billede, billedelink, bilde, bildeurl, kuva, kuvaurl, kuvalinkki
KategorianneEikategorinavn, merchantcategory, productcategory, category, kategori, kategoria, producttype, categorypath, varugrupp, varegruppe, tuoteryhma, googleproductcategory
KuvausEiproductdescription, description, beskrivning, beskrivelse, kuvaus, produktbeskrivning, tuotekuvaus
Kunto (uusi, käytetty)Eicondition, skick, stand, tilstand, kunto
VäriEicolor, colour, farg, farve, farge, vari
KokoEisize, storlek, storrelse, koko

Nimet tunnistetaan kirjainkoosta, välilyönneistä, aksenteista ja nimiavaruuksista riippumatta, joten "Ordinarie pris", "ordinarie_pris" ja "g:ordinarie pris" ovat sama nimi.

Mitä odotamme kuhunkin kenttään

  • GTIN tai EAN: koodi, jonka tarkistusnumero on oikein. Virheellinen koodi jätetään huomiotta, rivi ei. GTIN-koodin avulla voimme yhdistää tarjouksesi oikeaan tuotteeseen.
  • MPN: tallennetaan sellaisenaan.
  • Varastotilanne: nollaa suurempi luku tai sana, kuten "varastossa" tai "in stock". Tuntematon sana tulkitaan niin, ettei tuotetta ole varastossa. Jos varastosaraketta ei ole, jokainen rivi katsotaan varastossa olevaksi.
  • Toimitusaika: luku tai väli päivinä, viikkoina tai tunteina. "Tänään" tulkitaan nollaksi päiväksi. Yli 365 päivän arvot jätetään huomiotta.
  • Variantit: lähetä jokainen variantti omana rivinään omalla SKU-koodillaan ja laita väri ja koko omiin sarakkeisiinsa. Meillä ei ole kenttää varianttiryhmälle.
  • Kuvat: yksi kuvan osoite riviä kohden.

Ennen-hinta ja alennusprosentti

Ennen-hinta: hinta, jonka näytät yliviivattuna tai aiempana hintana. Toimivia sarakenimiä ovat esimerkiksi glpris, gammelpris, oldprice, productpriceold, ordinariepris, ordpris, normalpris, forpris, tidigarepris, normaalihinta, aiempihinta, alkuperainenhinta, regularprice, originalprice, wasprice, compareatprice, beforeprice, referenceprice.

Alennusprosentti: toimivia sarakenimiä ovat esimerkiksi rabatt, rabattprocent, rabattpct, rabat, rabatprocent, discount, discountpct, discountpercent, discountpercentage, alennus, alennusprosentti, alennuspct, prosentrabatt, rabattprosent. Hyväksymme arvot, jotka ovat suurempia kuin nolla ja pienempiä kuin sata.

Jos lähetät sen sijaan normaalihintaasi alemman tarjoushinnan, normaalihinta katsotaan ennen-hinnaksi.

Jos ennen-hintaa tai prosenttia ei ole, katsomme, ettei tarjouksessa ilmoiteta alennusta, eikä se saa hintatodistetta. Jos on vain prosentti, laskemme sitä vastaavan ennen-hinnan. Jos se on korkeampi kuin alin hintasi jakson aikana, tulos kertoo, etteivät hintasi tue ilmoitusta. Ennen-hinta, joka ei ole nykyistä hintaasi korkeampi, jätetään huomiotta.

Jäsenhinta: toimivia sarakenimiä ovat esimerkiksi loyaltyprice, loyaltyprogramprice, memberprice, clubprice, medlemspris, klubbpris, kundeklubbpris, klubpris, medlemspriser, jasenhinta, kantaasiakashinta. Jos jäsenhinnat lasketaan mukaan alimpaan hintaan, käytämme niitä tarkistuksessa.

Esimerkit

Jokainen esimerkki on otettu tiedostoista, joilla testaamme tuontia. Tässä näytetään ensimmäiset rivit; ladattavassa tiedostossa on muutama rivi lisää.

Esimerkeissä käytetään sen markkinan valuuttaa, jota varten ne on tehty. Syötteessäsi on käytettävä valuuttaa EUR.

Prisjakt-muoto, CSV

Produktnamn;Art.nr.;Kategori;Pris inkl. moms;Ordinarie pris;Rabatt %;Produkt-URL;Tillverkare;Tillverkar-SKU;Frakt;Bild-URL;Lagerstatus;EAN;Leveranstid;Beskrivning;Skick;Färg;Storlek
Stokke Barnvagn M647;SE-00001;Barn > Barnvagnar;12 859,00;;;https://www.example-butik.se/produkt/1;Stokke;STO-M647;29,00;https://cdn.example-butik.se/bilder/1.jpg;I lager;7300000010003;1-2 dagar;"Barnvagn från Stokke. Modell M647; levereras med svensk bruksanvisning.";Renoverad;;
Philips Airfryer N782 grön;SE-00002;Hem & kök > Airfryers;4 579,00;;;https://www.example-butik.se/produkt/2;Philips;PHI-N782;29,00;https://cdn.example-butik.se/bilder/2.jpg;I lager;7300000010003;1-3 dagar;"Airfryer från Philips. Modell N782; levereras med svensk bruksanvisning.";Ny;grön;
Philips Airfryer T606;SE-00003;Hem & kök > Airfryers;1 129,00;;;https://www.example-butik.se/produkt/3;Philips;PHI-T606;59,00;https://cdn.example-butik.se/bilder/3.jpg;I lager;7300000010003;1-2 dagar;"Airfryer från Philips. Modell T606; levereras med svensk bruksanvisning.";Ny;;
Melitta Kaffebryggare Q861;SE-00004;Hem & kök > Kaffemaskiner;1 862,00;2 499,00;25 %;https://www.example-butik.se/produkt/4;Melitta;MEL-Q861;49,00;https://cdn.example-butik.se/bilder/4.jpg;I lager;7300000010003;1-2 dagar;"Kaffebryggare från Melitta. Modell Q861; levereras med svensk bruksanvisning.";Ny;;
Jabra Hörlurar trådlösa T289;SE-00005;Ljud > Hörlurar;5 759,00;;;https://www.example-butik.se/produkt/5;Jabra;JAB-T289;0,00;https://cdn.example-butik.se/bilder/5.jpg;Slut i lager;7300000010003;2-5 dagar;"Hörlurar trådlösa från Jabra. Modell T289; levereras med svensk bruksanvisning.";Ny;;

Lataa tiedosto mervo-exempel-prisjakt.csv

PriceRunner-muoto, XML

<?xml version="1.0" encoding="UTF-8"?>
<products>
  <product>
    <SKU>SE-00001</SKU>
    <Name>Stokke Barnvagn M647</Name>
    <Price>12859.00</Price>
    <ShippingCost>29.00</ShippingCost>
    <StockStatus>in stock</StockStatus>
    <DeliveryTime>1-2</DeliveryTime>
    <Manufacturer>Stokke</Manufacturer>
    <ManufacturerSKU>STO-M647</ManufacturerSKU>
    <EAN>7300000010003</EAN>
    <URL>https://www.example-butik.se/produkt/1</URL>
    <ImageURL>https://cdn.example-butik.se/bilder/1.jpg</ImageURL>
…

Lataa tiedosto mervo-exempel-pricerunner.xml

Google Shopping, XML

<?xml version="1.0" encoding="UTF-8"?>
<rss version="2.0" xmlns:g="http://base.google.com/ns/1.0">
  <channel>
    <title>Exempelbutiken</title>
    <link>https://www.exempelbutiken.se</link>
    <item>
      <g:id>G-1</g:id>
      <g:title><![CDATA[Sony WH-1000XM6 Hörlurar – svart]]></g:title>
      <g:link>https://www.exempelbutiken.se/p/g-1</g:link>
      <g:price>4990.00 SEK</g:price>
      <g:sale_price>3990.00 SEK</g:sale_price>
      <g:availability>in_stock</g:availability>
      <g:brand>Sony</g:brand>
      <g:gtin>4548000000737</g:gtin>
…

Lataa tiedosto mervo-exempel-google.xml

CSV, merkistö Latin-1

Varenummer;Produktnavn;Pris;Førpris;Fragt;Lagerstatus;Leveringstid;Producent;EAN;Link;Billede;Kategori;Beskrivelse;Stand
DK-1001;Rødgrød-skål i rustfrit stål, 2 liter;249,95;299,95;39,00;På lager;1-2 hverdage;Blomsterhuset Ære;5700000000202;https://www.eksempel-butik.dk/vare/DK-1001;https://www.eksempel-butik.dk/billeder/DK-1001.jpg;Hjem & køkken;Kvalitetsvare fra Blomsterhuset Ære. Nem at gøre ren.;Ny
DK-1002;Blæser med lyddæmper – hvid;499,00;;39,00;På lager;1-2 hverdage;Wilfa;5700000000202;https://www.eksempel-butik.dk/vare/DK-1002;https://www.eksempel-butik.dk/billeder/DK-1002.jpg;Hjem & køkken;Kvalitetsvare fra Wilfa. Nem at gøre ren.;Ny
DK-1003;Kaffemaskine “Århus” sort;1.299,00;1.599,00;39,00;Ikke på lager;1-2 hverdage;Bodum;5700000000202;https://www.eksempel-butik.dk/vare/DK-1003;https://www.eksempel-butik.dk/billeder/DK-1003.jpg;Hjem & køkken;Kvalitetsvare fra Bodum. Nem at gøre ren.;Ny
DK-1004;Støvsuger Æble-edition, pose;1.899,00;;39,00;På lager;1-2 hverdage;Nilfisk;5700000000202;https://www.eksempel-butik.dk/vare/DK-1004;https://www.eksempel-butik.dk/billeder/DK-1004.jpg;Hjem & køkken;Kvalitetsvare fra Nilfisk. Nem at gøre ren.;Ny
DK-1005;Håndmixer med 5 hastigheder;349,00;;39,00;Bestillingsvare;1-2 hverdage;Bosch;5700000000202;https://www.eksempel-butik.dk/vare/DK-1005;https://www.eksempel-butik.dk/billeder/DK-1005.jpg;Hjem & køkken;Kvalitetsvare fra Bosch. Nem at gøre ren.;Ny

Lataa tiedosto mervo-eksempel-latin1.csv

Sarkaimin eroteltu teksti

Varenummer	Produktnavn	Pris	Førpris	Frakt	Lagerstatus	Leveringstid	Merke	EAN	Produkt-URL	Bilde	Kategori	Tilstand
N-1	Bærbar høyttaler Ørn – blå	kr 1 299,-	kr 1 599,-	99	På lager	2-4 dager	JBL	7000000000409	https://www.eksempelbutikk.no/p/n-1	https://www.eksempelbutikk.no/i/n-1.jpg	Lyd	Ny
N-2	Stekepanne i støpejern 28 cm	649,00		0	Utsolgt	1-2 dager	Skeppshult	7000000000409	https://www.eksempelbutikk.no/p/n-2	https://www.eksempelbutikk.no/i/n-2.jpg	Kjøkken	Ny
N-3	Regnjakke Dame, gul	899 kr		79	På lager	1-3 dager	Helly Hansen		https://www.eksempelbutikk.no/p/n-3		Klær	Brukt

Lataa tiedosto mervo-eksempel.tsv

JSON

{
  "products": [
    {
      "id": "J-1",
      "name": "Sähköpyörä Kaupunki 28\"",
      "price": "1 799,00 €",
      "regular_price": "1 999,00 €",
      "stock": "Varastossa",
      "delivery_time": "5-10 päivää",
      "brand": "Tunturi",
      "ean": "6400000000507",
      "url": "https://www.kauppa.fi/p/j-1",
      "category": "Pyörät"
    },
…

Lataa tiedosto mervo-esimerkki.json

Syötteen virheet ja niiden korjaaminen

Kaikki ohjeartikkelit