Hello Everyone,
This blog post informs you about SAP BusinessOne multi-branch support together with SAP Customer Checkout.
SAP Customer Checkout supports integration with SAP BusinessOne where multi-branch is enabled from Release 2.0 FP07 onwards(Released on 14th December 2018).
You also need the B1if services for SAP Customer Checkout . The version of B1if services should be 3.4.74 or higher. You find these B1if services in our standard SAP
Note
In SAP Customer Checkout configuration you maintain the branch id from SAP BusinessOne in the field Branch ID (Beta version). If you are not using multi-branch, just leave this field blank. Once a branch ID is maintained, SAP Customer Checkout uses this branch ID for all calls to SAP BusinessOne.
Example:
The AR Invoices or Incoming/Out-going payments are all created for this branch. In stock overview you see the stocks for only the warehouses which are assigned to this branch. When you fetch an AR Invoice for payment or Sales order or any other business document to continue your business process in SAP Customer Checkout, this is done only for the branch ID maintained in configuration.
It is NOT possible to fetch any business document in SAP Customer Checkout which belongs to a branch different than what is maintained in configuration. In summary, you can say that 1 SAP Customer Checkout belongs to a 1 specific branch and can perform operations only related to that branch.
Below a list of error messages that can occur in SAP Customer Checkout monitor when the system is not configured correctly is listed. The idea is that it helps you to quickly resolve the most common problems faced.
1.
Error :999 - DI Error: (-5002) Specify an active branch
[OINV.BPLId]-The di call #1 did fail.
Solution: When multi-branch is activated in SBO, but no branch ID is maintained in SAP Customer Checkout or wrong branch ID is maintained in SAP Customer Checkout, then in SAP Customer Checkout monitor this error message is shown.
SAP Customer Checkout supports multi-branch only from Release 2.0 FP07. If lower version then kindly update. If already on the right version than maintain or correct the branch ID in SAP Customer Checkout.
2. It is NOT possible to modify or edit the branch ID in SAP Customer Checkout monitor. This is as planned. We do not allow modifying system ID and branch ID in SAP Customer Checkout monitor.
In this case the partner needs to change the Branch ID, this needs to be done in SAP Customer Checkout monitor DB directly.
3.
Error :DI Error: (-5002) 1320000257 - You are not assigned to selected branch 'Frankfurt'
[USR6.BPLId][line: 1]-The di call #1 did fail.
You are assigning customers to branch. However the user which is used for creating this customer is not assigned to the branch used. By default for SAP Customer Checkout, the integration user B1if is used. Hence this user should be assigned to the branch - you want to use.
4. By defaults when customers are created by SBO. They are created for all branches to which the logged in user(like manager) is assigned.
4A)Now (default behaviour)
We changed this behavior based on various requests, and now the customers are created for the branch which is maintained in the PoS.
4B)Behaviour which can be set using the parameter sap.POS.MaintainBP_BranchAssignment)
Which means for our B1if services, it will be created for all all branches to which integration user "B1if" is assigned. The parameter sap.POS.MaintainBP_BranchAssignment should be x or X for this behaviour to work.
5.
Error :999 - DI Error: (-5002) Warehouse is not assigned to the same branch as the document
[INV1.WhsCode][line: 1] , "201"-The di call #1 did fail.
Solution: BranchID in the transaction and warehouse used - no not match. Kindly assign the warehouse to the branch in SBO or correct the branch ID in SAP Customer Checkout or SAP Customer Checkout monitor.
6.
Error :999 - DI Error: (-5002) 1320000258 - Select business partner assigned to specified branch "Frankfurt"-The di call #1 did fail.
Solution: Customer is not assigned to the branch which is used in the transaction.
7.
Error :005 - B1 Error (0010000108): Exception : DI Error: (-5002) Account is not assigned to the same branch as the document
[ORCT.CashAcct][line: 1] , "511402"- The di call #1 did fail
Solution: PettyCash or GL Ledger account used is not assigned to branch.
8.
Error :005 - B1 Error (0010000108): Exception : DI Error: (-5002) Ensure selected branch is the same as the branch of documents to be paid
[ORCT.BPLId][line: 0] , "Swiss"
Solution: When you try to pay an Invoice which belongs to a different branch. This is not supported by SAP Customer Checkout
9.
Error: 999 – DI Error: (-2028) No matching records found (ODBC -2028)-The di call #1 did fail.
Solution: The user used in the B1DI connection in the B1if > SLD is not assigned to the branch. Refer to the KBA #2884690 for further information
In this blog, you have learnt about what is supported in SAP Customer Checkout for multi-branch scenario of SAP BusinessOne and how to resolve common configuration issues.
Hope you enjoyed the blog. Best of luck with your SAP Customer Checkout journey.
Feel free to comment and give feedback about the blog.
About me:
My name is Bikash Bansal. I work for SAP SE, Germany. My current role is of Product Owner for SAP Customer Checkout.
You can find more blogs from me about SAP Customer Checkout
here .