Sapera kan kobles direkte sammen med en Shopify-butik, så I kun vedligeholder jeres produkter ét sted. Integrationen arbejder i begge retninger:
Fra Sapera til Shopify: produkter, varianter, priser, billeder, tags, webshopkategorier og lager sendes til Shopify.
Fra Shopify til Sapera: betalte ordrer hentes ind og bliver til salgsordrer.
Sapera er "facit" for produkter, priser og lager. Ændringer, I laver i de felter direkte i Shopify, bliver overskrevet ved næste synkronisering.
Hvad | Retning | Hvor ofte |
Produkter, varianter, priser, billeder og tags | Sapera → Shopify | Når I synkroniserer, og ca. 20 sekunder efter en ændring, når automatisk synkronisering er slået til |
Webshopkategorier som Shopify-kollektioner | Sapera → Shopify | Ved hver produktsynkronisering |
Tilgængeligt lager | Sapera → Shopify | Ved hver produktsynkronisering og når lageret ændres |
Betalte ordrer | Shopify → Sapera (som salgsordrer) | Hvert 3. minut |
Gennemførsel (fulfillment) af ordrer | Sapera → Shopify | Når salgsordren afsluttes i Sapera |
Gavekort og saldi | Begge veje | Når et gavekort ændres i Sapera, og hvert 10. minut fra Shopify |
Fra hamburger-menuen i øverste venstre hjørne åbnes Shop Manager, og i venstre menu vælges Webshop. Her finder du Webshops (selve forbindelsen), Webshopkategorier (hvilke produkter der sælges) og under Shopify skærmen Synkroniseringskørsler, hvor I følger synkroniseringen.
Kan du ikke se menupunktet, har du sandsynligvis ikke rettigheder til det. Kontakt support.
En Shopify-butik på en plan, der tillader custom apps. Skal I sælge eller synkronisere gavekort, skal planen også omfatte gavekort. Det gør udviklingsbutikker (development stores) ikke.
Shopify-butikken skal vise priser inklusive moms. Ordrer fra butikker med priser uden moms bliver ikke importeret.
I Sapera: de produkter, I vil sælge, en organisatorisk enhed, der skal eje salgsordrerne, og eventuelt en kategori med jeres fragtprodukter.
1. I Shopify admin åbnes Settings → Apps. Klik Develop apps og derefter Create an app, fx med navnet "Sapera".
2. Under Configuration → Admin API integration vælges disse adgangsområder (access scopes):
write_products – oprette og opdatere produkter, varianter, billeder og kollektioner
write_inventory – sætte tilgængeligt lager
write_publications – udgive produkter til en salgskanal
write_files – uploade produktbilleder
read_locations – læse butikkens lagerlokationer
read_orders – importere ordrer
write_merchant_managed_fulfillment_orders – gennemføre ordrer
write_gift_cards og write_gift_card_transactions – synkronisere gavekort
3. Ordreimporten skal bruge kundens navn, e-mail og adresse, så giv også appen adgang til protected customer data (navn, e-mail, telefon og adresse).
4. Installér appen og kopiér Admin API access token og API secret key.
Shopify viser kun Admin API-adgangstokenet én gang. Gem tokenet og API-hemmeligheden et sikkert sted, indtil de er indtastet i Sapera.
Åbn Webshops, klik Ny webshop og udfyld:
Felt | Hvad du indtaster |
Navn | Et valgfrit navn til webshoppen. |
Webshoptype | Shopify. |
Org. enhed | Den enhed, der ejer salgsordrerne. Dens priser sendes til Shopify, og dens lager bruges, hvis der ikke er valgt lager-enheder. |
Automatisk synkronisering | Slå til for at sende ændringer automatisk og importere ordrer hvert 3. minut. Slå den først til, når den første synkronisering er kontrolleret. |
Lager org. enhed | De enheder, hvis lager udbydes i Shopify. Lad feltet stå tomt for at bruge org. enheden ovenfor. |
Fragtkategori | Den Sapera-kategori, der indeholder jeres fragtprodukter. Fragtlinjer på ordrer kobles til disse produkter (se "Ordrer"). |
Shopify butiks-URL | Butikkens adresse, fx https://din-butik.myshopify.com. |
Admin API-adgangstoken | Tokenet fra Shopify-appen. |
API-version | Vælg den nyeste stabile version. Knappen ved siden af feltet henter de versioner, Shopify understøtter. |
API-hemmelighed | API secret key fra Shopify-appen. Den bruges ikke endnu, men udfyld den alligevel: Shopify viser den kun én gang, og den skal bruges, når Shopify på et tidspunkt selv giver Sapera besked om ændringer. I dag spørger Sapera Shopify med faste mellemrum, hvilket er mere stabilt. |
Klik derefter Hent Shopify-oplysninger for at hente butikkens lokationer og salgskanaler, vælg indstillingerne nedenfor, og klik Test opsætning. Testen viser butikken, dens valuta og tidszone, og om API-version, adgangsområder, lokation, salgskanal og (hvis slået til) gavekort er i orden. Ret alt, der er markeret som manglende, før den første synkronisering.
Indstilling | Hvad den gør | Standard |
Salgskanal | Produkterne udgives til denne Shopify-salgskanal, typisk Online Store. | Tom |
Brandhåndtering | Leverandørfelt: produktets brand-søgemærke sendes som Shopify-vendor. Synkroniser ikke: der sendes ingen vendor. Kollektion: endnu ikke tilgængelig, vælg den ikke. | Leverandørfelt |
Håndtering af lagerlokationer | Sammenlæg alle enheder i én lokation: lageret fra alle lager-enheder lægges sammen og sendes til den valgte Shopify-lokation. Tilknyt hver organisatorisk enhed til en lokation: vælg en Shopify-lokation pr. enhed; enheder uden lokation sendes ikke. | Sammenlæg alle enheder i én lokation |
Tillad opdatering af produktbeskrivelser | Når den er slået fra, sendes beskrivelsen kun, når produktet oprettes, så I kan redigere den i Shopify. | Til |
Tillad opdatering af produktbilleder | Når den er slået fra, sendes billeder kun, når produktet oprettes. | Til |
Tillad opdatering af andre produktfelter | Når den er slået fra, sendes titel, tags og vendor kun, når produktet oprettes. | Til |
Tillad opdatering af kategoribeskrivelse | Bruges ikke til Shopify. | Til |
Opret produkter i kladdetilstand | Når den er slået til, oprettes nye produkter som kladde, og Sapera ændrer aldrig deres status, så I selv udgiver dem i Shopify. Når den er slået fra, sætter hver synkronisering produkterne til Active. | Fra |
Fortsæt salg når varen er udsolgt | Bruges ikke endnu. Sæt lagerpolitikken i Shopify. | Fra |
Synkroniser gavekort | Synkroniserer gavekort og gør det muligt at sælge gavekortprodukter i Shopify (se "Gavekort"). | Fra |
Produkterne vælges via Webshopkategorier (vælg webshoppen øverst). Et produkt sendes til Shopify, når det matcher mindst én af webshoppens kategorier gennem en af kategoriens sammenkædninger:
produktet ligger i en sammenkædet Sapera-kategori,
produktet er et af de produkter, der er valgt i en sammenkædning,
produktet har et af de sammenkædede søgemærker, eller
produktets producent er en af de sammenkædede producenter.
Hver webshopkategori bliver til en Shopify-kollektion med samme navn, som indeholder de produkter, der matcher den. Når et produkt ikke længere matcher nogen kategori, sættes det til Draft i Shopify og fjernes fra sine kollektioner. Det bliver ikke slettet.
Titel og beskrivelse: webvisningsnavnet og webbeskrivelsen, eller de almindelige, hvis de er tomme.
SKU og stregkode: produktets eller variantens nummer og GTIN.
Pris: den aktuelle salgspris i org. enheden, omregnet til butikkens valuta med Saperas valutakurs. Er produktet på tilbud, vises normalprisen som compare-at-pris.
Varianter: de synlige felter i variantskabelonen bliver til Shopify-options. Shopify tillader højst 3 options.
Tags: produktets søgemærker, hvis søgemærketype er markeret til web.
Billeder: produktbilleder først, derefter variantbilleder. Billeder, I selv lægger op i Shopify, bevares.
Produkter, der allerede findes i Shopify, kobles på SKU i stedet for at blive oprettet igen.
1. Åbn Webshopkategorier og vælg webshoppen.
2. Klik Synkroniser. Beskeden "Shopify-synkronisering er igangsat" bekræfter, at den er sat i kø.
3. Følg forløbet under Shopify → Synkroniseringskørsler, fanen Produktsynkronisering. Når kørslen er afsluttet, så læs Opsummering for sprungne eller fejlede produkter.
4. Kontrollér nogle produkter i Shopify, og slå derefter Automatisk synkronisering til på webshoppen.
Synkroniser sender de produkter, der er ændret siden sidste vellykkede synkronisering (første gang alle). Tving fuld synkronisering, som kun administratorer har adgang til, sender alle produkter igen og sletter samtidig billeder i Shopify, som intet produkt længere bruger.
Ordreimporten starter fra det tidspunkt, hvor det første produkt blev synkroniseret. Ældre Shopify-ordrer importeres ikke.
Med Automatisk synkronisering slået til, og når den første synkronisering er afsluttet:
sendes produkt-, variant- og lagerændringer til Shopify ca. 20 sekunder efter, de sker,
opdateres produkterne med et søgemærke, når søgemærket ændres,
importeres betalte ordrer hvert 3. minut,
gennemføres afsluttede salgsordrer i Shopify,
synkroniseres gavekort (hvis slået til).
Mens en manuel synkronisering kører, venter de automatiske opdateringer, til den er færdig.
Shopify → Synkroniseringskørsler viser alt, hvad integrationen laver, med én fane pr. type arbejde:
Fane | Viser | Handlinger |
Produktsynkronisering | Manuelle synkroniseringer med type (Fuld / Ændringer), synkroniserede produkter, tidspunkter og en opsummering. | Kopier opsummering, Kopifejl |
Produktopdateringer | Automatiske produkt- og lageropdateringer. | Sæt fejlede i kø igen, Åbn produkt, Kopifejl |
Søgemærkeopdateringer | Ændringer af søgemærker, og hvor mange produktopdateringer de satte i kø. | Sæt fejlede i kø igen, Kopifejl |
Gavekortopdateringer | Synkronisering af gavekort. | Eksportér gavekort, Sæt fejlede i kø igen, Kopifejl |
Ordreimport | Importerede Shopify-ordrer og de salgsordrer, der er dannet ud fra dem. | Importér ordrer, Genimportér ordre, Vis erstattede, Kopifejl |
Ordreeksport | Gennemførsler sendt til Shopify. | Sæt fejlede i kø igen, Kopifejl |
Hvert 3. minut importerer Sapera Shopify-ordrer, der er betalt og ikke annulleret. Knappen Importér ordrer på fanen Ordreimport tjekker med det samme. Hver ordre bliver til en salgsordre i webshoppens org. enhed:
Kunde: en eksisterende kunde genbruges, hvis e-mail, navn og telefon eller firmanavn matcher. Ellers oprettes en ny kunde ud fra faktureringsoplysningerne.
Linjer: kobles til de synkroniserede produkter. Produkter oprettet uden for Sapera kobles på SKU og markeres "kontrollér venligst korrekthed". Rabatter overføres som linjerabatter.
Fragt: kobles til et produkt i fragtkategorien via produktets nummer (Shopifys fragtkode) eller navn (fragttitlen). Ellers bruges det første produkt i kategorien. Uden fragtkategori importeres fragten ikke.
Lager: når der er valgt lager-enheder, tages linjen fra en enhed med tilstrækkeligt lager.
Reference og noter: Shopify-ordrenavnet bliver kundens reference. Ordrenoten, betalingsmetoden og leveringsmetoden lægges i den synlige note.
Valuta: ordrens valuta skal findes i Sapera og, hvis det ikke er standardvalutaen, have en valutakurs for ordredatoen.
Kan nogle linjer ikke findes, oprettes salgsordren alligevel, og den interne note viser, hvad der mangler. Der registreres ingen betaling på salgsordren.
For at importere en ordre igen annulleres dens salgsordre i Sapera. Vælg derefter ordren på fanen Ordreimport og klik Genimportér ordre. Ordren hentes igen fra Shopify. En fejlet import prøves også automatisk igen, når ordren ændres i Shopify.
Når salgsordren afsluttes i Sapera, markeres ordren som gennemført (fulfilled) i Shopify (fanen Ordreeksport). Shopify sender ikke kunden en forsendelsesbesked i den forbindelse.
Ordrer med mere end 100 linjer: kun de første 100 importeres, og salgsordren får en note om det. Refunderinger og annulleringer, der laves i Shopify, efter ordren er importeret, slår ikke igennem i Sapera.
Slå Synkroniser gavekort til i webshoppens indstillinger. Det kræver også:
en Shopify-plan, der omfatter gavekort (ellers melder Test opsætning "Denne Shopify-plan inkluderer ikke gavekort"),
at Generer webkoder til gavekort er slået til i gavekortindstillingerne, fordi webkoden bliver gavekortets kode i Shopify. Indstillingerne viser en advarsel, hvis ingen org. enhed genererer webkoder,
automatisk synkronisering.
Et solgt gavekort oprettes i Shopify med samme kode og saldo. Gavekorttyper, der kun tillader én hævning, synkroniseres ikke, fordi Shopify ikke kan håndhæve det.
Hævninger og annulleringer i Sapera ændrer saldoen i Shopify.
Beløb brugt i Shopify kommer tilbage til Sapera som en hævning ("Used in Shopify webshop …"). Det tjekkes hvert 10. minut.
For at sende eksisterende gavekort én gang klikkes Eksportér gavekort på fanen Gavekortopdateringer.
Produktet for en Sapera-gavekorttype sendes til Shopify som et Shopify-gavekortprodukt, når typen har et fast beløb og tillader flere hævninger. Når en kunde køber det, udsteder Shopify gavekortet og mailer det til kunden. Ordreimporten registrerer et tilsvarende gavekort i Sapera, og saldoen synkroniseres derefter.
Gavekort udstedt af Shopify kan kun bruges i Shopify: Shopify oplyser ikke koden, så de kan ikke indløses i Kasse via webkode. Gennemfører butikken ikke gavekort automatisk, venter ordreimporten på dem: gennemfør gavekortlinjerne i Shopify, og genimportér derefter ordren.
Besked | Hvad du gør |
Test opsætning: adgangsområder "mangler …" | Tilføj adgangsområdet til Shopify-appen, geninstallér den, og opdatér tokenet i Sapera, hvis Shopify har udstedt et nyt. |
"[produkt] skipped: Product has N variant attributes, Shopify allows at most 3" | Reducér antallet af synlige felter i produktets variantskabelon. |
"[produkt] skipped: SKU … is used by N Shopify variants" / "its SKUs are spread over N Shopify products" | Ryd op i de dobbelte SKU'er i Shopify, og synkronisér igen. |
"Stock is not synced: no Shopify location is configured" | Vælg en Shopify-lokation (eller én pr. enhed) under Håndtering af lagerlokationer. |
"… has prices without VAT, only shops with prices including VAT are supported" | Indstil Shopify-butikken til at vise priser inklusive moms. |
Kundedata mangler (ordreimport) | Giv Shopify-appen adgang til protected customer data. |
"No exchange rate defined for …" | Tilføj en valutakurs for ordrens valuta og dato, og genimportér ordren. |
"Shopify order … is already imported as sales order …" | Annullér først den salgsordre, hvis ordren virkelig skal importeres igen. |
"… cannot be fulfilled while its fulfillment orders are …" | Ordren er sat på hold eller allerede håndteret i Shopify. Løs det dér, og vælg derefter Sæt fejlede i kø igen. |
"Webshop … has not completed its first Shopify sync" | Kør Synkroniser én gang. Automatiske opdateringer starter, når den er afsluttet. |
"Shopify throttled …" | Intet. Shopify har bedt Sapera om at sætte tempoet ned, og arbejdet prøves automatisk igen. |
Ved en fejlet række kopierer Kopifejl hele fejlbeskeden, så du kan sende den til support.
Har du brug for hjælp til opsætningen, er du altid velkommen til at kontakte support.
