Duplikate: Prüfung erforderlich und Gleiches Produkt

Findet ein Kanalimport einen Artikel, der ein bereits in Nembol vorhandenes Produkt sein könnte (aber nicht mit Sicherheit), rät er nicht und verwirft ihn auch nicht: Der Artikel kommt pausiert herein, mit dem Status to_verify („Prüfung erforderlich“ im Dashboard). Er wird nicht veröffentlicht, synchronisiert oder verknüpft, bis jemand entscheidet.

Finden, was geprüft werden muss

curl "https://api.nembol.com/rest/v1/products?status=to_verify" \
  -H "Authorization: Bearer $NEMBOL_API_KEY"

Jedes Produkt erklärt den Grund in requires_attention:

{
  "id": "prod_7c1e",
  "status": "to_verify",
  "requires_attention": {
    "reason": "ambiguous_match",
    "message": "The SKU matches more than one product in Nembol",
    "channel": "etsy",
    "conflicting_product_ids": ["prod_51aa", "prod_51ab"],
    "detected_at": "2026-10-13T10:00:00.000Z"
  }
}

Importe melden, wie viele Artikel auf diese Weise hereingekommen sind (import.requires_attention in der Operation). Solange ein Produkt to_verify ist, antworten Schreibvorgänge auf Angeboten mit 409 product_requires_attention, und Bestandsänderungen über die SKU überspringen es.

Auflösen

Es gibt zwei Wege:

• Es ist derselbe Artikel wie ein vorhandenes Produkt → führe sie mit POST /products/merge zusammen (siehe unten). Damit ist es auch aufgelöst.
• Andernfalls → POST /products/{id}/resolve:

Die Etsy-Gründe (etsy_shared_quantity, etsy_processing_profiles) sind Kanaleinstellungen, keine Duplikate: keep_independent antwortet für sie mit 409 resolution_not_applicable.

Ignorierte Angebote werden von GET /ignored_listings aufgelistet; DELETE /ignored_listings/{id} hebt das Ignorieren für eines auf, und der nächste Import dieses Kanals holt es wieder herein.

Zwei Produkte zusammenführen (Gleiches Produkt)

curl -X POST https://api.nembol.com/rest/v1/products/merge \
  -H "Authorization: Bearer $NEMBOL_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"product_ids": ["prod_51aa", "prod_7c1e"], "survivor_id": "prod_51aa", "dry_run": true}'

• Das verbleibende Produkt (Survivor) behält seine ID; die anderen werden mit merged_into archiviert, und ihre Angebote wandern zum Survivor. Ein Bestand pro Variante wird dann von allen Kanälen geteilt.
• Sende immer zuerst dry_run: true und zeig die Vorschau: title, variants und was jeder Kanal anzeigen wird (listings).
• choices legt pro Feld fest, von welchem Produkt ein Wert stammt (Standard: der Survivor): title, description, sku, barcode, price, quantity, photos, tags, category. Zum Beispiel: "choices": {"photos": {"from": "prod_7c1e"}, "quantity": {"values": {"var_1": 5}}}. Übernimmst du photos, kommen auch die Variantenbilder dieses Produkts mit. Die Kanäle behalten ihre eigenen Titel und Beschreibungen.
• Produkte, die sich nicht ähneln, werden in looks_different aufgeführt: Um sie zusammenzuführen, ist confirm_different: true nötig.
• Abgelehnt, wenn zwei Produkte auf demselben Kanalkonto live sind (422 same_channel_account).
• 30 Tage lang rückgängig zu machen mit POST /actions/{id}/undo (die ID steht im Header Nembol-Action-Id).

Varianten, die nicht übereinstimmen

Varianten werden über die SKU zugeordnet, danach über die Optionswerte. Schlägt das fehl, antwortet die Zusammenführung mit 422 variants_differ und error.details.matching: beide Variantenlisten und ein suggestion. Ist manual_allowed true (das aufgenommene Produkt ist nur auf Etsy, Shopify oder WooCommerce live, mit gleich vielen Varianten), ordne sie selbst zu und sende die Zusammenführung erneut:

{
  "product_ids": ["prod_51aa", "prod_7c1e"],
  "survivor_id": "prod_51aa",
  "variant_maps": { "prod_7c1e": { "var_e1": "var_a1", "var_e2": "var_a2" } }
}

Die Zuordnung muss vollständig und eins zu eins sein. Nach der Zusammenführung übernehmen die Varianten des Kanals die Namen aus Nembol (und die SKUs, wo der Kanal es erlaubt).

Events

Eine Zusammenführung sendet product.updated für den Survivor (data.merged) und product.deleted für jedes aufgenommene Produkt (data.merged_into). Eine Auflösung sendet product.updated (product.deleted bei ignore).

Gute Praxis für Agenten

• Löse oder führe nie eigenständig zusammen: Zeig der Person die konkurrierenden Produkte nebeneinander und lass sie entscheiden.
• Verwende dry_run vor jeder Zusammenführung und bewahre die Action-ID zum Rückgängigmachen auf.

Zuletzt aktualisiert am 20. Oktober 2026