Dokumentácia CSV - kategórie
Import
- Súbor so vzorovým obsahom (kódovanie Windows-1250)
- Importujú sa všetky stĺpce okrem tých, čo sú označené (len export) podľa Definícií záhlaví jednotlivých stĺpcov.
- Zákazníci sa pri importe párujú podľa e-mailu.
- Všetky stĺpce sú nepovinné, okrem e-mailu.
- Systém eviduje 3 druhy zákazníkov:
- kontakt - [CUSTOMER_YN] = 0 a [COMPANY_YN] = 0
- zákazník osoba - [CUSTOMER_YN] = 1 a [COMPANY_YN] = 0
- zákazník firma - [CUSTOMER_YN] = 1 a [COMPANY_YN] = 1
- Pokiaľ neuvediete [CUSTOMER_YN] a [COMPANY_YN], zákazník sa založí ako kontakt.
- V prípadoch, kedy je [CUSTOMER_YN] = 1 (osoba alebo firma), musí byť vyplnené aj meno [FIRSTNAME] a priezvisko [SURNAME], inak sa zákazník založí ako kontakt.
- Ignorujú sa všetky stĺpce, ktoré majú neznámy názov v záhlaví (viď definície záhlaví jednotlivých stĺpcov).
- Pokiaľ bude nejaká hodnota v CSV prázdna, na e-shope dôjde po importe k jej zmazaniu.
- Nepoužívané stĺpce môžete zmazať (pozor, ale aj so záhlavím).
- Nezáleží na poradí stĺpcov.
- Ďalšie veci môžete ovplyvniť nastavením importu v administrácii (viď nápoveda).
Export
- Exportujú sa všetky stĺpce podľa Definícií záhlaví jednotlivých stĺpcov.
Dátové typy
Vysvetlivky, aké hodnoty je možné vkladať do daných stĺpcov.
- bool - true / false, 1 / 0, áno / nie, yes / no
- string - štandardný reťazec znakov v UTF-8
- int - celé číslo
- float - desatinné číslo, ako oddeľovač desatinných miest používajte bodkočiarku
- array - pole hodnôt oddelených bodkočiarkou. Napr. obrazok1.jpg;obrazok2.png;obrazok3.svg
- email - validná e-mailová adresa
- date - dátum zapísaný ako reťazec znakov vo formáte YYYY-MM-DD podľa ISO 8601. Y je rok, M je mesiac a D je deň. Príklad: 2020-12-30
- language - kód jazyka podľa ISO 639-1
- currency - kód meny podľa ISO 4217
- country - kód krajiny podľa ISO 3166-1 alpha-2
Definície záhlaví jednotlivých stĺpcov
- [CUSTOMER_YN] (bool) - 1 = zákazník (registrovaný; má zákaznícky účet); 0 = kontakt (neregistrovaný zákazník).
- [COMPANY_YN] (bool) - 1 = firemný zákazník (má vyplnené firemné údaje); 0 = osoba zákazník.
- [DEGREE] (string) - Titul pred menom.
- [FIRSTNAME] (string) - Krstné meno.
- [SURNAME] (string) - Priezvisko.
- [NICKNAME] (string) - Prezývka.
- [CODE] (string) - Zákaznícke číslo. Pokiaľ nie je uvedené, vyplní sa automaticky podľa číselného radu.
- [LANGUAGE] (language) - Dvojmiestny kód jazyka, pod ktorým bol kontakt vytvorený. Jazyk musí byť založený v administrácii.
- [NEWSLETTER_ACCEPT] (string) - Zákazník chce / nechce dostávať newsletter. Možné hodnoty sú:
- yes - je prihlásený k odberu newslettera,
- no - je odhlásený z odberu newslettera,
- notset alebo prázdna hodnota - nie je nastavené,
- excluded - je vyradený z odberu (bol prihlásený, ale neotvoril žiadny newsletter).
- [CAN_SEE_PRIVATE_YN] (bool) - Zákazník vidí / nevidí neverejný obsah.
- [SET_PRICELIST_BY_TURNOVER_YN] (bool) - Nastavený cenník podľa obratu zákazníka.
- [PRICELIST] (string) - Názov cenníka, ktorý má zákazník pridelený. Páruje sa podľa existujúcej hodnoty v databáze (v hlavnom jazyku) a pokiaľ neexistuje, nezakladá sa automaticky nová! Cenník je možné aktualizovať len vtedy, keď je [CUSTOMER_YN] = 1 (osoba alebo firma).*
- [DEFAULT_TURNOVER] (float) - Východisková hodnota obratu.
- [TURNOVER] (float) - Obrat zákazníka (len export).
- [TURNOVER_CURRENCY] (currency) - Mena obratu zákazníka (len export).
- [LOYALTY_SYSTEM] (int) - Počet bodov získaných vo vernostnom systéme.
- [COMPANY_NAME] (string) - Názov spoločnosti.
- [COMPANY_NUMBER] (string) - IČ.
- [VAT_NUMBER] (string) - DIČ.
- [VAT_PAYER_YN] (bool) - Je / nie je platca DPH.
- [PHONE] (string) - Telefón, len čísla a znak + na začiatku, všetky ostatné znaky budú odstránené.
- [FAX] (string) - Fax.
- [IM] (string) - Instant messaging.
- [SALUTATION] (string) - Oslovenie zákazníka (v jeho jazyku).
- [DECLENSION] (string) - Skloňovanie zákazníkovho mena v 5. páde.
- [ACTIVE_YN] (bool) - Povolenie alebo zakázanie prihlásenia zákazníka do zákazníckeho účtu.
- [BLOCKED_YN] (bool) - Blokovaný zákazník.
- [EMAIL] (email) - Jednoznačný identifikátor zákazníka (POVINNÝ). Prihlasovací údaj do zákazníckeho účtu v prípade zákazníka. Páruje sa podľa existujúcej hodnoty v databáze, alebo vytvorí nového zákazníka.
- [PASSWORD] (string) - Heslo pre prihlásenie do zákazníckeho účtu. Pokiaľ je uvedené, bude nový zákazník založený s týmto heslom a existujúcemu sa zmení. Pokiaľ nie je uvedené, existujúcemu zákazníkovi zostane pôvodné heslo a novému sa vygeneruje náhodné.
- [GROUPS] (string) - Názov skupiny. Páruje sa podľa existujúcej hodnoty v databáze (v hlavnom jazyku), alebo vytvorí novú.**
- [NOTE] (string) - Poznámka k zákazníkovi.
- [CAN_RATE_PRODUCTS_YN] (bool) - Môže hodnotiť produkty - hviezdičky, recenzie.
- [ORDER_COUNT] (int) - Počet objednávok (len export).
- [BILLING_STREET] (string) - Fakturačná ulica.
- [BILLING_CITY] (string) - Fakturačné mesto.
- [BILLING_STATE] (string) - Fakturačný kraj.
- [BILLING_ZIP_CODE] (string) - Fakturačné PSČ.
- [BILLING_COUNTRY_ID] (country) - Fakturačný dvojmiestny kód krajiny.
- [POSTAL_COMPANY_NAME] (string) - Doručovací názov firmy.
- [POSTAL_FIRSTNAME] (string) - Doručovacie meno.
- [POSTAL_SURNAME] (string) - Doručovacie priezvisko.
- [POSTAL_STREET] (string) - Doručovacia ulica.
- [POSTAL_CITY] (string) - Doručovacie mesto.
- [POSTAL_STATE] (string) - Doručovací kraj.
- [POSTAL_ZIP_CODE] (string) - Doručovacie PSČ.
- [POSTAL_COUNTRY_ID] (country) - Doručovací dvojmiestny kód krajiny.
- [AGREEMENT_TIME „názov súhlasu“] (date) - Čas vyhotovenia súhlasu. Pokiaľ bude prázdne alebo nebude uvedené, berie sa aktuálny čas vytvorenia súhlasu. Názov súhlasu sa páruje s existujúcim súhlasom v databáze, pokiaľ zodpovedajúci súhlas neexistuje ignoruje sa.*
- [AGREEMENT_VALID_TO „názov súhlasu“] (date) - Čas, dokedy je súhlas platný. Pokiaľ bude prázdne alebo nebude uvedené, berie sa z nastavení konkrétneho súhlasu. Názov súhlasu sa páruje s existujúcim súhlasom v databáze. Pokiaľ zodpovedajúci súhlas neexistuje ignoruje sa.*
- [AGREEMENT_STATUS „názov súhlasu“] (string) - Stav súhlasu, áno / nie, môže nadobudnúť hodnoty 1/0. Názov súhlasu sa páruje s existujúcim súhlasom v databáze. Pokiaľ zodpovedajúci súhlas neexistuje, ignoruje sa.*
- [META „kľúč vlastného poľa“] (string) - Vlastné pole.
* Páruje sa podľa existujúcej hodnoty v administrácii. Pokiaľ hodnota neexistuje ignoruje sa.
** Páruje sa podľa existujúcej hodnoty v administrácii. Pokiaľ hodnota neexistuje, vytvorí sa v nastavení nová.