SAP Business One koppelen aan APIcenter

Je koppelt SAP Business One aan APIcenter met de gegevens waarmee je ook inlogt op de Service Layer van SAP Business One: het adres en de poort van de server, een SAP Business One-gebruiker met wachtwoord en de naam van de bedrijfsdatabase. Je hoeft geen API-sleutel aan te maken. Je doet dit één keer. Daarna gebruik je SAP Business One in al je integraties.

Wat je nodig hebt

• Een SAP Business One-omgeving waarop de Service Layer draait. De Service Layer is de API van SAP Business One waar APIcenter mee praat.
• Een SAP Business One-gebruiker met een wachtwoord. APIcenter logt met deze gebruiker in bij de Service Layer.
• De naam van de bedrijfsdatabase.
• Een server die APIcenter kan bereiken. Staat de server achter een firewall, laat dan het verkeer van APIcenter naar de Service Layer toe. Overleg dit met je SAP-beheerder.

Waar vind je de gegevens

SAP beschrijft in zijn eigen documentatie waar je de gegevens vindt in de System Landscape Directory (SLD) van SAP Business One:

• Servernaam en poort: op het tabblad Services van de SLD. SAP noemt in zijn voorbeelden https://<server>:40000/ControlCenter/ als adres van de SLD.
• Naam van de bedrijfsdatabase: op het tabblad DB Instances and Companies van de SLD, in de lijst met bedrijven. De naam is hoofdlettergevoelig: neem hem precies over.
• Gebruiker en wachtwoord: een bestaande SAP Business One-gebruiker. Vraag het aan je SAP-beheerder als je niet zeker weet welke gebruiker je moet gebruiken.

In de voorbeelden van SAP draait de Service Layer op poort 50000. Gebruik de poort die jouw SLD toont.

Zo koppel je SAP Business One

1. Ga in APIcenter naar Applicaties en kies Nieuwe applicatie koppelen, of doe dit in stap 2 van de wizard, Verbind je apps. Kies SAP Business One.
2. Vul een Weergavenaam in, bijvoorbeeld de naam van je bedrijf.
3. Vul de verbindingsgegevens in:
   • Server Host: het adres van de server waarop de Service Layer draait.
   • Server Port: de poort van de Service Layer.
   • Server Username: de SAP Business One-gebruiker.
   • Server Password: het wachtwoord van die gebruiker.
   • Database name: de naam van de bedrijfsdatabase.
   • Scheme: https:// of http://. Standaard is dit https://.
4. Klik op Testverbinding. APIcenter slaat de gegevens op en test de verbinding.

De algemene stappen staan in Een nieuwe applicatie koppelen en Een applicatie bewerken.

Let op: de standaardwaarde van Server Port in APIcenter is 21. Dat is niet de poort van de Service Layer. Pas de poort altijd aan.

Hoe APIcenter inlogt

APIcenter logt in bij de Service Layer met de gebruiker, het wachtwoord en de bedrijfsdatabase die je hebt ingevuld. SAP Business One geeft dan een sessie terug. APIcenter bewaart de sessie en gebruikt hem voor alle verzoeken. Hoe lang de sessie geldig is, bepaalt SAP Business One: standaard is dat 30 minuten zonder activiteit. Is de sessie bijna verlopen, dan logt APIcenter zelf opnieuw in. Daar hoef je niets voor te doen.

APIcenter controleert het SSL-certificaat van de server niet. Een server met een zelf ondertekend certificaat werkt dus ook.

Als het niet lukt

• Inloggen mislukt. Controleer de gebruiker, het wachtwoord en de naam van de bedrijfsdatabase. De naam van de bedrijfsdatabase is hoofdlettergevoelig.
• De server is niet bereikbaar. Controleer het adres, de poort en of Scheme klopt. Controleer ook of de firewall het verkeer van APIcenter toelaat.

Meer hulp bij fouten staat in SAP Business One: veelvoorkomende fouten en Verbinding of inloggen mislukt.

Volgende stappen

Maak een integratie met SAP Business One en controleer de instellingen. Zie SAP Business One verbindings- en integratie-instellingen.

Meer informatie van SAP

• Inloggen en uitloggen met de Service Layer
• Working with SAP Business One Service Layer