Numeria heeft een paar vaste koppelingen die u zonder technische kennis instelt, en een openbare API voor alles daarbuiten. De API hoort bij elk pakket.
Vaste koppelingen
| Koppeling | Wat het doet | Waar |
|---|---|---|
| Bank | Transacties van uw zakelijke rekening automatisch ophalen | Instellingen → Bankkoppelingen; zie Bank koppelen en afletteren |
| Mollie | Klanten betalen uw factuur online | Instellingen → Facturatie; zie Online betalen |
| Shopify en WooCommerce | Betaalde bestellingen worden facturen | Instellingen → Webshops; zie Webshop koppelen |
| Peppol | E-facturen versturen en ontvangen | Instellingen → Facturatie; zie E-facturen en Peppol |
Met een salarispakket is er geen rechtstreekse koppeling; de loonjournaalpost leest u in als CSV-bestand. Zie Loonjournaalpost inlezen.
De API
Met de API haalt andere software gegevens uit Numeria of zet ze erin: uw eigen systemen, een koppeling die iemand voor u bouwt, of uw accountant. De volledige beschrijving staat op de pagina voor ontwikkelaars, /developers op de website van Numeria; u komt er ook via de link de API-documentatie bij Instellingen → API. Daar staat per onderdeel welke gegevens u kunt opvragen of meesturen, met een voorbeeld, en een link naar de OpenAPI-beschrijving voor tools als Postman.
Met de API kunt u:
- Lezen: bedrijfsgegevens, relaties, verkoopfacturen (ook als PDF), inkoopfacturen, het rekeningschema, journaalposten, de btw-aangifte, de winst-en-verliesrekening en de balans.
- Schrijven, met een sleutel die dat mag: relaties aanmaken en wijzigen, conceptfacturen aanmaken en boeken, en memoriaalboekingen maken.
Lijsten komen in pagina's van standaard 25, hooguit 100 per keer. Met updated_since vraagt u alleen op wat sinds een bepaald moment is gewijzigd.
Een API-sleutel maken
Alleen de eigenaar van het bedrijf kan sleutels maken.
- Ga naar Instellingen → API.
- Vul onder Nieuwe sleutel een Naam in waaraan u de sleutel later herkent, zoals "webshop" of "accountant".
- Kies eventueel bij Verloopt op een datum. Laat u die leeg, dan werkt de sleutel tot u hem intrekt.
- Vink Mag ook schrijven (relaties, facturen en boekingen aanmaken) alleen aan als de software dat echt nodig heeft. Zonder vinkje kan de sleutel alleen lezen.
- Klik op Sleutel aanmaken.
- Kopieer de sleutel met Kopiëren en geef hem aan de software of de ontwikkelaar. Hij wordt maar één keer getoond.
De software stuurt de sleutel bij elk verzoek mee in de header Authorization: Bearer, gevolgd door de sleutel. Per sleutel kunnen er 120 verzoeken per minuut worden gedaan.
Sleutels beheren
Onder het formulier staan al uw sleutels: de naam, wie hem maakte en wanneer, het begin van de sleutel, of hij mag schrijven, wanneer hij voor het laatst is gebruikt en wanneer hij verloopt. Klik op Intrekken als een sleutel niet meer nodig is of in verkeerde handen kan zijn gevallen. Hij werkt dan meteen niet meer.
Een sleutel werkt niet meer als hij is ingetrokken of verlopen, als degene die hem maakte geen eigenaar meer is, of als het bedrijf niet actief is, bijvoorbeeld omdat het abonnement niet is betaald.
Wat de API niet doet
- Geen facturen versturen per e-mail of via Peppol; dat doet u in Numeria.
- Geen bonnen of inkoopfacturen aanmaken, en geen banktransacties.
- Geen webhooks: Numeria laat uw software niet weten dat er iets is veranderd. Vraag regelmatig op wat sinds de vorige keer is gewijzigd.