Inrichten communicatieprofiel E-facturen via e-mail (MUBL)
Je kunt facturen verzenden en ontvangen via UBL. Hiervoor moet je onder andere een communicatieprofiel instellen.
Aandachtspunten:
- Je moet het communicatieprofiel voor UBL inrichten in elke omgeving waarin je deze functionaliteit gaat gebruiken. Je kunt dit communicatieprofiel niet per administratie inrichten.
- Bij de communicatieservice gebruik je normaal gesproken een opzet van hoofd- en subomgevingen, waarbij je het communicatieprofiel alleen inricht voor de hoofdomgeving. Dit geldt echter niet voor UBL, voor deze functionaliteit wordt de opzet van hoofd- en subomgevingen niet toegepast.
- Voor UBL moet je voor elke omgeving waarin je e-facturen inleest, een uniek e-mailadres gebruiken.
Voorbeeld:
Bijvoorbeeld, je hebt meerdere bedrijven die het domein www.enyoi.nl gebruiken: EnYoi Rotterdam en EnYoi Amsterdam. Gebruik de volgende e-mailadressen:
Omgeving EnYoi Rotterdam: accountingrotterdam@enyoi.nl
Omgeving EnYoi Amsterdam: accountingamsterdam@enyoi.nl
Communicatieprofiel voor e-facturen instellen:
- Open de juiste omgeving.
- Ga naar: Algemeen / Communicatieservice / Communicatieprofiel.
- Open het communicatieprofiel E-facturen verwerken via de e-mail.
- Vink Geblokkeerd uit.
- Ga naar het tabblad: Instellingen.
- Na de keuze voor het type mailserver kun je de bijbehorende velden invullen.
Gebruik één van deze methoden:
Methode 1: Inrichting Exchange Entra ID (voorheen Azure AD)
Je kunt inkomende e-facturen inlezen vanuit Exchange Entra ID (voorheen Azure AD). Dit heeft te maken met de door Microsoft geplande uitfasering van POP3 vanaf 13 oktober 2022.
De inrichting bestaat uit de volgende stappen:
- Applicatie maken in Azure AD
- Profit inrichten
- Afzenders/gebruikers controleren in Azure AD
Stap 1: Applicatie maken in Entra ID (voorheen Azure AD)
Je maakt in Azure AD een applicatie die de juiste rechten heeft.
- Ga naar https://portal.azure.com en log in als beheerder.
- Klik op Azure Active Directory.
- Klik op App registrations.
- Klik op New registration.
- Geef de nieuwe registratie een logische naam zoals Profit e-mail.
- Klik op Register.
- Klik op API permissions.
- Klik op Add a permission.
- Klik op Microsoft Graph.
- Klik op Application permissions.
- Vink Mail.ReadWrite aan.
- Klik op Add permissions.
Om te verzenden met Profit e-mails moet tenminste de permission Mail.ReadWrite en aan de registratie zijn toegekend. De overige permissions mogen indien gewenst verwijderd worden.
Let op:
Dit is een 'grove' instelling, want deze staat namelijk toe dat Profit namens elke gebruiker van je Azure-omgeving mag mailen. Microsoft biedt hiervoor een betere (meer fijnmazige) oplossing: je kan namelijk een policy toevoegen aan je Azure-appregistratie en deze koppelen aan een groep met een beperkt aantal users. Voor meer uitleg, zie https://learn.microsoft.com/en-us/graph/auth-limit-mailbox-access.
- Klik op Grant admin consent for ….
- Klik op Certificates & secrets.
- Klik op New client secret.
- Geef de nieuwe secret een logische naam en geef aan hoe lang de secret geldig blijft.
- Klik op Add.
- Je ziet in de weergave nu de secret. Sla deze op in bijvoorbeeld een wachtwoord-kluis. Na het afsluiten van dit scherm kun je de secret niet meer zien. Als je de secret niet meer weet moet er een nieuwe gemaakt worden. Je hebt deze later nodig bij het inrichten van Profit in het veld Application secret.
- Klik op Overview
- Je ziet de waarden Application (client) ID en Directory (tenant) ID. Deze heb je later nodig bij het inrichten van Profit voor de velden Application id en Directory id.
Let op:
Als het onderstaande scherm getoond wordt, moet je de waarde in het veld Waarde (Value) overnemen als Application Secret in Profit (dus niet de waarde in Geheim-id).
Stap 2: Profit inrichten
- Vink E-mailbijlagen als e-factuur inlezen aan.
- Selecteer Exchange Entra AD.
- Vul de waarden Directory id, Application id en Application secret (op basis van de inrichting van de Azure AD App in stap 1).
- Vul het e-mailadres in van de mailbox in.
- Vul de naam in van de map uit de mailbox waarin de e-facturen staan, dit kan bijvoorbeeld Postvak IN zijn. De naam van de map is hoofdlettergevoelig.
Stap 3: Afzenders/gebruikers controleren in Entra AD (voorheen Azure AD)
In Profit kunnen er op verschillende momenten e-mails verstuurd worden door verschillende afzenders. Mailen via Exchange Entra AD zal alleen succesvol zijn als de gebruikte afzender een gebruiker is in Entra AD. Om een Entra AD-gebruiker te maken gaat je in de Entra AD beheer omgeving (stap 1) naar Users en kies je voor New user. Zie ook dit artikel van Microsoft: https://learn.microsoft.com/nl-nl/azure/active-directory/manage-apps/add-application-portal-assign-users
Methode 2: Inrichting pop e-mail box
Let op:
Als je Microsoft (Exchange Online) gebruikt, stopt de POP e-mailbox per 1-10-2022. Vanaf deze datum schakelt Microsoft de (oude) Basic Authentication methode namelijk uit.
Andere systemen op basis van POP, zoals Google, blijven nog wel werken. Is deze wijziging van Microsoft ook voor jouw organisatie van toepassing? Dan heb je hier 23 augustus 2022 deze mail over ontvangen.
Update 26-07-2022: We zien dat Microsoft op willekeurige basis al is gestart om Basic Authentication tijdelijk uit te schakelen voor een deel van hun klanten. Als systeembeheerder kan je de Basic Authentication weer inschakelen, waardoor dit tot 01-10-2022 blijft werken. Zie voor meer informatie het artikel van Microsoft onder kopje Limited Opt Out.
- Vink E-mailbijlagen als e-factuur inlezen aan als je e-facturen wilt inlezen.
- Selecteer POP3 bij Type e-mailserver.
De communicatieservice haalt de e-mailberichten op en slaat de berichten op in het communicatiebericht van de communicatieservice. Hiermee kun je berichten ophalen via een POP-dienst, maar dit moet bij de betreffende dienst wel zijn ingeschakeld.
- Vul Gebruikersnaam, Wachtwoord en Server inkomende e-mail (POP3) in.
- Poort en ‘Veilige communicatie afdwingen’.
Wat je hier invult is afhankelijk van de instellingen en mogelijkheden van je mailserver. Twijfel je, controleer dan de documentatie van de mailserver(-dienst) of neem contact op met de beheerder hiervan. De veiligste instelling (en daarom de door AFAS aangeraden optie) is om poort 995 te gebruiken in combinatie met de optie ‘Veilige communicatie afdwingen’.
- Toegestane poorten: 110 en 995.
- Als 'Veilige communicatie afdwingen is ingeschakeld dan wordt een correct geconfigureerde mailserver afgedwongen. De servernaam moet dus overeenkomen met de CN (of 1 van de alternatieve namen) in het certificaat, het certificaat moet geldig zijn en afkomstig zijn van een vertrouwde uitgever. (Een self-signed certificaat is dus niet geldig.) Voor poort 995 wordt met deze instelling een 'Implicit SSL/TLS'-verbinding gestart. Voor poort 110 wordt er een verbinding gestart met StartTLS.
- Als 'Veilige communicatie afdwingen' is uitgeschakeld dan wordt er een poging gedaan om een veilige verbinding op te zetten. Hierbij worden juiste certificaatgegevens niet afgedwongen. Aan deze methode zitten veiligheidsrisico’s, een 'man in the middle' aanval is hierbij bijvoorbeeld mogelijk. Als de server geen SSL-certificaat heeft geconfigureerd, wordt er in 'plain text' gecommuniceerd. Dit geldt voor zowel poort 995 als 110.
- Profit gebruikt voor communicatie met de mailserver TLS 1.2. Of als dat niet beschikbaar is, TLS 1.1 of anders TLS 1.0.
- Klik op: Opslaan en sluiten.
Berichten verzenden en ontvangen via de communicatieservice:
Meer informatie over het verzenden en ontvangen van berichten, vind je hier.
