Fin CustomerProfileServiceAM

Usage Notes for Receivables Customer Profile Service
1
Table of Contents
1 Overview .................................................................................................................................................... 3
2 Service Details ............................................................................................................................................ 4
2.1 Supported Operations......................................................................................................................... 4
2.2 Setups and Security............................................................................................................................. 4
2.3 Related Services .................................................................................................................................. 5
2.3.1 Location Service ........................................................................................................................... 5
2.3.2 Organization Service .................................................................................................................... 6
2.3.3 Customer Account Service ........................................................................................................... 6
2.4 Invoking Receivables Customer Profile Service using Web Service Proxy Client................................ 6
2.5 Service Data Objects ........................................................................................................................... 8
2.6 Error Handling ................................................................................................................................... 10
3 Appendix .................................................................................................................................................. 11
3.1 Sample of the Service Client Java code. ............................................................................................ 11
3.2 Sample of the CustomerProfileInvoke.java code.............................................................................. 16
3.3 Testing the CustomerProfileService web service.............................................................................. 17
3.4 Examples of Sample Payloads ........................................................................................................... 18
3.4.1 Location Service Payloads .......................................................................................................... 18
3.4.2 Organization Service Payloads ................................................................................................... 20
3.4.3 Customer Account Service Payloads .......................................................................................... 28
3.4.4 Customer Profile Service Payloads............................................................................................. 30
3.5 Accessing WSDL URL ......................................................................................................................... 31
2
1 Overview
When a new customer registers his information into the web store to purchase an item, his
information and profile is stored and created before any orders can be completed. The
Receivables Customer Profile Web Service integrates the deploying company’s non-
Oracle online web-store systems to Oracle Fusion Receivables. This service receives the
customer profile information from the online user and creates the corresponding profile
for the existing customer and account in Fusion Receivables.
Web Services Description Language (WSDL) of the Receivables Customer Profile Web
Service can be accessed from the SOAP Web Services for Oracle Financials Cloud guide and is
available to any user who has access to Oracle Fusion Receivables. This service supports
both synchronous and asynchronous processing.
The Receivables Customer Profile Web Service is a SOAP encoded Web service which
uses HTTPS transport as defined in the WSDL. A SOAP client can be manually created to
invoke this service (example described in appendix 3.1 ). Another alternative is to
automatically invoke the service via WSDL invocation tools, such as the Web Services
Invocation Framework (WSIF) for Java clients or SOAP::Lite for Perl.
3
2 Service Details
2.1 Supported Operations
The following operations are available in the Receivables Customer Profile Service.
createCustomerProfile
This operation is used to create a customer profile at the account level in
synchronous mode. It accepts an object of Customer Profile SDO as the input
parameter and returns a response of Customer Profile SDO object.
createCustomerProfileAsync
This operation is used to create a customer profile at the account level in
asynchronous mode. It accepts an object of Customer Profile SDO as the input
updateCustomerProfile
This operation is used to update a customer profile at the account level in
synchronous mode. It accepts an object of Customer Profile SDO as the input
updateCustomerProfileAsync
This operation is used to update a customer profile at the account level in
asynchronous mode. It accepts an object of Customer Profile SDO as the input
The asynchronous requests to Oracle web service are placed in a processing

queue and handled asynchronously with other requests. The client application
does not wait for a response. Once a job is submitted, a job ID is returned in the
Web services response. The client application can then check on the status and
result of the request by referencing the job ID.
2.2 Setups and Security

Prerequisite Setups
The prerequisite setup needed to invoke the Receivables Customer Profile service is the
Receivables Customer Profile Class entity. This can be set up in the Fusion instance
through the Functional Setup Manager. The customer profile class can be passed to the
service to create the customer profile at the account level. If the information to create
the profile is not passed, the seeded DEFAULT profile class will be associated to the
customer account instead.
4
Security Details
The users and their credentials in the source system should be synchronized with the
Oracle Fusion instance so that the user invoking the web service from the source
system will get authorized at the Oracle Fusion instance. Once the service is invoked,
the XML request payload is submitted to the web service which processes the request
and creates a customer profile for the customer account in Oracle Fusion Receivables.
The user who has the customer creation duty role will be able view the customer
account profile successfully created in Receivables.
2.3 Related Services
A customer with an account is required to be present in the system in order to attach an

existing customer profile class as a customer profile. The web services from Trading
Community Architecture (TCA) can be consumed to create a customer with an account.
Below is the list of TCA web services that support the customer, account, site and site use
creation.
 LocationService
 OrganizationService
 CustomerAccountService
2.3.1 Location Service

A geographical/physical location or a postal address, for example, 500 Oracle
Parkway, Redwood Shores, CA 94065, USA or Oracle Parkway, Thames Valley Park (TVP),
Reading, Berkshire, RG6 1RA.
Web Service Description Language:

https://<host>:<port>/foundationParties/LocationService?WSDL
More details on how to construct the WSDL URL are available in 3.5
Operation that supports creation of a location: createLocation.

A sample payload to create the location using this service is given in 3.4.1
Review the LocationService documentation in the SOAP Web Services for Oracle
Financials Cloud guide for more details.
5
2.3.2 Organization Service
A company or organization such as Oracle or Dell that is registered in some
jurisdiction and can enter into a business relationship with other legal entities.

https://<host>:<port>/foundationParties/OrganizationService?WSDL
Operation that supports creation of an organization: createOrganization.

A sample payload to create the organization using this service is given in 3.4.2
Review the OrganizationService documentation in the SOAP Web Services for Oracle
Financials Cloud guide for more details.
2.3.3 Customer Account Service

A financial arrangement that a person or organization has with deploying company
to buy products and services, for example, John's buying account at Amazon, Dell's buying
account at Oracle. This service describes the details about a customer account, site and the
site purposes.

https://<host>:<port>/foundationParties/CustomerAccountService?WSDL
Operation that supports creation of a customer account: createCustomerAccount.

A sample payload to create the customer account, site and the site use using this
service is given in 3.4.3
Review the CustomerAccountService documentation in the SOAP Web Services for

Oracle Financials Cloud guide for more details.
2.4 Invoking Receivables Customer Profile Service using Web Service Proxy
Client
Step 1: Get the service description from the CustomerProfileService WSDL URL.
https://<host>:<port>/finArCustomers/CustomerProfileService?WSDL
More details on how to construct the WSDL URL are available in 3.5.
Step 2: Use WSDL to write a java class (for example, CustomerProfileServiceClient.java)

to invoke the createCustomerProfile operation of CustomerProfileService web
service and return the response.
Complete details of a sample Service Client Java code are found in Section 3.
6
The java client class (CustomerProfileServiceClient.java) should have the following two
main methods:
a) constructPayload() : Create the java method to construct the XML payload based on
the functional parameter values. This XML format should follow the standard SOAP
(Simple Object Access Protocol) specifications. The XML request payload will be
passed while invoking the service. The XML Tag names for the input parameters
(Service Data Object attributes) can be obtained from the SDO Section [2.5].
Example of a sample request payload can be found in Section [3.4.4].
b) createCustomerProfile() : Create the java method to invoke the service via http
connection and get the response. This method will accept the following parameters:
• Service URL
• Username/Password
• Keystore details
• Input Payload
Step 3: Prepare the Keystore information for certificate authentication.
• Launch the WSDL URL in the browser, click on the Lock icon appearing on the
starting of the URL and export the certificate to the local system.
• Generate a keystore file.
• Use the key tool command to import the certificate into the key store
keytool -import -file <sslcertfile> -keystore <keystorefile>
• Use this keystore file in the CustomerProfileServiceClient. Java class.
Step 4: Integrate the CustomerProfileServiceClient.java class to the source system to

Create the customer account profile. There are four major areas used in the source
system to integrate the client java class.
• Set the input parameters

The input parameters are the functional parameter values that are required for
customer profile creation. The values entered here will be formulated as XML
payload in constructPayload() method of CustomerProfileServiceClient.java class.
The XML tags for the functional parameters are shown in the SDO attribute names
mentioned in SDO Section (2.5).
• Set the Security information

The combination of keystore information (obtained from step 3) and the user
credentials are required for authentication of the service call at the Oracle Fusion
instance.
• Call the Client code for service invocation and creation of customer profile
7
This step calls the createCustomerProfile() method of
CustomerProfileServiceClient.java class with the input parameters, host information
and the security information.
• Parse the service response and handling error messages

The invocation of the service returns the response upon completion. The response is
in a XML format and it can be parsed using any standard java class (like
XPathFactory ) to read the values of the tags and analyze them to determine the
status of the service call. If the service call reports an error status, then the service
error message can be sent to the user to review the cause for the service invocation
failure.
Sample code for invocation of the CustomerProfileServiceClient is available in

Appendix 3.2
Step 5: Test the CustomerProfileService web service.
• Install Java and set PATH system

Install the Java Development Kit (JDK) and set the system environment path and
variables.
Details of the testing are available in Appendix 3.3
2.5 Service Data Objects
The Receivables Customer Profile Service Web service supports the following Service
Data Objects (SDO).
 Receivables Customer Profile SDO

 Receivables Customer Profile Flexfield SDO
Relationships
 Receivables Customer Profile SDO is the parent SDO
 Receivables Customer Profile Flexfield SDO is the child of Receivables Customer
Profile SDO
8
Receivables Customer Profile SDO
Service Data Object for creating customer profile at account level to maintain
characteristics of customer accounts, such as creditworthiness, business volume, payment
cycles, and late charge policies. For each profile you can define information such as credit
limits, payment terms, statement cycles, invoicing, and discount information. You can also
define amount limits for your late charges and statements for each currency in which you
do business.
Attribute Name Attribute Description Data Type Required

PartyId Unique Identifier that java.lang.Long Yes.
represents the customer.
CustomerAccountId Unique Identifier that java.lang.Long Yes.
represents the customer
account.
ProfileClassName The name of the customer java.lang.String No.
profile class setup. The seeded profile class
DEFAULT will be attached to the
customer account as a profile if
no value is provided.
CustomerProfileFLEX Customer profile descriptive CustomerProfileF No.
flexfield information lexField SDO
Receivables Customer Profile Flexfield SDO
This is the Service SDO for the customer profile flexfield of the Receivables
customer. The SDO Attributes are:
Attribute Name Attribute Description Required

Data Type
_Flex_Context Context for the Receivables java.lang.String No.
Customer Profile descriptive This value is entered by the
flexfield. user if the user chooses to use a
flexfield.
_Num_Of_Segments Number of Segments for the java.lang.Integer No.

Receivables Customer Profile This value is entered by the
descriptive flexfield. user if the user chooses to use a
flexfield.
9
2.6 Error Handling
When a Web service request is being processed and an error is encountered, the
nature of the error will be communicated to the client. The SOAP specification
defines a standard, platform-independent way of describing the error within the
SOAP message using a SOAP fault.
SOAP faults can be one of the following types:
 Modeled
This refers to an exception that is thrown explicitly from the business logic and
mapped to wsdl:fault definitions in the WSDL file.
 Unmodeled
This refers to an exception that is generated at run-time when no business logic
fault is defined in the WSDL. In this case, Java exceptions are represented as
generic SOAP fault exceptions, javax.xml.ws.soap.SOAPFaultException.
The faults are returned to the sender only in case of synchronous mode. If a Web
service invocation is asynchronous, the SOAP fault is not returned to the sender but
stored for further processing. For more information about exception handling refer
to the Exception Handling SOAP documentation.
The table below shows the error message names and the accompanying text that
describes each error.
Receivables Customer Profile Service Error Messages Table
Message Name Message Text
HZ_API_NO_A_PTY The party is either inactive or does not exist.
Cannot find the default customer profile class. Use a different

HZ_API_NO_DEFAULT_PROF_CLASS profile class.
The customer profile class is inactive. Select another profile

HZ_API_INACTIVE_PROFILE_CLASS class for the customer profile.
10
3 Appendix
3.1 Sample of the Service Client Java code.
CustomerProfileServiceClient.Java code:
import java.io.BufferedReader;
import java.io.IOException;
import java.io.InputStream;
import java.io.InputStreamReader;
import java.io.OutputStream;
import java.io.OutputStreamWriter;
import java.net.HttpURLConnection;
import java.net.URL;
import java.util.HashMap;
public class CustomerProfileServiceClient {

public CustomerProfileServiceClient() {
super();
}
private static String serviceURL;

private static String inputPayload;
private static String username;
private static String password;
private static String userToken;
private static String outputPayload;
public static String httpPost(String destUrl, String postData,

String authStr, String keyStoreLocation,
String keyStorePassword) throws Exception {
System.out.println();
System.out.println("Invoking the Service");
// Setting the KeyStore Properties
System.setProperty("javax.net.ssl.trustStore", keyStoreLocation);
System.setProperty("javax.net.ssl.trustStorePassword",
keyStorePassword);
// Open the HTTP connection and set the connection properties
URL url = new URL(destUrl);

HttpURLConnection conn = (HttpURLConnection)url.openConnection();
if (conn == null) {
return null;
}
conn.setRequestProperty("Content-Type", "text/xml;charset=UTF-8");
conn.setDoOutput(true);
conn.setDoInput(true);
conn.setUseCaches(false);
conn.setFollowRedirects(true);
conn.setAllowUserInteraction(false);
conn.setRequestMethod("POST");
11
// Set the Authorization property for the HTTP connection using the
username and password
byte[] authBytes = authStr.getBytes("UTF-8");

String auth = Base64.byteArrayToBase64(authBytes);
conn.setRequestProperty("Authorization", "Basic " + auth);
// Post the http request. This will invoke the customer profile Web
Service for creating the customer profile
OutputStream out = conn.getOutputStream();

OutputStreamWriter writer = new OutputStreamWriter(out, "UTF-8");
writer.write(postData);
writer.close();
out.close();
try {
InputStream errIs = conn.getErrorStream();
if (errIs != null) {
String err = getString(errIs);
if (err != null && !err.isEmpty()) {
System.out.println(err);
}
errIs.close();
}
} catch (Exception e) {
e.printStackTrace();
}
// Read the response and return it to the calling Java API
String response = null;

try {
InputStream in = conn.getInputStream();
if (in != null) {
response = getString(in);
in.close();
}
} catch (Exception e) {
}
conn.disconnect();
return response;
}
public static String getString(InputStream errIs) {
BufferedReader br = null;
StringBuilder sb = new StringBuilder();
String line;
try {
br = new BufferedReader(new InputStreamReader(errIs));

while ((line = br.readLine()) != null) {
sb.append(line);
}
} catch (IOException e) {
12
} finally {
if (br != null) {
try {
br.close();
} catch (IOException e) {
}
}
}
return sb.toString();
public void setInputPayload(String inputPayload) {

this.inputPayload = inputPayload;
}
public String getInputPayload() {

return this.inputPayload;
}
public void setWebService(String webService) {

this.serviceURL = webService;
}
public static String getWebService() {

return serviceURL;
}
public void setUsername(String username) {

this.username = username;
}
public static String getUsername() {

return username;
}
public void setPassword(String password) {

this.password = password;
}
public static String getPassword() {

return password;
}
public void setUserToken(String userToken) {

this.userToken = userToken;
}
public String getUserToken() {

return userToken;
}
public void setOutputPayload(String outputPayload) {

this.outputPayload = outputPayload;
}
public String getOutputPayload() {

return outputPayload;
}
public String constructPayload(HashMap profileDetails) {

13
String payload =
"<soap:Envelope
xmlns:soap=\"http://schemas.xmlsoap.org/soap/envelope>\n" +
" <soap:Body>\n" +
" <ns1:createCustomerProfile
xmlns:ns1=\"http://xmlns.oracle.com/apps/financials/receivables/cu
stomers/customerProfileService/types/\">\n" +
" <ns1:customerProfile
xmlns:ns2=\"http://xmlns.oracle.com/apps/financials/receivables/cu
stomers/customerProfileService/\">\n" +
"
<ns2:CustomerAccountId>"+profileDetails.get("CustomerAccountId")+"
</ns2:CustomerAccountId>\n" +
"
<ns2:PartyId>"+profileDetails.get("PartyId")+"</ns2:PartyId>\n" +
" </ns1:customerProfile>\n" +
" </ns1:createCustomerProfile>\n" +
" </soap:Body>\n" +
"</soap:Envelope> \n";
return payload;
}
public String createCustomerProfile(String hostName, int port, String

username,
String password, HashMap profileDetails,
String keyStoreLocation,
String keyStorePassword) throws Exception {
if (port < 0)
this.setWebService("https://" + hostName +
"/finArCustomers/CustomerProfileService");
else
this.setWebService("https://" + hostName + ":" + port +
"/finArCustomers/CustomerProfileService");
this.setUsername(username);
this.setPassword(password);
// Construct the XML input payload
String reqPayload = this.constructPayload(profileDetails);

this.setInputPayload(reqPayload);
// Invoke the service via a http secure connection
String response =
httpPost(getWebService() + "?invoke=",
getInputPayload(), getUsername() +
":" + getPassword(), keyStoreLocation, keyStorePassword);
return response;
}}
14
Base64.Java code:
public class Base64 {

public Base64() {
super();
}
public static String byteArrayToBase64(byte[] a) {

return byteArrayToBase64(a, a.length);
}
public static String byteArrayToBase64(byte[] a, int aLen) {

int numFullGroups = aLen / 3;
int numBytesInPartialGroup = aLen - 3 * numFullGroups;
int resultLen = 4 * ((aLen + 2) / 3);
StringBuffer result = new StringBuffer(resultLen);
char intToAlpha[] = intToBase64;
int inCursor = 0;
for (int i = 0; i < numFullGroups; i++) {
int byte0 = a[inCursor++] & 0xff;
result.append(intToAlpha[byte0 >> 2]);
result.append(intToAlpha[byte0 << 4 & 0x3f | byte1 >> 4]);
result.append(intToAlpha[byte1 << 2 & 0x3f | byte2 >> 6]);
result.append(intToAlpha[byte2 & 0x3f]);
}
if (numBytesInPartialGroup != 0) {
result.append(intToAlpha[byte0 >> 2]);
if (numBytesInPartialGroup == 1) {
result.append(intToAlpha[byte0 << 4 & 0x3f]);
result.append("==");
} else {
result.append(intToAlpha[byte0 << 4 & 0x3f |
byte1 >> 4]);
result.append(intToAlpha[byte1 << 2 & 0x3f]);
result.append('=');
}
}
return result.toString();
}
private static final char intToBase64[] =

{ 'A', 'B', 'C', 'D', 'E', 'F', 'G', 'H', 'I', 'J', 'K', 'L',
'M', 'N','O', 'P', 'Q', 'R', 'S', 'T', 'U', 'V', 'W', 'X', 'Y',
'Z', 'a', 'b','c', 'd', 'e', 'f', 'g', 'h', 'i', 'j', 'k', 'l',
'm', 'n', 'o', 'p', 'q', 'r', 's', 't', 'u', 'v', 'w', 'x',
'y', 'z', '0', '1', '2', '3','4', '5', '6', '7', '8', '9',
'+', '/' };
15
3.2 Sample of the CustomerProfileInvoke.java code
import java.io.StringReader;
import java.util.HashMap;
import javax.xml.parsers.DocumentBuilder;
import javax.xml.parsers.DocumentBuilderFactory;
import javax.xml.xpath.XPath;
import javax.xml.xpath.XPathFactory;
import org.w3c.dom.Document;
import org.xml.sax.InputSource;
public class CustomerProfileInvoke {

public CustomerProfileInvoke() {
super();
}
public static void main(String[] args) throws Exception {
HashMap profileDetails = new HashMap();
// Setting necessary input parameter values utilizing the

profileDetails Attributes. See Section 2.2 for list of SDOs and
Attributes
profileDetails.put("CustomerAccountId", "1001");
profileDetails.put("PartyId", "1001");
// Setting keystore Location
String keyStoreLocation = "C:\\default-keystore.jks";

String keyStorePass = "welcome1";
String username = “guest”;
String password = “guest”;
// Calling the customer profile service invocation

// The createCustomerProfile method calls the Http Post to invoke
the service
CustomerProfileServiceClient custProfile = new

CustomerProfileServiceClient();
String response =
custProfile.createCustomerProfile("efops-rel8-cdrmdit-
external-fin.us.oracle.com",-1, username, password,
profileDetails,keyStoreLocation, keyStorePass);
// Parse the response to read the service output details and

handle errors if any.
if (response != null && !response.isEmpty()) {

System.out.println();
InputSource source = new InputSource(new
StringReader(response));
DocumentBuilderFactory dbf =
DocumentBuilderFactory.newInstance();
DocumentBuilder db = dbf.newDocumentBuilder();
Document document = db.parse(source);
XPathFactory xpathFactory = XPathFactory.newInstance();
XPath xpath = xpathFactory.newXPath();
16
String PartyId =
xpath.evaluate("Envelope/Body/createCustomerProfileAsyncRespo
nse/result/PartyId", document);
if ("".equals(PartyId) || PartyId == null) {
System.out.println("Service Errored. Parse
the Response to review the Error Message ");
} else {
System.out.println("Service Succeeded");
}
}
}
}
3.3 Testing the CustomerProfileService web service.
One-time step required for running any Java executable on a Windows

system is given below.
Download and install Java and set PATH system environment variable.
• Get the latest JDK version for appropriate operating system if Java
is not installed already.
• Install the Java from the executable.
• Note the path of the bin in the Java installation directory.
The default path is C:\Program Files\Java\jdkx.x.x\bin.
Set the System Environment variables.
• Right-click on 'My Computer' and select 'Properties'.

• Go to Advance System Setting.
• Click Environment Variable.
• Set the PATH variable:
If present double click it and append the bin path like
";C:\Program Files\Java\jdkx.x.x\bin;"
Else create a New Variable by clicking NEW.
Provide variable name as "Path" and Variable value as path of bin
directory
"C:\Program Files\Java\jdkx.x.x\bin;"
• Click OK.
Javac CustomerProfileInvoke.java – This generates the Java class file.

Java CustomerProfileInvoke – This invokes the service and prints the
output.
17
Output :
Invoking Customer Profile Web Service

Response received.
Service Succeeded.
The customer can be queried on the Fusion instance to review the customer
account profile.
3.4 Examples of Sample Payloads
3.4.1 Location Service Payloads

Request Payload
<soap:Envelope xmlns:soap="http://schemas.xmlsoap.org/soap/envelope/">
<soap:Body
xmlns:ns1="http://xmlns.oracle.com/apps/cdm/foundation/parties/locationSe
rvice/applicationModule/types/">
<ns1:createLocation>
<ns1:location
rvice/">
<ns2:Country>US</ns2:Country>
<ns2:Address1>Addr_1</ns2:Address1>
<ns2:City>Redwood City</ns2:City>
<ns2:PostalCode>94063</ns2:PostalCode>
<ns2:State>CA</ns2:State>
<ns2:CreatedByModule>AMS</ns2:CreatedByModule>
</ns1:location>
</ns1:createLocation>
</soap:Body>
</soap:Envelope>
Response Payload
LocationId will be returned if the service operation succeeds. The locationId returned is
to be used in createOrganization operation of OrganizationService.
<ns0:createLocationResponse xmlns=""
xmlns:env="http://schemas.xmlsoap.org/soap/envelope/"
rvice/applicationModule/types/"
xmlns:wsa="http://www.w3.org/2005/08/addressing"
xmlns:wsu="http://docs.oasis-open.org/wss/2004/01/oasis-200401-wss-
wssecurity-utility-1.0.xsd">
<ns2:result xmlns:ns0="http://xmlns.oracle.com/adf/svc/types/"
rvice/"
18
rvice/applicationModule/types/"
xmlns:ns3="http://xmlns.oracle.com/apps/cdm/foundation/parties/partyServi
ce/"
xmlns:ns4="http://xmlns.oracle.com/apps/cdm/foundation/parties/flex/locat
ion/" xmlns:tns="http://xmlns.oracle.com/adf/svc/errors/"
xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
xsi:type="ns1:LocationResult">
<ns1:Value>
<ns1:LocationId>300000006264317</ns1:LocationId>
<ns1:LastUpdateDate>2013-05-28T04:28:55.179-
05:00</ns1:LastUpdateDate>
<ns1:LastUpdatedBy>FIN_SUPERUSER</ns1:LastUpdatedBy>
<ns1:CreationDate>2013-05-28T04:28:55.001-
05:00</ns1:CreationDate>
<ns1:CreatedBy>FIN_SUPERUSER</ns1:CreatedBy>
<ns1:LastUpdateLogin>DDC0B3F873096E77E04374A017902784</ns1:LastUpdateLogi
n>
<ns1:RequestId xsi:nil="true"/>
<ns1:OrigSystem xsi:nil="true"/>
<ns1:OrigSystemReference>300000006264317</ns1:OrigSystemReference>
<ns1:Country>US</ns1:Country> <ns1:Address1>Avinash-
_SHAN1</ns1:Address1>
<ns1:Address2 xsi:nil="true"/> <ns1:Address3
xsi:nil="true"/>
<ns1:Address4 xsi:nil="true"/> <ns1:City>Redwood
City</ns1:City>
<ns1:Province xsi:nil="true"/>
<ns1:County xsi:nil="true"/>
<ns1:AddressStyle xsi:nil="true"/>
<ns1:ValidatedFlag>false</ns1:ValidatedFlag>
<ns1:AddressLinesPhonetic xsi:nil="true"/>
<ns1:PostalPlus4Code xsi:nil="true"/>
<ns1:Position xsi:nil="true"/>
<ns1:LocationDirections xsi:nil="true"/>
<ns1:AddressEffectiveDate xsi:nil="true"/>
<ns1:AddressExpirationDate xsi:nil="true"/>
<ns1:ClliCode xsi:nil="true"/>
<ns1:Language xsi:nil="true"/>
<ns1:ShortDescription xsi:nil="true"/>
<ns1:Description xsi:nil="true"/>
<ns1:SalesTaxGeocode xsi:nil="true"/>
<ns1:SalesTaxInsideCityLimits>1</ns1:SalesTaxInsideCityLimits>
<ns1:FaLocationId xsi:nil="true"/>
<ns1:ObjectVersionNumber>1</ns1:ObjectVersionNumber>
<ns1:GeometryStatusCode>DIRTY</ns1:GeometryStatusCode>
<ns1:ValidationStatusCode xsi:nil="true"/>
<ns1:DateValidated xsi:nil="true"/>
<ns1:DoNotValidateFlag xsi:nil="true"/>
<ns1:Comments xsi:nil="true"/>
<ns1:HouseType xsi:nil="true"/>
<ns1:EffectiveDate>2013-05-27</ns1:EffectiveDate>
<ns1:AddrElementAttribute1 xsi:nil="true"/>
<ns1:Building xsi:nil="true"/>
19
<ns1:FloorNumber xsi:nil="true"/>
<ns1:StatusFlag>true</ns1:StatusFlag>
<ns1:InternalFlag>false</ns1:InternalFlag>
<ns1:TimezoneCode xsi:nil="true"/>
</ns1:Value>
</ns2:result>
</ns0:createLocationResponse>
3.4.2 Organization Service Payloads

Request Payload
<soap:Body
xmlns:ns1="http://xmlns.oracle.com/apps/cdm/foundation/parties/organizati
onService/applicationModule/types/">
<ns1:createOrganization>
<ns1:organizationParty
onService/">
<ns2:PartyUsageAssignment
ce/">
<ns3:PartyUsageCode>CUSTOMER</ns3:PartyUsageCode>
</ns2:PartyUsageAssignment>
<ns2:OrganizationProfile>
<ns2:OrganizationName>Company1</ns2:OrganizationName>
<ns2:CeoName>CEO1</ns2:CeoName>
</ns2:OrganizationProfile>
<ns2:Relationship
xmlns:ns14="http://xmlns.oracle.com/apps/cdm/foundation/parties/relations
hipService/">
<ns14:SubjectType>ORGANIZATION</ns14:SubjectType>
<ns14:SubjectTableName>HZ_PARTIES</ns14:SubjectTableName>
<ns14:ObjectId>300100031265398</ns14:ObjectId>
<ns14:ObjectType>PERSON</ns14:ObjectType>
<ns14:ObjectTableName>HZ_PARTIES</ns14:ObjectTableName>
<ns14:RelationshipCode>EMPLOYER_OF</ns14:RelationshipCode>
<ns14:RelationshipType>EMPLOYMENT</ns14:RelationshipType>
<ns14:Comments>TestComments</ns14:Comments>
<ns14:StartDate>2020-10-10</ns14:StartDate>
<ns14:EndDate>2020-11-11</ns14:EndDate>
<ns14:AdditionalInformation1>TestAdditionalInfo</ns14:AdditionalInformati
on1>
<ns14:PercentageOwnership>14</ns14:PercentageOwnership>
<ns14:CurrencyCode>USD</ns14:CurrencyCode>
<ns14:CurcyConvRateType>Corporate</ns14:CurcyConvRateType>
<ns14:CorpCurrencyCode>USD</ns14:CorpCurrencyCode>
</ns2:Relationship>
<ns2:PartySite
xmlns:ns28="http://xmlns.oracle.com/apps/cdm/foundation/parties/partyServ
ice/">
<ns28:Mailstop>Test</ns28:Mailstop>
20
<ns28:IdentifyingAddressFlag>true</ns28:IdentifyingAddressFlag>
<ns28:Language>US</ns28:Language>
<ns28:PartySiteName>Site1</ns28:PartySiteName>
<ns28:Addressee>SiteName Address</ns28:Addressee>
<ns28:Comments>Test</ns28:Comments>
<ns28:OriginalSystemReference>
<ns28:OrigSystem>CSV</ns28:OrigSystem>
<ns28:OrigSystemReference>SiteRef</ns28:OrigSystemReference>
<ns28:OwnerTableName>HZ_PARTY_SITES</ns28:OwnerTableName>
</ns28:OriginalSystemReference>
<ns28:PartySiteUse>
<ns28:Comments>Comments</ns28:Comments>
<ns28:SiteUseType>BILL_TO</ns28:SiteUseType>
</ns28:PartySiteUse>
</ns2:PartySite>
</ns1:organizationParty>
</ns1:createOrganization>
</soap:Body>
</soap:Envelope>
Response Payload
PartyId and PartySiteId will be returned if the service operation succeeds. The PartyId
and PartySiteId returned is to be used in createCustomerAccount operation of
CustomerAccountService.
<ns0:createOrganizationResponse xmlns=""
onService/applicationModule/types/"
onService/"
onService/applicationModule/types/"
ce/"
xmlns:ns4="http://xmlns.oracle.com/apps/cdm/foundation/parties/contactPoi
ntService/"
xmlns:ns8="http://xmlns.oracle.com/apps/cdm/foundation/parties/relationsh
ipService/" xmlns:tns="http://xmlns.oracle.com/adf/svc/errors/"
xsi:type="ns1:OrganizationPartyResult">
<ns1:Value>
<ns1:PartyNumber>14005</ns1:PartyNumber>
<ns1:PartyId>300000006097238</ns1:PartyId>
<ns1:PartyType>ORGANIZATION</ns1:PartyType>
21
<ns1:PartyName>Nam1</ns1:PartyName>
<ns1:ValidatedFlag xsi:nil="true"/>
<ns1:LastUpdateLogin>DDD47E2734117F08E0432D3CF50A3495</ns1:LastUpdateLogi
n>
<ns1:CreationDate>2013-05-28T21:20:01.0-07:00</ns1:CreationDate>
<ns1:HQBranchIndicator xsi:nil="true"/>
<ns1:DUNSNumberC xsi:nil="true"/>
<ns1:SICCode xsi:nil="true"/>
<ns1:JgzzFiscalCode xsi:nil="true"/>
<ns1:Address1>Avinash-_OVMTest</ns1:Address1>
<ns1:Country>US</ns1:Country>
<ns1:Address3 xsi:nil="true"/>
<ns1:GroupType xsi:nil="true"/>
<ns1:Status>A</ns1:Status>
<ns1:City>Redwood City</ns1:City>
<ns1:County xsi:nil="true"/>
<ns1:YearEstablished xsi:nil="true"/>
<ns1:Province xsi:nil="true"/>
<ns1:URL xsi:nil="true"/>
<ns1:AnalysisFy xsi:nil="true"/>
<ns1:SICCodeType xsi:nil="true"/>
<ns1:EmailAddress xsi:nil="true"/>
<ns1:FiscalYearendMonth xsi:nil="true"/>
<ns1:EmployeesTotal xsi:nil="true"/>
<ns1:CurrentFiscalYearPotentialRevenueAmount xsi:nil="true"/>
<ns1:NextFyPotentialRevenueAmount xsi:nil="true"/>
<ns1:GSAIndicatorFlag xsi:nil="true"/>
<ns1:CategoryCode xsi:nil="true"/>
<ns1:LanguageName xsi:nil="true"/>
<ns1:MissionStatement xsi:nil="true"/>
<ns1:ThirdPartyFlag xsi:nil="true"/>
<ns1:HomeCountry xsi:nil="true"/>
<ns1:CertificationLevel xsi:nil="true"/>
<ns1:CertReasonCode xsi:nil="true"/>
<ns1:PrimaryPhonePurpose xsi:nil="true"/>
<ns1:PrimaryPhoneContactPointId xsi:nil="true"/>
<ns1:PrimaryPhoneLineType xsi:nil="true"/>
<ns1:PrimaryPhoneCountryCode xsi:nil="true"/>
<ns1:PrimaryPhoneAreaCode xsi:nil="true"/>
<ns1:PrimaryPhoneNumber xsi:nil="true"/>
<ns1:PreferredContactMethod xsi:nil="true"/>
<ns1:PrimaryPhoneExtension xsi:nil="true"/>
<ns1:IdenAddrLocationId>300000006097201</ns1:IdenAddrLocationId>
<ns1:PrimaryURLContactPointId xsi:nil="true"/>
<ns1:PrimaryEmailContactPointId xsi:nil="true"/>
<ns1:IdenAddrPartySiteId>300000006097240</ns1:IdenAddrPartySiteId>
<ns1:PreferredName xsi:nil="true"/>
22
<ns1:PersonSecondLastName xsi:nil="true"/>
<ns1:PreferredNameId xsi:nil="true"/>
<ns1:TradingPartnerIdentifier xsi:nil="true"/>
<ns1:PreferredContactPersonId xsi:nil="true"/>
<ns1:PreferredFunctionalCurrency xsi:nil="true"/>
<ns1:InternalFlag xsi:nil="true"/>
<ns1:CeoName>CEO1<ns1:CeoName>
<ns1:PrincipalName xsi:nil="true"/>
<ns1:OrganizationSize xsi:nil="true"/>
<ns1:PartyUniqueName>Name1</ns1:PartyUniqueName>
<ns1:OrganizationProfile
xmlns:ns2="http://xmlns.oracle.com/apps/cdm/foundation/parties/flex/organ
ization/">
<ns1:OrganizationProfileId>300000006097239</ns1:OrganizationProfileId>
<ns1:OrganizationName>Name1</ns1:OrganizationName>
<ns1:EnquiryDUNS xsi:nil="true"/>
<ns1:CeoName>ceo1</ns1:CeoName>
<ns1:CeoTitle xsi:nil="true"/>
<ns1:PrincipalName xsi:nil="true"/>
<ns1:PrincipalTitle xsi:nil="true"/>
<ns1:LegalStatus xsi:nil="true"/>
<ns1:ControlYr xsi:nil="true"/>
<ns1:EmployeesTotal xsi:nil="true"/>
<ns1:HQBranchIndicator xsi:nil="true"/>
<ns1:BranchFlag xsi:nil="true"/>
<ns1:OobInd xsi:nil="true"/>
<ns1:LineOfBusiness xsi:nil="true"/>
<ns1:CongDistCode xsi:nil="true"/>
<ns1:ImportInd xsi:nil="true"/>
<ns1:ExportInd xsi:nil="true"/>
<ns1:LaborSurplusInd xsi:nil="true"/>
<ns1:MinorityOwnedInd xsi:nil="true"/>
<ns1:MinorityOwnedType xsi:nil="true"/>
<ns1:WomanOwnedInd xsi:nil="true"/>
<ns1:Disadv8aInd xsi:nil="true"/>
<ns1:SmallBusInd xsi:nil="true"/>
<ns1:RentOwnInd xsi:nil="true"/>
<ns1:DbRating xsi:nil="true"/>
<ns1:GSAIndicatorFlag xsi:nil="true"/>
<ns1:JgzzFiscalCode xsi:nil="true"/>
<ns1:AnalysisFy xsi:nil="true"/>
<ns1:FiscalYearendMonth xsi:nil="true"/>
<ns1:CurrentFiscalYearPotentialRevenueAmount xsi:nil="true"/>
<ns1:NextFyPotentialRevenueAmount xsi:nil="true"/>
<ns1:YearEstablished xsi:nil="true"/>
<ns1:MissionStatement xsi:nil="true"/>
<ns1:OrganizationType xsi:nil="true"/>
<ns1:BusinessScope xsi:nil="true"/>
<ns1:CorporationClass xsi:nil="true"/>
<ns1:LocalBusIdenType xsi:nil="true"/>
<ns1:LocalBusIdentifier xsi:nil="true"/>
<ns1:PreferredFunctionalCurrency xsi:nil="true"/>
<ns1:RegistrationType xsi:nil="true"/>
<ns1:TotalEmployeesText xsi:nil="true"/>
<ns1:TotalEmployeesInd xsi:nil="true"/>
<ns1:TotalEmployeesEstimatedIndicator xsi:nil="true"/>
<ns1:TotalEmployeesMinimumIndicator xsi:nil="true"/>
<ns1:ParentSubInd xsi:nil="true"/>
<ns1:IncorpYear xsi:nil="true"/>
23
n>
<ns1:ContentSourceNumber xsi:nil="true"/>
<ns1:EffectiveStartDate>2013-05-28</ns1:EffectiveStartDate>
<ns1:EffectiveEndDate>4712-12-31</ns1:EffectiveEndDate>
<ns1:PublicPrivateOwnershipFlag xsi:nil="true"/>
<ns1:LocalActivityCodeType xsi:nil="true"/>
<ns1:LocalActivityCode xsi:nil="true"/>
<ns1:EmployeesAtPrimaryAddress xsi:nil="true"/>
<ns1:EmployeesAtPrimaryAddressText xsi:nil="true"/>
<ns1:EmployeesAtPrimaryAddressEstimation xsi:nil="true"/>
<ns1:EmployeesAtPrimaryAddressMinimum xsi:nil="true"/>
<ns1:InternalFlag xsi:nil="true"/>
<ns1:TotalPaymentAmount xsi:nil="true"/>
<ns1:DisplayedDUNSPartyIdentifier xsi:nil="true"/>
<ns1:BankOrBranchNumber xsi:nil="true"/>
<ns1:BankCode xsi:nil="true"/>
<ns1:BranchCode xsi:nil="true"/>
<ns1:DoNotConfuseWith xsi:nil="true"/>
<ns1:HomeCountry xsi:nil="true"/>
<ns1:GrowthStrategyDescription xsi:nil="true"/>
<ns1:SeblUserKeyLoc xsi:nil="true"/>
<ns1:StockSymbol xsi:nil="true"/>
<ns1:TradingPartnerIdentifier xsi:nil="true"/>
<ns1:EffectiveSequence>1</ns1:EffectiveSequence>
<ns1:EffectiveLatestChange>Y</ns1:EffectiveLatestChange>
<ns1:OrganizationSize xsi:nil="true"/>
<ns1:SuffixOverriddenFlag>false</ns1:SuffixOverriddenFlag>
<ns1:UniqueNameAlias>Indian
AutomobCompany</ns1:UniqueNameAlias>
<ns1:UniqueNameSuffix xsi:nil="true"/>
<ns1:DomesticUltimateDUNSNumberC xsi:nil="true"/>
<ns1:GlobalUltimateDUNSNumberC xsi:nil="true"/>
<ns1:ParentDUNSNumberC xsi:nil="true"/>
<ns1:CurrencyCode xsi:nil="true"/>
</ns1:OrganizationProfile>
<ns1:PartySite
xmlns:ns7="http://xmlns.oracle.com/apps/cdm/foundation/parties/flex/party
Site/">
<ns3:PartySiteId>300000006097240</ns3:PartySiteId>
<ns3:PartySiteNumber>6004</ns3:PartySiteNumber>
24
n>
<ns3:StartDateActive>2013-05-28</ns3:StartDateActive>
<ns3:EndDateActive>4712-12-31</ns3:EndDateActive>
<ns3:Mailstop>Test</ns3:Mailstop>
<ns3:IdentifyingAddressFlag>true</ns3:IdentifyingAddressFlag>
<ns3:PartySiteName>Site1</ns3:PartySiteName>
<ns3:Addressee>Addresse</ns3:Addressee>
<ns3:GlobalLocationNumber xsi:nil="true"/>
<ns3:Comments>Test</ns3:Comments>
<ns3:PartySiteType xsi:nil="true"/>
<ns3:PartyNameDba xsi:nil="true"/>
<ns3:PartyNameDivision xsi:nil="true"/>
<ns3:PartyNameLegal xsi:nil="true"/>
<ns3:RelationshipId xsi:nil="true"/>
<ns3:PartyUsageCode xsi:nil="true"/>
<ns3:UsageCode>GEOGRAPHY</ns3:UsageCode>
<ns3:Country1>US</ns3:Country1>
<ns3:ObjectVersionNumber1>1</ns3:ObjectVersionNumber1>
<ns3:OriginalSystemReference
xmlns:ns5="http://xmlns.oracle.com/apps/cdm/foundation/parties/flex/sourc
eSystemRef/">
<ns3:OrigSystemReferenceId>300000006097241</ns3:OrigSystemReferenceId>
<ns3:OrigSystem>CSV</ns3:OrigSystem>
<ns3:OrigSystemReference>SiteRef</ns3:OrigSystemReference>
<ns3:OwnerTableName>HZ_PARTY_SITES</ns3:OwnerTableName>
<ns3:OwnerTableId>300000006097240</ns3:OwnerTableId>
<ns3:ReasonCode xsi:nil="true"/>
<ns3:OldOrigSystemReference xsi:nil="true"/>
<ns3:StartDateActive>2013-05-28</ns3:StartDateActive>
<ns3:EndDateActive>4712-12-31</ns3:EndDateActive>
n>
<ns3:PartyId xsi:nil="true"/>
25
</ns3:OriginalSystemReference>
<ns3:PartySiteUse>
<ns3:PartySiteUseId>300000006097242</ns3:PartySiteUseId>
<ns3:BeginDate>2013-05-28</ns3:BeginDate>
<ns3:Comments>Comments</ns3:Comments>
n>
<ns3:IntegrationKey>x</ns3:IntegrationKey>
<ns3:SiteUseType>BILL_TO</ns3:SiteUseType>
<ns3:PrimaryPerType>Y</ns3:PrimaryPerType>
</ns3:PartySiteUse>
</ns1:PartySite>
<ns1:PartyUsageAssignment>
<ns3:PartyUsgAssignmentId>300000006097243</ns3:PartyUsgAssignmentId>
<ns3:PartyUsageCode>CUSTOMER</ns3:PartyUsageCode>
<ns3:EffectiveStartDate>2013-05-28</ns3:EffectiveStartDate>
<ns3:EffectiveEndDate>4712-12-31</ns3:EffectiveEndDate>
<ns3:StatusFlag>true</ns3:StatusFlag>
<ns3:OwnerTableName xsi:nil="true"/>
<ns3:OwnerTableId xsi:nil="true"/>
n>
</ns1:PartyUsageAssignment>
<ns1:Relationship
xmlns:ns10="http://xmlns.oracle.com/apps/cdm/foundation/parties/flex/rela
tionship/">
<ns8:RelationshipRecId>300000006097244</ns8:RelationshipRecId>
<ns8:RelationshipId>300000006097245</ns8:RelationshipId>
<ns8:SubjectId>300000006097238</ns8:SubjectId>
<ns8:SubjectType>ORGANIZATION</ns8:SubjectType>
<ns8:SubjectTableName>HZ_PARTIES</ns8:SubjectTableName>
<ns8:ObjectId>300000006097203</ns8:ObjectId>
<ns8:ObjectType>PERSON</ns8:ObjectType>
<ns8:ObjectTableName>HZ_PARTIES</ns8:ObjectTableName>
<ns8:RelationshipCode>EMPLOYER_OF</ns8:RelationshipCode>
26
<ns8:RelationshipType>EMPLOYMENT</ns8:RelationshipType>
<ns8:Comments>TestComments</ns8:Comments>
n>
<ns8:AdditionalInformation1>TestAdditionalInfo</ns8:AdditionalInformation
1>
<ns8:AdditionalInformation2 xsi:nil="true"/>
<ns8:DirectionCode>C</ns8:DirectionCode>
<ns8:PercentageOwnership>14</ns8:PercentageOwnership>
<ns8:ObjectUsageCode xsi:nil="true"/>
<ns8:SubjectUsageCode xsi:nil="true"/>
</ns1:Relationship>
</ns1:Value>
</ns2:result>
</ns0:createOrganizationResponse>
27
3.4.3 Customer Account Service Payloads
Request Payload
<soap:Body
xmlns:ns1="http://xmlns.oracle.com/apps/cdm/foundation/parties/customerAc
countService/applicationModule/types/">
<ns1:createCustomerAccount>
<ns1:customerAccount
xmlns:ns2="http://xmlns.oracle.com/apps/cdm/foundation/parties/customerAc
countService/">
<ns2:AccountNumber>Account1</ns2:AccountNumber>
<ns2:CustomerAccountSite>
<ns2:SetId>300000000571001</ns2:SetId>
<ns2:CustomerAccountSiteUse>
<ns2:SiteUseCode>BILL_TO</ns2:SiteUseCode>
</ns2:CustomerAccountSiteUse>
</ns2:CustomerAccountSite>
</ns1:customerAccount>
</ns1:createCustomerAccount>
</soap:Body>
</soap:Envelope>
Response Payload
CustomerAccountId will be returned if the invocation succeeds. The customerAccountId

returned and the PartyId returned from OrganizationService is to be used while creating the
customer profile using createCustomerProfile operation of CustomerProfileService.
<ns0:CreateCustomerAccountResponse xmlns=""
xmlns:ns0="http://xmlns.oracle.com/apps/cdm/foundation/parties/customerAccountService/applica
tionModule/types/" xmlns:wsa="http://www.w3.org/2005/08/addressing"
xmlns:wsu="http://docs.oasis-open.org/wss/2004/01/oasis-200401-wss-wssecurity-utility-1.0.xsd">
xmlns:ns2="http://xmlns.oracle.com/apps/cdm/foundation/parties/customerAccountService/"
xmlns:ns4="http://xmlns.oracle.com/apps/cdm/foundation/parties/partyService/"
xmlns:ns9="http://xmlns.oracle.com/apps/cdm/foundation/parties/flex/custAccount/"
xmlns:tns="http://xmlns.oracle.com/adf/svc/errors/"
xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xsi:type="ns2:CustomerAccountResult">
<ns2:Value>
<ns2:CustomerAccountId>300000006274225</ns2:CustomerAccountId>
<ns2:LastUpdateDate>2013-05-29T10:21:58.43-05:00</ns2:LastUpdateDate>
<ns2:AccountNumber>GitHub Account</ns2:AccountNumber>
<ns2:LastUpdateLogin>DDD9A07244D41EDCE04375A017907AEE</ns2:LastUpdateLogin>
28
<ns2:CustomerType xsi:nil="true"/>
<ns2:CustomerClassCode xsi:nil="true"/>
<ns2:TaxCode xsi:nil="true"/>
<ns2:TaxHeaderLevelFlag xsi:nil="true"/>
<ns2:TaxRoundingRule xsi:nil="true"/>
<ns2:CoterminateDayMonth xsi:nil="true"/>
<ns2:AccountEstablishedDate>2013-05-29</ns2:AccountEstablishedDate>
<ns2:AccountTerminationDate>4712-12-31</ns2:AccountTerminationDate>
<ns2:HeldBillExpirationDate xsi:nil="true"/>
<ns2:HoldBillFlag>false</ns2:HoldBillFlag>
<ns2:AccountName xsi:nil="true"/>
<ns2:DepositRefundMethod xsi:nil="true"/>
<ns2:NpaNumber xsi:nil="true"/>
<ns2:SourceCode xsi:nil="true"/>
<ns2:DateTypePreference xsi:nil="true"/>
<ns2:ArrivalsetsIncludeLinesFlag xsi:nil="true"/>
<ns2:StatusUpdateDate xsi:nil="true"/>
<ns2:AutopayFlag xsi:nil="true"/>
<ns2:LastBatchId xsi:nil="true"/>
<ns2:SellingPartyId xsi:nil="true"/>
<ns2:CustomerAccountSite
xmlns:ns7="http://xmlns.oracle.com/apps/cdm/foundation/parties/flex/custAccountSite/">
<ns2:CustomerAccountSiteId>300000006274226</ns2:CustomerAccountSiteId>
<ns2:BillToIndicator>P</ns2:BillToIndicator>
<ns2:MarketIndicator>N</ns2:MarketIndicator>
<ns2:ShipToIndicator>N</ns2:ShipToIndicator>
<ns2:CustomerCategoryCode xsi:nil="true"/>
<ns2:KeyAccountFlag xsi:nil="true"/>
<ns2:TpHeaderId xsi:nil="true"/>
<ns2:EceTpLocationCode xsi:nil="true"/>
<ns2:TranslatedCustomerName xsi:nil="true"/>
<ns2:SetId>300000000571001</ns2:SetId>
<ns2:SetCode>Vision Operations SET</ns2:SetCode>
<ns2:CustomerAccountSiteUse
xmlns:ns6="http://xmlns.oracle.com/apps/cdm/foundation/parties/flex/custAccountSiteUse/">
<ns2:SiteUseId>300000006274227</ns2:SiteUseId>
<ns2:CustomerAccountSiteId>300000006274226</ns2:CustomerAccountSiteId>
<ns2:SiteUseCode>BILL_TO</ns2:SiteUseCode>
<ns2:PrimaryFlag>true</ns2:PrimaryFlag>
29
<ns2:Location>4003</ns2:Location>
<ns2:BillToSiteUseId xsi:nil="true"/>
<ns2:SICCode xsi:nil="true"/>
<ns2:PaymentTermId xsi:nil="true"/>
<ns2:GSAIndicator xsi:nil="true"/>
<ns2:TerritoryId xsi:nil="true"/>
<ns2:TaxReference xsi:nil="true"/>
<ns2:SortPriority xsi:nil="true"/>
<ns2:TaxCode xsi:nil="true"/>
<ns2:SecondLastAccrueChargeDate xsi:nil="true"/>
<ns2:LastAccrueChargeDate xsi:nil="true"/>
<ns2:LastUnaccrueChargeDate xsi:nil="true"/>
<ns2:SecondLastUnaccrueChrgDate xsi:nil="true"/>
<ns2:TaxHeaderLevelFlag xsi:nil="true"/>
<ns2:FinchrgReceivablesTrxId xsi:nil="true"/>
<ns2:TaxRoundingRule xsi:nil="true"/>
<ns2:TaxClassification xsi:nil="true"/>
<ns2:SetId>300000000571001</ns2:SetId>
</ns2:CustomerAccountSiteUse>
</ns2:CustomerAccountSite>
</ns2:Value>
</ns0:result>
</ns0:CreateCustomerAccountResponse>
3.4.4 Customer Profile Service Payloads

Request Payload
<soap:Envelope xmlns:soap="http://schemas.xmlsoap.org/soap/envelope>
<soap:Body>
<ns1:createCustomerProfile
xmlns:ns1="http://xmlns.oracle.com/apps/financials/receivables/customers/
customerProfileService/types/">
<ns1:customerProfile
customerProfileService/">
</ns1:customerProfile>
</ns1:createCustomerProfile>
</soap:Body>
</soap:Envelope>
30
Response Payload
The Response payload will contain the customer profile attributes if the invocation
succeeds.
<ns0:createCustomerProfileResponse xmlns=""
customerProfileService/types/"
customerProfileService/"
customerProfileService/types/"
xmlns:tns="http://xmlns.oracle.com/adf/svc/errors/"
xsi:type="ns1:CustomerProfileResult">
<ns1:Value>
</ns1:Value>
</ns2:result>
</ns0:createCustomerProfileResponse>
3.5 Accessing WSDL URL
To get the physical end point of any given instance:
 Launch the home page and log in with a functional user.

 Navigate to an application's dashboard/workarea page that belongs to Customer
Profile Service.
For example: In case of Customer Profile Service navigate to
Receivables Billing. A URL will be displayed in the browser similar to
https://<domainname>/receivables/faces/TransactionsWorkArea
The <domainname> might be like https://<pod-
name>.<lba>.xxx.oraclecloud.com.
 In this URL, use https://<domainname>.
http://<fin_server:PortNumber>/finArCustomers/CustomerProfileService
 The part "http://<fin_server:PortNumber>" is dynamic for every environment
whereas "/finArCustomers/CustomerProfileService" is static for a given service
version.
31
 https://<domainname>/finArCustomers/CustomerProfileService is the WSDL
URL for Customer Profile Service.
32

Fin CustomerProfileServiceAM

Uploaded by

Document Information

Copyright

Available Formats

Share this document

Share or Embed Document

Sharing Options

Did you find this document useful?

Is this content inappropriate?

Copyright:

Available Formats

Fin CustomerProfileServiceAM

Uploaded by

Copyright:

Available Formats

Usage Notes for Receivables Customer Profile Service

2 Service Details ............................................................................................................................................ 4

2.1 Supported Operations......................................................................................................................... 4

2.2 Setups and Security............................................................................................................................. 4

2.3 Related Services .................................................................................................................................. 5

2.3.1 Location Service ........................................................................................................................... 5

2.3.2 Organization Service .................................................................................................................... 6

2.3.3 Customer Account Service ........................................................................................................... 6

2.5 Service Data Objects ........................................................................................................................... 8

2.6 Error Handling ................................................................................................................................... 10

3.1 Sample of the Service Client Java code. ............................................................................................ 11

3.2 Sample of the CustomerProfileInvoke.java code.............................................................................. 16

3.3 Testing the CustomerProfileService web service.............................................................................. 17

3.4 Examples of Sample Payloads ........................................................................................................... 18

3.4.1 Location Service Payloads .......................................................................................................... 18

3.4.2 Organization Service Payloads ................................................................................................... 20

3.4.3 Customer Account Service Payloads .......................................................................................... 28

3.4.4 Customer Profile Service Payloads............................................................................................. 30

3.5 Accessing WSDL URL ......................................................................................................................... 31

The asynchronous requests to Oracle web service are placed in a processing

2.2 Setups and Security

2.3 Related Services

A customer with an account is required to be present in the system in order to attach an

2.3.1 Location Service

Web Service Description Language:

Operation that supports creation of a location: createLocation.

Web Service Description Language:

Operation that supports creation of an organization: createOrganization.

2.3.3 Customer Account Service

Web Service Description Language:

Operation that supports creation of a customer account: createCustomerAccount.

Review the CustomerAccountService documentation in the SOAP Web Services for

Step 2: Use WSDL to write a java class (for example, CustomerProfileServiceClient.java)

Step 3: Prepare the Keystore information for certificate authentication.

Step 4: Integrate the CustomerProfileServiceClient.java class to the source system to

• Set the input parameters

• Set the Security information

• Parse the service response and handling error messages

Sample code for invocation of the CustomerProfileServiceClient is available in

Step 5: Test the CustomerProfileService web service.

• Install Java and set PATH system

Details of the testing are available in Appendix 3.3

2.5 Service Data Objects

 Receivables Customer Profile SDO

Attribute Name Attribute Description Data Type Required

Receivables Customer Profile Flexfield SDO

Attribute Name Attribute Description Required

_Num_Of_Segments Number of Segments for the java.lang.Integer No.

SOAP faults can be one of the following types:

Receivables Customer Profile Service Error Messages Table

Message Name Message Text

HZ_API_NO_A_PTY The party is either inactive or does not exist.

Cannot find the default customer profile class. Use a different

The customer profile class is inactive. Select another profile

public class CustomerProfileServiceClient {

private static String serviceURL;

public static String httpPost(String destUrl, String postData,

// Setting the KeyStore Properties

// Open the HTTP connection and set the connection properties

URL url = new URL(destUrl);

byte[] authBytes = authStr.getBytes("UTF-8");

OutputStream out = conn.getOutputStream();

// Read the response and return it to the calling Java API

String response = null;