Naar de hoofdinhoud

DISH AFAS koppeling: installatiehandleiding | Combidesk


​

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.

  1. Open de Management Tool via Algemeen -> Beheer -> Management Tool

  2. Open de functiegroep Organisatie / Persoon

  3. Kies Verkooprelatie

  4. 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:

  1. Dagelijks boeken van de dagomzet

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

  1. 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")

  2. Verkooprelatie_Availability. In dit veld kan de beschikbaarheid in DISH worden aangegeven.

  3. Verkooprelatie_NamePrefix. In dit veld kan de prefix van de klantnaam in DISH worden aangegeven.

  4. Verkooprelatie_NameSuffix. In dit veld kan de suffix van de klantnaam in DISH worden aangegeven.

  5. Organisatie_Persoon_Attribuut1. In dit veld kan de cardId van een klant in DISH worden aangegeven.

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

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

  • Dagboek
    Selecteer het dagboek waarin de kasboekingen gemaakt moeten worden

  • Btw-configuratie
    Koppel hier de btw-categorieën van DISH aan de btw-tarieven in AFAS

  • Configuratie 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 verkoopboek

  • Selecteer 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 worden

  • Grootboekrekening fooien
    Selecteer de grootboekrekening waarop de fooien geboekt moet worden

  • Standaard 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 artikelen

  • Standaard artikel eenheid
    Voer hier de code in van de eenheid voor nieuwe artikelen

  • Magazijn
    Het magazijn waar de orders uit geboekt worden

  • Btw-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 statiegeld

  • Pakbon 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 worden

  • Standaard 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 geboekt

  • Standaard 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.

Was dit een antwoord op uw vraag?