updateProfileAddress
put
/ccagent/v1/profiles/{id}/addresses/{addressId}
Update profile address of the customer. If the customer is B2B, then the customer should have profile address manager role in that organization.
Request
Supported Media Types
- application/json
Path Parameters
-
addressId: string
The address Id associated to profile.
-
id: string
The customer profile id.
Root Schema : updateProfileAddress_request
Type:
Show Source
object-
address:
object address
The address object of the profile
-
addressType(optional):
string
The nickname for the address.
Example:
{
"address":{
"lastName":"Anderson",
"country":"US",
"types":[
{
"id":"at200001"
}
],
"address3":"",
"city":"Buffalo",
"address2":"",
"address1":"1234, International Avenue",
"postalCode":"32305",
"companyName":"Oracle",
"firstName":"kim",
"phoneNumber":"813-123-1234",
"repositoryId":"ss-12345",
"state":"FL"
},
"addressType":"Home"
}Nested Schema : address
Type:
objectThe address object of the profile
Show Source
-
address1(optional):
string
address line 1 for the address
-
address2(optional):
string
Address line 2 for the address
-
address3(optional):
string
Address line 3 for the address
-
city(optional):
string
city for the address
-
companyName(optional):
string
companyName for the address. It is not mandatory for the profile addresses.
-
country(optional):
string
The country of the address
-
county(optional):
string
county for the address
-
externalAddressId(optional):
string
External reference ID of address
-
firstName(optional):
string
The first name of the user for whom the address is created. This field can be null also
-
lastName(optional):
string
The last name of the user for whom the address is created. This field can be null also
-
phoneNumber(optional):
string
Phone number of the address
-
postalCode(optional):
string
postalCode for the address
-
repositoryId(optional):
boolean
repository id of the address
-
state(optional):
string
state for the address
-
types(optional):
array types
The types tagged to the address
Nested Schema : items
Type:
Show Source
object-
id(optional):
string
repository Id of the address type
Response
Supported Media Types
- application/json
200 Response
Following model is returned when operation succeeds.
Root Schema : updateProfileAddress_response
Type:
Show Source
object-
address(optional):
object address
The address object of the profile
-
addressType(optional):
string
The nickname for the address.
Nested Schema : address
Type:
objectThe address object of the profile
Show Source
-
address1(optional):
string
address line 1 for the address
-
address2(optional):
string
Address line 2 for the address
-
address3(optional):
string
Address line 3 for the address
-
city(optional):
string
city for the address
-
companyName(optional):
string
companyName for the address. It is not mandatory for the profile addresses.
-
country(optional):
string
The country of the address
-
county(optional):
string
county for the address
-
externalAddressId(optional):
string
External reference ID of address
-
firstName(optional):
string
The first name of the user for whom the address is created. This field can be null also
-
lastName(optional):
string
The last name of the user for whom the address is created. This field can be null also
-
phoneNumber(optional):
string
Phone number of the address
-
postalCode(optional):
string
postalCode for the address
-
repositoryId(optional):
string
repository id of the address
-
state(optional):
string
state for the address
-
types(optional):
array types
The types tagged to the address
Nested Schema : items
Type:
Show Source
object-
displayName(optional):
string
The name of the address type
-
id(optional):
string
repository Id of the address type
-
repositoryId(optional):
string
repository Id of the address type
Example Response (application/json)
{
"address":{
"firstName":"tr",
"lastName":"et",
"country":"US",
"externalAddressId":"EXT_ADDR_1",
"types":[
{
"displayName":"Billing",
"repositoryId":"ss-10002",
"id":"SHIPPING"
}
],
"phoneNumber":"631-748-6479",
"address2":"et",
"city":"te",
"address1":"et",
"postalCode":"35005",
"repositoryId":"130023",
"state":"AL"
},
"addressType":"tertr",
"links":[
{
"rel":"self",
"href":"http://localhost:9080/ccagentui/v1/profiles/se-570031/addresses/130023"
}
]
}Default Response
The error response.
The following are the internal error codes thrown by this API when the request processing fails in Oracle Commerce Cloud:
|Error Code|Description|
|------------------|------------------|
|22030|User is not logged in|
|22031|Internal error during get profile|
|22032|Error occurred due to invalid data|
|22002|No profile found with profile id|
|89103|The current user does not have administrator privileges and is not associated to an account|
|100190|Error occurred while attempting to fetch addresses from the repository.|
|22038|Invalid Address ID : address is not associated with user profile.|
|89101|User {0} does not have required permission to manage addresses.|
|100186|Updating of multiple address is not allowed|
|100183|Addresses is required|
|23010|City is not specified|
|23011|Address line 1 not specified|
|22000|The profile id passes is null or empty.|
|23012|No last name specified in shipping address|
|22001|Internal error while getting the profile.|
|23013|No first name specified in shipping address|
|23015|Phone number not specified in shipping address|
|23005|Invalid phone number is specified|
|23007|No country is specified |
|23008|Postal code is not specified|
|100077|One of the dynamic properties is not writable by the Agent user|
|180106|One or more address type ID is invalid|
|
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:
arrayAn 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