Dit is het eerste artikel in een reeks die je door het proces van het koppelen van Moss en Microsoft Dynamics 365 Business Central SaaS/Cloud (MS BC) loodst. Als je deze handleiding stap voor stap volgt, heb je aan het einde van de rit Moss en MS BC succesvol aan elkaar gekoppeld.
Doel van dit artikel
Dit artikel legt uit welke stappen je moet nemen voordat je Moss en MS BC kunt verbinden. Om gegevens tussen Moss en MS BC te synchroniseren, moet je een Moss Wallet-grootboekrekening en een Moss-betalingsdagboek aanmaken, een dummy-leveranciersrekening voor transacties aanmaken en de juiste gebruiker de nodige rechten geven. Zo zorg je ervoor dat de gegevensstroom vanaf dag één werkt, zonder vraagtekens of handmatige correcties.
Ondersteunde systemen:
Moss integreert alleen via API met Microsoft Dynamics 365 Business Central (Cloud/SaaS). De volgende systemen worden niet ondersteund door deze API, maar kunnen worden gebruikt in combinatie met CSV-exports/geplande SFTP-downloads:
Microsoft Dynamics Business Central op locatie
Microsoft Dynamics Finance & Operations
Microsoft Dynamics Navision (op locatie/oudere versies)
Checklist (voordat je verbinding maakt)
Zorg ervoor dat de juiste gebruikersrechten, toegangsrechten en licenties zijn toegekend. Een gebruiker moet een actieve BC-licentie hebben. We raden BC-superrechten en Azure Global Administrator-rechten aan om verbinding te maken met de API.
Maak een Moss-balansgrootboekrekening (bijv. bankrekening) aan in BC.
Maak een betalingsdagboek aan voor Moss-betalingen (bijv. MOSS_Wallet).
Maak een ‘standaardleverancier’ (‘collectieve leverancier’) aan voor Moss-kaarttransacties zonder specifieke leverancier (bijv. MOSS STANDAARDLEVERANCIER).
Autorisaties en vereiste toestemmingen
De Moss API wordt geautoriseerd met behulp van een bestaande gebruiker van Microsoft Dynamics 365 Business Central.
Gedetailleerde autorisaties en vereiste toestemmingen
Gedetailleerde autorisaties en vereiste toestemmingen
Gebruikersvereisten voor Business Central
De gebruiker moet beschikken over een actieve Business Central-licentie.
De licentie moet toegewezen blijven zolang de integratie in gebruik is.
⚠️Het verwijderen van de licentie zal de integratie verbreken.
Azure AD-applicatiegoedkeuring
Om de verbinding te voltooien, moet de Moss Finance-applicatie worden goedgekeurd in Azure Active Directory.
Voor deze goedkeuring is een Azure Global Administrator vereist.
Als de gebruiker die de verbinding tot stand brengt geen Global Administrator-rechten heeft, moet een Azure-admin:
Het toestemmingsverzoek controleren.
De aanvraag goedkeuren in de Azure Portal.
De integratie kan pas worden voltooid nadat deze goedkeuring is verleend.
Business Central-machtigingen
We raden aan om de gebruiker die de API autoriseert SUPER-rechten te geven in Business Central.
Dit voorkomt problemen die worden veroorzaakt door ontbrekende machtigingen tijdens de installatie en uitvoering.
Als je de voorkeur geeft aan een beperkter toestemmingsmodel, kun je expliciet toestemmingen toewijzen.
In dat geval kun je de technische API-documentatie gebruiken als een leidraad voor:
Vereiste eindpunten
Vereiste tabellen en bewerkingen die door de integratie worden gebruikt
Toestemming voor het uploaden van extensies
De Moss-integratie uploadt automatisch een Business Central-extensie via de API om het integratiebereik uit te breiden.
Voor deze stap heeft de autoriserende gebruiker ook de volgende machtiging nodig:
TableData 5447 "API Extension Upload" = IndirectInsert
(Exclude_APIV2_)
Deze extensie is vereist voor geavanceerde integratiemogelijkheden.
Gedetailleerd technisch gedrag en het toepassingsgebied worden beschreven in de technische API-documentatie.
Een Moss Wallet-grootboekrekening aanmaken
Om Moss-transacties correct weer te geven in Microsoft Dynamics 365 Business Central (creditcardtransacties en/of walletbetalingen), moet je een rekening aanmaken die je Moss Wallet-saldo weergeeft.
Het saldo van deze rekening:
Stijgt bij het opladen van de Wallet.
Neemt af als er betalingen worden gedaan vanuit de Moss Wallet.
⚠️ Belangrijke mededeling voor klanten van Moss Credit
Als je klant bent bij Moss Credit en gebruik wilt maken van:
walletbetalingen voor AP-facturen of declaraties van werknemers, en Moss-creditcards
moet je twee aparte rekeningen aanmaken:
een rekening voor walletbetalingen, en
een rekening voor creditcard-betalingen.
De Moss-kredietlijn wordt alleen gebruikt voor creditcardtransacties, niet voor betalingen met een wallet.
Zo maak je een Moss Wallet-grootboekrekening aan
Zo maak je een Moss Wallet-grootboekrekening aan
Er zijn twee manieren waarop je de Moss Wallet kunt instellen:
Moss Wallet als een bankrekening (aanbevolen)
We raden aan om de Moss Wallet in Business Central als bankrekening in te stellen. Dit zorgt voor meer overzicht en sluit aan bij de manier waarop saldi en kasstromen doorgaans worden gemodelleerd.
Open ‘Zoeken’ en ga naar ‘Bankrekeningen’.
Maak een nieuwe bankrekening aan en voer het volgende in:
Bankrekeningnummer: je kunt je Moss-opwaardeergegevens gebruiken.
Boekingsgroep bankrekening: selecteer een boekingsgroep die de bankrekening koppelt aan de juiste grootboekrekening.
Alternatieve instelling: grootboekrekening
Als je geen bankrekening wilt gebruiken, kun je ook een grootboekrekening aanmaken om het saldo van de Moss Wallet weer te geven.
Open ‘Financiën’ en ga vervolgens naar ‘Rekeningschema’.
Maak nu een grootboekrekening voor de balans aan.
Configureer de rekening als volgt:
Directe boeking: ingeschakeld (vereist voor API-gebruik).
Reconciliatierekening: uitgeschakeld.
⚠️ Schakel de reconciliatierekening niet in.
Moss ondersteunt Business Centrals reconciliatiefunctie niet.
Nieuw betalingsdagboek aanmaken
Om Moss Wallet-betalingen in Business Central te registreren, moet je een speciaal betalingsdagboek aanmaken.
Moss zal dan:
Walletbetalingen rechtstreeks in dit dagboek boeken via de API.
Betalingen automatisch afstemmen met uitgaven (bijv. inkoopfacturen) wanneer het dagboek wordt geboekt in Business Central, met behulp van de Moss API-extensie.
Zo maak je een nieuw betalingsdagboek aan
Zo maak je een nieuw betalingsdagboek aan
Open ‘Cashbeheer’ en ga naar ‘Betalingsdagboeken’.
Aanbevolen configuratie
Naam: Moss Wallet-betalingen (of vergelijkbaar, duidelijk herkenbaar)
Type balansrekening:
Bankrekening → als je de Moss Wallet als bankrekening hebt aangemaakt.
Grootboekrekening → als je de Moss Wallet als grootboekrekening hebt aangemaakt.
Balansrekeningnummer:
Selecteer de Moss Wallet-rekening die je in de vorige stap hebt aangemaakt.
Dit dagboek wordt uitsluitend gebruikt voor geautomatiseerde Moss Wallet-boekingen.
Een Moss-standaardleverancier aanmaken
Alle Moss-creditcardtransacties kunnen worden geboekt onder één enkele ‘standaardleverancier’ in MS BC. Je kunt transacties ook boeken onder de respectieve leveranciersrekeningen van de handelaren die je betaalt, of een hybride aanpak hanteren waarbij alleen grotere transacties worden geboekt onder specifieke leveranciers, terwijl kleinere uitgaven worden geboekt onder de enkele creditcardleverancier.
⚠️ Deze rekening wordt ook gebruikt om wisselkoerskosten of banktransactiekosten van Moss te boeken als je facturen en declaraties betaalt vanuit je Moss Wallet.
Je kunt de btw-boekingsgroep voor de collectieve leverancier leeg laten en het btw-scenario per transactie coderen als je deze leverancier voor alle of veel verschillende creditcardtransacties wilt gebruiken.
Je bent klaar met de voorbereidingen.
Je kunt nu de verbinding tussen Moss en MSBC tot stand gaan brengen.