Integratie met SAP Business One: API, extensies en koppelingen die u moet kennen

Wie zoekt naar een connector voor SAP Business One, zoekt meestal niet naar software maar naar zekerheid: komt de order uit de webshop zonder handwerk in het systeem, klopt de betaling met de factuur, en wie belt er als het om vier uur 's nachts misgaat? Dit artikel legt uit welke technische ingangen SAP Business One biedt, welke soorten koppelingen u in de praktijk tegenkomt en hoe u een integratie met SAP Business One zo kadert dat ze ook over twee jaar nog werkt.

Waarom SAP Business One een kernsysteem is dat u uitbreidt

SAP Business One is een ERP voor het mkb. SAP Learning beschrijft het als een ERP-kern die is gemaakt om uitgebreid te worden, met kunstmatige intelligentie, machine learning en de clouddiensten van SAP Business Technology Platform (BTP). Automatiseringssjablonen zijn beschikbaar via de Business Accelerator Hub en SAP Build. Dat past bij de manier waarop Nederlandse mkb-bedrijven werken: een stabiele administratieve kern, daaromheen een webwinkel, een bankkoppeling, een transportportaal en een rapportagetool.

SAP zelf meldt dat er meer dan 500 sector- en landenextensies zijn en dat het product via 850 partners wordt verspreid (SAP, december 2025). Dat is goed nieuws en een waarschuwing tegelijk: de keuze is groot, maar de kwaliteit van een extensie hangt sterk af van de partner erachter. Lees ook wat een goede integrator kenmerkt voordat u een koppelingsleverancier kiest.

De API van SAP Business One: Service Layer en DI API

Een API van SAP Business One is geen los product maar een ingang tot de bedrijfslogica van het systeem. Er zijn twee hoofdroutes.

Service Layer: de REST-route

De Service Layer is een extensie-API op basis van REST, HTTP en OData; berichten gaan als JSON heen en weer. Volgens de handleiding van 27 juli 2026 ondersteunt hij OData v3 via /b1s/v1/$metadata en OData v4 via /b1s/v2/$metadata. Op SAP Learning staat dat hij de authenticatieschema's Basic en OAuth hanteert en bedoeld is om web- en mobiele toepassingen voor SAP Business One makkelijker te bouwen.

Technisch is het goed om te weten dat de Service Layer draait op SUSE Linux Enterprise en op Microsoft Windows (sinds 10.0 PL01), dat Apache als load balancer fungeert en dat hij geïntegreerd of gedistribueerd kan worden ingezet. Voor u als opdrachtgever vertaalt dat zich naar een eenvoudige vraag aan de integrator: waar draait de Service Layer in uw omgeving, en wie bewaakt hem? Dat raakt direct de keuze voor hosting en cloud.

DI API en gedeelde objectdefinities

De DI API is de oudere programmeerroute. Hij deelt met de Service Layer dezelfde objectdefinities dankzij het DI Core-component. Een order, een inkoopfactuur of een relatie gedraagt zich dus hetzelfde, ongeacht langs welke route u hem aanmaakt. Dat is belangrijk voor controle: validaties die u in het systeem hebt ingesteld, gelden ook voor uw koppelingen.

Integration Framework

Naast de API's heeft SAP Business One het Integration Framework. SAP omschreef het in april 2020 als onderdeel van het product, bruikbaar op locatie en in de cloud, dat dient als ontwikkel- en uitvoeringsomgeving voor integratiescenario's. Genoemde voorbeelden zijn dashboards, mobiele apps, uitbestede salarisverwerking, geautomatiseerde prijsaanvragen, SAP Customer Checkout, webservices en toepassingen van SAP en van andere leveranciers. Voor een mkb-bedrijf dat meerdere systemen aan elkaar wil knopen zonder zelf een tussenlaag te bouwen, is dit een logische eerste plek om te kijken.

Welke soorten koppelingen komt u tegen?

Niet elke koppeling is even zwaar. Onderstaande tabel helpt om ze te sorteren op impact en risico.

Webshops en marktplaatsen

Een koppeling met een webwinkel lijkt simpel en is dat zelden. De lastige vragen zijn niet technisch: hoe gaat u om met een deellevering, wat gebeurt er als een klant een order wijzigt na betaling, en welke voorraad toont de shop (beschikbaar, gereserveerd, onderweg)? Een goede connector maakt die keuzes expliciet. Bekijk ook de ERP-oplossing voor e-commerce en de afstemming met voorraad en inkoop in SAP Business One.

Banken en betalingen

In Nederland draait de financiële keten op SEPA en iDEAL. Een bankkoppeling verwerkt afschriften en betaalbestanden en stelt openstaande posten voor aan de boekhouder. Controleer vooral hoe de koppeling omgaat met onduidelijke betalingen: een deelbetaling, een betaling zonder factuurnummer of een creditnota. Hoe dat wordt afgehandeld, bepaalt hoeveel handwerk uw financiële afdeling houdt. Het hoofdstuk boekhouding en financiën gaat dieper op de administratie zelf.

Kantoor- en samenwerkingstools

SAP Learning noemt als standaard bureauticaintegraties export naar Microsoft 365 OneDrive (Excel en Word), samenwerking met Microsoft Teams en integratie met Outlook 365. Dat zijn koppelingen die een medewerker dagelijks gebruikt zonder dat een IT-project nodig is. Reken ze daarom niet mee als "integratieproject", maar wel mee in uw trainingsplan.

BI, EDI en elektronische handtekening

Voor rapportage op maat leest een BI-tool doorgaans uit het systeem of uit een aparte rapportagelaag. Het risico zit hier niet in de techniek maar in de definities: wat is "omzet", en wanneer telt een order mee? EDI is vooral van belang voor groothandel en logistiek, waar afnemers berichtformaten voorschrijven. Een elektronische handtekening voor offertes en contracten sluit vaak aan op het verkoopproces; zie verkoop en CRM.

Nederlandse eisen waar uw koppelingen aan moeten voldoen

Een integratie met SAP Business One in Nederland moet meer kunnen dan gegevens verplaatsen. Drie thema's komen terug.

E-factureren en Peppol. Veel afnemers, zeker overheden en grote bedrijven, willen facturen in een gestructureerd formaat ontvangen. Dat vraagt om een koppeling die uw facturen omzet, verstuurt en de ontvangstbevestiging terugkoppelt. Lees het overzicht over e-factureren in uw ERP en de achtergrond in de gids over e-facturatie.

Btw-aangifte en auditfile. De btw-aangifte volgt uit de codes op uw boekingen. Een webshopkoppeling die een verkeerde btw-code meegeeft, veroorzaakt dus een fout in uw aangifte, niet alleen in uw order. Zie hoe btw-aangifte vanuit uw ERP werkt. Houd er ook rekening mee dat uw boekhouder of accountant de auditfile moet kunnen opvragen zonder handmatige correcties.

Samenwerking met de accountant. Veel mkb-bedrijven laten hun jaarwerk door een externe accountant doen. Spreek af in welk formaat en met welke frequentie de gegevens naar het kantoor gaan, en wie de koppeling beheert.

Meer over de Nederlandse inrichting leest u op de pagina SAP Business One in Nederland.

Een integratie kaderen in vijf stappen

Een koppeling die zonder kader begint, wordt een koppeling die niemand durft aan te raken. Werk daarom in deze volgorde.

1. Beschrijf het proces, niet de techniek. Begin met de vraag wat er in de praktijk moet gebeuren: "een betaalde order wordt een verkooporder, de magazijnmedewerker ziet hem binnen een werkdag." Pas daarna komt de vraag welke API daarvoor nodig is.
2. Wijs de eigenaar van elk gegeven aan. Prijzen: ERP of shop? Voorraad: ERP. Klantgegevens: ERP of CRM? Zonder één bron ontstaan dubbele gegevens.
3. Kies de richting en het ritme. Eén richting is eenvoudiger dan twee. Bepaal per gegevensstroom of hij direct, per batch of op verzoek loopt.
4. Ontwerp de foutafhandeling. Wat gebeurt er als de shop onbereikbaar is of een artikelcode niet bestaat? Een goede koppeling meldt het en probeert het opnieuw, in plaats van stil te falen.
5. Test met echte gegevens. Gebruik echte orders, facturen en bankafschriften, inclusief uitzonderingen zoals retouren, creditnota's en deelbetalingen.

Deze aanpak sluit aan op wat in de implementatie van SAP Business One zowieso nodig is: een vastgelegd proces, een testplan en een duidelijke overdracht.

Standaard connector, extensie of maatwerk?

Er zijn drie routes, en geen is altijd de beste.

• Standaardkoppeling uit het systeem of via het Integration Framework. Snel in te richten, goed ondersteund, maar beperkt tot wat de scenario's toelaten.
• Extensie van een SAP-partner. Dekt vaak een specifiek behoefte (een bepaalde webshop, een bank, Peppol). Controleer wie de extensie onderhoudt, hoe updates worden uitgerold en wat er gebeurt als de partner stopt.
• Maatwerk op de Service Layer. Maximale vrijheid, maar ook maximale verantwoordelijkheid. U heeft documentatie, testgevallen en een beheerder nodig. Meer hierover in het onderdeel maatwerk voor SAP Business One.

Een nuchtere vuistregel: kies voor een standaard of extensie zolang uw proces er past, en voor maatwerk alleen waar uw bedrijf zich onderscheidt. Het onderhoud van een maatwerkkoppeling is een blijvende kostenpost; hoe hoog die is, hangt af van het aantal koppelingen en de frequentie van wijzigingen.

Wie onderhoudt de koppeling?

Dit is de vraag die in offertes het vaakst ontbreekt. Een koppeling is geen project met een einddatum maar een levend onderdeel van uw bedrijfsvoering. Leg daarom vast:

• wie de meldingen van mislukte berichten ontvangt en binnen welke termijn reageert;
• wie updates van SAP Business One, van de webshop en van de extensie test voordat ze live gaan;
• wie toegang heeft tot de inloggegevens van de API en hoe die worden vernieuwd;
• wie de documentatie bijhoudt, zodat een vervanger de koppeling kan overnemen.

Deze afspraken horen thuis in uw overeenkomst voor support en onderhoud. Zonder die afspraken is elke upgrade een risico en elke storing een discussie over wiens verantwoordelijkheid het is.

Veelgemaakte fouten bij koppelingen

• Te veel tegelijk. Begin met de koppelingen die uw dagelijkse proces dragen (orders, facturen, betalingen) en voeg daarna de rest toe.
• Geen eigenaar voor stamgegevens. Artikelen en relaties die op twee plekken worden gewijzigd, lopen vroeg of laat uit de pas.
• Alleen de gelukkige route testen. Het gaat mis bij uitzonderingen: halve leveringen, negatieve voorraad, een klant met meerdere vestigingen.
• Het licentie- en hostingmodel vergeten. Een koppeling die vanuit het internet bij uw systeem moet kunnen, vraagt om afspraken over beveiliging en beschikbaarheid.
• Geen plan voor een versiewissel. Kijk bij een upgrade welke koppelingen geraakt worden; de pagina over versies en edities helpt bij die inschatting.

Zo helpt de matching met een integrator

Wij zijn niet gelieerd aan SAP en voeren zelf geen projecten uit. Wat wij doen, is uw vraag koppelen aan een integrator die ervaring heeft met het type koppeling dat u nodig heeft. Beschrijf in uw aanvraag welke systemen aan SAP Business One gekoppeld moeten worden, welke gegevens heen en weer gaan en wie intern het aanspreekpunt wordt. Hoe die verbinding verloopt, ziet u op de pagina hoe het werkt. De dienst is gratis en vrijblijvend; de uiteindelijke afspraken maakt u rechtstreeks met de integrator.

De genoemde softwarenamen zijn handelsmerken van hun respectievelijke eigenaren en worden uitsluitend ter informatie vermeld. Deze site is onafhankelijk en niet verbonden aan een softwareleverancier.