update site based Organization properties
post
/ccapp/v1/organizations/{id}/updateSiteOrganizationProperties
This operation is used to create/update site based organization proeprties in Oracle Commerce Cloud for a customer.
Request
Supported Media Types
- application/json
Path Parameters
-
id: string
The ID of the Organization for which site based properties has to be updated.
Root Schema : updateSiteOrganizationProperties_request
Type:
Show Source
object
-
siteOrganizationProperties:
array siteOrganizationProperties
Site Organizaiton properties
Example:
{
"siteOrganizationProperties":[
{
"site":{
"id":"site1"
},
"properties":{
"op":"remove",
"contract":null
}
},
{
"site":{
"id":"site2"
},
"properties":{
"approvalRequired":false,
"contract":{
"catalogId":"cloudCatalog",
"priceListGroupId":"defaultPriceGroup",
"displayName":"Us Motor Works Contract",
"description":"This is a written or spoken agreement, especially one concerning employment, sales, or tenancy, that is intended to be enforceable by law.",
"contract_terms":{
"terms":"All copyright, trade marks, design rights, patents and other intellectual property rights (registered and unregistered) belong to Us Motor Works Contract"
},
"externalContractReference":"UMWCUS001"
},
"delegateApprovalManagement":false,
"useExternalApprovalWebhook":false,
"orderPriceLimit":null
}
}
]
}
Nested Schema : items
Type:
Show Source
object
-
properties:
object properties
site based properties information
-
site:
object site
site information
Nested Schema : properties
Type:
object
site based properties information
Show Source
-
approvalRequired(optional):
boolean
Approval flag is required for the organization, by default it is set to false
-
contract:
object contract
Contract Info
-
delegateApprovalManagement(optional):
boolean
This flag indicates if the delegated admin has the provision of approval management, if set merchant admin cannot do any approval management.
-
op(optional):
string
A OP code parameter used to remove inheritance for a property, the supported value is 'remove'. If this op code is given and properties field has a some property like contract or orderPriceLimit then it will remove inheritance for that property (if exists), it will set NULL if no inheritance is found.
-
orderPriceLimit(optional):
number
Its order limit value for the organization, if order limit is more than this value then approval is needed for the order
-
useExternalApprovalWebhook(optional):
boolean
Flag to enable/disable Order Approval check from External Webhook
Nested Schema : site
Type:
object
site information
Show Source
-
id:
string
Id of the Site for which mapping is to be created/updated
Nested Schema : contract
Type:
object
Contract Info
Show Source
-
catalogId:
string
Catalog Id of the contract associated with account
-
contract_terms(optional):
object contract_terms
Terms & Conditions for contract
-
description(optional):
string
Description for contract
-
displayName:
string
Display name for contract
-
externalContractReference(optional):
string
External contract reference
-
priceListGroupId:
string
Price list group Id associated with account
Nested Schema : contract_terms
Type:
object
Terms & Conditions for contract
Show Source
-
terms(optional):
string
Terms & Conditions
Response
Supported Media Types
- application/json
200 Response
Following model is returned when operation succeeds.
Root Schema : updateSiteOrganizationProperties_response
Type:
Show Source
object
-
siteOrganizationProperties(optional):
array siteOrganizationProperties
Site Organizaiton properties
Nested Schema : items
Type:
Show Source
object
-
properties(optional):
object properties
site based properties information
-
site(optional):
object site
site information
Nested Schema : properties
Type:
object
site based properties information
Show Source
-
approvalRequired(optional):
boolean
Approval flag is required for the organization, by default it is set to false
-
contract(optional):
object contract
Contract Info
-
delegateApprovalManagement(optional):
boolean
This flag indicates if the delegated admin has the provision of approval management, if set merchant admin cannot do any approval management.
-
orderPriceLimit(optional):
number
Its order limit value for the organization, if order limit is more than this value then approval is needed for the order
-
useExternalApprovalWebhook(optional):
boolean
Flag to enable/disable Order Approval check from External Webhook
Nested Schema : site
Type:
object
site information
Show Source
-
enabled(optional):
boolean
The enabled flag for the site
-
id(optional):
string
The id for Site
-
name(optional):
string
The name for the site
-
productionURL(optional):
string
The production url of the site
Nested Schema : contract
Type:
object
Contract Info
Show Source
-
catalogId(optional):
string
Catalog Id of the contract associated with account
-
contract_terms(optional):
object contract_terms
Terms & Conditions for contract
-
description(optional):
string
Description for contract
-
displayName(optional):
string
Display name for contract
-
externalContractReference(optional):
string
External contract reference
-
priceListGroupId(optional):
string
Price list group Id associated with account
-
repositoryId(optional):
string
Repository Id of the contract
Nested Schema : contract_terms
Type:
object
Terms & Conditions for contract
Show Source
-
terms(optional):
string
Terms & Conditions
Example Response (application/json)
{
"siteOrganizationProperties":[
{
"site":{
"productionURL":null,
"name":"Site 2",
"id":"site2",
"enabled":false
},
"properties":{
"approvalRequired":false,
"contract":{
"catalogId":"cloudCatalog",
"priceListGroupId":"defaultPriceGroup",
"displayName":"Us Motor Works Contract",
"repositoryId":100001,
"description":"This is a written or spoken agreement, especially one concerning employment, sales, or tenancy, that is intended to be enforceable by law.",
"contract_terms":{
"terms":"All copyright, trade marks, design rights, patents and other intellectual property rights (registered and unregistered) belong to Us Motor Works Contract"
},
"externalContractReference":"UMWCUS001"
},
"delegateApprovalManagement":false,
"useExternalApprovalWebhook":false,
"orderPriceLimit":null
}
}
]
}
Default Response
The error response.
100064 : If the catalog id is invalid
100073 : If the catalog id is required
100074 :If the pricelist group id is required
100075 : If external reference number is invalid
100082 : The current account does not have the delegate approval management option enabled. Requiring order approvals or making changes to purchase limits cannot be done.
100083 : You must create at least one active approver for the account before you can enable the approval required option
100086 : Merchant admin is not allowed to do approval management with delegate approval management set to true.
100105 : Error while fetching site account properties
100108 : Invalid organization id for fetching site account properties
100109 : The site id entered is a non b2b site
100110 : Invalid values for site based organization properties
100111 : Internal error occurred while updating site based organization properties
Root Schema : errorModel
Type:
Show Source
object
-
devMessage(optional):
string
An optional non-localized message containing technical information for developers
-
errorCode(optional):
string
The numerical code identifying the error
-
errors(optional):
array errors
An optional list of errors if multiple errors were encountered
-
message(optional):
string
The localized message describing the error
-
moreInfo(optional):
string
An optional non-localized message with more information
-
o:errorPath(optional):
string
An optional machine readable description of where the error occurred
-
status(optional):
string
The HTTP status code
-
type(optional):
string
The URI to the HTTP state code definition
Nested Schema : errors
Type:
array
An optional list of errors if multiple errors were encountered
Show Source
Nested Schema : items
Type:
Show Source
object
-
devMessage(optional):
string
An optional non-localized message containing technical information for developers
-
errorCode(optional):
string
The numerical code identifying the error
-
message(optional):
string
The localized message describing the error
-
moreInfo(optional):
string
An optional non-localized message with more information
-
o:errorPath(optional):
string
An optional machine readable description of where the error occurred
-
status(optional):
string
The HTTP status code