Mit der winkler-OCI-Anbindung öffnen Sie den winkler-Onlineshop direkt aus einem Auftrag, übernehmen den Warenkorb in die Positionen und können die Bestellung wahlweise schon im Shop auslösen. Artikelnummer, Bezeichnung, Menge, Einkaufspreis, UVP, Mengeneinheit, Pfand und Positionsnotiz kommen dabei mit. Eine im Shop abgeschlossene Bestellung liefert zusätzlich die winkler-Auftragsnummer und die Frachtkosten.
Voraussetzung
winkler richtet für OCI einen eigenen Zugang ein. Das ist nicht der normale Login des Onlineshops. Sie brauchen von winkler:
- Benutzername (LoginName, in der Regel eine E-Mail-Adresse)
- Passwort
- Portal-ID
- Member-ID im Format OCI plus Ihre winkler-Kundennummer, zum Beispiel
OCI123456 - die OCI-Einstiegs-URL (eine https-Adresse)
Ohne Portal-ID und Member-ID lässt sich der Katalog nicht öffnen.
Schnittstelle einrichten
Öffnen Sie den Systemeditor, wechseln Sie zu API und klappen Sie winkler OCI auf. Tragen Sie ein:
| Feld | Inhalt |
|---|---|
| Anbieter | aktiviert |
| Username | der OCI-Benutzer von winkler |
| Passwort | das OCI-Passwort |
| Portal-ID | die Portal-ID von winkler |
| Member-ID | OCI plus winkler-Kundennummer |
| Land | DE |
| Sprache | DE |
| OCI Einstiegs-URL | die https-Adresse von winkler |
Speichern Sie die Einstellungen. Mit >> Katalog-Einstieg testen prüfen Sie, ob der Shop sich öffnet. Erlauben Sie Popups für CATAMA, sonst blockiert der Browser das Katalogfenster.
Die Rücksprungadresse erzeugt CATAMA selbst. Sie müssen sie nicht eintragen.
Katalog aus dem Auftrag öffnen
Öffnen Sie den Auftrag, in den die Teile sollen. Im Positionsbereich finden Sie den Button winkler.
- Katalog öffnen startet den winkler-Shop in einem neuen Fenster. Sie sind dort bereits angemeldet.
- Legen Sie die Artikel in den Warenkorb. Eine Positionsnotiz am Artikel (maximal 35 Zeichen) wird mit übernommen.
- Entscheiden Sie, ob Sie nur den Warenkorb zurückgeben oder im Shop bestellen.
Warenkorb oder Bestellung
winkler unterscheidet zwei Wege. CATAMA liest beide über denselben Import.
Nur den Warenkorb übertragen (ohne Bestellung im Shop): CATAMA übernimmt die Positionen, den UVP, Pfand und die Positionsnotiz. Die Felder Auftragsnummer und Fracht bleiben leer, weil winkler sie in diesem Fall nicht mitschickt.
Im Shop bestellen: Zusätzlich kommen die winkler-Auftragsnummer und die Frachtkosten. Die Auftragsnummer landet in ext. Auftr.-Nr. des Belegs. Die Fracht wird eine eigene Position. Das ist ein echter Auftrag: winkler bearbeitet und liefert ihn. Eine Stornierung gibt es nur, wenn winkler sie im Rahmen eines gemeinsamen Tests manuell vornimmt.
Haben Sie zuerst nur den Warenkorb importiert und bestellen danach, öffnen Sie den Katalog erneut, schließen die Bestellung ab und importieren noch einmal. Der erste Warenkorb ist nach dem Import verbraucht. Der zweite Import legt die Artikel erneut an. Für einen sauberen Beleg löschen Sie die ersten Positionen vorher oder nutzen einen neuen Auftrag.
Positionen importieren
Nachdem der Shop zurückgesprungen ist, erscheint am Menüpunkt Warenkorb importieren nach wenigen Sekunden ein Badge. Klicken Sie darauf.
CATAMA legt an:
- jede Artikelposition mit Artikelnummer, Bezeichnung, Menge, Einkaufspreis (netto) und UVP (netto, Brutto wird mit 19 % gerechnet)
- die Mengeneinheit, soweit sie bekannt ist (Stück, Pack, Liter, Meter, Paar, Set)
- Pfand als eigene Position direkt hinter dem zugehörigen Artikel, Menge wie beim Artikel
- Frachtkosten als eine Position am Ende, von brutto auf netto gerechnet, nur wenn im Shop bestellt wurde und Fracht angefallen ist
- die Positionsnotiz im internen Kommentar der Position
- die winkler-Auftragsnummer in ext. Auftr.-Nr., nur wenn dieses Feld noch leer ist
Prüfen Sie die Positionen und speichern Sie den Beleg. Ohne Speichern bleibt die ext. Auftr.-Nr. nicht erhalten.
Bestätigungs-E-Mail
Die Adresse für die Bestellbestätigung pflegt winkler am OCI-Zugang. Sie ist dort ein Pflichtfeld und lässt sich im Shop bei jeder Bestellung noch ändern. In CATAMA gibt es dafür kein eigenes Feld.
Wenn etwas nicht klappt
- Der Katalog öffnet sich nicht: Anbieter aktiviert, Username, Passwort, Portal-ID, Member-ID und eine https-Einstiegs-URL prüfen. Popups für die Seite erlauben.
- Es liegt kein Warenkorb vor: Zuerst im Shop den Warenkorb übertragen oder die Bestellung abschließen, dann importieren. Ein bereits importierter Warenkorb lässt sich nicht ein zweites Mal einlesen.
- ext. Auftr.-Nr. und Fracht fehlen: Das ist normal, solange im Shop nicht bestellt wurde. Nach einer Bestellung den Katalog erneut öffnen und neu importieren. Steht in ext. Auftr.-Nr. schon ein Wert, wird er nicht überschrieben.
- Die Mengeneinheit ist Stück, obwohl es Liter oder Meter sein sollte: Unbekannte Einheiten setzt CATAMA auf Stück. Zentimeter kennt CATAMA nicht; solche Artikel bleiben ebenfalls bei Stück.
Bei Fragen zur Freischaltung des OCI-Zugangs wenden Sie sich an winkler. Bei Fragen zur Einrichtung in CATAMA steht der Support unter support@catama-software.de zur Verfügung.