Mitkä attribuuttikoodit on varattu AI Commercen oletusattribuuttiryhmään?
Tutustu AI Commercen oletusattribuuttiryhmän varattuihin attribuuttikoodeihin ja niiden merkityksiin.
Sisällysluettelo
Tässä artikkelissa listataan kaikki AI Commercen ja Akeneon integraatiossa varatut attribuutit. Niitä ei tule käyttää muihin tarkoituksiin, sillä AI Commerce hyödyntää niitä sisäänrakennettuun bisneslogiikkaan (esim. rahtilaskurit, verolaskenta, tuotteen varastotilanteen hallinta). Mikäli olet jo ottanut jonkin näistä attribuuteista muuhun käyttöön, poista tai nollaa se Akeneossa tai päivitä prosessisi AI Commercen oletuslogiikkojen mukaisesti.
AI Commerce -oletus (default)
Suurin osa alla mainituista attribuuttikoodeista kuuluu jo AI Commercen oletus-attribuuttiryhmään. Kaikki näistä koodeista eivät kuitenkaan välttämättä ole mukana jokaisessa asennuksessa, sillä jokainen Akeneo-installaation ympäristö on hieman erilainen.
Samaan aikaan kaikki AI Commerce -kaupat jakavat saman rajapintaversion, joten alla oleva lista varatuista attribuuttikoodeista on universaali. Tämä tarkoittaa, että näitä koodeja ei tule käyttää muihin kuin AI Commercen sisäisiin tarkoituksiin.
Varatut attribuutit
- sku
- brand
- material
- extra_image_1 – extra_image_10
- name
- availability_in_stock
- availability_out_of_stock
- model_name
- ean
- image
- weight
- cargo_weight
- width
- length
- height
- status
- short_description
- store_description
- description
- video_link
- link_href
- link_title
- products_location
- vat_rate
- price_current
- price_purchase
- price_business
- shipping_fee
- pdf_extra
- package_size
- package_unit
- products_group
- is_forced_stock_check
- comment_instructions
- variant_image
- color_specification
- date_in_stock
- products_link_href
- products_link_title
-
sort
HUOM!
Koodien juokseva numerointi selkeyden vuoksi. Esimerkiksi extra_image_1–extra_image_9 ovat kaikki yksittäisiä attribuutteja, mutta listalla ne on yhdistetty.
Varatut mediatiedostojen attribuutit (jokainen 1–10)
AI Commerce tukee myös monia tiedostopohjaisia attribuutteja, jokaisesta 1–10 kappaletta. Nämä on tarkoitettu liitetiedostoiksi, joita näytetään tuotekortilla (esim. PDF-ohjeet, CAD-tiedostot, videot). Samaa logiikkaa noudatetaan: älä käytä näitä omiin tarkoituksiisi, jos haluat hyödyntää AI Commercen valmista sisäänrakennettua median käsittelyä. Mediatiedostoista löytyy omat ohjeartikkelit sekä AI Commerceen että Akeneoon.
- pdf_1 – pdf_10
- jpg_1 – jpg_10
- jpeg_1 – jpeg_10
- avif_1 – avif_10
- png_1 – png_10
- gif_1 – gif_10
- webp_1 – webp_10
- txt_1 – txt_10
- doc_1 – doc_10
- docx_1 – docx_10
- xls_1 – xls_10
- xlsx_1 – xlsx_10
- svg_1 – svg_10
- less_1 – less_10
- ies_1 – ies_10
- dwg_1 – dwg_10
- dxf_1 – dxf_10
- dwf_1 – dwf_10
- dwfx_1 – dwfx_10
- zip_1 – zip_10
- mp4_1 – mp4_10
- avi_1 – avi_10
- mp3_1 – mp3_10
- wav_1 – wav_10
- ogg_1 – ogg_10
- flac_1 – flac_10
- mov_1 – mov_10
- m4a_1 – m4a_10
- m4v_1 – m4v_10
- webm_1 – webm_10
- mkv_1 – mkv_10
- m3u8_1 – m3u8_10
- ts_1 – ts_10
Yllä luetellut attribuuttikoodit on siis varattu AI Commercelle, ja niissä on taustalla logiikka, joka esittelee liitetiedostot (kuten PDF-ohjeet tai IES-valotiedostot) tuotekortilla.
Mihin kukin Akeneon attribuutti liittyy AI Commercessa?
- width, length, height – rahtilaskurit ja kuljetusmittoihin liittyvä logiikka
- vat_rate – tuotteen arvonlisäveroprosentti
- price_current – perushinta (b2c)
- price_business - hinta yritysasiakkaille (b2b)
- price_purchase - hankintahinta eli ostohinta
- pdf_1 – pdf_10 (ym. tiedostoprefiksit) – dokumentit, ohjeet, piirustukset, videot…
- status – tuoteaktiivisuus
- sku, ean – yksilöivät tunnisteet
- products_location – hylly-/varastopaikka
- availability_in_stock/out_of_stock – varastosaatavuuden esitystapa
- shipping_fee – tuotekohtainen lähetyskulun hallinta
- comment_instructions - tekstiattribuutti joka ylikirjoittaa tuotekortilla näkyvän kommenttikentän ohjeistuksen (voi myös aktivoida kommenttikentän täytön pakotuksen)
- sort - tuotteiden järjestys kategorioissa, mikäli järjestys on kauppiaan valitsema
- color_specification - pääväri tuottelle. Yksinkertainen valinta. Niputtaa värin päävärin taakse → kaupan suodattimissa asiakas näkee vain päävärit → vähemmän klikkauksia.
- is_forced_stock_check - eli “Varaston ylimyynti”. Totuusarvomuunnin Akeneossa. Ottaa tuotekohtaisen saldon valvonta käyttöön.
- date_in_stock - käytetään arvioidun saatavuuspäivämäärän hallintaan. Partneri voi kustomoida näkymän käyttöliittymässä.
- jne…
Kaikki nämä ovat AI Commercessa koodaustasolla linkitetty ostoprosessiin, varastonhallintaan, kuljetuslaskentaan tai näkyvyyteen tuotesivuilla.
Jos käytit attribuuttia muuhun tarkoitukseen vahingossa
- Nollaa attribuutti tuotteen arvoista (esim. poistamalla tiedoston, pyyhkimällä arvon).
- Poista attribuutti Akeneosta tai jätä se käyttöön vain siinä merkityksessä, johon AI Commerce on sen suunnitellut.
- Halutessasi voit luoda oman, uuden attribuutin (koodilla oma_tarkoitus_1, tms.), jos haluat toteuttaa samaa asiaa ilman AI Commercen sisäisiä logiikkoja.
Yhteenveto
-
Älä käytä varattuja koodeja muihin tarkoituksiin. Niihin sisältyy mm.
sku
,weight
,vat_rate
,pdf_1..pdf_10
ja kaikki muut yllä luetellut koodit. - AI Commerce hyödyntää näitä kenttiä sisäisessä logiikassaan: verot, rahti, varastonhallinta, tuotekortin mediatiedostot ym.
- Jos vahingossa “ylikirjoitat” niitä omilla arvoilla, AI Commercen toiminnot voivat lakata toimimasta odotetusti.
- Tarvittaessa poista tai nollaa arvo, ja määritä se uudelleen vastaamaan AI Commercen oletustoimintoja.
Näin varmistat, että AI Commercessa sisäänrakennettu liiketoimintalogiikka toimii ongelmitta ja että omat lisäattribuutit eivät sekoitu alustan omiin.