RCG SAP ECC Customers System API - Implementation Template

Please review the use cases described on the MuleSoft Accelerator for Retail solution pages for more information about dependencies on other APIs and services.

Prerequisite setup

• SAP should implement the BAPIs named ZBAPI_CUSTOMER_V3,ZBAPI_CUST_QUERY_V3, ZBAPI_CUSTOMER_CD_V3, ZBAPI_ADDR_QUERY_V3,ZBAPI_QUERY_V3,BAPI_CUSTOMER_GETLIST
• ZBAPI_CUSTOMER_CD_V3 is used for getting the list of customers updated in given time range
• ZBAPI_CUST_QUERY_V3 is used for retrieving the customer by Customer Id
• ZBAPI_ADDR_QUERY_V3 is used for retrieving the customer by Customer Email
• ZBAPI_CUSTOMER_V3 is used for creating or updating the customer
• BAPI_CUSTOMER_GETLIST is used for retrieve the list of existing customers
• ZBAPI_QUERY_V3 is used for retrieving the customer by MasterId/ExternalId

Required libraries

The SAP ECC Customers system API requires the following libraries, which cannot be shipped with the accelerator.These connector dependencies can be downloaded from SAP Support portal.

1. Two multi-platform Java libraries:

   sapjco3.jar
   sapidoc3.jar

2. One of the JCo platform-specific native libraries:

   sapjco3.dll (Windows)
   libsapjco3.jnilib (Mac OS X)
   libsapjco3.so (Linux)

   Once the libraries have been obtained they can be installed by running the appropriate Maven commands, as follows.

   ############ Maven commands to install the multi-platform Java libraries
   
   mvn install:install-file -Dfile=sapjco3.jar -DgroupId=com.sap.conn.jco -DartifactId=com.sap.conn.jco.sapjco3 -Dversion=3.x.x -Dpackaging=jar
   
   mvn install:install-file -Dfile=sapidoc3.jar -DgroupId=com.sap.conn.idoc -DartifactId=com.sap.conn.idoc.sapidoc3 -Dversion=3.x.x -Dpackaging=jar
   
   ############ Commands to install MacOS binaries
   
   mvn install:install-file -Dfile=darwinintel64/libsapjco3.jnilib -DgroupId=com.sap.conn.jco -DartifactId=libsapjco3 -Dversion=3.x.x -Dclassifier=external-library -Dpackaging=jnilib
   
   ############ Commands to install Linux binaries
   
   mvn install:install-file -Dfile=linuxx86\_64/libsapjco3.so -DgroupId=com.sap.conn.jco -DartifactId=libsapjco3 -Dversion=3.x.x -Dclassifier=external-library -Dpackaging=so
   
   ############ Commands to install Windows binaries
   
   mvn install:install-file -Dfile=NTintel/sapjco3.dll -DgroupId=com.sap.conn.jco -DartifactId=libsapjco3 -Dversion=3.x.x -Dclassifier=external-library -Dpackaging=dll

TroubleShooting

1. Error: SAP:CONNECTIVITY "UnableToReachDestinationException: JCO_ERROR_COMMUNICATION Connect to SAP Gateway failed" LOCATION CPIC (TCP/IP) on Localhost ERROR hostname '' unknown

   • Resolution: Go to private/etc/hosts and add the following line 127.0.0.1 localhost

Next steps

Refer to the Deployment page for instructions on how to configure and deploy this application.