Kopiér et produkt med Claude eller REST API

Hvis du skal lage et søsterprodukt eller en variant av et produkt du allerede har, trenger du ikke å lage det helt fra bunnen av. Shoporama har et verktøy som dupliserer et eksisterende produkt i samme nettbutikk, slik at du kan ta utgangspunkt i et ferdig produkt og bare endre det som er annerledes. Verktøyet finnes to steder: som handlingen product_copy når du arbeider med Claude, og som POST /product/{id}/copy i vårt REST API.

Slik bruker du det med Claude

Du må bruke ID-en til produktet du vil kopiere. Hvis du er i tvil om hvor du finner den, kan du lese «Finn ID på et produkt, en kategori eller en ordre». Når du kjenner ID-en, kan du bare beskrive hva du ønsker, for eksempel:

«Lag en kopi av produkt 227429, kall den ‘Søster-T-skjorte’, gi den EAN-nummer 5799999000011 og pris 149,50, og la den forbli som utkast.»

Claude oppretter kopien, legger inn navnet, EAN-nummeret og prisen du ba om, og lar den ligge som utkast, slik at du kan sjekke den før den legges ut i butikken. For at Claude skal kunne jobbe med produkter, må området «Katalog» være aktivert under AI-verktøyene dine. Du kan lese mer om dette i «Tilpass hvilke verktøy Claude får bruke i butikken din».

Hva følger med i kopien

En kopi tar med seg alt som beskriver selve produktet, slik at du sjelden trenger å starte på nytt. Følgende kopieres automatisk:

• Produktnavnet, med «(kopi)» lagt til på slutten, med mindre du selv angir et annet navn
• Pris og tilbudspris
• Alle beskrivelser, både den korte og den lange
• Meta- og SEO-felt
• Alle bilder, som dupliseres fysisk, slik at kopien har sine egne bildefiler
• Kategorier og hovedkategori
• Produktetiketter
• Relaterte produkter
• Variantprofilen med dens attributter og variantverdier, for eksempel størrelse og farge
• Ekstra felt (utvidelsesdata)
• En ny, unik URL, slik at kopien ikke kolliderer med kildeadressen

Noen opplysninger er bevisst utelatt, fordi de skal være unike for hvert produkt eller fordi det er mest hensiktsmessig å angi dem selv. Følgende kopieres ikke som standard:

• EAN/strekkode (gtin): kopien får ingen strekkode, slik at du unngår at to produkter deler samme EAN
• Varenummer/SKU (own_id): Kildens varenummer blir ikke inkludert
• Lagerbeholdning: Lagerbeholdningen er hendelsesbasert og kopieres aldri. Kopien starter uten lager, slik at du selv bestemmer når den kan selges
• Lignende produkter: listen over lignende varer blir ikke overført
• Canonical: Kopien er i utgangspunktet et selvstendig produkt og peker ikke canonical tilbake til kilden

Overstyr felter i samme oppkall

Du kan gi kopien sin egen identitet allerede i det øyeblikket den opprettes. Dette er smart, fordi det betyr at en kopi aldri vil ligge online med kildens navn eller EAN, ikke engang et kort øyeblikk. Du kan angi følgende felt i selve kopieringskallet:

• name: overstyr kopiens navn. Standard er kildens navn pluss «(kopi)»
• gtin: angi kopiens EAN/strekkode. Standard er ingen strekkode
• own_id: angi kopiens varenummer/SKU. Standard er ingen varenummer fra kilden
• price: overstyr prisen. Standard er samme pris som kilden
• rewrite_url: overstyr URL-slug. Standard er en unik slug som genereres automatisk
• is_online: sett til true for å publisere kopien umiddelbart. Standard er false, altså utkast

Kopier også EAN, SKU eller lignende (valgfritt)

Noen ganger vil du nettopp ha med de feltene som ikke kopieres som standard. Til det finnes det fire valg, som alle er deaktivert fra starten:

• copy_gtin: ta med kildens EAN. Vær oppmerksom på at dette skaper en duplikat-strekkode, så bruk det kun hvis du har en grunn til det
• copy_own_id: ta med kildens varenummer/SKU
• copy_similar: kopier listen over lignende produkter
• canonical_to_source: pek kopiens canonical-tag mot kildeproduktet. Dette er nyttig for ekte duplikatvarianter, der du ønsker å samle SEO-signalene på ett produkt

Hvis du både angir en overstyring og det tilhørende tilvalget, vil overstyringen ha forrang. Hvis du for eksempel angir både gtin og copy_gtin, vil kopien bruke den EAN-koden du selv skrev, ikke kildens.

Utkast som standard

En kopi opprettes alltid som utkast, altså skjult fra nettbutikken, med mindre du uttrykkelig ber om at den skal være online. Dette er med vilje. Det betyr at en kopi aldri rekker å bli synlig i nettbutikken med kildens navn eller strekkode i det øyeblikket den opprettes og frem til du har rettet den. Du kan i ro og mak sjekke navn, pris, bilder og varianter, og først deretter legge kopien ut på nettet. Hvis du vil hoppe over dette trinnet og publisere umiddelbart, setter du ganske enkelt is_online til true i anropet.

Via REST API

Hvis du bygger en integrasjon, kaller du endepunktet direkte. Kopiering krever et token med skrivetilgang, så sørg for at nøkkelen din har «write»-tilgang eller full tilgang. Har du ikke en nøkkel ennå, kan du lese «Finn eller opprett en API-nøkkel» og se den generelle veiledningen i REST API.

Den enkleste kopien krever ingen body. Kopien blir et utkast med kildens navn pluss «(kopi)»:

curl -X POST -H "Authorization: DIN-API-NØGLE" \
  https://dinshop.dk/REST/product/227429/copy

Hvis du vil opprette en søstervare med egen identitet og publisere den umiddelbart, sender du feltene med i en JSON-body:

curl -X POST -H "Authorization: DIN-API-NØGLE" \
  -H "Content-Type: application/json" \
  -d '{"name":"Søster-T-skjorte","gtin":"5799999000011","own_id":"SIS-001","price":149.50,"rewrite_url":"soester-t-shirt","is_online":true}' \
  https://dinshop.dk/REST/product/227429/copy

Du sender tilleggsvalgene på samme måte. Her kopieres kildens EAN, og kopien settes til å peke kanonisk tilbake til kilden:

curl -X POST -H "Authorization: DIN-API-NØGLE" \
  -H "Content-Type: application/json" \
  -d '{"copy_gtin":true,"canonical_to_source":true}' \
  https://dinshop.dk/REST/product/227429/copy

Svaret er «201 Created» med hele det nye produktet, inkludert dets nye product_id, slik at du kan fortsette å jobbe med kopien i samme arbeidsflyt.

Ofte stilte spørsmål

Blir kopien lagt ut på nettet med en gang, slik at kundene mine kan se den?

Nei. En kopi opprettes alltid som et skjult utkast, slik at ingen kunder ser den. Den vises først i nettbutikken når du selv velger å gjøre den synlig, eller hvis du setter is_online til true i selve anropet. Så du kan rolig se gjennom den i fred først.

Hvordan finner jeg produkt-ID-en jeg skal bruke?

ID-en står i produktets adresse i admin og i produktoversikten. Uten ID kan verktøyet ikke vite hvilket produkt som skal dupliseres. Du kan se nøyaktig hvor den står i «Finn ID» på et produkt, en kategori eller en ordre.

Hva skjer med bildene?

Bildene blir automatisk overført til kopien, slik at du slipper å laste dem opp på nytt. De dupliseres fysisk, slik at kopien har sine egne bildefiler og ikke deler dem med originalen. Hvis du vil ha andre bilder på kopien, kan du bare endre dem i etterkant.

Blir EAN, varenummer og lagerbeholdning overført?

Nei, ikke som standard. EAN/strekkode, varenummer/SKU og lagerbeholdning kopieres ikke, slik at du unngår to produkter med samme strekkode eller varenummer. Du kan be om å få EAN og SKU inkludert i samme handling, og lagerbeholdningen legger du selv inn på kopien.

Kan jeg angre hvis kopien likevel ikke skal brukes?

Ja. Siden kopien opprettes som et skjult utkast, kan du bare slette den igjen. Kundene har ikke sett den, og det opprinnelige produktet blir ikke berørt i det hele tatt.

Fungerer dette for produkter med varianter?

Ja. Variantprofilen og de tilhørende attributtene og variantverdiene, for eksempel størrelse og farge, kopieres over til det nye produktet. Lagerbeholdningen for variantene følger imidlertid ikke med; den angir du selv.

Kan jeg kopiere et produkt over til en av mine andre nettbutikker?

Nei. Verktøyet lager kopien i samme nettbutikk som kildeproduktet. Det er ment for søster- og variantartikler internt i én nettbutikk. Hvis du skal flytte sortimentet mellom nettbutikkene dine, er det en annen arbeidsprosess.

Gir kopien og originalen problemer i Google?

Kopien får sin egen unike URL og blir ikke angitt som kanonisk i forhold til originalen, så den fremstår som et selvstendig produkt. Skriv unike titler, beskrivelser og metatekster på kopien, slik at de to sidene ikke konkurrerer om de samme søkeordene. Hvis kopien egentlig bare er en variant av originalen, kan du angi den kanoniske lenken til kilden i samme handling.

Kan jeg kopiere mange produkter raskt?

Ja. Det kreves bare én forespørsel per produkt, så du kan lage mange kopier på kort tid. Alle kopier opprettes som utkast og er ikke synlige før du publiserer dem, så du kan trygt opprette mange på en gang og rydde opp etterpå.

Hvordan utfører jeg dette via REST API?

Send POST /product/{id}/copy med en JSON-body, som kan være tom for en standardkopi. Du må bruke et token med skriveadgang i Authorization-headeren. Anropet returnerer det nye produktets fullstendige data, inkludert et nytt product_id.

Trenger du hjelp, kan du gjerne skrive til oss på support@shoporama.dk.