Handwerkersoftware (IDS Connect)

Diese Seite zeigt allen, die eine Handwerkersoftware einrichten, wie sie die Software über IDS Connect mit einem punchout.dev-Shop verbinden.

Was Sie vom Shop-Betreiber brauchen

Angabe	Übliche Bezeichnung in der Software	Wert
Roundtrip-URL	Roundtrip-URL	https://api.punchout.dev/v1/ids/launch/<shop id>
Benutzername	Benutzername	Die Kennung des Zugangs
Passwort	Passwort	Das Secret des Zugangs; der Shop-Betreiber sieht es nur einmal
Kundennummer	Kundennummer	Nur wenn Ihre Software kein Feld für den Benutzernamen hat (siehe unten)

Der Shop-Betreiber findet die Roundtrip-URL im Tab Einbindung des Shops unter Launch-URLs für das Einkaufssystem, IDS Connect Roundtrip-URL, und legt den Einkäufer-Zugang im Tab Einkäufer an.

Schränkt der Shop-Betreiber die Rücksprung-Adressen unter Erlaubte Rücksprung-Hosts ein, nennen Sie ihm den Hostnamen, auf dem Ihre Software den Warenkorb empfängt.

Was Sie in der Software eintragen

Tragen Sie die Roundtrip-URL so ein, wie sie angezeigt wird, ohne Schrägstrich am Ende, dazu Benutzername und Passwort vom Shop-Betreiber. Wo diese Felder liegen, hängt vom Programm ab; die Maske zeigt dessen Dokumentation.

Fragt Ihre Software nur nach einer Kundennummer und hat kein Feld „Benutzername“, tragen Sie dort die Kundennummer ein und das Passwort wie gewohnt. Der Shop-Betreiber legt den Zugang dann mit dieser Kundennummer als Kennung an. Sind beide Felder ausgefüllt, gilt der Benutzername.

punchout.dev unterstützt nur den Warenkorb-Roundtrip: Der Benutzer öffnet den Shop aus der Software, füllt den Warenkorb und übergibt ihn zurück. Funktionen wie das Senden eines Warenkorbs aus der Software in den Shop, den Direktaufruf eines Artikels oder die Artikelsuche bietet punchout.dev nicht an.

Die Verbindung testen

1. Starten Sie den Verbindungstest der Software, falls es einen gibt. punchout.dev beantwortet ihn ohne Anmeldung; er bestätigt also die Adresse, nicht aber die Zugangsdaten.
2. Starten Sie den Punchout aus der Software.
3. Legen Sie zwei oder drei Artikel in den Warenkorb des Shops und öffnen Sie die Warenkorbseite.
4. Prüfen Sie die Artikel, die das Panel anzeigt, und klicken Sie auf An Einkaufssystem übergeben.
5. Starten Sie den Punchout noch einmal und klicken Sie auf Zurück zum Einkaufssystem.

So sieht ein erfolgreicher Test aus

• Der Shop öffnet sich mit dem Punchout-Panel, das „Punchout aktiv“ anzeigt.
• Auf der Warenkorbseite zeigt das Panel die Artikel mit Menge und Preis.
• Nach der Übergabe stehen die Artikel mit Artikelnummer, Menge, Einheit und Preis in der Software.
• Nach Zurück zum Einkaufssystem schließt die Software den Punchout, ohne etwas hinzuzufügen.

Hat der Shop-Betreiber für Ihren Zugang Auto-Login eingerichtet, ist der Handwerker im Shop gleich mit dem zugeordneten Shop-Konto angemeldet und sieht dessen Preise.

punchout.dev übergibt die Preise so, wie Handwerkersoftware sie erwartet. Ob die Shop-Preise die MwSt. enthalten und welcher MwSt.-Satz gilt, stellt der Shop-Betreiber im Portal ein.

Wenn der Test fehlschlägt

Was Sie sehen	Ursache	Was zu tun ist
Eine Seite „Zugang verweigert / Access denied“	Benutzername, Kundennummer oder Passwort stimmen nicht, oder der Zugang ist deaktiviert	Gleichen Sie die Angaben mit dem Shop-Betreiber ab oder lassen Sie sich ein neues Passwort geben
Dieselbe Seite	Der Shop lässt die Adresse, auf der Ihre Software den Warenkorb empfängt, nicht zu	Nennen Sie dem Shop-Betreiber Ihren Hostnamen; er trägt ihn unter Erlaubte Rücksprung-Hosts ein
Dieselbe Seite	Die Software hat eine andere Funktion als den Warenkorb-Roundtrip angefordert	Verwenden Sie nur den Warenkorb-Roundtrip
Dieselbe Seite	Die Roundtrip-URL enthält eine falsche Shop-ID	Lassen Sie sich die URL noch einmal vom Shop-Betreiber geben
Eine Seite „Punchout nicht freigeschaltet / Punchout not enabled“	Der Shop ist noch in der Sandbox	Bei Ihnen ist nichts zu tun. Siehe Pläne und Sandbox
Der Shop öffnet sich ohne Punchout-Panel	Der Shop leitet den Browser auf eine Adresse um, die nicht für punchout.dev eingetragen ist, zum Beispiel mit oder ohne www.	Der Shop-Betreiber trägt diese Adresse im Tab Allgemein unter Erlaubte Origins ein
Die Schaltfläche An Einkaufssystem übergeben reagiert nicht	Die Content-Security-Policy des Shops blockiert den Rücksprung-Host Ihrer Software	Der Shop-Betreiber gibt Ihren Host in dieser Policy frei
Die Software weist den übergebenen Warenkorb ab	Der Warenkorb enthält Artikelnummern mit mehr als 15 Zeichen, und manche Handwerkersoftware kann solche Nummern nicht verarbeiten. punchout.dev kürzt Artikelnummern nie, denn mit einer gekürzten Nummer wird der falsche Artikel bestellt	Prüfen Sie, ob Ihre Software längere Artikelnummern annimmt, und sprechen Sie mit dem Shop-Betreiber
Die Übergabe schlägt nach einer längeren Pause fehl	Ein Punchout ist vier Stunden gültig	Starten Sie den Punchout neu

Die Seite „Zugang verweigert“ sieht bei jeder Ursache gleich aus. Das ist Absicht: Sie soll nichts über den Shop oder den Zugang verraten. Gehen Sie die Ursachen deshalb der Reihe nach durch.