REST API for Oracle Commerce Cloud December 2017

update address for an Organization

put

/ccadmin/v1/organizations/{id}/secondaryAddresses/{addressId}

Update Organization Address. This endpoint is used to update secondary address of an Organization in Oracle Commerce Cloud.

Request

Supported Media Types

application/json

Path Parameters

addressId: Type: string

Required: true

The address id of the requested address for an Organization.
id: Type: string

Required: true

The ID of the requested Organization.

Header Parameters

X-CCAsset-Language: Type: string

The asset language of the request. E.g., en,de,fr_CA.

Body Parameter

Root Schema : updateOrganizationAddress_request

Example


{
    "address":{
        "isDefaultBillingAddress":false,
        "country":"US",
        "phoneNumber":"973-974-1234",
        "address2":"Street 2",
        "city":"Montgomery",
        "address1":"600 Dexter Avenue",
        "postalCode":"36130",
        "companyName":"Oracle New",
        "isDefaultShippingAddress":false,
        "state":"AL"
    },
    "addressType":"Office Address New"
}

Properties

address: Type: object address

Additional Properties Allowed:

Updated address for the Organization.
addressType: Type: string

Address type represents nick name of account if present else repository ID of address item.

Nested Schema : address

Type: object

Updated address for the Organization.

Properties

address1: Type: string

The address1 of the secondary address.
address2: Type: string

The address2 of the secondary address
city: Type: string

The city of the secondary address.
companyName: Type: string

Company name of the secondary address.
country: Type: string

The country of the address.
isDefaultBillingAddress: Type: boolean

Marks an address as default billing address. Default value is false. Accepts true or false
isDefaultShippingAddress: Type: boolean

Marks an address as default shipping address. Default value is false. Accepts true or false
phoneNumber: Type: string

Phone Number of the address.
postalCode: Type: string

Postal Code of the address.
state: Type: string

The State of the address.

Response

Supported Media Types

application/json

200 Response

Following model is returned when operation succeeds.

Body

Root Schema : updateOrganizationAddress_response

Properties

address: Type: object address

Additional Properties Allowed:

Address created for the Organization.
addressType: Type: string

Address type represents nick name of address if present else repository ID of address item.

Nested Schema : address

Type: object

Address created for the Organization.

Properties

address1: Type: string

The address1 of the secondary address
address2: Type: string

The address2 of the secondary address
city: Type: string

The city of the secondary address
companyName: Type: string

Company name of the secondary address
country: Type: string

The country of the address
phoneNumber: Type: string

Phone Number of the address
postalCode: Type: string

Postal Code of the address
repositoryId: Type: string

repository Id of the address
state: Type: string

The State of the address

Example application/json


{
    "address":{
        "country":"US",
        "phoneNumber":"973-974-1234",
        "address2":"Street 2",
        "city":"Montgomery",
        "address1":"600 Dexter Avenue",
        "companyName":"National Discount Auto Parts",
        "postalCode":"36130",
        "repositoryId":"280004",
        "state":"AL"
    },
    "addressType":"Montgomery Office Address",
    "links":[
        {
            "rel":"self",
            "href":"/ccadminui/v1/organizations/or-100001/secondaryAddresses/280004"
        }
    ]
}

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| |------------------|------------------| |100183|If input or nickname given is null/empty| |100030|Postal Code is required| |100031|Country is required| |100032|No State Region is found| |23015|Phone Number is required| |23005|Phone Number is invalid| |80018|If an invalid country is provided| |100067|If an invalid state is provided| |100189|Duplicate Addresses Type are giving in input| |100026|Company Name is required| |100027|Address 1 is required| |100028|City is required| |100029|State is required| |100000|If input passed is invalid| |100001|If there was no organization found with the given id|

Body

Root Schema : errorModel

Type: object

Properties

devMessage: Type: string

An optional non-localized message containing technical information for developers
errorCode: Type: string

The numerical code identifying the error
errors: Type: array errors

Additional Properties Allowed:

An optional list of errors if multiple errors were encountered
message: Type: string

The localized message describing the error
moreInfo: Type: string

An optional non-localized message with more information
o:errorPath: Type: string

An optional machine readable description of where the error occurred
status: Type: string

The HTTP status code
type: Type: string

The URI to the HTTP state code definition

Nested Schema : errors

Type: array

An optional list of errors if multiple errors were encountered

Items

Type: object items

Additional Properties Allowed:

Nested Schema : items

Type: object

Properties

devMessage: Type: string

An optional non-localized message containing technical information for developers
errorCode: Type: string

The numerical code identifying the error
message: Type: string

The localized message describing the error
moreInfo: Type: string

An optional non-localized message with more information
o:errorPath: Type: string

An optional machine readable description of where the error occurred
status: Type: string

The HTTP status code

Examples

Sample Request:

{
  "address": {
    "isDefaultBillingAddress": false,
    "country": "US",
    "phoneNumber": "973-974-1234",
    "address2": "Street 2",
    "city": "Montgomery",
    "address1": "600 Dexter Avenue",
    "postalCode": "36130",
    "companyName": "Oracle New",
    "isDefaultShippingAddress": false,
    "state": "AL"
  },
  "addressType": "Office Address New"
}

Sample Response Payload returned by endpoint:

{
  "address": {
    "country": "US",
    "phoneNumber": "973-974-1234",
    "address2": "Street 2",
    "city": "Montgomery",
    "address1": "600 Dexter Avenue",
    "companyName": "National Discount Auto Parts",
    "postalCode": "36130",
    "repositoryId": "280004",
    "state": "AL"
  },
  "addressType": "Montgomery Office Address",
  "links": [{
    "rel": "self",
    "href": "/ccadminui/v1/organizations/or-100001/secondaryAddresses/280004"
  }]
}