Når I benytter Shipmondo Ordrehåndtering, importerer vi løbende jeres varer fra webshoppen og opretter dem i Shipmondo.
En vare i Shipmondo har følgende data-felter:
SKU
Navn
Variantkode
Stregkode
Placering
Billede
Valuta
Salgspris
Virtuel
Kan ikke refunderes
Oprindelsesland
Indhold
Tarif
Vægt
Når I opsætter en ordreintegration, så henter vi data fra nogle standard-felter fra jeres webshop.
I har dog mulighed for selv at bestemme/overstyre, hvilke felter data skal hentes fra, når Shipmondo importerer jeres varer.
Vi understøtter også hentning af data fra meta-felter (også kaldet custom-felter) på webshoppen. Metadata-felter bliver ofte brugt af tredjepart plugins/apps til at gemme data.
Det kan eksempelvis kan være, at I bruger et plugin/app til at registrere stregkoder på jeres varer eller til lagerstyring på jeres webshop, og I gerne vil have de registrerede stregkoder eller vareplaceringer overført til pak og pluk i Shipmondo.
Dette er blot nogle eksempler. Vores løsning er dynamisk og fleksibel, og vi understøtter, at I kan hente data fra både produkter og ordrelinjer fra jeres webshop.
I denne vejledning gennemgår vi, hvordan I opsætter brugerdefinerede tilknytninger af varefelter.
NB! Denne vejledning forudsætter teknisk indsigt, herunder viden om API og JSON datastruktur.
Sådan gør man
Gå til Indstillinger > Integrationer > Ordrer og klik på ordreintegrationen, som I ønsker at opsætte brugerdefinerede tilknytninger af varefelter for.
Gå til fanen Varer og tilvælg Benyt brugerdefineret tilknytning.
Her ser I vare-felter, hvor I kan opsætte brugerdefinerede tilknytninger til data-felter fra jeres webshop.
For hvert felt kan I vælge et endpoint i dropdown og angive en værdi.
Valg af endpoint
I dropdown kan I vælge det endpoint på jeres webshop, som den brugerdefineret tilknytning skal tage udgangspunkt i.
Der er følgende muligheder:
Endpoint | Beskrivelse |
Produkt | Data stammer fra webshoppens produkt-API.
Hvis der er opdeling mellem variant og hovedprodukt på webshopsystemet, har variant præcedens. |
Ordrelinje | Data stammer fra webshoppens ordre-API. |
Metadata | Data er et array af metadata fra Shopifys metafield-API.
NB! Dette endpoint kan kun bruges for Shopify-shops. |
Angivelse af sti
I feltet værdi skal I angive stien til nøglen i JSON-objektet/-svaret fra webshoppens API, hvor data skal hentes fra.
Der er tre regler/scenarier, som I skal være opmærksomme på, når I angiver stien.
For at støtte forklaringen, er der til højre i tabellen angivet eksempler, der tager udgangspunkt i JSON-objektet, som I finder efter tabellen.
Regler/scenarier | Eksempel |
Hvis der skal peges på en værdi, som ligger i roden af objektet, så skal nøglen til den property angives. | Ønske: I ønsker at overskrive feltet for SKU i Shipmondo med data fra feltet “model” fra produktet i webshoppen. Løsning: I vælger Produkt i feltet endpoint og skriver “model” i feltet værdi. |
Hvis der skal peges på en værdi, som befinder sig i et indlejret objekt, så skal stien til den property angives.
Der skal benyttes punktum (.) til at indikere, at der er tale om et indlejret objekt. | Ønske: I ønsker at overskrive feltet for Placering i Shipmondo med data fra feltet "section" fra produktet i webshoppen. Løsning: I vælger Produkt i feltet endpoint og skriver “stock_location.section” i feltet værdi. |
Hvis værdien er indeholdt i et array af objekter, angives en nøgle og en tilhørende værdi fra arrayet, efterfulgt af destinationsnøglen.
| Ønske: I ønsker at overskrive feltet for Stregkode i Shipmondo med data fra feltet "value" under "custom_barcode".
Løsning: I vælger Produkt i feltet endpoint og skriver “custom_attributes.attribute_code.custom_barcode.value” i feltet værdi. |
For Shopify og WooCommerce metadata er det ikke nødvendigt at angive hele stien for nøglen, hvis den ligger på standard stien for metadata. Det er muligt at kun at angive nøglen, da der søges som standard på disse stier.
JSON-objekt eksempel
JSON-objekt i eksemplerne, der er gennemgået foroven.
{
"id": 12,
"name": "Playstation 4",
"is_enabled" :true,
"allow_no_stock": false,
"is_shippable": true,
"model": "ITM-A1231",
"custom_attributes": [
{
"attribute_code": "image",
"value": null
},
{
"attribute_code": "custom_barcode",
"value": "A0-A0-A0"
},
{
"attribute_code": "options_container",
"value": "container2"
}
],
"stock_location": {
"section": "A0-A1-A2"
}
}
Opsætning af brugerdefinerede tilknytninger eksempel
Angivelse af sti i eksemplerne der er gennemgået foroven.