Inleiding

Dit document beschrijft de benodigde inrichting en technische randvoorwaarden die een rol spelen om een koppeling tot stand te brengen tussen Somtoday en Afas Profit, ten behoeve van de facturering.

De volgende onderdelen bespreken we:

inrichting in Somtoday
export naar Profit
Profit Webservices installeren (BRON: Help AFAS Profit 2008)
extra tabelwaarden Profit

Inrichting

De specifieke inrichting voor de koppeling met Profit wordt in de volgende menukeuzes gedaan: Financieel > Instellingen

Nadat er gekozen is voor Profit – Afas in het veld Financieel pakket, zie je het volgende blok:

Url
In dit veld wordt de URL vastgelegd die verwijst naar de genoemde website (http[s]://[websitenaam of ip-nummer]:[poort]/Profitservices/), waaraan de webservices gekoppeld zijn. Let op de ‘/’ aan het eind van de URL.

Om te kunnen communiceren tussen de Somtoday (gehost) en Profit (op LAN van de school), moet de server waarop de server van Profit draait opengesteld worden voor communicatie met de Profit webservices.

Een poortnummer is niet verplicht, het is een manier om de communicatie van dit onderdeel gescheiden te houden van bijvoorbeeld poort 80.

Omgeving
Hierin wordt de naam van de Profit-omgeving opgegeven, waar de factuurregels naartoe gaan.

Inlognaam
De naam van de COM+ gebruiker die ingesteld wordt tijdens de installatie van de Profit webservices.

Wachtwoord
Het wachtwoord van de COM+ gebruiker die ingesteld wordt tijdens de installatie van de Profit webservices.

Verzamelrekening
Het nummer van de verzamelrekening Debiteuren, waarop tijdens de export van de factuurregels op geboekt wordt.

Betaalvoorwaarde meesturen
De mogelijkheid om de betaalvoorwaarde wel/niet mee te nemen in de koppeling naar Profit.

Grootte grootboeknummer (voegt voorloopnullen toe)
Het aantal posities van de grootboeknummers uit het rekeningschema van Profit. Dit is nodig om het aantal voorloopnullen te bepalen tijdens de export naast Profit.

Verbijzonderingcodes
Profit kent vijf verbijzondersassen, waarvoor hier verbijzonderingcodes (kostenplaatsen / kostendragers) geregistreerd kunnen worden. Bij het definiëren van de categorieën voor de standaardposten kan dan voor iedere as een verbijzonderingcode worden opgegeven.

Beheer > Instellingen > Vestigingen > [vestiging selecteren] > (Projectcode)

In de koppeling met Profit heb je de mogelijkheid om per vestiging in de orderegels een projectcode mee te sturen. Hiermee kan in Profit financiële integratie plaatsvinden naar verschillende administraties.

Deze projectcodes kun je in deze menukeuze opgeven.

Verbinding met een lokale Afas server

Als de Afas-omgeving binnen jouw schoolorganisatie in het lokale netwerk staat, moet je rekening houden met de volgende zaken:

De firewall moet opengezet worden om Somtoday met Afas te laten koppelen. De binnen de school geïnstalleerde Profit Webservices moet beschikbaar zijn op internet.

Als de verbinding via https moet lopen in verband met de veiligheid, dan moet er een goedgekeurd certificaat aangeschaft worden. Dit certificaat moet je aanvragen voor de URL die opgegeven wordt in Somtoday. Bv: https://SOM.schoolnaam.nl. Als je geen certificaat aanschaft, komt de verbinding niet tot stand.

Hieronder staat een lijst met toegestane certificaten.

Alle certificaten die uitgegeven worden door de pki-overheid ondersteund.

verisign_class3g2ssca.der:VeriSign Class 3 Secure Server CA - G2
verisign_class3g5ppca.der:VeriSign Class 3 Public Primary Certification Authority - G5
verisign_class3g3ssca.der:VeriSign Class 3 Secure Server CA - G3
staatdernederlandenrootca.crt:Staat der Nederlanden Root CA - G1
staatdernederlandenoverheidca.crt:Staat der Nederlanden Overheid CA - G1
staatdernederlandenrootca-g2.crt:Staat der Nederlanden Root CA - G2
staatdernederlandenorganisatieca-g2.crt:Staat der Nederlanden Organisatie CA - G2
Staat_der_Nederlanden_EV_Root_CA.crt:Stamcertificaat Staat der Nederlanden EV Root CA
Staat_der_Nederlanden_EV_Intermediair_CA.crt:Intermediair EV CA Staat der Nederlanden EV Intermediair CA
ESG_CA_-_G2.crt:CSP certificaten ESG - domein Organisatie (G2)
QuoVadis_CSP_-_PKI_Overheid_CA_-_G2.crt:CSP certificaten QuoVadis - domein Organisatie (G2)
getronicspinkroccadepkioverheidca-overheidenbedrijven.crt:CSP-certificaten Getronics - domein Overheid en Bedrijven (G1)
Getronics_CSP_Organisatie_CA_-_G2.crtL:CSP-certificaten Getronics - domein Organisatie (G2)

Export naar Profit

Als de inrichting gedaan is en de technische randvoorwaarden zijn geïnstalleerd, kunnen de incassoruns (factuurruns) samengesteld worden. Voor het aanmaken en samenstellen van de incassoruns, verwijzen we graag naar de procedure Financieel.

Als de run klaar is voor export, kun je gebruikmaken van de knop Afas koppeling aanmaken. Deze knop wordt alleen aangeboden voor runs met de status Opmaken en Controle en als het financiële systeem in de basisinstellingen op Afas – Profit staat.

Profit Webservices installeren

(BRON: Help AFAS Profit 2008)

Voor het transporteren van gegevens naar Profit wordt gebruikgemaakt van webservices. Deze webservices zorgen ervoor dat de gegevens van de webserver (die door Som(today)/Vocus) wordt aangeroepen) naar de database van Profit getransporteerd worden.

De Profit Webservices worden meegeleverd vanaf Profit 2008. In dit hoofdstuk wordt het instellen van de Profit Webservices beschreven.

Let op
Het installeren en instellen van de Profit Webservices moet je op de Profit Server (Back
Office) uitvoeren.

Werkwijze

Windows-onderdelen controleren/installeren.
Rechten instellen voor Profit Webservices.
Instellen van de Profit Webservices op de Profit Server (backoffice).
Testen Profit Webservices.

Windows-onderdelen controleren/installeren voor Webservices op de Profit Server
Op de Profit Server moeten voor de Webservices de juiste Windows-onderdelen geïnstalleerd en ingesteld zijn.

Je kunt de juiste Windows-onderdelen als volgt installeren of controleren:

Ga op de Profit-server naar Windows Start > Control Panel > Add or Remove Programs.
Klik op Add/Remove Windows Components.
Selecteer hier de component Application Server.
Klik vervolgens op de knop Details.
De Windows-onderdelen ASP.NET en Internet Information Services (IIS) moeten aangevinkt zijn. Enable network COM+ access staat ook aan vanwege Profit.

Rechten instellen voor Profit Webservice (ProfitServices)
Na installatie van de Profit Webservices op de server waar ook Profit is geïnstalleerd, ga je de rechten instellen.

Bij gebruik in IIS van anonieme toegang (IUSR_<servernaam>) op de virtual directory Profit Services moeten de rechten minimaal als volgt ingesteld worden:

Gebruiker(s)/groep	Mappen	Minimale bestandsrechten
IIS Worker Process Groep '-'IIS_WPG'	<Profit installatie>\Profit\AFAS Windows\Kernel\Webservices	Read & Execute
Internet Guest Account 'IUSR_<servernaam>'	C:\Windows\Temp\	Read & Execute
Gebruikers waaronder de Application Pool (ProfitAppPool) draait. Dit is vaak dezelfde als de Com+ User.	<Profit installatie> \AFAS windows\Server profile\Afas Software\Cache	Full Control

Let op
Als deze webservice over het internet wordt benaderd, dan adviseren wij je om gebruik te maken van SSL-certificaten.

Instellen rechten voor Profit Webservices:

Open op de Profit Server de Verkenner.
Ga naar C:\Program Files\Profit\AFAS Windows\Kernel.
Klik met de rechter muisknop op de map Webservice.
Kies voor Properties (Eigenschappen).
Daarna klik je op het tabblad Security (Beveiliging).
Selecteer de groep IIS_WPG bij Group or user names. Als deze gebruikersgroep niet weergegeven wordt, voeg deze gebruikersgroep dan toe:
- Klik op de knop Add.
- Typ IIS_WPG in bij Enter the object names to select.
- Klik op de knop Check.
- Klik op OK, waarna je terugkeert naar het Security-tabblad.
Selecteer vervolgens IIS_WPG.
Zet een vinkje bij Read & Execute in de kolom Allow onderin het scherm bij Permissions for IIS_WPG.
Klik op Apply.
Klik op OK.
Voer deze stappen uit voor de map C:\Windows\Temp met de anonieme gebruiker Internet Guest Account (IUSR_<servernaam>). En bovendien voor de map Profit installatie \AFAS Windows\Server profile\Afas Software\cache met gebruiker waaronder de Application Pool (ProfitAppPool) draait.

Instellen Profit Webservices op de Profit Server (backoffice)
Nadat de installatie van de Profit Webservices uitgevoerd is, kun je de Profit Webservices instellen.

Klik op het menu \\Profit\AFAS Windows\Kernel\Profit Webservices Setup\WebService Configure.exe. De wizard voor het instellen van de Profit Webservices wordt gestart.

Lees de tekst op het scherm over hoe de Internet Information Services geschikt gemaakt wordt voor het gebruik van de Profit WebServices.
Klik op Volgende.
In dit scherm moet je de gegevens van de COM+ gebruiker die je bij de installatie van Profit hebt ingesteld ingeven. Deze gebruiker moet je opgeven, omdat er voor de Profit WebServices een aparte Application Pool moet worden aangemaakt in Internet Information Services (IIS).
Vul bij Gebruikersnaam de gebruikersnaam van de COM+ gebruiker in.
Vul bij Wachtwoord het wachtwoord van de COM+ gebruiker in.
Vul bij Domain van gebruiker het domein van de COM+ gebruiker in.
Klik op de Voltooien.

Testen Profit Webservices (backoffice Profit Server)
Voordat je verder gaat, moet je eerst de Webservices testen.

Om een duidelijke foutmelding te krijgen, moet je eerst het volgende instellen:

Zet in Internet Explorer de optie Show friendly HTTP error message uit. (Internet Explorer / Tools / Internet Options / Advanced / zet bij browsing de optie Show friendly HTTP error message uit.
De Externe Gebruiker moet in Profit bij Filterautorisatie rechten hebben op Definitie / Uitvoeren.

Testen van de Webservices doe je als volgt:

Start Internet Explorer op de Profit server.
Ga naar het volgende adres: http://localhost/ProfitServices/GetConnector.asmx
Kies vervolgens voor de link: GetData (tweede link)
Gebruik de volgende gegevens (die je in Profit als externe websitegebruiker hebt aangemaakt)
- EnvironmentId: <naam van de Profit omgeving>
- UserId: <gebruikersnaam met rechten op de connector>
- Password: <wachtwoord van bovenstaande gebruiker>
- LogonAs: <leeg>
- ConnectorId: ProfitTitles
- filtersXml: <leeg>
Klik op Invoke.
Nu komt er een XML in het scherm met daarin (even zoeken, maar wel zichtbaar) de titels die in de Profit omgeving voorkomen.

Krijg je bovenstaand resultaat, dat werkt de Webservice.
Test, als dit op de Profit Server werkt, ook vanaf de Website Server. Dit gaat als volgt:
- Ga naar de Web(site) server.
- Surf naar: http://<<profitservernaam>>/ProfitServices/GetConnector.asmx

Op afstand kun je verder geen gegevens invoeren om te testen, je kunt alleen controleren of de virtual directory te benaderen is vanaf de andere machine.

Extra tabelwaarden Profit

In de connector wordt een aantal velden verplicht gesteld die in Somtoday niet geregistreerd worden. Deze waarden worden gevuld met een standaardwaarde en moeten dus worden opgenomen in de tabellen van Profit 2008.

Om de onderstaande items te kunnen aanmaken, moet je een aantal groepen aanmaken in het onderdeel Projecten (startmenu > Projecten > Item > Groep):

Artikelgroep
Integratiegroep
Prijsgroep

Aan de namen van deze groepen worden geen eisen gesteld. Tijdens de invoer van deze groepen wordt om grootboeknummers gevraagd (verplicht). Deze kunnen voor wat de koppeling van SOMtoday betreft willekeurig gekozen worden, omdat de koppeling deze grootboekrekeningen niet belast.

De volgende drie tabelwaarden zijn nodig voor de koppeling:

Artikel met itemcode = 0

Menukeuze: startmenu > Projecten > Item > Artikel

Kosten met itemcode = 0

Menukeuze: startmenu > Projecten > Item > Kosten

Werksoort met itemcode = 0

Menukeuze: startmenu > Projecten > Item > Werksoort