Document Properties
KbidP29613
Last Modified23-Feb-2021
Added to KB11-Sep-2020
Public AccessEveryone
StatusOnline
Doc TypeReferences
ProductICM 7.10

Reference - Customer API 1.0.0


Product Version

7.10

Product To Version


Status

final

Download Specification 

This API specification is available for download as an Open API 3.0 YAML file: 

API Specification

Introduction

OpenAPI Version: 3.0.1
Customer Version: 1.0.0

This is Intershop ICM REST API documentation.

This reference lists the REST API for storefront development. The REST API covers features of both, the B2C (SMB - Small and Medium-sized businesses) and the B2B storefront development.
This reference is intended for developers who want to make use of an easy-to-use API when developing frontend solutions.
You can find more information at Intershop Communications. Contact our Intershop experts at Support - Intershop Communications

Introduction

This API is documented in OpenAPI format.

Address API

/customers/{CustomerKey}/addresses
GET: Returns the customer's addresses

Description

This operation returns a list of the customer's addresses based on the provided CustomerResourceKey. The response resource collection contains objects of the type LinkRO.

Java Method

public com.intershop.component.rest.capi.resourceobject.ResourceCollectionRO com.intershop.sellside.rest.common.capi.resource.customer.address.CustomerAddressListResource.getAddresses()

Request Body

--

Request Parameters

LocationNameFormatDescription
in pathCustomerKeystringRequired | The key or UUID to resolve a single item | Example: ExampleKey

Response

200 - OK

- The addresses of the customer.
ResourceCollectionROLinkRO application/json
ResourceCollectionROLinkRO -> elements -> [..] -> itemId can be used as {CustomerAddressKey} in subsequent requests. Links to item of type AddressRO.

401 - Unauthorized

- The organization is not valid.
POST: Create new customer address

Description

Creates a new customer address by using POST data provided by the client

Java Method

public javax.ws.rs.core.Response com.intershop.sellside.rest.common.capi.resource.customer.address.CustomerAddressListResource.createAddress(com.intershop.sellside.rest.common.capi.resourceobject.AddressRO)

Request Body

AddressRO application/json

Request Parameters

LocationNameFormatDescription
in pathCustomerKeystringRequired | The key or UUID to resolve a single item | Example: ExampleKey

Response

200 - OK

The created address is a duplicate. The existing instance is returned.

201 - Created

Creation of a unique address finished succesfully

400 - Bad Request

possible values for header error-key:
- customer.address.invalid_fields.usage.error
- customer.address.missing_fields.error

401 - Unauthorized

404 - Not Found

possible values for header error-key:
- customer.address.not_found.error
/customers/{CustomerKey}/addresses/{CustomerAddressKey}
GET: Get customer address details

Description

Returns details about customer's address to the client

Java Method

public com.intershop.sellside.rest.common.capi.resourceobject.AddressRO com.intershop.sellside.rest.common.capi.resource.customer.address.CustomerAddressItemResource.getAddress()

Request Body

--

Request Parameters

LocationNameFormatDescription
in pathCustomerKeystringRequired | The key or UUID to resolve a single item | Example: ExampleKey
in pathCustomerAddressKeystringRequired | The key or UUID to resolve a single item | Example: ExampleKey

Response

200 - OK

AddressRO application/json

401 - Unauthorized

404 - Not Found

possible values for header error-key:
- customer.address_not_found.error
PUT: Update customer address

Description

Updates a customer address with address data provided from the client

Java Method

public javax.ws.rs.core.Response com.intershop.sellside.rest.common.capi.resource.customer.address.CustomerAddressItemResource.updateAddress(com.intershop.sellside.rest.common.capi.resourceobject.AddressRO)

Request Body

AddressRO application/json

Request Parameters

LocationNameFormatDescription
in pathCustomerKeystringRequired | The key or UUID to resolve a single item | Example: ExampleKey
in pathCustomerAddressKeystringRequired | The key or UUID to resolve a single item | Example: ExampleKey

Response

200 - OK

400 - Bad Request

possible values for header error-key:
- customer.address.missing_fields.error
- customer.address.update.error.inconsistentUsage
Other errors (customer.address.update.error.failureCode) may be returned if AddressUpdateHandlers are registered

401 - Unauthorized

403 - Forbidden

possible values for header error-key:
- customer.address.update.error.AddressNotUpdatable

404 - Not Found

possible values for header error-key:
- customer.address.not_found.error
DELETE: Delete customer address

Description

Deletes a customer address

Java Method

public javax.ws.rs.core.Response com.intershop.sellside.rest.common.capi.resource.customer.address.CustomerAddressItemResource.deleteAddress()

Request Body

--

Request Parameters

LocationNameFormatDescription
in pathCustomerKeystringRequired | The key or UUID to resolve a single item | Example: ExampleKey
in pathCustomerAddressKeystringRequired | The key or UUID to resolve a single item | Example: ExampleKey

Response

204 - No Content

401 - Unauthorized

404 - Not Found

409 - Conflict

possible values for header error-key:
- customer.address.deletion.error.LastAddress
- customer.address.deletion.error.WrongAddressRepository
Other errors (customer.address.deletion.error.failureCode) may be returned if additional AddressDeletionHandlers are registered
/privatecustomers/{CustomerKey}/addresses
GET: Returns the customer's addresses

Description

This operation returns a list of the customer's addresses based on the provided CustomerResourceKey. The response resource collection contains objects of the type LinkRO.

Java Method

public com.intershop.component.rest.capi.resourceobject.ResourceCollectionRO com.intershop.sellside.rest.common.capi.resource.customer.address.CustomerAddressListResource.getAddresses()

Request Body

--

Request Parameters

LocationNameFormatDescription
in pathCustomerKeystringRequired | The key or UUID to resolve a single item | Example: ExampleKey

Response

200 - OK

- The addresses of the customer.
ResourceCollectionROLinkRO application/json
ResourceCollectionROLinkRO -> elements -> [..] -> itemId can be used as {CustomerAddressKey} in subsequent requests. Links to item of type AddressRO.

401 - Unauthorized

- The organization is not valid.
POST: Create new customer address

Description

Creates a new customer address by using POST data provided by the client

Java Method

public javax.ws.rs.core.Response com.intershop.sellside.rest.common.capi.resource.customer.address.CustomerAddressListResource.createAddress(com.intershop.sellside.rest.common.capi.resourceobject.AddressRO)

Request Body

AddressRO application/json

Request Parameters

LocationNameFormatDescription
in pathCustomerKeystringRequired | The key or UUID to resolve a single item | Example: ExampleKey

Response

200 - OK

The created address is a duplicate. The existing instance is returned.

201 - Created

Creation of a unique address finished succesfully

400 - Bad Request

possible values for header error-key:
- customer.address.invalid_fields.usage.error
- customer.address.missing_fields.error

401 - Unauthorized

404 - Not Found

possible values for header error-key:
- customer.address.not_found.error
/privatecustomers/{CustomerKey}/addresses/{CustomerAddressKey}
GET: Get customer address details

Description

Returns details about customer's address to the client

Java Method

public com.intershop.sellside.rest.common.capi.resourceobject.AddressRO com.intershop.sellside.rest.common.capi.resource.customer.address.CustomerAddressItemResource.getAddress()

Request Body

--

Request Parameters

LocationNameFormatDescription
in pathCustomerKeystringRequired | The key or UUID to resolve a single item | Example: ExampleKey
in pathCustomerAddressKeystringRequired | The key or UUID to resolve a single item | Example: ExampleKey

Response

200 - OK

AddressRO application/json

401 - Unauthorized

404 - Not Found

possible values for header error-key:
- customer.address_not_found.error
PUT: Update customer address

Description

Updates a customer address with address data provided from the client

Java Method

public javax.ws.rs.core.Response com.intershop.sellside.rest.common.capi.resource.customer.address.CustomerAddressItemResource.updateAddress(com.intershop.sellside.rest.common.capi.resourceobject.AddressRO)

Request Body

AddressRO application/json

Request Parameters

LocationNameFormatDescription
in pathCustomerKeystringRequired | The key or UUID to resolve a single item | Example: ExampleKey
in pathCustomerAddressKeystringRequired | The key or UUID to resolve a single item | Example: ExampleKey

Response

200 - OK

400 - Bad Request

possible values for header error-key:
- customer.address.missing_fields.error
- customer.address.update.error.inconsistentUsage
Other errors (customer.address.update.error.failureCode) may be returned if AddressUpdateHandlers are registered

401 - Unauthorized

403 - Forbidden

possible values for header error-key:
- customer.address.update.error.AddressNotUpdatable

404 - Not Found

possible values for header error-key:
- customer.address.not_found.error
DELETE: Delete customer address

Description

Deletes a customer address

Java Method

public javax.ws.rs.core.Response com.intershop.sellside.rest.common.capi.resource.customer.address.CustomerAddressItemResource.deleteAddress()

Request Body

--

Request Parameters

LocationNameFormatDescription
in pathCustomerKeystringRequired | The key or UUID to resolve a single item | Example: ExampleKey
in pathCustomerAddressKeystringRequired | The key or UUID to resolve a single item | Example: ExampleKey

Response

204 - No Content

401 - Unauthorized

404 - Not Found

409 - Conflict

possible values for header error-key:
- customer.address.deletion.error.LastAddress
- customer.address.deletion.error.WrongAddressRepository
Other errors (customer.address.deletion.error.failureCode) may be returned if additional AddressDeletionHandlers are registered

Cost Center API

/customers/{CustomerKey}/costcenters
GET: Returns all cost centers

Description

This operation returns a list of links to all cost centers of the customer as well as some of their properties.

Java Method

public javax.ws.rs.core.Response com.intershop.sellside.rest.b2b.costcenter.capi.resource.CostCenterListResource.getCostCenters()

Request Body

--

Request Parameters

LocationNameFormatDescription
in pathCustomerKeystringRequired | The key or UUID to resolve a single item | Example: ExampleKey

Response

200 - OK

- The list of cost centers.
Array of LinkRO application/json

401 - Unauthorized

- The user could not be authenticated.

403 - Forbidden

- The user is not allowed to access this resource.

404 - Not Found

- The customer could not be found.
POST: Creates a new cost center

Description

This operation creates a new cost center.

Java Method

public javax.ws.rs.core.Response com.intershop.sellside.rest.b2b.costcenter.capi.resource.CostCenterListResource.createCostCenter(com.intershop.sellside.rest.b2b.costcenter.capi.resourceobject.NewCostCenterRO)

Request Body

NewCostCenterRO application/json

Request Parameters

LocationNameFormatDescription
in pathCustomerKeystringRequired | The key or UUID to resolve a single item | Example: ExampleKey

Response

201 - Created

- The new cost center.
LinkRO application/json

401 - Unauthorized

- The user could not be authenticated.

403 - Forbidden

- The user is not allowed to access this resource.

404 - Not Found

- The customer could not be found.
/customers/{CustomerKey}/costcenters/{CostCenterKey}
GET: Returns cost center details

Description

This operation returns detail information about the cost center with the given ID.

Java Method

public javax.ws.rs.core.Response com.intershop.sellside.rest.b2b.costcenter.capi.resource.CostCenterItemResource.getCostCenter()

Request Body

--

Request Parameters

LocationNameFormatDescription
in pathCustomerKeystringRequired | The key or UUID to resolve a single item | Example: ExampleKey
in pathCostCenterKeystringRequired | The automatically assigned cost center ID | Example: Z.8KDgAFgJsAAAF2wyUMzLSE

Response

200 - OK

- The cost center with the given ID.
CostCenterRO application/json

401 - Unauthorized

Unathorized - The user could not be authenticated.

403 - Forbidden

- The user is not allowed to access this resource.

404 - Not Found

- The customer or the cost center could not be found.
DELETE: Removes the cost center

Description

This operation removes the cost center with the given ID.

Java Method

public javax.ws.rs.core.Response com.intershop.sellside.rest.b2b.costcenter.capi.resource.CostCenterItemResource.deleteCostCenter()

Request Body

--

Request Parameters

LocationNameFormatDescription
in pathCustomerKeystringRequired | The key or UUID to resolve a single item | Example: ExampleKey
in pathCostCenterKeystringRequired | The automatically assigned cost center ID | Example: Z.8KDgAFgJsAAAF2wyUMzLSE

Response

204 - No Content

- The cost center was deleted.

401 - Unauthorized

Unathorized - The user could not be authenticated.

403 - Forbidden

- The user is not allowed to access this resource.

404 - Not Found

- The customer or the cost center could not be found.
PATCH: Updates the cost center

Description

This operation updates the cost center information.

Java Method

public javax.ws.rs.core.Response com.intershop.sellside.rest.b2b.costcenter.capi.resource.CostCenterItemResource.updateCostCenter(com.intershop.sellside.rest.b2b.costcenter.capi.resourceobject.UpdateCostCenterRO)

Request Body

UpdateCostCenterRO application/json

Request Parameters

LocationNameFormatDescription
in pathCustomerKeystringRequired | The key or UUID to resolve a single item | Example: ExampleKey
in pathCostCenterKeystringRequired | The automatically assigned cost center ID | Example: Z.8KDgAFgJsAAAF2wyUMzLSE

Response

200 - OK

- The updated cost center.
CostCenterRO application/json

401 - Unauthorized

Unathorized - The user could not be authenticated.

403 - Forbidden

- The user is not allowed to access this resource.

404 - Not Found

- The customer or the cost center could not be found.
/customers/{CustomerKey}/costcenters/{CostCenterKey}/buyers
GET: Returns all buyers for the cost center

Description

This operation returns a list of links to all assigned buyers for the given cost center, as well as some of their properties.

Java Method

public javax.ws.rs.core.Response com.intershop.sellside.rest.b2b.costcenter.capi.resource.CostCenterBuyerListResource.getCostCenterBuyers()

Request Body

--

Request Parameters

LocationNameFormatDescription
in pathCustomerKeystringRequired | The key or UUID to resolve a single item | Example: ExampleKey
in pathCostCenterKeystringRequired | The automatically assigned cost center ID | Example: Z.8KDgAFgJsAAAF2wyUMzLSE

Response

200 - OK

- The cost center buyers.
Array of LinkRO application/json

401 - Unauthorized

Unathorized - The user could not be authenticated.

403 - Forbidden

- The user is not allowed to access this resource.

404 - Not Found

- The customer or cost center could not be found.
POST: Adds a new cost center buyer

Description

This operation adds a new buyer to the given cost center.

Java Method

public javax.ws.rs.core.Response com.intershop.sellside.rest.b2b.costcenter.capi.resource.CostCenterBuyerListResource.addCostCenterBuyer(com.intershop.sellside.rest.b2b.costcenter.capi.resourceobject.NewCostCenterBuyerRO)

Request Body

NewCostCenterBuyerRO application/json

Request Parameters

LocationNameFormatDescription
in pathCustomerKeystringRequired | The key or UUID to resolve a single item | Example: ExampleKey
in pathCostCenterKeystringRequired | The automatically assigned cost center ID | Example: Z.8KDgAFgJsAAAF2wyUMzLSE

Response

200 - OK

- The added buyer.
CostCenterUserRO application/json

401 - Unauthorized

Unathorized - The user could not be authenticated.

403 - Forbidden

- The user is not allowed to access this resource.

404 - Not Found

- The customer or cost center could not be found.
/customers/{CustomerKey}/costcenters/{CostCenterKey}/buyers/{CostCenterBuyerKey}
GET: Returns information about a buyer of the cost center

Description

This operation returns information about a buyer of the cost center.

Java Method

public javax.ws.rs.core.Response com.intershop.sellside.rest.b2b.costcenter.capi.resource.CostCenterBuyerItemResource.getCostCenterBuyer()

Request Body

--

Request Parameters

LocationNameFormatDescription
in pathCustomerKeystringRequired | The key or UUID to resolve a single item | Example: ExampleKey
in pathCostCenterKeystringRequired | The automatically assigned cost center ID | Example: Z.8KDgAFgJsAAAF2wyUMzLSE
in pathCostCenterBuyerKeystringRequired | The login of the cost center buyer | Example: pmiller@test.intershop.de

Response

200 - OK

- The buyer information.
CostCenterUserRO application/json

401 - Unauthorized

Unathorized - The user could not be authenticated.

403 - Forbidden

- The user is not allowed to access this resource.

404 - Not Found

- The customer, cost center or buyer could not be found.
DELETE: Removes the buyer from the cost center

Description

This operation removes the given buyer from the cost center.

Java Method

public javax.ws.rs.core.Response com.intershop.sellside.rest.b2b.costcenter.capi.resource.CostCenterBuyerItemResource.removeCostCenterBuyer()

Request Body

--

Request Parameters

LocationNameFormatDescription
in pathCustomerKeystringRequired | The key or UUID to resolve a single item | Example: ExampleKey
in pathCostCenterKeystringRequired | The automatically assigned cost center ID | Example: Z.8KDgAFgJsAAAF2wyUMzLSE
in pathCostCenterBuyerKeystringRequired | The login of the cost center buyer | Example: pmiller@test.intershop.de

Response

204 - No Content

- The cost center buyer was removed.

401 - Unauthorized

Unathorized - The user could not be authenticated.

403 - Forbidden

- The user is not allowed to access this resource.

404 - Not Found

- The customer, cost center or buyer could not be found.
PATCH: Updates the budget for a buyer of the cost center

Description

This operation updates the budget for a buyer of the cost center.

Java Method

public javax.ws.rs.core.Response com.intershop.sellside.rest.b2b.costcenter.capi.resource.CostCenterBuyerItemResource.updateCostCenterBuyer(com.intershop.sellside.rest.b2b.costcenter.capi.resourceobject.UpdateCostCenterBuyerRO)

Request Body

UpdateCostCenterBuyerRO application/json

Request Parameters

LocationNameFormatDescription
in pathCustomerKeystringRequired | The key or UUID to resolve a single item | Example: ExampleKey
in pathCostCenterKeystringRequired | The automatically assigned cost center ID | Example: Z.8KDgAFgJsAAAF2wyUMzLSE
in pathCostCenterBuyerKeystringRequired | The login of the cost center buyer | Example: pmiller@test.intershop.de

Response

200 - OK

- The cost center buyer with the updated budget.
CostCenterUserRO application/json

401 - Unauthorized

Unathorized - The user could not be authenticated.

403 - Forbidden

- The user is not allowed to access this resource.

404 - Not Found

- The customer, cost center or buyer could not be found.
/customers/{CustomerKey}/users/{CustomerItemUserKey}/costcenters
GET: Returns a list of cost centers of a business user

Description

This operation returns a list of all cost centers to which the user is assigned (as a buyer or approver).

Java Method

public com.intershop.application.storefront.rest.b2b.capi.user.costcenter.resourceobject.UserCostCenterLinkROCollection com.intershop.application.storefront.rest.b2b.capi.user.costcenter.resource.UserCostCenterListResource.getCostCenters()

Request Body

--

Request Parameters

LocationNameFormatDescription
in pathCustomerKeystringRequired | The key or UUID to resolve a single item | Example: ExampleKey
in pathCustomerItemUserKeystringRequired | The key or UUID to resolve a single item | Example: ExampleKey

Response

200 - OK

- The list of cost centers.
UserCostCenterLinkROCollection application/json

401 - Unauthorized

- The user could not be authenticated.

403 - Forbidden

- The user is not allowed to access this resource.

404 - Not Found

- The customer or user could not be found or does not support cost centers.
/customers/{CustomerKey}/users/{CustomerItemUserKey}/costcenters/{UserCostCenterKey}
GET: Returns business user cost center details

Description

This operation returns the details of a specified cost center of a business user.

Java Method

public com.intershop.application.storefront.rest.b2b.capi.user.costcenter.resourceobject.UserCostCenterRO com.intershop.application.storefront.rest.b2b.capi.user.costcenter.resource.UserCostCenterItemResource.getUserCostCenter()

Request Body

--

Request Parameters

LocationNameFormatDescription
in pathCustomerKeystringRequired | The key or UUID to resolve a single item | Example: ExampleKey
in pathCustomerItemUserKeystringRequired | The key or UUID to resolve a single item | Example: ExampleKey
in pathUserCostCenterKeystringRequired | The cost center ID assigned by the customer | Example: 100401

Response

200 - OK

- The cost center details.
UserCostCenterRO application/json

401 - Unauthorized

- The user could not be authenticated.

403 - Forbidden

- The user is not allowed to access this resource.

404 - Not Found

- The customer or user could not be found, does not support cost centers or is not assigned to a cost center (as buyer or approver).

General API

/customers
POST: registers a new SMB customer

Description

--

Java Method

public javax.ws.rs.core.Response com.intershop.sellside.rest.smb.capi.resource.customer.CustomerListResource.createCustomer(com.intershop.sellside.rest.smb.capi.resourceobject.NewCustomerRO)

Request Body

NewCustomerRO application/json

Request Parameters

--

Response

201 - Created

LinkRO application/json

400 - Bad Request

401 - Unauthorized

Authorization is required if the customer gets assigned to an existing user

403 - Forbidden

Authorized user has to be the same as the one to get assigned to the new customer
/customers/{CustomerKey}
GET: Get customer profile of currently logged in user

Description

--

Java Method

public com.intershop.sellside.rest.smb.capi.resourceobject.SMBCustomerRO com.intershop.sellside.rest.smb.capi.resource.customer.CustomerItemResource.getCustomer()

Request Body

--

Request Parameters

LocationNameFormatDescription
in pathCustomerKeystringRequired | The key or UUID to resolve a single item | Example: ExampleKey

Response

200 - OK

SMBCustomerRO application/json

401 - Unauthorized

403 - Forbidden

404 - Not Found

PUT: Update customer profile of currently logged in user

Description

--

Java Method

public com.intershop.sellside.rest.smb.capi.resourceobject.SMBCustomerRO com.intershop.sellside.rest.smb.capi.resource.customer.CustomerItemResource.updateCustomer(com.intershop.sellside.rest.smb.capi.resourceobject.SMBCustomerRO)

Request Body

SMBCustomerRO application/json

Request Parameters

LocationNameFormatDescription
in pathCustomerKeystringRequired | The key or UUID to resolve a single item | Example: ExampleKey

Response

200 - OK

SMBCustomerRO application/json

401 - Unauthorized

404 - Not Found

/privatecustomers
POST: Create individual customer

Description

Creates an individual customer. Available for unregistered users only.

Java Method

public javax.ws.rs.core.Response com.intershop.sellside.rest.b2c.capi.resource.customer.PrivateCustomerListResource.createCustomer(com.intershop.sellside.rest.b2c.capi.resourceobject.NewCustomerRO)

Request Body

NewCustomerRO application/json

Request Parameters

--

Response

201 - Created

400 - Bad Request

possible values for header error-key:
- customer.already_exists.error
- customer.customerno.already_exists.error
- customer.missing_fields.error
- customer.invalid_fields.error
- customer.credentials.missing_fields.error
- customer.credentials.login.not_acceptable.error
- customer.credentials.login.not_unique.error
- customer.credentials.password.invalid.error
- customer.address.missing_fields.error

401 - Unauthorized

Authorization is required if the customer gets assigned to an existing user

403 - Forbidden

Authorized user has to be the same as the one to get assigned to the new customer

409 - Conflict

/privatecustomers/simple
POST: Create Customer

Description

simplified creation process for new customerwith minimal information

Java Method

public javax.ws.rs.core.Response com.intershop.sellside.rest.b2c.capi.resource.customer.PrivateCustomerListResource.createAccount(com.intershop.sellside.rest.common.capi.resourceobject.CredentialsRO)

Request Body

CredentialsRO application/json

Request Parameters

--

Response

201 - Created

400 - Bad Request

409 - Conflict

possible values for header error-key:
- customer.already_exists.error

501 - Not Implemented

possible values for header error-key:
- customer.simpleaccount.not_possible.error
/privatecustomers/{CustomerKey}
GET: Get current customer profile details

Description

--

Java Method

public com.intershop.sellside.rest.b2c.capi.resourceobject.PrivateCustomerRO com.intershop.sellside.rest.b2c.capi.resource.customer.PrivateCustomerItemResource.getCustomer()

Request Body

--

Request Parameters

LocationNameFormatDescription
in pathCustomerKeystringRequired | The key or UUID to resolve a single item | Example: ExampleKey

Response

200 - OK

PrivateCustomerRO application/json

401 - Unauthorized

403 - Forbidden

404 - Not Found

PUT: Upates a customer

Description

--

Java Method

public com.intershop.sellside.rest.b2c.capi.resourceobject.PrivateCustomerRO com.intershop.sellside.rest.b2c.capi.resource.customer.PrivateCustomerItemResource.updateCustomer(com.intershop.sellside.rest.b2c.capi.resourceobject.PrivateCustomerRO)

Request Body

PrivateCustomerRO application/json

Request Parameters

LocationNameFormatDescription
in pathCustomerKeystringRequired | The key or UUID to resolve a single item | Example: ExampleKey

Response

200 - OK

PrivateCustomerRO application/json

400 - Bad Request

401 - Unauthorized

404 - Not Found

Gift Card and Certificate API

/customers/{CustomerKey}/users/{CustomerItemUserKey}/giftcardsandcertificates
GET: Returns gift cards and certificates

Description

This operation returns a list of gift cards and certificates associated with the current user.

Java Method

public com.intershop.component.rest.capi.resourceobject.ResourceCollectionRO com.intershop.sellside.rest.common.capi.resource.customer.giftcardsandcertificates.CustomerGiftCardsAndCertificatesResource.getGiftCardsAndCertificates()

Request Body

--

Request Parameters

LocationNameFormatDescription
in pathCustomerKeystringRequired | The key or UUID to resolve a single item | Example: ExampleKey
in pathCustomerItemUserKeystringRequired | The key or UUID to resolve a single item | Example: ExampleKey

Response

200 - OK

- The list of gift cards and certificates.
LinkROResourceCollectionRO application/json

401 - Unauthorized

- The user could not be authenticated.

403 - Forbidden

- The authenticated user does not match the requested user.

404 - Not Found

- The customer or user could not be found.
/customers/{CustomerKey}/users/{CustomerItemUserKey}/giftcardsandcertificates/{CustomerGiftCardAndCertificateResourceKey}
GET: Returns gift card or certificate details

Description

This operation returns details about a specific gift card or certificate associated with the current user.

Java Method

public com.intershop.sellside.rest.common.capi.resourceobject.GiftCardAndCertificateRO com.intershop.sellside.rest.common.capi.resource.customer.giftcardsandcertificates.balance.CustomerGiftCardAndCertificateResource.getGiftCardAndCertificate()

Request Body

--

Request Parameters

LocationNameFormatDescription
in pathCustomerKeystringRequired | The key or UUID to resolve a single item | Example: ExampleKey
in pathCustomerItemUserKeystringRequired | The key or UUID to resolve a single item | Example: ExampleKey
in pathCustomerGiftCardAndCertificateResourceKeystringRequired | The gift card or certificate number | Example: 27755166187

Response

200 - OK

- The gift card or certificate with the given ID.
GiftCardAndCertificateRO application/json

401 - Unauthorized

- The user could not be authenticated.

403 - Forbidden

- The authenticated user does not match the requested user.

404 - Not Found

- The customer, user or gift card/certificate could not be found.
/privatecustomers/{CustomerKey}/giftcardsandcertificates
GET: Returns gift cards and certificates

Description

This operation returns a list of gift cards and certificates associated with the current user.

Java Method

public com.intershop.component.rest.capi.resourceobject.ResourceCollectionRO com.intershop.sellside.rest.common.capi.resource.customer.giftcardsandcertificates.CustomerGiftCardsAndCertificatesResource.getGiftCardsAndCertificates()

Request Body

--

Request Parameters

LocationNameFormatDescription
in pathCustomerKeystringRequired | The key or UUID to resolve a single item | Example: ExampleKey

Response

200 - OK

- The list of gift cards and certificates.
LinkROResourceCollectionRO application/json

401 - Unauthorized

- The user could not be authenticated.

403 - Forbidden

- The authenticated user does not match the requested user.

404 - Not Found

- The customer or user could not be found.
/privatecustomers/{CustomerKey}/giftcardsandcertificates/{CustomerGiftCardAndCertificateResourceKey}
GET: Returns gift card or certificate details

Description

This operation returns details about a specific gift card or certificate associated with the current user.

Java Method

public com.intershop.sellside.rest.common.capi.resourceobject.GiftCardAndCertificateRO com.intershop.sellside.rest.common.capi.resource.customer.giftcardsandcertificates.balance.CustomerGiftCardAndCertificateResource.getGiftCardAndCertificate()

Request Body

--

Request Parameters

LocationNameFormatDescription
in pathCustomerKeystringRequired | The key or UUID to resolve a single item | Example: ExampleKey
in pathCustomerGiftCardAndCertificateResourceKeystringRequired | The gift card or certificate number | Example: 27755166187

Response

200 - OK

- The gift card or certificate with the given ID.
GiftCardAndCertificateRO application/json

401 - Unauthorized

- The user could not be authenticated.

403 - Forbidden

- The authenticated user does not match the requested user.

404 - Not Found

- The customer, user or gift card/certificate could not be found.

Payment API

/customers/{CustomerKey}/payments
GET: Get list of customer profile payments

Description

Returns a list of all payment methods as Links that are store in the customer profile of the logged in customer.

Java Method

public com.intershop.component.rest.capi.resourceobject.ResourceCollectionRO com.intershop.sellside.rest.common.capi.resource.customer.payment.CustomerPaymentListResource.getPayments()

Request Body

--

Request Parameters

LocationNameFormatDescription
in pathCustomerKeystringRequired | The key or UUID to resolve a single item | Example: ExampleKey

Response

200 - OK

ResourceCollectionROLinkRO application/json
ResourceCollectionROLinkRO -> elements -> [..] -> itemId can be used as {CustomerPaymentKey} in subsequent requests. Links to item of type PaymentRO.

401 - Unauthorized

404 - Not Found

value for header error-key:
- payment.instrument.not_found.error (e.g. unregistred user)
POST: Add a payment to Customer profile

Description

Adds a payment to the customer profile of the logged in customer.

Java Method

public javax.ws.rs.core.Response com.intershop.sellside.rest.common.capi.resource.customer.payment.CustomerPaymentListResource.createPayment(com.intershop.sellside.rest.common.capi.resourceobject.basket.PaymentRO)

Request Body

PaymentRO application/json

Request Parameters

LocationNameFormatDescription
in pathCustomerKeystringRequired | The key or UUID to resolve a single item | Example: ExampleKey

Response

201 - Created

400 - Bad Request

possible values for header error-key:
- shopping_cart.payment.paymentdata.error (e.g., wrong giftcard number)
- shopping_cart.payment.missing_fields.error
- shopping_cart.payment.invalid_fields.error
- shopping_cart.payment.name.error (payment method not found)
- shopping_cart.payment.dublicate.error

401 - Unauthorized

OPTIONS: Return payment options for customer

Description

Returns all available payment methods and its parameters that can be added to the customer

Java Method

public com.intershop.sellside.rest.common.capi.resourceobject.basket.PaymentOptionsRO com.intershop.sellside.rest.common.capi.resource.customer.payment.CustomerPaymentListResource.getPaymentOptions()

Request Body

--

Request Parameters

LocationNameFormatDescription
in pathCustomerKeystringRequired | The key or UUID to resolve a single item | Example: ExampleKey

Response

200 - OK

PaymentOptionsRO application/json

401 - Unauthorized

/customers/{CustomerKey}/payments/{CustomerPaymentKey}
GET: Get details of a customer profile payment

Description

Returns detailed information of a payment method available for a customer

Java Method

public com.intershop.sellside.rest.common.capi.resourceobject.basket.PaymentRO com.intershop.sellside.rest.common.capi.resource.customer.payment.CustomerPaymentItemResource.getPayment()

Request Body

--

Request Parameters

LocationNameFormatDescription
in pathCustomerKeystringRequired | The key or UUID to resolve a single item | Example: ExampleKey
in pathCustomerPaymentKeystringRequired | The key or UUID to resolve a single item | Example: ExampleKey

Response

200 - OK

PaymentRO application/json

401 - Unauthorized

404 - Not Found

value for header error-key:
- payment.instrument.not_found.error (e.g. unregistred user)
PUT: Update payment from customer profile

Description

Updates a payment (with attributes) from customer profile for the logged in user. The request has to contain all attributes even if they are not changed. Payments without further attributes can not be updated.

Java Method

public com.intershop.sellside.rest.common.capi.resourceobject.basket.PaymentRO com.intershop.sellside.rest.common.capi.resource.customer.payment.CustomerPaymentItemResource.updatePayment(com.intershop.sellside.rest.common.capi.resourceobject.basket.PaymentRO)

Request Body

PaymentRO application/json

Request Parameters

LocationNameFormatDescription
in pathCustomerKeystringRequired | The key or UUID to resolve a single item | Example: ExampleKey
in pathCustomerPaymentKeystringRequired | The key or UUID to resolve a single item | Example: ExampleKey

Response

200 - OK

PaymentRO application/json

400 - Bad Request

possible values for header error-key:
- shopping_cart.payment.paymentdata.error (e.g. wrong giftcard number)
- shopping_cart.payment.missing_fields.error
- shopping_cart.payment.invalid_fields.error

401 - Unauthorized

DELETE: Remove a payment from customer profile

Description

Removes a payment method from the customer profile of the logged in customer

Java Method

public com.intershop.component.rest.capi.resourceobject.LinkRO com.intershop.sellside.rest.common.capi.resource.customer.payment.CustomerPaymentItemResource.deletePayment()

Request Body

--

Request Parameters

LocationNameFormatDescription
in pathCustomerKeystringRequired | The key or UUID to resolve a single item | Example: ExampleKey
in pathCustomerPaymentKeystringRequired | The key or UUID to resolve a single item | Example: ExampleKey

Response

200 - OK

LinkRO application/json

401 - Unauthorized

404 - Not Found

/privatecustomers/{CustomerKey}/payments
GET: Get list of customer profile payments

Description

Returns a list of all payment methods as Links that are store in the customer profile of the logged in customer.

Java Method

public com.intershop.component.rest.capi.resourceobject.ResourceCollectionRO com.intershop.sellside.rest.common.capi.resource.customer.payment.CustomerPaymentListResource.getPayments()

Request Body

--

Request Parameters

LocationNameFormatDescription
in pathCustomerKeystringRequired | The key or UUID to resolve a single item | Example: ExampleKey

Response

200 - OK

ResourceCollectionROLinkRO application/json
ResourceCollectionROLinkRO -> elements -> [..] -> itemId can be used as {CustomerPaymentKey} in subsequent requests. Links to item of type PaymentRO.

401 - Unauthorized

404 - Not Found

value for header error-key:
- payment.instrument.not_found.error (e.g. unregistred user)
POST: Add a payment to Customer profile

Description

Adds a payment to the customer profile of the logged in customer.

Java Method

public javax.ws.rs.core.Response com.intershop.sellside.rest.common.capi.resource.customer.payment.CustomerPaymentListResource.createPayment(com.intershop.sellside.rest.common.capi.resourceobject.basket.PaymentRO)

Request Body

PaymentRO application/json

Request Parameters

LocationNameFormatDescription
in pathCustomerKeystringRequired | The key or UUID to resolve a single item | Example: ExampleKey

Response

201 - Created

400 - Bad Request

possible values for header error-key:
- shopping_cart.payment.paymentdata.error (e.g., wrong giftcard number)
- shopping_cart.payment.missing_fields.error
- shopping_cart.payment.invalid_fields.error
- shopping_cart.payment.name.error (payment method not found)
- shopping_cart.payment.dublicate.error

401 - Unauthorized

OPTIONS: Return payment options for customer

Description

Returns all available payment methods and its parameters that can be added to the customer

Java Method

public com.intershop.sellside.rest.common.capi.resourceobject.basket.PaymentOptionsRO com.intershop.sellside.rest.common.capi.resource.customer.payment.CustomerPaymentListResource.getPaymentOptions()

Request Body

--

Request Parameters

LocationNameFormatDescription
in pathCustomerKeystringRequired | The key or UUID to resolve a single item | Example: ExampleKey

Response

200 - OK

PaymentOptionsRO application/json

401 - Unauthorized

/privatecustomers/{CustomerKey}/payments/{CustomerPaymentKey}
GET: Get details of a customer profile payment

Description

Returns detailed information of a payment method available for a customer

Java Method

public com.intershop.sellside.rest.common.capi.resourceobject.basket.PaymentRO com.intershop.sellside.rest.common.capi.resource.customer.payment.CustomerPaymentItemResource.getPayment()

Request Body

--

Request Parameters

LocationNameFormatDescription
in pathCustomerKeystringRequired | The key or UUID to resolve a single item | Example: ExampleKey
in pathCustomerPaymentKeystringRequired | The key or UUID to resolve a single item | Example: ExampleKey

Response

200 - OK

PaymentRO application/json

401 - Unauthorized

404 - Not Found

value for header error-key:
- payment.instrument.not_found.error (e.g. unregistred user)
PUT: Update payment from customer profile

Description

Updates a payment (with attributes) from customer profile for the logged in user. The request has to contain all attributes even if they are not changed. Payments without further attributes can not be updated.

Java Method

public com.intershop.sellside.rest.common.capi.resourceobject.basket.PaymentRO com.intershop.sellside.rest.common.capi.resource.customer.payment.CustomerPaymentItemResource.updatePayment(com.intershop.sellside.rest.common.capi.resourceobject.basket.PaymentRO)

Request Body

PaymentRO application/json

Request Parameters

LocationNameFormatDescription
in pathCustomerKeystringRequired | The key or UUID to resolve a single item | Example: ExampleKey
in pathCustomerPaymentKeystringRequired | The key or UUID to resolve a single item | Example: ExampleKey

Response

200 - OK

PaymentRO application/json

400 - Bad Request

possible values for header error-key:
- shopping_cart.payment.paymentdata.error (e.g. wrong giftcard number)
- shopping_cart.payment.missing_fields.error
- shopping_cart.payment.invalid_fields.error

401 - Unauthorized

DELETE: Remove a payment from customer profile

Description

Removes a payment method from the customer profile of the logged in customer

Java Method

public com.intershop.component.rest.capi.resourceobject.LinkRO com.intershop.sellside.rest.common.capi.resource.customer.payment.CustomerPaymentItemResource.deletePayment()

Request Body

--

Request Parameters

LocationNameFormatDescription
in pathCustomerKeystringRequired | The key or UUID to resolve a single item | Example: ExampleKey
in pathCustomerPaymentKeystringRequired | The key or UUID to resolve a single item | Example: ExampleKey

Response

200 - OK

LinkRO application/json

401 - Unauthorized

404 - Not Found

User API

/customers/{CustomerKey}/users
GET: Get users of SMB customer

Description

List all registered users of selected SMB customer with link to user item resource.

Java Method

public javax.ws.rs.core.Response com.intershop.sellside.rest.smb.capi.resource.user.CustomerItemUserListResource.getCustomers()

Request Body

--

Request Parameters

LocationNameFormatDescription
in pathCustomerKeystringRequired | The key or UUID to resolve a single item | Example: ExampleKey
in queryoffsetstringThe start element position
in querylimitstringThe count of users to return | Default: 50
in queryfilterstringOnly users which firtName, lastName or login contains the filter will be returned
in querysortstringThe sorting to be applied on returned users. Minus means sorting in DESC direction. | Default: name

Response

200 - OK

The list of registered users
UserLinkROCollection application/json

401 - Unauthorized

404 - Not Found

POST: Registers new users of SMB customer

Description

--

Java Method

public javax.ws.rs.core.Response com.intershop.sellside.rest.smb.capi.resource.user.CustomerItemUserListResource.addUsersToCustomer(com.intershop.sellside.rest.smb.capi.resourceobject.SMBCustomerUserROCollection)

Request Body

SMBCustomerUserROCollection application/json

Request Parameters

LocationNameFormatDescription
in pathCustomerKeystringRequired | The key or UUID to resolve a single item | Example: ExampleKey

Response

201 - Created

Collection with links to created users
UserLinkROCollection application/json

207 - Multi-Status

Collection with links to created users and header 'not-created-users' with list of users which creation finished with error
UserLinkROCollection application/json

400 - Bad Request

In case provided login is not acceptable

401 - Unauthorized

409 - Conflict

In case user with provided login or business partner number already exists

500 - Internal Server Error

In case provided user data contain missing or invalid fields
/customers/{CustomerKey}/users/{CustomerItemUserKey}
GET: Get user profile data of selected user

Description

--

Java Method

public com.intershop.sellside.rest.smb.capi.resourceobject.SMBCustomerUserRO com.intershop.sellside.rest.smb.capi.resource.user.CustomerItemUserItemResource.getCustomerUser()

Request Body

--

Request Parameters

LocationNameFormatDescription
in pathCustomerKeystringRequired | The key or UUID to resolve a single item | Example: ExampleKey
in pathCustomerItemUserKeystringRequired | The key or UUID to resolve a single item | Example: ExampleKey
in queryincludestringThe relations to be included in returned user data, If not provided all user data will be included.

Response

200 - OK

Display available user data. In case user has preferred address assigned, all address data will be displayed in the response.
SMBCustomerUserRO application/json

401 - Unauthorized

404 - Not Found

PUT: Update the profile of selected user of SMB customer

Description

--

Java Method

public com.intershop.component.rest.capi.resourceobject.AbstractResourceObject com.intershop.sellside.rest.smb.capi.resource.user.CustomerItemUserItemResource.updateCustomerUser(com.intershop.sellside.rest.smb.capi.resourceobject.SMBCustomerUserRO)

Request Body

SMBCustomerUserRO application/json

Request Parameters

LocationNameFormatDescription
in pathCustomerKeystringRequired | The key or UUID to resolve a single item | Example: ExampleKey
in pathCustomerItemUserKeystringRequired | The key or UUID to resolve a single item | Example: ExampleKey

Response

200 - OK

SMBCustomerUserRO application/json

400 - Bad Request

401 - Unauthorized

404 - Not Found

409 - Conflict

In case user with provided business partner number already exists

500 - Internal Server Error

In case provided user data contain missing or invalid fields
DELETE: Delete user of SMB customer

Description

Deletes the user with the same ID or login as the item resource name

Java Method

public javax.ws.rs.core.Response com.intershop.sellside.rest.smb.capi.resource.user.CustomerItemUserItemResource.deleteUser()

Request Body

--

Request Parameters

LocationNameFormatDescription
in pathCustomerKeystringRequired | The key or UUID to resolve a single item | Example: ExampleKey
in pathCustomerItemUserKeystringRequired | The key or UUID to resolve a single item | Example: ExampleKey

Response

204 - No Content

401 - Unauthorized

403 - Forbidden

Requires authentication with user having assigned the following permission: Manage Users (APP_B2B_MANAGE_USERS)

404 - Not Found

Request and Response Object Schemata

AddressRO application/json{
  • "name":
    string
    The name of an element.
  • "type":
    string
    The type of the object. This is normally a constant that can be used to differentiate objects by their type. | Example: Address
  • "urn":
    string
    the URN representation of this address | Example: urn:address:customer:1234567890:0987654321
  • "id":
    string
    The ID of the returned element | Example: vagKAB17gg4AAAFGSkFqQASI
  • "addressName":
    string
    The name of the address | Example: customeraddr-ABCDEFGPRMuMCscyXgSRVU
  • "title":
    string
    The (personal) title of the contact person, like 'Mr.' or 'Ms.' | Example: Mrs.
  • "aristocraticTitle":
    string
    the aristocratic title of the contact person, like Lord or Lady
  • "jobTitle":
    string
    the job title of the contact person | Example: CEO
  • "honorific":
    string
    the honorific title of the contact person that denotes the honored person's occupation, like Captain, Coach, Officer, Reverend or the academic title, like PhD
  • "firstName":
    string
    The (first) given name of the contact person | Example: Patricia
  • "secondName":
    string
    the second given name of the contact person | Example: Luise
  • "lastName":
    string
    The last name of the contact person | Example: Miller
  • "secondLastName":
    string
    the second last name of the contact person
  • "companyName1":
    string
    the company name | Example: PMiller ltd.
  • "companyName2":
    string
    The second company name
  • "addressLine1":
    string
    the first address line | Example: Berliner Str. 20
  • "addressLine2":
    string
    the second address line | Example: 1st Floor
  • "addressLine3":
    string
    The third address line | Example: Second door on the right
  • "postBox":
    string
    the post-office box | Example: PO Box 42
  • "mainDivision":
    string
    the main division of the country, e. g. a state or province | Example: AL
  • "mainDivisionName":
    string
    The localized display name of the main division | Example: Alabama
  • "subDivision":
    string
    The sub division code of the country. | Example: GB-PKN
  • "subDivisionName":
    string
    The localized display name of the sub division | Example: Perth and Kinross
  • "postalCode":
    string
    The postal code | Example: 14482
  • "email":
    string
    the e-mail address of the contact person | Example: pmiller@intershop.de
  • "phoneMobile":
    string
    The number of the contact person's cell phone | Example: 49364112677
  • "phoneHome":
    string
    The phone number of the house or apartment where the contact person lives | Example: 049364112677
  • "phoneBusiness":
    string
    The phone number of the contact person's company | Example: 049364112699
  • "phoneBusinessDirect":
    string
    the business phone number of the contact person that allows an outside caller to connect directly to the contact person without any help of an attendant or operator | Example: 049364112659
  • "country":
    string
    The display name of the country in the current locale | Example: Germany
  • "countryCode":
    string
    The country code | Example: DE
  • "city":
    string
    The name of the city | Example: Potsdam
  • "fax":
    string
    the fax number | Example: 049364112643
  • "usage":
    object
    Returns usage information for the address. Every bit in the returned set marks a specific usage type, like ship-from or invoice-to address. If a bit is set, the address may be used for the specific purpose mapped to this bit. Further bits may be used for custom types. Default usage for first 4 bits are Invoice-to, Ship-to, Service-to and Install-to
    {
    • "empty":
      boolean
    }
}
CostCenterRO application/json{
  • "name":
    string
    The name of the cost center | Example: my cost center
  • "type":
    string
    The type of the object. This is normally a constant that can be used to differentiate objects by their type. | Example: CostCenter
  • "approvedOrders":
    integer
    The approved orders of the cost center | Format: int32 | Example: 2
  • "active":
    boolean
    Indicates whether the cost center is active | Example: true
  • "budget":
    object
    A MoneyRO_v1 object. Describes a money object.
    {
    • "currency":
      string
      Three-letter currency code (ISO 4217) of the monetary value. | Example: USD
    • "value":
      number
      The monetary value. | Example: 10.99
    }
  • "budgetPeriod":
    string
    The budget period of the cost center | Example: monthly
  • "buyers":
    array
    An array of CostCenterUserRO objects. The cost center buyers
    [
    CostCenterUserRO: This resource holds information about a cost center user.
    {
    • "approvedOrders":
      integer
      The approved orders of the cost center buyer | Format: int32 | Example: 8
    • "budget":
      object
      A MoneyRO_v1 object. Describes a money object.
      {
      • "currency":
        string
        Three-letter currency code (ISO 4217) of the monetary value. | Example: USD
      • "value":
        number
        The monetary value. | Example: 10.99
      }
    • "budgetPeriod":
      string
      The budget period of the cost center buyer | Example: monthly
    • "buyerDetails":
      object
      A LinkRO object. A Link pointing to a resource
      {
      • "name":
        string
        the name of the returned element
      • "type":
        string
        Readonly | This is a constant: Link | Example: Link
      • "attributes":
        array
        An array of ResourceAttribute objects. the list of attributes
        [
        ResourceAttribute: An attribute
        {
        • "name":
          string
          The attribute's name
        • "type":
          string
          This is a constant: ResourceAttribute | Example: ResourceAttribute
        • "value":
          object
          The attribute's value.
        }
        ]
      • "uri":
        string
        The uri
      • "relation":
        string
        The relation of the link | Documentation: Link Relations (www.iana.org) | Possible Values: aboutalternateappendixarchivesauthorbookmarkcanonicalchaptercollectioncontentscopyrightcreate-formcurrentdescribedbydescribesdisclosureduplicateeditedit-formedit-mediaenclosurefirstglossaryhelphostshubiconindexitemlastlatest-versionlicenselrddmonitormonitor-groupnextnext-archivenofollownoreferrerpaymentpredecessor-versionprefetchprevpreviewpreviousprev-archiveprivacy-policyprofilerelatedrepliessearchsectionselfservicestartstylesheetsubsectionsuccessor-versiontagterms-of-servicetypeupversion-historyviaworking-copyworking-copy-of
      • "title":
        string
        The title of the link
      • "description":
        string
        The description of the link
      • "itemId":
        string
        the Id of the linked item
      • "attribute":
        object
        A ResourceAttribute object. An attribute
        {
        • "name":
          string
          The attribute's name
        • "type":
          string
          This is a constant: ResourceAttribute | Example: ResourceAttribute
        • "value":
          object
          The attribute's value.
        }
      }
    • "email":
      string
      The e-mail address of the person represented by this user | Example: merkel@test.intershop.de
    • "firstName":
      string
      The given name (also known as a personal name, first name, forename) of the person represented by this user | Example: Peter
    • "lastName":
      string
      The surname (also known as a family name, last name) of the person represented by this user | Example: Merkel
    • "login":
      string
      The login of the person represented by this user | Example: merkel@test.intershop.de
    • "pendingOrders":
      integer
      The pending orders of the cost center buyer | Format: int32 | Example: 2
    • "remainingBudget":
      object
      A MoneyRO_v1 object. Describes a money object.
      {
      • "currency":
        string
        Three-letter currency code (ISO 4217) of the monetary value. | Example: USD
      • "value":
        number
        The monetary value. | Example: 10.99
      }
    • "spentBudget":
      object
      A MoneyRO_v1 object. Describes a money object.
      {
      • "currency":
        string
        Three-letter currency code (ISO 4217) of the monetary value. | Example: USD
      • "value":
        number
        The monetary value. | Example: 10.99
      }
    • "title":
      string
      The personal title, like Ms., Mr. | Example: Mr.
    }
    ]
  • "costCenterId":
    string
    The unique cost center ID assigned by the customer | Example: 007
  • "costCenterOwner":
    object
    A CostCenterUserRO object. This resource holds information about a cost center user.
    {
    • "approvedOrders":
      integer
      The approved orders of the cost center buyer | Format: int32 | Example: 8
    • "budget":
      object
      A MoneyRO_v1 object. Describes a money object.
      {
      • "currency":
        string
        Three-letter currency code (ISO 4217) of the monetary value. | Example: USD
      • "value":
        number
        The monetary value. | Example: 10.99
      }
    • "budgetPeriod":
      string
      The budget period of the cost center buyer | Example: monthly
    • "buyerDetails":
      object
      A LinkRO object. A Link pointing to a resource
      {
      • "name":
        string
        the name of the returned element
      • "type":
        string
        Readonly | This is a constant: Link | Example: Link
      • "attributes":
        array
        An array of ResourceAttribute objects. the list of attributes
        [
        ResourceAttribute: An attribute
        {
        • "name":
          string
          The attribute's name
        • "type":
          string
          This is a constant: ResourceAttribute | Example: ResourceAttribute
        • "value":
          object
          The attribute's value.
        }
        ]
      • "uri":
        string
        The uri
      • "relation":
        string
        The relation of the link | Documentation: Link Relations (www.iana.org) | Possible Values: aboutalternateappendixarchivesauthorbookmarkcanonicalchaptercollectioncontentscopyrightcreate-formcurrentdescribedbydescribesdisclosureduplicateeditedit-formedit-mediaenclosurefirstglossaryhelphostshubiconindexitemlastlatest-versionlicenselrddmonitormonitor-groupnextnext-archivenofollownoreferrerpaymentpredecessor-versionprefetchprevpreviewpreviousprev-archiveprivacy-policyprofilerelatedrepliessearchsectionselfservicestartstylesheetsubsectionsuccessor-versiontagterms-of-servicetypeupversion-historyviaworking-copyworking-copy-of
      • "title":
        string
        The title of the link
      • "description":
        string
        The description of the link
      • "itemId":
        string
        the Id of the linked item
      • "attribute":
        object
        A ResourceAttribute object. An attribute
        {
        • "name":
          string
          The attribute's name
        • "type":
          string
          This is a constant: ResourceAttribute | Example: ResourceAttribute
        • "value":
          object
          The attribute's value.
        }
      }
    • "email":
      string
      The e-mail address of the person represented by this user | Example: merkel@test.intershop.de
    • "firstName":
      string
      The given name (also known as a personal name, first name, forename) of the person represented by this user | Example: Peter
    • "lastName":
      string
      The surname (also known as a family name, last name) of the person represented by this user | Example: Merkel
    • "login":
      string
      The login of the person represented by this user | Example: merkel@test.intershop.de
    • "pendingOrders":
      integer
      The pending orders of the cost center buyer | Format: int32 | Example: 2
    • "remainingBudget":
      object
      A MoneyRO_v1 object. Describes a money object.
      {
      • "currency":
        string
        Three-letter currency code (ISO 4217) of the monetary value. | Example: USD
      • "value":
        number
        The monetary value. | Example: 10.99
      }
    • "spentBudget":
      object
      A MoneyRO_v1 object. Describes a money object.
      {
      • "currency":
        string
        Three-letter currency code (ISO 4217) of the monetary value. | Example: USD
      • "value":
        number
        The monetary value. | Example: 10.99
      }
    • "title":
      string
      The personal title, like Ms., Mr. | Example: Mr.
    }
  • "id":
    string
    The unique cost center ID assigned by the system | Example: q2QKAEsBiyQAAAFjXFBB6G14
  • "orders":
    array
    An array of OrderRO objects. The orders of the cost center
    [
    OrderRO: This resource holds information on an order of a cost center.
    {
    • "name":
      string
      The name of an element.
    • "type":
      string
      The type of the object. This is normally a constant that can be used to differentiate objects by their type. | Example: Order
    • "buyer":
      object
      A LinkRO object. A Link pointing to a resource
      {
      • "name":
        string
        the name of the returned element
      • "type":
        string
        Readonly | This is a constant: Link | Example: Link
      • "attributes":
        array
        An array of ResourceAttribute objects. the list of attributes
        [
        ResourceAttribute: An attribute
        {
        • "name":
          string
          The attribute's name
        • "type":
          string
          This is a constant: ResourceAttribute | Example: ResourceAttribute
        • "value":
          object
          The attribute's value.
        }
        ]
      • "uri":
        string
        The uri
      • "relation":
        string
        The relation of the link | Documentation: Link Relations (www.iana.org) | Possible Values: aboutalternateappendixarchivesauthorbookmarkcanonicalchaptercollectioncontentscopyrightcreate-formcurrentdescribedbydescribesdisclosureduplicateeditedit-formedit-mediaenclosurefirstglossaryhelphostshubiconindexitemlastlatest-versionlicenselrddmonitormonitor-groupnextnext-archivenofollownoreferrerpaymentpredecessor-versionprefetchprevpreviewpreviousprev-archiveprivacy-policyprofilerelatedrepliessearchsectionselfservicestartstylesheetsubsectionsuccessor-versiontagterms-of-servicetypeupversion-historyviaworking-copyworking-copy-of
      • "title":
        string
        The title of the link
      • "description":
        string
        The description of the link
      • "itemId":
        string
        the Id of the linked item
      • "attribute":
        object
        A ResourceAttribute object. An attribute
        {
        • "name":
          string
          The attribute's name
        • "type":
          string
          This is a constant: ResourceAttribute | Example: ResourceAttribute
        • "value":
          object
          The attribute's value.
        }
      }
    • "items":
      number
      The order count | Example: 23
    • "order":
      object
      A LinkRO object. A Link pointing to a resource
      {
      • "name":
        string
        the name of the returned element
      • "type":
        string
        Readonly | This is a constant: Link | Example: Link
      • "attributes":
        array
        An array of ResourceAttribute objects. the list of attributes
        [
        ResourceAttribute: An attribute
        {
        • "name":
          string
          The attribute's name
        • "type":
          string
          This is a constant: ResourceAttribute | Example: ResourceAttribute
        • "value":
          object
          The attribute's value.
        }
        ]
      • "uri":
        string
        The uri
      • "relation":
        string
        The relation of the link | Documentation: Link Relations (www.iana.org) | Possible Values: aboutalternateappendixarchivesauthorbookmarkcanonicalchaptercollectioncontentscopyrightcreate-formcurrentdescribedbydescribesdisclosureduplicateeditedit-formedit-mediaenclosurefirstglossaryhelphostshubiconindexitemlastlatest-versionlicenselrddmonitormonitor-groupnextnext-archivenofollownoreferrerpaymentpredecessor-versionprefetchprevpreviewpreviousprev-archiveprivacy-policyprofilerelatedrepliessearchsectionselfservicestartstylesheetsubsectionsuccessor-versiontagterms-of-servicetypeupversion-historyviaworking-copyworking-copy-of
      • "title":
        string
        The title of the link
      • "description":
        string
        The description of the link
      • "itemId":
        string
        the Id of the linked item
      • "attribute":
        object
        A ResourceAttribute object. An attribute
        {
        • "name":
          string
          The attribute's name
        • "type":
          string
          This is a constant: ResourceAttribute | Example: ResourceAttribute
        • "value":
          object
          The attribute's value.
        }
      }
    • "orderDate":
      array
      An array of integer literals. The order date | Example: ["2020","5","27"]
    • "orderNo":
      string
      The order no | Example: 001
    • "orderStatus":
      string
      The order status | Example: new
    • "orderTotalGross":
      object
      A MoneyRO_v1 object. Describes a money object.
      {
      • "currency":
        string
        Three-letter currency code (ISO 4217) of the monetary value. | Example: USD
      • "value":
        number
        The monetary value. | Example: 10.99
      }
    • "orderTotalNet":
      object
      A MoneyRO_v1 object. Describes a money object.
      {
      • "currency":
        string
        Three-letter currency code (ISO 4217) of the monetary value. | Example: USD
      • "value":
        number
        The monetary value. | Example: 10.99
      }
    }
    ]
  • "pendingOrders":
    integer
    The amount of pending orders of the cost center | Format: int32 | Example: 2
  • "remainingBudget":
    object
    A MoneyRO_v1 object. Describes a money object.
    {
    • "currency":
      string
      Three-letter currency code (ISO 4217) of the monetary value. | Example: USD
    • "value":
      number
      The monetary value. | Example: 10.99
    }
  • "spentBudget":
    object
    A MoneyRO_v1 object. Describes a money object.
    {
    • "currency":
      string
      Three-letter currency code (ISO 4217) of the monetary value. | Example: USD
    • "value":
      number
      The monetary value. | Example: 10.99
    }
}
CostCenterUserRO application/json{
  • "approvedOrders":
    integer
    The approved orders of the cost center buyer | Format: int32 | Example: 8
  • "budget":
    object
    A MoneyRO_v1 object. Describes a money object.
    {
    • "currency":
      string
      Three-letter currency code (ISO 4217) of the monetary value. | Example: USD
    • "value":
      number
      The monetary value. | Example: 10.99
    }
  • "budgetPeriod":
    string
    The budget period of the cost center buyer | Example: monthly
  • "buyerDetails":
    object
    A LinkRO object. A Link pointing to a resource
    {
    • "name":
      string
      the name of the returned element
    • "type":
      string
      Readonly | This is a constant: Link | Example: Link
    • "attributes":
      array
      An array of ResourceAttribute objects. the list of attributes
      [
      ResourceAttribute: An attribute
      {
      • "name":
        string
        The attribute's name
      • "type":
        string
        This is a constant: ResourceAttribute | Example: ResourceAttribute
      • "value":
        object
        The attribute's value.
      }
      ]
    • "uri":
      string
      The uri
    • "relation":
      string
      The relation of the link | Documentation: Link Relations (www.iana.org) | Possible Values: aboutalternateappendixarchivesauthorbookmarkcanonicalchaptercollectioncontentscopyrightcreate-formcurrentdescribedbydescribesdisclosureduplicateeditedit-formedit-mediaenclosurefirstglossaryhelphostshubiconindexitemlastlatest-versionlicenselrddmonitormonitor-groupnextnext-archivenofollownoreferrerpaymentpredecessor-versionprefetchprevpreviewpreviousprev-archiveprivacy-policyprofilerelatedrepliessearchsectionselfservicestartstylesheetsubsectionsuccessor-versiontagterms-of-servicetypeupversion-historyviaworking-copyworking-copy-of
    • "title":
      string
      The title of the link
    • "description":
      string
      The description of the link
    • "itemId":
      string
      the Id of the linked item
    • "attribute":
      object
      A ResourceAttribute object. An attribute
      {
      • "name":
        string
        The attribute's name
      • "type":
        string
        This is a constant: ResourceAttribute | Example: ResourceAttribute
      • "value":
        object
        The attribute's value.
      }
    }
  • "email":
    string
    The e-mail address of the person represented by this user | Example: merkel@test.intershop.de
  • "firstName":
    string
    The given name (also known as a personal name, first name, forename) of the person represented by this user | Example: Peter
  • "lastName":
    string
    The surname (also known as a family name, last name) of the person represented by this user | Example: Merkel
  • "login":
    string
    The login of the person represented by this user | Example: merkel@test.intershop.de
  • "pendingOrders":
    integer
    The pending orders of the cost center buyer | Format: int32 | Example: 2
  • "remainingBudget":
    object
    A MoneyRO_v1 object. Describes a money object.
    {
    • "currency":
      string
      Three-letter currency code (ISO 4217) of the monetary value. | Example: USD
    • "value":
      number
      The monetary value. | Example: 10.99
    }
  • "spentBudget":
    object
    A MoneyRO_v1 object. Describes a money object.
    {
    • "currency":
      string
      Three-letter currency code (ISO 4217) of the monetary value. | Example: USD
    • "value":
      number
      The monetary value. | Example: 10.99
    }
  • "title":
    string
    The personal title, like Ms., Mr. | Example: Mr.
}
CredentialsRO application/json{
  • "name":
    string
    The name of an element.
  • "type":
    string
    Readonly | The type of the object. This is normally a constant that can be used to differentiate objects by their type.
  • "login":
    string
    the login | Example: pmiller@test.intershop.de
  • "password":
    string
    the password | Example: !InterShop00!
  • "securityQuestion":
    string
    the security question | Example: what was the name of your first pet?
  • "securityQuestionAnswer":
    string
    the security questions answer | Example: Snoopy
}
GiftCardAndCertificateRO application/json{
  • "name":
    string
    The name of an element.
  • "type":
    string
    The type of the object. This is normally a constant that can be used to differentiate objects by their type. | Example: GiftCardAndCertificate
  • "currency":
    string
    The currency of the gift card | Example: USD
  • "amount":
    number
    The value of the gift card | Example: 25
  • "amountRemaining":
    number
    The remaining value of the gift card | Example: 12.73
}
LinkRO application/json[
LinkRO: A Link pointing to a resource
{
  • "name":
    string
    the name of the returned element
  • "type":
    string
    Readonly | This is a constant: Link | Example: Link
  • "attributes":
    array
    An array of ResourceAttribute objects. the list of attributes
    [
    ResourceAttribute: An attribute
    {
    • "name":
      string
      The attribute's name
    • "type":
      string
      This is a constant: ResourceAttribute | Example: ResourceAttribute
    • "value":
      object
      The attribute's value.
    }
    ]
  • "uri":
    string
    The uri
  • "relation":
    string
    The relation of the link | Documentation: Link Relations (www.iana.org) | Possible Values: aboutalternateappendixarchivesauthorbookmarkcanonicalchaptercollectioncontentscopyrightcreate-formcurrentdescribedbydescribesdisclosureduplicateeditedit-formedit-mediaenclosurefirstglossaryhelphostshubiconindexitemlastlatest-versionlicenselrddmonitormonitor-groupnextnext-archivenofollownoreferrerpaymentpredecessor-versionprefetchprevpreviewpreviousprev-archiveprivacy-policyprofilerelatedrepliessearchsectionselfservicestartstylesheetsubsectionsuccessor-versiontagterms-of-servicetypeupversion-historyviaworking-copyworking-copy-of
  • "title":
    string
    The title of the link
  • "description":
    string
    The description of the link
  • "itemId":
    string
    the Id of the linked item
  • "attribute":
    object
    A ResourceAttribute object. An attribute
    {
    • "name":
      string
      The attribute's name
    • "type":
      string
      This is a constant: ResourceAttribute | Example: ResourceAttribute
    • "value":
      object
      The attribute's value.
    }
}
]
LinkROResourceCollectionRO application/json{
  • "pageable":
    string
    The pageable ID
  • "total":
    integer
    The pageable amount total | Format: int32
  • "offset":
    integer
    The pageable offset | Format: int32
  • "amount":
    integer
    The pageable amount | Format: int32
  • "elements":
    array
    An array of LinkRO objects. The list of elements
    [
    LinkRO: A Link pointing to a resource
    {
    • "name":
      string
      the name of the returned element
    • "type":
      string
      Readonly | This is a constant: Link | Example: Link
    • "attributes":
      array
      An array of ResourceAttribute objects. the list of attributes
      [
      ResourceAttribute: An attribute
      {
      • "name":
        string
        The attribute's name
      • "type":
        string
        This is a constant: ResourceAttribute | Example: ResourceAttribute
      • "value":
        object
        The attribute's value.
      }
      ]
    • "uri":
      string
      The uri
    • "relation":
      string
      The relation of the link | Documentation: Link Relations (www.iana.org) | Possible Values: aboutalternateappendixarchivesauthorbookmarkcanonicalchaptercollectioncontentscopyrightcreate-formcurrentdescribedbydescribesdisclosureduplicateeditedit-formedit-mediaenclosurefirstglossaryhelphostshubiconindexitemlastlatest-versionlicenselrddmonitormonitor-groupnextnext-archivenofollownoreferrerpaymentpredecessor-versionprefetchprevpreviewpreviousprev-archiveprivacy-policyprofilerelatedrepliessearchsectionselfservicestartstylesheetsubsectionsuccessor-versiontagterms-of-servicetypeupversion-historyviaworking-copyworking-copy-of
    • "title":
      string
      The title of the link
    • "description":
      string
      The description of the link
    • "itemId":
      string
      the Id of the linked item
    • "attribute":
      object
      A ResourceAttribute object. An attribute
      {
      • "name":
        string
        The attribute's name
      • "type":
        string
        This is a constant: ResourceAttribute | Example: ResourceAttribute
      • "value":
        object
        The attribute's value.
      }
    }
    ]
  • "type":
    string
    The type of the object. This is normally a constant that can be used to differentiate objects by their type.
  • "sortKeys":
    array
    An array of string literals. The keys to sort for
  • "name":
    string
    The name of an element.
}
NewCostCenterBuyerRO application/json{
  • "budget":
    object
    A MoneyRO_v1 object. Describes a money object.
    {
    • "currency":
      string
      Three-letter currency code (ISO 4217) of the monetary value. | Example: USD
    • "value":
      number
      The monetary value. | Example: 10.99
    }
  • "budgetPeriod":
    string
    The budget period of the cost center buyer | Example: monthly
  • "login":
    string
    The login of the buyer | Example: abc@login.de
}
NewCostCenterRO application/json{
  • "name":
    string
    The name of the cost center | Example: my cost center
  • "type":
    string
    The type of the object. This is normally a constant that can be used to differentiate objects by their type. | Example: NewCostCenter
  • "budget":
    object
    A MoneyRO_v1 object. Describes a money object.
    {
    • "currency":
      string
      Three-letter currency code (ISO 4217) of the monetary value. | Example: USD
    • "value":
      number
      The monetary value. | Example: 10.99
    }
  • "budgetPeriod":
    string
    The budget period of the cost center | Example: monthly
  • "costCenterId":
    string
    The unique cost center ID assigned by the customer | Example: 007
  • "costCenterOwner":
    object
    A CostCenterUserRO object. This resource holds information about a cost center user.
    {
    • "approvedOrders":
      integer
      The approved orders of the cost center buyer | Format: int32 | Example: 8
    • "budget":
      object
      A MoneyRO_v1 object. Describes a money object.
      {
      • "currency":
        string
        Three-letter currency code (ISO 4217) of the monetary value. | Example: USD
      • "value":
        number
        The monetary value. | Example: 10.99
      }
    • "budgetPeriod":
      string
      The budget period of the cost center buyer | Example: monthly
    • "buyerDetails":
      object
      A LinkRO object. A Link pointing to a resource
      {
      • "name":
        string
        the name of the returned element
      • "type":
        string
        Readonly | This is a constant: Link | Example: Link
      • "attributes":
        array
        An array of ResourceAttribute objects. the list of attributes
        [
        ResourceAttribute: An attribute
        {
        • "name":
          string
          The attribute's name
        • "type":
          string
          This is a constant: ResourceAttribute | Example: ResourceAttribute
        • "value":
          object
          The attribute's value.
        }
        ]
      • "uri":
        string
        The uri
      • "relation":
        string
        The relation of the link | Documentation: Link Relations (www.iana.org) | Possible Values: aboutalternateappendixarchivesauthorbookmarkcanonicalchaptercollectioncontentscopyrightcreate-formcurrentdescribedbydescribesdisclosureduplicateeditedit-formedit-mediaenclosurefirstglossaryhelphostshubiconindexitemlastlatest-versionlicenselrddmonitormonitor-groupnextnext-archivenofollownoreferrerpaymentpredecessor-versionprefetchprevpreviewpreviousprev-archiveprivacy-policyprofilerelatedrepliessearchsectionselfservicestartstylesheetsubsectionsuccessor-versiontagterms-of-servicetypeupversion-historyviaworking-copyworking-copy-of
      • "title":
        string
        The title of the link
      • "description":
        string
        The description of the link
      • "itemId":
        string
        the Id of the linked item
      • "attribute":
        object
        A ResourceAttribute object. An attribute
        {
        • "name":
          string
          The attribute's name
        • "type":
          string
          This is a constant: ResourceAttribute | Example: ResourceAttribute
        • "value":
          object
          The attribute's value.
        }
      }
    • "email":
      string
      The e-mail address of the person represented by this user | Example: merkel@test.intershop.de
    • "firstName":
      string
      The given name (also known as a personal name, first name, forename) of the person represented by this user | Example: Peter
    • "lastName":
      string
      The surname (also known as a family name, last name) of the person represented by this user | Example: Merkel
    • "login":
      string
      The login of the person represented by this user | Example: merkel@test.intershop.de
    • "pendingOrders":
      integer
      The pending orders of the cost center buyer | Format: int32 | Example: 2
    • "remainingBudget":
      object
      A MoneyRO_v1 object. Describes a money object.
      {
      • "currency":
        string
        Three-letter currency code (ISO 4217) of the monetary value. | Example: USD
      • "value":
        number
        The monetary value. | Example: 10.99
      }
    • "spentBudget":
      object
      A MoneyRO_v1 object. Describes a money object.
      {
      • "currency":
        string
        Three-letter currency code (ISO 4217) of the monetary value. | Example: USD
      • "value":
        number
        The monetary value. | Example: 10.99
      }
    • "title":
      string
      The personal title, like Ms., Mr. | Example: Mr.
    }
  • "id":
    string
    The unique cost center ID assigned by the system | Example: q2QKAEsBiyQAAAFjXFBB6G14
}
NewCustomerRO application/json{
  • "address":
    object
    A AddressRO object. This resource holds the details of an address.
    {
    • "name":
      string
      The name of an element.
    • "type":
      string
      The type of the object. This is normally a constant that can be used to differentiate objects by their type. | Example: Address
    • "urn":
      string
      the URN representation of this address | Example: urn:address:customer:1234567890:0987654321
    • "id":
      string
      The ID of the returned element | Example: vagKAB17gg4AAAFGSkFqQASI
    • "addressName":
      string
      The name of the address | Example: customeraddr-ABCDEFGPRMuMCscyXgSRVU
    • "title":
      string
      The (personal) title of the contact person, like 'Mr.' or 'Ms.' | Example: Mrs.
    • "aristocraticTitle":
      string
      the aristocratic title of the contact person, like Lord or Lady
    • "jobTitle":
      string
      the job title of the contact person | Example: CEO
    • "honorific":
      string
      the honorific title of the contact person that denotes the honored person's occupation, like Captain, Coach, Officer, Reverend or the academic title, like PhD
    • "firstName":
      string
      The (first) given name of the contact person | Example: Patricia
    • "secondName":
      string
      the second given name of the contact person | Example: Luise
    • "lastName":
      string
      The last name of the contact person | Example: Miller
    • "secondLastName":
      string
      the second last name of the contact person
    • "companyName1":
      string
      the company name | Example: PMiller ltd.
    • "companyName2":
      string
      The second company name
    • "addressLine1":
      string
      the first address line | Example: Berliner Str. 20
    • "addressLine2":
      string
      the second address line | Example: 1st Floor
    • "addressLine3":
      string
      The third address line | Example: Second door on the right
    • "postBox":
      string
      the post-office box | Example: PO Box 42
    • "mainDivision":
      string
      the main division of the country, e. g. a state or province | Example: AL
    • "mainDivisionName":
      string
      The localized display name of the main division | Example: Alabama
    • "subDivision":
      string
      The sub division code of the country. | Example: GB-PKN
    • "subDivisionName":
      string
      The localized display name of the sub division | Example: Perth and Kinross
    • "postalCode":
      string
      The postal code | Example: 14482
    • "email":
      string
      the e-mail address of the contact person | Example: pmiller@intershop.de
    • "phoneMobile":
      string
      The number of the contact person's cell phone | Example: 49364112677
    • "phoneHome":
      string
      The phone number of the house or apartment where the contact person lives | Example: 049364112677
    • "phoneBusiness":
      string
      The phone number of the contact person's company | Example: 049364112699
    • "phoneBusinessDirect":
      string
      the business phone number of the contact person that allows an outside caller to connect directly to the contact person without any help of an attendant or operator | Example: 049364112659
    • "country":
      string
      The display name of the country in the current locale | Example: Germany
    • "countryCode":
      string
      The country code | Example: DE
    • "city":
      string
      The name of the city | Example: Potsdam
    • "fax":
      string
      the fax number | Example: 049364112643
    • "usage":
      object
      Returns usage information for the address. Every bit in the returned set marks a specific usage type, like ship-from or invoice-to address. If a bit is set, the address may be used for the specific purpose mapped to this bit. Further bits may be used for custom types. Default usage for first 4 bits are Invoice-to, Ship-to, Service-to and Install-to
      {
      • "empty":
        boolean
      }
    }
  • "birthday":
    string
    the birthday of the customer | Example: 1970-03-10T00:00:00.000Z
  • "credentials":
    object
    A CredentialsRO object.
    {
    • "name":
      string
      The name of an element.
    • "type":
      string
      Readonly | The type of the object. This is normally a constant that can be used to differentiate objects by their type.
    • "login":
      string
      the login | Example: pmiller@test.intershop.de
    • "password":
      string
      the password | Example: !InterShop00!
    • "securityQuestion":
      string
      the security question | Example: what was the name of your first pet?
    • "securityQuestionAnswer":
      string
      the security questions answer | Example: Snoopy
    }
  • "customerNo":
    string
  • "customerType":
    string
    Readonly | the type of the customer | Example: PRIVATE
  • "email":
    string
    the email address of the customer | Example: patrik@test.intershop.net
  • "fax":
    string
    the fax number of the customer | Example: 4211324
  • "firstName":
    string
    the first name of the customer | Example: Patrik
  • "lastName":
    string
    the last name of the customer | Example: Mueller
  • "login":
    string
    the login(username) of the customer | Example: patrik_83
  • "name":
    string
    The name of an element.
  • "phoneBusiness":
    string
    the business phone number of the customer | Example: 4211324
  • "phoneHome":
    string
    the phone home number of the customer | Example: 4211324
  • "phoneMobile":
    string
    the mobile phone number of the customer | Example: 4211324
  • "preferredInvoiceToAddress":
    object
    A AddressRO object. This resource holds the details of an address.
    {
    • "name":
      string
      The name of an element.
    • "type":
      string
      The type of the object. This is normally a constant that can be used to differentiate objects by their type. | Example: Address
    • "urn":
      string
      the URN representation of this address | Example: urn:address:customer:1234567890:0987654321
    • "id":
      string
      The ID of the returned element | Example: vagKAB17gg4AAAFGSkFqQASI
    • "addressName":
      string
      The name of the address | Example: customeraddr-ABCDEFGPRMuMCscyXgSRVU
    • "title":
      string
      The (personal) title of the contact person, like 'Mr.' or 'Ms.' | Example: Mrs.
    • "aristocraticTitle":
      string
      the aristocratic title of the contact person, like Lord or Lady
    • "jobTitle":
      string
      the job title of the contact person | Example: CEO
    • "honorific":
      string
      the honorific title of the contact person that denotes the honored person's occupation, like Captain, Coach, Officer, Reverend or the academic title, like PhD
    • "firstName":
      string
      The (first) given name of the contact person | Example: Patricia
    • "secondName":
      string
      the second given name of the contact person | Example: Luise
    • "lastName":
      string
      The last name of the contact person | Example: Miller
    • "secondLastName":
      string
      the second last name of the contact person
    • "companyName1":
      string
      the company name | Example: PMiller ltd.
    • "companyName2":
      string
      The second company name
    • "addressLine1":
      string
      the first address line | Example: Berliner Str. 20
    • "addressLine2":
      string
      the second address line | Example: 1st Floor
    • "addressLine3":
      string
      The third address line | Example: Second door on the right
    • "postBox":
      string
      the post-office box | Example: PO Box 42
    • "mainDivision":
      string
      the main division of the country, e. g. a state or province | Example: AL
    • "mainDivisionName":
      string
      The localized display name of the main division | Example: Alabama
    • "subDivision":
      string
      The sub division code of the country. | Example: GB-PKN
    • "subDivisionName":
      string
      The localized display name of the sub division | Example: Perth and Kinross
    • "postalCode":
      string
      The postal code | Example: 14482
    • "email":
      string
      the e-mail address of the contact person | Example: pmiller@intershop.de
    • "phoneMobile":
      string
      The number of the contact person's cell phone | Example: 49364112677
    • "phoneHome":
      string
      The phone number of the house or apartment where the contact person lives | Example: 049364112677
    • "phoneBusiness":
      string
      The phone number of the contact person's company | Example: 049364112699
    • "phoneBusinessDirect":
      string
      the business phone number of the contact person that allows an outside caller to connect directly to the contact person without any help of an attendant or operator | Example: 049364112659
    • "country":
      string
      The display name of the country in the current locale | Example: Germany
    • "countryCode":
      string
      The country code | Example: DE
    • "city":
      string
      The name of the city | Example: Potsdam
    • "fax":
      string
      the fax number | Example: 049364112643
    • "usage":
      object
      Returns usage information for the address. Every bit in the returned set marks a specific usage type, like ship-from or invoice-to address. If a bit is set, the address may be used for the specific purpose mapped to this bit. Further bits may be used for custom types. Default usage for first 4 bits are Invoice-to, Ship-to, Service-to and Install-to
      {
      • "empty":
        boolean
      }
    }
  • "preferredLanguage":
    string
    the preferred language of the customer | Example: de_DE
  • "preferredPaymentInstrument":
    object
    A PaymentRO object.
    {
    • "name":
      string
      The name of an element.
    • "type":
      string
      The type of the object. This is normally a constant that can be used to differentiate objects by their type. | Example: Payment
    • "attributes":
      array
      An array of ResourceAttribute objects. the list of attributes
      [
      ResourceAttribute: An attribute
      {
      • "name":
        string
        The attribute's name
      • "type":
        string
        This is a constant: ResourceAttribute | Example: ResourceAttribute
      • "value":
        object
        The attribute's value.
      }
      ]
    • "id":
      string
    • "limitedTenderBalance":
      object
      A MoneyRO object. Money combines a currency and a money amount.
      {
      • "name":
        string
        The name of an element.
      • "type":
        string
        Readonly | This is a constant: Money | Example: Money
      • "value":
        number
        The monetary value. | Example: 10.99
      • "currencyMnemonic":
        string
        Deprecated
      • "currency":
        string
        Three-letter currency code (ISO 4217) of the monetary value. | Example: USD
      }
    • "paymentTotalAmount":
      object
      A MoneyRO object. Money combines a currency and a money amount.
      {
      • "name":
        string
        The name of an element.
      • "type":
        string
        Readonly | This is a constant: Money | Example: Money
      • "value":
        number
        The monetary value. | Example: 10.99
      • "currencyMnemonic":
        string
        Deprecated
      • "currency":
        string
        Three-letter currency code (ISO 4217) of the monetary value. | Example: USD
      }
    • "accountIdentifier":
      string
      Readonly | the optional account identifier for this payment instrument | Example: DE12****7890
    • "parameters":
      array
      An array of GenericPropertyROObject objects.
      [
      GenericPropertyROObject:
      {
      • "name":
        string
        The name of an element.
      • "type":
        string
        Readonly | The type of the object. This is normally a constant that can be used to differentiate objects by their type.
      • "key":
        string
      • "property":
        object
      • "displayName":
        string
      }
      ]
    • "attribute":
      object
      A ResourceAttribute object. An attribute
      {
      • "name":
        string
        The attribute's name
      • "type":
        string
        This is a constant: ResourceAttribute | Example: ResourceAttribute
      • "value":
        object
        The attribute's value.
      }
    }
  • "preferredShipToAddress":
    object
    A AddressRO object. This resource holds the details of an address.
    {
    • "name":
      string
      The name of an element.
    • "type":
      string
      The type of the object. This is normally a constant that can be used to differentiate objects by their type. | Example: Address
    • "urn":
      string
      the URN representation of this address | Example: urn:address:customer:1234567890:0987654321
    • "id":
      string
      The ID of the returned element | Example: vagKAB17gg4AAAFGSkFqQASI
    • "addressName":
      string
      The name of the address | Example: customeraddr-ABCDEFGPRMuMCscyXgSRVU
    • "title":
      string
      The (personal) title of the contact person, like 'Mr.' or 'Ms.' | Example: Mrs.
    • "aristocraticTitle":
      string
      the aristocratic title of the contact person, like Lord or Lady
    • "jobTitle":
      string
      the job title of the contact person | Example: CEO
    • "honorific":
      string
      the honorific title of the contact person that denotes the honored person's occupation, like Captain, Coach, Officer, Reverend or the academic title, like PhD
    • "firstName":
      string
      The (first) given name of the contact person | Example: Patricia
    • "secondName":
      string
      the second given name of the contact person | Example: Luise
    • "lastName":
      string
      The last name of the contact person | Example: Miller
    • "secondLastName":
      string
      the second last name of the contact person
    • "companyName1":
      string
      the company name | Example: PMiller ltd.
    • "companyName2":
      string
      The second company name
    • "addressLine1":
      string
      the first address line | Example: Berliner Str. 20
    • "addressLine2":
      string
      the second address line | Example: 1st Floor
    • "addressLine3":
      string
      The third address line | Example: Second door on the right
    • "postBox":
      string
      the post-office box | Example: PO Box 42
    • "mainDivision":
      string
      the main division of the country, e. g. a state or province | Example: AL
    • "mainDivisionName":
      string
      The localized display name of the main division | Example: Alabama
    • "subDivision":
      string
      The sub division code of the country. | Example: GB-PKN
    • "subDivisionName":
      string
      The localized display name of the sub division | Example: Perth and Kinross
    • "postalCode":
      string
      The postal code | Example: 14482
    • "email":
      string
      the e-mail address of the contact person | Example: pmiller@intershop.de
    • "phoneMobile":
      string
      The number of the contact person's cell phone | Example: 49364112677
    • "phoneHome":
      string
      The phone number of the house or apartment where the contact person lives | Example: 049364112677
    • "phoneBusiness":
      string
      The phone number of the contact person's company | Example: 049364112699
    • "phoneBusinessDirect":
      string
      the business phone number of the contact person that allows an outside caller to connect directly to the contact person without any help of an attendant or operator | Example: 049364112659
    • "country":
      string
      The display name of the country in the current locale | Example: Germany
    • "countryCode":
      string
      The country code | Example: DE
    • "city":
      string
      The name of the city | Example: Potsdam
    • "fax":
      string
      the fax number | Example: 049364112643
    • "usage":
      object
      Returns usage information for the address. Every bit in the returned set marks a specific usage type, like ship-from or invoice-to address. If a bit is set, the address may be used for the specific purpose mapped to this bit. Further bits may be used for custom types. Default usage for first 4 bits are Invoice-to, Ship-to, Service-to and Install-to
      {
      • "empty":
        boolean
      }
    }
  • "title":
    string
    the title of the customer | Example: Mr
  • "type":
    string
    The type of the object. This is normally a constant that can be used to differentiate objects by their type. | Example: PrivateCustomer
  • "userId":
    string
    the id of the user this customer is based on. If not set, credentials and user data are mandatory.
}
PaymentOptionsRO application/json{
  • "name":
    string
    The name of an element.
  • "type":
    string
    The type of the object. This is normally a constant that can be used to differentiate objects by their type. | Example: PaymentOptions
  • "methods":
    array
    An array of PaymentOptionsForMethodRO objects. payment methods that can be added via http
    [
    PaymentOptionsForMethodRO: payment methods that can be added via http
    {
    • "name":
      string
      The name of an element.
    • "type":
      string
      The type of the object. This is normally a constant that can be used to differentiate objects by their type. | Example: PaymentOptionsForMethodRO
    • "payments":
      array
      An array of PaymentOptionRO objects. the payments
      [
      PaymentOptionRO: the payments
      {
      • "name":
        string
        The name of an element.
      • "type":
        string
        The type of the object. This is normally a constant that can be used to differentiate objects by their type. | Example: PaymentOption
      • "id":
        string
        the id of the payment option | Example: ISH_INVOICE
      • "displayName":
        string
        the display name of the payment option | Example: Invoice
      • "applicability":
        string
      • "restrictions":
        array
        An array of string literals.
      • "paymentParameters":
        array
        An array of GenericPropertyROObject objects. the parameters for this payment option
        [
        GenericPropertyROObject:
        {
        • "name":
          string
          The name of an element.
        • "type":
          string
          Readonly | The type of the object. This is normally a constant that can be used to differentiate objects by their type.
        • "key":
          string
        • "property":
          object
        • "displayName":
          string
        }
        ]
      }
      ]
    • "method":
      string
      the http method to use when adding this method | Example: POST
    }
    ]
}
PaymentRO application/json{
  • "name":
    string
    The name of an element.
  • "type":
    string
    The type of the object. This is normally a constant that can be used to differentiate objects by their type. | Example: Payment
  • "attributes":
    array
    An array of ResourceAttribute objects. the list of attributes
    [
    ResourceAttribute: An attribute
    {
    • "name":
      string
      The attribute's name
    • "type":
      string
      This is a constant: ResourceAttribute | Example: ResourceAttribute
    • "value":
      object
      The attribute's value.
    }
    ]
  • "id":
    string
  • "limitedTenderBalance":
    object
    A MoneyRO object. Money combines a currency and a money amount.
    {
    • "name":
      string
      The name of an element.
    • "type":
      string
      Readonly | This is a constant: Money | Example: Money
    • "value":
      number
      The monetary value. | Example: 10.99
    • "currencyMnemonic":
      string
      Deprecated
    • "currency":
      string
      Three-letter currency code (ISO 4217) of the monetary value. | Example: USD
    }
  • "paymentTotalAmount":
    object
    A MoneyRO object. Money combines a currency and a money amount.
    {
    • "name":
      string
      The name of an element.
    • "type":
      string
      Readonly | This is a constant: Money | Example: Money
    • "value":
      number
      The monetary value. | Example: 10.99
    • "currencyMnemonic":
      string
      Deprecated
    • "currency":
      string
      Three-letter currency code (ISO 4217) of the monetary value. | Example: USD
    }
  • "accountIdentifier":
    string
    Readonly | the optional account identifier for this payment instrument | Example: DE12****7890
  • "parameters":
    array
    An array of GenericPropertyROObject objects.
    [
    GenericPropertyROObject:
    {
    • "name":
      string
      The name of an element.
    • "type":
      string
      Readonly | The type of the object. This is normally a constant that can be used to differentiate objects by their type.
    • "key":
      string
    • "property":
      object
    • "displayName":
      string
    }
    ]
  • "attribute":
    object
    A ResourceAttribute object. An attribute
    {
    • "name":
      string
      The attribute's name
    • "type":
      string
      This is a constant: ResourceAttribute | Example: ResourceAttribute
    • "value":
      object
      The attribute's value.
    }
}
PrivateCustomerRO application/json{
  • "birthday":
    string
    the birthday of the customer | Example: 1970-03-10T00:00:00.000Z
  • "customerNo":
    string
  • "customerType":
    string
    Readonly | the type of the customer | Example: PRIVATE
  • "email":
    string
    the email address of the customer | Example: patrik@test.intershop.net
  • "fax":
    string
    the fax number of the customer | Example: 4211324
  • "firstName":
    string
    the first name of the customer | Example: Patrik
  • "lastName":
    string
    the last name of the customer | Example: Mueller
  • "login":
    string
    the login(username) of the customer | Example: patrik_83
  • "name":
    string
    The name of an element.
  • "phoneBusiness":
    string
    the business phone number of the customer | Example: 4211324
  • "phoneHome":
    string
    the phone home number of the customer | Example: 4211324
  • "phoneMobile":
    string
    the mobile phone number of the customer | Example: 4211324
  • "preferredInvoiceToAddress":
    object
    A AddressRO object. This resource holds the details of an address.
    {
    • "name":
      string
      The name of an element.
    • "type":
      string
      The type of the object. This is normally a constant that can be used to differentiate objects by their type. | Example: Address
    • "urn":
      string
      the URN representation of this address | Example: urn:address:customer:1234567890:0987654321
    • "id":
      string
      The ID of the returned element | Example: vagKAB17gg4AAAFGSkFqQASI
    • "addressName":
      string
      The name of the address | Example: customeraddr-ABCDEFGPRMuMCscyXgSRVU
    • "title":
      string
      The (personal) title of the contact person, like 'Mr.' or 'Ms.' | Example: Mrs.
    • "aristocraticTitle":
      string
      the aristocratic title of the contact person, like Lord or Lady
    • "jobTitle":
      string
      the job title of the contact person | Example: CEO
    • "honorific":
      string
      the honorific title of the contact person that denotes the honored person's occupation, like Captain, Coach, Officer, Reverend or the academic title, like PhD
    • "firstName":
      string
      The (first) given name of the contact person | Example: Patricia
    • "secondName":
      string
      the second given name of the contact person | Example: Luise
    • "lastName":
      string
      The last name of the contact person | Example: Miller
    • "secondLastName":
      string
      the second last name of the contact person
    • "companyName1":
      string
      the company name | Example: PMiller ltd.
    • "companyName2":
      string
      The second company name
    • "addressLine1":
      string
      the first address line | Example: Berliner Str. 20
    • "addressLine2":
      string
      the second address line | Example: 1st Floor
    • "addressLine3":
      string
      The third address line | Example: Second door on the right
    • "postBox":
      string
      the post-office box | Example: PO Box 42
    • "mainDivision":
      string
      the main division of the country, e. g. a state or province | Example: AL
    • "mainDivisionName":
      string
      The localized display name of the main division | Example: Alabama
    • "subDivision":
      string
      The sub division code of the country. | Example: GB-PKN
    • "subDivisionName":
      string
      The localized display name of the sub division | Example: Perth and Kinross
    • "postalCode":
      string
      The postal code | Example: 14482
    • "email":
      string
      the e-mail address of the contact person | Example: pmiller@intershop.de
    • "phoneMobile":
      string
      The number of the contact person's cell phone | Example: 49364112677
    • "phoneHome":
      string
      The phone number of the house or apartment where the contact person lives | Example: 049364112677
    • "phoneBusiness":
      string
      The phone number of the contact person's company | Example: 049364112699
    • "phoneBusinessDirect":
      string
      the business phone number of the contact person that allows an outside caller to connect directly to the contact person without any help of an attendant or operator | Example: 049364112659
    • "country":
      string
      The display name of the country in the current locale | Example: Germany
    • "countryCode":
      string
      The country code | Example: DE
    • "city":
      string
      The name of the city | Example: Potsdam
    • "fax":
      string
      the fax number | Example: 049364112643
    • "usage":
      object
      Returns usage information for the address. Every bit in the returned set marks a specific usage type, like ship-from or invoice-to address. If a bit is set, the address may be used for the specific purpose mapped to this bit. Further bits may be used for custom types. Default usage for first 4 bits are Invoice-to, Ship-to, Service-to and Install-to
      {
      • "empty":
        boolean
      }
    }
  • "preferredLanguage":
    string
    the preferred language of the customer | Example: de_DE
  • "preferredPaymentInstrument":
    object
    A PaymentRO object.
    {
    • "name":
      string
      The name of an element.
    • "type":
      string
      The type of the object. This is normally a constant that can be used to differentiate objects by their type. | Example: Payment
    • "attributes":
      array
      An array of ResourceAttribute objects. the list of attributes
      [
      ResourceAttribute: An attribute
      {
      • "name":
        string
        The attribute's name
      • "type":
        string
        This is a constant: ResourceAttribute | Example: ResourceAttribute
      • "value":
        object
        The attribute's value.
      }
      ]
    • "id":
      string
    • "limitedTenderBalance":
      object
      A MoneyRO object. Money combines a currency and a money amount.
      {
      • "name":
        string
        The name of an element.
      • "type":
        string
        Readonly | This is a constant: Money | Example: Money
      • "value":
        number
        The monetary value. | Example: 10.99
      • "currencyMnemonic":
        string
        Deprecated
      • "currency":
        string
        Three-letter currency code (ISO 4217) of the monetary value. | Example: USD
      }
    • "paymentTotalAmount":
      object
      A MoneyRO object. Money combines a currency and a money amount.
      {
      • "name":
        string
        The name of an element.
      • "type":
        string
        Readonly | This is a constant: Money | Example: Money
      • "value":
        number
        The monetary value. | Example: 10.99
      • "currencyMnemonic":
        string
        Deprecated
      • "currency":
        string
        Three-letter currency code (ISO 4217) of the monetary value. | Example: USD
      }
    • "accountIdentifier":
      string
      Readonly | the optional account identifier for this payment instrument | Example: DE12****7890
    • "parameters":
      array
      An array of GenericPropertyROObject objects.
      [
      GenericPropertyROObject:
      {
      • "name":
        string
        The name of an element.
      • "type":
        string
        Readonly | The type of the object. This is normally a constant that can be used to differentiate objects by their type.
      • "key":
        string
      • "property":
        object
      • "displayName":
        string
      }
      ]
    • "attribute":
      object
      A ResourceAttribute object. An attribute
      {
      • "name":
        string
        The attribute's name
      • "type":
        string
        This is a constant: ResourceAttribute | Example: ResourceAttribute
      • "value":
        object
        The attribute's value.
      }
    }
  • "preferredShipToAddress":
    object
    A AddressRO object. This resource holds the details of an address.
    {
    • "name":
      string
      The name of an element.
    • "type":
      string
      The type of the object. This is normally a constant that can be used to differentiate objects by their type. | Example: Address
    • "urn":
      string
      the URN representation of this address | Example: urn:address:customer:1234567890:0987654321
    • "id":
      string
      The ID of the returned element | Example: vagKAB17gg4AAAFGSkFqQASI
    • "addressName":
      string
      The name of the address | Example: customeraddr-ABCDEFGPRMuMCscyXgSRVU
    • "title":
      string
      The (personal) title of the contact person, like 'Mr.' or 'Ms.' | Example: Mrs.
    • "aristocraticTitle":
      string
      the aristocratic title of the contact person, like Lord or Lady
    • "jobTitle":
      string
      the job title of the contact person | Example: CEO
    • "honorific":
      string
      the honorific title of the contact person that denotes the honored person's occupation, like Captain, Coach, Officer, Reverend or the academic title, like PhD
    • "firstName":
      string
      The (first) given name of the contact person | Example: Patricia
    • "secondName":
      string
      the second given name of the contact person | Example: Luise
    • "lastName":
      string
      The last name of the contact person | Example: Miller
    • "secondLastName":
      string
      the second last name of the contact person
    • "companyName1":
      string
      the company name | Example: PMiller ltd.
    • "companyName2":
      string
      The second company name
    • "addressLine1":
      string
      the first address line | Example: Berliner Str. 20
    • "addressLine2":
      string
      the second address line | Example: 1st Floor
    • "addressLine3":
      string
      The third address line | Example: Second door on the right
    • "postBox":
      string
      the post-office box | Example: PO Box 42
    • "mainDivision":
      string
      the main division of the country, e. g. a state or province | Example: AL
    • "mainDivisionName":
      string
      The localized display name of the main division | Example: Alabama
    • "subDivision":
      string
      The sub division code of the country. | Example: GB-PKN
    • "subDivisionName":
      string
      The localized display name of the sub division | Example: Perth and Kinross
    • "postalCode":
      string
      The postal code | Example: 14482
    • "email":
      string
      the e-mail address of the contact person | Example: pmiller@intershop.de
    • "phoneMobile":
      string
      The number of the contact person's cell phone | Example: 49364112677
    • "phoneHome":
      string
      The phone number of the house or apartment where the contact person lives | Example: 049364112677
    • "phoneBusiness":
      string
      The phone number of the contact person's company | Example: 049364112699
    • "phoneBusinessDirect":
      string
      the business phone number of the contact person that allows an outside caller to connect directly to the contact person without any help of an attendant or operator | Example: 049364112659
    • "country":
      string
      The display name of the country in the current locale | Example: Germany
    • "countryCode":
      string
      The country code | Example: DE
    • "city":
      string
      The name of the city | Example: Potsdam
    • "fax":
      string
      the fax number | Example: 049364112643
    • "usage":
      object
      Returns usage information for the address. Every bit in the returned set marks a specific usage type, like ship-from or invoice-to address. If a bit is set, the address may be used for the specific purpose mapped to this bit. Further bits may be used for custom types. Default usage for first 4 bits are Invoice-to, Ship-to, Service-to and Install-to
      {
      • "empty":
        boolean
      }
    }
  • "title":
    string
    the title of the customer | Example: Mr
  • "type":
    string
    The type of the object. This is normally a constant that can be used to differentiate objects by their type. | Example: PrivateCustomer
}
ResourceCollectionROLinkRO application/json{
  • "pageable":
    string
    the pageable ID
  • "total":
    integer
    the pageable amount total | Format: int32
  • "offset":
    integer
    the pageable offset | Format: int32
  • "amount":
    integer
    the pageable amount | Format: int32
  • "elements":
    array
    An array of LinkRO objects. the list of elements
    [
    LinkRO: A Link pointing to a resource
    {
    • "name":
      string
      the name of the returned element
    • "type":
      string
      Readonly | This is a constant: Link | Example: Link
    • "attributes":
      array
      An array of ResourceAttribute objects. the list of attributes
      [
      ResourceAttribute: An attribute
      {
      • "name":
        string
        The attribute's name
      • "type":
        string
        This is a constant: ResourceAttribute | Example: ResourceAttribute
      • "value":
        object
        The attribute's value.
      }
      ]
    • "uri":
      string
      The uri
    • "relation":
      string
      The relation of the link | Documentation: Link Relations (www.iana.org) | Possible Values: aboutalternateappendixarchivesauthorbookmarkcanonicalchaptercollectioncontentscopyrightcreate-formcurrentdescribedbydescribesdisclosureduplicateeditedit-formedit-mediaenclosurefirstglossaryhelphostshubiconindexitemlastlatest-versionlicenselrddmonitormonitor-groupnextnext-archivenofollownoreferrerpaymentpredecessor-versionprefetchprevpreviewpreviousprev-archiveprivacy-policyprofilerelatedrepliessearchsectionselfservicestartstylesheetsubsectionsuccessor-versiontagterms-of-servicetypeupversion-historyviaworking-copyworking-copy-of
    • "title":
      string
      The title of the link
    • "description":
      string
      The description of the link
    • "itemId":
      string
      the Id of the linked item
    • "attribute":
      object
      A ResourceAttribute object. An attribute
      {
      • "name":
        string
        The attribute's name
      • "type":
        string
        This is a constant: ResourceAttribute | Example: ResourceAttribute
      • "value":
        object
        The attribute's value.
      }
    }
    ]
  • "type":
    string
    This is a constant: ResourceCollection | Example: ResourceCollection
  • "sortKeys":
    array
    An array of string literals. the keys to sort for
  • "name":
    string
    the name of the returned element
}
SMBCustomerRO application/json{
  • "companyName":
    string
    the company name of the customer | Example: AgroNet
  • "companyName2":
    string
  • "customerNo":
    string
  • "customerType":
    string
    Readonly | the type of the customer | Example: PRIVATE
  • "description":
    string
    the description of the customer | Example: AgroNet description
  • "industry":
    string
    the industry of the customer | Example: agrar industry
  • "name":
    string
    The name of an element.
  • "preferredInvoiceToAddress":
    object
    A AddressRO object. This resource holds the details of an address.
    {
    • "name":
      string
      The name of an element.
    • "type":
      string
      The type of the object. This is normally a constant that can be used to differentiate objects by their type. | Example: Address
    • "urn":
      string
      the URN representation of this address | Example: urn:address:customer:1234567890:0987654321
    • "id":
      string
      The ID of the returned element | Example: vagKAB17gg4AAAFGSkFqQASI
    • "addressName":
      string
      The name of the address | Example: customeraddr-ABCDEFGPRMuMCscyXgSRVU
    • "title":
      string
      The (personal) title of the contact person, like 'Mr.' or 'Ms.' | Example: Mrs.
    • "aristocraticTitle":
      string
      the aristocratic title of the contact person, like Lord or Lady
    • "jobTitle":
      string
      the job title of the contact person | Example: CEO
    • "honorific":
      string
      the honorific title of the contact person that denotes the honored person's occupation, like Captain, Coach, Officer, Reverend or the academic title, like PhD
    • "firstName":
      string
      The (first) given name of the contact person | Example: Patricia
    • "secondName":
      string
      the second given name of the contact person | Example: Luise
    • "lastName":
      string
      The last name of the contact person | Example: Miller
    • "secondLastName":
      string
      the second last name of the contact person
    • "companyName1":
      string
      the company name | Example: PMiller ltd.
    • "companyName2":
      string
      The second company name
    • "addressLine1":
      string
      the first address line | Example: Berliner Str. 20
    • "addressLine2":
      string
      the second address line | Example: 1st Floor
    • "addressLine3":
      string
      The third address line | Example: Second door on the right
    • "postBox":
      string
      the post-office box | Example: PO Box 42
    • "mainDivision":
      string
      the main division of the country, e. g. a state or province | Example: AL
    • "mainDivisionName":
      string
      The localized display name of the main division | Example: Alabama
    • "subDivision":
      string
      The sub division code of the country. | Example: GB-PKN
    • "subDivisionName":
      string
      The localized display name of the sub division | Example: Perth and Kinross
    • "postalCode":
      string
      The postal code | Example: 14482
    • "email":
      string
      the e-mail address of the contact person | Example: pmiller@intershop.de
    • "phoneMobile":
      string
      The number of the contact person's cell phone | Example: 49364112677
    • "phoneHome":
      string
      The phone number of the house or apartment where the contact person lives | Example: 049364112677
    • "phoneBusiness":
      string
      The phone number of the contact person's company | Example: 049364112699
    • "phoneBusinessDirect":
      string
      the business phone number of the contact person that allows an outside caller to connect directly to the contact person without any help of an attendant or operator | Example: 049364112659
    • "country":
      string
      The display name of the country in the current locale | Example: Germany
    • "countryCode":
      string
      The country code | Example: DE
    • "city":
      string
      The name of the city | Example: Potsdam
    • "fax":
      string
      the fax number | Example: 049364112643
    • "usage":
      object
      Returns usage information for the address. Every bit in the returned set marks a specific usage type, like ship-from or invoice-to address. If a bit is set, the address may be used for the specific purpose mapped to this bit. Further bits may be used for custom types. Default usage for first 4 bits are Invoice-to, Ship-to, Service-to and Install-to
      {
      • "empty":
        boolean
      }
    }
  • "preferredShipToAddress":
    object
    A AddressRO object. This resource holds the details of an address.
    {
    • "name":
      string
      The name of an element.
    • "type":
      string
      The type of the object. This is normally a constant that can be used to differentiate objects by their type. | Example: Address
    • "urn":
      string
      the URN representation of this address | Example: urn:address:customer:1234567890:0987654321
    • "id":
      string
      The ID of the returned element | Example: vagKAB17gg4AAAFGSkFqQASI
    • "addressName":
      string
      The name of the address | Example: customeraddr-ABCDEFGPRMuMCscyXgSRVU
    • "title":
      string
      The (personal) title of the contact person, like 'Mr.' or 'Ms.' | Example: Mrs.
    • "aristocraticTitle":
      string
      the aristocratic title of the contact person, like Lord or Lady
    • "jobTitle":
      string
      the job title of the contact person | Example: CEO
    • "honorific":
      string
      the honorific title of the contact person that denotes the honored person's occupation, like Captain, Coach, Officer, Reverend or the academic title, like PhD
    • "firstName":
      string
      The (first) given name of the contact person | Example: Patricia
    • "secondName":
      string
      the second given name of the contact person | Example: Luise
    • "lastName":
      string
      The last name of the contact person | Example: Miller
    • "secondLastName":
      string
      the second last name of the contact person
    • "companyName1":
      string
      the company name | Example: PMiller ltd.
    • "companyName2":
      string
      The second company name
    • "addressLine1":
      string
      the first address line | Example: Berliner Str. 20
    • "addressLine2":
      string
      the second address line | Example: 1st Floor
    • "addressLine3":
      string
      The third address line | Example: Second door on the right
    • "postBox":
      string
      the post-office box | Example: PO Box 42
    • "mainDivision":
      string
      the main division of the country, e. g. a state or province | Example: AL
    • "mainDivisionName":
      string
      The localized display name of the main division | Example: Alabama
    • "subDivision":
      string
      The sub division code of the country. | Example: GB-PKN
    • "subDivisionName":
      string
      The localized display name of the sub division | Example: Perth and Kinross
    • "postalCode":
      string
      The postal code | Example: 14482
    • "email":
      string
      the e-mail address of the contact person | Example: pmiller@intershop.de
    • "phoneMobile":
      string
      The number of the contact person's cell phone | Example: 49364112677
    • "phoneHome":
      string
      The phone number of the house or apartment where the contact person lives | Example: 049364112677
    • "phoneBusiness":
      string
      The phone number of the contact person's company | Example: 049364112699
    • "phoneBusinessDirect":
      string
      the business phone number of the contact person that allows an outside caller to connect directly to the contact person without any help of an attendant or operator | Example: 049364112659
    • "country":
      string
      The display name of the country in the current locale | Example: Germany
    • "countryCode":
      string
      The country code | Example: DE
    • "city":
      string
      The name of the city | Example: Potsdam
    • "fax":
      string
      the fax number | Example: 049364112643
    • "usage":
      object
      Returns usage information for the address. Every bit in the returned set marks a specific usage type, like ship-from or invoice-to address. If a bit is set, the address may be used for the specific purpose mapped to this bit. Further bits may be used for custom types. Default usage for first 4 bits are Invoice-to, Ship-to, Service-to and Install-to
      {
      • "empty":
        boolean
      }
    }
  • "taxationID":
    string
    the taxation ID of the customer | Example: 123456
  • "type":
    string
    The type of the object. This is normally a constant that can be used to differentiate objects by their type. | Example: SMBCustomer
}
SMBCustomerUserRO application/json{
  • "type":
    string
    The type of the object. This is normally a constant that can be used to differentiate objects by their type. | Example: SMBCustomerUser
  • "name":
    string
    The name of an element. | Example: SMBCustomerUser
  • "login":
    string
    The login to be used for that user. | Example: pmerkel@test.intershop.de
  • "firstName":
    string
    The given name (also known as a personal name, first name, forename) of the person represented by this user. | Example: Peter
  • "lastName":
    string
    The surname (also known as a family name, last name) of the person represented by this user. | Example: Merkel
  • "businessPartnerNo":
    string
    ID uniquely identifying the user in the context of the customer. | Example: PMerkel
  • "preferredLanguage":
    string
    the preffered language of the user | Example: de_DE
  • "phoneBusiness":
    string
    the business phone number of the user | Example: 4211324
  • "phoneMobile":
    string
    the mobile phone number of the user | Example: 4211324
  • "department":
    string
    the department of the user | Example: Sales
  • "title":
    string
    The personal title, like Ms., Mr. | Example: Mr.
  • "birthday":
    string
    Date of birth of the person represented by this user in format MM/dd/yyyy | Example: 12/24/1998
  • "preferredPaymentInstrument":
    object
    A PaymentRO object.
    {
    • "name":
      string
      The name of an element.
    • "type":
      string
      The type of the object. This is normally a constant that can be used to differentiate objects by their type. | Example: Payment
    • "attributes":
      array
      An array of ResourceAttribute objects. the list of attributes
      [
      ResourceAttribute: An attribute
      {
      • "name":
        string
        The attribute's name
      • "type":
        string
        This is a constant: ResourceAttribute | Example: ResourceAttribute
      • "value":
        object
        The attribute's value.
      }
      ]
    • "id":
      string
    • "limitedTenderBalance":
      object
      A MoneyRO object. Money combines a currency and a money amount.
      {
      • "name":
        string
        The name of an element.
      • "type":
        string
        Readonly | This is a constant: Money | Example: Money
      • "value":
        number
        The monetary value. | Example: 10.99
      • "currencyMnemonic":
        string
        Deprecated
      • "currency":
        string
        Three-letter currency code (ISO 4217) of the monetary value. | Example: USD
      }
    • "paymentTotalAmount":
      object
      A MoneyRO object. Money combines a currency and a money amount.
      {
      • "name":
        string
        The name of an element.
      • "type":
        string
        Readonly | This is a constant: Money | Example: Money
      • "value":
        number
        The monetary value. | Example: 10.99
      • "currencyMnemonic":
        string
        Deprecated
      • "currency":
        string
        Three-letter currency code (ISO 4217) of the monetary value. | Example: USD
      }
    • "accountIdentifier":
      string
      Readonly | the optional account identifier for this payment instrument | Example: DE12****7890
    • "parameters":
      array
      An array of GenericPropertyROObject objects.
      [
      GenericPropertyROObject:
      {
      • "name":
        string
        The name of an element.
      • "type":
        string
        Readonly | The type of the object. This is normally a constant that can be used to differentiate objects by their type.
      • "key":
        string
      • "property":
        object
      • "displayName":
        string
      }
      ]
    • "attribute":
      object
      A ResourceAttribute object. An attribute
      {
      • "name":
        string
        The attribute's name
      • "type":
        string
        This is a constant: ResourceAttribute | Example: ResourceAttribute
      • "value":
        object
        The attribute's value.
      }
    }
  • "phoneHome":
    string
    the phone home number of the user | Example: 4211324
  • "fax":
    string
    the fax number of the user | Example: 4211324
  • "email":
    string
    the email of the user | Example: pmerkel@test.intershop.de
  • "active":
    boolean
    the user is active or not | Example: true
  • "preferredInvoiceToAddressUrn":
    string
    The URN representation of the preferred invoice address for the user in the format urn:address:customer:addressID:customerID
  • "preferredShipToAddressUrn":
    string
    The URN representation of the preferred shipping address for the user in the format urn:address:customer:addressID:customerID
}
SMBCustomerUserROCollection application/json{
  • "type":
    string
    The type of the object. This is normally a constant that can be used to differentiate objects by their type. | Example: SMBCustomerUserCollection
  • "name":
    string
    The name of an element. | Example: Users
  • "elements":
    array
    An array of SMBCustomerUserRO objects. The list of elements
    [
    SMBCustomerUserRO:
    {
    • "type":
      string
      The type of the object. This is normally a constant that can be used to differentiate objects by their type. | Example: SMBCustomerUser
    • "name":
      string
      The name of an element. | Example: SMBCustomerUser
    • "login":
      string
      The login to be used for that user. | Example: pmerkel@test.intershop.de
    • "firstName":
      string
      The given name (also known as a personal name, first name, forename) of the person represented by this user. | Example: Peter
    • "lastName":
      string
      The surname (also known as a family name, last name) of the person represented by this user. | Example: Merkel
    • "businessPartnerNo":
      string
      ID uniquely identifying the user in the context of the customer. | Example: PMerkel
    • "preferredLanguage":
      string
      the preffered language of the user | Example: de_DE
    • "phoneBusiness":
      string
      the business phone number of the user | Example: 4211324
    • "phoneMobile":
      string
      the mobile phone number of the user | Example: 4211324
    • "department":
      string
      the department of the user | Example: Sales
    • "title":
      string
      The personal title, like Ms., Mr. | Example: Mr.
    • "birthday":
      string
      Date of birth of the person represented by this user in format MM/dd/yyyy | Example: 12/24/1998
    • "preferredPaymentInstrument":
      object
      A PaymentRO object.
      {
      • "name":
        string
        The name of an element.
      • "type":
        string
        The type of the object. This is normally a constant that can be used to differentiate objects by their type. | Example: Payment
      • "attributes":
        array
        An array of ResourceAttribute objects. the list of attributes
        [
        ResourceAttribute: An attribute
        {
        • "name":
          string
          The attribute's name
        • "type":
          string
          This is a constant: ResourceAttribute | Example: ResourceAttribute
        • "value":
          object
          The attribute's value.
        }
        ]
      • "id":
        string
      • "limitedTenderBalance":
        object
        A MoneyRO object. Money combines a currency and a money amount.
        {
        • "name":
          string
          The name of an element.
        • "type":
          string
          Readonly | This is a constant: Money | Example: Money
        • "value":
          number
          The monetary value. | Example: 10.99
        • "currencyMnemonic":
          string
          Deprecated
        • "currency":
          string
          Three-letter currency code (ISO 4217) of the monetary value. | Example: USD
        }
      • "paymentTotalAmount":
        object
        A MoneyRO object. Money combines a currency and a money amount.
        {
        • "name":
          string
          The name of an element.
        • "type":
          string
          Readonly | This is a constant: Money | Example: Money
        • "value":
          number
          The monetary value. | Example: 10.99
        • "currencyMnemonic":
          string
          Deprecated
        • "currency":
          string
          Three-letter currency code (ISO 4217) of the monetary value. | Example: USD
        }
      • "accountIdentifier":
        string
        Readonly | the optional account identifier for this payment instrument | Example: DE12****7890
      • "parameters":
        array
        An array of GenericPropertyROObject objects.
        [
        GenericPropertyROObject:
        {
        • "name":
          string
          The name of an element.
        • "type":
          string
          Readonly | The type of the object. This is normally a constant that can be used to differentiate objects by their type.
        • "key":
          string
        • "property":
          object
        • "displayName":
          string
        }
        ]
      • "attribute":
        object
        A ResourceAttribute object. An attribute
        {
        • "name":
          string
          The attribute's name
        • "type":
          string
          This is a constant: ResourceAttribute | Example: ResourceAttribute
        • "value":
          object
          The attribute's value.
        }
      }
    • "phoneHome":
      string
      the phone home number of the user | Example: 4211324
    • "fax":
      string
      the fax number of the user | Example: 4211324
    • "email":
      string
      the email of the user | Example: pmerkel@test.intershop.de
    • "active":
      boolean
      the user is active or not | Example: true
    • "preferredInvoiceToAddressUrn":
      string
      The URN representation of the preferred invoice address for the user in the format urn:address:customer:addressID:customerID
    • "preferredShipToAddressUrn":
      string
      The URN representation of the preferred shipping address for the user in the format urn:address:customer:addressID:customerID
    }
    ]
}
UpdateCostCenterBuyerRO application/json{
  • "budget":
    object
    A MoneyRO_v1 object. Describes a money object.
    {
    • "currency":
      string
      Three-letter currency code (ISO 4217) of the monetary value. | Example: USD
    • "value":
      number
      The monetary value. | Example: 10.99
    }
  • "budgetPeriod":
    string
    The budget period of the cost center buyer | Example: monthly
}
UpdateCostCenterRO application/json{
  • "name":
    string
    The name of the cost center | Example: my cost center
  • "type":
    string
    The type of the object. This is normally a constant that can be used to differentiate objects by their type. | Example: UpdateCostCenter
  • "active":
    boolean
    Indicates whether the cost center is active | Example: true
  • "budget":
    object
    A MoneyRO_v1 object. Describes a money object.
    {
    • "currency":
      string
      Three-letter currency code (ISO 4217) of the monetary value. | Example: USD
    • "value":
      number
      The monetary value. | Example: 10.99
    }
  • "budgetPeriod":
    string
    The budget period of the cost center | Example: monthly
  • "costCenterId":
    string
    The cost center ID of the cost center | Example: 007
  • "costCenterOwner":
    object
    A CostCenterUserRO object. This resource holds information about a cost center user.
    {
    • "approvedOrders":
      integer
      The approved orders of the cost center buyer | Format: int32 | Example: 8
    • "budget":
      object
      A MoneyRO_v1 object. Describes a money object.
      {
      • "currency":
        string
        Three-letter currency code (ISO 4217) of the monetary value. | Example: USD
      • "value":
        number
        The monetary value. | Example: 10.99
      }
    • "budgetPeriod":
      string
      The budget period of the cost center buyer | Example: monthly
    • "buyerDetails":
      object
      A LinkRO object. A Link pointing to a resource
      {
      • "name":
        string
        the name of the returned element
      • "type":
        string
        Readonly | This is a constant: Link | Example: Link
      • "attributes":
        array
        An array of ResourceAttribute objects. the list of attributes
        [
        ResourceAttribute: An attribute
        {
        • "name":
          string
          The attribute's name
        • "type":
          string
          This is a constant: ResourceAttribute | Example: ResourceAttribute
        • "value":
          object
          The attribute's value.
        }
        ]
      • "uri":
        string
        The uri
      • "relation":
        string
        The relation of the link | Documentation: Link Relations (www.iana.org) | Possible Values: aboutalternateappendixarchivesauthorbookmarkcanonicalchaptercollectioncontentscopyrightcreate-formcurrentdescribedbydescribesdisclosureduplicateeditedit-formedit-mediaenclosurefirstglossaryhelphostshubiconindexitemlastlatest-versionlicenselrddmonitormonitor-groupnextnext-archivenofollownoreferrerpaymentpredecessor-versionprefetchprevpreviewpreviousprev-archiveprivacy-policyprofilerelatedrepliessearchsectionselfservicestartstylesheetsubsectionsuccessor-versiontagterms-of-servicetypeupversion-historyviaworking-copyworking-copy-of
      • "title":
        string
        The title of the link
      • "description":
        string
        The description of the link
      • "itemId":
        string
        the Id of the linked item
      • "attribute":
        object
        A ResourceAttribute object. An attribute
        {
        • "name":
          string
          The attribute's name
        • "type":
          string
          This is a constant: ResourceAttribute | Example: ResourceAttribute
        • "value":
          object
          The attribute's value.
        }
      }
    • "email":
      string
      The e-mail address of the person represented by this user | Example: merkel@test.intershop.de
    • "firstName":
      string
      The given name (also known as a personal name, first name, forename) of the person represented by this user | Example: Peter
    • "lastName":
      string
      The surname (also known as a family name, last name) of the person represented by this user | Example: Merkel
    • "login":
      string
      The login of the person represented by this user | Example: merkel@test.intershop.de
    • "pendingOrders":
      integer
      The pending orders of the cost center buyer | Format: int32 | Example: 2
    • "remainingBudget":
      object
      A MoneyRO_v1 object. Describes a money object.
      {
      • "currency":
        string
        Three-letter currency code (ISO 4217) of the monetary value. | Example: USD
      • "value":
        number
        The monetary value. | Example: 10.99
      }
    • "spentBudget":
      object
      A MoneyRO_v1 object. Describes a money object.
      {
      • "currency":
        string
        Three-letter currency code (ISO 4217) of the monetary value. | Example: USD
      • "value":
        number
        The monetary value. | Example: 10.99
      }
    • "title":
      string
      The personal title, like Ms., Mr. | Example: Mr.
    }
  • "id":
    string
    The ID of the cost center | Example: q2QKAEsBiyQAAAFjXFBB6G14
}
UserCostCenterLinkROCollection application/json{
  • "pageable":
    string
    The pageable ID
  • "total":
    integer
    The pageable amount total | Format: int32
  • "offset":
    integer
    The pageable offset | Format: int32
  • "amount":
    integer
    The pageable amount | Format: int32
  • "elements":
    array
    An array of UserCostCenterLinkRO objects. The list of elements
    [
    UserCostCenterLinkRO: This resource holds a list of all cost centers assigned to the user.
    {
    • "name":
      string
      The name of the cost center | Example: Agro Net Central
    • "type":
      string
      The type of the object. This is normally a constant that can be used to differentiate objects by their type. | Example: UserCostCenterLink
    • "id":
      string
      The ID of the cost center | Example: 511288
    • "roles":
      array
      An array of string literals. The roles assigned to the user | Example: ["Approver","Buyer"]
    • "link":
      object
      A LinkRO object. A Link pointing to a resource
      {
      • "name":
        string
        the name of the returned element
      • "type":
        string
        Readonly | This is a constant: Link | Example: Link
      • "attributes":
        array
        An array of ResourceAttribute objects. the list of attributes
        [
        ResourceAttribute: An attribute
        {
        • "name":
          string
          The attribute's name
        • "type":
          string
          This is a constant: ResourceAttribute | Example: ResourceAttribute
        • "value":
          object
          The attribute's value.
        }
        ]
      • "uri":
        string
        The uri
      • "relation":
        string
        The relation of the link | Documentation: Link Relations (www.iana.org) | Possible Values: aboutalternateappendixarchivesauthorbookmarkcanonicalchaptercollectioncontentscopyrightcreate-formcurrentdescribedbydescribesdisclosureduplicateeditedit-formedit-mediaenclosurefirstglossaryhelphostshubiconindexitemlastlatest-versionlicenselrddmonitormonitor-groupnextnext-archivenofollownoreferrerpaymentpredecessor-versionprefetchprevpreviewpreviousprev-archiveprivacy-policyprofilerelatedrepliessearchsectionselfservicestartstylesheetsubsectionsuccessor-versiontagterms-of-servicetypeupversion-historyviaworking-copyworking-copy-of
      • "title":
        string
        The title of the link
      • "description":
        string
        The description of the link
      • "itemId":
        string
        the Id of the linked item
      • "attribute":
        object
        A ResourceAttribute object. An attribute
        {
        • "name":
          string
          The attribute's name
        • "type":
          string
          This is a constant: ResourceAttribute | Example: ResourceAttribute
        • "value":
          object
          The attribute's value.
        }
      }
    }
    ]
  • "type":
    string
    The type of the object. This is normally a constant that can be used to differentiate objects by their type. | Example: UserCostCenterLinkROCollection
  • "sortKeys":
    array
    An array of string literals. The keys to sort for
  • "name":
    string
    The name of an element.
}
UserCostCenterRO application/json{
  • "name":
    string
    The name of the cost center | Example: Agro Net Central
  • "type":
    string
    The type of the object. This is normally a constant that can be used to differentiate objects by their type. | Example: UserCostCenter
  • "id":
    string
    The ID of the cost center | Example: 511288
  • "roles":
    array
    An array of string literals. The roles assigned to the user | Example: ["Approver","Buyer"]
}
UserLinkROCollection application/json{
  • "type":
    string
    The type of the object. This is normally a constant that can be used to differentiate objects by their type. | Example: UserLinkCollection
  • "name":
    string
    The name of an element. | Example: users
  • "amount":
    integer
    The pageable amount | Format: int32
  • "elements":
    array
    An array of UserLinkRO objects. The list of elements
    [
    UserLinkRO: A Link to registered User Item Resource
    {
    • "type":
      string
      The type of the object. This is normally a constant that can be used to differentiate objects by their type. | Example: Link
    • "name":
      string
      The name of an element. | Example: Peter Merkel
    • "login":
      string
      The login of the user | Example: pmerkel@test.intershop.de
    • "uri":
      string
      the uri to the user item resource | Example: Organization-Channel-Site/-/customers/-/users/pmerkel@test.intershop.de
    • "attributes":
      array
      An array of ResourceAttribute objects. the list of attributes
      [
      ResourceAttribute: An attribute
      {
      • "name":
        string
        The attribute's name
      • "type":
        string
        This is a constant: ResourceAttribute | Example: ResourceAttribute
      • "value":
        object
        The attribute's value.
      }
      ]
    • "attribute":
      object
      A ResourceAttribute object. An attribute
      {
      • "name":
        string
        The attribute's name
      • "type":
        string
        This is a constant: ResourceAttribute | Example: ResourceAttribute
      • "value":
        object
        The attribute's value.
      }
    }
    ]
  • "pageable":
    string
    The pageable ID
  • "total":
    integer
    The pageable amount total | Format: int32
  • "offset":
    integer
    The pageable offset | Format: int32
  • "limit":
    integer
    the maximum count of users to return | Format: int32
  • "filter":
    string
    the defined filter criteria for returned users
  • "sortKeys":
    array
    An array of string literals. The keys to sort for
}

Disclaimer

The information provided in the Knowledge Base may not be applicable to all systems and situations. Intershop Communications will not be liable to any party for any direct or indirect damages resulting from the use of the Customer Support section of the Intershop Corporate Web site, including, without limitation, any lost profits, business interruption, loss of programs or other data on your information handling system.

Customer Support
Knowledge Base
Product Resources
Tickets