Flödesspecifikation

Format

Vi läser Prisjakt-format (CSV eller XML), PriceRunner-format (CSV eller XML), Google Shopping (RSS eller Atom med namnrymden g:), CSV eller annan avgränsad text, annan XML och JSON.

Vi känner igen syntaxen från själva filen. I avgränsad text hittar vi avgränsaren (komma, semikolon, tabb eller lodstreck). I XML och JSON läser vi den största listan med produkter. Google-flöden känns igen på sin namnrymd, och där ett fält upprepas per land använder vi posten för ditt land.

Teckenkodning och komprimering

Teckenkodningar: UTF-8, UTF-16, ISO-8859-1, Windows-1252. En byte order mark eller XML-deklarationen avgör först. Utan dem provar vi UTF-8, och annars läser vi filen som Windows-1252.

Nordiska flöden i Latin-1 fungerar: vi läser dem som Windows-1252, som har samma Å, Ä, Ö, Æ och Ø och dessutom klarar € och typografiska citattecken.

Komprimering: gzip, zip. En zip-fil ska innehålla exakt en flödesfil.

Adress, storlek och tidpunkt

Ditt flöde ska ligga på en fast https://- eller ftp://-adress som alltid ger ditt senaste flöde. Adresser med datum eller tidsstämpel i avvisas.

Upp till 200 MB. Vi hämtar det med 6 timmars mellanrum, vid en tid som sprids ut över dygnet för varje butik.

Priser

Alla priser i SEK, inklusive moms, som dina kunder ser dem. En pris- eller valutakolumn i en annan valuta stoppar hela importen. ”kr” godtas så länge det är din valuta.

Skriv priserna som din butik gör: komma eller punkt för decimaler, mellanslag eller punkt mellan tusental, och ":-" eller ",-" för hela belopp fungerar.

Fält

Namn matchas oavsett versaler, mellanslag, accenter och namnrymder, så "Ordinarie pris", "ordinarie_pris" och "g:ordinarie pris" är samma sak.

Vad vi förväntar oss i varje fält

• GTIN eller EAN: en kod med giltig kontrollsiffra. En ogiltig kod ignoreras, men inte raden. Med en GTIN kan vi matcha ditt erbjudande mot rätt produkt.
• MPN: sparas som du skickar det.
• Lagerstatus: ett tal över noll, eller ett ord som ”i lager” eller ”in stock”. Ett okänt ord räknas som slut i lager. Utan lagerkolumn räknas varje rad som i lager.
• Leveranstid: ett tal eller ett intervall i dagar, veckor eller timmar. ”Idag” räknas som noll dagar. Värden över 365 dagar ignoreras.
• Varianter: skicka varje variant som en egen rad med eget SKU, och lägg färg och storlek i egna kolumner. Vi har inget fält för variantgrupper.
• Bilder: en bildadress per rad.

Förpris och rabatt i procent

Förpris: priset du visar överstruket eller som tidigare pris. Kolumnnamn som fungerar är bland annat glpris, gammelpris, oldprice, productpriceold, ordinariepris, ordpris, normalpris, forpris, tidigarepris, normaalihinta, aiempihinta, alkuperainenhinta, regularprice, originalprice, wasprice, compareatprice, beforeprice, referenceprice.

Rabatt i procent: kolumnnamn som fungerar är bland annat rabatt, rabattprocent, rabattpct, rabat, rabatprocent, discount, discountpct, discountpercent, discountpercentage, alennus, alennusprosentti, alennuspct, prosentrabatt, rabattprosent. Vi godtar värden över noll och under hundra.

Skickar du i stället ett kampanjpris under ditt normalpris räknas normalpriset som förpris.

Utan förpris eller procentsats räknar vi med att erbjudandet inte annonserar någon sänkning, och det får ingen priskontroll. Med bara en procentsats räknar vi ut vilket förpris den motsvarar. Är det högre än ditt lägsta pris under perioden står det i resultatet att dina priser inte styrker rabatten. Ett förpris som inte är högre än ditt nuvarande pris ignoreras.

Medlemspris: kolumnnamn som fungerar är bland annat loyaltyprice, loyaltyprogramprice, memberprice, clubprice, medlemspris, klubbpris, kundeklubbpris, klubpris, medlemspriser, jasenhinta, kantaasiakashinta. Där medlemspriser räknas in i det lägsta priset använder vi dem i kontrollen.

Exempel

Varje exempel kommer från filerna vi testar importen med. De första raderna visas här. Nedladdningen har några till.

Exemplen använder valutan på marknaden de gjordes för. Ditt flöde ska använda SEK.

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;;

<?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>
…

<?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>
…

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

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

{
  "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"
    },
…

Fel i flödet och hur du åtgärdar dem