Dit document beschrijft de handelingen die benodigd zijn om de koppeling tussen AFAS Profit Online en Magento 2 tot stand te brengen. Dit betreft handelingen in:

Om de koppeling succesvol te laten werken, dient in AFAS Profit Online een aantal handelingen te worden verricht:

Wil je ondersteuning bij het installeren van deze koppeling dan kun je contact opnemen met onze partner Gladior.

Importeren velden

Hieronder volgt het stappenplan voor het importeren van de Combidesk velden in je AFAS Profit Online omgeving:

<TODO>

Importeren van de GetConnectoren

Hieronder volgt het stappenplan voor het importeren van de Combidesk velden in je AFAS Profit Online omgeving:

1. Pak het ZIP bestand met Combidesk velden en GetConnectoren uit in een directory.

2. Ga in AFAS naar het menu item GetConnectors (zie screenshot onder)
​
​

3. Klik in het scherm “GetConnector beheren” op de knop “Importeren”. Onderstaande popup verschijnt dan.

4. Klik vervolgens op Map en selecteer de map waarin je de connectors uitgepakt hebt.

5. Voltooi vervolgens de wizard door op “Voltooien” te klikken.

Gebruiker

Indien er geen connector gebruiker aanwezig is dient er een nieuwe gebruiker aangemaakt te worden. Ga hiervoor naar ‘autorisatie tool’ en kies vervolgens bij ‘gebruiker’ voor ‘nieuwe systeemgebruiker’ aanmaken. Geef vervolgens bij ‘gebruiker’ het ID van het account op vervolgt door een ‘.magento’. Stel dat het ID ‘082610’ is, geef dan als gebruikersnaam ‘082610.magento’ op. Geef vervolgens een omschrijving op, bijvoorbeeld ‘magento AFAS koppeling’, gevolgd door een e-mailadres en een wachtwoord. Kies vervolgens voor ‘voltooien’.

Gebruiker aan groep koppelen

Je kunt vervolgens de gebruiker aan een groep koppelen. Dit doe je door in het tabblad ‘autorisatie tool’, te gaan naar het subtabblad ‘lid van groep’. Zet hier vervolgens het vinkje bij ‘alleen geselecteerde items’ uit en voeg de gebruiker toe aan de groep ‘APL (applicatiebeheer, alle rechten). Vervolgens kies je voor het opnieuw openen van de omgeving.

AppConnector

Ga naar het menu item Algemeen -> App Connector (zie screenshot onder)

Klik vervolgens linksboven op “Nieuw”. Hiermee wordt de wizard nieuwe App Connector geopend. In het eerste scherm kun je de naam invoeren en de gebruikersgroep selecteren (zie screenshot onder). Klik vervolgens op de knop “Voltooien”.

Vervolgens moeten de gebruikte GetConnectors en UpdateConnectors aan de AppConnector worden toegevoegd (zie screenshot onder).

Voeg de volgende connectors toe aan de AppConnector:

Vervolgens moet de zojuist gemaakte AppConnector gedeblokkeerd worden. Dit kan door in het tabblad Algemeen de checkbox Geblokkeerd uit te vinken (zie screenshot onder).

Hierna kan er een gebruikerstoken worden aangemaakt. Dit kan door op het tabblad Gebruikerstokens op de knop Nieuw te klikken. Vervolgens verschijnt het scherm hieronder, waarin de gebruiker geselecteerd kan worden en er een omschrijving kan worden ingevoerd.

BELANGRIJK! De gebruiker die je selecteert, dient voldoende rechten te hebben om de alle geconfigureerde connectoren (en de daar achter liggende functionaliteit) aan te roepen.

Vervolgens verschijnt het gegenereerde gebruikerstoken (zie screenshot onder).

BELANGRIJK! Kopieer het gegenereerde gebruikerstoken en bewaar dit goed! Deze wordt eenmalig getoond door AFAS en is nodig tijdens de installatie van de koppeling.

Controleren artikelen

Voor de correcte werking van de koppeling, dient er een aantal artikelen te bestaan in AFAS Profit Online. De artikel codes van deze artikelen zijn nodig tijdens de installatie van de connector. Het betreft de volgende artikelen:

Webshop artikelen configureren

Artikelen die in de webshop beschikbaar zijn, moeten in AFAS Profit Online gemarkeerd worden als “E-commerce beschikbaar” op het table E-commerce dat is toegevoegd bij artikelen.

Om de koppeling succesvol te laten werken, dient in Magento 2 een aantal handelingen te worden verricht:

Attributenset

Gebruik de default attributenset genaamd “Attribuut Set Combidesk” in Magento. Maak de nieuwe attributen aan (let op: Deze attributen moeten de scope ‘Global’ krijgen):

Voeg deze attributen toe aan de attribuut set in een nieuwe groep genaamd Afas Connector.

a. Alternatief: Voeg de attributen toe aan een bestaande attributen set.

Meerdere storeviews

Indien er gebruik gemaakt gaat worden van meerdere storeviews, moeten de attributen voor de afbeeldingsrollen een bredere scope krijgen. Dit betekent dat voor de attributen “image”, “small_image”, “swatch_image” en “thumbnail” de scope van “Store view” naar “Global” moet worden gewijzigd.

Configureren van de integratie

1. Log in de Magento admin omgeving

2. Navigeer naar System -> Integrations

3. Klik op de rode knop “Add new Integration”

4. Voer de volgende informatie in op de tab “General”:

a. Name: Magento 2 - AFAS integratie

b. Callback Url: https://combo-backend.combidesk.com/magento2/activateintegration/magento2-afas

c. Identity link URL: https://combidesk.com/oauthmagento2request/magento2-afas

5. En op tab “API”:

a. Resource Access: All

6. Klik tenslotte op de rode knop “Save” rechtsboven. Hierbij moet vervolgens op de tab “General” het admin wachtwoord nog worden ingevoerd.

Activeren

Vanuit Magento 2 kom je in de App installer terecht als je de Integration gaat activeren. Zie screenshot hieronder.

Na het beantwoorden van onderstaande configuratie vragen klik je op “Volgende”.

Hierna verschijnt er een scherm met de knop “Verbind je AFAS account”.

Er verschijnt een popup waarin je je AFAS account kunt verbinden. In deze popup dien je de volgende informatie in te voeren:

Klik vervolgens op “Test en sla op” en we controleren of de verbinding werkt en slaan de configuratie op.

Vervolgens verschijnt het restant van de configuratie vragen.

Na het beantwoorden van alle configuratie vragen verschijnt de rode knop “Installeer koppeling”. Voltooi de installatie door op deze knop te klikken.

Wil je ondersteuning bij het installeren van deze koppeling dan kun je contact opnemen met onze partner Gladior.