Importér produkter via CSV

Du kan nemt importere dine produkter fra en CSV-fil ind i Shoporama. I denne artikel kan du læse hvordan du gør, og hvordan det virker.

Forskellen på CSV og JSON import

Shoporama har to typer import. CSV er produkter, der kommer fra en komma-separeret fil (men i praksis oftest semikolon-separeret). JSON er et andet format, hvor du kun kan importere en fil du tidligere har eksporteret fra Shoporama. Resten af denne artikel handler udelukkende om CSV-import.

Hvad kan man bruge CSV-import til?

CSV-import er en nem måde at oprette eller redigere mange produkter på i Shoporama. Det bruges typisk når man flytter sin shop til Shoporama. Så kan man eksportere produkterne fra sin gamle shop og importere dem i Shoporama. Det kan også bruges hvis du ønsker at opdatere dine produkter.

Hvordan skal CSV-filen være udformet?

En CSV-fil er ret simpel. For at Shoporama kan læse den, skal den være i et format som dette:

own_id;price;name
334455;48.00;Brun t-shirt
667788;170;Sort t-shirt

Det du ser herover er det mest simple format. Den første linje angiver hvilke felter der er tale om (her SKU, pris, og navn). Du må også gerne lave filen sådan her:

produktid;pris;navn
334455;48.00;Brun t-shirt
667788;170;Sort t-shirt

Shoporama genkender også danske kolonnenavne. Pris, Lagerstatus, Leveringstid, Kategori, Mærke, Leverandør, og Beskrivelse virker direkte. Auto-matchet er også uafhængigt af store og små bogstaver samt overskydende mellemrum, så "Pris", "price", " price ", og "PRICE" giver samme resultat. Hvis et felt ikke matcher automatisk, kan du altid vælge det manuelt i import-wizardens dropdown.

Hvordan importerer man billeder?

Skal du importere billeder, skal du angive URL'en til billedet. Bemærk at det skal være en absolut URL som vores server kan tilgå. Der skal stå https://www.ditdomæne.dk foran. Du kan ikke bare angive /images/product533.jpg, for så ved vores server ikke, hvor den skal lede efter billedet. Billedet må heller ikke ligge bag et password.

Du kan her se et eksempel på import, der også indeholder billeder:

own_id;price;name;image
334455;48.00;Brun t-shirt;http://minshop.dk/img/brun-tshirt.jpg
667788;170;Sort t-shirt;http://minshop.dk/img/sort-tshirt.jpg

Hvordan importerer man produktets profilattributter?

Har du oprettet en profil hvor du skal angive fx materiale og hvor det er produceret, kan du angive produktets profilattributter som parametre i en URL. Det vil se sådan ud hvis man har to profilattributter, som hedder hhv. "materiale" og "madein":

materiale=bomuld&madein=denmark
materiale=polyester&madein=portugal

Skal vi genbruge vores eksempel herover, vil filen se sådan ud:

own_id;price;name;attributes
334455;48.00;Brun t-shirt;materiale=bomuld&madein=denmark
667788;170;Sort t-shirt;materiale=polyester&madein=portugal

Det er i øvrigt samme måde du angiver ekstrafelter og trapperabat på (altså i URL-format). Ekstrafelter er dem, du ellers skriver i feltet Ekstra felter i produktets kort Felter. Læs mere i Importér ekstrafelter på produkter.

De to "Profil"-felter: hvad er forskellen?

På import-siden møder du "Profil" to steder, og de gør ikke det samme. Forskellen er vigtig, hvis du vil styre præcis hvilken produktprofil hvert enkelt produkt får.

• Profil-kolonnen (mapping øverst): Mapper du en kolonne i din CSV til feltet profile, vælges profilen pr. række. Findes profilen allerede på din shop, bruges den. Findes den ikke, oprettes den automatisk. Det virker både når du opretter nye produkter, og når du opdaterer eksisterende.
• Profil i importindstillingerne (nederst): Denne dropdown er kun en standardprofil. Den bruges udelukkende på nye produkter, og kun når rækken ikke selv har en værdi i Profil-kolonnen. Eksisterende produkter får ikke ændret deres profil af denne indstilling.

Kort sagt: Vil du vælge en specifik profil pr. produkt, så tilføj en kolonne med profilnavnet i din CSV, og map den til "Profil". Vil du blot have, at alle nye produkter uden profil-værdi havner på den samme profil, så nøjes med dropdown'en i importindstillingerne.

Eksempel med en profil-kolonne pr. produkt:

own_id;price;name;profile
334455;48.00;Brun t-shirt;T-shirts
667788;1200;Lædertaske;Tasker

Hvordan importerer man produkter helt praktisk?

1. Klik på "Produkter".
2. Klik på "Import/eksport".
3. Under "Importer" klikker du på "Produkter fra CSV".
4. Scroll ned i bunden og klik på knappen "Vælg fil" under "Upload CSV-fil". Vælg filen på din computer.
5. Inden upload skal du vælge separator (om dine værdier er adskilt af komma, semikolon, eller noget tredje). Du kan også angive om dine felter er omkranset af "" eller noget andet, samt hvilken encoding filen er i. Efterlad det på "auto" hvis du er i tvivl, så vil Shoporama prøve at detektere det.
6. Klik på "Upload".
7. Mapp de enkelte værdier til de felter de skal have i Shoporama. Har du angivet den første linje med navne vi kan genkende (se listen længere nede), så vil vi have valgt dem for dig.
8. Når alle felter er valgt, skal du vælge hvilken produktprofil produkterne skal oprettes med, samt hvor mange linjer du vil importere. Som default importeres alle linjer. Du har også mulighed for at angive om priserne er inkl. 25% moms eller ej.
9. Klik på "Importer". Efter et par minutter er dine produkter i Shoporama. Bemærk dog, at hvis serveren skal hente billeder fra en anden server, kan det tage adskillige minutter.

Hvilke felter kan importen genkende?

Herunder er en liste over de felter Shoporama genkender:

Felter med 1/0 værdier

Nogle felter forventer 1 eller 0 (eller tom celle). Her er hvad værdierne betyder:

Bemærk at online og offline er to sider af samme sag. Du behøver kun ét af felterne i din CSV. Vælg det der passer bedst til hvordan dine data ligger.

Felter med fritekst

• related_products og similar_products: liste af produkt-ID'er adskilt af komma
• category og main_category: flere kategorier adskilles af |, hierarki angives med > (fx Tøj > T-shirts)
• image: flere billeder adskilles af |
• extra_fields, attributes, og discount: URL-format (fx materiale=bomuld&madein=denmark). I extra_fields kan du også sætte Google Shopping custom labels, fx google-custom-label-2=sommer
• google_category: Googles kategori-id, fx 1868. Id'et finder du ved at søge i feltet Googlekategori i produktets kort Produktfeeds
• google_shopping_title: titlen i Google Shopping-feedet. Google tillader højst 150 tegn

Miljødata (EPR)

Registrerer du miljødata til producentansvar, kan du importere dem sammen med dine produkter. Kolonnerne svarer til afsnittet Miljødata (EPR) i produktets kort Jura, moms, told og miljø. Du kan læse mere om, hvad felterne betyder, i Miljødata på produkter.

Gyldige WEEE-kategorier

I env_weee_category bruger du de 7 kategorier, der har gældt siden 15. august 2018:

De 10 gamle kategorier fra før 2018 (large_equipment, small_equipment, it_telecom, consumer_equipment, lighting, electrical_tools, toys_leisure_sports, medical_devices, monitoring_control og dispensers) accepteres stadig, så ældre filer ikke går i stykker. På produktet vises de som "Gammel kategori" og bevares, indtil du vælger en ny. Shoporama oversætter dem ikke automatisk, fordi de gamle og nye kategorier ikke svarer til hinanden, så ret dem gerne til en af de 7 nye.

Gyldige værdier for batteriets kemi

I env_battery_type bruger du en af disse værdier:

Den gamle værdi button-cell (knapcelle) accepteres stadig og bevares. Knapcelle er et format og ikke en kemi, så vælg gerne kemien i stedet. Et bærbart batteri som en knapcelle angiver du med portable i env_battery_category.

Eksempel og regler

own_id;env_enabled;env_packaging_paper;env_packaging_producer;env_weee_weight;env_weee_category;env_battery_category;env_battery_type;env_battery_weight;env_battery_integrated;env_battery_replaceable
EL-100;1;120;supplier;850;small_it_telecom;portable;li-ion;45;1;0
EL-200;1;300;shop;4200;large_over_50cm;;;;;

• Husk env_enabled med værdien 1. Importerer du miljødata uden, gemmes tallene, men registreringen er slået fra. Så kommer produktet ikke med i miljødata-eksporten på ordrer, og gemmer nogen produktet i admin, mens kontakten er slået fra, slettes miljødata.
• Tomme celler ændrer ingenting. En tom celle sletter ikke en eksisterende værdi, og 0 i env_enabled slår ikke miljødata fra. Det gør du på selve produktet.
• Brug værdierne fra tabellerne. I env_weee_category og env_battery_type gør store og små bogstaver ingen forskel, så fx "Li-ion" gemmes som li-ion. I env_packaging_producer, env_weee_end_user, og env_battery_category skal du skrive værdien præcis som i tabellen med små bogstaver. I alle fem kolonner ignoreres værdier, Shoporama ikke kender, så de bliver ikke gemt.
• Eksportér først, hvis du er i tvivl. CSV-eksporten under Produkter som CSV har de samme env-kolonner, så du kan se formatet på dine egne produkter og rette direkte i filen.

Ofte stillede spørgsmål

Hvorfor er der to "Profil"-felter, og hvilket bruges?

Profil-kolonnen (som du mapper øverst) bestemmer profilen for hver enkelt række og virker på både nye og eksisterende produkter. Dropdown'en "Profil" i importindstillingerne er kun en standardprofil for nye produkter uden en profil-værdi. Vil du vælge profil pr. produkt, skal du bruge kolonnen.

Skal jeg bruge engelske kolonnenavne, og hvad hvis et navn ikke matcher?

Både danske og engelske navne fungerer. Shoporama genkender "Pris" og "price", "Lagerstatus" og "stock", "Leveringstid" og "delivery_time" osv., og store og små bogstaver gør ingen forskel. Kan en kolonne ikke genkendes, vælger du feltet manuelt i import-wizardens dropdown, eller du omdøber kolonnen til et af de understøttede navne og uploader igen.

Kan jeg importere uden at have alle felter med?

Ja. Du behøver kun de felter du vil opdatere. Du skal dog have ét unikt felt (SKU, ProductId, eller URL) så Shoporama ved hvilket eksisterende produkt der skal opdateres. Ellers oprettes nye produkter.

Hvad sker der med produkter der ikke er i CSV'en?

De bliver ikke rørt. Importen opdaterer kun de produkter der findes i filen. Vil du fjerne produkter, kan du tilføje kolonnen remove og sætte 1 på de linjer du vil slette.

Hvilken filtype skal jeg uploade?

CSV, som er en almindelig tekstfil med komma- eller semikolon-separerede felter. Du kan eksportere den fra Excel, Numbers, Google Sheets, eller dit nuværende butikssystem. Shoporama detekterer automatisk separator, indkapsling, og encoding hvis du efterlader felterne på "auto".

Skal jeg lave en backup inden jeg importerer?

Det er en god idé hvis du opdaterer mange produkter på én gang. Du kan eksportere en JSON-fil med dine nuværende produkter under "Import/eksport" og bruge den hvis noget skulle gå galt.

Jeg har importeret miljødata, men produkterne er ikke med i miljødata-eksporten. Hvorfor?

Sandsynligvis mangler kolonnen env_enabled med værdien 1. Uden den er registreringen slået fra på produktet, og så springer eksporten det over. Importér filen igen med env_enabled sat til 1, og tjek et produkt i kortet Jura, moms, told og miljø bagefter.

Vores fil bruger de gamle WEEE-kategorier. Virker den stadig?

Ja. De gamle værdier accepteres og bevares, og på produktet står der "Gammel kategori" med en opfordring til at vælge en ny. Vi oversætter dem ikke automatisk, fordi de gamle og nye kategorier ikke passer sammen. Ret gerne kolonnen til en af de 7 gældende kategorier, næste gang du importerer.

Hvordan finder jeg den rigtige batterikategori og kemi?

Kategorien handler om, hvad batteriet bruges til: almindelige batterier og batterier i telefoner og små apparater er portable, elcykler og elløbehjul er lmt, og bilbatterier er sli eller ev. Kemien står typisk på batteriet eller i leverandørens datablad, fx Li-ion. I filen skriver du li-ion, men skriver du Li-ion, retter importen det selv til små bogstaver.

Kan jeg også importere fortrydelsesret og aldersgrænse via CSV?

Nej, de to felter findes ikke i CSV-importen. Undtagelser fra fortrydelsesretten kan du sætte på mange produkter ad gangen i masseredigering af produkter. Aldersverifikation (Ingen, 15, 16 eller 18 år) vælger du på det enkelte produkt i kortet Jura, moms, told og miljø.