Zum Inhalt

Marktplatz-Artikeldetails

Die Marktplatz-Artikelkarte ist die Karte eines Angebots – eine für jedes Angebot, gleich welcher Marktplatz es führt. Sie zeigt die gemeinsamen Angaben des Hubs; was es nur bei einem Marktplatz gibt (etwa Zustand und Richtlinien bei eBay oder Gebühren bei Amazon), ergänzt dessen Connector in eigenen Abschnitten derselben Karte.

Seite öffnen

Aus jeder Angebotsliste und von jeder Stelle, die auf ein Angebot verweist:

  • Marktplatz-Artikelliste und die Artikelliste eines Connectors – einen Eintrag öffnen.
  • Gesperrte Preise, Attributprobleme und Angebotsbefunde – Aktion Angebot bzw. Marktplatz-Artikel.
  • FactBox Marktplatz-Artikel an der Artikelkarte – Klick auf eine Zeile. Hat der Connector dafür keine eigene Seite, öffnet sich genau das Angebot der Zeile, auch bei mehreren Varianten oder Verkaufskanälen.

Neue Angebote legen Sie nicht auf der Karte an, sondern mit Zum Marktplatz hinzufügen auf der Artikelkarte oder in der Artikelliste: Das setzt, was der Connector braucht (SKU, Vorgaben, Variantenzeilen). Die Listen, die diese Karte öffnen, bieten deshalb kein Neu.

Hinweis: Einige Connectoren zeigen ihre Angebote noch auf einer eigenen Karte. Sie stellen nach und nach auf diese Karte um; ihre Angaben stehen dann im Abschnitt Marktplatzangaben.

Aufbau

Die Karte ist nach Aufgaben gegliedert:

Bereich Inhalt
Allgemein Fehlermeldung der letzten Synchronisation (nur bei einem Fehler, mit maschineller Übersetzung), Marktplatz, Verkaufskanal, Artikel, Variante, Marktplatz-Artikel-ID, SKU, EAN, Marke, Hersteller, MPN, Kategorie, Attributstatus, Online-Status, Synchronisierungsstatus.
Marktplatzangaben Angaben des Connectors zum Angebot, etwa Zustand, Kategorie oder Richtlinien – nur bei Angeboten seines Marktplatzes. Ohne solche Angaben bleibt der Bereich verborgen.
Inhalt Inhaltssprache, Titel, Untertitel.
Beschreibung, Kanalbeschreibung Beschreibungsvorlage und eigene Beschreibung des Kanals – siehe Beschreibung.
Aufzählungspunkte und Suchbegriffe Woher die Listen stammen und die eigenen Listen des Angebots.
SEO Meta-Titel, Meta-Beschreibung, SEO-Schlüsselwörter, URL-Pfad.
Preis & Menge und Lagerstandorte Preis, Business-Preis, Preisprüfung, Bestand, Bestandsregeln, Bearbeitungszeit, Lagerstandorte.
Marktplatzpreise und -bestand Preis- und Bestandsangaben des Connectors, etwa Gebühren oder Mengen im Lager des Marktplatzes.
Bilder und Dokumente Primärbild, Bildauswahl und Produktdokumente – siehe Produktbilder.
Technische Angaben Synchronisierung, Aktualisierungsflags und Zeitstempel unter Mehr anzeigen, dazu Gewicht und Abmessungen bei Kanälen, die sie übernehmen.

Aktionen des Connectors stehen in der Gruppe Marktplatz, etwa Hochladen, Status abrufen oder das Angebot beim Marktplatz öffnen.

Was die Karte ausblendet

Felder, die der Kanal nicht übernimmt, blendet die Karte aus. Maßgeblich ist das Inhaltsprofil des Marktplatzes (Marktplatzkarte, Aktion Inhaltsprofil; Spalte Unterstützt je Inhaltsfeld): Titel, Untertitel, Beschreibung, Aufzählungspunkte, Suchbegriffe, Meta-Titel, Meta-Beschreibung, URL-Pfad, Bilder, Marke, Hersteller, MPN, EAN und Kategorie. Ein Inhaltsfeld ohne Zeile im Profil bleibt sichtbar. Übernimmt der Kanal weder Aufzählungspunkte noch Suchbegriffe, entfallen auch Eigene Listen für diesen Kanal schreiben und Wieder Artikellisten verwenden.

Gewicht und Abmessungen zeigt die Karte nur bei einem Kanal, dessen Inhaltsprofil das Inhaltsfeld Gewicht & Abmessungen als unterstützt führt. Ein Connector, der Maße sendet, legt diese Zeile an; sonst fügen Sie sie im Inhaltsprofil selbst hinzu. Auf Connector-Vorgaben zurücksetzen entfernt eine selbst angelegte Zeile wieder.


Felder

Feld Beschreibung
Marktplatz Zugehöriger Marktplatz.
Artikelnr. BC-Artikelnummer.
SKU Marktplatz-SKU.
Beschreibung Artikelbeschreibung.
Titel Titel, den der Kanal zeigt. Ein neues Angebot beginnt mit der Artikelbeschreibung, eine Variantenzeile mit „Beschreibung - Variantenbeschreibung“, ein Verkaufskanal in einer anderen Sprache mit der Artikelübersetzung. Solange der Titel genau dieser Text ist, folgt er dem Artikel: Ändern Sie die Artikelbeschreibung, die Variantenbeschreibung oder die Übersetzung, bekommt das Angebot den neuen Text und wird zur Aktualisierung markiert. Einen geänderten Titel – von Hand, aus einer Product-Data-Vorlage oder der SEO Engine – lässt das unberührt. Ein leerer Titel sendet die aktuelle Artikelbeschreibung bzw. Übersetzung.
EAN/GTIN Barcode des Artikels.
Preis Preis, den der Artikel auf dem Marktplatz haben soll. Bei Marktplätzen mit Preisen aus Verkaufspreislisten kommt er aus der Liste des Verkaufskanals und ist nur bei Preis fixiert änderbar. 0 bei einem Artikel, der nur Geschäftskunden angeboten wird und nur einen Business-Preis hat (siehe Business-Preis).
Business-Preis Preis für Geschäftskunden aus der Business-Preisliste des Verkaufskanals, in Währung und MwSt.-Basis des Preises. Leer, wenn der Artikel keinen hat. Nur bei Marktplätzen mit Business-Preisen.
Preis fixiert Der Preis wird nicht aus der Preisliste übernommen; gesendet wird der von Hand eingegebene Preis. Beim Zurücksetzen gilt sofort wieder der Listenpreis. Das gilt auch für den Business-Preis.
Preis inkl. MwSt. Ob der Preis die MwSt. enthält – aus der Preisliste, bei einem fixierten Preis von Hand passend einzustellen.
Preislistencode Liste, aus der der Preis stammt.
Preisfehler Warum der Artikel keinen gültigen Preis hat, warum die Preisprüfung seinen Preis sperrt oder warum der Marktplatz den letzten Preis abgelehnt hat. Solange ein Artikel keinen gültigen Preis hat, wird für ihn kein Preis gesendet; auf dem Marktplatz bleibt der bisherige.
Gesperrter Preis Preis aus der Preisliste, den die Preisprüfung sperrt. Bis er die Prüfung besteht oder freigegeben wird, behält der Artikel seinen bisherigen Preis.
Zuletzt veröffentlichter Preis (netto) Nettopreis, den der Marktplatz zuletzt angenommen hat. Die Preisprüfung misst daran die Abweichung eines neuen Preises.
Freigegebener Preis Von Hand freigegebener Preis, obwohl er zu weit vom zuletzt veröffentlichten abweicht. Die Freigabe endet, sobald der Marktplatz ihn angenommen hat.
Gesperrter Business-Preis, Zuletzt veröffentlichter Business-Preis (netto), Freigegebener Business-Preis Dasselbe für den Business-Preis. Eine Sperre hält beide Preise zurück, eine Freigabe gilt für beide Beträge.
Bestand Gemeldete Bestandsmenge.
Verfügbarkeit aus Montagestückliste Ob ein Set mit Montage auf Auftrag die Menge meldet, die sich aus seinen Komponenten montieren lässt. Standard folgt der Einrichtung. Siehe Sets mit Montagestückliste.
Bearbeitungszeit (Tage) Zusage zur berechneten Menge: die Bearbeitungszeit der langsamsten Quelle, deren Bestand in der Menge enthalten ist. Ein Klick zeigt die Bestandsquellen – siehe Bearbeitungszeit. Ein Connector, der die Menge selbst rechnet, zeigt sie so, wie er rechnet (eBay etwa mit dem Lagerort des eBay-Marktplatzes).
Zuletzt veröffentlichte Bearbeitungszeit (Tage) Zusage, die der Marktplatz zuletzt übernommen hat. Weicht die berechnete ab, wird die Menge erneut gesendet.
Online-Status Ob der Artikel aktuell gelistet ist.
Herkunft der Kategorie Woher die Marktplatzkategorie stammt: Abgeleitet aus der Kategoriezuordnung der Artikelkategorie, Manuell eingegeben oder vom Marktplatz geliefert. Nur eine abgeleitete Kategorie folgt Änderungen der Zuordnung; eine Eingabe im Feld macht sie manuell.
Attributstatus Ergebnis der letzten Attributprüfung: OK, Warnung (einige Attribute werden nicht gesendet) oder Gesperrt (ein Pflichtattribut fehlt, das Angebot wird nicht gesendet). Ein Klick öffnet die Attributprobleme.

Beschreibung

  • Beschreibungsvorlage: Beschreibungsvorlage, mit der dieses Angebot gesendet wird. Leer bedeutet die Vorlage seines Verkaufskanals, sonst die des Marktplatzes.
  • Wirksame Vorlage und Vorlage von zeigen, welche Vorlage tatsächlich gilt und woher sie stammt.
  • Kanalbeschreibung: eine nur für diesen Kanal geschriebene Beschreibung, im Rich-Text-Editor. Leer bedeutet den Marketingtext des Artikels, sonst den Text einer externen Quelle, sonst die Artikelbeschreibung. Eine Beschreibungsvorlage setzt sie in ihren Abschnitt Beschreibungstext ein.
  • Vorschau der Beschreibung zeigt die Beschreibung, die das Angebot sendet, so wie der Käufer sie sieht, und darunter ihr HTML.

Hinweis: Der Rich-Text-Editor speichert die Kanalbeschreibung als HTML. Kanäle, die nur reinen Text annehmen, entfernen die Auszeichnungen selbst.

Attribute

Die FactBox Attribute zeigt live, welche Attribute das Angebot in der Sprache seines Verkaufskanals sendet. Attribute prüfen prüft alle Sprachen des Verkaufskanals, schreibt die Attributprobleme und den Attributstatus. Siehe Marktplatz-Attribute.

Aktion Preis berechnen

Übernimmt den Preis sofort aus der Preisliste des Verkaufskanals, ohne ihn zu senden – etwa nachdem Sie die Preisliste ergänzt haben. Gesendet wird er mit der nächsten Preissynchronisation.

Aktion Preis freigeben

Gibt einen Preis frei, den die Preisprüfung wegen seiner Abweichung vom zuletzt veröffentlichten Preis sperrt. Er wird mit der nächsten Preissynchronisation gesendet; die nächste Änderung wird wieder geprüft. Ein Preis unter dem Einstandspreis oder der Mindestmarge lässt sich nicht freigeben – er muss in der Preisliste korrigiert werden.

Produktbilder

Die Bildauswahl im Bereich Bilder und Dokumente zeigt die Bilder des Artikels; ein Haken bestimmt, welche davon dieser Kanal bekommt. Ein Artikel kann bis zu 100 Bilder haben; jeder Kanal sendet davon so viele, wie er annimmt.

Die Aktion Artikelbilder-Vorschau auf der Artikelkarte öffnet die Bilder des Artikels als Galerie auf einer eigenen Seite; ein Klick auf ein Bild öffnet es. Dieselbe Seite öffnen Listen, die Bilder je Artikel zählen – etwa die Spalte Übernommene Bilder auf den Icecat-Inhalten von Product Enrichment (Bilder, die dort ohne Medienspeicher als Artikelbild gespeichert wurden, zeigt stattdessen die Artikelkarte).

Bilder je Artikelvariante

Ein Bild kann einer oder mehreren Artikelvarianten gehören – das Foto des roten Shirts der Farbe Rot in jeder Größe, ohne die Datei doppelt abzulegen. Die Spalte Varianten zeigt, zu welchen Varianten ein Bild gehört; ist sie leer, ist es ein allgemeines Bild des Artikels.

  • Varianten zuweisen (oder ein Klick in die Spalte Varianten) öffnet die Varianten des Artikels. Ein Haken gibt das Bild der Variante.
  • Gleichem Wert zuweisen gibt das Bild jeder Variante, die einen Attributwert mit der markierten Variante teilt – etwa allen Varianten mit Farbe: Rot. Grundlage sind die Attribute der Artikelvarianten. Später angelegte Varianten weisen Sie mit derselben Aktion nach.
  • Allen zuweisen und Allgemein machen gelten für alle Varianten auf einmal.

Eine Variante zeigt im Kanal zuerst ihre eigenen Bilder, danach die allgemeinen; ihr erstes eigenes Bild ist das Titelbild. Eine Variante ohne eigene Bilder zeigt die allgemeinen. Kanäle, die Bilder je Variante noch nicht senden, senden weiterhin alle Bilder des Artikels. Wird ein Bild oder eine Variante gelöscht, verschwindet die Zuordnung mit.

  • Jede Änderung einer Zuordnung merkt die Marktplatzzeilen des Artikels in den Kanälen, die Bilder je Variante senden, zum Hochladen vor; der nächste Lauf sendet die neuen Bilder.
  • Haben einige Varianten eigene Bilder und andere nicht – etwa später angelegte –, nennt ein Hinweis über den Artikelbildern die Varianten ohne eigene Bilder (höchstens zehn).
  • Die Shop-Galerie an der Zeile einer Variante zeigt in Kanälen, die Bilder je Variante senden, genau die Bilder dieser Variante – eigene, dann allgemeine. Haken und Pfeile gelten für das Bild im Shop und damit für alle Varianten; die Pfeile verschieben ein Bild innerhalb der eigenen bzw. der allgemeinen Bilder. Das Titelbild der Variante ist ihr erstes eigenes Bild; nur eine Variante ohne eigene Bilder übernimmt das Titelbild des Shops. Den Stern setzen Sie hier auf ein allgemeines Bild – er bestimmt das Titelbild des Shops und damit des übergeordneten Produkts. Bleibt kein eigenes oder allgemeines Bild ausgewählt, geht die ganze Galerie hinaus, und die Galerie zeigt sie. Kanäle, die an jeder Zeile die ganze Galerie senden, zeigen auch an Variantenzeilen die Artikelgalerie.
  • Wann und was ein Kanal daraus sendet, beschreibt seine eigene Seite. Amazon etwa sendet Bilder nur auf Anforderung und einer Variante ohne eigenes oder allgemeines Bild keines (siehe Amazon-Bild-Upload).

Marktplatzangaben

Was ein Marktplatz zusätzlich führt, steht in den Abschnitten Marktplatzangaben und Marktplatzpreise und -bestand und in der Aktionsgruppe Marktplatz. Welche Felder das sind, beschreibt die Hilfe des jeweiligen Connectors. Auf einem Angebot eines anderen Marktplatzes sind diese Abschnitte und Aktionen nicht zu sehen.


Für Entwickler: Slots der Angebotskarte

Ein Connector bringt keine eigene Angebotskarte mit, sondern erweitert diese Karte per pageextension auf "ALN MC Marketplace Item Card". Der Vertrag:

Slot Art Wofür
ChannelListing Gruppe nach Allgemein Angaben zum Angebot (Zustand, Kategorie, Richtlinien, IDs des Marktplatzes)
ChannelCommerce Gruppe nach Preis & Menge eigene Preis- und Bestandsangaben (Gebühren, Mengen im Lager des Marktplatzes)
ChannelActions Aktionsgruppe in area(Processing) Aktionen zum Angebot
Category_Channel Gruppe in area(Promoted) die hervorgehobenen davon (actionref)
FactBoxes addlast kanaleigene FactBoxes

Regeln:

  • Felder direkt einfügen, nicht als Part: addlast(ChannelListing) { group(<Präfix>Listing) { … } }. Die Felder liegen per tableextension in derselben Tabelle; ein Part bräuchte einen SubPageLink und liefe auf jeder Karte mit, auch unsichtbar.
  • Parts nur für eigene Tabellen (etwa Zustandsdetails oder Angebote eines Marktplatzes), mit SubPageLink auf alle vier Schlüsselfelder der Angebotstabelle: "Marketplace Code", "Sub-Account Code", "Item No.", "Variant Code".
  • Visible je Marktplatz aus OnAfterGetCurrRecord der pageextension: IsOwnRow := Rec."Marketplace Code" = <Codequelle>(); – den Code aus der eigenen Einrichtung bzw. Codeunit, nie als Literal. Gilt für Gruppen, Felder, Parts und Aktionen.
  • Präfix des Connectors in jedem Control- und Aktionsnamen; mehrere Apps erweitern dieselbe Seite.
  • Rechte über Enabled, nicht über Visible: eine Aktion, die Schreibrechte braucht, bleibt sichtbar und ist ohne die Rechte gesperrt.
  • Slot-Namen nicht verwenden, um Hub-Felder zu verdrängen. Hub-Felder, die ein Kanal nicht übernimmt, blendet die Karte selbst nach dem Inhaltsprofil aus; der Connector pflegt dafür nur sein Profil (OnSeedChannelContentProfile).
  • Einstieg: Connector-Listen setzen CardPageId = "ALN MC Marketplace Item Card"; Drilldowns, Fehlernavigation und Problemlisten rufen "ALN MC Marketplace Mgmt.".OpenListingCard(MarketplaceItem). Die Prozedur sucht das Angebot über die vier Schlüsselfelder und öffnet genau dieses; eine Überladung nimmt die vier Schlüsselfelder direkt. Gibt es das Angebot nicht mehr, meldet sie das und liefert false; ohne Benutzeroberfläche (Aufgabenwarteschlange) liefert sie false ohne Meldung. OnDrillDownMarketplaceItemCard muss ein umgestellter Connector nicht mehr behandeln.
  • Hub-Benutzer ohne Connector-Berechtigungssatz öffnen die Karte auch: Code des Connectors läuft in OnAfterGetCurrRecord nur auf eigenen Zeilen und nur, wenn der Benutzer mit dem Connector arbeiten darf (etwa ReadPermission einer Connector-Tabelle in OnOpenPage). Die Tabelle eines Parts liest er mit, auch auf fremden Zeilen desselben Artikels – sie braucht dann InherentPermissions = R, und der Part ist nur für Connector-Benutzer editierbar. Eine Tabelle, die nur den Artikel kennt (eBay-Zustandsdetails), bindet nur "Item No.".
  • Modal öffnen (etwa für „Lösen“ im Hub, das nach dem Schließen neu prüft): das Angebot holen, SetRecFilter() und Page.RunModal(Page::"ALN MC Marketplace Item Card", …) – OpenListingCard öffnet nicht modal.
  • Bestandsquellen: Rechnet ein Connector die Menge selbst (eBay mit dem Lagerort seines Marktplatzes), zeigt er die Quellen hinter Bearbeitungszeit (Tage) über OnBeforeShowInventorySources (ALN MC Event Publisher) so, wie er rechnet.

Vorlage: Test-App ALN MC Test Listing Slot (pageextension 72887) mit den Tests ALN MC Listing Card Tests (72948).