# Leverandørdata til Akeneo, mappet visuelt

Leverandøren din sender et regneark. Akeneo vil ha et produktdokument med riktig familie, kanal, lokalitet og valuta på hver verdi. SDM Portal er mapping-laget imellom: du bygger det én gang per leverandør, og hver senere fil gjentar de samme reglene.

Nettversjon: https://sdmportal.com/no/akeneo/

## Tilkoblingen

- **Protokoll:** Akeneo REST API, /api/rest/v1
- **Autentisering:** OAuth2 password grant: client ID, secret, brukernavn, passord
- **Utgaver:** Community Edition 7 og Serenity, oppdaget ved handshake
- **Struktur:** Familie
- **Skriving:** ND-JSON PATCH /products, opptil 100 per batch
- **Delta sync:** Dokumenthash per produkt

## Der en leverandørfeed til Akeneo faktisk stopper

### Attributter hører til familier

En leverandørkolonne betyr ingenting før du vet hvilken familie den hører til. Velg familien, og attributtskinnen begrenses til attributtene i den familien, i familiens egen rekkefølge.

### Hver verdi har en dimensjon

Akeneo-verdier bærer en lokalitet og, for scopable attributter, en kanal. En pris er en samling med en valuta. En metrisk verdi er et tall pluss en enhet. Tar du feil på én av dem, blir verdien avvist.

### Alternativer er koder, ikke etiketter

En select-verdi må ende opp i en eksisterende alternativkode med tegnene Akeneo godtar. Leverandørfiler sender i stedet etiketter som Navy Blue.

## Slik skriver SDM Portal til Akeneo

### Mapping per familie

Velg familien og attributtskinnen begrenses til den, med familiens attributtrekkefølge intakt. Identifier-attributtet utelates, og i stedet legges det inn et systemfelt kalt esa_sku, slik at du mapper SKU som enhver annen kolonne, akkurat som på Ergonode.

### Lokalitet på forbindelsen

De aktiverte lokalitetene kommer fra din egen instans. Lokalitet er en egenskap ved forbindelsen du tegner, så tre beskrivelseskolonner kan fylle ett attributt på tre språk. Et lokaliserbart attributt tar lokaliteten fra forbindelsen; et ikke-lokaliserbart beholder den første verdien og gir en advarsel.

### Kanal og valuta per profil

Publiseringsinnstillingene holder kanalen og standardvalutaen for profilen, foreslått fra dine egne kanaler og begrenset til valutaene i den kanalen. En scopable verdi uten konfigurert kanal blir droppet med en advarsel. Sett dette før godkjenning: en endring endrer hver dokumenthash og tvinger en full ny push.

### Prissamlinger, flere valutaer

Valuta er også en egenskap ved en forbindelse. Flere kildekolonner, for eksempel price_eur og price_usd, slås sammen til én prissamling på ett attributt. Å blande forbindelser med valuta og forbindelser uten lar tørrkjøringen feile i stedet for å gjette.

### Metriske attributter

En metrisk verdi skrives som et tall pluss attributtets standard metriske enhet. Et attributt uten standardenhet dropper verdien og sier det, i stedet for å skrive et tall uten enhet.

### Oppretting av alternativer med etiketter

Manglende select-alternativer opprettes med etiketter per lokalitet. Kodene må bruke tegnene Akeneo tillater, og en ugyldig kode blir avvist med et forslag til retting i stedet for å bli skrevet om i stillhet, så koden du ser er koden som havner der.

### Nye attributter fra editoren

Opprett attributter av typen text, textarea, number, date, simple select, multi select, boolean, price collection og metric uten å forlate lerretet. Hver type trenger en attributtgruppe; metric trenger også en familie og en standardenhet. Det nye attributtet legges til profilens familie med en PATCH som leser og føyer til, så ingenting annet i familien berøres.

### Reference entities på Serenity

Et reference entity-attributt oppfører seg som en select, og collection-varianten som en multi select. Alternativlisten er postene i den koblede entiteten, så du mapper leverandørverdier rett på postkoder.

### Skrivemekanikk du kan revidere

Produkter sendes som ND-JSON-batcher på opptil 100. Hver linje kommer tilbake som opprettet, oppdatert eller avvist, og en avvisning rapporteres per attributt. Rate limits respekteres fra svaret. Hvert produkt bærer en dokumenthash, så en ny kjøring av en uendret fil skriver ingenting. I modusene create og update sjekkes det først hva som finnes, i blokker på 500 SKU-er.

## Hva vi kan skrive til Akeneo

Select- og multi select-verdier mappes til alternativkoder, og manglende alternativer kan opprettes med etikettene sine. Kategorier tilordnes per produkt som et sett uten duplikater.

- Tekst
- Textarea
- Tall
- Dato
- Simple select
- Multi select
- Boolean
- Prissamling, flere valutaer
- Metric
- Kategorier
- Reference entity
- Reference entity collection

## Hva Akeneo-connectoren ikke gjør ennå

### Product models og varianter (varianter)

Variantakser er i dag en Ergonode-funksjon. På en Akeneo-profil er variantmarkørene skjult. Hvis en eldre flyt fortsatt bærer dem, skrives barna som selvstendige produkter og foreldrene hoppes over med én samlet advarsel.

### Media, tabeller, identifier (ikke skrivbar)

Bilde- og mediaattributter, tabellattributter og identifier-attributtet er synlige i skinnen, men ikke skrivbare. De forblir lesbare slik at du ser hele familien.

### Reference entity-poster (kun lesing)

Poster i en reference entity leses som alternativer, aldri opprettet. Etiketten deres er postkoden, så velgeren viser koder.

### Arbeidsflytstatus (ignorert)

Akeneo har ingen arbeidsflytstatus på produkter. En statusmapping som er tatt med fra en Ergonode-flyt, ignoreres med én advarsel i stedet for at kjøringen feiler.

### Custom fields på alternativer (kun ergonode)

Akeneo-alternativer har etiketter, men ingen custom fields, så berikingsfunksjonene for alternativer forblir skjult på en Akeneo-profil.

### Slette attributter (enveis)

Et attributt som er opprettet via API-et, kan ikke slettes igjen via CE 7-API-et. Opprett dem bevisst.

## FAQ

### Hvilke Akeneo-versjoner støtter SDM Portal?

Akeneo Community Edition 7 og Serenity. Utgaven og versjonen oppdages under tilkoblingens handshake og vises på tilkoblingsraden, så du ser nøyaktig hva du er koblet til.

### Hvordan autentiserer SDM Portal seg mot Akeneo?

Via en Akeneo API-tilkobling: client ID, client secret, brukernavn og passord over OAuth2 password grant. Bearer-tokenet caches per tilkobling og fornyes én gang ved en 401. Legitimasjonen lagres kryptert og er aldri en del av en eksportert mapping.

### Støtter SDM Portal Akeneo product models og varianter?

Ikke ennå. Variantakser og bindings er i dag en Ergonode-funksjon. På en Akeneo-profil er variantmarkørene skjult, og en flyt som fortsatt bærer dem, skriver barna som selvstendige produkter og hopper over foreldrene med én advarsel.

### Hvordan håndteres kanaler, lokaliteter og valutaer?

Lokalitet er en egenskap ved mapping-forbindelsen, så tre beskrivelseskolonner kan fylle ett attributt på tre språk. Kanal og standardvaluta settes per profil i publiseringsinnstillingene, foreslått fra dine egne kanaler. Et prisattributt kan motta flere valutaer samtidig ved å sette en valuta per forbindelse.

### Kan jeg se hva som skjer før noe skrives til Akeneo?

Ja. En tørrkjøring viser resultatet rad for rad, med advarsler for umappede verdier og droppede felt, og skriver ingenting. Kjøringer kan gå til et staging-Akeneo først og produksjon etterpå, og delta sync betyr at bare endrede produkter sendes på nytt.

## Kom i gang

Prøv gratis i 14 dager: https://app.sdmportal.com/signup?lang=no

Andre PIM-er: https://sdmportal.com/no/ergonode/ · https://sdmportal.com/no/akeneo/ · https://sdmportal.com/no/pimcore/

SDM Portal.