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.

Varatut attribuutit

1. sku
2. brand
3. extra_image_1 – extra_image_10
4. name
5. availability_in_stock
6. availability_out_of_stock
7. model_name
8. ean
9. image
10. weight
11. cargo_weight
12. width
13. length
14. height
15. status
16. short_description
17. store_description
18. description
19. video_link
20. link_href
21. link_title
22. products_location
23. vat_rate
24. price_current
25. price_purchase
26. price_business
27. shipping_fee
28. pdf
29. pdf_extra
30. package_size
31. package_unit
32. products_group
33. is_forced_stock_check
34. comment_instructions
35. variant_image
36. color_specification
37. date_in_stock
38. products_link_href
39. products_link_title
40. sort
     

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
• material – attribuuttia ei yhdistetä kaupan materiaaliin, vaan se toimii omana attribuuttina bisneslogiikkanne vaatimalla tavalla.
• 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

1. Nollaa attribuutti tuotteen arvoista (esim. poistamalla tiedoston, pyyhkimällä arvon).
2. Poista attribuutti Akeneosta tai jätä se käyttöön vain siinä merkityksessä, johon AI Commerce on sen suunnitellut.
3. 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.