Ein Produkt mit Claude oder der REST-API kopieren

Wenn du ein ähnliches Produkt oder eine Variante eines bereits vorhandenen Produkts erstellen möchtest, musst du nicht alles von Grund auf neu erstellen. Shoporama verfügt über ein Tool, das ein bestehendes Produkt im selben Shop dupliziert, sodass du von einem fertigen Produkt ausgehen und nur die Unterschiede anpassen kannst. Das Tool ist an zwei Stellen verfügbar: als Aktion „product_copy“, wenn du mit Claude arbeitest, und als POST-Aufruf „/product/{id}/copy“ in unserer REST-API.

So nutzt du es mit Claude

Du benötigst die ID des Produkts, das du kopieren möchtest. Wenn du dir nicht sicher bist, wo du diese findest, lies den Artikel „ID eines Produkts, einer Kategorie oder einer Bestellung finden“. Sobald du die ID kennst, kannst du einfach beschreiben, was du möchtest, zum Beispiel:

„Erstelle eine Kopie von Produkt 227429, nenne sie ‚Schwester-T-Shirt‘, gib ihr die EAN 5799999000011 und den Preis 149,50 und lass sie als Entwurf gespeichert.“

Claude erstellt die Kopie, vergibt den von dir gewünschten Namen, die EAN und den Preis und lässt sie als Entwurf gespeichert, damit du sie überprüfen kannst, bevor sie in den Shop gelangt. Damit Claude mit Produkten arbeiten kann, muss der Bereich „Katalog“ unter deinen KI-Tools aktiviert sein. Mehr dazu erfährst du unter „Anpassen, welche Tools Claude in deinem Shop nutzen darf“.

Was ist in der Kopie enthalten?

Eine Kopie übernimmt alle Angaben, die das Produkt selbst beschreiben, sodass du selten von vorne anfangen musst. Folgendes wird automatisch kopiert:

• Der Produktname, mit dem Zusatz „(Kopie)“ am Ende, sofern du nicht selbst einen anderen Namen angibst
• Preis und Sonderpreis
• Alle Beschreibungen, sowohl die kurze als auch die lange
• Meta- und SEO-Felder
• Alle Bilder, die physisch dupliziert werden, sodass die Kopie über eigene Bilddateien verfügt
• Kategorien und Hauptkategorie
• Produkt-Labels
• Ähnliche Produkte
• Das Variantenprofil mit seinen Attributen und Variantenwerten, zum Beispiel Größe und Farbe
• Zusatzfelder (Erweiterungsdaten)
• Eine neue, eindeutige URL, damit die Kopie nicht mit der Adresse der Quelle kollidiert

Einige Angaben werden bewusst nicht übernommen, da sie für jedes Produkt einzigartig sein müssen oder am sinnvollsten selbst festgelegt werden. Folgende Angaben werden standardmäßig nicht kopiert:

• EAN/Barcode (gtin): Die Kopie erhält keinen Barcode, damit zwei Produkte nicht dieselbe EAN haben
• Artikelnummer/SKU (own_id): Die Artikelnummer der Quelle wird nicht übernommen
• Lagerbestand: Der Lagerbestand ist ereignisbasiert und wird niemals kopiert. Die Kopie startet ohne Lagerbestand, sodass Sie selbst bestimmen, wann das Produkt verkauft werden kann
• Ähnliche Produkte: Die Liste ähnlicher Artikel wird nicht übernommen
• Canonical: Die Kopie ist grundsätzlich ein eigenständiges Produkt und verweist nicht canonical auf die Quelle zurück

Felder im selben Aufruf überschreiben

Sie können der Kopie bereits bei ihrer Erstellung eine eigene Identität zuweisen. Das ist sinnvoll, da eine Kopie dadurch niemals – auch nicht für einen kurzen Moment – mit dem Namen oder der EAN der Quelle online erscheint. Sie können die folgenden Felder im Kopieraufruf selbst festlegen:

• name: Überschreiben Sie den Namen der Kopie. Der Standardwert ist der Name der Quelle plus „(Kopie)“
• gtin: Lege die EAN/den Barcode der Kopie fest. Standardmäßig gibt es keinen Barcode
• own_id: Lege die Artikelnummer/SKU der Kopie fest. Standardmäßig wird keine Artikelnummer aus der Quelle übernommen
• price: Überschreibe den Preis. Standard ist derselbe Preis wie bei der Quelle
• rewrite_url: Überschreibe den URL-Slug. Standard ist ein automatisch generierter eindeutiger Slug
• is_online: Setze den Wert auf „true“, um die Kopie sofort zu veröffentlichen. Standard ist „false“, d. h. Entwurf

Kopiere auch EAN, SKU oder Ähnliches (optional)

Manchmal möchten Sie genau die Felder einbeziehen, die standardmäßig nicht kopiert werden. Dafür gibt es vier Optionen, die alle von Haus aus deaktiviert sind:

• copy_gtin: Die EAN der Quelle übernehmen. Beachte, dass dadurch ein doppelter Barcode entsteht; verwende diese Option daher nur, wenn du einen Grund dafür hast
• copy_own_id: Die Artikelnummer/SKU der Quelle übernehmen
• copy_similar: Kopiere die Liste ähnlicher Produkte
• canonical_to_source: Verweise den Canonical-Tag der Kopie auf das Quellprodukt. Dies ist nützlich für echte Duplikatvarianten, bei denen du die SEO-Signale auf ein einziges Produkt bündeln möchtest

Wenn du sowohl eine Überschreibung als auch die zugehörige Option festlegst, hat die Überschreibung Vorrang. Wenn du beispielsweise sowohl „gtin“ als auch „copy_gtin“ angibst, verwendet die Kopie die von dir selbst eingegebene EAN und nicht die der Quelle.

Standardmäßig als Entwurf

Eine Kopie wird immer als Entwurf angelegt, d. h. sie ist im Shop nicht sichtbar, es sei denn, du forderst ausdrücklich an, dass sie online geschaltet wird. Das ist beabsichtigt. Das bedeutet, dass eine Kopie in der Sekunde zwischen ihrer Erstellung und deiner Bearbeitung niemals mit dem Namen oder dem Barcode der Quelle im Shop sichtbar wird. Du kannst in aller Ruhe Name, Preis, Bilder und Varianten überprüfen und die Kopie erst danach online stellen. Wenn du diesen Schritt überspringen und den Artikel sofort veröffentlichen möchtest, setze einfach „is_online“ im Aufruf auf „true“.

Über die REST-API

Wenn du eine Integration entwickelst, rufst du den Endpunkt direkt auf. Das Kopieren erfordert ein Token mit Schreibzugriff, stelle also sicher, dass dein Schlüssel über Schreib- oder Vollzugriff verfügt. Wenn du noch keinen Schlüssel hast, lies den Abschnitt „API-Schlüssel suchen oder erstellen“ und schau dir die allgemeine Anleitung zur REST-API an.

Die einfachste Kopie erfordert keinen Body. Die Kopie wird als Entwurf mit dem Namen der Quelle plus „(Kopie)“ gespeichert:

curl -X POST -H "Authorization: DEIN-API-SCHLÜSSEL" \
  https://dinshop.dk/REST/product/227429/copy

Wenn Sie einen Schwesterartikel mit eigener Identität erstellen und diesen sofort veröffentlichen möchten, übermitteln Sie die Felder in einem JSON-Body:

curl -X POST -H "Authorization: DEIN-API-SCHLÜSSEL" \
  -H "Content-Type: application/json" \
  -d '{"name":"Schwester-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

Die Optionen sendest du auf die gleiche Weise. Dabei wird die EAN der Quelle mitkopiert, und die Kopie wird so eingerichtet, dass sie kanonisch auf die Quelle verweist:

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

Die Antwort lautet „201 Created“ und enthält das gesamte neue Produkt einschließlich seiner neuen `product_id`, sodass du im selben Arbeitsablauf mit der Kopie weiterarbeiten kannst.

Häufig gestellte Fragen

Wird die Kopie sofort online gestellt, sodass meine Kunden sie sehen können?

Nein. Eine Kopie wird immer als versteckter Entwurf erstellt, sodass kein Kunde sie sehen kann. Sie erscheint erst im Shop, wenn du sie selbst sichtbar machst oder wenn du im Aufruf selbst `is_online` auf `true` setzt. Du kannst sie also zunächst in Ruhe durchsehen.

Wie finde ich die Produkt-ID, die ich benötige?

Die ID findest du in der Produktadresse im Admin-Bereich und in der Produktübersicht. Ohne die ID kann das Tool nicht erkennen, welches Produkt dupliziert werden soll. Wo genau sie steht, erfährst du unter „ID eines Produkts, einer Kategorie oder einer Bestellung finden“.

Was passiert mit den Bildern?

Die Bilder werden automatisch in die Kopie übernommen, sodass du sie nicht erneut hochladen musst. Sie werden physisch dupliziert, sodass die Kopie über eigene Bilddateien verfügt und diese nicht mit dem Original teilt. Wenn du andere Bilder in der Kopie haben möchtest, kannst du diese anschließend einfach anpassen.

Werden EAN, Artikelnummer und Lagerbestand mit übertragen?

Nein, standardmäßig nicht. EAN/Barcode, Artikelnummer/SKU und Lagerbestand werden nicht kopiert, damit du zwei Produkte mit demselben Barcode oder derselben Artikelnummer vermeidest. Du kannst beantragen, dass EAN und SKU im selben Vorgang übernommen werden, und den Lagerbestand trägst du selbst in die Kopie ein.

Kann ich den Vorgang rückgängig machen, wenn die Kopie doch nicht benötigt wird?

Ja. Da die Kopie zunächst als ausgeblendeter Entwurf angelegt wird, kannst du sie einfach wieder löschen. Die Kunden haben sie nicht gesehen, und dein ursprüngliches Produkt bleibt völlig unberührt.

Funktioniert das auch bei Produkten mit Varianten?

Ja. Das Variantenprofil und die zugehörigen Attribute sowie die Variantenwerte, zum Beispiel Größe und Farbe, werden auf das neue Produkt kopiert. Die Lagerbestände der Varianten werden jedoch nicht mit übernommen – diese legst du selbst fest.

Kann ich ein Produkt in einen meiner anderen Shops kopieren?

Nein. Das Tool erstellt die Kopie im selben Shop wie das Quellprodukt. Es ist für Schwester- und Variantenartikel innerhalb eines Shops gedacht. Wenn du dein Sortiment zwischen deinen Shops verschieben möchtest, ist das ein anderer Arbeitsablauf.

Verursachen die Kopie und das Original Probleme bei Google?

Die Kopie erhält eine eigene, eindeutige URL und wird nicht als „canonical“ für das Original festgelegt, sodass sie als eigenständiges Produkt erscheint. Verfasse für die Kopie einzigartige Titel, Beschreibungen und Meta-Texte, damit die beiden Seiten nicht um dieselben Suchbegriffe konkurrieren. Ist die Kopie tatsächlich nur eine Variante des Originals, kannst du im selben Schritt die kanonische URL auf die Quelle setzen.

Kann ich schnell viele Produkte kopieren?

Ja. Pro Produkt ist nur ein Aufruf erforderlich, sodass du in kurzer Zeit viele Kopien erstellen kannst. Alle Kopien werden als Entwurf angelegt und sind erst sichtbar, wenn du sie veröffentlichst. So kannst du bedenkenlos in großem Umfang Kopien erstellen und anschließend aufräumen.

Wie rufe ich das über die REST-API auf?

Sende einen POST-Aufruf an /product/{id}/copy mit einem JSON-Body, der für eine Standardkopie leer sein kann. Du benötigst ein Token mit Schreibzugriff im Authorization-Header. Der Aufruf gibt die vollständigen Daten des neuen Produkts zurück, einschließlich einer neuen product_id.

Wenn du Hilfe benötigst, kannst du uns gerne unter support@shoporama.dk schreiben.