Shopware 6.3 koppelen aan APIcenter

Je koppelt Shopware 6.3 aan APIcenter met een integratie die je in Shopware zelf aanmaakt. Shopware geeft je daarbij een toegangs-ID en een geheime sleutel. Die vul je in APIcenter in, samen met het webadres van je shop. Je doet dit één keer. Daarna gebruik je Shopware in al je integraties.

Wat je nodig hebt

• Een Shopware 6-webshop waarin je gebruikers en integraties mag beheren.
• Het webadres van je shop.

Stap 1: Maak een integratie in Shopware

1. Ga in de Shopware Administration naar Settings > System > Integrations.
2. Klik op Create integration.
3. Geef de integratie een naam, bijvoorbeeld APIcenter.
4. Kies of de integratie de rechten van een administrator krijgt, of kies een rol. Kies je een rol, geef die rol dan rechten voor de gegevens die je flows gebruiken. De flows lezen of schrijven orders, producten, klanten, klantgroepen, categorieën, afbeeldingen, eigenschappen, belastingen, valuta's en prijsregels.
5. Sla de integratie op. Shopware toont nu de toegangs-ID (Access key ID) en de geheime sleutel (Secret access key). Je ziet de geheime sleutel maar één keer. Bewaar hem direct op een veilige plek.

Bewerk je de integratie later, dan toont Shopware de geheime sleutel niet meer. Je kunt dan wel nieuwe sleutels laten maken. Shopware maakt dan zowel de toegangs-ID als de geheime sleutel opnieuw aan, dus je moet beide in APIcenter aanpassen.

Shopware legt dit zelf uit op Shopware 6 - Settings - Integrations. Hoe de Admin API de sleutels gebruikt, staat in de documentatie voor ontwikkelaars.

Stap 2: Koppel Shopware in APIcenter

1. Ga in APIcenter naar Applicaties en kies Nieuwe applicatie koppelen, of doe dit in stap 2 van de wizard, Verbind je apps. Kies Shopware 6.3.
2. Vul een Weergavenaam in, bijvoorbeeld de naam van je webshop.
3. Vul bij API url het adres van je shop in, zonder https:// en zonder slash aan het einde. Bijvoorbeeld mywebshop.com, of mywebshop.com/staging als je shop in een submap staat.
4. Vul de toegangsgegevens van de integratie in die APIcenter vraagt: de toegangs-ID en de geheime sleutel uit stap 1.
5. Klik op Opslaan en daarna op Testverbinding. Zie je "Verbinding is goed!", dan is Shopware klaar voor gebruik.

De algemene stappen staan in Een nieuwe applicatie koppelen en Een applicatie bewerken.

Als het niet lukt

• Controleer of het adres in API url klopt en geen https:// of slash aan het einde heeft.
• Controleer of je de toegangs-ID en de geheime sleutel van dezelfde integratie hebt gebruikt. Heb je de sleutels opnieuw laten maken, vul dan beide opnieuw in.
• Zie ook Verbinding of inloggen mislukt.

Volgende stappen

Maak een integratie met Shopware 6.3 en controleer de instellingen. Zie Shopware 6.3 verbindings- en integratie-instellingen.