Kowal B2B API — vollständige REST-Dokumentation

Vertragsversion: V1 · Quelle der Wahrheit: Kowal_B2BApi/etc/webapi.xml · Zielgruppe: Shop-Administratoren, Implementierungspartner und Teams, die ERP, PIM, WMS oder ein Beschaffungssystem integrieren.

1. Zweck und Grenzen der API

Die Kowal B2B API stellt B2B-Daten und -Prozesse bereit, die in Magento 2 laufen: Firmen, Katalog und individuelle Preise, Schnellkäufe, Dokumente, Kreditlimit, Genehmigungen, RFQ sowie Integrationswarteschlangen. Es handelt sich um eine REST API für Systemintegrationen; sie ersetzt nicht die Standard-Endpunkte von Magento für Katalog, Warenkorb, Checkout und Kundenkonto.

Das Dokument beschreibt ausschließlich die aktuell bereitgestellten Endpoints des Moduls. Es enthält keine Zusage für Operationen, die der Vertrag V1 nicht bereitstellt, z. B. Erstellung einer Bestellung per REST, CRUD von Preislisten oder Bearbeitung der Website-Konfiguration.

2. Zugriff erhalten und Regeln der Zusammenarbeit

2.1. Prozess zur Inbetriebnahme der Integration

1. Der Integrator übermittelt dem Shop-Administrator Ziel der Integration, Umgebung (Test/Produktion), Quellsystem, Datenumfang sowie die Liste der erforderlichen API-Bereiche.
2. Der Administrator erstellt oder konfiguriert die Magento-Integration, weist ihr minimale ACL-Berechtigungen zu und übermittelt über einen sicheren Kanal: baseUrl, Token, websiteId, companyId (falls zutreffend), Währung und Testdaten.
3. Der Integrator führt den Test GET /V1/kowal-b2b/websites/:websiteId/config und anschließend Funktionstests in der Testumgebung aus.
4. Vor der Produktion vereinbaren beide Seiten den Synchronisationsplan, die maximale Datengröße, Retry, den Dateneigentümer und die Art der Fehlermeldung.
5. Tokens werden ausschließlich in einem Secrets Vault gespeichert; der Administrator rotiert oder entzieht sie bei Wechsel des Anbieters, Benutzers oder Integrationsumfangs.

2.2. Verantwortlichkeiten

Ein Administrator-Token sollte nicht in einer Client-Anwendung verwendet und ein einzelnes Token nicht von unabhängigen Systemen gemeinsam genutzt werden. Jede Integration sollte ein eigenes Token und ausschließlich die erforderlichen ACL haben.

2.3. Berechtigungen

Magento prüft das Bearer-Token sowie die ACL, die dem administrativen Benutzer oder der Integration zugewiesen sind. B2B-Endpoints erfordern eine der folgenden Berechtigungsgruppen:

Der Umfang sollte sich aus dem Zweck der Integration ergeben. Beispiel: Ein Beschaffungssystem benötigt in der Regel products, prices, catalog_permissions, quick_order und quotes; ein ERP, das Dokumente verarbeitet — documents sowie, wenn es Eigentümer der Synchronisierung ist, system_integrations.

3. Technische Konventionen

Adresse, Header und Parameter

Die Basisadresse hat die Form https://b2b.example.com/rest/V1. Alle weiteren Pfade im Dokument werden ab /V1 angegeben; die vollständige Endpoint-Adresse ist BASE_URL + Pfad.

Authorization: Bearer Accept: application/jsonContent-Type: application/json

Die API verwendet JSON. Namen in der URL sind camelCase (websiteId, companyId), und JSON-Felder entsprechen den Parameternamen der Magento-Verträge. :companyId, :quoteId, :sku usw. sind Pfadparameter. In Beispielen bedeutet ? einen optionalen Parameter.

websiteId ist bei Operationen erforderlich, die vom Vertriebskanal abhängig sind. Es muss auf eine bestehende Website mit aktiviertem B2B verweisen. companyId verweist auf eine Firma, die eine aktive Beziehung zu dieser Website haben muss, wenn die Operation in ihrem Kontext ausgeführt wird. Die API wählt weder eine Standard-Website noch eine Standardfirma aus.

Request Body und Idempotenz

Magento serialisiert das DTO-Objekt unter dem Namen des Methodenparameters: Die meisten Schreibvorgänge akzeptieren {'request': {...}}; die Erstellung einer Firma verwendet {'company': {...}}; Firmen-Batch — {'companies': [...]}. Endpoints mit einfachen Argumenten akzeptieren Felder ohne Wrapper, z. B. {'websiteId': 1, 'currency': 'PLN', 'items': [...]}.

Der Header Idempotency-Key (max. 128 Zeichen) wird derzeit von POST /companies unterstützt: Ein Retry mit demselben Schlüssel gibt die zuvor erstellte Firma zurück. Für einen Integrationsjob verwenden Sie das Feld request.idempotencyKey. Gehen Sie nicht von automatischer Idempotenz anderer Schreib-Endpoints aus; wiederholen Sie sie erst, nachdem der Status der Operation geklärt wurde.

Antworten und Fehler

Erfolgreiche Antworten sind Objekte oder Tabellen von Magento-Verträgen. Von Objekten zurückgegebene Felder können kompatibel erweitert werden; die Integration sollte unbekannte Felder ignorieren. Ein Geschäftsfehler kann enthalten:

{ 'code': 'b2b.company.not_assigned_to_website', 'message': 'B2B company is not assigned to website.', 'website_id': 1, 'trace_id': 'request-correlation-id', 'details': {'company_id': 10}, 'field_errors': []}

Loggen Sie keine Tokens, vollständigen personenbezogenen Daten oder Konfigurationsgeheimnisse. Eine Meldung an das Shop-Team sollte Zeit, Methode, Pfad ohne Secrets, HTTP-Status, trace_id sowie anonymisierten Payload enthalten.

4. Schemas der Eingabedaten

Die folgenden Schemas gelten gemeinsam für die Referenz-Endpoints. Ein Feld ohne ? ist durch den Vertrag erforderlich; ? bedeutet einen optionalen Wert. Die Felder metadata, config, configuration und payload sind JSON-Objekte.

5. Endpoint-Referenz

In den Tabellen bezeichnet ACL die minimale Magento-Berechtigungsressource. Ergebnis bestimmt die Art der erfolgreichen Antwort.

5.1. Websites und Konfiguration

5.2. Firmen und Firmenbenutzer

5.3. Produkte, Preis und Katalogsichtbarkeit

5.4. Dateiimport und -export

5.5. Schnellbestellung und Einkaufslisten

5.6. Dokumente und Dateien

5.7. Kreditlimit und Zahlungsbedingungen

5.8. Genehmigungsworkflow

5.9. B2B-Kontext von Bestellungen

5.10. RFQ und kommerzielle Angebote

5.11. Integrationsprofile und -jobs

6. Aufrufbeispiele

export BASE_URL='https://b2b.example.com/rest/V1'export TOKEN='token-przekazany-przez-administratora'export WEBSITE_ID=1 COMPANY_ID=10 SKU='B2B-SKU-001' CURRENCY='PLN'# Test dostępu i konfiguracji kanałucurl -sS '$BASE_URL/kowal-b2b/websites/$WEBSITE_ID/config' \ -H 'Authorization: Bearer $TOKEN' -H 'Accept: application/json'# Cena kontraktowa firmy dla konkretnej ilościcurl -sS '$BASE_URL/kowal-b2b/companies/$COMPANY_ID/products/$SKU/price?websiteId=$WEBSITE_ID&currency=$CURRENCY&qty=5' \ -H 'Authorization: Bearer $TOKEN' -H 'Accept: application/json'# Walidacja koszyka po SKUcurl -sS -X POST '$BASE_URL/kowal-b2b/companies/$COMPANY_ID/quick-order/validate' \ -H 'Authorization: Bearer $TOKEN' -H 'Content-Type: application/json' \ --data '{'websiteId':1,'currency':'PLN','items':[{'sku':'B2B-SKU-001','qty':5}]}'# Utworzenie RFQcurl -sS -X POST '$BASE_URL/kowal-b2b/quotes' \ -H 'Authorization: Bearer $TOKEN' -H 'Content-Type: application/json' \ --data '{'request':{'websiteId':1,'companyId':10,'customerId':25,'title':'Dostawa kwartalna','currency':'PLN','externalId':'ERP-RFQ-2026-001'}}'

7. Empfohlene Integrationsszenarien

Kauf nach SKU

1. Lesen Sie die Website-Konfiguration aus und speichern Sie die übermittelte websiteId, companyId und Währung.
2. Verwenden Sie quick order zur Sammelvalidierung von SKU, Menge, Sichtbarkeit und Verfügbarkeit.
3. Rufen Sie für akzeptierte Positionen den Preis aus price mit dem richtigen qty ab.
4. Erstellen Sie ein RFQ, fügen Sie Positionen hinzu und senden Sie sie über submit, wenn der Kauf ein Angebot erfordert.
5. Verfolgen Sie Status und Historie des RFQ; gehen Sie nach der Annahme gemäß dem vereinbarten Magento-Bestellprozess vor, da V1 keinen Endpoint zur Erstellung einer order bereitstellt.

Dokumente und Abrechnung

1. Rufen Sie die Dokumentenliste der Firma ab, optional gefiltert nach documentType.
2. Rufen Sie für das ausgewählte Dokument Metadaten und Dateiliste ab; der Dateipfad ist nicht automatisch eine öffentliche URL — die Art des Abrufs der Binärdatei stimmen Sie mit dem Shop-Administrator ab.
3. Lesen Sie den Limitstatus vor dem Kaufprozess aus; nur eine Integration mit ACL credit_limits kann ihn verwalten.

Asynchrone Operationen

1. Speichern Sie das Integrationsprofil und die ID-Zuordnungen.
2. Veröffentlichen Sie einen Job mit einem geschäftlichen idempotencyKey und bewahren Sie die jobId auf.
3. Lesen Sie Job sowie Logs/Fehler aus; retry rufen Sie erst nach Analyse des Fehlers und Beseitigung seiner Ursache auf.

8. Abnahmeliste vor der Produktion

• Das Token hat ausschließlich die erforderlichen ACL und ist kein Administrator-Token, das von der UI verwendet wird.
• Der Integrator behandelt 401, 403, 404, Validierung 422, Konflikt 409 und Timeouts korrekt.
• Jeder Request im B2B-Kontext übermittelt die richtige websiteId, und Firmendaten verwenden die korrekte companyId.
• Preise, Sichtbarkeit und Verfügbarkeit werden vor Erstellung des Kaufprozesses geprüft.
• Die Erstellung einer Firma verwendet Idempotency-Key; Integrationsjobs haben einen stabilen idempotencyKey im Body.
• Logs enthalten keine Tokens oder sensiblen Daten, und das Supportverfahren übermittelt trace_id.
• Tests wurden in der Testumgebung mit einer Firma durchgeführt, die eine aktive Beziehung zur B2B-Website hat.

9. Kompatibilität

Der Vertrag ist über /V1 versioniert. Die Erweiterung der Antwort um neue Felder ist kompatibel; der Integrator sollte unbekannte Felder tolerieren. Eine Änderung, die ein Feld, die Bedeutung eines Feldes oder einen Endpoint entfernt, erfordert eine neue API-Version. Bei Abweichungen zwischen Dokument und laufender Installation ist der aktive Vertrag webapi.xml der jeweiligen Modulversion maßgeblich.

Installation und Konfiguration der Kowal B2B Suite

Dieses Handbuch richtet sich an Personen, die die Kowal B2B Suite gekauft haben und sie in einer bestehenden Magento Open Source Installation in Betrieb nehmen sollen. Es führt durch zwei Schritte:

1. technische Installation— durchgeführt durch einen Developer oder Serveradministrator;
2. geschäftliche Konfiguration— durchgeführt im Magento-Panel durch den Shop-Administrator.

Erstellen Sie vor Beginn ein Backup der Magento-Datenbank und -Dateien. Wir empfehlen, die erste Inbetriebnahme in einer Testumgebung durchzuführen und erst danach in die Produktion zu übernehmen.

1. Lieferumfang und Voraussetzungen

Die Kowal B2B Suite wird als Composer-Paketkowal/metapackage-b2b-suitebereitgestellt. Sie enthält B2B-Module sowie das Themefrontend/Kowal/b2bverwenden.

Anforderungen

Von Kowal erhalten Sie:

• die Adresse des privaten Composer-Repositorys — im FolgendenREPOSITORY_URL;
• den Benutzernamen oder die Zugriffskennung —USERNAME;
• das Zugriffstoken —ACCESS_TOKEN;
• den zulässigen Versionsbereich des Pakets.

Speichern Sie das Token nicht im Git-Repository, in Tickets oder in der Shell-Historie, die mit anderen Personen geteilt wird.

2. Technische Installation

Führen Sie alle Befehle im Stammverzeichnis der bestehenden Magento-Installation aus, als Benutzer mit Zugriff auf die Dateien und auf den Befehlbin/magentoverwenden.

2.1. Vorbereitung

1. Stellen Sie sicher, dass Magento vor der Änderung korrekt funktioniert.
2. Dokumentieren Sie den Deployment-Stand und erstellen Sie ein Backup der Datenbank sowie der Verzeichnisseapp/etc,pub/mediaundvarverwenden.
3. Aktivieren Sie in der Produktion für die Dauer der Aktualisierung den Maintenance-Modus:

bin/magento maintenance:enable

2.2. Privates Repository ergänzen

Fügen Sie das Composer-Repository von Kowal hinzu und konfigurieren Sie die erhaltenen Zugangsdaten.

Die Zugangsdaten für das Composer-Repository – E-Mail-Adresse des Kunden und Lizenz-Token – erhalten Sie nach dem Kauf per E-Mail. Sie sind nach der Anmeldung auf kowal.storeebenfalls im Kundenkonto verfügbar. Ersetzen Sie TWOJ_EMAIL_KLIENTA durch die E-Mail-Adresse Ihres Kontos und TWOJ_TOKEN durch das erhaltene Token. Führen Sie die Befehle im Magento-Stammverzeichnis aus.

composer config repositories.kowal composer https://repo.kowal.store
composer config http-basic.repo.kowal.store "TWOJ_EMAIL_KLIENTA" "TWOJ_TOKEN"

Composer speichert Zugangsdaten in der Regel in einer lokalenauth.json; fügen Sie diese Datei nicht zu Git hinzu.

2.3. Paket installieren

Installieren Sie die Version, die mit der Lizenz übermittelt wurde. Für die aktuelle Paketlinie sieht ein Beispielbefehl wie folgt aus:

composer require kowal/metapackage-b2b-suite:^0.2 --with-all-dependencies

Führen Sie nach dem Herunterladen der Abhängigkeiten die Aktualisierung des Magento-Schemas und der Konfiguration aus:

bin/magento setup:upgrade
bin/magento cache:clean

Im Produktionsmodus führen Sie zusätzlich aus:

bin/magento setup:di:compile
bin/magento setup:static-content:deploy -f pl_PL en_US
bin/magento cache:flush

Verwenden Sie nur die Locales, die im Shop aktiv sind. Wenn die Installation einen anderen Deployment-Prozess verwendet, nehmen Sie die oben genannten Befehle in dessen Standardverfahren auf.

2.4. Installation prüfen

bin/magento module:status | grep Kowal
bin/magento indexer:status

Im Administrationspanel sollten das MenüB2Bsowie der TabStores > Configuration > Kowal > B2Berscheinen. Wenn sie fehlen, prüfen Sie das Ergebnis vonsetup:upgrade, den Cache sowie die ACL-Rollen des Administratorbenutzers.

2.5. PDF-Dateiberechtigungen

Die von B2B generierten PDFs verwenden mPDF und Verzeichnisse untervar/, daruntervar/tmp/kowal_b2b_mpdfsowievar/kowal_b2b_documents. Der PHP-Prozess muss diese erstellen und beschreiben können. Fehlende Berechtigungen äußern sich durch einen Fehler bei der Dokument- oder PDF-Erzeugung.

Deaktivieren Sie nach Abschluss des Produktionsdeployments den Maintenance-Modus:

bin/magento maintenance:disable

3. B2B-Shopstruktur konfigurieren

3.1. Website und Store View

Die Suite arbeitet im Scopewebsiteund nicht global. Sie können B2C und B2B in derselben Magento-Installation betreiben, B2B sollte jedoch in einer separaten Website oder in einer bewusst ausgewählten Website für den Firmenvertrieb laufen.

1. Definieren Sie unterStores > Settings > All Storesdie B2B-Website, ihren Store und die Store View aus.
2. Merken Sie sich diewebsite_id— sie wird von Firmen, Preisen, Dokumenten, API und Integrationen verwendet.
3. Definieren Sie unterContent > Design > Configurationdas Themefrontend/Kowal/b2bnur der B2B Store View zu.
4. Prüfen Sie, ob aktive Währungen, Steuern, Versandmethoden und Zahlungsmethoden für denselben Scope konfiguriert sind.

Weisen Sie das B2B-Theme keiner B2C Store View zu, wenn Sie deren Darstellungsebene nicht ändern möchten. Die reine Installation der Module aktiviert die B2B-Logik nicht für alle Websites.

3.2. B2B aktivieren

1. Öffnen SieStores > Configuration > Kowal > B2Bverwenden.
2. Wählen Sie im Scope-Umschalter die richtigeWebsiteverwenden.
3. Setzen Sie im AbschnittGeneraldie OptionEnable B2BaufYesverwenden.
4. Für die Dauer des Deployments können SieDebug Modeaktivieren; deaktivieren Sie ihn nach den Tests.
5. Legen Sie im Scope Default Config den Aufbewahrungszeitraum für Logs fest.
6. Speichern Sie die Konfiguration und leeren Sie den Cache.

Nach der Aktivierung werden alle Store Views, die zu dieser Website gehören, als B2B behandelt. Eine Firma ohne aktive Beziehung zu dieser Website erhält keinen Zugriff darauf.

3.3. Verkäuferdaten

Ergänzen Sie die Daten des verkaufenden Unternehmens unterStores > Configuration > General > Store Information: Name, Adresse, Telefon und Umsatzsteuer-ID. Sie werden in Dokumenten und RFQ-PDFs verwendet. Ergänzen Sie außerdem die allgemeine E-Mail-Adresse des Absenders in der Sales Emails-Konfiguration sowie das E-Mail-Logo, wenn es im PDF erscheinen soll.

4. Ersten B2B-Kunden konfigurieren

Verwenden Sie die folgende Reihenfolge für jede Firma. So vermeiden Sie Situationen, in denen der Kunde zwar ein Konto hat, aber das Angebot nicht sieht oder den Checkout nicht durchlaufen kann.

4.1. Unternehmen, Personen und Adressen

1. Öffnen SieB2B > Companiesund erstellen Sie eine Firma.
2. Geben Sie Name, Umsatzsteuer-ID, externe Kennung (falls die Firma mit ERP synchronisiert wird), den StatusActivesowie die Zuordnung zur B2B-Website an.
3. Fügen Sie einen Firmenbenutzer hinzu oder weisen Sie einen bestehenden Magento-Kunden zu. Weisen Sie ihm die passende Rolle zu und aktivieren Sie die Zuordnung.
4. Definieren Sie unterB2B > Company Addressesdie Firmenadressen hinzu; markieren Sie die Standard-Rechnungs- und Versandadresse für die B2B-Website.
5. Definieren Sie unterB2B > Company Contactseinen aktiven Hauptkontakt mit E-Mail und Telefon hinzu.

Die Rechnungsadresse und der Hauptkontakt werden ebenfalls in RFQ-PDFs verwendet. Fehlende Daten blockieren das PDF nicht, das Dokument ist jedoch weniger vollständig.

4.2. Unternehmensrollen

Vergeben Sie Benutzern nur die benötigten Berechtigungen. Eine typische Aufteilung ist:

Testen Sie ein Konto jedes Typs, insbesondere die Berechtigung zum Aufgeben und Genehmigen von Bestellungen. Verwenden Sie nicht ein gemeinsames Konto für die gesamte Firma.

5. Angebot, Preise und Checkout

5.1. Katalog und Preise

1. Stellen Sie sicher, dass die Magento-Produkte der B2B-Website zugewiesen, aktiv und mit korrekten MSI-Daten versehen sind.
2. Konfigurieren Sie Preislisten oder Vertragspreise für die Firma im BereichB2B > Pricing(Price Lists, Price List Assignments oder Contract Prices).
3. Konfigurieren Sie die Regeln für die Katalogsichtbarkeit der Firma gemäß dem implementierten Berechtigungsmodell und prüfen Sie anschließend die Sichtbarkeit im Kundenkonto.
4. Testen Sie im Firmenkonto: Suche nach SKU, Produktsichtbarkeit und Preis für die Menge1sowie für eine Mengenstaffel.

Der B2B-Preis hängt von Firma, Website, Währung und Menge ab. Ein in B2C sichtbares Produkt muss für einen B2B-Kunden nicht verfügbar sein.

5.2. Versand und Zahlung

1. Aktivieren Sie die erforderlichen Versand- und Zahlungsmethoden in der Standardkonfiguration von Magento für die B2B Store View.
2. Definieren Sie unterB2B > CheckoutRegeln für verfügbare Methoden für Firma/Website hinzu, wenn Sie die Auswahl einschränken möchten.
3. Führen Sie einen Warenkorbtest mit den Standardadressen der Firma durch.

Wenn die Erstellung einer Bestellung aus RFQ automatisch auf Administratorseite funktionieren soll, muss die Firma eindeutige Standardadressen sowie eine aktive Zahlungs- und Versandmethode haben. Andernfalls lädt die Suite die Daten in das native Backend Order Create, wo der Administrator fehlende Elemente ergänzt.

5.3. Limits und Freigaben

Diese Funktionen sind optional, sollten jedoch konfiguriert werden, bevor sie für Kunden aktiviert werden.

1. Definieren Sie unterB2B > Credit > Payment TermsZahlungsbedingungen hinzu.
2. Definieren Sie unterB2B > Credit > Credit LimitsLimit, Währung, Status und Zahlungsbedingung zu.
3. Definieren Sie unterB2B > Approvals > Ruleseine Betragsgrenzenregel für Firma und Website.
4. Definieren Sie unterB2B > Approvals > ApproversGenehmiger zu.
5. Testen Sie den Warenkorb unterhalb und oberhalb der Grenze und prüfen Sie, ob die Entscheidung des Genehmigers den weiteren Prozess ändert.

6. Dokumente, PDF und RFQ

6.1. Magento-Dokumente

Definieren Sie unterStores > Configuration > Kowal > B2B > Documentsdie Dokumentenquelle und entscheiden Sie, welche Dokumente automatisch generiert werden sollen: Auftragsbestätigungen, Rechnungen, Lieferscheine und Gutschriften. Legen Sie außerdem den Zielstatus des Dokuments fest.

Definieren Sie unterB2B > Documents > PDF Templatesfest:

1. prüfen Sie die aktive Vorlage für jeden Typ und jede Website;
2. führen Sie eine Vorschau aus;
3. passen Sie HTML/CSS nur dann an, wenn Sie eine Person haben, die Magento-Templates und mPDF-CSS kennt;
4. generieren Sie eine Testrechnung oder Bestätigung und prüfen Sie den Download aus dem Firmenkonto.

6.2. RFQ und PDF-Angebot

1. Definieren Sie unterB2B > Quotes > RFQein Test-RFQ für eine aktive Firma und einen aktiven Benutzer.
2. Fügen Sie eine für die Firma sichtbare SKU, Menge und Angebotspreis hinzu.
3. Legen Sie die Gültigkeitsfrist fest, senden Sie das Angebot an den Kunden und generieren Sie das PDF.
4. Prüfen Sie die Kundenvariante: Verkäufer-/Käuferdaten, Positionen, Preis, Summe und Gültigkeitsfrist.
5. Prüfen Sie die Administratorvariante: zusätzlich Vertriebsnotizen, Kommentare, Historie und interne Informationen zu den Positionen.

Das Kunden-PDF darf keine Notizen des Vertriebsmitarbeiters oder interne Statushistorie enthalten.

7. Schnellbestellungen, Importe und Integrationen

Schnellbestellungen

Definieren Sie unterB2B > Quick Order > Debug SKUdie ListeSKU,qtyfür Firma, Website und Währung. Erstellen Sie anschließend eine Einkaufsliste und testen Sie deren Verwendung durch den Kunden im Storefront.

Import und Export

Definieren Sie unterB2B > Import/Exportein Profil erst, nachdem die Datenquelle festgelegt wurde. Die Profilkonfiguration ist ein JSON-Objekt und muss Dateipfade enthalten, die auf dem Magento-Server verfügbar sind. Starten Sie den Import zunächst im Testmodus und analysieren Sie Job und Logs.

API-Integrationen

Legen Sie vor dem Erstellen eines Integrationstokens den Datenumfang und den Verantwortlichen für die Synchronisierung fest. Verwenden Sie für jedes ERP, PIM, WMS oder jede Middleware eine separate Magento-Integration und vergeben Sie ausschließlich die benötigten B2B-ACL. Die vollständige Liste der Endpoints, Tokens und Sicherheitsregeln finden Sie in derAPI-Dokumentation für Integratorenverwenden.

8. Abnahmecheckliste

Bestätigen Sie vor dem Produktionsstart:

• ☐ Die Kowal-Module sind aktiv, cron läuft, Cache und Indizes sind korrekt.
• ☐ B2B ist ausschließlich für die richtige Website aktiviert.
• ☐ Das B2B-Theme ist ausschließlich der B2B Store View zugewiesen.
• ☐ Die Testfirma hat den Status Active, einen Benutzer, eine Rolle, einen Kontakt und Standardadressen.
• ☐ Das Testprodukt ist aktiv, der Website zugewiesen, für die Firma sichtbar und hat einen korrekten B2B-Preis.
• ☐ Der Kunde kann sich anmelden, nach SKU suchen, quick order verwenden und das Produkt in den Warenkorb legen.
• ☐ Der Checkout zeigt nur zulässige Versand- und Zahlungsmethoden an.
• ☐ Limit und Genehmigungsregel funktionieren gemäß der Firmenrichtlinie, sofern diese Funktionen verwendet werden.
• ☐ Dokument und RFQ-PDF werden generiert und sind ausschließlich für die richtige Firma verfügbar.
• ☐ RFQ kann gesendet, akzeptiert und in den Prozess zur Auftragserstellung übergeben werden.
• ☐ Integrationen haben separate Tokens und eingeschränkte ACL, sofern sie verwendet werden.

9. Häufige Probleme

Geben Sie bei Supportanfragen Magento-Version, Paketversion, Reproduktionsschritte, Ereigniszeit, sicher anonymisierte Protokolle und gegebenenfallstrace_idan. Senden Sie keine Tokens oder Passwörter.

10. Paket aktualisieren

1. Lesen Sie die von Kowal übermittelten Versionsinformationen.
2. Führen Sie die Aktualisierung zuerst in der Testumgebung durch.
3. Erstellen Sie ein Backup, führen Siecomposer update kowal/metapackage-b2b-suite --with-all-dependencies,bin/magento setup:upgradeund in der Produktion zusätzlich die DI-Kompilierung und das Deployment statischer Inhalte aus.
4. Wiederholen Sie die Abnahme-Checkliste mit besonderem Fokus auf Preise, Checkout, Dokumente und Integrationen.

Aktualisieren Sie das Paket nicht durch manuelles Kopieren von Dateien nachapp/code; dies verursacht Probleme mit Composer und erschwert späteren Support.