Skip to Content

B1WS: Business One Web Services Wrapper



The SAP Business One SDK provides several programming interfaces to build solutions on top of the SAP Business One application. In this document we will present a wrapper, called B1 Web Services wrapper (B1WS) that makes easier and quicker to develop add-ons based on the SAP Business One DI Server.
SAP Business One DI Server (Data Interface Server) is a Component Object Model (COM) service running on a server that enables multiple clients to access and manipulate SAP Business One company database, using SOAP version 1.1 messages.

B1WS will expose the DI Server functionality as Web Services to provide a better usability. Developers only need to add the web references to the B1WS web services (presented through wsdl files) and use the services with the auto generated object model. Implementation is then simplified and development time reduced with the use of B1WS.This wrapper has been developed using Visual Studio .NET 2005 but can also be used with Java environments, just take a look at the article Building Web Applications with NetBeans and SAP Business One Web Services.B1WS is delivered within the SDN license structure and therefore no support is provided.

B1WS setup allows you to easily install and run the application. You can also download the complete source code if you need more details on how the provided services are built.


B1WS is composed of the following:

  • List of wsdl files, each wsdl file representing one service
  • Http handler
  • wsdl services generator.

The figure below shows the different components and their integration. Represented in blue are the B1WS components, in orange are the Windows and SAP Business One components, and in green is a partner application using B1WS.

B1WS main component is B1WSHttpHandler, an Http Handler registered inside IIS (Internet Information Services) as a virtual directory. B1WSHttpHandler automatically intercepts all calls from B1WS web services, redirects the requests to the DI Server and returns the SOAP response to the client.
B1WSHttpHandler needs to be located in the same server machine as the DI Server.

Partner applications simply need to add a Web Reference (pointing to the corresponding wsdl file) per each DI Server service they use. In the client application the location of the B1WS server must be defined in order to redirect the calls to the B1WSHttpHandler. In .NET for example Web References have a configuration file (web.config) where the server address can be configured.

Partner applications can be located in a server machine or a client machine having a network access to the server.
No formatting in the http handler is needed, the wsdl files containing the services definitions are already formatted as required by the DI Server. The Web Services will then automatically build the requests following the right format.

The WsdlServicesGenerator is an application that automatically recreates all B1WS wsdl files. The wsdl files provided with the B1WS setup are the ones corresponding to a basic SAP Business One database without user defined fields. If the structure of the database your application will be running on contains user defined fields in B1 tables you will need to regenerate the wsdl files in order to have access to all your user defined fields from the services.


You can download the setup and source code from the following links:


SAP Business One 8.8

B1WS 1.1 (ZIP)

B1 9.0 and B1H 9.0 - NewB1WS 1.2 (ZIP)

Source Code

SAP Business One 8.8

B1WS 1.1 (ZIP)

B1 9.0 and B1H 9.0 - NewB1WS 1.2 (ZIP)

The SAP Business One Web Services tool is given as a free source code and therefore there is no support by SAP for the provided tools.

Please give us your feedback on the Business One Web Services blog: we are interested in your opinion.

More Details

For a more detailed documentation on how to develop and use B1WS please check the SAP Business One Web Services Document.

Related Content

Building Web Applications with NetBeans and SAP Business One Web Services 

This article demonstrates how developers can extend SAP Business One functionality using SAP Business One Web Services and Sun Microsystems' NetBeans IDE. The article details out how to use the NetBeans visual composer to rapidly create Web applications, drag and drop Web Services operations into the IDE editor, and enable tracing of the SOAP messages with the Message Handler module.

You can also find other tools related with SAP Business SDK development at:

Business One Development Environment

This is a compendium of software tools that make easier and quicker to develop and package add-ons based on SAP B1 SDK interfaces.

Business One Test Environment

This is a set of software tools helping to profile the usage of the SAP B1 SDK interfaces by a solution. These tools are also used by SAP during solution certification phase.

Business One Event Logger

This is a tool that easily visualizes all UI API events fired by the SAP Business One application.

Business One Test Composer

This tool allowing to easily record and replay test scripts in order to automate the Testing process of your addons.

Former Member

No comments