Tämän ohjeen avulla viet ja tuot AI Commerce -alustan asiakastilejä hallitusti CSV-tiedostoina. Opit, miten vältät tyypilliset datatyyppivirheet (esim. puhelinnumeroiden etunollien katoaminen) ja miten päivitys vs. uuden asiakkaan luonti ratkaistaan automaattisesti asiakastunnuksen (customers_id) perusteella.

Mistä editoidaan

• Hallintapaneeli > Customers → painike CSV Export Customers
• Hallintapaneeli > Customers → painike CSV Import Customers

Turvallinen työskentely CSV:llä

• Käytä aina ensin CSV Export Customers -tiedostoa importin pohjana, jotta sarakenimet, -järjestys ja arvot ovat varmasti oikein.
• Yleisohje AI Commercessa: muokkaa vain niitä sarakkeita, joita tarvitset. Älä jätä muita sarakkeita tyhjiksi, sillä tyhjä arvo tulkitaan tietojen tyhjentämiseksi — poista mieluummin koko sarake, jos et halua koskea siihen.
• Asiakastilien importissa turvallisin ja tuetuin tapa on säilyttää vientitiedoston täydellinen sarakejoukko ja järjestys, jolloin et vahingossa korvaa tai tyhjennä arvoja.
• Vältä taulukkolaskennan automaattimuunnoksia (esim. numerot → päivämäärä, puhelinnumeroiden etunollat). AI Commerce ei voi vaikuttaa siihen, miten avaamasi ohjelma muuttaa CSV:n sisältöä, joten toimi varovaisesti.
• Kirjainkoko on tärkeä: otsikoiden isot ja pienet kirjaimet on säilytettävä täsmälleen samoina. Älä muuta otsikoita.
• Ennen massapäivityksiä muokkaa yksi asiakas käyttöliittymän kautta ja tarkista vientitiedoston arvomuodot — älä arvaile datatyyppejä.

CSV Export Customers

Mitä tulee ulos? Toiminto tuottaa latauksena CSV-tiedoston, jossa on asiakkaan perustiedot, osoitetiedot, lisätiedot ja tilausmäärä. Alla on esimerkki vientiotsikon sarakkeista. Säilytä importissa niiden sarakkeiden nimet, joita haluat muokata.

Vientidatan rakenne

• Vienti yhdistää asiakkaan perustiedot, oletusosoitteen (toimitus- ja laskutuselementit), asiakkaan lisätiedot ja tilausmäärän.
• entry_country_code ja billing_country_code ovat aina kaksikirjaimisia maatunnuksia (esim. FI, SE).
• number_of_orders on 0, jos tilauksia ei ole.

CSV Import Customers

Hyväksytty muoto ja validoinnit

• CSV:ssä on oltava otsikkorivi. Jokaisen rivin sarakemäärän on täsmättävä otsikkoon, muuten prosessi keskeytyy virheeseen.
• Järjestelmä käy tiedoston läpi ja tarkistaa jokaisella rivillä, onko customers_id-tunnus jo olemassa. Tämän perusteella se päättää, onko kyseessä päivitys vai uusi asiakas.
• Kenttien käsittely perustuu otsikkorivin sarakenimiin. Tunnetut sarakkeet kohdistetaan oikeisiin asiakastietoihin ja osoitekenttiin, tuntemattomat sarakkeet ohitetaan.
• customers_id ja number_of_orders voidaan lukea raportointia ja seurantaa varten, mutta niitä ei muuteta CSV-importin kautta.

Päivitys vs. lisäys

• Päivitys (kun customers_id löytyy jo järjestelmästä): päivitetään annetut asiakkaan perustiedot, lisätiedot ja oletusosoitteen kentät.
• Jos asiakkaalla ei ole oletusosoitetta, import luo sen ja asettaa oletukseksi.
• Maat annetaan CSV:ssä kaksikirjaimisina koodeina (esim. FI, SE). Järjestelmä muuntaa ne sisäiseen muotoon automaattisesti.
• Lisäys (tyhjä tai tuntematon customers_id): luodaan uusi asiakas, jolle voidaan antaa asiakasryhmä (customers_group) CSV:n perusteella, ja luodaan samalla oletusosoite.
• Jos asiakastilin luontipäivää (customers_info_date_account_created) ei ole CSV:ssä, järjestelmä käyttää tämänhetkistä päivämäärää.

CSV-avain määrittää tuotavat tiedot

• Kaikki yllä luetellut vientiotsikon sarakkeet kelpaavat importtiin.
• Osoitteiden maat annetaan ISO2-koodeina entry_country_code ja billing_country_code -sarakkeissa. Muut osoitekentät (entry_street_address, entry_postcode, laskutuskentät jne.) täytetään vastaavasti.
• Sarakkeiden nimet ja kirjainkoko on vastattava vientiotsikkoa, jotta kohdistus onnistuu.

Tiedoston tallennus importissa

• Ladattu CSV tallentuu automaattisesti järjestelmän arkistoon, jotta siihen voidaan palata esimerkiksi virheiden selvittelyssä tai myöhempää tarkastelua varten.
• Jos tiedoston lataus epäonnistuu, järjestelmä ilmoittaa virheestä heti, eikä mitään tietoja tuoda.

Vinkit ja riskienhallinta

• Puhelinnumerot: monet ohjelmat poistavat etunollat. Pelkkä vienti → import “sellaisenaan” voi korruptoida kaikki numerot, jos muokkaustyökalu muuttaa ne. Tarkista asetukset tai käsittele kentät tekstinä.
• Päivitys ankkuroituu customers_id-arvoon. Jos tunnus ei vastaa järjestelmässä olevaa asiakasta, rivi käsitellään uutena asiakkaana.
• Jos et halua muokata tiettyä saraketta etkä käytä täydellistä vientipohjaa, poista sarake kokonaan äläkä jätä arvoja tyhjiksi.
• Testaa aina pienellä otoksella ennen massatuontia.

Yhteenveto / seuraava toimenpide

Lataa CSV Export Customers, tee tarvittavat muutokset säilyttäen sarakenimet ja -järjestyksen (tai poista kokonaan sarakkeet, joihin et koske), ja aja tiedosto sisään CSV Import Customers -toiminnolla. Varmista erityisesti customers_id-logiikka (päivitys vs. lisäys) sekä entry_country_code/billing_country_code -arvojen oikea kaksikirjaiminen maatunnus (esim. FI, SE).

Avainsanat

• AI Commerce CSV import
• CSV Export Customers
• customers_id päivitys
• asiakastilit massamuokkaus
• ISO2 country code
• customers_group
• newsletter päivitys
• Hallintapaneeli Customers
• asiakasosoitteet CSV
• customer import security