Kopiér et produkt med Claude eller REST API

Skal du lave en søster-vare eller en variant af et produkt du allerede har, behøver du ikke bygge det hele forfra. Shoporama har et værktøj der duplikerer et eksisterende produkt i den samme shop, så du kan tage udgangspunkt i et færdigt produkt og kun rette det der er anderledes. Værktøjet findes to steder: som handlingen product_copy når du arbejder med Claude, og som kaldet POST /product/{id}/copy i vores REST API.

Sådan bruger du det med Claude

Du skal bruge ID'et på det produkt du vil kopiere. Er du i tvivl om hvor du finder det, så læs Find ID på et produkt, en kategori, eller en ordre. Når du kender ID'et, kan du bare beskrive hvad du vil have, for eksempel:

"Lav en kopi af produkt 227429, kald den 'Søster t-shirt', giv den EAN 5799999000011 og pris 149,50, og lad den blive som kladde."

Claude opretter kopien, sætter det navn, den EAN, og den pris du bad om, og lader den blive liggende som kladde, så du kan tjekke den efter inden den kommer i shoppen. For at Claude kan arbejde med produkter, skal området Katalog være slået til under dine AI-værktøjer. Det kan du læse mere om i Tilpas hvilke værktøjer Claude må bruge i din shop.

Hvad følger med i kopien

En kopi tager alt det med der beskriver selve produktet, så du sjældent skal starte forfra. Følgende kopieres automatisk:

• Produktnavnet, med " (kopi)" sat bagpå, med mindre du selv angiver et andet navn
• Pris og tilbudspris
• Alle beskrivelser, både den korte og den lange
• Meta- og SEO-felter
• Alle billeder, som duplikeres fysisk, så kopien har sine egne billedfiler
• Kategorier og hovedkategori
• Produkt-labels
• Relaterede produkter
• Variant-profilen med dens attributter og variantværdier, for eksempel størrelse og farve
• Ekstrafelter (extension-data)
• En ny, unik URL, så kopien ikke kolliderer med kildens adresse

Nogle ting følger bevidst ikke med, fordi de skal være unikke for hvert produkt eller giver mest mening at sætte selv. Følgende kopieres ikke som standard:

• EAN/stregkode (gtin): kopien får ingen stregkode, så du undgår at to produkter deler samme EAN
• Varenummer/SKU (own_id): kildens varenummer følger ikke med
• Lagerantal: lager er hændelsesbaseret og kopieres aldrig. Kopien starter uden lager, så du selv styrer hvornår den kan sælges
• Similar-produkter: listen over lignende varer bliver ikke ført over
• Canonical: kopien er som udgangspunkt et selvstændigt produkt og peger ikke canonical tilbage på kilden

Overstyr felter i samme kald

Du kan give kopien sin egen identitet allerede i det øjeblik den oprettes. Det er smart, fordi det betyder at en kopi aldrig kommer til at ligge online med kildens navn eller EAN, heller ikke et kort øjeblik. Du kan sætte følgende felter i selve kopi-kaldet:

• name: overstyr kopiens navn. Standard er kildens navn plus " (kopi)"
• gtin: sæt kopiens EAN/stregkode. Standard er ingen stregkode
• own_id: sæt kopiens varenummer/SKU. Standard er intet varenummer fra kilden
• price: overstyr prisen. Standard er samme pris som kilden
• rewrite_url: overstyr URL-slug. Standard er en unik slug der genereres automatisk
• is_online: sæt til true for at udgive kopien med det samme. Standard er false, altså kladde

Kopiér også EAN, SKU eller similar (tilvalg)

Nogle gange vil du netop have de felter med der ikke kopieres som standard. Til det er der fire tilvalg, som alle er slået fra fra start:

• copy_gtin: tag kildens EAN med. Vær opmærksom på at det skaber en dublet-stregkode, så brug det kun hvis du har en grund til det
• copy_own_id: tag kildens varenummer/SKU med
• copy_similar: kopiér listen over lignende produkter
• canonical_to_source: peg kopiens canonical på kildeproduktet. Det er nyttigt for ægte dublet-varianter, hvor du vil samle SEO-signalerne på ét produkt

Hvis du både sætter en overstyring og det tilhørende tilvalg, vinder overstyringen. Angiver du for eksempel både gtin og copy_gtin, bruger kopien den EAN du selv skrev, ikke kildens.

Kladde som standard

En kopi oprettes altid som kladde, altså skjult fra shoppen, med mindre du udtrykkeligt beder om at den skal være online. Det er med vilje. Det betyder at en kopi aldrig når at være synlig i shoppen med kildens navn eller stregkode i sekundet mellem at den bliver oprettet, og at du får rettet den til. Du kan i ro og mag tjekke navn, pris, billeder, og varianter, og først derefter sætte kopien online. Vil du springe det trin over og udgive med det samme, sætter du blot is_online til true i kaldet.

Via REST API

Bygger du en integration, kalder du endpointet direkte. Kopiering kræver et token med skriveadgang, så sørg for at din nøgle har write eller fuld adgang. Har du ikke en nøgle endnu, så læs Find eller opret en API-nøgle, og se den generelle guide i REST API.

Den enkleste kopi kræver ingen body. Kopien bliver en kladde med kildens navn plus " (kopi)":

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

Vil du oprette en søster-vare med sin egen identitet og udgive den med det samme, sender du felterne med i en JSON-body:

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

Tilvalgene sender du på samme måde. Her kopieres kildens EAN med, og kopien sættes til at pege canonical tilbage på 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 produkt, inklusive dets nye product_id, så du kan arbejde videre med kopien i det samme flow.

Ofte stillede spørgsmål

Kommer kopien online med det samme, så mine kunder kan se den?

Nej. En kopi oprettes altid som en skjult kladde, så ingen kunder ser den. Den kommer først frem i shoppen når du selv vælger at gøre den synlig, eller hvis du sætter is_online til true i selve kaldet. Så du kan roligt kigge den igennem i fred først.

Hvordan finder jeg produkt-ID'et jeg skal bruge?

ID'et står i produktets adresse i admin og i produktoversigten. Uden ID kan værktøjet ikke vide hvilket produkt der skal duplikeres. Du kan se præcis hvor det står i Find ID på et produkt, en kategori, eller en ordre.

Hvad sker der med billederne?

Billederne følger automatisk med over på kopien, så du slipper for at uploade dem igen. De duplikeres fysisk, så kopien har sine egne billedfiler og ikke deler dem med originalen. Vil du have andre billeder på kopien, retter du dem bare bagefter.

Følger EAN, varenummer og lager med over?

Nej, ikke som standard. EAN/stregkode, varenummer/SKU, og lagerantal kopieres ikke, så du undgår to produkter med samme stregkode eller varenummer. Du kan bede om at få EAN og SKU med i samme handling, og lageret sætter du selv på kopien.

Kan jeg fortryde, hvis kopien alligevel ikke skal bruges?

Ja. Fordi kopien starter som en skjult kladde, kan du bare slette den igen. Kunderne har ikke set den, og dit oprindelige produkt bliver slet ikke rørt.

Virker det på produkter med varianter?

Ja. Variant-profilen og de tilhørende attributter og variantværdier, for eksempel størrelse og farve, kopieres med over på det nye produkt. Lagerantal på varianterne følger dog ikke med, det sætter du selv.

Kan jeg kopiere et produkt over i en af mine andre shops?

Nej. Værktøjet laver kopien i samme shop som kildeproduktet. Det er tænkt til søster- og variant-artikler internt i én shop. Skal du flytte sortiment mellem dine shops, er det en anden arbejdsgang.

Giver kopien og originalen problemer i Google?

Kopien får sin egen unikke URL og bliver ikke sat som canonical til originalen, så den står som et selvstændigt produkt. Skriv unikke titler, beskrivelser, og meta-tekster på kopien, så de to sider ikke konkurrerer om de samme søgeord. Er kopien reelt bare en variant af originalen, kan du sætte canonical til kilden i samme handling.

Kan jeg kopiere mange produkter hurtigt?

Ja. Det er ét kald pr. produkt, så du kan lave mange kopier på kort tid. Alle kopier oprettes som kladde og er ikke synlige før du udgiver dem, så du kan trygt masseoprette og rydde op bagefter.

Hvordan kalder jeg det via REST API?

Send POST /product/{id}/copy med en JSON-body, som kan være tom for en standardkopi. Du skal bruge et token med skriveadgang i Authorization-headeren. Kaldet returnerer det nye produkts fulde data, inklusive et nyt product_id.

Har du brug for hjælp, er du velkommen til at skrive til os på support@shoporama.dk.