Product Information
Configure SAP ByDesign Point-of-Sales Interface
Point-of-sale systems are critical to retail business success. SAP Business ByDesign Point-of-Sale (ByD PoS) interface offers flexibility that empowers users to quickly and easily configure point of sales web service interface and ready to be consumed from any 3rd party application.
SAP Business ByDesign (ByD) provides web services to create PoS transactions, for details refer to blog Integrate SAP ByDesign with Point-of-Sales Systems
This blog post provides you with an overview on how to configure PoS interface in ByD and considers some frequently asked questions related to point of sales integration scenarios.
Overview of Point-of-Sales integration with ByD.
Point of Sales Web Service API Configuration in SAP ByDesign
SAP Business ByDesign provides the prepackaged integration scenario “Point-of-Sale Transactions Integration” to connect the PoS system with ByD using web services. As part of the Point of sales enablement you can configure this prepackage integration scenario and further web service interfaces by following the steps in ByD.
Number |
Step |
Comments |
1 |
Scope Point of Sale |
Scope the feature in Business Configuration |
2 |
Scope E-commerce |
Optional scoping feature |
3 |
Create Communication System |
Create in Application and User management |
4 |
Create Communication Arrangement for Point of Sale |
Create in Application and User management |
5 |
Create Communication Arrangement for E-commerce |
Optional activity |
Scope Point of Sale
SAP ByDesign offers business features which can be scoped in and then the feature is ready to be consumed out of the box.
As part of the configuration process I followed the steps mentioned below:
- Log into Business ByDesign system
- Go to WorkCentre “Business Configuration” and View “Implementation Project”
- Select the Implementation Project and click on “Edit Project Scope”
- Go to Step 3 “Scoping”
- Check the Scoping Element “Sales->Customer Invoicing->Point-of-Sale” as shown in the figure below
Scope E-commerce
ByDesign offers E-commerce functionality, which can be used after scoping the functionality in business configuration, its an optional step to consume the PoS interface.
In a 3rd party PoS application integration with ByD PoS user will have to synchronize several master data like Customers/Accounts, Products / Articles, Price List, Sales Orders, Service Orders, Service Confirmations and those relevant web service APIs are part of E-commerce functionality, to use those interfaces the feature has to be scoped in ByDesign.
as part of the configuration process I followed the steps mentioned below:
- Log into Business ByDesign system
- Go to Work Centre “Business Configuration” and View “Implementation Project”
- Select the Implementation Project and click on “Edit Project Scope”
- Go to Step 3 “Scoping”
- Check the Scoping Element “Sales->Selling Products and Services ->E-Selling” as shown in the figure below
Note: alternatively to scoping the pre-packed integration scenario, you can as well create custom integration scenario with additional web services.
Create Communication System
In ByDesign communication system represents an external system which is used for application integration.Communication systems can be, for example, external time recording or master data systems. For more information, refer to Communication Systems Quick Guide in the embedded ByDesign Help Center. Before you can use a communication system in an application integration scenario, you need to create a communication arrangement.
After Point of Sale is scoped, user can see the newly scoped elements. to create and configure communication system by I followed the steps mentioned below
- Go to Work Centre “Application and User Management” and View “Communication Systems”
- On top of the OWL click on “New”
- Enter the following Basic Information:
- ID: you can enter any ID to identify the external system
- Host Name: you can enter Host Name of the external system
- System Access Type: Internet
- Enter a technical contact
- Enter as System Instance you can enter any ID to identify the external system instance
- you could enter the other optional fields like Internal Comment, Contact Information …
- Execute the action “Set to active”
- Press the button “Save and Close”
Create Communication Arrangement for Point of Sale
In ByDesign Communication arrangements help you to configure the electronic data exchange between the ByDesign solution and a communication partner.
Communication arrangements can be set up for multiple business documents and communication methods.The solution provides communication scenarios for inbound and outbound communication that you can use to create communication arrangements.
Inbound communication defines how business documents are received from a communication partner, whereas outbound communication defines how business documents are sent to a communication partner.
In the Communication Arrangements view the following communication types are supported:
-
Business-to-business (B2B) : This communication type defines an electronic data exchange with a business partner.
-
Application integration: This communication type defines an electronic data exchange with a communication system. For more information, refer to Communication Arrangements Quick Guide.
The Point-of-Sale integration is Application integration and hence you can create communication arrangement for the communication system which was created in the last step.
- Go to Work Centre “Application and User Management” and View “Communication Arrangements”
- On top of the table click on “New”. A guided procedure for New Communication Arrangement will come up
- Select Communication Scenario “Point-of-Sale Transactions Integration” Note : User could use the standard prepacked integration communication scenarios.
- Go to step 2 and enter the following data:
- System Instance ID: Select the System Instance ID that was created in previous step
- Company ID: The relevant Company ID
- Go to step 3 and enter the following data:
- Communication Method: Direct Connection
- Application Protocol: Web Service
- Authentication Method: choose User ID and Password / Client certificate
- Edit the Credentials by clicking on “Edit Account”. Remember the credentials, it would be used in the configuration of the 3rd party application which calls ByDesign PoS interface.
- Finally review the data in step 4 and Finish the creation of the communication arrangement
Create Communication Arrangement for E-commerce (Opt)
Configuring E-commerce communication arrangement is a optional step and required only in case of a 3rd party PoS application integration with ByD PoS where user will have to synchronize several master data like Customers/Accounts, Products / Articles, Price List, Sales Orders, Service Orders, Service Confirmations and those relevant web service APIs are part of E-commerce functionality, to use those interfaces the feature has to be scoped in ByDesign.
Alternatively to the prepacked integration scenario to the E-Commerce integration you can create custom integration scenario with the web services required.
- Go to Work Center “Application and User Management” and View “Communication Arrangements”
- On top the table “New”. A guided procedure for New Communication Arrangement will come up
- Select Communication Scenario “E-commerce Web Shop Transactions Integration” Note : User could use the standard prepacked integration communication scenarios.
- Go to step 2 and enter the following data:
- System Instance ID: Select the System Instance ID that was created in previously
- Company ID: The relevant Company ID
- Go to step 3 and enter the following data:
- Communication Method: Direct Connection
- Application Protocol: Web Service
- Authentication Method: choose User ID and Password / Client certificate
- Edit the Credentials by clicking on “Edit Account”. Remember the user and password, it would be used in the configuration of the 3rd party application which calls ByDesign PoS interface.
- Finally review the data in step 4 and Finish the creation of the communication arrangement
Download WSDL Files
After a Point-of-Sale communication arrangement is configured in ByDesign, the service interface can be tested by downloading the WSDL of service interface Point-of-Sale Transactions Integration, to download I followed the steps mentioned below:
- Go to Work Centre “Application and User Management” and View “Communication Arrangements”
- In the the table search for communication scenario “Point-of-Sale Transactions Integration” and in the result list, Select Communication Scenario and click on “Edit”.
- click on “Technical Data” and then click on “Edit Advance Settings” button .
- Select the service “Point-of-Sale Transactions Integration” in Inbound communications list.
- Click on “Download WSDL“
- Save the WSDL in local file system.
Note: ByDesign PoS web service interface can be testing using WSDL file in any web service testing tool like SOAP UI.