Met de Magento 2 AFAS Profit Online koppeling van Combidesk worden bestellingen automatisch als facturen in AFAS Profit Online geboekt. In deze handleiding doorloop je stap voor stap de installatie.
1. Verbinden met Magento2
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 integratie
b. Callback Url: https://combo-backend.combidesk.com/magento2/activateintegration/magento2-(app)
c. Identity link URL: https://combidesk.com/oauthmagento2request/magento2-(app)
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
Klik op de link “Activate” in het Integrations overzicht
Dit opent de App Installer die in het volgende hoofdstuk wordt beschreven
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.
2. Verbinden met AFAS
Wat heb je nodig?
Voordat je begint, zorg je dat je beschikt over:
Een actief AFAS-abonnement met toegang tot de AppConnector
Het subdomein van je AFAS-omgeving (het gedeelte vóór .afas.online)
Een XML-token dat je hebt gegenereerd via de AppConnector in AFAS
Heb je nog geen AppConnector ingesteld? Doe dit dan eerst in AFAS via Beheer → AppConnector. Zorg ervoor dat er minimaal één connector aan je AppConnector is toegevoegd en kopieer het XML-token — dit wordt slechts eenmalig getoond door AFAS.
Stap voor stap: je AFAS-account koppelen
Stap 1: Open het verbindingsscherm
Ga naar de installatiepagina van de koppeling en klik op "Verbind je AFAS-account". Er verschijnt een scherm zoals hieronder.
Stap 2: Vul je subdomein in
Vul bij het veld Subdomein het eerste deel van je AFAS-URL in. De volledige URL heeft de vorm:
Vul dus alleen het gedeelte in dat vóór .afas.online staat.
Stap 3: Plak het XML-token
Plak in het veld Token het volledige XML-token dat je hebt gekopieerd uit de AppConnector in AFAS. Het token ziet er als volgt uit:
<token><version>1</version><data>...</data></token>
Let op: AFAS toont dit token slechts eenmalig. Heb je hem niet meer? Dan moet je een nieuw token aanmaken in de AppConnector.
Stap 4: Test- of acceptatieomgeving (optioneel)
Wil je verbinden met een test- of acceptatieomgeving? Vink dan de bijbehorende optie aan:
Verbind met een testomgeving
Verbind met een acceptatieomgeving
Laat deze opties uitgevinkt als je wilt verbinden met je productieomgeving.
Stap 5: Opslaan
Klik op "Opslaan" om de verbinding te bevestigen. Als alles klopt, is je AFAS-account nu succesvol gekoppeld.
Veelgestelde vragen
Waar vind ik mijn subdomein?
Je subdomein is het eerste deel van de URL waarmee je inlogt in AFAS. Bijvoorbeeld: als je inlogt via mijnbedrijf.afas.online, dan is het subdomein mijnbedrijf.
Ik ben het XML-token kwijtgeraakt — wat nu?
AFAS toont het token slechts eenmalig bij het aanmaken. Ga in AFAS naar Beheer → AppConnector en maak een nieuw token aan. Kopieer dit direct en plak het in de koppeling.
Ik krijg een foutmelding bij het opslaan — wat controleer ik?
Controleer of het subdomein correct is ingevoerd (zonder https:// of .afas.online) en of het XML-token volledig en correct is geplakt, inclusief de <token>-tags.
Kan ik verbinden met meerdere AFAS-omgevingen?
Per koppeling maak je verbinding met één AFAS-omgeving. Voor meerdere omgevingen installeer je de koppeling meerdere keren.
3. Configuratie van de koppeling
Om de koppeling goed te laten werken dient deze juist geconfigureerd te worden. In onderstaande alinea doorlopen we achtereenvolgens alle stappen van de koppeling. Voordat je start met de installatie, is het aan te raden eerst even deze stappen rustig door te nemen.
Stel deze Magento2 stappen in:
Verwerking korting
Geef aan of je de kortingen op orderregel niveau, op order niveau of gesplitst (kortingspercentages op orderregel niveau en overige kortingen op order niveau) wilt verwerken.Verkooporder nummer toevoegen
Voeg het verkooporder nummer toe aan het order nummer in Afas ProfitSelecteer order statussen
Selecteer de order statussen voor orders die naar AFAS gesynchroniseerd moeten worden. Indien er geen statussen geselecteerd worden, worden alle orders gesynchroniseerd. Zorg ervoor dat de status "Canceled" geselecteerd is, als orders die geannuleerd worden in Magento weer verwijderd moeten worden in Afas.Filter op storeviews
Selecteer hier de storeviews waar de orders uit komen in die gesynchroniseerd moeten worden (als je niets selecteert, worden alle orders meegenomen).Btw in kortingbedragen
Bevatten de discount amounts in de api resultaten bedragen inclusief btw?Klantgroep gebruiken
Wil je dat de klantgroep uit Magento gebruikt wordt om de prijslijst en kortingsgroep van nieuwe verkooprelaties in te stellen?Overhevelen verzendkosten
Geef aan of de verzendkosten meegenomen moeten worden naar naar AFAS.Markeer orders als voltooid
Orders op voltooid zetten in je webshop als ze de status "Geleverd" of "Handmatig afgehandeld" hebben in Profit. Let op: alle producten in de order worden als verzonden gemarkeerd in je webshop, terwijl deze in Profit als backorder kunnen staan.Neem de productcatalogus over uit AFAS
Zullen we alle producten synchroniseren, wijzigingen vanaf nu, of helemaal niet?Bij grotere webwinkels kan dit geruime tijd duren!
Standaard prijslijst
Standaard prijslijst incl. of excl. btw gebruiken?Groepering configurabele producten
Configurabele producten groeperen per product titel of via de main item codeConfigurabel product sorterings attribuut
Indien configurabele producten gegroepeerd worden middels product titel, welk attribuut moet er dan gebruikt worden om het hoofdartikel te vinden?Sorteervolgorde sorterings attribuut
Voer de attribuutwaarden van het attribuut dat gebruikt wordt om het hoofdartikel te vinden in, aflopend in prioriteit.Converteren lange omschrijving
Moet de markdown content die in de lange omschrijving velden is opgenomen, omgezet worden naar HTML?Synchroniseer product met prijs 0
Wil je producten met een prijs van 0 synchroniseren?Voorraden synchroniseren naar je webshop
Overnemen van de voorraad aantallen van het geselecteerde magazijn in de webshop activeren?Voorraden op magazijn niveau
Voorraden op magazijn niveau? (Gebruikt de standaard Combidesk_Profit_Stock GetConnector?)Definitie van voorraad
Selecteer je voorraad definitie hieronder (Geen = standaard definitie)Voorraad voorkeurseenheid synchroniseren
Wil je de voorraad van de voorkeurseenheid van het artikel synchroniseren (indien beschikbaar)?Voorraden van samengestelde artikelen synchroniseren naar je webshop
Wil je de voorraad van samenstellingen synchroniseren naar je webshop?Accounts voor verkooprelaties
Gebruikers accounts aanmaken voor verkooprelaties in AFAS?Afleveradres gebruiken
Maak gebruik van het afleveradres van een verkooprelatie, mits beschikbaarContactpersonen of verkooprelaties
Wil je gebruik maken van contact personen of van verkooprelaties zelf (Ja voor contactpersonen van verkooprelaties, Nee voor verkooprelaties zelf)Adres van "Factureren aan" relatie gebruiken
Heeft een verkooprelatie een andere verkooprelatie ingesteld als "Factureren aan", moet dan het adres van deze "Factureren aan" verkooprelatie toegevoegd worden in het klant account van Magento2?Prijzen synchroniseren naar je webshop
Overnemen van de prijzen in in de webshop activeren?Actieprijzen
Activeren ondersteuning voor actieprijzen in je webshop (alleen Magento 2)?Staffelprijzen
Moeten de staffelprijzen ook overgeheveld worden naar je webshop?
Stel deze AFAS stappen in:
Debiteuren verzamelrekening
Voer hier de debiteuren verzamelrekening in waar nieuwe debiteuren aan gekoppeld wordenVerzendkosten artikel
Voer hier de artikelcode in waarop de verzendkosten geboekt wordenOverige kosten artikel
Voer hier de artikelcode in waarop de overige kosten geboekt wordenKortingen artikel
Voer hier de artikelcode in waarop de kortingen geboekt wordenMagazijn
Het magazijn waar de orders uit geboekt wordenAdministratie
De administratie waar de orders in geboekt wordenProject
Het project waarop de orders geboekt wordenStandaard prijslijst
De prijslijst die gebruikt wordt voor de standaard prijzenVerkoopboek
Het verkoopboek waar de orders in geboekt wordenVerzendkosten btw laag artikel
Voer hier de artikelcode in waarop de verzendkosten btw laag geboekt wordenAanpassen bestaande verkooprelaties
Moeten bestaande verkooprelaties aangepast worden in AFAS?Standaard valuta code
Voer de standaard valuta code voor nieuwe relaties inStandaard verstrekkingswijze
Voer de standaard verstrekkingswijze voor nieuwe relaties inVerkooprelatieprofiel B2C klanten
Voer de code van het verkooprelatieprofiel voor nieuwe B2C relaties inVerkooprelatieprofiel
Voer de code van het verkooprelatieprofiel voor nieuwe relaties inBetalingsvoorwaarde
Selecteer de standaard betalingsvoorwaarde voor nieuwe relatieKredietlimiet
Voer hier de standaard kredietlimiet voor nieuwe relaties inVerwerking order
Voer hier de standaard code voor de verwerking order in voor nieuwe verkooprelatiesVoorkeur magazijn
Selecteer het voorkeursmagazijn voor nieuwe relatiesAfwijkende aanmaningset
Voer hier de afwijkende aanmaningset voor nieuwe relaties inVertegenwoordiger
Selecteer de vertegenwoordiger voor nieuwe relatiesStandaard prijslijst
Selecteer de standaard prijslijst voor nieuwe relatiesVervoerder
Selecteer de standaard vervoerder voor nieuwe verkoopordersDienst
Selecteer de dienst voor nieuwe verkoopordersVerzendstatus
Selecteer de standaard verzendstatus voor nieuwe verkoopordersVerpakking
De standaard verpakking voor nieuwe verkoopordersKostensoort
Worden kosten en kortingen als kostensoort geboekt?Kortingen artikel btw laag
Voer hier de artikelcode in waarop de kortingen voor btw laag geboekt wordenStandaard taal
Voer hier de code voor de standaard taal in voor nieuwe relatiesStandaard tegenrekening
Voer hier de code voor de standaard tegenrekening in voor nieuwe relatiesStandaard aflevercondities
Voer hier de code voor de standaard aflevercondities in voor nieuwe relatiesStandaard assortiment
Voer hier de code voor het standaard assortiment in voor nieuwe relatiesOrderregels met prijslijst in plaats van prijzen
Moeten de order regels met de verkooprelatie prijslijst worden geïmporteerd in plaats van de webshop prijzen (dit betekent dat Profit de prijzen gaat berekenen)?Standaard betaalvoorwaarde
Selecteer de standaard betaalvoorwaarde voor ordersStandaard betaalmethode
Voer de code van de standaard betaalmethode voor orders inAfwijkend contactpersoon
Geef aan of een afwijkend contactpersoon toegevoegd moet worden aan de orderDebiteuren verzamelrekening buitenland
Indien je een afwijkende debiteuren verzamelrekening voor debiteuren uit het buitenland wilt, voer deze dan hier inToekennen btw-plicht code 3 aan EU-inwoners
Ken btw-plicht code 3 toe aan EU-inwoners (personen). Let op dat een geldig btw-nummer daarbij verplicht is.Order betaalmethode mapping
Koppel AFAS instellingen voor specifieke order betaalmethoden. Het formaat is: <status1>=<property1>:<property_value1>&<property2>:<property_value2>;<status2>=<property1>:<property_value1>. Voorbeeld: Twikey=OrderProcessingCode:11&PaymentMethod:00;Paypal=OrderProcessingCode:12. Instellingen die momenteel ondersteund worden, zijn: PaymentMethod (Betaalwijze), PaymentCondition (Betaalvoorwaarde) en OrderProcessingCode (Verwerking order)Vrij veld "Credit" bij verkooporder
De standaard code voor het vrije veld "Credit" bij een verkooporder (neem contact met ons op als je dit vrije veld nog niet hebt)Factureren aan
Moet het veld factureren aan gevuld worden met de verkooprelatie?Extra magazijnen
Voer hier een komma gescheiden lijst van magazijncodes in die gebruikt moeten worden naast het standaard magazijnVaste verkooprelatie
Als je alle orders op dezelfde vaste verkooprelatie geboekt wilt hebben, vul dan hier het nummer van de verkooprelatie inBalie / Directfacturen
Wil je dat de orders als balie / directfacturen aangemaakt worden in Profit in plaats van verkooporders?Order soort
Indien een order een order soort toegewezen moet krijgen, voer dan hieronder de code van de order soort inVoorkeursmagazijn verkooprelatie
Moet het voorkeursmagazijn van de verkooprelatie gebruikt worden?Btw-code afstandsverkopen
Voer hieronder een kommagescheiden lijst van landcodes in waarvan consumenten de btw-code 5 (Afstandsverkopen) moeten krijgen.Canonline specific product numbers to administration
Bedrag aanbetalen vullen
Geef aan of het veld "Bedrag aanbetalen" gevuld moet worden met het totaal bedrag van de order indien de order is betaald. N.b. dit betekent dat "Verwerking Order" op 7 (Aanbetalen, levering na aanbetaling) komt te staan.Koppel vervoerder aan verzendmethode
Koppel hier de verzendmethode uit je webshop aan de bijbehorende vervoerder in Profit.Adres toevoegen bij afwijkende contactpersoon
Het adres wordt toegevoegd aan de afwijkende contactpersoonToekennen btw-plicht code 1 aan EU-bedrijven
Ken btw-plicht code 1 toe aan EU bedrijven die geen btw-nummer hebben ingevuld.Factuurreferentie
Moet het veld factuurreferentie gevuld worden met het order nummer?Vast artikelnummer
Als je alle order regels op hetzelfde vaste artikelnummer geboekt wilt hebben, vul dan hier het nummer van het artikel inVrijgifte Boxwise
Moet het veld 'Vrijgave Boxwise' op 'True' worden gezet als de bestelling betaald is, en op 'False' als dat niet het geval is?Btw-tariefgroep bepalen o.b.v. order
Moet de koppeling voor buitenlandse orders de btw-tariefgroep op orderregel niveau bepalen op basis van het gebruikte tarief in de order?Koppelvoorkeur prijslijst nieuwe verkooprelaties
Koppel de voorkeursprijslijst voor nieuwe relaties aan de storeviewTaal nieuwe verkooprelaties per storeview
Voer per storeview de code van de taal voor nieuwe verkooprelaties inVerkooprelatieprofiel nieuwe verkooprelaties per storeview
Voer per storeview de code van het verkooprelatieprofiel voor nieuwe verkooprelaties inToevoegen naam persoon als afdelingsnaam
Moet de naam van de persoon als afdelingsnaam worden toegevoegd?Voorkeur verkoopeenheid voor orderregels
Moet voor orderregels gebruik worden gemaakt van de voorkeur verkoopeenheid van het artikel (indien beschikbaar)?Orders prijzen inschieten incl. btw?
Moeten orderregel prijzen ingeschoten worden inclusief btw bij het overhevelen van de orders naar Afas?Orders geblokkeerd aanmaken
Moeten orders geblokkeerd aangemaakt worden?Bedrag voor order geblokkeerd aanmaken
Voer hier het bedrag in waarboven orders geblokkeerd moeten wordenStandaard code verbijzondering
Voer hier de code in voor de standaard verbijzondering voor as 1 die bij orderregels gebruikt moet worden.Attribuut set
Selecteer de attribuut set voor productenPrijzen toevoegen inclusief btw
Moeten de prijzen inclusief btw worden toegevoegd in de webshop?Taal mappings
Koppel hier de AFAS taalvelden op Magento storeviews. Formaat: taalcode1=code1,code2;taalcode2=code3,code4Categorieën
Toevoegen en verwijderen categorieën bij productenExtra websites
Komma gescheiden lijst van website id's waar de producten aan toegevoegd moeten wordenExtra storeview
Komma gescheiden lijst van codes van de extra storeviews die gekoppeld moeten wordenBtw hoog klasse
Selecteer de btw-klasse voor btw hoog artikelenBtw laag klasse
Selecteer de btw-klasse voor btw laag artikelenURL sleutel attributen
Voer de attributen in die gebruikt moeten worden om de URL sleutel voor producten te genereren. Als er geen attributen zijn ingevoerd, genereert Magento de URL sleutel zelf.Configurabele product attributen
Voer een komma gescheiden lijst in van attributen die gebruikt worden om configurabele producten te maken (attribute1 t/m attribute15)Gerelateerde producten
Moet het veld gerelateerde producten gesynchroniseerd worden naar Magento?Gewicht
Moet het veld gewicht gesynchroniseerd worden naar Magento?Extra storeview 2
Komma gescheiden lijst van codes van de extra storeviews die gekoppeld moeten worden #2Standaard wachtwoord
Voer het standaard wachtwoord voor een nieuwe gebruiker inStandaard klantgroep
Selecteer de standaard customer group voor klantenWebsite
Selecteer de website waar aan gekoppeld isAanmaken klantgroepen
Moeten klantgroepen worden aangemaakt door de koppeling?Is Sectolin
Is Sectolin
4. Het Combidesk klanten dashboard
Hoe werkt het dashboard?
Heb je een nieuw Combidesk account aangemaakt of een koppeling geïnstalleerd, dan ontvang je een e-mail met toegang tot je Combidesk account. Als je vervolgens inlogt op combidesk.com, kom je op het dashboard. Dit is de plaats waar je koppeling te vinden is. Vanuit hier kun je eenvoudig de instellingen van je koppeling en je account aanpassen, de logs van de koppeling (geschiedenis) bekijken en heb je toegang tot support.
Wat kun je inzien via je account bij Combidesk?
Vanuit je Combidesk dashboard heb je ook toegang tot je accountinstellingen, verbonden accounts, facturatie en support.
5. Wat kan je van Combidesk verwachten?
We begrijpen dat je druk bent of misschien weinig ervaring hebt met software. Daarom staat ons gespecialiseerde team altijd voor je klaar om je te helpen. Maak gebruik van onze installatiepakketten om zelf nóg meer tijd over te houden.
Installatieafspraak
Kom je tijd te kort of wil je dat wij de installatie volledig uit handen nemen, maak dan gebruik van onze implementatiehulp op afstand. Wij ontzorgen je meteen en leveren een goed werkende koppeling op. Voor de meeste koppelingen kost installatiehulp een vast bedrag van € 150, sommigen € 300. Besluit je na de proefperiode niet met de koppeling verder te gaan dan brengen we geen kosten in rekening. Maak hieronder een installatie afspraak en plan hem direct in.
Uitleg service level (SLA) abonnementen (Basis, Pro, Premium)
Om je goed te kunnen helpen bij het gebruik van onze koppeling, bieden we drie service levels aan: basis, pro en premium. Je kunt het service level altijd wijzigen in je koppeling. De prijs wordt voor de eerstvolgende betaalperiode aangepast.

