Magento integreren
Vanaf juni 2020 zal Magento 1.9 het einde van zijn levensduur bereiken en zullen we onze Magento 1.9-plugin niet langer updaten. De plugin blijft open source en beschikbaar voor klanten die nog niet zijn gemigreerd naar Magento 2 of een nieuw platform.
Deze integratie maakt het mogelijk om alle bestaande Magento-klanten in Belco te importeren en relevante klantinformatie van Magento te laden op de klantdetailpagina.
API Toegang
Voordat je begint, controleer of de REST API toegankelijk is. De eenvoudigste manier om dat te doen, is door een API-eindpunt te openen in je browser, bijvoorbeeld https://jouwdomein.com/api/rest/customers. De pagina zou XML moeten retourneren met een bericht 'Toegang geweigerd'.
Als je een standaard 404-pagina krijgt, zorg er dan voor dat de herschrijfregels voor de REST API zijn ingeschakeld.
Als je een firewall gebruikt, voeg dan de volgende IP-bereiken toe aan de whitelist.
185.60.151.0/26
5.104.96.0/21
46.231.144.0/21
109.232.232.0/21
185.21.192.0/22
171.33.64.0/18
148.253.64.0/18
Installeer de Magento-extensie
Om deze integratie in te schakelen, moet je eerst onze Magento-extensie installeren. Als je de extensie al hebt geïnstalleerd, kun je doorgaan naar stap 2.
De plugin kan je via deze link verkrijgen:
Maak een nieuwe Consumer aan
Ten eerste moet je een Consumer aanmaken in het Beheerderspaneel. Het maken van een nieuwe gebruiker betekent het registreren van de applicatie. Volg hiervoor de onderstaande stappen:
Ga naar het Magento Beheerderspaneel menu en selecteer Systeem > Webdiensten > REST - OAuth Gebruikers.
Op de pagina OAuth Gebruikers, klik op Nieuwe toevoegen in de rechterbovenhoek om een nieuwe gebruiker toe te voegen. De pagina Nieuwe gebruiker wordt geopend. De velden Sleutel en Geheim worden automatisch ingevuld en kunnen niet worden bewerkt.
Deze waarden worden automatisch gegenereerd en worden gebruikt om de Gebruiker te identificeren in Magento.
Vul een naam in, bijvoorbeeld Belco. Kopieer vervolgens de Key en de Secret in een kladblokje.
Klik als laatste op opslaan.
Configureer de REST gebruikers rollen
Vervolgens moeten de juiste rollen worden geconfigureerd om Belco toegang te geven tot de REST API.
Ga naar het Magento Beheerderspaneel menu en selecteer Systeem > Webdiensten > REST - Rollen.
Op de pagina REST-rollen, klik op Adminrol toevoegen. Voer een rol naam in, bijvoorbeeld Belco. Voer je beheerderswachtwoord in. Configureer de Rol API-resources, selecteer Ophalen voor Bestellingen, Bestelitems, Besteladressen, Bestelopmerkingen, Klant en Klantadres.
Klik op opslaan om de wijzingen door te voeren.
Configureer de REST atributen
Op het Magento Beheerderspaneel menu, selecteer Systeem > Webdiensten > REST - Attributen. Klik op Admin. Stel Toegang tot Bron in op alles. Klik op Opslaan om de wijzigingen op te slaan.
Configureer de gebruikers toegang
De volgende stap is om de nieuw gemaakte rol toe te wijzen aan een gebruiker.
🚧 Maak altijd een nieuwe gebruiker aan zonder beheerdersrechten voor extra beveiliging.
Op het Magento Beheerderspaneel menu, selecteer Systeem > Machtigingen > Gebruikers. Maak een nieuwe gebruiker specifiek aan om toegang te krijgen tot de API. Open het tabblad REST Rol. Selecteer de Belco rol die je zojuist hebt aangemaakt. Klik als laatste op gebruiker opslaan om de rol toe te wijzen.
Configureer de Belco integratie
Nu alles binnen Magento klaar staat, kunnen we de integratie in Belco configureren.
Binnen Belco, klik links op het tandwiel. Ga naar Integraties. Kies de juiste shop bovenin de gele balk.
Onder e-commerce platformen kies je voor Magento.
Voer de hoofd-URL van je winkel in, bijvoorbeeld https://mijnwinkel.com/index.php (zorg ervoor dat je /index.php toevoegt na de URL). Als je een aangepast beheerderspad gebruikt, vervang 'admin' door het pad dat je gebruikt.
Plak de zojuist gekopieerde Sleutel en Geheim in de overeenkomstige velden.
Klik op Verbinden. Er wordt een pop-up geopend die je doorverwijst naar je Magento-winkel. Log in op de pop-up met de gebruiker voor wie je de Belco REST-rol hebt toegewezen.
Klik als laatste op Authoriseer en de koppeling is gemaakt!
Importeer bestaande gebruikers
Nadat je succesvol verbinding hebt gemaakt met Magento, kun je je bestaande klanten importeren in Belco. Nieuwe klanten worden automatisch toegevoegd.
Klik op 'Bestaande klanten importeren' om de import te starten. Het importeren kan even duren, afhankelijk van het aantal klanten in je database. Je hoeft het scherm niet open te laten staan.
