Im Rahmen der Zusammenarbeit zwischen nextPIM und dem E/D/E ist eine Schnittstelle zwischen nextPIM und dem OSG-Trade-Shop entstanden. Über diese Schnittstelle importieren Sie Kataloge aus Ihrem OSG-Shop in nextPIM, überarbeiten sie dort und übertragen sie anschließend zurück in den Shop.
Für den Zugriff benötigen Sie die OSG-Trade-API. Dieses Plug-in steht Ihnen direkt in Ihrem OSG-Shop zur Verfügung.
Verbindung einrichten
Schritt 1: OSG-Trade-API im App-Store erwerben
Melden Sie sich in Ihrem OSG-Shop an und öffnen Sie den Bereich „Shop Apps“. Über „Zum App-Store“ erwerben Sie dort die OSG-Trade-API.
Abbildung 1: Die OSG-Trade-API im Bereich „Shop Apps“ des OSG-Shops.
Anschließend steht Ihnen der Web-Service in der Übersicht zur Verfügung.
Abbildung 2: Übersicht „Shop Webservice“ mit dem angelegten API-Zugang.
Schritt 2: Zugangsdaten prüfen und API-Key kopieren
Prüfen Sie die hinterlegten Daten, bevor Sie den API-Key kopieren. Folgende Angaben müssen passen:
- Gültigkeit: ab dem ersten Tag der Nutzung
- Benutzername: ein Benutzer mit Administratorrechten
Sind beide Angaben korrekt, kopieren Sie den API-Key.
Abbildung 3: Reiter „Zugang bearbeiten“ mit API-Key und Gültigkeitszeitraum.
Schritt 3: Verbindung in nextPIM hinterlegen
Öffnen Sie in nextPIM über das Benutzer-Symbol oben rechts den Menüpunkt „Account“.
Abbildung 4: Benutzermenü mit dem Eintrag „Account“.
Wechseln Sie in den Reiter „OSG Verbindung“ und tragen Sie im Unterreiter „Live“ Ihre Shop-URL und den kopierten API-Key ein.
Abbildung 5: Reiter „OSG Verbindung“ mit den Feldern „Shop URL“ und „API-Key“ (API-Key unkenntlich gemacht).
Schritt 4: Verbindung testen
Klicken Sie auf „Verbindung testen“. Ist der Test erfolgreich, erscheint auf der Schaltfläche ein Häkchen (siehe Abbildung 5).
Zusätzlich können Sie die Shop-URL in Ihrem Browser aufrufen. Erscheint eine Meldung wie in der folgenden Abbildung, ist die URL korrekt.
Abbildung 6: Antwort der OSG-Trade-API bei korrekter Shop-URL.
Katalog aus dem OSG-Shop importieren
Sobald die Verbindung eingerichtet ist, importieren Sie die Kataloge aus Ihrem OSG-Shop in nextPIM. Klicken Sie dazu in der Katalogübersicht auf „Importieren“.
Abbildung 7: Katalogübersicht mit der Schaltfläche „Importieren“.
Wechseln Sie im Dialog „Katalog importieren“ in den Reiter „OSG-Shop“. Im Feld „Sortiment“ stehen Ihnen die Sortimente Ihres OSG-Shops zur Auswahl. Klappen Sie die Auswahl auf und wählen Sie das gewünschte Sortiment aus. Über den Schalter „Wurzelkategorie ignorieren“ legen Sie zusätzlich fest, ob die Wurzelkategorie beim Import übersprungen werden soll.
Abbildung 8: Dialog „Katalog importieren“, Reiter „OSG-Shop“.
Katalog in den OSG-Shop übertragen
Haben Sie die Anpassungen im Katalog abgeschlossen, übertragen Sie ihn zurück in Ihren OSG-Shop. Öffnen Sie dazu im Katalog den Reiter „Einstellungen“, wechseln Sie in den Unterreiter „OSG-Shop“ und klicken Sie auf „Katalog senden“.
Abbildung 9: Reiter „Einstellungen“ › „OSG-Shop“ mit der Schaltfläche „Katalog senden“.
Übertragene Felder
Die folgende Übersicht zeigt, welche Felder der OSG-Trade-API beim Übertragen aus nextPIM in den OSG-Shop befüllt werden und welche Felder beim Import aus dem OSG-Shop in nextPIM übernommen werden.
Artikeldaten
| Feld im OSG-Shop | Export (nextPIM nach OSG) | Import (OSG nach nextPIM) |
|---|---|---|
| item_number | Artikelnummer (SUPPLIER_PID) | Artikelnummer (SUPPLIER_PID). Ein vorangestelltes „Var“ wird entfernt. |
| original_item_number | Artikelnummer (SUPPLIER_PID) | Alternative Artikelnummer |
| item_name | Kurzbeschreibung | Kurzbeschreibung |
| item_description | Langbeschreibung. Je nach Einstellung des Sortiments mit rechtlichen Hinweisen und Gefahrstoffklassen. Ist keine Langbeschreibung vorhanden, wird die Kurzbeschreibung, ersatzweise die Artikelnummer verwendet. | Langbeschreibung |
| manufacturer | Herstellername | Herstellername |
| supplier_item_number | Hersteller-Artikelnummer. Ist das Zusatzfeld (UDX) Shop_Lieferantenartnr gepflegt, wird dessen Wert verwendet. | Hersteller-Artikelnummer |
| gtin | Internationale Artikelnummer (GTIN) | Internationale Artikelnummer (GTIN) |
| eclass | ECLASS-ID aus dem Merkmal bzw. Zusatzfeld | wird nicht übernommen |
| unspsc | UNSPSC aus dem Merkmal bzw. Zusatzfeld | Klassifizierung „UNSPSC-EDE“ |
| keywords | Schlagworte | Schlagworte |
| order | Produktreihenfolge | Produktreihenfolge |
| product_range | Sortiment der zugeordneten Kategorie | Sortiment |
| category_ids | Kategorien des Artikels inklusive Sortierung (nach Produktreihenfolge) | Kategorie-Zuordnung |
| item_group_number | Artikelnummer des Master-Artikels (bei Varianten) | Gruppierung der Varianten |
| item_details | Technische Merkmale mit Bezeichnung und Wert (inklusive Einheit). Zusätzlich werden Variantenmerkmale gekennzeichnet. Optional kann der Markenname als Merkmal übertragen werden. | Technische Merkmale |
| media | Medien mit Alternativtext und Beschreibung. Das Hauptbild wird gekennzeichnet. Details siehe Artikel „Schnittstelle OSG-Trade: Medien übertragen“. | Medien (Typ, Alternativtext, Beschreibung, Verwendungszweck, Dateiname) |
| additional_references | Referenzen: Zubehör, Besteht aus, Nachfolger, Andere Bestelleinheit, Ähnlich, Ersatzteil, Pflichtartikel | dieselben Referenztypen |
Preis, Mengen und Einheiten
| Feld im OSG-Shop | Export (nextPIM nach OSG) | Import (OSG nach nextPIM) |
|---|---|---|
| price | Preis aus der Preisliste. Welche Preisliste genutzt wird, legen Sie in den Einstellungen des Sortiments fest (Preistyp). Ist kein gültiger Preis hinterlegt, wird ein Platzhalterpreis übertragen. Bitte prüfen Sie die Preise vor der Übertragung. | Preis (Typ „net_list“, Währung EUR) |
| tax_rate | Steuersatz aus der Preisliste. Zulässig sind 0, 7, 16, 19, 20 und 21 %, andernfalls und ohne Angabe wird 19 % übertragen. | Steuersatz |
| sales_unit | Bestelleinheit (Standard: C62) | Bestelleinheit |
| sales_volume | Preismengeneinheit (Standard: 1) | Preismengeneinheit |
| minimum_order_quantity | Mindestbestellmenge | Mindestbestellmenge |
| sales_interval | Bestellintervall | Bestellintervall |
| packing_quantity | Verpackungsmenge. Ist das Zusatzfeld (UDX) DEFAULT_PACKING_QUANTITY gepflegt, wird dessen Wert verwendet (Standard: 1). | Verpackungsmenge |
| packing_unit | Inhaltseinheit. Ist sie leer, wird die Bestelleinheit verwendet. | Inhaltseinheit |
| item_group_discount_number | Rabattgruppe aus dem Zusatzfeld (UDX) DISCOUNT_GROUP_SUPPLIER | Rabattgruppe (als Zusatzfeld) |
Hinweis: Die Einheiten werden als Code nach UN/ECE-Empfehlung übertragen. Die Einheit C4 wird dabei automatisch in CG umgewandelt.
Status
| Feld im OSG-Shop | Export (nextPIM nach OSG) | Import (OSG nach nextPIM) |
|---|---|---|
| status | „Aktiviert“. Ist der Artikel als Auslaufartikel gekennzeichnet und das Auslaufdatum erreicht, wird „Auslaufartikel“ übertragen. | Status „Auslaufartikel“ setzt den Artikel in nextPIM auf „Auslaufartikel“ |
| hidden | wird nicht gesetzt | Ein ausgeblendeter Artikel gilt in nextPIM als Auslaufartikel |
Zusatzfelder für E/D/E und OXOMI
| Feld im OSG-Shop | Zusatzfeld (UDX) in nextPIM | Hinweis |
|---|---|---|
| prio (Suchpriorisierung) | Shop_Priorisierung | Ist nichts gepflegt, wird 999 übertragen. |
| oxomi_lieferantennr | Liefer_Nr_OXOMI | Lieferantennummer für OXOMI |
| oxomi_model_type | Modell_Typ_OXOMI | Modell bzw. Typ für OXOMI |
Die drei Felder werden auch beim Import aus dem OSG-Shop in die entsprechenden Zusatzfelder übernommen, sofern sie im Shop gepflegt sind.
Kategorien
Für Kategorien werden Name (maximal 100 Zeichen), Beschreibung, Reihenfolge, übergeordnete Kategorie, Sortiment und optional das Kategoriebild übertragen. Der Dateiname des Kategoriebilds darf maximal 100 Zeichen lang sein, nicht unterstützte Bildformate werden ohne Bild übertragen.
Hinweise
- Bei Master-Artikeln werden fehlende Angaben (z. B. Preis, Steuersatz, Einheiten, GTIN, Hersteller) aus dem ersten Varianten-Artikel ergänzt.
- Maßgeblich für den Datenaustausch ist die vom OSG-Shop bereitgestellte Version der OSG-Trade-API. Bei Rückfragen wenden Sie sich bitte an den nextPIM-Support.