Document Properties
KbidP29613
Last Modified02-Nov-2020
Added to KB11-Sep-2020
Public AccessEveryone
StatusOnline
Doc TypeReferences
ProductICM 7.10

Reference - ICM REST API - B2B Front End - Customer 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: Get customer addresses list

Description

Returns a list of links to customer addresses resources

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

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

401 - Unauthorized

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

201 - Created

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

Object application/json

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: Get customer addresses list

Description

Returns a list of links to customer addresses resources

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

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

401 - Unauthorized

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

201 - Created

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

Object application/json

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: Gets a list of all cost centers.

Description

Gets a list of all cost centers.

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

201 - Created

The created cost center.
CostCenterRO application/json

401 - Unauthorized

If the user couldn't be authenticated.

403 - Forbidden

If the user isn't allowed to access this resource.
POST: Creates a new cost center.

Description

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 created cost center.
CostCenterRO application/json

401 - Unauthorized

If the user couldn't be authenticated.

403 - Forbidden

If the user isn't allowed to access this resource.
/customers/{CustomerKey}/costcenters/{CostCenterKey}
GET: Returns the cost center by the given id.

Description

Returns detail information about the cost center with 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 key or UUID to resolve a single item | Example: ExampleKey

Response

200 - OK

The cost center.
CostCenterRO application/json

401 - Unauthorized

If the user couldn't be authenticated.

403 - Forbidden

If the user isn't allowed to access this resource.

404 - Not Found

If the customer couldn't be found.
DELETE: Deletes the cost center.

Description

The cost center with the given id will be removed.

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 key or UUID to resolve a single item | Example: ExampleKey

Response

204 - No Content

The cost center was deleted.

401 - Unauthorized

If the user couldn't be authenticated.

403 - Forbidden

If the user isn't allowed to access this resource.

404 - Not Found

If the customer couldn't be found.
PATCH: Updates the cost center by the given id.

Description

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 key or UUID to resolve a single item | Example: ExampleKey

Response

200 - OK

The updated cost center.
UpdateCostCenterRO application/json

401 - Unauthorized

If the user couldn't be authenticated.

403 - Forbidden

If the user isn't allowed to access this resource.

404 - Not Found

If the user is missing or couldn't be found.
/customers/{CustomerKey}/costcenters/{CostCenterKey}/buyers
GET: Returns all buyers for the cost center

Description

All assigned cost center buyers.

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 key or UUID to resolve a single item | Example: ExampleKey

Response

200 - OK

The cost center.
CostCenterRO application/json

401 - Unauthorized

If the user couldn't be authenticated.

403 - Forbidden

If the user isn't allowed to access this resource.

404 - Not Found

If the customer couldn't be found.
POST: Adds a new cost center buyer.

Description

Adds a new cost center buyer.

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 key or UUID to resolve a single item | Example: ExampleKey

Response

200 - OK

The added buyer.
CostCenterRO application/json

401 - Unauthorized

If the user couldn't be authenticated.

403 - Forbidden

If the user isn't allowed to access this resource.
/customers/{CustomerKey}/costcenters/{CostCenterKey}/buyers/{CostCenterBuyerKey}
GET: Returns information about a buyer of the cost center

Description

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 key or UUID to resolve a single item | Example: ExampleKey
in pathCostCenterBuyerKeystringRequired | The key or UUID to resolve a single item | Example: ExampleKey

Response

200 - OK

The buyer information.
CostCenterRO application/json

401 - Unauthorized

If the user couldn't be authenticated.

403 - Forbidden

If the user isn't allowed to access this resource.

404 - Not Found

If the customer couldn't be found.
DELETE: Remove the buyer from the cost center.

Description

The buyer identified by given id will be removed 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 key or UUID to resolve a single item | Example: ExampleKey
in pathCostCenterBuyerKeystringRequired | The key or UUID to resolve a single item | Example: ExampleKey

Response

204 - No Content

The cost center buyer was removed.

401 - Unauthorized

If the user couldn't be authenticated.

403 - Forbidden

If the user isn't allowed to access this resource.

404 - Not Found

If the customer couldn't be found.
PATCH: Updates information for a buyer of the cost center

Description

Updates information 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 key or UUID to resolve a single item | Example: ExampleKey
in pathCostCenterBuyerKeystringRequired | The key or UUID to resolve a single item | Example: ExampleKey

Response

200 - OK

The cost center.
CostCenterRO application/json

401 - Unauthorized

If the user couldn't be authenticated.

403 - Forbidden

If the user isn't allowed to access this resource.

404 - Not Found

If the customer couldn't be found.
/customers/{CustomerKey}/users/{CustomerItemUserKey}/costcenters
GET: Get business users list of cost centers

Description

Returns a list of cost centers of the given user of a business customer

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

UserCostCenterLinkROCollection application/json

401 - Unauthorized

404 - Not Found

if the user is not found or does not support cost centers
/customers/{CustomerKey}/users/{CustomerItemUserKey}/costcenters/{UserCostCenterKey}
GET: Get business user cost center details

Description

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 key or UUID to resolve a single item | Example: ExampleKey

Response

200 - OK

UserCostCenterRO application/json

401 - Unauthorized

404 - Not Found

possible reasons:
- if the user is not found or does not support cost centers;
- if cost center with that id does not exist within the customer;
- if cost center with that id exists within the customer but this user is not assigned to it (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

400 - Bad Request

/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

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: Get the gift cards and certificates associated with the current user

Description

ResourceCollectionRO contains Objects of type LinkRO

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

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

401 - Unauthorized

404 - Not Found

/customers/{CustomerKey}/users/{CustomerItemUserKey}/giftcardsandcertificates/{CustomerGiftCardAndCertificateResourceKey}
GET: Get details of a gift card or certificate by given id

Description

--

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 key or UUID to resolve a single item | Example: ExampleKey

Response

200 - OK

GiftCardAndCertificateRO application/json

400 - Bad Request

401 - Unauthorized

404 - Not Found

/privatecustomers/{CustomerKey}/giftcardsandcertificates
GET: Get the gift cards and certificates associated with the current user

Description

ResourceCollectionRO contains Objects of type LinkRO

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

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

401 - Unauthorized

404 - Not Found

/privatecustomers/{CustomerKey}/giftcardsandcertificates/{CustomerGiftCardAndCertificateResourceKey}
GET: Get details of a gift card or certificate by given id

Description

--

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 key or UUID to resolve a single item | Example: ExampleKey

Response

200 - OK

GiftCardAndCertificateRO application/json

400 - Bad Request

401 - Unauthorized

404 - Not 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

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

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

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

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
    ISO 3166-1 country code | Example: DE
  • "city":
    string
    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 an element. | 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
    The cost center is active.
  • "budget":
    object
    A MoneyRO_v1 object. Describes a money object.
    {
    • "currency":
      string
      Readonly | Three-letter currency code (ISO 4217) of the monetary value. | Example: USD
    • "value":
      number
      Readonly | 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: Represents 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
        Readonly | Three-letter currency code (ISO 4217) of the monetary value. | Example: USD
      • "value":
        number
        Readonly | 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 email 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
        Readonly | Three-letter currency code (ISO 4217) of the monetary value. | Example: USD
      • "value":
        number
        Readonly | The monetary value. | Example: 10.99
      }
    • "spentBudget":
      object
      A MoneyRO_v1 object. Describes a money object.
      {
      • "currency":
        string
        Readonly | Three-letter currency code (ISO 4217) of the monetary value. | Example: USD
      • "value":
        number
        Readonly | The monetary value. | Example: 10.99
      }
    • "title":
      string
      The personal title, like Ms., Mr. | Example: Mr.
    }
    ]
  • "costCenterId":
    string
    The cost center id of the cost center. | Example: 007
  • "costCenterOwner":
    object
    A CostCenterUserRO object. Represents 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
        Readonly | Three-letter currency code (ISO 4217) of the monetary value. | Example: USD
      • "value":
        number
        Readonly | 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 email 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
        Readonly | Three-letter currency code (ISO 4217) of the monetary value. | Example: USD
      • "value":
        number
        Readonly | The monetary value. | Example: 10.99
      }
    • "spentBudget":
      object
      A MoneyRO_v1 object. Describes a money object.
      {
      • "currency":
        string
        Readonly | Three-letter currency code (ISO 4217) of the monetary value. | Example: USD
      • "value":
        number
        Readonly | 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
  • "orders":
    array
    An array of OrderRO objects. The orders of the cost center | Example: 23
    [
    OrderRO: A representation of 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":
      string
      The order date. | Format: date
    • "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
        Readonly | Three-letter currency code (ISO 4217) of the monetary value. | Example: USD
      • "value":
        number
        Readonly | The monetary value. | Example: 10.99
      }
    • "orderTotalNet":
      object
      A MoneyRO_v1 object. Describes a money object.
      {
      • "currency":
        string
        Readonly | Three-letter currency code (ISO 4217) of the monetary value. | Example: USD
      • "value":
        number
        Readonly | The monetary value. | Example: 10.99
      }
    }
    ]
  • "pendingOrders":
    integer
    The pending orders of the cost center. | Format: int32 | Example: 2
  • "remainingBudget":
    object
    A MoneyRO_v1 object. Describes a money object.
    {
    • "currency":
      string
      Readonly | Three-letter currency code (ISO 4217) of the monetary value. | Example: USD
    • "value":
      number
      Readonly | The monetary value. | Example: 10.99
    }
  • "spentBudget":
    object
    A MoneyRO_v1 object. Describes a money object.
    {
    • "currency":
      string
      Readonly | Three-letter currency code (ISO 4217) of the monetary value. | Example: USD
    • "value":
      number
      Readonly | The monetary value. | Example: 10.99
    }
}
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 giftcard | Example: USD
  • "amount":
    number
    The pageable amount | Example: 10
  • "amountRemaining":
    number
    The remaining amount of the giftcard | Example: 5
}
LinkRO application/json{
  • "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.
    }
}
NewCostCenterBuyerRO application/json{
  • "budget":
    object
    A MoneyRO_v1 object. Describes a money object.
    {
    • "currency":
      string
      Readonly | Three-letter currency code (ISO 4217) of the monetary value. | Example: USD
    • "value":
      number
      Readonly | 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 an element. | 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
      Readonly | Three-letter currency code (ISO 4217) of the monetary value. | Example: USD
    • "value":
      number
      Readonly | 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. Represents 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
        Readonly | Three-letter currency code (ISO 4217) of the monetary value. | Example: USD
      • "value":
        number
        Readonly | 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 email 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
        Readonly | Three-letter currency code (ISO 4217) of the monetary value. | Example: USD
      • "value":
        number
        Readonly | The monetary value. | Example: 10.99
      }
    • "spentBudget":
      object
      A MoneyRO_v1 object. Describes a money object.
      {
      • "currency":
        string
        Readonly | Three-letter currency code (ISO 4217) of the monetary value. | Example: USD
      • "value":
        number
        Readonly | 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
}
NewCustomerRO 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: SMBCustomer
  • "customerNo":
    string
  • "companyName":
    string
    the company name of the customer | Example: AgroNet
  • "companyName2":
    string
  • "taxationID":
    string
    the taxation ID of the customer | Example: 123456
  • "industry":
    string
    the industry of the customer | Example: agrar industry
  • "description":
    string
    the description of the customer | Example: AgroNet description
  • "credentials":
    object
    A CredentialsRO object. the credentials of the new customer as CredentialsRO
    {
    • "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
    }
  • "address":
    object
    A AddressRO 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: 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
      ISO 3166-1 country code | Example: DE
    • "city":
      string
      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
      }
    }
  • "user":
    object
    A SMBCustomerUserRO object.
    {
    • "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
    }
}
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{
  • "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: PrivateCustomer
  • "customerNo":
    string
  • "preferredInvoiceToAddress":
    object
    A AddressRO 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: 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
      ISO 3166-1 country code | Example: DE
    • "city":
      string
      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.
    {
    • "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
      ISO 3166-1 country code | Example: DE
    • "city":
      string
      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
  • "firstName":
    string
    the first name of the customer | Example: Patrik
  • "lastName":
    string
    the last name of the customer | Example: Mueller
  • "birthday":
    string
    the birthday of the customer | Example: 1970-03-10T00:00:00.000Z
  • "phoneHome":
    string
    the phone home number of the customer | Example: 4211324
  • "phoneBusiness":
    string
    the business phone number of the customer | Example: 4211324
  • "phoneMobile":
    string
    the mobile phone number of the customer | Example: 4211324
  • "fax":
    string
    the fax number of the customer | Example: 4211324
  • "email":
    string
    the email address of the customer | Example: patrik@test.intershop.net
  • "login":
    string
    the login(username) of the customer | Example: patrik_83
  • "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.
      }
    }
}
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{
  • "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: SMBCustomer
  • "customerNo":
    string
  • "preferredInvoiceToAddress":
    object
    A AddressRO 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: 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
      ISO 3166-1 country code | Example: DE
    • "city":
      string
      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.
    {
    • "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
      ISO 3166-1 country code | Example: DE
    • "city":
      string
      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
      }
    }
  • "companyName":
    string
    the company name of the customer | Example: AgroNet
  • "companyName2":
    string
  • "taxationID":
    string
    the taxation ID of the customer | Example: 123456
  • "industry":
    string
    the industry of the customer | Example: agrar industry
  • "description":
    string
    the description of the customer | Example: AgroNet description
}
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
      Readonly | Three-letter currency code (ISO 4217) of the monetary value. | Example: USD
    • "value":
      number
      Readonly | 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 an element. | 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
    The cost center is active.
  • "budget":
    object
    A MoneyRO_v1 object. Describes a money object.
    {
    • "currency":
      string
      Readonly | Three-letter currency code (ISO 4217) of the monetary value. | Example: USD
    • "value":
      number
      Readonly | 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. Represents 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
        Readonly | Three-letter currency code (ISO 4217) of the monetary value. | Example: USD
      • "value":
        number
        Readonly | 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 email 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
        Readonly | Three-letter currency code (ISO 4217) of the monetary value. | Example: USD
      • "value":
        number
        Readonly | The monetary value. | Example: 10.99
      }
    • "spentBudget":
      object
      A MoneyRO_v1 object. Describes a money object.
      {
      • "currency":
        string
        Readonly | Three-letter currency code (ISO 4217) of the monetary value. | Example: USD
      • "value":
        number
        Readonly | 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: the list of elements
    {
    • "name":
      string
      The name of an element. | 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 costcenter | Example: 511288
    • "roles":
      array
      An array of string literals. the roles of the costcenter
    • "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 an element. | 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 costcenter | Example: 511288
  • "roles":
    array
    An array of string literals. the roles of the costcenter
}
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
}
Object application/json{
  • "links":
    array
    An array of object literals.
    [
    {
    • "uri":
      string
      Format: uri
    • "title":
      string
    • "uriBuilder":
      object
    • "rel":
      string
    • "rels":
      array
      An array of string literals.
    • "params":
      object
    • "type":
      string
    }
    ]
  • "statusInfo":
    object
    {
    • "reasonPhrase":
      string
    • "statusCode":
      integer
      Format: int32
    • "family":
      string
      Possible Values: INFORMATIONALSUCCESSFULREDIRECTIONCLIENT_ERRORSERVER_ERROROTHER
    }
  • "allowedMethods":
    array
    An array of string literals.
  • "stringHeaders":
    object
    {
    • "empty":
      boolean
    }
  • "mediaType":
    object
    {
    • "type":
      string
    • "subtype":
      string
    • "parameters":
      object
    • "wildcardType":
      boolean
    • "wildcardSubtype":
      boolean
    }
  • "entityTag":
    object
    {
    • "value":
      string
    • "weak":
      boolean
    }
  • "metadata":
    object
    {
    • "empty":
      boolean
    }
  • "entity":
    object
  • "lastModified":
    string
    Format: date-time
  • "date":
    string
    Format: date-time
  • "headers":
    object
    {
    • "empty":
      boolean
    }
  • "cookies":
    object
  • "status":
    integer
    Format: int32
  • "length":
    integer
    Format: int32
  • "language":
    object
    {
    • "language":
      string
    • "script":
      string
    • "country":
      string
    • "variant":
      string
    • "extensionKeys":
      array
      An array of string literals.
    • "unicodeLocaleAttributes":
      array
      An array of string literals.
    • "unicodeLocaleKeys":
      array
      An array of string literals.
    • "iso3Language":
      string
    • "iso3Country":
      string
    • "displayLanguage":
      string
    • "displayScript":
      string
    • "displayCountry":
      string
    • "displayVariant":
      string
    • "displayName":
      string
    }
  • "location":
    string
    Format: uri
}

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