Naar de hoofdinhoud
Alle collectiesHandleidingenMagento2
Installatiehandleiding Magento 2 AFAS Profit Online koppeling
Installatiehandleiding Magento 2 AFAS Profit Online koppeling

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

Meer dan een week geleden bijgewerkt

Versiebeheer

Versie

Omschrijving

1.0

Eerste versie installatiehandleiding

1.1

Nieuwe update

1.2

Staffelprijs connector toegevoegd (Combidesk_Profit_Pricelist_Item_Tier_Prices)

1.3

Profit_Composition connector toegevoegd

1.4

Toevoegingen m.b.t. attribuut rollen in Magento

Inleiding

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:

  1. AFAS Profit Online

  2. Magento 2

  3. De App installer

AFAS Profit Online

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

  1. Importeren van de Combidesk velden

  2. Importeren van de GetConnectoren

  3. Het maken van een AppConnector (inclusief het opslaan van het token)

  4. Zorgen dat de juiste artikelen bestaan

  5. Webshop artikelen configureren

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:

GetConnectoren

Profit_Warehouses

Profit_Journals

Profit_salesorderlines

Profit_Projects

Profit_Article

Profit_Composition

Combidesk_Profit_Debtor_Contacts

Combidesk_Profit_Debtor_Contacts_DeliveryAddresses

Combidesk_Profit_Article_Basic

Combidesk_Profit_Article_Image_Large

Combidesk_Profit_Article_Composition

Combidesk_VAT_Code_Group

Combidesk_Profit_Stock

Combidesk_Profit_Pricelists

Combidesk_Profit_Administrations

Combidesk_Profit_Countries

Combidesk_Profit_Discount_Groups

Combidesk_Profit_Discount_Group_Items

Combidesk_Profit_Pricelist_Item

Combidesk_Profit_Item_Prices * (Staat niet in de lijst)

Combidesk_Profit_Salesorders

Combidesk_Profit_PaymentMethods

Combidesk_Profit_DirectInvoices

Combidesk_Profit_DirectInvoiceLines

Combidesk_Profit_Pricelist_Item_Tier_Prices

UpdateConnectoren

FbSales

FbDirectInvoice

KnSalesRelationOrg

KnSalesRelationPer

KnPerson

KnOrganisation

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:

  • Een artikel voor de verzendkosten

  • Een artikel voor kortingen

  • Een artikel voor de overige kosten

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.

Magento 2

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

  1. Aanmaken van de attributen in een attributenset

  2. Configureren van de integratie,

  3. Activeren

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):

attribute1, attribute 2, attribute 3, ….., attribute 15

memo1, memo2, .., memo6

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

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

  1. Klik op de link “Activate” in het Integrations overzicht

  2. Dit opent de App Installer die in het volgende hoofdstuk wordt beschreven

  3. Klik op de rode knop “Allow” rechtsboven

App installer

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”.

  • Gebruikersaccounts aanmaken voor verkooprelaties in AFAS?
    a. Nee, doe maar niet
    b. Ja, alle wijzigingen vanaf nu
    c. Ja, alles graag

  • Voorraad synchroniseren naar je webshop?
    a. Ja
    b. Nee

  • Voorraden op magazijn niveau? (Gebruikt de default Combidesk_Profit_Stock GetConnector?)
    a. Ja
    b. Nee

  • Neem de productcatalogus over uit AFAS (alle producten synchroniseren)
    a. Nee, doe maar niet
    b. Ja, alle wijzigingen vanaf nu
    c. Ja, alles graag

  • Standaard prijslijst incl. of excl. BTW gebruiken?
    a. Standaard prijslijst excl. BTW
    b. Standaard prijslijst incl. BTW

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:

  1. De url van je AFAS Online account. We hebben een groot deel al voor je ingevoerd, dus je hoeft alleen maar het nummer van je url in te voeren.

  2. Het XML token dat je tijdens de configuratie van de AppConnector hebt gekopieerd (zie Configuratie AFAS Online stap AppConnector).

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.

  • Debiteuren verzamelrekening. Wat is de de debiteuren verzamelrekening in waar nieuwe debiteuren aan gekoppeld worden?

  • Verzendkosten artikel. Wat is het artikel waar verzendkosten op geboekt worden?

  • Verzendkosten artikel BTW laag. Wat is het artikel waar verzendkosten BTW laag op geboekt worden.

  • Overige kosten artikel. Wat is het artikel waar overige kosten op geboekt worden?

  • Kortingen artikel. Wat is het artikel waar kortingen op geboekt worden?

  • Magazijn. Welk magazijn worden de orders uit geboekt?

  • Optioneel Administratie. In welke administratie moeten orders worden geboekt?

  • Optioneel Verkoopboek. In welk verkoopboek moeten orders worden geboekt?

  • Optioneel Project. Op welk project moeten orders worden geboekt?

  • Standaard prijslijst. Welke prijslijst moet worden gebruikt voor de standaard prijzen?

  • Standaard wachtwoord. Wat is het standaard wachtwoord voor nieuwe gebruikers? Let op: Deze dient

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.

Was dit een antwoord op uw vraag?