NIVA is now Vatoo. Read the short story

Vatoo
All integrations

Connect SAP Business One
to Vatoo

Vatoo connects to SAP Business One using the Service Layer REST API, an OData-compatible HTTP interface included with SAP Business One 9.0+. Authentication uses a per-request session login · Vatoo opens a session, executes the operation, and closes the session automatically. Once connected you can enable individual modules and control exactly which read and write operations your bot can perform.

Estimated: 10–15 minutesIntermediate5 steps

Confirm connector availability, your account plan, and required permissions before setup. Test with a non-production record before enabling live actions.

Start free trial Get help on a call
VatooSAP
VatooSAP Business One
Verify Service Layer Is Running01
Gather Your Connection Details02
Connect in Vatoo Botmaster03
Enable Components04

Setup overview · illustrative

Have these
ready

  • SAP Business One 9.0 or later (Service Layer must be installed and running)
  • Service Layer port accessible from Vatoo server (default 50000/50001)
  • A SAP B1 user account with API access (not Windows/domain login)
  • Company database name (shown in SAP → Administration → Choose Company)
  • Vatoo Botmaster account with active bot

5 steps
to go live

01

Verify Service Layer Is Running

  • On your SAP server, open Services (services.msc) and confirm SAP Business One Service Layer is running.
  • Open a browser on the same server and navigate to http://localhost:50000/b1s/v1/$metadata · you should see XML metadata.
  • If using HTTPS (port 50001), test with https://:50001/b1s/v1/$metadata.
  • Ensure the SAP server's firewall allows inbound connections on port 50000 (or 50001) from your Vatoo server's IP.

Service Layer is installed with SAP Business One Server Tools. If missing, re-run the SAP B1 installer and check the Service Layer component.

02

Gather Your Connection Details

  • Note your SAP server hostname or IP address (e.g. 192.168.1.100 or sap.mycompany.com).
  • Note the Service Layer port · default is 50000 (HTTP) or 50001 (HTTPS).
  • Find your Company Database name: log in to SAP B1 → Help → About → or check Administration → Choose Company.
  • Use a SAP B1 user login (not a Windows login). The "manager" account works but creating a dedicated API user is recommended.
03

Connect in Vatoo Botmaster

  • Go to Botmaster → ERP Integrations.
  • Click Connect under SAP Business One.
  • Enter: Server Host, Port, Company Database, Username, Password.
  • Set Verify SSL to false if your SAP server uses a self-signed certificate (common for on-premise).
  • Click Save & Test · Vatoo will attempt a login and fetch one record to confirm connectivity.

If the test fails with a connection error, check that the port is open and the hostname resolves from Vatoo's server, not just locally.

04

Enable Components

  • After connecting, click Manage Components.
  • Toggle ON the components you want the bot to access (Business Partners, Sales Orders, Inventory, Invoices, Service Calls).
  • For each component, review Read Operations (enabled by default) and Write Operations (disabled by default · enable only what you need).
  • Click Save.

Start with read-only access. Enable write operations (create order, create invoice) only after testing read operations work correctly.

05

Test With Your Bot

  • Open your bot's chat widget.
  • Try: _"How many units of \[item code\] do we have in stock?"_
  • Try: _"Show me open orders for customer \[CardCode\]"_
  • Try: _"Find service calls from last week"_
  • Check ERP Integrations → Operation Logs to see exactly which queries fired and their results.

Stuck?
Quick fixes

Connection test fails with "Authentication failed".

Double-check Company Database name · it is case-sensitive and must match exactly. Verify the SAP username and password are for a SAP B1 user (not a Windows/AD login). Confirm the user is not locked out in SAP → Administration → Setup → General → Users.

Cannot connect to host · connection refused or timeout.

Confirm Service Layer is running on the SAP server (check Windows Services). Verify the port number · HTTP default is 50000, HTTPS is 50001. Check firewall rules on the SAP server allow the port inbound from your Vatoo server. Test connectivity: curl http://:50000/b1s/v1/$metadata

SSL certificate error.

Most on-premise SAP servers use self-signed certificates. Set Verify SSL to false in the connection config. Alternatively, install a proper SSL certificate on the SAP server and set it to true.

Bot returns "No items found" or empty results.

Check the component is enabled in Manage Components. Verify the SAP user has read access to that data in SAP → Administration → Setup → General → Users → Authorizations. Check Operation Logs to see the exact OData query sent and any SAP error returned.

Write operation fails with SAP error.

SAP Business One enforces mandatory fields · for example, Sales Orders require a valid CardCode and at least one DocumentLine. Check the Operation Log for the specific SAP error message. Ensure the SAP user has the appropriate write permissions in SAP User Authorizations.

Service Layer returns 400 on OData filter queries.

SAP Service Layer uses strict OData syntax. String values in filters must be single-quoted. Date fields use format YYYY-MM-DD. Check Operation Logs to see the exact filter sent · report the error to Vatoo support if the query looks malformed.

More integrations

Zendesk Integration

Explore Zendesk Integration

Instagram DM Integration

Explore Instagram DM Integration

LINE Integration

Explore LINE Integration

Connect SAP Business One in one call

Book a demo and we'll set up the integration with you live.

Book a 30-min demoStart free trial