Sales Party Territory service

Logical Business Objects

CRM : Customer Center : Sales Party

Relationships

The following table describes how this service data object is related to other service data objects or business object services.

Relationship Type	Object or Service
Handles	Trading Community Organization Profile Additional Information
Handles	Financial Profile
Handles	Trading Community Address Purpose
Handles	Trading Community Address Additional Information
Handles	E-Mail
Handles	Account
Handles	Phone
Handles	Trading Community Organization Details
Handles	Electronic Data Interchange
Handles	Trading Community Relationship Additional Information
Handles	Instant Messaging
Handles	Classification Assignment
Handles	Additional Account Name
Handles	Certification
Handles	Education
Handles	Trading Community Contact Point Additional Information
Handles	Citizenship
Handles	Contact Preference
Handles	Contact
Handles	Household
Handles	Contact Language
Handles	Credit Rating
Handles	Electronic File Transfer
Handles	Usage Assignment
Handles	Contact Interest
Handles	Customer Contact Responsibility
Handles	Additional Identifier
Handles	Sales Party Territory
Handles	Employment History
Handles	Financial Report
Handles	Financial Number
Handles	Customer Contact Profile
Handles	Contact Address
Handles	Trading Community Person Details
Handles	Additional Household Name
Handles	Trading Community Organization Contact Additional Information
Handles	Web
Handles	Source System Reference
Handles	Trading Community Original System Mapping Identifier Additional Information
Handles	E-Mail Domain
Handles	Work Class
Handles	Telex
Handles	Trading Community Person Profile Additional Information
Handles	Additional Contact Name
Handles	Relationship
Handles	Address
Handles	Preference

getSalesPartyTerritory

The get operation for sales party territory details.

Life Cycle Status: Active

Request Payload

Element Name	Type	Description
partyTerritoryId	long	The identifier for sales party territory.

Response Payload

Element Name	Type	Description
result	Sales Party Territory	The operation that returns sales party territory details that matches the inbound key attributes.

createSalesPartyTerritory

The operation that creates sales party territory details for a party.

Life Cycle Status: Active

Request Payload

Element Name	Type	Description
salesPartyTerritory	Sales Party Territory	Sales Party Territory Details to be created

Response Payload

Element Name	Type	Description
result	Sales Party Territory	The result of the operation including the successfully created sales party territories and any warnings or informational messages.

updateSalesPartyTerritory

The operation to update sales party territory details.

Life Cycle Status: Active

Request Payload

Element Name	Type	Description
salesPartyTerritory	Sales Party Territory	Sales Party Territory Details to be updated

Response Payload

Element Name	Type	Description
result	Sales Party Territory	The result of the operation includes the successfully updated sales party territory details or a list of warnings or informational messages, or both.

deleteSalesPartyTerritory

The operation that deletes sales party territory details.

Life Cycle Status: Active

Request Payload

Element Name	Type	Description
salesPartyTerritory	Sales Party Territory	Sales Party Territory Details to be deleted

Response Payload

Element Name	Type	Description
result	void	A list of warnings or informational messages encountered when deleting the object.

findSalesPartyTerritory

The find operation for sales party territory details.

Life Cycle Status: Active

Request Payload

Element Name	Type	Description
findCriteria	{http://xmlns.oracle.com/adf/svc/types/}FindCriteria	The criteria used to limit your query result, such as the filter (or where clause), the fetch size, and so on.
findControl	{http://xmlns.oracle.com/adf/svc/types/}FindControl	This operation is currently not in use.

Response Payload

Element Name	Type	Description
result	Sales Party Territory	The result of the operation including the list of sales party territory details that satisfy the inbound criteria and any warnings or informational messages encountered during the invocation.

findTerritoriesOfSalesParty

The find operation for sales party details filtered by party identifier. Get a list of territories this sales party belongs to. Get the complete territory data object. This is a composite service.

Life Cycle Status: Active

Request Payload

Element Name	Type	Description
findCriteria	{http://xmlns.oracle.com/adf/svc/types/}FindCriteria	The criteria used to limit your query result, such as the filter (or where clause), the fetch size, and so on.
BindPartyId	long	The find operation for party identifier.
findControl	{http://xmlns.oracle.com/adf/svc/types/}FindControl	This operation is currently not in use.

Response Payload

Element Name	Type	Description
result	Sales Party Territory	The result of the operation including the list of sales party territory details that satisfy the inbound criteria and any warnings or informational messages encountered during the invocation.

findSalesPartyOfTerritory

The find operation for sales party details filtered by territory identifier. Get a list of territories this sales party belongs to. Get the complete territory data object. This is a composite service.

Life Cycle Status: Active

Request Payload

Element Name	Type	Description
findCriteria	{http://xmlns.oracle.com/adf/svc/types/}FindCriteria	The criteria used to limit your query result, such as the filter (or where clause), the fetch size, and so on.
BindTerritoryId	long	The find operation for territory identifier.
findControl	{http://xmlns.oracle.com/adf/svc/types/}FindControl	This operation is currently not in use.

Response Payload

Element Name	Type	Description
result	Sales Party Territory	The result of the operation including the list of sales party territory details that satisfy the inbound criteria and any warnings or informational messages encountered during the invocation.

findSalesPartyTerritoriesHierarchy

The find operation for sales party details filtered by territory identifier. Get a list of territories this sales party belongs to. Get the complete territory data object. This is a composite service.

Life Cycle Status: Active

Request Payload

Element Name	Type	Description
findCriteria	{http://xmlns.oracle.com/adf/svc/types/}FindCriteria	The criteria used to limit your query result, such as the filter (or where clause), the fetch size, and so on.
BindTerritoryId	long	The find operation for territory identifier.
findControl	{http://xmlns.oracle.com/adf/svc/types/}FindControl	This operation is currently not in use.

Response Payload

Element Name	Type	Description
result	Sales Party Territory	The result of the operation including the list of sales party territory hierarchies that satisfy the inbound criteria and any warnings or informational messages encountered during the invocation.

getDfltObjAttrHints

An operation to retrieve user interface hints, such as the service data object label and object attribute labels, for the specified service data object and locale. As a prerequisite, invoke the getEntityList operation defined on this service to get the list of possible values for the viewName request payload element.

Life Cycle Status: Active

Request Payload

Element Name	Type	Description
viewName	string	The service view usage name, an internal name for the service data object. Specify the value of the <name> element from the getEntityList operation response payload.
localeName	string	The locale to use when evaluating locale-based user interface hints. The locale name is in ISO 639-1 format.

Response Payload

Element Name	Type	Description
result	{http://xmlns.oracle.com/adf/svc/types/}ObjAttrHints	The label and user interface hints for the specified service data object and its attributes in a name-value pair format.

getServiceLastUpdateTime

An operation that returns the date and time when the schema files referenced in the service definition last changed.

Life Cycle Status: Active

Request Payload

Response Payload

Element Name	Type	Description
result	{http://xmlns.oracle.com/adf/svc/types/}dateTime-Timestamp	The date and time when the service definition last changed in ISO 8601 format.

getEntityList

An operation to get the list of service data objects defined on this service.

Life Cycle Status: Active

Request Payload

Response Payload

Element Name	Type	Description
result	{http://xmlns.oracle.com/adf/svc/types/}ServiceViewInfo	A list of service data objects defined on this service. For each service data object, the result includes the QName, internal name, and Boolean values indicating whether create, update, merge, and delete operations can be performed on the object.

Security

The following tables list the privileges required to perform the service operations, and the duty roles that each privilege is granted to.

Service Operations to Privileges Mapping

Operation Name	Privilege Code	Privilege Name	Privilege Description
All Operations	ZCM_MANAGE_SALES_PARTY_TEAM_PRIV	Manage Sales Party Team	Allows managing the sales party team

Privileges to Duty Roles Mapping

Privilege Code	Granted to Duty Role Code	Granted to Duty Role Name	Granted To Duty Role Description
ZCM_MANAGE_SALES_PARTY_TEAM_PRIV	ORA_ZCM_SR_SALES_PARTY_MANAGEMENT	Service Sales Party Management	Can create Service Requests and help with resolution of the Service Request. Has basic Service Request management capabilities.
ZCM_MANAGE_SALES_PARTY_TEAM_PRIV	ORA_ZCM_MKTG_SALES_PARTY_MANAGEMENT_DUTY	Marketing Sales Party Management	Manages creation and maintenance of the sales organizations and consumers for internal marketing users. Additional duties include viewing of appointments, interactions, and customer contacts.
ZCM_MANAGE_SALES_PARTY_TEAM_PRIV	ORA_ZCM_PARTNER_SALES_PARTY_MANAGEMENT_DUTY	Partner Sales Party Management	Manages creation and maintenance of sales organizations and consumers for partners. Additional duties include viewing of opportunities and opportunity revenue, reviewing sales leads as well as appointments, interactions, and customer contacts. This role has limited access to customers and contacts.
ZCM_MANAGE_SALES_PARTY_TEAM_PRIV	ORA_ZCM_SALES_PARTY_MANAGEMENT_DUTY	Sales Party Management	Manages creation and maintenance of the sales organizations and consumers for internal sales users. Additional duties include viewing of opportunities and opportunity revenue, reviewing sales leads as well as appointments, interactions, and customer contacts.

Duty Roles to Duty or Job Roles Mapping

Duty Role Code	Granted to Duty or Job Role Code	Granted to Duty or Job Role Name	Granted To Duty or Job Role Description
ORA_ZCM_MKTG_SALES_PARTY_MANAGEMENT_DUTY	ORA_OKC_ALL_BUSINESS_UNITS_CONTRACT_INQUIRY_DUTY_CRM	Contract View Access Across All Contracts	Views all contracts across an enterprise.
ORA_ZCM_SALES_PARTY_MANAGEMENT_DUTY	ORA_ZCM_SALES_PARTY_REVIEW_DUTY	Sales Party Review	Allows resources read-only access to sales parties information such as manage customer work area and all sales party duties. Additional duties include view access to other customer and sales lead features.
ORA_ZCM_SALES_PARTY_MANAGEMENT_DUTY	ORA_MANAGE_TRADING_COMMUNITY_IMPORT_BATCH_DUTY	Trading Community Import Batch Management	Manages trading community data import batches.
ORA_ZCM_MKTG_SALES_PARTY_MANAGEMENT_DUTY	ORA_MANAGE_TRADING_COMMUNITY_IMPORT_BATCH_DUTY	Trading Community Import Batch Management	Manages trading community data import batches.