In Connect XS is het mogelijk om traject- en/of spreekuurdocumenten te versturen naar AFAS.


INHOUDSOPGAVE


Inleiding - hoe werkt de koppeling?

Zodra je in de Xpert Suite een in de koppeling opgenomen traject- of spreekuurdocument definitief maakt, wordt daarvan een documentbericht opgesteld en naar AFAS verstuurd. In dat bericht wordt additionele informatie meegestuurd aan de hand waarvan AFAS onder andere het type document herkent en in het juiste dossier kan plaatsten.


Indien je in XS een extra beoordelingsronde hebt ingericht, zal de koppeling daar rekening mee houden en worden enkel goedgekeurde documenten verstuurd.


Randvoorwaarden

Om documenten naar AFAS te kunnen versturen, wordt door de Xpert Suite de knSubject-UpdateConnector aangeroepen, ook wel bekend als 'Dossier'. Deze dient in AFAS beschikbaar te zijn gesteld aan de inzendende partij en hiervoor dienen credentials beschikbaar te zijn



Stap 1. Inrichting in AFAS

Om deze UpdateConnector succesvol aan te kunnen roepen, dienen de inzendende en ontvangende partij de volgende zaken af te stemmen voor wat betreft inrichting van AFAS en de Xpert Suite:

  • wordt er ingestuurd op de CRM-bestemming 0 (Organisatie - Persoon) of 2 (Medewerker)? 'Medewerker' is hierbij verreweg de meest gebruikte optie. Het verdient de aanbeveling om in AFAS de verbinding vanuit XS te autoriseren voor zowel de combinatie 'Medewerker - Verzuim' als enkel 'Medewerker'.
    Bij elk document zullen we zowel een medewerkernummer als het volgnummer van het verzuimgeval zoals dat in AFAS bekend is meesturen - zo deze bij ons bekend is. Mocht dat verzuimvolgnummer niet bij ons bekend zijn, zullen we enkel het medewerkernummer mee (kunnen) sturen. Als XS ook geautoriseerd is voor enkel 'Medewerker' zal AFAS altijd het document vanuit XS accepteren en vindt er zo min mogelijk uitval plaats
  • in AFAS dient een gebruiker voor de inzendende partij gecreëerd te worden. De koppeling zal de gebruiker (format <AFAS deelnemernummer>.<gebruikersnaam>, bijvoorbeeld 12345.XpertSuite) gebruiken als identificatie, zodat in AFAS inzichtelijk is dat het document afkomstig is van de inzendende partij 
  • welke documenttypen dienen er uitgewisseld te worden?
    • De inzender stelt eerst een lijst op met alle typen documenten die men graag vanuit XS zou willen versturen
    • De ontvanger beoordeelt die lijst en laat enkel de documenttypen staan die men daadwerkelijk wenst te ontvangen; de overige typen worden uit de lijst verwijderd
    • de ontvanger vult de resulterende lijst vervolgens - al dan niet per type document - aan met de volgende informatie:
      • het dossiertype waarop het document ingestuurd dient te worden
      • het documentkenmerk, of de documentkenmerken (maximaal 3 per documenttype) waarop ingestuurd dient te worden


Zie onderaan een documentenlijst als voorbeeld: de geelgekleurde kolommen zijn de documenten zoals deze in de Xpert Suite zijn ingericht, waar deze door de ontvanger in de blauwe kolommen worden aangevuld met inrichtingsinformatie vanuit AFAS.


Stap 2. Inrichting in de Xpert Suite

In Connect XS dienen drie hoofdzaken te worden ingericht:

  1. een conversiegroep (per dossiertype) per ontvangende partij
  2. een klantaccount per ontvangende partij
  3. een exportkoppeling (per dossiertype) binnen het klantaccount bij 2


De conversiegroep

Voordat je begint aan het configureren van de daadwerkelijke koppeling, dien je een conversiegroep aan te maken. In deze conversiegroep ga je instellen:

  • welke documenttypen uitgewisseld gaan worden
  • met welke documentkenmerk(en) dat document naar AFAS verstuurd dient te worden

Meer informatie over conversiegroepen vind je hier.


Omdat voor elke klant de inrichting van de documentkenmerken in AFAS zal verschillen, is het belangrijk dat voor iedere klant een aparte conversiegroep wordt aangemaakt. Als die klant in zijn documentenlijst heeft aangegeven dat hij op méér dan een dossiertype wil insturen, dien je hiervoor ook meerdere conversiegroepen aan te maken.


Let op: 

Wanneer je een conversiegroep aanmaakt voor de documenten dan dient deze niet aan een extern systeem gekoppeld worden.




Creëer een nieuwe conversiegroep en selecteer 'Toevoegen gegeven' om een conversiesleutel toe te voegen:


Afbeelding met tekst, schermopname, Lettertype

Automatisch gegenereerde beschrijving



Selecteer in de lijst ‘Documenten’ en bevestig:

 

Afbeelding met tekst, software, schermopname

Automatisch gegenereerde beschrijving

 



Klik nu op de gecreëerde conversiesleutel 'Documenten' en selecteer in het nieuwe scherm 'Toevoegen gegeven'. Een popup wordt geopend:


Afbeelding met tekst, schermopname, Lettertype, lijn

Automatisch gegenereerde beschrijving



In de popup kun je de traject- en spreekuurdocumenten selecteren die je (met dit AFAS dossiertype) met de klant wenst te gaan delen. Je hebt hier ook een zoekfunctie:


Afbeelding met tekst, schermopname, Lettertype, nummer

Automatisch gegenereerde beschrijving

 

 

 

 Als je het document toegevoegd hebt, klik dan op het potloodje om het documentkenmerk aan het documenttype toe te wijzen:


Afbeelding met tekst, Lettertype, lijn, schermopname

Automatisch gegenereerde beschrijving



Voeg hier de waarde in die de klant wilt ontvangen voor het betreffende document:


Afbeelding met tekst, Lettertype, schermopname, ontwerp

Automatisch gegenereerde beschrijving



LET OP: als de klant voor een documenttype heeft aangegeven meerdere documentkenmerken te willen ontvangen, kun je de verschillende documentkenmerken (maximaal 3) scheiden met een puntkomma.



Het klantaccount

Voor het kunnen aanmaken van het klantaccount moet je over de volgende gegevens beschikken:

  • het deelnemernummer van de AFAS-omgeving (5 cijfers) - plus informatie met welke AFAS-omgeving je gaat verbinden: Test, Acceptatie of Productie?
  • een geldig token gegenereerd vanuit de AppConnector van de AFAS-omgeving
  • voor welke werkgever(s) je deze verzuimexport gaat inrichten: voor één werkgever of een werkgevergroep?


Maak een klantaccount aan van het type 'AFAS Export' en vul dit scherm met de bovenstaande gegevens.


De exportkoppeling

Als uiteindelijk bovenstaande voorbereidingen zijn getroffen, kan de daadwerkelijke export worden ingericht. Kies daartoe voor 'Toevoegen export':


 

 

Vervolgens heb je - per AFAS dossiertype - de volgende parameters om te vullen:


 

 

  1. Herkenbare naam van de exportkoppeling. In het geval van één AFAS dossiertype kan dit gewoon 'Documenten' zijn, maar verwerk in het geval van meerdere AFAS dossiertypen dat dossiertypenummer in de naam
  2. Kies hier voor AFAS Documenten
  3. Kies hier voor Documenten
  4. Kies hier de conversiegroep die je voor (dit dossiertype van) deze ontvanger hebt aangemaakt
  5. Selecteer hier de CRM-bestemming die met de ontvangende partij  is afgestemd
  6. Vul hier de AFAS gebruikersnaam in zoals verstrekt door de ontvangende partij
  7. Vul hier het te hanteren AFAS dossiertype in
  8. Kies hier voor AFAS Documenten

 

Let op: Het kan zijn dat het veld ‘Instuurder’ (Stap 6) niet getoond wordt. Vraag de Xpert Desk om dit toe te voegen.


Herhaal deze stappen voor elk extra dossiertype dat is afgestemd met de ontvangende partij.