De Moss API geeft je organisatie directe, programmeerbare toegang tot Moss-gegevens. Deze wordt meestal gebruikt door IT-teams, datateams of implementatiepartners om Moss aan andere systemen te koppelen, workflows te automatiseren en rapportages op maat te maken.
In dit artikel wordt het volgende uitgelegd:
Beschikbare gegevens
De API biedt toegang tot de belangrijkste gegevens waarmee finance teams dagelijks werken. Hieronder vallen transactiegegevens, boekhoudkundige referentiegegevens en organisatiegegevens.
Je kunt het volledige Moss-datamodel en de API-referentie bekijken in de API-documentatie.
Gegevens | Beschrijving |
Uitgaven | Alle kaarttransacties, facturen en declaraties, inclusief details van de afzonderlijke regelitems, bedragen, btw, status, boekhoudkundige dimensies en exportgeschiedenis |
Leveranciers | Namen van leveranciers, bankgegevens, standaard boekhoudinstellingen en adressen. Je kunt leveranciers ook aanmaken en bijwerken via de API |
Grootboekrekeningen | Je grootboekrekeningcodes en -namen, zoals die in Moss zijn ingesteld |
Belastingtarieven | Alle belastingtariefcodes, -tarieven en landentoewijzingen |
Kostenplaatsen en dimensies | Je kostenplaatsen, kostendragers en eventuele aangepaste boekhoudkundige dimensies met hun waarden |
Teams en afdelingen | Jouw organisatiestructuur zoals die in Moss is opgezet |
Gebruikers | Namen, e-mailadressen en functies van medewerkers |
Banktransacties | Geldbewegingen in je Moss Wallets, inclusief balansbewegingen |
Bestanden | Zoek naar bestanden (betaalbewijzen, facturen) die bij uitgaven zijn gevoegd en download de inhoud van die bestanden |
Wat kun je allemaal doen met de Moss API?
Klanten gebruiken de Moss API om workflows en rapportages te maken die verder gaan dan de standaardexporten.
Veelvoorkomende toepassingen zijn onder andere:
Financiële rapportages en inzichten op maat
Vervang handmatige CSV-exports door realtime dashboards waarin Moss-gegevens worden gecombineerd met andere bedrijfsgegevens.
Bijvoorbeeld:
Maak een doorlopende kasprognose door gegevens over uitstaande betalingen van alle entiteiten te verzamelen en deze te visualiseren in je BI-tool (bijv. Google BigQuery, Looker Studio of Metabase).
Analyseer je uitgaven per entiteit met een uitgebreid overzicht.
Hoe vaak kan de API gegevens ophalen?
De API ondersteunt toegang bijna in realtime. Je integratie kan zo vaak als nodig is bijgewerkte gegevens opvragen, zolang je je aan de gepubliceerde limieten houdt. Veel organisaties kiezen ervoor om volgens een vast schema te synchroniseren, vaak dagelijks, afhankelijk van hun behoeften.
Belangrijkste eindpunten
Gegevens | Eindpunt | Beschrijving |
Uitgaven | GET /v1/expenses | Kaarttransacties, facturen en declaraties met volledige boekhoudkundige details (bedragen, grootboekrekeningen, belastingtarieven, dimensies, statussen) |
Grootboekrekeningen | GET /v1/expense-accounts | Rekeningschema – de grootboekrekeningen waarop de uitgaven worden geboekt |
Kostenplaatsen en dimensies | GET /v1/dimensions | Boekhoudkundige dimensies (kostenplaatsen, kostendragers, aangepaste dimensies) |
Kostenplaatsen en dimensies | GET /v1/dimension-items | Waarden binnen een dimensie (bijv. afzonderlijke kostenplaatsen of projectcodes) |
Teams | GET /v1/teams | Handig om uitgaven per team te groeperen |
Afdelingen | GET /v1/departments | Handig voor aggregatie op een hoger niveau |
Leveranciers | GET /v1/suppliers | Leveranciersstamgegevens – handig voor analyses van uitgaven per leverancier |
Gebruikers | GET /v1/users | Handig om uitgaven aan individuele personen toe te wijzen |
Je kunt de volledige use case hier bekijken in de API-documentatie.
Integraties voor project- en takenbeheer
Dienstverlenende bedrijven (bijv. bureaus, adviesbureaus, bouwbedrijven) moeten vaak de uitgaven per klantproject of opdracht bijhouden. Met de API kun je projectstructuren synchroniseren met Moss en uitgebreide uitgavengegevens ophalen voor verdere rapportage.
Bijvoorbeeld:
Maak via de API een bijbehorend dimensie-item aan in Moss zodra er een nieuw project wordt aangemaakt in je projectmanagementtool. Zo blijven je projectlijsten gesynchroniseerd zonder dat je gegevens handmatig hoeft in te voeren.
Haal uitgaven op die zijn gekoppeld aan projectcodes en laad ze in je datawarehouse om per project winst-en-verliesoverzichten te maken.
Haal project- of klantcodes op uit uitgaven in Moss en genereer nauwkeurige klantfacturen op basis van de daadwerkelijk gemaakte kosten.
Belangrijkste eindpunten
Gegevens | Eindpunt | Beschrijving |
Kostenplaatsen en dimensies | POST /v1/dimension-items | Maak een nieuwe dimensiewaarde aan (bijv. een projectcode) |
Kostenplaatsen en dimensies | PATCH /v1/dimension-items/{id} | Een dimensie-item bijwerken of deactiveren |
Uitgaven | GET /v1/expenses | Haal de uitgaven op, samen met de bijbehorende dimensiewaarden, om te bepalen bij welk project elke uitgave hoort |
Kostenplaatsen en dimensies | GET /v1/dimensions | Geef de beschikbare dimensies weer om te bepalen welke projecten vertegenwoordigen |
Kostenplaatsen en dimensies | GET /v1/dimension-items | Geef alle waarden binnen een bepaalde dimensie weer |
Je kunt de volledige use case hier bekijken in de API-documentatie.
Integraties met boekhoudsoftware
Als je ERP- of boekhoudsoftware niet standaard door Moss wordt ondersteund, kun je de API gebruiken om een aangepaste gegevenssynchronisatie te bouwen.
Bijvoorbeeld:
Haal goedgekeurde uitgaven op uit Moss en zet ze om in dagboekboekingen in je ERP. Elke uitgave bevat de grootboekrekening, het belastingtarief, de dimensies en de leverancier die nodig zijn voor een volledige boeking.
Stuur leverancierslijsten en dimensie-items vanuit je ERP naar Moss, zodat de codering van uitgaven consistent blijft met je boekhoudsysteem.
Houd leveranciersgegevens in beide systemen bij. Als er een leverancier wordt aangemaakt of bijgewerkt in Moss of je ERP, zorg dan dat de wijziging ook in het andere systeem wordt doorgevoerd.
Belangrijkste eindpunten
Gegevens | Eindpunt | Beschrijving |
Uitgaven | GET /v1/expenses | Uitgaven met volledige boekhoudkundige gegevens voor het aanmaken van dagboekboekingen |
Uitgaven | GET /v1/expense-accounts | Toewijzingen van grootboekrekeningen |
Belastingtarieven | GET /v1/tax-rates | Belasting- en btw-tarieven voor een correcte fiscale afhandeling |
Leveranciers | GET /v1/suppliers | Leveranciersgegevens, waaronder adressen en betalingsvoorwaarden |
Bestanden | POST /v1/files/search-query | Zoek naar bijlagen (bonnen, facturen) bij uitgaven |
Bestanden | GET /v1/files/{fileId}/content | Bestandsinhoud downloaden |
Kostenplaatsen en dimensies | GET /v1/dimension-items | Toewijzingen van dimensie-items in Moss (kostenplaats, project etc. |
Leveranciers | POST /v1/suppliers | Nieuwe leverancier aanmaken |
Leveranciers | PATCH /v1/suppliers/{id} | Bestaande leverancier bijwerken |
Kostenplaatsen en dimensies | POST /v1/dimensions | Nieuwe dimensie aanmaken |
Kostenplaatsen en dimensies | POST /v1/dimension-items | Nieuw dimensie-item aanmaken (kostenplaats, project etc. |
Je kunt de volledige use case hier bekijken in de API-documentatie.
Documenten opzoeken en archiveren
Haal bonnen, facturen en andere documenten op die aan uitgaven zijn gekoppeld, voor archivering, compliance of geautomatiseerde verwerking.
Bijvoorbeeld:
Importeer bonnen en facturen uit Moss in een documentbeheersysteem, met volledige metagegevens die elk document koppelen aan de bijbehorende transactie.
Haal programmatisch voorbeelddocumenten op voor externe auditors, zodat je niet meer handmatig hoeft te verzamelen.
Voer pdf-facturen in een LLM in voor gegevensextractie, nalevingscontrole of het opsporen van dubbele documenten.
Belangrijkste eindpunten
Gegevens | Eindpunt | Beschrijving |
Bestanden | POST /v1/files/search-query | Zoek naar bestanden die bij uitgaven horen |
Bestanden | GET /v1/files/{fileId}/content | Bestandsinhoud downloaden (pdf, afbeelding) |
Uitgaven | GET /v1/expenses | Uitgavengegevens, inclusief verwijzingen naar bestanden bij elke regel |
Je kunt de volledige use case hier bekijken in de API-documentatie.
Aan de slag
De API wordt meestal gebruikt door je IT- of datateam. Om ermee aan de slag te gaan, volg je doorgaans vier stappen.
1. Bepaal wat je nodig hebt
Bepaal eerst welke systemen Moss-gegevens moeten ontvangen en welke gegevens die systemen nodig hebben. Zo kun je beter bepalen wat voor soort integratie je wilt bouwen en welke eindpunten je team daarvoor moet gebruiken.
2. Betrek je IT-team of integratiepartner erbij
Deel je vereisten met je IT-team, datateam of implementatiepartner. Zij kunnen het beste ook de Moss API-documentatie doornemen, want daarin staat alle informatie die nodig is om de verbinding tot stand te brengen.
Als je geen IT-team of integratiepartner hebt, zijn er andere manieren om gegevens uit Moss te exporteren. Lees hier meer over de exportmethoden.
3. Vraag API-inloggegevens aan
Je Moss-admin kan API-inloggegevens aanmaken in de Moss-instellingen. Je IT-team gebruikt deze inloggegevens om verbinding te maken.
Volg deze stappen om API-sleutels aan te maken:
Log in op je Moss-account als admin.
Ga naar 'Instellingen' → 'Bedrijfsinstellingen' → 'API-sleutels'.
Klik op 'API-sleutel genereren'.
Bevestig de handeling via de Moss-app.
Sla zowel de sleutel-ID (kid_) als de geheime sleutel (sk_) veilig op.
Belangrijk: bewaar je inloggegevens veilig en laat ze nooit zien in code aan de clientzijde.
Voor meer informatie over het verkrijgen en gebruiken van toegangstokens kun je hier onze API-documentatie bekijken.
4. Test en ga live
Je IT-team bouwt en test de integratie en maakt deze vervolgens klaar voor gebruik in de productieomgeving.
Beveiliging en toegangscontrole
De Moss API is ontworpen om je organisatie veilige, gecontroleerde toegang te geven tot je Moss-gegevens.
De belangrijkste veiligheidsmaatregelen zijn onder meer:
Alleen toegang na authenticatie: voor elke API-verbinding zijn beveiligde inloggegevens nodig die uniek zijn voor jouw organisatie.
Aparte API-inloggegevens: API-verbindingen gebruiken hun eigen inloggegevens, los van de inloggegevens van medewerkers. Er worden geen wachtwoorden van medewerkers gedeeld.
Verzoeklimieten: de API hanteert limieten voor het aantal verzoeken om misbruik te voorkomen en betrouwbare werking te garanderen.
Controleerbare activiteiten: API-updates worden geregistreerd en zijn traceerbaar.
Worden gegevens met derden gedeeld?
Nee. De API geeft alleen toegang tot de gegevens van je eigen organisatie, en alleen aan apps die je expliciet machtigt met je inloggegevens. Moss deelt je gegevens via de API niet met derden.