Kopiera en produkt med Claude eller REST API

Om du ska skapa en liknande produkt eller en variant av en produkt du redan har behöver du inte bygga upp allt från grunden. Shoporama har ett verktyg som duplicerar en befintlig produkt i samma butik, så att du kan utgå från en färdig produkt och bara justera det som skiljer sig åt. Verktyget finns på två ställen: som åtgärden product_copy när du arbetar med Claude, och som POST-anropet /product/{id}/copy i vårt REST-API.

Så här använder du det med Claude

Du behöver ID-numret för den produkt du vill kopiera. Om du är osäker på var du hittar det, läs Hitta ID för en produkt, en kategori eller en beställning. När du känner till ID-numret kan du helt enkelt beskriva vad du vill ha, till exempel:

”Skapa en kopia av produkt 227429, kalla den ’Syster-t-shirt’, ge den EAN-numret 5799999000011 och priset 149,50, och låt den förbli som utkast.”

Claude skapar kopian, anger det namn, den EAN-kod och det pris du bad om, och låter den ligga kvar som utkast så att du kan kontrollera den innan den läggs ut i butiken. För att Claude ska kunna arbeta med produkter måste området Katalog vara aktiverat under dina AI-verktyg. Du kan läsa mer om detta i Anpassa vilka verktyg Claude får använda i din butik.

Vad ingår i kopian

En kopia tar med allt som beskriver själva produkten, så du behöver sällan börja om från början. Följande kopieras automatiskt:

• Produktnamnet, med ”(kopia)” tillagt i slutet, såvida du inte själv anger ett annat namn
• Pris och erbjudandepris
• Alla beskrivningar, både den korta och den långa
• Meta- och SEO-fält
• Alla bilder, som dupliceras fysiskt, så att kopian har sina egna bildfiler
• Kategorier och huvudkategori
• Produktetiketter
• Relaterade produkter
• Variantprofilen med dess attribut och variantvärden, till exempel storlek och färg
• Extra fält (tilläggsdata)
• En ny, unik URL, så att kopian inte kolliderar med källans adress

Vissa uppgifter utelämnas medvetet, eftersom de måste vara unika för varje produkt eller eftersom det är mest meningsfullt att ange dem själv. Följande kopieras inte som standard:

• EAN/streckkod (gtin): kopian får ingen streckkod, så att du undviker att två produkter delar samma EAN
• Artikelnummer/SKU (own_id): källans artikelnummer ingår inte
• Lagerstatus: lagerstatusen är händelsebaserad och kopieras aldrig. Kopian startar utan lager, så att du själv styr när den kan säljas
• Liknande produkter: listan över liknande varor överförs inte
• Canonical: Kopian är i utgångspunkten en fristående produkt och pekar inte tillbaka på källan via canonical

Åsidosätt fält i samma anrop

Du kan ge kopian en egen identitet redan när den skapas. Det är smart, eftersom det innebär att en kopia aldrig kommer att ligga online med källans namn eller EAN, inte ens för ett kort ögonblick. Du kan ange följande fält i själva kopieringsanropet:

• name: åsidosätt kopiens namn. Standard är källans namn plus " (kopia)"
• gtin: ange kopiens EAN/streckkod. Standard är ingen streckkod
• own_id: ange kopiens artikelnummer/SKU. Standard är inget artikelnummer från källan
• price: åsidosätt priset. Standardvärdet är samma pris som källan
• rewrite_url: åsidosätt URL-slug. Standard är en unik slug som genereras automatiskt
• is_online: ställ in på true för att publicera kopian omedelbart. Standardvärdet är false, dvs. utkast

Kopiera även EAN, SKU eller liknande (valfritt)

Ibland vill du just ha med de fält som inte kopieras som standard. För detta finns fyra tillval, som alla är avstängda från början:

• copy_gtin: inkludera källans EAN. Tänk på att detta skapar en dubbel streckkod, så använd det endast om du har en anledning till det
• copy_own_id: ta med källans artikelnummer/SKU
• copy_similar: kopiera listan över liknande produkter
• canonical_to_source: peka kopians canonical-länk mot källprodukten. Detta är användbart för äkta dubblettvarianter där du vill samla SEO-signalerna på en enda produkt

Om du anger både en överskrivning och det tillhörande tillvalet, har överskrivningen företräde. Om du till exempel anger både gtin och copy_gtin, använder kopian den EAN-kod du själv angav, inte källans.

Utkast som standard

En kopia skapas alltid som utkast, det vill säga dold från webbutiken, såvida du inte uttryckligen begär att den ska vara online. Detta är avsiktligt. Det innebär att en kopia aldrig hinner visas i butiken med källans namn eller streckkod under den sekund det tar från att den skapas till att du har hunnit redigera den. Du kan i lugn och ro kontrollera namn, pris, bilder och varianter, och först därefter publicera kopian online. Om du vill hoppa över det steget och publicera direkt, ställer du helt enkelt in is_online till true i anropet.

Via REST API

Om du bygger en integration anropar du endpointen direkt. Kopiering kräver en token med skrivbehörighet, så se till att din nyckel har skrivbehörighet eller full behörighet. Om du inte har en nyckel ännu, läs avsnittet Hitta eller skapa en API-nyckel och se den allmänna guiden för REST API.

Den enklaste kopieringen kräver ingen body. Kopian blir ett utkast med källans namn plus ”(kopia)”:

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

Om du vill skapa en systerprodukt med egen identitet och publicera den direkt skickar du med fälten i en JSON-body:

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

Tillvalen skickar du på samma sätt. Här kopieras källans EAN med, och kopian ställs in så att den pekar tillbaka på källan som kanonisk:

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

Svaret är 201 Created med hela den nya produkten, inklusive dess nya product_id, så att du kan fortsätta arbeta med kopian i samma flöde.

Vanliga frågor

Kommer kopian att publiceras direkt så att mina kunder kan se den?

Nej. En kopia skapas alltid som ett dolt utkast, så inga kunder ser den. Den visas först i butiken när du själv väljer att göra den synlig, eller om du sätter is_online till true i själva anropet. Så du kan lugnt gå igenom den i lugn och ro först.

Hur hittar jag det produkt-ID jag behöver?

ID:t står i produktens adress i admin och i produktöversikten. Utan ID kan verktyget inte veta vilken produkt som ska dupliceras. Du kan se exakt var det står i ”Hitta ID” för en produkt, en kategori eller en beställning.

Vad händer med bilderna?

Bilderna överförs automatiskt till kopian, så du slipper ladda upp dem igen. De dupliceras fysiskt, vilket innebär att kopian har sina egna bildfiler och inte delar dem med originalet. Om du vill ha andra bilder på kopian kan du enkelt ändra dem i efterhand.

Överförs EAN, artikelnummer och lagerstatus?

Nej, inte som standard. EAN/streckkod, artikelnummer/SKU och lagerstatus kopieras inte, så att du undviker att få två produkter med samma streckkod eller artikelnummer. Du kan begära att EAN och SKU ska inkluderas i samma åtgärd, och lagerstatusen anger du själv på kopian.

Kan jag ångra mig om kopian ändå inte ska användas?

Ja. Eftersom kopian inledningsvis är en dold utkast kan du helt enkelt radera den igen. Kunderna har inte sett den, och din ursprungliga produkt påverkas inte alls.

Fungerar det för produkter med varianter?

Ja. Variantprofilen och tillhörande attribut och variantvärden, till exempel storlek och färg, kopieras över till den nya produkten. Lagerantalet för varianterna följer dock inte med, det anger du själv.

Kan jag kopiera en produkt till en av mina andra butiker?

Nej. Verktyget skapar kopian i samma butik som källprodukten. Det är avsett för syster- och variantartiklar internt i en och samma butik. Om du vill flytta sortiment mellan dina butiker är det en annan arbetsprocess.

Orsakar kopian och originalet problem i Google?

Kopian får en egen unik URL och anges inte som kanonisk länk till originalet, så den framstår som en fristående produkt. Skriv unika titlar, beskrivningar och metatexter för kopian, så att de två sidorna inte konkurrerar om samma sökord. Om kopian i själva verket bara är en variant av originalet kan du ange källan som kanonisk i samma åtgärd.

Kan jag kopiera många produkter snabbt?

Ja. Det krävs endast ett anrop per produkt, så du kan skapa många kopior på kort tid. Alla kopior skapas som utkast och är inte synliga förrän du publicerar dem, så du kan tryggt skapa dem i bulk och rensa upp efteråt.

Hur gör jag detta via REST API?

Skicka POST /product/{id}/copy med en JSON-body, som kan vara tom för en standardkopia. Du måste använda ett token med skrivbehörighet i Authorization-rubriken. Anropet returnerar den nya produktens fullständiga data, inklusive ett nytt product_id.

Om du behöver hjälp är du välkommen att skriva till oss på support@shoporama.dk.