Inhoudsopgave
1. Werking van de koppeling
1.1 Inrichting AFAS Profit
Om de koppeling succesvol te laten werken, dient in AFAS Profit Online een aantal handelingen te worden verricht:
1.1.1 Het maken van een AppConnector (inclusief het opslaan van het token)
1.1.2 Toevoegen van GetConnectoren
1.1.3 Toevoegen van UpdateConnectoren
1.1.4 Importeren van vrije velden
1.1.1 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”.
1.1.2 Toevoegen van GetConnectoren
Vervolgens moeten de volgende GetConnectoren aan de AppConnector worden toegevoegd (zie screenshot onder).
Profit_Accounts
Proift_Warehouses
Profit_Journals
Profit_VAT_code
Profit_Article
Profit_Articlegroups
Combidesk_VAT_Code_Group (deze moet eerst geïmporteerd worden in je Afas omgeving)
Combidesk_Profit_Administrations (deze moet eerst geïmporteerd worden in je Afas omgeving)
Combidesk_Profit_DirectInvoices (deze moet eerst geïmporteerd worden in je Afas omgeving)
Combidesk_Profit_Erp_Debtor (deze moet eerst geïmporteerd worden in je Afas omgeving)
Combidesk_Profit_Journal_Periods (deze moet eerst geïmporteerd worden in je Afas omgeving)
En voor de Pro koppeling komen daar nog bij:
Combidesk_Profit_Debtor (deze moet eerst geïmporteerd worden in je Afas omgeving)
Profit_Projects
1.1.3 Toevoegen van UpdateConnectoren
Voeg de volgende UpdateConnectoren toe aan de AppConnector:
FiEntries
FbDirectInvoice
FbItemArticle
FbDeliveryNote (Pro koppeling)
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.
1.1.4 Importeren van vrije velden (Alleen pro koppeling)
Er zijn een viertal vrije velden die geïmporteerd moeten worden in Profit om de synchronisatie van verkooprelaties correct te laten werken.
Open de Management Tool via Algemeen -> Beheer -> Management Tool
Open de functiegroep Organisatie / Persoon
Kies Verkooprelatie
Druk op de knop Importeren en volg de instructies om de bijgeleverde velden (Verkooprelatie_Availability, Verkooprelatie_NamePrefix, Verkooprelatie_NameSuffix, Verkooprelatie_YesNoAttribute1, Verkooprelatie_YesNoAttribute2, Organisatie_Persoon_Attribuut1, Verkooprelatie_Bovenliggende_debiteur) te importeren.
BELANGRIJK! De vrije velden moeten geïmporteerd worden vóórdat de GetConnectoren geïmporteerd worden.
1.2 Hoe importeer je een GetConnector in AFAS?
Ga in AFAS Profit via het menu naar Algemeen › Uitvoer › Beheer › GetConnector. Druk op Importeren.
Druk vervolgens op Bestand (voor het importeren van een enkele GetConnector) of Map (wanneer u alle GetConnectoren wilt bijwerken). Blader nu naar de map waarin de GetConnectoren staan en selecteer de map of het bestand (afhankelijk van uw eerdere keuze). Importeer de GetConnector(en) door op Voltooien te drukken. Druk nogmaals op Voltooien om de import af te ronden.
1.3 Werking koppeling
De koppeling bestaat uit een tweetal onderdelen, te weten:
Dagelijks boeken van de dagomzet
Overhevelen van bonnen op rekening
1.3.1 Dagomzet
Eénmaal per dag wordt de dagomzet geboekt op een geaggregeerd niveau. In Profit worden deze als financiële boeking geboekt middels de UpdateConnector FiEntries. Hierbij worden onderstaande velden gevuld.
Boeking niveau:
Year (Jaar)
Peri (Periode)
UnId (Administratie)
JoCo (Journal Code, dagboek)
Boeking regel niveau:
VaAs (Kenmerk rekening, vaste waarde 1 voor Grootboekrekening)
AcNr (Grootboekrekening)
BpNr (Boekstuknummer)
EnDa (Datum boeking)
BpDa (Boekstuk datum)
AmCr / AmDe (Bedrag debet / credit)
VaId (Btw code)
Mref (Afletterreferentie)
1.3.2 Bonnen op rekening
Optioneel kunnen bonnen op rekening apart overgeheveld worden naar AFAS Profit. Deze worden geboekt als Balie- / Directfactuur middels de UpdateConnector FbDirectInvoice. Hierbij worden onderstaande velden gevuld.
Factuur niveau:
Unit (Administratie)
JoCo (Journal Code, dagboek)
DbId (Verkooprelatie)
OrDa (Datum)
RfCs (Opdrachtnummer / Referentie)
Re (Opmerking)
War (Magazijn)
InVa (Prijs. incl / excl btw)
Factuurregel niveau:
VaIt (Type item)
BiUn (Eenheid)
ItCd (Artikelcode)
Ds (Omschrijving)
QuUn (Aantal eenheden)
Upri (Unit price)
VaRc (Btw tariefgroep)
Indien een artikel nog niet bestaat in AFAS Profit, kan de koppeling deze optioneel aanmaken. Hiervoor wordt gebruik gemaakt van de UpdateConnector FbItemArticle. Hierbij worden onderstaande velden gevuld:
Artikel niveau:
ItCd (Artikelcode)
Ds (Omschrijving)
Grp (Artikelgroep)
BiUn (Eenheid)
VaRc (Btw tariefgroep)
1.3.3 Debiteurensynchronisatie (Pro koppeling)
Optioneel kan de koppeling verkooprelaties van AFAS synchroniseren naar klanten in DISH. Hierbij wordt het debiteurnummer uit AFAS gebruikt als external_id van een klant in DISH.
Zoals bij de inrichting aangegeven, is er een aantal extra velden dat geïmporteerd dient te zijn in AFAS. Hieronder staat aangegeven waarvoor deze velden gebruikt worden.
Verkooprelatie_YesNoAttribute1. Dit veld kun je gebruiken om klanten te verwijderen uit DISH. Als het veld aangevinkt wordt in AFAS, dan wordt de klant verwijderd uit DISH. (Advies: geef het veld als labelnaam "Inactief in DISH")
Verkooprelatie_Availability. In dit veld kan de beschikbaarheid in DISH worden aangegeven.
Verkooprelatie_NamePrefix. In dit veld kan de prefix van de klantnaam in DISH worden aangegeven.
Verkooprelatie_NameSuffix. In dit veld kan de suffix van de klantnaam in DISH worden aangegeven.
Organisatie_Persoon_Attribuut1. In dit veld kan de cardId van een klant in DISH worden aangegeven.
Verkooprelatie_Bovenliggende_debiteur. In dit veld kan de bovenliggende debiteur worden aangegeven. Dit veld wordt gebruikt om in DISH een klant onder een bovenliggende klant te hangen.
Verkooprelatie_YesNoAttribute2. Dit veld wordt gebruikt als filter in de connector die de klanten die gesynchroniseerd worden teruggeeft. Als dit veld Ja is, wordt de klant gesynchonriseerd naar DISH.
Daarnaast worden de volgende standaard velden overgeheveld naar DISH: Voornaam, Voorvoegsel, Achternaam, Naam debiteur, E-mailadres, Straat, Huisnummer, Postcode, Woonplaats, Landcode
2. Verbinden met DISH
Om verbinding te maken met DISH heb je een Client ID nodig. Deze wordt verstrekt door Eijsink en kun je invoeren bij het maken van de verbinding in Combidesk.
3. 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.
4. 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 DISH stappen in:
Selecteer filialen
Selecteer de filialen waarvoor de tickets gesynchroniseerd moeten worden. Indien je geen keuze maakt, worden alle filialen gesynchroniseerd.Startpunt transfer
Voer hieronder de marker of het ordernummer in waar de transfer van de tickets moet starten.Facturen op rekening in kasboeking
Moeten facturen op rekening worden meegenomen in de dagelijkse kasboeking?Selecteer uit te sluiten betaalmethoden
Selecteer betaalmethode(n) waarvoor de bonnen niet verwerkt moeten worden.Overhevelen fooien
Moeten fooien ook overgeheveld worden naar AFAS? Als je kiest voor 'Ja', selecteer dan verderop ook de gewenste 'Grootboekrekening fooien'.Facturen op rekening
Moeten facturen op rekening ook overgeheveld worden?Startpunt transfer facturen op rekening
Voer hieronder de marker of het ordernummer in waar de transfer van de facturen op rekening moet starten.
Als er niets wordt ingevuld, wordt de 'Startpunt transfer' marker gebruikt.Groeperen factuurregels
Moeten de orderregels van de tickets die op rekening zijn worden gegroepeerd?Verkooprelaties
Verkooprelaties overhevelen van Afas naar DISH?Betaalmethode voor interne doorbelasting
Bonnen met deze betaalmethode zijn intern doorbelast. Deze worden geboekt op de kostenplaats die bij de klant is vastgelegd.
Stel deze AFAS stappen in:
Administratie
Selecteer de administratieDagboek
Selecteer het dagboek waarin de kasboekingen gemaakt moeten wordenBtw-configuratie
Koppel hier de btw-categorieën van DISH aan de btw-tarieven in AFASConfiguratie grootboekrekeningen
Koppel de omzetgroepen uit DISH aan de bijbehorende grootboekrekeningen in AFAS.Configuratie betaalmethoden
Koppel hier de betaalmethoden van DISH aan de bijbehorende grootboekrekeningen in AFAS.Standaard grootboekrekening omzet
Selecteer de standaard grootboekrekening waar de omzet op geboekt moet worden.Verkoopboek
Selecteer het verkoopboekSelecteer standaard grootboekrekening voor betaalmethode
Selecteer de standaard grootboekrekening die gebruikt moet worden voor betaalmethoden die niet gekoppeld zijn.Configuratie verbijzonderingsas
Voer hier voor iedere sales point de code in voor de standaard verbijzondering voor as 1 die bij omzetboekingen gebruikt moet worden.Standaard code verbijzondering
Voer hier de code in voor de standaard verbijzondering voor as 1 die bij omzetboekingen gebruikt moet worden.Standaard code verbijzondering 2
Voer hier de code in voor de standaard verbijzondering voor as 2 die bij omzetboekingen gebruikt moet worden.Grootboekrekening statiegeld
Selecteer de grootboekrekening waarop het statiegeld geboekt moet wordenGrootboekrekening fooien
Selecteer de grootboekrekening waarop de fooien geboekt moet wordenStandaard debiteur
Als je de bonnen op rekening van een onbekende debiteur toch wilt boeken, voer dan hier de code van de standaard debiteur in.Maak artikelen aan
Geef aan of de koppeling artikelen moet aanmaken indien deze nog niet bestaan. Dit geldt alleen voor artikelen die gebruikt worden in een order.Configuratie artikelgroepen
Koppel de omzetgroepen uit DISH aan de artikelgroepen uit AFAS.Standaard artikel groep
Voer hier de code in van de artikel groep voor nieuwe artikelenStandaard artikel eenheid
Voer hier de code in van de eenheid voor nieuwe artikelenMagazijn
Het magazijn waar de orders uit geboekt wordenBtw-tariefgroep configuratie
Koppel hier de btw-categorieën van DISH aan de btw-tariefgroepen in AFAS (die gebruikt worden voor nieuwe artikelen)Order datum op pakbon regel?
Wil je de order datum toevoegen aan de opmerkingen op de pakbon regels?Pakbon gereedgemeld markeren?
Moet de pakbon Gereedgemeld gemarkeerd worden?Opdrachtnummer / referentie template
Voer hieronder het template voor de Opdrachtnummer/referentie in Profit. De volgende placeholders kunnen gebruikt worden: {{maand}}, {{jaar}}, {{datum}}, {{bonnummer}}, {{debiteurnaam}}, {{debiteurnummer}}, {{store}}Statiegeld artikelcode
Voer de code van het artikel in dat gebruikt moet worden voor statiegeldPakbon orderregels inclusief btw?
Moeten de prijzen op de pakbonregels altijd inclusief btw ingeschoten worden (los van de instelling op debiteurniveau)?Mapping projecten op faciliteiten
Map de faciliteiten uit DISH op de bijbehorende projecten in AFAS.Project
Het project waarop de pakbonnen geboekt wordenStandaard e-mailadres
Voer het standaard e-mailadres in voor een nieuwe klant in DISH (indien niet gevuld in DISH).Verbijzonderingsas
Geef aan op welke verbijzonderingsas de kostenplaats voor intern doorbelaste bonnen moet worden geboektStandaard verbijzonderingsas
Geef de standaardwaarde die voor de verbijzonderingsas voor intern doorbelaste bonnen moet worden gebruikt.Configuratie grootboekrekeningen voor interne doorbelastingen
Koppel ten behoeve van de intern doorbelaste bonnnen de omzetgroepen uit DISH aan de bijbehorende grootboekrekeningen in AFAS.
5. 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.
6. 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.


