# Erste Schritte Die zwei Wege zum Start mit punchout.dev, die fünf Einrichtungsschritte, die das Portal für jeden Shop verfolgt, und was die kostenlose Sandbox vor einem bezahlten Plan erlaubt. URL: https://punchout.dev/de/docs/getting-started/ Diese Seite führt einen Shop vom leeren Konto bis zum ersten Punchout mit punchout.dev und nennt für jeden Schritt die Seite, die ihn beschreibt. ## Zwei Wege zum Start | | Sofort-Tag | Zuerst ein Konto | | --- | --- | --- | | Wo Sie beginnen | Der Tag-Generator auf der [Startseite von punchout.dev](https://punchout.dev/de/) | [Registrieren](https://punchout.dev/signup) | | Was Sie eingeben | Die Domain Ihres Shops | E-Mail-Adresse, Passwort, Firmenname | | Was Sie sofort bekommen | Eine Shop-ID, das Script-Tag, einen Test-Punchout-Link und einen Link, mit dem Sie den Shop behalten | Ein Konto, eine Organisation und das Portal | | Lebensdauer des Shops | Vorläufig: wird nach 7 Tagen gelöscht, wenn Sie ihn nicht übernehmen | Von Anfang an Teil Ihrer Organisation | ### Das Sofort-Tag 1. Geben Sie unter **Ihr Tag erstellen** die Domain Ihres Shops ein und klicken Sie auf **Erstellen**. Geben Sie eine vollständige URL ein, wird ihr Pfad zu der Seite, auf der ein Punchout landet. 2. punchout.dev legt einen Shop für diese Origin an und zeigt das Script-Tag, einen Hinweis, wo Sie es einfügen, sowie **Test-Punchout in Ihrem Shop öffnen** und **Konto erstellen und diesen Shop behalten**. 3. Fügen Sie das Tag in Ihren Shop ein, wie unter [Das Tag einbinden](https://punchout.dev/de/docs/getting-started/install-the-tag/) beschrieben. 4. Öffnen Sie den Test-Punchout-Link. Er startet einen echten OCI-Punchout in Ihrem Shop, und der Warenkorb geht am Ende an punchout.dev statt an ein Einkaufssystem. Der Link funktioniert einmal und verfällt nach 60 Minuten. 5. Behalten Sie den Shop, indem Sie ihn übernehmen (siehe unten). Hinter einem vorläufigen Shop steht kein Konto. Er bekommt ein eigenes kleines Tagesbudget und wird nach 7 Tagen gelöscht, wenn ihn niemand übernimmt. ### Einen vorläufigen Shop übernehmen Der Link **Konto erstellen und diesen Shop behalten** öffnet die Registrierungsseite des Portals. - **Neues Konto.** Registrieren Sie sich auf dieser Seite. Der Shop wird Ihrer neuen Organisation zugeordnet, sobald Sie Ihre E-Mail-Adresse über den Link in der Bestätigungs-E-Mail bestätigt haben. Bis dahin gehört er niemandem. - **Bestehendes Konto.** Wählen Sie auf derselben Seite unter „Sie haben bereits ein Konto?“ **Anmelden** und melden Sie sich an. Der Shop wird der Organisation zugeordnet, in der Sie gerade arbeiten, und das Portal öffnet den Tab **Einrichtung** des Shops. Dafür brauchen Sie die Rolle Inhaber oder Admin, und Ihr Plan muss einen weiteren Shop erlauben. Ein abgelaufener, unbekannter oder bereits benutzter Link zeigt „Dieser Link ist abgelaufen.“ Mit der Übernahme beginnt der Sandbox-Zeitraum des Shops (siehe unten). ### Zuerst ein Konto 1. [Registrieren](https://punchout.dev/signup) Sie sich mit Ihrer E-Mail-Adresse, einem Passwort mit 12 bis 128 Zeichen und Ihrem Firmennamen. Die Firma wird Ihre Organisation, Sie werden ihr Inhaber, und sie startet im Plan Sandbox. 2. Öffnen Sie den Bestätigungslink aus der E-Mail. Er gilt 24 Stunden. Ein nie bestätigtes Konto wird nach 7 Tagen gelöscht. 3. Öffnen Sie im Portal **Shops** und klicken Sie auf **Neuer Shop**. Ein Name und eine Origin (`https://shop.example`) genügen. ## Die Einrichtungs-Checkliste Jeder Shop hat einen Tab **Einrichtung** mit einer Checkliste, und **Onboarding** in der Seitenleiste zeigt den Stand aller Shops. Das Portal gleicht jeden Schritt bei jedem Aufruf mit dem aktuellen Stand des Shops ab. Ein Schritt, den Sie anderswo erledigen, wird deshalb von selbst grün. | Schritt | Erledigt, wenn | Wo Sie ihn erledigen | | --- | --- | --- | | Shop angelegt | Der Shop existiert | Shops | | Snippet eingebunden | punchout.dev hat den Shop zum ersten Mal registriert: eine erfolgreiche Warenkorb-Erkennung per Setup-Link oder ein Punchout-Launch | Ihr Shop, mit dem Tag aus dem Tab **Einbindung** | | Warenkorb erkannt | Ein Warenkorb-Container wurde per Setup-Link geprüft | Tab **Einrichtung**, dann Ihr Shop | | Einkaufssystem angelegt | Der Shop hat mindestens einen Einkäufer-Zugang | Tab **Einkäufer** | | Test-Punchout | Ein Test-Punchout ist in den letzten 30 Tagen zurückgekommen | Tab **Einrichtung** | Der erste offene Schritt in der Reihenfolge Einbinden, Erkennen, Einkäufer, Test ist mit **Als Nächstes** markiert. Sind alle fünf erledigt, zeigt der Tab „Shop ist startklar.“ :::note Bei einem normalen Seitenaufruf bleibt das Tag still. **Snippet eingebunden** bleibt deshalb offen, nachdem Sie das Tag eingefügt haben. Grün wird der Schritt mit der ersten erfolgreichen Warenkorb-Erkennung oder dem ersten Punchout-Launch, Test-Punchouts eingeschlossen. Ein gehosteter Launch per OCI, cXML oder IDS Connect erreicht punchout.dev, bevor sich Ihr Shop öffnet, und hakt den Schritt deshalb auch dort ab, wo das Tag fehlt. **Prüfen** lädt den Schritt neu. ::: Ein Selector, den Sie im Tab **Warenkorb** von Hand eintragen, erledigt **Warenkorb erkannt** nicht. Dieser Schritt braucht einen geprüften Container. ## Was die Sandbox erlaubt Neue Organisationen starten im Plan Sandbox. Jeder Shop bekommt einen Sandbox-Zeitraum, der beginnt, sobald der Shop im Portal angelegt oder übernommen wird. Die Übersicht und die Shop-Liste zeigen die verbleibenden Tage. | Im Sandbox-Zeitraum | Erlaubt | | --- | --- | | Setup-Links und Warenkorb-Erkennung | Ja | | Test-Punchouts mit OCI, cXML und IDS Connect | Ja | | Ein aktiver Einkäufer-Zugang, um einen Go-live vorzubereiten | Ja | | Ein produktiver Punchout aus einem echten Einkaufssystem | Nein, er wird abgewiesen, bevor sich der Shop öffnet | Jeder Launch, der kein Test-Punchout ist, gilt als produktiv. Der Einkäufer sieht dann statt des Shops eine Absage: | Launch | Was der Einkäufer bekommt | | --- | --- | | OCI-Launch direkt am Shop | Das Panel zeigt „Punchout ist für diesen Shop noch nicht freigeschaltet. Bitte den Anbieter kontaktieren.“ | | Gehosteter Launch per OCI oder IDS Connect | Eine Seite „Punchout nicht freigeschaltet“ | | cXML-Launch | Das Einkaufssystem erhält statt einer Startseite eine Absage | Das Portal benachrichtigt alle Inhaber der Organisation per E-Mail, wenn Einkäufer abgewiesen werden, und 7 Tage vor dem Ende des Sandbox-Zeitraums eines Shops. Danach liest punchout.dev für diesen Shop keine Warenkörbe mehr: Warenkorb-Erkennung und Test-Punchouts ruhen, bis die Organisation in einen bezahlten Plan wechselt. Wie die Pläne funktionieren, steht unter [Pläne und Sandbox](https://punchout.dev/de/docs/account/plans-and-sandbox/), die Preise finden Sie im [Preisabschnitt](https://punchout.dev/de/#pricing). ## Weiterlesen Folgen Sie diesen vier Seiten der Reihe nach: 1. [Das Tag einbinden](https://punchout.dev/de/docs/getting-started/install-the-tag/) zeigt das Script-Tag, wo es auf jeder Plattform hingehört, die erlaubten Origins und die Content-Security-Policy. 2. [Warenkorb-Erkennung](https://punchout.dev/de/docs/getting-started/cart-detection/) erklärt den Setup-Link und wie punchout.dev lernt, wo Ihr Warenkorb ist. 3. [Test-Punchout](https://punchout.dev/de/docs/getting-started/test-punchout/) beschreibt einen echten Durchlauf durch Ihren Shop, in dem das Portal die Rolle des Einkaufssystems übernimmt. 4. [Einen Einkäufer verbinden](https://punchout.dev/de/docs/getting-started/connect-a-buyer/) behandelt Einkäufer-Zugänge, Launch-URLs und erlaubte Rücksprung-Hosts. Danach erklärt [Team](https://punchout.dev/de/docs/account/team/) Rollen und Einladungen, und [Sicherheit und Datenschutz](https://punchout.dev/de/docs/account/security-and-privacy/) zeigt, welche Daten wohin gehen.