Die Plattform-Boutique einrichten

Die Seite Boutique : paiement et transport (Boutique: Zahlung und Versand) der Console (Bereich Offres et prix, Tarife und Preise) ist dem Herausgeber von SheepOS vorbehalten. Sie bindet die Zahlung (Stripe Connect) und den Versand (Boxtal) aller Boutiquen an. Die eingegebenen Schlüssel werden beim Speichern verschlüsselt und nie wieder angezeigt. Jeder einklappbare Kasten der Seite wiederholt die untenstehenden Schritte, mit den zu kopierenden Adressen. Siehe auch den Online-Shop.

Häufige Aufgaben

Den Server vorbereiten

1. Erzeugen Sie den Verschlüsselungsschlüssel auf dem Server mit dem Befehl openssl rand -base64 32.
2. Tragen Sie das Ergebnis in die Umgebungsvariable INTEGRATIONS_TOKEN_KEY der API ein, niemals in eine versionierte Datei und nie in eine Nachricht. Ohne sie zeigt die Seite eine Warnung an, und es kann kein Schlüssel gespeichert werden.
3. Um den Schlüssel zu erneuern, ohne etwas zu verlieren, behalten Sie den alten während der Rotation in INTEGRATIONS_TOKEN_KEY_PREVIOUS.

Stripe Connect anbinden

1. Aktivieren Sie im Stripe-Dashboard Connect mit Konten vom Typ Standard: Jeder Händler eröffnet sein eigenes Konto, und SheepOS bewahrt keine Ausweisdokumente auf.
2. Kopieren Sie unter Developers, dann API-Schlüssel, den geheimen Testschlüssel (sk_test_…) und für die Produktion den geheimen Schlüssel sk_live_… (oder einen eingeschränkten Schlüssel rk_live_…). Fügen Sie sie in das Feld „Clé secrète“ (Geheimer Schlüssel) des jeweiligen Modus ein.
3. Fügen Sie unter Developers, dann Webhooks, einen Endpunkt vom Typ Connect hinzu. Die Adresse wird auf der Seite mit einer Schaltfläche Copier (Kopieren) angezeigt: Sie endet auf /public/shop-payments/webhooks/stripe.
4. Aktivieren Sie die Ereignisse: checkout.session.completed, payment_intent.succeeded, payment_intent.payment_failed, charge.refunded, charge.dispute.created, charge.dispute.closed, account.updated, account.application.deauthorized, payout.created, payout.updated, payout.paid, payout.failed und payout.canceled.
5. Kopieren Sie das Signaturgeheimnis des Endpunkts (whsec_…) in „Secret de signature du webhook“ (Signaturgeheimnis des Webhooks). Legen Sie pro Modus einen Endpunkt an: Jeder hat sein eigenes Geheimnis.
6. Speichern Sie und starten Sie dann in jedem Modus Tester la connexion (Verbindung testen).

Boxtal anbinden

1. Öffnen Sie in Ihrem Boxtal-Konto den Entwicklerbereich und erstellen Sie einen API-Schlüssel: Sie erhalten einen Zugangsschlüssel und einen geheimen Schlüssel.
2. Fügen Sie sie in die Felder des jeweiligen Modus ein (Sandbox-Schlüssel im Test, Produktionsschlüssel im Echtmodus).
3. Hinterlegen Sie in den Webhooks von Boxtal die auf der Seite angezeigte Adresse (sie endet auf /public/shop-carriers/webhooks/boxtal) und kopieren Sie das Signaturgeheimnis in das dafür vorgesehene Feld.
4. Speichern Sie und testen Sie die Verbindung in jedem Modus.

Provision und Versandmarge festlegen

Die Provision wird auf jeden Verkauf erhoben (ein Prozentsatz mit einer Obergrenze pro Bestellung) und kann je nach Tarif des Händlers variieren. Die Versandmarge wird auf den Einkaufspreis des Etiketts aufgeschlagen (ein Prozentsatz mit einem Mindestbetrag pro Paket). Die SheepOS geschuldeten Beträge werden monatlich zu einem Rechnungsentwurf zusammengefasst, den Sie vor der Ausstellung prüfen.

Den Echtmodus öffnen

1. Prüfen Sie, dass die Produktionsschlüssel gespeichert sind und der Verbindungstest der Produktion erfolgreich ist.
2. Drücken Sie Ouvrir le mode réel (Echtmodus öffnen) und bestätigen Sie.
3. Händler, die ein Konto im Testmodus verbunden hatten, können nichts mehr einnehmen, solange sie ihre Stripe-Registrierung nicht in der Produktion erneuert haben, im Reiter Zahlung ihrer Boutique. Das Schließen des Echtmodus versetzt sie wieder in die Testphase.

Alle Boutiquen verfolgen

Der Bereich Offres et prix der Console bietet außerdem die Ansicht Boutiques: alle Boutiquen aller Kundenorganisationen, nur als Aggregate, ohne jegliche Daten über Käufer.

1. Öffnen Sie Offres et prix → Boutiques. Oben nennen Zähler die Anzahl der Boutiquen, darunter die online, im Entwurf und gesperrten.
2. Suchen Sie nach Boutique, Organisation oder Adresse, filtern Sie nach Status (Brouillon, Entwurf; En ligne, Online; Suspendue, Gesperrt) und nach Zahlungsmodus (Essai, Test, oder Réel, Echt) und sortieren Sie dann (Organisation, Name, Status, Produkte, Bestellungen oder Umsatz der letzten 30 Tage, Erstellungsdatum).
3. Die Tabelle nennt für jede Boutique die Organisation, den Status, den Zahlungsmodus, den Zustand der Stripe-Verbindung, die Anzahl der Produkte, die Bestellungen und den Umsatz der letzten 30 Tage, die Erstellung und die Adresse des öffentlichen Schaufensters (Schaltfläche Copier). Exporter en CSV (Als CSV exportieren) lädt die Liste herunter.
4. Öffnen Sie eine Boutique für ihr Tableau de bord de la boutique (Dashboard der Boutique): Zeitraum (7 jours, 30 jours, 12 mois oder Personnalisée, Benutzerdefiniert), eingenommener Umsatz, bezahlte Bestellungen, durchschnittlicher Warenkorb, Konversionsrate, Aufteilung nach Kanal (Privatpersonen oder Geschäftskunden), nach Versandart und nach Zahlungsmittel, Produkte, Retouren, Streitfälle und vereinnahmte Provisionen, dann der Konfigurationsstand (Fait, Erledigt; À faire, Zu erledigen; Conseillé, Empfohlen).

Abschließende Checkliste

• INTEGRATIONS_TOKEN_KEY ist auf dem Server definiert.
• Connect ist mit Standard-Konten aktiviert, der Produktionsschlüssel und das Geheimnis des Connect-Webhooks sind gespeichert, der Produktionstest ist erfolgreich.
• Der Connect-Webhook der Produktion verweist auf die angezeigte Adresse und empfängt die aufgelisteten Ereignisse.
• Boxtal: Produktionsschlüssel, Tracking-Geheimnis und Tracking-Webhook sind eingerichtet.
• Provision und Marge sind für jeden Tarif festgelegt.
• Das MwSt-Regime, der Standardsatz, die SIRET, die MwSt-Nummer und die Adresse der herausgebenden Organisation sind angegeben.
• Ein Händler hat seine Stripe-Registrierung in der Produktion abgeschlossen und eine Zahlung durchgängig erhalten.
• Der Echtmodus wird erst nach allen diesen Punkten geöffnet.

Wissenswertes

Die MwSt der Provisions- und Versandrechnungen hängt vom Regime der herausgebenden Organisation ab, also derjenigen, die die Variable PLATFORM_ORGANIZATION_ID bezeichnet: Ohne MwSt-Regime und ohne Nummer können ihre Rechnungsentwürfe nicht ausgestellt werden. SheepOS gibt keine Rechts- oder Steuerberatung: Lassen Sie diese Einstellungen von Ihrem Steuerberater bestätigen.