openapi: 3.0.1
info:
title: Customer
description: "This is Intershop ICM REST API documentation. \n\nThis 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.\
\ \nThis reference is intended for developers who want to make use of an easy-to-use\
\ API when developing frontend solutions.\nYou can find more information at [Intershop\
\ Communications](https://www.intershop.com). Contact our Intershop experts at\
\ [Support - Intershop Communications](https://www.intershop.com/en/support) \
\ \n\n# Introduction\nThis API is documented in **OpenAPI format**.\n\n"
version: 1.0.0
servers:
- url: /INTERSHOP/rest/{serverGroup}/{siteName}/{appUrl}
description: Intershop ICM Server
variables:
serverGroup:
description: The server group
default: WFS
siteName:
description: The site name
default: inSPIRED-inTRONICS-Site
appUrl:
description: The application URL identifier
enum:
- smb-responsive
default: '-'
paths:
/customers:
post:
tags:
- General
summary: registers a new SMB customer
operationId: createCustomer
requestBody:
content:
application/json:
schema:
$ref: '#/components/schemas/NewCustomerRO'
text/xml:
schema:
$ref: '#/components/schemas/NewCustomerRO'
responses:
201:
description: Created
content:
application/json:
schema:
$ref: '#/components/schemas/LinkRO'
text/xml:
schema:
$ref: '#/components/schemas/LinkRO'
400:
description: Bad request
401:
description: Authorization is required if the customer gets assigned to an existing user
403:
description: Authorized user has to be the same as the one to get assigned to the new customer
security:
- bearerAuth: []
- basicAuth: []
- authToken: []
x-origin-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)
x-origin-class: com.intershop.sellside.rest.smb.capi.resource.customer.CustomerListResource
/customers/{CustomerKey}:
get:
tags:
- General
summary: Get customer profile of currently logged in user
operationId: getCustomer
parameters:
- name: CustomerKey
in: path
description: The key or UUID to resolve a single item
required: true
schema:
type: string
example: ExampleKey
x-item-key: com.intershop.sellside.rest.smb.capi.resource.customer.CustomerListResource
responses:
200:
description: OK
content:
application/json:
schema:
$ref: '#/components/schemas/SMBCustomerRO'
text/xml:
schema:
$ref: '#/components/schemas/SMBCustomerRO'
401:
description: Unauthorized
403:
description: FORBIDDEN
404:
description: Not found
security:
- bearerAuth: []
- basicAuth: []
- authToken: []
x-origin-method: public com.intershop.sellside.rest.smb.capi.resourceobject.SMBCustomerRO com.intershop.sellside.rest.smb.capi.resource.customer.CustomerItemResource.getCustomer()
x-origin-class: com.intershop.sellside.rest.smb.capi.resource.customer.CustomerItemResource
put:
tags:
- General
summary: Update customer profile of currently logged in user
operationId: updateCustomer
parameters:
- name: CustomerKey
in: path
description: The key or UUID to resolve a single item
required: true
schema:
type: string
example: ExampleKey
x-item-key: com.intershop.sellside.rest.smb.capi.resource.customer.CustomerListResource
requestBody:
content:
application/json:
schema:
$ref: '#/components/schemas/SMBCustomerRO'
text/xml:
schema:
$ref: '#/components/schemas/SMBCustomerRO'
responses:
200:
description: OK
content:
application/json:
schema:
$ref: '#/components/schemas/SMBCustomerRO'
text/xml:
schema:
$ref: '#/components/schemas/SMBCustomerRO'
401:
description: Unauthorized
404:
description: Not found
security:
- bearerAuth: []
- basicAuth: []
- authToken: []
x-origin-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)
x-origin-class: com.intershop.sellside.rest.smb.capi.resource.customer.CustomerItemResource
/customers/{CustomerKey}/addresses:
get:
tags:
- Address
summary: Returns the customer's addresses
description: |
This operation returns a list of the customer's addresses based on the provided CustomerResourceKey. The response resource collection contains objects of the type LinkRO.
operationId: getAddresses
parameters:
- name: CustomerKey
in: path
description: The key or UUID to resolve a single item
required: true
schema:
type: string
example: ExampleKey
x-item-key: com.intershop.sellside.rest.smb.capi.resource.customer.CustomerListResource
responses:
200:
description: OK - The addresses of the customer.
content:
application/json:
schema:
$ref: '#/components/schemas/ResourceCollectionROLinkRO'
text/xml:
schema:
$ref: '#/components/schemas/ResourceCollectionROLinkRO'
links:
itemInfo:
operationId: getAddress
parameters:
CustomerAddressKey: $response.body#/elements/{$index}/itemId
description: Links to item of type AddressRO
401:
description: Unauthorized - The organization is not valid.
security:
- bearerAuth: []
- basicAuth: []
- authToken: []
x-origin-method: public com.intershop.component.rest.capi.resourceobject.ResourceCollectionRO com.intershop.sellside.rest.common.capi.resource.customer.address.CustomerAddressListResource.getAddresses()
x-origin-class: com.intershop.sellside.rest.common.capi.resource.customer.address.CustomerAddressListResource
post:
tags:
- Address
summary: Create new customer address
description: Creates a new customer address by using POST data provided by the client
operationId: createAddress
parameters:
- name: CustomerKey
in: path
description: The key or UUID to resolve a single item
required: true
schema:
type: string
example: ExampleKey
x-item-key: com.intershop.sellside.rest.smb.capi.resource.customer.CustomerListResource
requestBody:
content:
application/json:
schema:
$ref: '#/components/schemas/AddressRO'
text/xml:
schema:
$ref: '#/components/schemas/AddressRO'
responses:
200:
description: |-
OK
The created address is a duplicate. The existing instance is returned.
201:
description: |-
Created
Creation of a unique address finished succesfully
401:
description: Unauthorized
400:
description: |-
Bad request
possible values for header error-key:
- customer.address.invalid_fields.usage.error
- customer.address.missing_fields.error
404:
description: |-
Not found
possible values for header error-key:
- customer.address.not_found.error
security:
- bearerAuth: []
- basicAuth: []
- authToken: []
x-origin-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)
x-origin-class: com.intershop.sellside.rest.common.capi.resource.customer.address.CustomerAddressListResource
/customers/{CustomerKey}/addresses/{CustomerAddressKey}:
get:
tags:
- Address
summary: Get customer address details
description: Returns details about customer's address to the client
operationId: getAddress
parameters:
- name: CustomerKey
in: path
description: The key or UUID to resolve a single item
required: true
schema:
type: string
example: ExampleKey
x-item-key: com.intershop.sellside.rest.smb.capi.resource.customer.CustomerListResource
- name: CustomerAddressKey
in: path
description: The key or UUID to resolve a single item
required: true
schema:
type: string
example: ExampleKey
x-item-key: com.intershop.sellside.rest.common.capi.resource.customer.address.CustomerAddressListResource
responses:
200:
description: OK
content:
application/json:
schema:
$ref: '#/components/schemas/AddressRO'
text/xml:
schema:
$ref: '#/components/schemas/AddressRO'
401:
description: Unauthorized
404:
description: |-
Not found
possible values for header error-key:
- customer.address_not_found.error
security:
- bearerAuth: []
- basicAuth: []
- authToken: []
x-origin-method: public com.intershop.sellside.rest.common.capi.resourceobject.AddressRO com.intershop.sellside.rest.common.capi.resource.customer.address.CustomerAddressItemResource.getAddress()
x-origin-class: com.intershop.sellside.rest.common.capi.resource.customer.address.CustomerAddressItemResource
put:
tags:
- Address
summary: Update customer address
description: Updates a customer address with address data provided from the client
operationId: updateAddress
parameters:
- name: CustomerKey
in: path
description: The key or UUID to resolve a single item
required: true
schema:
type: string
example: ExampleKey
x-item-key: com.intershop.sellside.rest.smb.capi.resource.customer.CustomerListResource
- name: CustomerAddressKey
in: path
description: The key or UUID to resolve a single item
required: true
schema:
type: string
example: ExampleKey
x-item-key: com.intershop.sellside.rest.common.capi.resource.customer.address.CustomerAddressListResource
requestBody:
content:
application/json:
schema:
$ref: '#/components/schemas/AddressRO'
text/xml:
schema:
$ref: '#/components/schemas/AddressRO'
responses:
200:
description: OK
400:
description: "Bad request\n possible values for header error-key:\n - customer.address.missing_fields.error\n\
\ - customer.address.update.error.inconsistentUsage\n Other errors (`customer.address.update.error.failureCode`)\
\ may be returned if `AddressUpdateHandlers` are registered "
401:
description: Unauthorized
403:
description: |-
FORBIDDEN
possible values for header error-key:
- customer.address.update.error.AddressNotUpdatable
404:
description: |-
Not found
possible values for header error-key:
- customer.address.not_found.error
security:
- bearerAuth: []
- basicAuth: []
- authToken: []
x-origin-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)
x-origin-class: com.intershop.sellside.rest.common.capi.resource.customer.address.CustomerAddressItemResource
delete:
tags:
- Address
summary: Delete customer address
description: Deletes a customer address
operationId: deleteAddress
parameters:
- name: CustomerKey
in: path
description: The key or UUID to resolve a single item
required: true
schema:
type: string
example: ExampleKey
x-item-key: com.intershop.sellside.rest.smb.capi.resource.customer.CustomerListResource
- name: CustomerAddressKey
in: path
description: The key or UUID to resolve a single item
required: true
schema:
type: string
example: ExampleKey
x-item-key: com.intershop.sellside.rest.common.capi.resource.customer.address.CustomerAddressListResource
responses:
204:
description: No content
401:
description: Unauthorized
404:
description: Not found
409:
description: |-
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
security:
- bearerAuth: []
- basicAuth: []
- authToken: []
x-origin-method: public javax.ws.rs.core.Response com.intershop.sellside.rest.common.capi.resource.customer.address.CustomerAddressItemResource.deleteAddress()
x-origin-class: com.intershop.sellside.rest.common.capi.resource.customer.address.CustomerAddressItemResource
/customers/{CustomerKey}/costcenters:
get:
tags:
- Cost Center
summary: Returns all cost centers
description: This operation returns a list of links to all cost centers of the customer as well as some of their properties.
operationId: getCostCenters
parameters:
- name: CustomerKey
in: path
description: The key or UUID to resolve a single item
required: true
schema:
type: string
example: ExampleKey
x-item-key: com.intershop.sellside.rest.smb.capi.resource.customer.CustomerListResource
responses:
200:
description: OK - The list of cost centers.
content:
application/json:
schema:
type: array
description: OK - The list of cost centers.
items:
$ref: '#/components/schemas/LinkRO'
401:
description: Unauthorized - The user could not be authenticated.
403:
description: Forbidden - The user is not allowed to access this resource.
404:
description: Not found - The customer could not be found.
security:
- bearerAuth: []
- basicAuth: []
- authToken: []
x-origin-method: public javax.ws.rs.core.Response com.intershop.sellside.rest.b2b.costcenter.capi.resource.CostCenterListResource.getCostCenters()
x-origin-class: com.intershop.sellside.rest.b2b.costcenter.capi.resource.CostCenterListResource
post:
tags:
- Cost Center
summary: Creates a new cost center
description: This operation creates a new cost center.
operationId: createCostCenter
parameters:
- name: CustomerKey
in: path
description: The key or UUID to resolve a single item
required: true
schema:
type: string
example: ExampleKey
x-item-key: com.intershop.sellside.rest.smb.capi.resource.customer.CustomerListResource
requestBody:
description: The information about the new cost center. For the costcenter owner only the login is required.
content:
application/json:
schema:
$ref: '#/components/schemas/NewCostCenterRO'
responses:
201:
description: Created - The new cost center.
content:
application/json:
schema:
$ref: '#/components/schemas/LinkRO'
401:
description: Unauthorized - The user could not be authenticated.
403:
description: Forbidden - The user is not allowed to access this resource.
404:
description: Not found - The customer could not be found.
security:
- bearerAuth: []
- basicAuth: []
- authToken: []
x-origin-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)
x-origin-class: com.intershop.sellside.rest.b2b.costcenter.capi.resource.CostCenterListResource
/customers/{CustomerKey}/costcenters/{CostCenterKey}:
get:
tags:
- Cost Center
summary: Returns cost center details
description: This operation returns detail information about the cost center with the given ID.
operationId: getCostCenter
parameters:
- name: CustomerKey
in: path
description: The key or UUID to resolve a single item
required: true
schema:
type: string
example: ExampleKey
x-item-key: com.intershop.sellside.rest.smb.capi.resource.customer.CustomerListResource
- name: CostCenterKey
in: path
description: The automatically assigned cost center ID
required: true
schema:
type: string
description: The automatically assigned cost center ID
example: Z.8KDgAFgJsAAAF2wyUMzLSE
example: Z.8KDgAFgJsAAAF2wyUMzLSE
x-item-key: com.intershop.sellside.rest.b2b.costcenter.capi.resource.CostCenterListResource
responses:
200:
description: OK - The cost center with the given ID.
content:
application/json:
schema:
$ref: '#/components/schemas/CostCenterRO'
401:
description: Unathorized - The user could not be authenticated.
404:
description: Not found - The customer or the cost center could not be found.
403:
description: Forbidden - The user is not allowed to access this resource.
security:
- bearerAuth: []
- basicAuth: []
- authToken: []
x-origin-method: public javax.ws.rs.core.Response com.intershop.sellside.rest.b2b.costcenter.capi.resource.CostCenterItemResource.getCostCenter()
x-origin-class: com.intershop.sellside.rest.b2b.costcenter.capi.resource.CostCenterItemResource
delete:
tags:
- Cost Center
summary: Removes the cost center
description: This operation removes the cost center with the given ID.
operationId: deleteCostCenter
parameters:
- name: CustomerKey
in: path
description: The key or UUID to resolve a single item
required: true
schema:
type: string
example: ExampleKey
x-item-key: com.intershop.sellside.rest.smb.capi.resource.customer.CustomerListResource
- name: CostCenterKey
in: path
description: The automatically assigned cost center ID
required: true
schema:
type: string
description: The automatically assigned cost center ID
example: Z.8KDgAFgJsAAAF2wyUMzLSE
example: Z.8KDgAFgJsAAAF2wyUMzLSE
x-item-key: com.intershop.sellside.rest.b2b.costcenter.capi.resource.CostCenterListResource
responses:
204:
description: No content - The cost center was deleted.
401:
description: Unathorized - The user could not be authenticated.
404:
description: Not found - The customer or the cost center could not be found.
403:
description: Forbidden - The user is not allowed to access this resource.
security:
- bearerAuth: []
- basicAuth: []
- authToken: []
x-origin-method: public javax.ws.rs.core.Response com.intershop.sellside.rest.b2b.costcenter.capi.resource.CostCenterItemResource.deleteCostCenter()
x-origin-class: com.intershop.sellside.rest.b2b.costcenter.capi.resource.CostCenterItemResource
patch:
tags:
- Cost Center
summary: Updates the cost center
description: This operation updates the cost center information.
operationId: updateCostCenter
parameters:
- name: CustomerKey
in: path
description: The key or UUID to resolve a single item
required: true
schema:
type: string
example: ExampleKey
x-item-key: com.intershop.sellside.rest.smb.capi.resource.customer.CustomerListResource
- name: CostCenterKey
in: path
description: The automatically assigned cost center ID
required: true
schema:
type: string
description: The automatically assigned cost center ID
example: Z.8KDgAFgJsAAAF2wyUMzLSE
example: Z.8KDgAFgJsAAAF2wyUMzLSE
x-item-key: com.intershop.sellside.rest.b2b.costcenter.capi.resource.CostCenterListResource
requestBody:
description: The new information about the cost center. For the cost center owner only the login is required.
content:
application/json:
schema:
$ref: '#/components/schemas/UpdateCostCenterRO'
responses:
200:
description: OK - The updated cost center.
content:
application/json:
schema:
$ref: '#/components/schemas/CostCenterRO'
401:
description: Unathorized - The user could not be authenticated.
404:
description: Not found - The customer or the cost center could not be found.
403:
description: Forbidden - The user is not allowed to access this resource.
security:
- bearerAuth: []
- basicAuth: []
- authToken: []
x-origin-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)
x-origin-class: com.intershop.sellside.rest.b2b.costcenter.capi.resource.CostCenterItemResource
/customers/{CustomerKey}/costcenters/{CostCenterKey}/buyers:
get:
tags:
- Cost Center
summary: Returns all buyers for the cost center
description: This operation returns a list of links to all assigned buyers for the given cost center, as well as some of their properties.
operationId: getCostCenterBuyers
parameters:
- name: CustomerKey
in: path
description: The key or UUID to resolve a single item
required: true
schema:
type: string
example: ExampleKey
x-item-key: com.intershop.sellside.rest.smb.capi.resource.customer.CustomerListResource
- name: CostCenterKey
in: path
description: The automatically assigned cost center ID
required: true
schema:
type: string
description: The automatically assigned cost center ID
example: Z.8KDgAFgJsAAAF2wyUMzLSE
example: Z.8KDgAFgJsAAAF2wyUMzLSE
x-item-key: com.intershop.sellside.rest.b2b.costcenter.capi.resource.CostCenterListResource
responses:
200:
description: OK - The cost center buyers.
content:
application/json:
schema:
type: array
description: OK - The cost center buyers.
items:
$ref: '#/components/schemas/LinkRO'
401:
description: Unathorized - The user could not be authenticated.
404:
description: Not found - The customer or cost center could not be found.
403:
description: Forbidden - The user is not allowed to access this resource.
security:
- bearerAuth: []
- basicAuth: []
- authToken: []
x-origin-method: public javax.ws.rs.core.Response com.intershop.sellside.rest.b2b.costcenter.capi.resource.CostCenterBuyerListResource.getCostCenterBuyers()
x-origin-class: com.intershop.sellside.rest.b2b.costcenter.capi.resource.CostCenterBuyerListResource
post:
tags:
- Cost Center
summary: Adds a new cost center buyer
description: This operation adds a new buyer to the given cost center.
operationId: addCostCenterBuyer
parameters:
- name: CustomerKey
in: path
description: The key or UUID to resolve a single item
required: true
schema:
type: string
example: ExampleKey
x-item-key: com.intershop.sellside.rest.smb.capi.resource.customer.CustomerListResource
- name: CostCenterKey
in: path
description: The automatically assigned cost center ID
required: true
schema:
type: string
description: The automatically assigned cost center ID
example: Z.8KDgAFgJsAAAF2wyUMzLSE
example: Z.8KDgAFgJsAAAF2wyUMzLSE
x-item-key: com.intershop.sellside.rest.b2b.costcenter.capi.resource.CostCenterListResource
requestBody:
description: The information about the new cost center buyer.
content:
application/json:
schema:
$ref: '#/components/schemas/NewCostCenterBuyerRO'
responses:
200:
description: OK - The added buyer.
content:
application/json:
schema:
$ref: '#/components/schemas/CostCenterUserRO'
401:
description: Unathorized - The user could not be authenticated.
403:
description: Forbidden - The user is not allowed to access this resource.
404:
description: Not found - The customer or cost center could not be found.
security:
- bearerAuth: []
- basicAuth: []
- authToken: []
x-origin-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)
x-origin-class: com.intershop.sellside.rest.b2b.costcenter.capi.resource.CostCenterBuyerListResource
/customers/{CustomerKey}/costcenters/{CostCenterKey}/buyers/{CostCenterBuyerKey}:
get:
tags:
- Cost Center
summary: Returns information about a buyer of the cost center
description: This operation returns information about a buyer of the cost center.
operationId: getCostCenterBuyer
parameters:
- name: CustomerKey
in: path
description: The key or UUID to resolve a single item
required: true
schema:
type: string
example: ExampleKey
x-item-key: com.intershop.sellside.rest.smb.capi.resource.customer.CustomerListResource
- name: CostCenterKey
in: path
description: The automatically assigned cost center ID
required: true
schema:
type: string
description: The automatically assigned cost center ID
example: Z.8KDgAFgJsAAAF2wyUMzLSE
example: Z.8KDgAFgJsAAAF2wyUMzLSE
x-item-key: com.intershop.sellside.rest.b2b.costcenter.capi.resource.CostCenterListResource
- name: CostCenterBuyerKey
in: path
description: The login of the cost center buyer
required: true
schema:
type: string
description: The login of the cost center buyer
example: pmiller@test.intershop.de
example: pmiller@test.intershop.de
x-item-key: com.intershop.sellside.rest.b2b.costcenter.capi.resource.CostCenterBuyerListResource
responses:
200:
description: OK - The buyer information.
content:
application/json:
schema:
$ref: '#/components/schemas/CostCenterUserRO'
401:
description: Unathorized - The user could not be authenticated.
404:
description: Not found - The customer, cost center or buyer could not be found.
403:
description: Forbidden - The user is not allowed to access this resource.
security:
- bearerAuth: []
- basicAuth: []
- authToken: []
x-origin-method: public javax.ws.rs.core.Response com.intershop.sellside.rest.b2b.costcenter.capi.resource.CostCenterBuyerItemResource.getCostCenterBuyer()
x-origin-class: com.intershop.sellside.rest.b2b.costcenter.capi.resource.CostCenterBuyerItemResource
delete:
tags:
- Cost Center
summary: Removes the buyer from the cost center
description: This operation removes the given buyer from the cost center.
operationId: removeCostCenterBuyer
parameters:
- name: CustomerKey
in: path
description: The key or UUID to resolve a single item
required: true
schema:
type: string
example: ExampleKey
x-item-key: com.intershop.sellside.rest.smb.capi.resource.customer.CustomerListResource
- name: CostCenterKey
in: path
description: The automatically assigned cost center ID
required: true
schema:
type: string
description: The automatically assigned cost center ID
example: Z.8KDgAFgJsAAAF2wyUMzLSE
example: Z.8KDgAFgJsAAAF2wyUMzLSE
x-item-key: com.intershop.sellside.rest.b2b.costcenter.capi.resource.CostCenterListResource
- name: CostCenterBuyerKey
in: path
description: The login of the cost center buyer
required: true
schema:
type: string
description: The login of the cost center buyer
example: pmiller@test.intershop.de
example: pmiller@test.intershop.de
x-item-key: com.intershop.sellside.rest.b2b.costcenter.capi.resource.CostCenterBuyerListResource
responses:
204:
description: No content - The cost center buyer was removed.
401:
description: Unathorized - The user could not be authenticated.
404:
description: Not found - The customer, cost center or buyer could not be found.
403:
description: Forbidden - The user is not allowed to access this resource.
security:
- bearerAuth: []
- basicAuth: []
- authToken: []
x-origin-method: public javax.ws.rs.core.Response com.intershop.sellside.rest.b2b.costcenter.capi.resource.CostCenterBuyerItemResource.removeCostCenterBuyer()
x-origin-class: com.intershop.sellside.rest.b2b.costcenter.capi.resource.CostCenterBuyerItemResource
patch:
tags:
- Cost Center
summary: Updates the budget for a buyer of the cost center
description: This operation updates the budget for a buyer of the cost center.
operationId: updateCostCenterBuyer
parameters:
- name: CustomerKey
in: path
description: The key or UUID to resolve a single item
required: true
schema:
type: string
example: ExampleKey
x-item-key: com.intershop.sellside.rest.smb.capi.resource.customer.CustomerListResource
- name: CostCenterKey
in: path
description: The automatically assigned cost center ID
required: true
schema:
type: string
description: The automatically assigned cost center ID
example: Z.8KDgAFgJsAAAF2wyUMzLSE
example: Z.8KDgAFgJsAAAF2wyUMzLSE
x-item-key: com.intershop.sellside.rest.b2b.costcenter.capi.resource.CostCenterListResource
- name: CostCenterBuyerKey
in: path
description: The login of the cost center buyer
required: true
schema:
type: string
description: The login of the cost center buyer
example: pmiller@test.intershop.de
example: pmiller@test.intershop.de
x-item-key: com.intershop.sellside.rest.b2b.costcenter.capi.resource.CostCenterBuyerListResource
requestBody:
description: The updated budget for the cost center buyer.
content:
application/json:
schema:
$ref: '#/components/schemas/UpdateCostCenterBuyerRO'
responses:
200:
description: OK - The cost center buyer with the updated budget.
content:
application/json:
schema:
$ref: '#/components/schemas/CostCenterUserRO'
401:
description: Unathorized - The user could not be authenticated.
404:
description: Not found - The customer, cost center or buyer could not be found.
403:
description: Forbidden - The user is not allowed to access this resource.
security:
- bearerAuth: []
- basicAuth: []
- authToken: []
x-origin-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)
x-origin-class: com.intershop.sellside.rest.b2b.costcenter.capi.resource.CostCenterBuyerItemResource
/customers/{CustomerKey}/payments:
get:
tags:
- Payment
summary: 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.
operationId: getPayments
parameters:
- name: CustomerKey
in: path
description: The key or UUID to resolve a single item
required: true
schema:
type: string
example: ExampleKey
x-item-key: com.intershop.sellside.rest.smb.capi.resource.customer.CustomerListResource
responses:
200:
description: OK
content:
application/json:
schema:
$ref: '#/components/schemas/ResourceCollectionROLinkRO'
text/xml:
schema:
$ref: '#/components/schemas/ResourceCollectionROLinkRO'
links:
itemInfo:
operationId: getPayment
parameters:
CustomerPaymentKey: $response.body#/elements/{$index}/itemId
description: Links to item of type PaymentRO
401:
description: Unauthorized
404:
description: "Not found\n value for header error-key: \n - payment.instrument.not_found.error\
\ (e.g. unregistred user)"
security:
- bearerAuth: []
- basicAuth: []
- authToken: []
x-origin-method: public com.intershop.component.rest.capi.resourceobject.ResourceCollectionRO com.intershop.sellside.rest.common.capi.resource.customer.payment.CustomerPaymentListResource.getPayments()
x-origin-class: com.intershop.sellside.rest.common.capi.resource.customer.payment.CustomerPaymentListResource
post:
tags:
- Payment
summary: Add a payment to Customer profile
description: Adds a payment to the customer profile of the logged in customer.
operationId: createPayment
parameters:
- name: CustomerKey
in: path
description: The key or UUID to resolve a single item
required: true
schema:
type: string
example: ExampleKey
x-item-key: com.intershop.sellside.rest.smb.capi.resource.customer.CustomerListResource
requestBody:
content:
application/json:
schema:
$ref: '#/components/schemas/PaymentRO'
text/xml:
schema:
$ref: '#/components/schemas/PaymentRO'
responses:
201:
description: Created
401:
description: Unauthorized
400:
description: |-
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
security:
- bearerAuth: []
- basicAuth: []
- authToken: []
x-origin-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)
x-origin-class: com.intershop.sellside.rest.common.capi.resource.customer.payment.CustomerPaymentListResource
options:
tags:
- Payment
summary: Return payment options for customer
description: Returns all available payment methods and its parameters that can be added to the customer
operationId: getPaymentOptions
parameters:
- name: CustomerKey
in: path
description: The key or UUID to resolve a single item
required: true
schema:
type: string
example: ExampleKey
x-item-key: com.intershop.sellside.rest.smb.capi.resource.customer.CustomerListResource
responses:
200:
description: OK
content:
application/json:
schema:
$ref: '#/components/schemas/PaymentOptionsRO'
text/xml:
schema:
$ref: '#/components/schemas/PaymentOptionsRO'
401:
description: Unauthorized
security:
- bearerAuth: []
- basicAuth: []
- authToken: []
x-origin-method: public com.intershop.sellside.rest.common.capi.resourceobject.basket.PaymentOptionsRO com.intershop.sellside.rest.common.capi.resource.customer.payment.CustomerPaymentListResource.getPaymentOptions()
x-origin-class: com.intershop.sellside.rest.common.capi.resource.customer.payment.CustomerPaymentListResource
/customers/{CustomerKey}/payments/{CustomerPaymentKey}:
get:
tags:
- Payment
summary: Get details of a customer profile payment
description: Returns detailed information of a payment method available for a customer
operationId: getPayment
parameters:
- name: CustomerKey
in: path
description: The key or UUID to resolve a single item
required: true
schema:
type: string
example: ExampleKey
x-item-key: com.intershop.sellside.rest.smb.capi.resource.customer.CustomerListResource
- name: CustomerPaymentKey
in: path
description: The key or UUID to resolve a single item
required: true
schema:
type: string
example: ExampleKey
x-item-key: com.intershop.sellside.rest.common.capi.resource.customer.payment.CustomerPaymentListResource
responses:
200:
description: OK
content:
application/json:
schema:
$ref: '#/components/schemas/PaymentRO'
text/xml:
schema:
$ref: '#/components/schemas/PaymentRO'
401:
description: Unauthorized
404:
description: "Not found\n value for header error-key: \n - payment.instrument.not_found.error\
\ (e.g. unregistred user)"
security:
- bearerAuth: []
- basicAuth: []
- authToken: []
x-origin-method: public com.intershop.sellside.rest.common.capi.resourceobject.basket.PaymentRO com.intershop.sellside.rest.common.capi.resource.customer.payment.CustomerPaymentItemResource.getPayment()
x-origin-class: com.intershop.sellside.rest.common.capi.resource.customer.payment.CustomerPaymentItemResource
put:
tags:
- Payment
summary: 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.
operationId: updatePayment
parameters:
- name: CustomerKey
in: path
description: The key or UUID to resolve a single item
required: true
schema:
type: string
example: ExampleKey
x-item-key: com.intershop.sellside.rest.smb.capi.resource.customer.CustomerListResource
- name: CustomerPaymentKey
in: path
description: The key or UUID to resolve a single item
required: true
schema:
type: string
example: ExampleKey
x-item-key: com.intershop.sellside.rest.common.capi.resource.customer.payment.CustomerPaymentListResource
requestBody:
content:
application/json:
schema:
$ref: '#/components/schemas/PaymentRO'
text/xml:
schema:
$ref: '#/components/schemas/PaymentRO'
responses:
200:
description: OK
content:
application/json:
schema:
$ref: '#/components/schemas/PaymentRO'
text/xml:
schema:
$ref: '#/components/schemas/PaymentRO'
401:
description: Unauthorized
400:
description: |-
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
security:
- bearerAuth: []
- basicAuth: []
- authToken: []
x-origin-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)
x-origin-class: com.intershop.sellside.rest.common.capi.resource.customer.payment.CustomerPaymentItemResource
delete:
tags:
- Payment
summary: Remove a payment from customer profile
description: Removes a payment method from the customer profile of the logged in customer
operationId: deletePayment
parameters:
- name: CustomerKey
in: path
description: The key or UUID to resolve a single item
required: true
schema:
type: string
example: ExampleKey
x-item-key: com.intershop.sellside.rest.smb.capi.resource.customer.CustomerListResource
- name: CustomerPaymentKey
in: path
description: The key or UUID to resolve a single item
required: true
schema:
type: string
example: ExampleKey
x-item-key: com.intershop.sellside.rest.common.capi.resource.customer.payment.CustomerPaymentListResource
responses:
200:
description: OK
content:
application/json:
schema:
$ref: '#/components/schemas/LinkRO'
text/xml:
schema:
$ref: '#/components/schemas/LinkRO'
401:
description: Unauthorized
404:
description: Not found
security:
- bearerAuth: []
- basicAuth: []
- authToken: []
x-origin-method: public com.intershop.component.rest.capi.resourceobject.LinkRO com.intershop.sellside.rest.common.capi.resource.customer.payment.CustomerPaymentItemResource.deletePayment()
x-origin-class: com.intershop.sellside.rest.common.capi.resource.customer.payment.CustomerPaymentItemResource
/customers/{CustomerKey}/users:
get:
tags:
- User
summary: Get users of SMB customer
description: List all registered users of selected SMB customer with link to user item resource.
operationId: getCustomers
parameters:
- name: offset
in: query
description: The start element position
schema:
type: string
default: "0"
- name: limit
in: query
description: The count of users to return
schema:
type: string
default: "50"
- name: filter
in: query
description: Only users which firtName, lastName or login contains the filter will be returned
schema:
type: string
- name: sort
in: query
description: The sorting to be applied on returned users. Minus means sorting in DESC direction.
schema:
type: string
enum:
- name
- creationDate
- login
- -name
- -creationDate
- -login
default: name
- name: CustomerKey
in: path
description: The key or UUID to resolve a single item
required: true
schema:
type: string
example: ExampleKey
x-item-key: com.intershop.sellside.rest.smb.capi.resource.customer.CustomerListResource
responses:
200:
description: The list of registered users
content:
application/json:
schema:
$ref: '#/components/schemas/UserLinkROCollection'
text/xml:
schema:
$ref: '#/components/schemas/UserLinkROCollection'
401:
description: Unauthorized
content:
application/json:
schema:
type: string
text/xml:
schema:
type: string
404:
description: Not found
content:
application/json:
schema:
type: string
text/xml:
schema:
type: string
security:
- bearerAuth: []
- basicAuth: []
- authToken: []
x-origin-method: public javax.ws.rs.core.Response com.intershop.sellside.rest.smb.capi.resource.user.CustomerItemUserListResource.getCustomers()
x-origin-class: com.intershop.sellside.rest.smb.capi.resource.user.CustomerItemUserListResource
post:
tags:
- User
summary: Registers new users of SMB customer
operationId: addUsersToCustomer
parameters:
- name: CustomerKey
in: path
description: The key or UUID to resolve a single item
required: true
schema:
type: string
example: ExampleKey
x-item-key: com.intershop.sellside.rest.smb.capi.resource.customer.CustomerListResource
requestBody:
description: A collection with data of the new users to be created.
content:
application/json:
schema:
$ref: '#/components/schemas/SMBCustomerUserROCollection'
text/xml:
schema:
$ref: '#/components/schemas/SMBCustomerUserROCollection'
responses:
201:
description: Collection with links to created users
content:
application/json:
schema:
$ref: '#/components/schemas/UserLinkROCollection'
text/xml:
schema:
$ref: '#/components/schemas/UserLinkROCollection'
207:
description: Collection with links to created users and header 'not-created-users' with list of users which creation finished with error
content:
application/json:
schema:
$ref: '#/components/schemas/UserLinkROCollection'
text/xml:
schema:
$ref: '#/components/schemas/UserLinkROCollection'
401:
description: Unauthorized
content:
application/json:
schema:
type: string
text/xml:
schema:
type: string
409:
description: In case user with provided login or business partner number already exists
content:
application/json:
schema:
type: string
text/xml:
schema:
type: string
400:
description: In case provided login is not acceptable
content:
application/json:
schema:
type: string
text/xml:
schema:
type: string
500:
description: In case provided user data contain missing or invalid fields
content:
application/json:
schema:
type: string
text/xml:
schema:
type: string
security:
- bearerAuth: []
- basicAuth: []
- authToken: []
x-origin-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)
x-origin-class: com.intershop.sellside.rest.smb.capi.resource.user.CustomerItemUserListResource
/customers/{CustomerKey}/users/{CustomerItemUserKey}:
get:
tags:
- User
summary: Get user profile data of selected user
operationId: getCustomerUser
parameters:
- name: include
in: query
description: The relations to be included in returned user data, If not provided all user data will be included.
schema:
type: string
enum:
- general
- preferredShipToAddress
- preferredInvoiceToAddress
- name: CustomerKey
in: path
description: The key or UUID to resolve a single item
required: true
schema:
type: string
example: ExampleKey
x-item-key: com.intershop.sellside.rest.smb.capi.resource.customer.CustomerListResource
- name: CustomerItemUserKey
in: path
description: The key or UUID to resolve a single item
required: true
schema:
type: string
example: ExampleKey
x-item-key: com.intershop.sellside.rest.smb.capi.resource.user.CustomerItemUserListResource
responses:
200:
description: Display available user data. In case user has preferred address assigned, all address data will be displayed in the response.
content:
application/json:
schema:
$ref: '#/components/schemas/SMBCustomerUserRO'
text/xml:
schema:
$ref: '#/components/schemas/SMBCustomerUserRO'
401:
description: Unauthorized
content:
application/json:
schema:
type: string
text/xml:
schema:
type: string
404:
description: Not found
content:
application/json:
schema:
type: string
text/xml:
schema:
type: string
security:
- bearerAuth: []
- basicAuth: []
- authToken: []
x-origin-method: public com.intershop.sellside.rest.smb.capi.resourceobject.SMBCustomerUserRO com.intershop.sellside.rest.smb.capi.resource.user.CustomerItemUserItemResource.getCustomerUser()
x-origin-class: com.intershop.sellside.rest.smb.capi.resource.user.CustomerItemUserItemResource
put:
tags:
- User
summary: Update the profile of selected user of SMB customer
operationId: updateCustomerUser
parameters:
- name: CustomerKey
in: path
description: The key or UUID to resolve a single item
required: true
schema:
type: string
example: ExampleKey
x-item-key: com.intershop.sellside.rest.smb.capi.resource.customer.CustomerListResource
- name: CustomerItemUserKey
in: path
description: The key or UUID to resolve a single item
required: true
schema:
type: string
example: ExampleKey
x-item-key: com.intershop.sellside.rest.smb.capi.resource.user.CustomerItemUserListResource
requestBody:
description: The updated data of the user.
content:
application/json:
schema:
$ref: '#/components/schemas/SMBCustomerUserRO'
text/xml:
schema:
$ref: '#/components/schemas/SMBCustomerUserRO'
responses:
200:
description: OK
content:
application/json:
schema:
$ref: '#/components/schemas/SMBCustomerUserRO'
text/xml:
schema:
$ref: '#/components/schemas/SMBCustomerUserRO'
401:
description: Unauthorized
content:
application/json:
schema:
type: string
text/xml:
schema:
type: string
404:
description: Not found
content:
application/json:
schema:
type: string
text/xml:
schema:
type: string
400:
description: Bad request
content:
application/json:
schema:
type: string
text/xml:
schema:
type: string
409:
description: In case user with provided business partner number already exists
content:
application/json:
schema:
type: string
text/xml:
schema:
type: string
500:
description: In case provided user data contain missing or invalid fields
content:
application/json:
schema:
type: string
text/xml:
schema:
type: string
security:
- bearerAuth: []
- basicAuth: []
- authToken: []
x-origin-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)
x-origin-class: com.intershop.sellside.rest.smb.capi.resource.user.CustomerItemUserItemResource
delete:
tags:
- User
summary: Delete user of SMB customer
description: Deletes the user with the same ID or login as the item resource name
operationId: deleteUser
parameters:
- name: CustomerKey
in: path
description: The key or UUID to resolve a single item
required: true
schema:
type: string
example: ExampleKey
x-item-key: com.intershop.sellside.rest.smb.capi.resource.customer.CustomerListResource
- name: CustomerItemUserKey
in: path
description: The key or UUID to resolve a single item
required: true
schema:
type: string
example: ExampleKey
x-item-key: com.intershop.sellside.rest.smb.capi.resource.user.CustomerItemUserListResource
responses:
204:
description: No content
401:
description: Unauthorized
content:
'*/*':
schema:
type: string
404:
description: Not found
content:
'*/*':
schema:
type: string
403:
description: |-
FORBIDDEN
Requires authentication with user having assigned the following permission: Manage Users (APP_B2B_MANAGE_USERS)
content:
'*/*':
schema:
type: string
security:
- bearerAuth: []
- basicAuth: []
- authToken: []
x-origin-method: public javax.ws.rs.core.Response com.intershop.sellside.rest.smb.capi.resource.user.CustomerItemUserItemResource.deleteUser()
x-origin-class: com.intershop.sellside.rest.smb.capi.resource.user.CustomerItemUserItemResource
/customers/{CustomerKey}/users/{CustomerItemUserKey}/costcenters:
get:
tags:
- Cost Center
summary: Returns a list of cost centers of a business user
description: This operation returns a list of all cost centers to which the user is assigned (as a buyer or approver).
operationId: getCostCenters_1
parameters:
- name: CustomerKey
in: path
description: The key or UUID to resolve a single item
required: true
schema:
type: string
example: ExampleKey
x-item-key: com.intershop.sellside.rest.smb.capi.resource.customer.CustomerListResource
- name: CustomerItemUserKey
in: path
description: The key or UUID to resolve a single item
required: true
schema:
type: string
example: ExampleKey
x-item-key: com.intershop.sellside.rest.smb.capi.resource.user.CustomerItemUserListResource
responses:
200:
description: OK - The list of cost centers.
content:
application/json:
schema:
$ref: '#/components/schemas/UserCostCenterLinkROCollection'
text/xml:
schema:
$ref: '#/components/schemas/UserCostCenterLinkROCollection'
401:
description: Unauthorized - The user could not be authenticated.
403:
description: Forbidden - The user is not allowed to access this resource.
404:
description: Not found - The customer or user could not be found or does not support cost centers.
security:
- bearerAuth: []
- basicAuth: []
- authToken: []
x-origin-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()
x-origin-class: com.intershop.application.storefront.rest.b2b.capi.user.costcenter.resource.UserCostCenterListResource
/customers/{CustomerKey}/users/{CustomerItemUserKey}/costcenters/{UserCostCenterKey}:
get:
tags:
- Cost Center
summary: Returns business user cost center details
description: This operation returns the details of a specified cost center of a business user.
operationId: getUserCostCenter
parameters:
- name: CustomerKey
in: path
description: The key or UUID to resolve a single item
required: true
schema:
type: string
example: ExampleKey
x-item-key: com.intershop.sellside.rest.smb.capi.resource.customer.CustomerListResource
- name: CustomerItemUserKey
in: path
description: The key or UUID to resolve a single item
required: true
schema:
type: string
example: ExampleKey
x-item-key: com.intershop.sellside.rest.smb.capi.resource.user.CustomerItemUserListResource
- name: UserCostCenterKey
in: path
description: The cost center ID assigned by the customer
required: true
schema:
type: string
description: The cost center ID assigned by the customer
example: "100401"
example: "100401"
x-item-key: com.intershop.application.storefront.rest.b2b.capi.user.costcenter.resource.UserCostCenterListResource
responses:
200:
description: OK - The cost center details.
content:
application/json:
schema:
$ref: '#/components/schemas/UserCostCenterRO'
text/xml:
schema:
$ref: '#/components/schemas/UserCostCenterRO'
401:
description: Unauthorized - The user could not be authenticated.
403:
description: Forbidden - The user is not allowed to access this resource.
404:
description: Not found - The customer or user could not be found, does not support cost centers or is not assigned to a cost center (as buyer or approver).
security:
- bearerAuth: []
- basicAuth: []
- authToken: []
x-origin-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()
x-origin-class: com.intershop.application.storefront.rest.b2b.capi.user.costcenter.resource.UserCostCenterItemResource
/customers/{CustomerKey}/users/{CustomerItemUserKey}/giftcardsandcertificates:
get:
tags:
- Gift Card and Certificate
summary: Returns gift cards and certificates
description: This operation returns a list of gift cards and certificates associated with the current user.
operationId: getGiftCardsAndCertificates_1
parameters:
- name: CustomerKey
in: path
description: The key or UUID to resolve a single item
required: true
schema:
type: string
example: ExampleKey
x-item-key: com.intershop.sellside.rest.smb.capi.resource.customer.CustomerListResource
- name: CustomerItemUserKey
in: path
description: The key or UUID to resolve a single item
required: true
schema:
type: string
example: ExampleKey
x-item-key: com.intershop.sellside.rest.smb.capi.resource.user.CustomerItemUserListResource
responses:
200:
description: OK - The list of gift cards and certificates.
content:
application/json:
schema:
$ref: '#/components/schemas/LinkROResourceCollectionRO'
text/xml:
schema:
$ref: '#/components/schemas/LinkROResourceCollectionRO'
404:
description: Not found - The customer or user could not be found.
403:
description: Forbidden - The authenticated user does not match the requested user.
401:
description: Unauthorized - The user could not be authenticated.
security:
- bearerAuth: []
- basicAuth: []
- authToken: []
x-origin-method: public com.intershop.component.rest.capi.resourceobject.ResourceCollectionRO com.intershop.sellside.rest.common.capi.resource.customer.giftcardsandcertificates.CustomerGiftCardsAndCertificatesResource.getGiftCardsAndCertificates()
x-origin-class: com.intershop.sellside.rest.common.capi.resource.customer.giftcardsandcertificates.CustomerGiftCardsAndCertificatesResource
/customers/{CustomerKey}/users/{CustomerItemUserKey}/giftcardsandcertificates/{CustomerGiftCardAndCertificateResourceKey}:
get:
tags:
- Gift Card and Certificate
summary: Returns gift card or certificate details
description: This operation returns details about a specific gift card or certificate associated with the current user.
operationId: getGiftCardAndCertificate_1
parameters:
- name: CustomerKey
in: path
description: The key or UUID to resolve a single item
required: true
schema:
type: string
example: ExampleKey
x-item-key: com.intershop.sellside.rest.smb.capi.resource.customer.CustomerListResource
- name: CustomerItemUserKey
in: path
description: The key or UUID to resolve a single item
required: true
schema:
type: string
example: ExampleKey
x-item-key: com.intershop.sellside.rest.smb.capi.resource.user.CustomerItemUserListResource
- name: CustomerGiftCardAndCertificateResourceKey
in: path
description: The gift card or certificate number
required: true
schema:
type: string
description: The gift card or certificate number
example: "27755166187"
example: "27755166187"
x-item-key: com.intershop.sellside.rest.common.capi.resource.customer.giftcardsandcertificates.CustomerGiftCardsAndCertificatesResource
responses:
200:
description: OK - The gift card or certificate with the given ID.
content:
application/json:
schema:
$ref: '#/components/schemas/GiftCardAndCertificateRO'
text/xml:
schema:
$ref: '#/components/schemas/GiftCardAndCertificateRO'
404:
description: Not found - The customer, user or gift card/certificate could not be found.
403:
description: Forbidden - The authenticated user does not match the requested user.
401:
description: Unauthorized - The user could not be authenticated.
security:
- bearerAuth: []
- basicAuth: []
- authToken: []
x-origin-method: public com.intershop.sellside.rest.common.capi.resourceobject.GiftCardAndCertificateRO com.intershop.sellside.rest.common.capi.resource.customer.giftcardsandcertificates.balance.CustomerGiftCardAndCertificateResource.getGiftCardAndCertificate()
x-origin-class: com.intershop.sellside.rest.common.capi.resource.customer.giftcardsandcertificates.balance.CustomerGiftCardAndCertificateResource
/privatecustomers:
post:
tags:
- General
summary: Create individual customer
description: Creates an individual customer. Available for unregistered users only.
operationId: createCustomer_1
requestBody:
content:
application/json:
schema:
$ref: '#/components/schemas/NewCustomerRO'
text/xml:
schema:
$ref: '#/components/schemas/NewCustomerRO'
responses:
201:
description: Created
400:
description: |-
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:
description: Conflict
401:
description: Authorization is required if the customer gets assigned to an existing user
403:
description: Authorized user has to be the same as the one to get assigned to the new customer
security:
- bearerAuth: []
- basicAuth: []
- authToken: []
x-origin-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)
x-origin-class: com.intershop.sellside.rest.b2c.capi.resource.customer.PrivateCustomerListResource
/privatecustomers/simple:
post:
tags:
- General
summary: Create Customer
description: simplified creation process for new customerwith minimal information
operationId: createAccount
requestBody:
content:
application/json:
schema:
$ref: '#/components/schemas/CredentialsRO'
text/xml:
schema:
$ref: '#/components/schemas/CredentialsRO'
responses:
201:
description: Created
400:
description: Bad request
409:
description: |-
Conflict
possible values for header error-key:
- customer.already_exists.error
501:
description: |-
Not implemented
possible values for header error-key:
- customer.simpleaccount.not_possible.error
security:
- bearerAuth: []
- basicAuth: []
- authToken: []
x-origin-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)
x-origin-class: com.intershop.sellside.rest.b2c.capi.resource.customer.PrivateCustomerListResource
/privatecustomers/{CustomerKey}:
get:
tags:
- General
summary: Get current customer profile details
operationId: getCustomer_1
parameters:
- name: CustomerKey
in: path
description: The key or UUID to resolve a single item
required: true
schema:
type: string
example: ExampleKey
x-item-key: com.intershop.sellside.rest.b2c.capi.resource.customer.PrivateCustomerListResource
responses:
200:
description: OK
content:
application/json:
schema:
$ref: '#/components/schemas/PrivateCustomerRO'
text/xml:
schema:
$ref: '#/components/schemas/PrivateCustomerRO'
401:
description: Unauthorized
403:
description: FORBIDDEN
404:
description: Not found
security:
- bearerAuth: []
- basicAuth: []
- authToken: []
x-origin-method: public com.intershop.sellside.rest.b2c.capi.resourceobject.PrivateCustomerRO com.intershop.sellside.rest.b2c.capi.resource.customer.PrivateCustomerItemResource.getCustomer()
x-origin-class: com.intershop.sellside.rest.b2c.capi.resource.customer.PrivateCustomerItemResource
put:
tags:
- General
summary: Upates a customer
operationId: updateCustomer_1
parameters:
- name: CustomerKey
in: path
description: The key or UUID to resolve a single item
required: true
schema:
type: string
example: ExampleKey
x-item-key: com.intershop.sellside.rest.b2c.capi.resource.customer.PrivateCustomerListResource
requestBody:
content:
application/json:
schema:
$ref: '#/components/schemas/PrivateCustomerRO'
text/xml:
schema:
$ref: '#/components/schemas/PrivateCustomerRO'
responses:
200:
description: OK
content:
application/json:
schema:
$ref: '#/components/schemas/PrivateCustomerRO'
text/xml:
schema:
$ref: '#/components/schemas/PrivateCustomerRO'
401:
description: Unauthorized
400:
description: Bad request
404:
description: Not found
security:
- bearerAuth: []
- basicAuth: []
- authToken: []
x-origin-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)
x-origin-class: com.intershop.sellside.rest.b2c.capi.resource.customer.PrivateCustomerItemResource
/privatecustomers/{CustomerKey}/addresses:
get:
tags:
- Address
summary: Returns the customer's addresses
description: |
This operation returns a list of the customer's addresses based on the provided CustomerResourceKey. The response resource collection contains objects of the type LinkRO.
operationId: getAddresses
parameters:
- name: CustomerKey
in: path
description: The key or UUID to resolve a single item
required: true
schema:
type: string
example: ExampleKey
x-item-key: com.intershop.sellside.rest.b2c.capi.resource.customer.PrivateCustomerListResource
responses:
200:
description: OK - The addresses of the customer.
content:
application/json:
schema:
$ref: '#/components/schemas/ResourceCollectionROLinkRO'
text/xml:
schema:
$ref: '#/components/schemas/ResourceCollectionROLinkRO'
links:
itemInfo:
operationId: getAddress_1
parameters:
CustomerAddressKey: $response.body#/elements/{$index}/itemId
description: Links to item of type AddressRO
401:
description: Unauthorized - The organization is not valid.
security:
- bearerAuth: []
- basicAuth: []
- authToken: []
x-origin-method: public com.intershop.component.rest.capi.resourceobject.ResourceCollectionRO com.intershop.sellside.rest.common.capi.resource.customer.address.CustomerAddressListResource.getAddresses()
x-origin-class: com.intershop.sellside.rest.common.capi.resource.customer.address.CustomerAddressListResource
post:
tags:
- Address
summary: Create new customer address
description: Creates a new customer address by using POST data provided by the client
operationId: createAddress_1
parameters:
- name: CustomerKey
in: path
description: The key or UUID to resolve a single item
required: true
schema:
type: string
example: ExampleKey
x-item-key: com.intershop.sellside.rest.b2c.capi.resource.customer.PrivateCustomerListResource
requestBody:
content:
application/json:
schema:
$ref: '#/components/schemas/AddressRO'
text/xml:
schema:
$ref: '#/components/schemas/AddressRO'
responses:
200:
description: |-
OK
The created address is a duplicate. The existing instance is returned.
201:
description: |-
Created
Creation of a unique address finished succesfully
401:
description: Unauthorized
400:
description: |-
Bad request
possible values for header error-key:
- customer.address.invalid_fields.usage.error
- customer.address.missing_fields.error
404:
description: |-
Not found
possible values for header error-key:
- customer.address.not_found.error
security:
- bearerAuth: []
- basicAuth: []
- authToken: []
x-origin-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)
x-origin-class: com.intershop.sellside.rest.common.capi.resource.customer.address.CustomerAddressListResource
/privatecustomers/{CustomerKey}/addresses/{CustomerAddressKey}:
get:
tags:
- Address
summary: Get customer address details
description: Returns details about customer's address to the client
operationId: getAddress_1
parameters:
- name: CustomerKey
in: path
description: The key or UUID to resolve a single item
required: true
schema:
type: string
example: ExampleKey
x-item-key: com.intershop.sellside.rest.b2c.capi.resource.customer.PrivateCustomerListResource
- name: CustomerAddressKey
in: path
description: The key or UUID to resolve a single item
required: true
schema:
type: string
example: ExampleKey
x-item-key: com.intershop.sellside.rest.common.capi.resource.customer.address.CustomerAddressListResource
responses:
200:
description: OK
content:
application/json:
schema:
$ref: '#/components/schemas/AddressRO'
text/xml:
schema:
$ref: '#/components/schemas/AddressRO'
401:
description: Unauthorized
404:
description: |-
Not found
possible values for header error-key:
- customer.address_not_found.error
security:
- bearerAuth: []
- basicAuth: []
- authToken: []
x-origin-method: public com.intershop.sellside.rest.common.capi.resourceobject.AddressRO com.intershop.sellside.rest.common.capi.resource.customer.address.CustomerAddressItemResource.getAddress()
x-origin-class: com.intershop.sellside.rest.common.capi.resource.customer.address.CustomerAddressItemResource
put:
tags:
- Address
summary: Update customer address
description: Updates a customer address with address data provided from the client
operationId: updateAddress_1
parameters:
- name: CustomerKey
in: path
description: The key or UUID to resolve a single item
required: true
schema:
type: string
example: ExampleKey
x-item-key: com.intershop.sellside.rest.b2c.capi.resource.customer.PrivateCustomerListResource
- name: CustomerAddressKey
in: path
description: The key or UUID to resolve a single item
required: true
schema:
type: string
example: ExampleKey
x-item-key: com.intershop.sellside.rest.common.capi.resource.customer.address.CustomerAddressListResource
requestBody:
content:
application/json:
schema:
$ref: '#/components/schemas/AddressRO'
text/xml:
schema:
$ref: '#/components/schemas/AddressRO'
responses:
200:
description: OK
400:
description: "Bad request\n possible values for header error-key:\n - customer.address.missing_fields.error\n\
\ - customer.address.update.error.inconsistentUsage\n Other errors (`customer.address.update.error.failureCode`)\
\ may be returned if `AddressUpdateHandlers` are registered "
401:
description: Unauthorized
403:
description: |-
FORBIDDEN
possible values for header error-key:
- customer.address.update.error.AddressNotUpdatable
404:
description: |-
Not found
possible values for header error-key:
- customer.address.not_found.error
security:
- bearerAuth: []
- basicAuth: []
- authToken: []
x-origin-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)
x-origin-class: com.intershop.sellside.rest.common.capi.resource.customer.address.CustomerAddressItemResource
delete:
tags:
- Address
summary: Delete customer address
description: Deletes a customer address
operationId: deleteAddress_1
parameters:
- name: CustomerKey
in: path
description: The key or UUID to resolve a single item
required: true
schema:
type: string
example: ExampleKey
x-item-key: com.intershop.sellside.rest.b2c.capi.resource.customer.PrivateCustomerListResource
- name: CustomerAddressKey
in: path
description: The key or UUID to resolve a single item
required: true
schema:
type: string
example: ExampleKey
x-item-key: com.intershop.sellside.rest.common.capi.resource.customer.address.CustomerAddressListResource
responses:
204:
description: No content
401:
description: Unauthorized
404:
description: Not found
409:
description: |-
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
security:
- bearerAuth: []
- basicAuth: []
- authToken: []
x-origin-method: public javax.ws.rs.core.Response com.intershop.sellside.rest.common.capi.resource.customer.address.CustomerAddressItemResource.deleteAddress()
x-origin-class: com.intershop.sellside.rest.common.capi.resource.customer.address.CustomerAddressItemResource
/privatecustomers/{CustomerKey}/giftcardsandcertificates:
get:
tags:
- Gift Card and Certificate
summary: Returns gift cards and certificates
description: This operation returns a list of gift cards and certificates associated with the current user.
operationId: getGiftCardsAndCertificates
parameters:
- name: CustomerKey
in: path
description: The key or UUID to resolve a single item
required: true
schema:
type: string
example: ExampleKey
x-item-key: com.intershop.sellside.rest.b2c.capi.resource.customer.PrivateCustomerListResource
responses:
200:
description: OK - The list of gift cards and certificates.
content:
application/json:
schema:
$ref: '#/components/schemas/LinkROResourceCollectionRO'
text/xml:
schema:
$ref: '#/components/schemas/LinkROResourceCollectionRO'
404:
description: Not found - The customer or user could not be found.
403:
description: Forbidden - The authenticated user does not match the requested user.
401:
description: Unauthorized - The user could not be authenticated.
security:
- bearerAuth: []
- basicAuth: []
- authToken: []
x-origin-method: public com.intershop.component.rest.capi.resourceobject.ResourceCollectionRO com.intershop.sellside.rest.common.capi.resource.customer.giftcardsandcertificates.CustomerGiftCardsAndCertificatesResource.getGiftCardsAndCertificates()
x-origin-class: com.intershop.sellside.rest.common.capi.resource.customer.giftcardsandcertificates.CustomerGiftCardsAndCertificatesResource
/privatecustomers/{CustomerKey}/giftcardsandcertificates/{CustomerGiftCardAndCertificateResourceKey}:
get:
tags:
- Gift Card and Certificate
summary: Returns gift card or certificate details
description: This operation returns details about a specific gift card or certificate associated with the current user.
operationId: getGiftCardAndCertificate
parameters:
- name: CustomerKey
in: path
description: The key or UUID to resolve a single item
required: true
schema:
type: string
example: ExampleKey
x-item-key: com.intershop.sellside.rest.b2c.capi.resource.customer.PrivateCustomerListResource
- name: CustomerGiftCardAndCertificateResourceKey
in: path
description: The gift card or certificate number
required: true
schema:
type: string
description: The gift card or certificate number
example: "27755166187"
example: "27755166187"
x-item-key: com.intershop.sellside.rest.common.capi.resource.customer.giftcardsandcertificates.CustomerGiftCardsAndCertificatesResource
responses:
200:
description: OK - The gift card or certificate with the given ID.
content:
application/json:
schema:
$ref: '#/components/schemas/GiftCardAndCertificateRO'
text/xml:
schema:
$ref: '#/components/schemas/GiftCardAndCertificateRO'
404:
description: Not found - The customer, user or gift card/certificate could not be found.
403:
description: Forbidden - The authenticated user does not match the requested user.
401:
description: Unauthorized - The user could not be authenticated.
security:
- bearerAuth: []
- basicAuth: []
- authToken: []
x-origin-method: public com.intershop.sellside.rest.common.capi.resourceobject.GiftCardAndCertificateRO com.intershop.sellside.rest.common.capi.resource.customer.giftcardsandcertificates.balance.CustomerGiftCardAndCertificateResource.getGiftCardAndCertificate()
x-origin-class: com.intershop.sellside.rest.common.capi.resource.customer.giftcardsandcertificates.balance.CustomerGiftCardAndCertificateResource
/privatecustomers/{CustomerKey}/payments:
get:
tags:
- Payment
summary: 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.
operationId: getPayments_1
parameters:
- name: CustomerKey
in: path
description: The key or UUID to resolve a single item
required: true
schema:
type: string
example: ExampleKey
x-item-key: com.intershop.sellside.rest.b2c.capi.resource.customer.PrivateCustomerListResource
responses:
200:
description: OK
content:
application/json:
schema:
$ref: '#/components/schemas/ResourceCollectionROLinkRO'
text/xml:
schema:
$ref: '#/components/schemas/ResourceCollectionROLinkRO'
links:
itemInfo:
operationId: getPayment_1
parameters:
CustomerPaymentKey: $response.body#/elements/{$index}/itemId
description: Links to item of type PaymentRO
401:
description: Unauthorized
404:
description: "Not found\n value for header error-key: \n - payment.instrument.not_found.error\
\ (e.g. unregistred user)"
security:
- bearerAuth: []
- basicAuth: []
- authToken: []
x-origin-method: public com.intershop.component.rest.capi.resourceobject.ResourceCollectionRO com.intershop.sellside.rest.common.capi.resource.customer.payment.CustomerPaymentListResource.getPayments()
x-origin-class: com.intershop.sellside.rest.common.capi.resource.customer.payment.CustomerPaymentListResource
post:
tags:
- Payment
summary: Add a payment to Customer profile
description: Adds a payment to the customer profile of the logged in customer.
operationId: createPayment_1
parameters:
- name: CustomerKey
in: path
description: The key or UUID to resolve a single item
required: true
schema:
type: string
example: ExampleKey
x-item-key: com.intershop.sellside.rest.b2c.capi.resource.customer.PrivateCustomerListResource
requestBody:
content:
application/json:
schema:
$ref: '#/components/schemas/PaymentRO'
text/xml:
schema:
$ref: '#/components/schemas/PaymentRO'
responses:
201:
description: Created
401:
description: Unauthorized
400:
description: |-
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
security:
- bearerAuth: []
- basicAuth: []
- authToken: []
x-origin-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)
x-origin-class: com.intershop.sellside.rest.common.capi.resource.customer.payment.CustomerPaymentListResource
options:
tags:
- Payment
summary: Return payment options for customer
description: Returns all available payment methods and its parameters that can be added to the customer
operationId: getPaymentOptions_1
parameters:
- name: CustomerKey
in: path
description: The key or UUID to resolve a single item
required: true
schema:
type: string
example: ExampleKey
x-item-key: com.intershop.sellside.rest.b2c.capi.resource.customer.PrivateCustomerListResource
responses:
200:
description: OK
content:
application/json:
schema:
$ref: '#/components/schemas/PaymentOptionsRO'
text/xml:
schema:
$ref: '#/components/schemas/PaymentOptionsRO'
401:
description: Unauthorized
security:
- bearerAuth: []
- basicAuth: []
- authToken: []
x-origin-method: public com.intershop.sellside.rest.common.capi.resourceobject.basket.PaymentOptionsRO com.intershop.sellside.rest.common.capi.resource.customer.payment.CustomerPaymentListResource.getPaymentOptions()
x-origin-class: com.intershop.sellside.rest.common.capi.resource.customer.payment.CustomerPaymentListResource
/privatecustomers/{CustomerKey}/payments/{CustomerPaymentKey}:
get:
tags:
- Payment
summary: Get details of a customer profile payment
description: Returns detailed information of a payment method available for a customer
operationId: getPayment_1
parameters:
- name: CustomerKey
in: path
description: The key or UUID to resolve a single item
required: true
schema:
type: string
example: ExampleKey
x-item-key: com.intershop.sellside.rest.b2c.capi.resource.customer.PrivateCustomerListResource
- name: CustomerPaymentKey
in: path
description: The key or UUID to resolve a single item
required: true
schema:
type: string
example: ExampleKey
x-item-key: com.intershop.sellside.rest.common.capi.resource.customer.payment.CustomerPaymentListResource
responses:
200:
description: OK
content:
application/json:
schema:
$ref: '#/components/schemas/PaymentRO'
text/xml:
schema:
$ref: '#/components/schemas/PaymentRO'
401:
description: Unauthorized
404:
description: "Not found\n value for header error-key: \n - payment.instrument.not_found.error\
\ (e.g. unregistred user)"
security:
- bearerAuth: []
- basicAuth: []
- authToken: []
x-origin-method: public com.intershop.sellside.rest.common.capi.resourceobject.basket.PaymentRO com.intershop.sellside.rest.common.capi.resource.customer.payment.CustomerPaymentItemResource.getPayment()
x-origin-class: com.intershop.sellside.rest.common.capi.resource.customer.payment.CustomerPaymentItemResource
put:
tags:
- Payment
summary: 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.
operationId: updatePayment_1
parameters:
- name: CustomerKey
in: path
description: The key or UUID to resolve a single item
required: true
schema:
type: string
example: ExampleKey
x-item-key: com.intershop.sellside.rest.b2c.capi.resource.customer.PrivateCustomerListResource
- name: CustomerPaymentKey
in: path
description: The key or UUID to resolve a single item
required: true
schema:
type: string
example: ExampleKey
x-item-key: com.intershop.sellside.rest.common.capi.resource.customer.payment.CustomerPaymentListResource
requestBody:
content:
application/json:
schema:
$ref: '#/components/schemas/PaymentRO'
text/xml:
schema:
$ref: '#/components/schemas/PaymentRO'
responses:
200:
description: OK
content:
application/json:
schema:
$ref: '#/components/schemas/PaymentRO'
text/xml:
schema:
$ref: '#/components/schemas/PaymentRO'
401:
description: Unauthorized
400:
description: |-
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
security:
- bearerAuth: []
- basicAuth: []
- authToken: []
x-origin-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)
x-origin-class: com.intershop.sellside.rest.common.capi.resource.customer.payment.CustomerPaymentItemResource
delete:
tags:
- Payment
summary: Remove a payment from customer profile
description: Removes a payment method from the customer profile of the logged in customer
operationId: deletePayment_1
parameters:
- name: CustomerKey
in: path
description: The key or UUID to resolve a single item
required: true
schema:
type: string
example: ExampleKey
x-item-key: com.intershop.sellside.rest.b2c.capi.resource.customer.PrivateCustomerListResource
- name: CustomerPaymentKey
in: path
description: The key or UUID to resolve a single item
required: true
schema:
type: string
example: ExampleKey
x-item-key: com.intershop.sellside.rest.common.capi.resource.customer.payment.CustomerPaymentListResource
responses:
200:
description: OK
content:
application/json:
schema:
$ref: '#/components/schemas/LinkRO'
text/xml:
schema:
$ref: '#/components/schemas/LinkRO'
401:
description: Unauthorized
404:
description: Not found
security:
- bearerAuth: []
- basicAuth: []
- authToken: []
x-origin-method: public com.intershop.component.rest.capi.resourceobject.LinkRO com.intershop.sellside.rest.common.capi.resource.customer.payment.CustomerPaymentItemResource.deletePayment()
x-origin-class: com.intershop.sellside.rest.common.capi.resource.customer.payment.CustomerPaymentItemResource
components:
schemas:
LinkRO:
title: Link
type: object
properties:
name:
type: string
description: the name of the returned element
xml:
attribute: true
type:
type: string
description: 'This is a constant: **Link**'
readOnly: true
example: Link
xml:
attribute: true
attributes:
type: array
description: the list of attributes
xml:
wrapped: true
items:
$ref: '#/components/schemas/ResourceAttribute'
uri:
type: string
description: The uri
relation:
type: string
description: The relation of the link
externalDocs:
description: Link Relations (www.iana.org)
url: http://www.iana.org/assignments/link-relations/link-relations.xml
enum:
- about
- alternate
- appendix
- archives
- author
- bookmark
- canonical
- chapter
- collection
- contents
- copyright
- create-form
- current
- describedby
- describes
- disclosure
- duplicate
- edit
- edit-form
- edit-media
- enclosure
- first
- glossary
- help
- hosts
- hub
- icon
- index
- item
- last
- latest-version
- license
- lrdd
- monitor
- monitor-group
- next
- next-archive
- nofollow
- noreferrer
- payment
- predecessor-version
- prefetch
- prev
- preview
- previous
- prev-archive
- privacy-policy
- profile
- related
- replies
- search
- section
- self
- service
- start
- stylesheet
- subsection
- successor-version
- tag
- terms-of-service
- type
- up
- version-history
- via
- working-copy
- working-copy-of
title:
type: string
description: The title of the link
description:
type: string
description: The description of the link
itemId:
type: string
description: the Id of the linked item
attribute:
$ref: '#/components/schemas/ResourceAttribute'
description: A Link pointing to a resource
xml:
name: Link
ResourceAttribute:
title: Attribute
type: object
properties:
name:
type: string
description: The attribute's name
xml:
attribute: true
type:
type: string
description: 'This is a constant: **ResourceAttribute**'
example: ResourceAttribute
xml:
attribute: true
value:
type: object
description: The attribute's value.
description: An attribute
xml:
name: ResourceAttribute
AddressRO:
title: Address
type: object
properties:
name:
type: string
description: The name of an element.
xml:
attribute: true
type:
type: string
description: 'The type of the object. This is normally a **constant** that
can be used to differentiate objects by their type. '
example: Address
xml:
attribute: true
urn:
type: string
description: the URN representation of this address
example: urn:address:customer:1234567890:0987654321
id:
type: string
description: The ID of the returned element
example: vagKAB17gg4AAAFGSkFqQASI
addressName:
type: string
description: The name of the address
example: customeraddr-ABCDEFGPRMuMCscyXgSRVU
title:
type: string
description: The (personal) title of the contact person, like 'Mr.' or 'Ms.'
example: Mrs.
aristocraticTitle:
type: string
description: the aristocratic title of the contact person, like Lord or Lady
jobTitle:
type: string
description: the job title of the contact person
example: CEO
honorific:
type: string
description: 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:
type: string
description: The (first) given name of the contact person
example: Patricia
secondName:
type: string
description: the second given name of the contact person
example: Luise
lastName:
type: string
description: The last name of the contact person
example: Miller
secondLastName:
type: string
description: the second last name of the contact person
companyName1:
type: string
description: the company name
example: PMiller ltd.
companyName2:
type: string
description: The second company name
addressLine1:
type: string
description: the first address line
example: Berliner Str. 20
addressLine2:
type: string
description: the second address line
example: 1st Floor
addressLine3:
type: string
description: The third address line
example: Second door on the right
postBox:
type: string
description: the post-office box
example: PO Box 42
mainDivision:
type: string
description: the main division of the country, e. g. a state or province
example: AL
mainDivisionName:
type: string
description: The localized display name of the main division
example: Alabama
subDivision:
type: string
description: The sub division code of the country.
example: GB-PKN
subDivisionName:
type: string
description: The localized display name of the sub division
example: Perth and Kinross
postalCode:
type: string
description: The postal code
example: "14482"
email:
type: string
description: the e-mail address of the contact person
example: pmiller@intershop.de
phoneMobile:
type: string
description: The number of the contact person's cell phone
example: +49364112677
phoneHome:
type: string
description: The phone number of the house or apartment where the contact person lives
example: "049364112677"
phoneBusiness:
type: string
description: The phone number of the contact person's company
example: "049364112699"
phoneBusinessDirect:
type: string
description: 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:
type: string
description: The display name of the country in the current locale
example: Germany
countryCode:
type: string
description: The country code
example: DE
city:
type: string
description: The name of the city
example: Potsdam
fax:
type: string
description: the fax number
example: "049364112643"
usage:
type: object
properties:
empty:
type: boolean
description: ' 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'
description: This resource holds the details of an address.
xml:
name: Address
CredentialsRO:
type: object
properties:
name:
type: string
description: The name of an element.
xml:
attribute: true
type:
type: string
description: 'The type of the object. This is normally a **constant** that
can be used to differentiate objects by their type. '
readOnly: true
xml:
attribute: true
login:
type: string
description: the login
example: pmiller@test.intershop.de
password:
type: string
description: the password
example: '!InterShop00!'
securityQuestion:
type: string
description: the security question
example: what was the name of your first pet?
securityQuestionAnswer:
type: string
description: the security questions answer
example: Snoopy
xml:
name: Credentials
GenericPropertyROObject:
type: object
properties:
name:
type: string
description: The name of an element.
xml:
attribute: true
type:
type: string
description: 'The type of the object. This is normally a **constant** that
can be used to differentiate objects by their type. '
readOnly: true
xml:
attribute: true
key:
type: string
property:
type: object
displayName:
type: string
xml:
name: Property
MoneyRO:
title: Money
type: object
properties:
name:
type: string
description: The name of an element.
writeOnly: true
type:
type: string
description: 'This is a constant: **Money**'
readOnly: true
example: Money
xml:
attribute: true
value:
type: number
description: The monetary value.
example: 10.99
currencyMnemonic:
type: string
deprecated: true
currency:
type: string
description: Three-letter currency code (ISO 4217) of the monetary value.
example: USD
description: Money combines a currency and a money amount.
readOnly: true
xml:
name: Money
NewCustomerRO:
type: object
properties:
address:
$ref: '#/components/schemas/AddressRO'
birthday:
type: string
description: the birthday of the customer
nullable: true
example: 1970-03-10
credentials:
$ref: '#/components/schemas/CredentialsRO'
customerNo:
type: string
customerType:
type: string
description: the type of the customer
readOnly: true
example: PRIVATE
email:
type: string
description: the email address of the customer
nullable: true
example: patrik@test.intershop.net
fax:
type: string
description: the fax number of the customer
nullable: true
example: "4211324"
firstName:
type: string
description: the first name of the customer
nullable: true
example: Patrik
lastName:
type: string
description: the last name of the customer
nullable: true
example: Mueller
login:
type: string
description: the login(username) of the customer
nullable: true
example: patrik_83
name:
type: string
description: The name of an element.
xml:
attribute: true
phoneBusiness:
type: string
description: the business phone number of the customer
nullable: true
example: "4211324"
phoneHome:
type: string
description: the phone home number of the customer
nullable: true
example: "4211324"
phoneMobile:
type: string
description: the mobile phone number of the customer
nullable: true
example: "4211324"
preferredInvoiceToAddress:
$ref: '#/components/schemas/AddressRO'
preferredLanguage:
type: string
description: the preferred language of the customer
nullable: true
example: de_DE
preferredPaymentInstrument:
$ref: '#/components/schemas/PaymentRO'
preferredShipToAddress:
$ref: '#/components/schemas/AddressRO'
title:
type: string
description: the title of the customer
nullable: true
example: Mr
type:
type: string
description: 'The type of the object. This is normally a **constant** that
can be used to differentiate objects by their type. '
example: PrivateCustomer
xml:
attribute: true
userId:
type: string
description: the id of the user this customer is based on. If not set, credentials and user data are mandatory.
nullable: true
xml:
name: NewCustomer
PaymentRO:
type: object
properties:
name:
type: string
description: The name of an element.
xml:
attribute: true
type:
type: string
description: 'The type of the object. This is normally a **constant** that
can be used to differentiate objects by their type. '
example: Payment
xml:
attribute: true
attributes:
type: array
description: the list of attributes
xml:
wrapped: true
items:
$ref: '#/components/schemas/ResourceAttribute'
id:
type: string
limitedTenderBalance:
$ref: '#/components/schemas/MoneyRO'
paymentTotalAmount:
$ref: '#/components/schemas/MoneyRO'
accountIdentifier:
type: string
description: the optional account identifier for this payment instrument
readOnly: true
example: DE12****7890
parameters:
type: array
xml:
wrapped: true
items:
$ref: '#/components/schemas/GenericPropertyROObject'
attribute:
$ref: '#/components/schemas/ResourceAttribute'
xml:
name: Payment
SMBCustomerUserRO:
type: object
properties:
type:
type: string
description: 'The type of the object. This is normally a **constant** that
can be used to differentiate objects by their type. '
example: SMBCustomerUser
xml:
attribute: true
name:
type: string
description: The name of an element.
example: SMBCustomerUser
xml:
attribute: true
login:
type: string
description: The login to be used for that user.
example: pmerkel@test.intershop.de
firstName:
type: string
description: The given name (also known as a personal name, first name, forename) of the person represented by this user.
example: Peter
lastName:
type: string
description: The surname (also known as a family name, last name) of the person represented by this user.
example: Merkel
businessPartnerNo:
type: string
description: ID uniquely identifying the user in the context of the customer.
example: PMerkel
preferredLanguage:
type: string
description: the preffered language of the user
example: de_DE
phoneBusiness:
type: string
description: the business phone number of the user
example: "4211324"
phoneMobile:
type: string
description: the mobile phone number of the user
example: "4211324"
department:
type: string
description: the department of the user
example: Sales
title:
type: string
description: The personal title, like Ms., Mr.
example: Mr.
birthday:
type: string
description: Date of birth of the person represented by this user in format MM/dd/yyyy
nullable: true
example: 12/24/1998
preferredPaymentInstrument:
$ref: '#/components/schemas/PaymentRO'
phoneHome:
type: string
description: the phone home number of the user
example: "4211324"
fax:
type: string
description: the fax number of the user
example: "4211324"
email:
type: string
description: the email of the user
example: pmerkel@test.intershop.de
active:
type: boolean
description: the user is active or not
example: true
preferredInvoiceToAddressUrn:
type: string
description: The URN representation of the preferred invoice address for the user in the format urn:address:customer:addressID:customerID
nullable: true
preferredShipToAddressUrn:
type: string
description: The URN representation of the preferred shipping address for the user in the format urn:address:customer:addressID:customerID
nullable: true
xml:
name: SMBCustomerUser
SMBCustomerRO:
type: object
properties:
companyName:
type: string
description: the company name of the customer
example: AgroNet
companyName2:
type: string
customerNo:
type: string
customerType:
type: string
description: the type of the customer
readOnly: true
example: PRIVATE
description:
type: string
description: the description of the customer
example: AgroNet description
industry:
type: string
description: the industry of the customer
example: agrar industry
name:
type: string
description: The name of an element.
xml:
attribute: true
preferredInvoiceToAddress:
$ref: '#/components/schemas/AddressRO'
preferredShipToAddress:
$ref: '#/components/schemas/AddressRO'
taxationID:
type: string
description: the taxation ID of the customer
example: "123456"
type:
type: string
description: 'The type of the object. This is normally a **constant** that
can be used to differentiate objects by their type. '
example: SMBCustomer
xml:
attribute: true
xml:
name: SMBCustomer
AbstractResourceObject:
title: Object
type: object
properties:
name:
type: string
description: The name of an element.
xml:
attribute: true
type:
type: string
description: 'The type of the object. This is normally a **constant** that
can be used to differentiate objects by their type. '
readOnly: true
xml:
attribute: true
description: the list of elements
ResourceCollectionRO:
type: object
properties:
pageable:
type: string
description: The pageable ID
total:
type: integer
description: The pageable amount total
format: int32
offset:
type: integer
description: The pageable offset
format: int32
amount:
type: integer
description: The pageable amount
format: int32
elements:
type: array
description: The list of elements
xml:
wrapped: true
items:
$ref: '#/components/schemas/AbstractResourceObject'
type:
type: string
description: 'The type of the object. This is normally a **constant** that
can be used to differentiate objects by their type. '
xml:
attribute: true
sortKeys:
uniqueItems: true
type: array
description: The keys to sort for
xml:
wrapped: true
items:
type: string
description: the keys to sort for
xml:
name: sortKey
name:
type: string
description: The name of an element.
xml:
attribute: true
description: A list of ResourceObjects
xml:
name: ResourceCollection
ResourceCollectionROLinkRO:
title: Link List
type: object
properties:
pageable:
type: string
description: the pageable ID
total:
type: integer
description: the pageable amount total
format: int32
offset:
type: integer
description: the pageable offset
format: int32
amount:
type: integer
description: the pageable amount
format: int32
elements:
type: array
description: the list of elements
xml:
wrapped: true
items:
$ref: '#/components/schemas/LinkRO'
type:
type: string
description: 'This is a constant: **ResourceCollection**'
example: ResourceCollection
xml:
attribute: true
sortKeys:
uniqueItems: true
type: array
description: the keys to sort for
xml:
wrapped: true
items:
type: string
description: the keys to sort for
xml:
name: sortKey
name:
type: string
description: the name of the returned element
xml:
attribute: true
description: A list of links
xml:
name: ResourceCollection
PaymentOptionRO:
type: object
properties:
name:
type: string
description: The name of an element.
xml:
attribute: true
type:
type: string
description: 'The type of the object. This is normally a **constant** that
can be used to differentiate objects by their type. '
example: PaymentOption
xml:
attribute: true
id:
type: string
description: the id of the payment option
example: ISH_INVOICE
displayName:
type: string
description: the display name of the payment option
example: Invoice
applicability:
type: string
restrictions:
type: array
xml:
wrapped: true
items:
type: string
xml:
name: restriction
paymentParameters:
type: array
description: the parameters for this payment option
xml:
name: parameters
wrapped: true
items:
$ref: '#/components/schemas/GenericPropertyROObject'
description: the payments
xml:
name: PaymentOption
PaymentOptionsForMethodRO:
type: object
properties:
name:
type: string
description: The name of an element.
xml:
attribute: true
type:
type: string
description: 'The type of the object. This is normally a **constant** that
can be used to differentiate objects by their type. '
example: PaymentOptionsForMethodRO
xml:
attribute: true
payments:
type: array
description: the payments
items:
$ref: '#/components/schemas/PaymentOptionRO'
method:
type: string
description: the http method to use when adding this method
example: POST
description: payment methods that can be added via http
xml:
name: PaymentOptionsForMethodRO
PaymentOptionsRO:
type: object
properties:
name:
type: string
description: The name of an element.
xml:
attribute: true
type:
type: string
description: 'The type of the object. This is normally a **constant** that
can be used to differentiate objects by their type. '
example: PaymentOptions
xml:
attribute: true
methods:
type: array
description: payment methods that can be added via http
items:
$ref: '#/components/schemas/PaymentOptionsForMethodRO'
xml:
name: PaymentOptions
CostCenterUserRO:
title: CostCenterUser
type: object
properties:
approvedOrders:
type: integer
description: The approved orders of the cost center buyer
format: int32
example: 8
budget:
$ref: '#/components/schemas/MoneyRO_v1'
budgetPeriod:
type: string
description: The budget period of the cost center buyer
example: monthly
buyerDetails:
$ref: '#/components/schemas/LinkRO'
email:
type: string
description: The e-mail address of the person represented by this user
example: merkel@test.intershop.de
firstName:
type: string
description: The given name (also known as a personal name, first name, forename) of the person represented by this user
example: Peter
lastName:
type: string
description: The surname (also known as a family name, last name) of the person represented by this user
example: Merkel
login:
type: string
description: The login of the person represented by this user
example: merkel@test.intershop.de
pendingOrders:
type: integer
description: The pending orders of the cost center buyer
format: int32
example: 2
remainingBudget:
$ref: '#/components/schemas/MoneyRO_v1'
spentBudget:
$ref: '#/components/schemas/MoneyRO_v1'
title:
type: string
description: The personal title, like Ms., Mr.
example: Mr.
description: This resource holds information about a cost center user.
MoneyRO_v1:
type: object
properties:
currency:
type: string
description: Three-letter currency code (ISO 4217) of the monetary value.
example: USD
value:
type: number
description: The monetary value.
example: 10.99
description: Describes a money object.
NewCostCenterRO:
title: NewCostCenter
type: object
properties:
name:
type: string
description: The name of the cost center
example: my cost center
xml:
attribute: true
type:
type: string
description: 'The type of the object. This is normally a **constant** that
can be used to differentiate objects by their type. '
example: NewCostCenter
xml:
attribute: true
budget:
$ref: '#/components/schemas/MoneyRO_v1'
budgetPeriod:
type: string
description: The budget period of the cost center
example: monthly
costCenterId:
type: string
description: The unique cost center ID assigned by the customer
example: "007"
costCenterOwner:
$ref: '#/components/schemas/CostCenterUserRO'
id:
type: string
description: The unique cost center ID assigned by the system
example: q2QKAEsBiyQAAAFjXFBB6G14
description: This resource holds information on a new cost center.
CostCenterRO:
title: CostCenter
type: object
properties:
name:
type: string
description: The name of the cost center
example: my cost center
xml:
attribute: true
type:
type: string
description: 'The type of the object. This is normally a **constant** that
can be used to differentiate objects by their type. '
example: CostCenter
xml:
attribute: true
approvedOrders:
type: integer
description: The approved orders of the cost center
format: int32
example: 2
active:
type: boolean
description: Indicates whether the cost center is active
example: true
budget:
$ref: '#/components/schemas/MoneyRO_v1'
budgetPeriod:
type: string
description: The budget period of the cost center
example: monthly
buyers:
type: array
description: The cost center buyers
items:
$ref: '#/components/schemas/CostCenterUserRO'
costCenterId:
type: string
description: The unique cost center ID assigned by the customer
example: "007"
costCenterOwner:
$ref: '#/components/schemas/CostCenterUserRO'
id:
type: string
description: The unique cost center ID assigned by the system
example: q2QKAEsBiyQAAAFjXFBB6G14
orders:
type: array
description: The orders of the cost center
items:
$ref: '#/components/schemas/OrderRO'
pendingOrders:
type: integer
description: The amount of pending orders of the cost center
format: int32
example: 2
remainingBudget:
$ref: '#/components/schemas/MoneyRO_v1'
spentBudget:
$ref: '#/components/schemas/MoneyRO_v1'
description: This resource holds information on a given cost center.
OrderRO:
title: Order
type: object
properties:
name:
type: string
description: The name of an element.
xml:
attribute: true
type:
type: string
description: 'The type of the object. This is normally a **constant** that
can be used to differentiate objects by their type. '
example: Order
xml:
attribute: true
buyer:
$ref: '#/components/schemas/LinkRO'
items:
type: number
description: The order count
example: 23
order:
$ref: '#/components/schemas/LinkRO'
orderDate:
type: array
description: The order date
example:
- "2020"
- "5"
- "27"
items:
type: integer
format: int32
orderNo:
type: string
description: The order no
example: "001"
orderStatus:
type: string
description: The order status
example: new
orderTotalGross:
$ref: '#/components/schemas/MoneyRO_v1'
orderTotalNet:
$ref: '#/components/schemas/MoneyRO_v1'
description: This resource holds information on an order of a cost center.
UpdateCostCenterRO:
title: UpdateCostCenter
type: object
properties:
name:
type: string
description: The name of the cost center
example: my cost center
xml:
attribute: true
type:
type: string
description: 'The type of the object. This is normally a **constant** that
can be used to differentiate objects by their type. '
example: UpdateCostCenter
xml:
attribute: true
active:
type: boolean
description: Indicates whether the cost center is active
example: true
budget:
$ref: '#/components/schemas/MoneyRO_v1'
budgetPeriod:
type: string
description: The budget period of the cost center
example: monthly
costCenterId:
type: string
description: The cost center ID of the cost center
example: "007"
costCenterOwner:
$ref: '#/components/schemas/CostCenterUserRO'
id:
type: string
description: The ID of the cost center
example: q2QKAEsBiyQAAAFjXFBB6G14
description: This rersource holds updated information on a cost center.
NewCostCenterBuyerRO:
title: NewCostCenterBuyer
type: object
properties:
budget:
$ref: '#/components/schemas/MoneyRO_v1'
budgetPeriod:
type: string
description: The budget period of the cost center buyer
example: monthly
login:
type: string
description: The login of the buyer
example: abc@login.de
description: This resource holds information on a new cost center buyer.
UpdateCostCenterBuyerRO:
title: UpdateCostCenterBuyer
type: object
properties:
budget:
$ref: '#/components/schemas/MoneyRO_v1'
budgetPeriod:
type: string
description: The budget period of the cost center buyer
example: monthly
description: This resource holds updated information on a cost center buyer.
UserLinkRO:
type: object
properties:
type:
type: string
description: 'The type of the object. This is normally a **constant** that
can be used to differentiate objects by their type. '
example: Link
xml:
attribute: true
name:
type: string
description: The name of an element.
example: Peter Merkel
xml:
attribute: true
login:
type: string
description: The login of the user
example: pmerkel@test.intershop.de
uri:
type: string
description: the uri to the user item resource
example: Organization-Channel-Site/-/customers/-/users/pmerkel@test.intershop.de
attributes:
type: array
description: the list of attributes
xml:
wrapped: true
items:
$ref: '#/components/schemas/ResourceAttribute'
attribute:
$ref: '#/components/schemas/ResourceAttribute'
description: A Link to registered User Item Resource
xml:
name: Link
UserLinkROCollection:
type: object
properties:
type:
type: string
description: 'The type of the object. This is normally a **constant** that
can be used to differentiate objects by their type. '
example: UserLinkCollection
xml:
attribute: true
name:
type: string
description: The name of an element.
example: users
xml:
attribute: true
amount:
type: integer
description: The pageable amount
format: int32
elements:
type: array
description: The list of elements
xml:
wrapped: true
items:
$ref: '#/components/schemas/UserLinkRO'
pageable:
type: string
description: The pageable ID
total:
type: integer
description: The pageable amount total
format: int32
offset:
type: integer
description: The pageable offset
format: int32
limit:
type: integer
description: the maximum count of users to return
format: int32
filter:
type: string
description: the defined filter criteria for returned users
sortKeys:
uniqueItems: true
type: array
description: The keys to sort for
xml:
wrapped: true
items:
type: string
description: the keys to sort for
xml:
name: sortKey
description: A collection of users with link to user item resource
xml:
name: ResourceCollection
SMBCustomerUserROCollection:
type: object
properties:
type:
type: string
description: 'The type of the object. This is normally a **constant** that
can be used to differentiate objects by their type. '
example: SMBCustomerUserCollection
xml:
attribute: true
name:
type: string
description: The name of an element.
example: Users
xml:
attribute: true
elements:
type: array
description: The list of elements
xml:
name: SMBCustomerUser
items:
$ref: '#/components/schemas/SMBCustomerUserRO'
description: A resource object containing the data for one or more users of given SMB Customer
xml:
name: SMBCustomerUserCollection
LinkROResourceCollectionRO:
type: object
properties:
pageable:
type: string
description: The pageable ID
total:
type: integer
description: The pageable amount total
format: int32
offset:
type: integer
description: The pageable offset
format: int32
amount:
type: integer
description: The pageable amount
format: int32
elements:
type: array
description: The list of elements
xml:
wrapped: true
items:
$ref: '#/components/schemas/LinkRO'
type:
type: string
description: 'The type of the object. This is normally a **constant** that
can be used to differentiate objects by their type. '
xml:
attribute: true
sortKeys:
uniqueItems: true
type: array
description: The keys to sort for
xml:
wrapped: true
items:
type: string
description: the keys to sort for
xml:
name: sortKey
name:
type: string
description: The name of an element.
xml:
attribute: true
description: This resource holds a list of Link-ResourceObjects.
xml:
name: ResourceCollection
GiftCardAndCertificateRO:
title: GiftCardAndCertificate
type: object
properties:
name:
type: string
description: The name of an element.
xml:
attribute: true
type:
type: string
description: 'The type of the object. This is normally a **constant** that
can be used to differentiate objects by their type. '
example: GiftCardAndCertificate
xml:
attribute: true
currency:
type: string
description: The currency of the gift card
example: USD
amount:
type: number
description: The value of the gift card
example: 25
amountRemaining:
type: number
description: The remaining value of the gift card
example: 12.73
description: This resource holds information on a gift card or a gift certificate.
xml:
name: GiftCardAndCertificate
UserCostCenterLinkRO:
title: UserCostCenterLink
type: object
properties:
name:
type: string
description: The name of the cost center
example: Agro Net Central
xml:
attribute: true
type:
type: string
description: 'The type of the object. This is normally a **constant** that
can be used to differentiate objects by their type. '
example: UserCostCenterLink
xml:
attribute: true
id:
type: string
description: The ID of the cost center
example: "511288"
roles:
type: array
description: The roles assigned to the user
example:
- Approver
- Buyer
items:
type: string
link:
$ref: '#/components/schemas/LinkRO'
description: This resource holds a list of all cost centers assigned to the user.
xml:
name: UserCostCenterLink
UserCostCenterLinkROCollection:
type: object
properties:
pageable:
type: string
description: The pageable ID
total:
type: integer
description: The pageable amount total
format: int32
offset:
type: integer
description: The pageable offset
format: int32
amount:
type: integer
description: The pageable amount
format: int32
elements:
type: array
description: The list of elements
xml:
wrapped: true
items:
$ref: '#/components/schemas/UserCostCenterLinkRO'
type:
type: string
description: 'The type of the object. This is normally a **constant** that
can be used to differentiate objects by their type. '
example: UserCostCenterLinkROCollection
xml:
attribute: true
sortKeys:
uniqueItems: true
type: array
description: The keys to sort for
xml:
wrapped: true
items:
type: string
description: the keys to sort for
xml:
name: sortKey
name:
type: string
description: The name of an element.
xml:
attribute: true
xml:
name: UserCostCenterLinkROCollection
UserCostCenterRO:
title: UserCostCenter
type: object
properties:
name:
type: string
description: The name of the cost center
example: Agro Net Central
xml:
attribute: true
type:
type: string
description: 'The type of the object. This is normally a **constant** that
can be used to differentiate objects by their type. '
example: UserCostCenter
xml:
attribute: true
id:
type: string
description: The ID of the cost center
example: "511288"
roles:
type: array
description: The roles assigned to the user
example:
- Approver
- Buyer
items:
type: string
description: This resource holds information about the assigned cost center.
xml:
name: UserCostCenter
PrivateCustomerRO:
type: object
properties:
birthday:
type: string
description: the birthday of the customer
nullable: true
example: 1970-03-10
customerNo:
type: string
customerType:
type: string
description: the type of the customer
readOnly: true
example: PRIVATE
email:
type: string
description: the email address of the customer
nullable: true
example: patrik@test.intershop.net
fax:
type: string
description: the fax number of the customer
nullable: true
example: "4211324"
firstName:
type: string
description: the first name of the customer
nullable: true
example: Patrik
lastName:
type: string
description: the last name of the customer
nullable: true
example: Mueller
login:
type: string
description: the login(username) of the customer
nullable: true
example: patrik_83
name:
type: string
description: The name of an element.
xml:
attribute: true
phoneBusiness:
type: string
description: the business phone number of the customer
nullable: true
example: "4211324"
phoneHome:
type: string
description: the phone home number of the customer
nullable: true
example: "4211324"
phoneMobile:
type: string
description: the mobile phone number of the customer
nullable: true
example: "4211324"
preferredInvoiceToAddress:
$ref: '#/components/schemas/AddressRO'
preferredLanguage:
type: string
description: the preferred language of the customer
nullable: true
example: de_DE
preferredPaymentInstrument:
$ref: '#/components/schemas/PaymentRO'
preferredShipToAddress:
$ref: '#/components/schemas/AddressRO'
title:
type: string
description: the title of the customer
nullable: true
example: Mr
type:
type: string
description: 'The type of the object. This is normally a **constant** that
can be used to differentiate objects by their type. '
example: PrivateCustomer
xml:
attribute: true
xml:
name: PrivateCustomer
responses:
200:
description: OK
201:
description: Created
202:
description: Accepted
204:
description: No Content
205:
description: Reset Content
206:
description: Partial Content
301:
description: Moved Permanently
302:
description: Found
303:
description: See Other
304:
description: Not Modified
305:
description: Use Proxy
307:
description: Temporary Redirect
400:
description: Bad Request
401:
description: Unauthorized
402:
description: Payment Required
403:
description: Forbidden
404:
description: Not Found
405:
description: Method Not Allowed
406:
description: Not Acceptable
407:
description: Proxy Authentication Required
408:
description: Request Timeout
409:
description: Conflict
410:
description: Gone
411:
description: Length Required
412:
description: Precondition Failed
413:
description: Request Entity Too Large
414:
description: Request-URI Too Long
415:
description: Unsupported Media Type
416:
description: Requested Range Not Satisfiable
417:
description: Expectation Failed
500:
description: Internal Server Error
501:
description: Not Implemented
502:
description: Bad Gateway
503:
description: Service Unavailable
504:
description: Gateway Timeout
505:
description: HTTP Version Not Supported
parameters:
loc:
name: loc
in: path
description: The locale ID (submitted as optional matrix parameter ```;loc=```). If omitted, the site's or user's default locale is used.
required: false
style: matrix
schema:
type: string
description: The locale ID (submitted as optional matrix parameter ```;loc=```). If omitted, the site's or user's default locale is used.
default: en_US
examples:
en_US:
description: English (United States)
value: en_US
fr_FR:
description: French (France)
value: fr_FR
de_DE:
description: German (Germany)
value: de_DE
x-matrixParamPath: /
cur:
name: cur
in: path
description: The currency code (submitted as optional matrix parameter ```;cur=```). If omitted, the site's or user's default currency is used.
required: false
style: matrix
schema:
type: string
description: The currency code (submitted as optional matrix parameter ```;cur=```). If omitted, the site's or user's default currency is used.
default: USD
examples:
FJD:
description: Fiji Dollar
value: FJD
STD:
description: São Tomé / Príncipe Dobra
value: STD
MXN:
description: Mexican Peso
value: MXN
SCR:
description: Seychelles Rupee
value: SCR
LVL:
description: Latvian Lats
value: LVL
CDF:
description: Congolese Franc
value: CDF
GTQ:
description: Guatemalan Quetzal
value: GTQ
BBD:
description: Barbados Dollar
value: BBD
CLP:
description: Chilean Peso
value: CLP
UGX:
description: Ugandan Shilling
value: UGX
HNL:
description: Honduran Lempira
value: HNL
ZAR:
description: South African Rand
value: ZAR
TND:
description: Tunisian Dinar
value: TND
SLL:
description: Sierra Leonean Leone
value: SLL
BSD:
description: Bahamian Dollar
value: BSD
SDG:
description: Sudanese Pound
value: SDG
IQD:
description: Iraqi Dinar
value: IQD
GMD:
description: Gambian Dalasi
value: GMD
CUP:
description: Cuban Peso
value: CUP
TWD:
description: New Taiwan Dollar
value: TWD
RSD:
description: Serbian Dinar
value: RSD
ZRZ:
description: Zaire
value: ZRZ
DOP:
description: Dominican Peso
value: DOP
KMF:
description: Comoro Franc
value: KMF
MYR:
description: Malaysian Ringgit
value: MYR
FKP:
description: Falkland Islands Pound
value: FKP
XOF:
description: CFA Franc BCEAO
value: XOF
GEL:
description: Lari
value: GEL
UYU:
description: Uruguayan Peso
value: UYU
MAD:
description: Moroccan Dirham
value: MAD
CVE:
description: Cape Verde Escudo
value: CVE
TOP:
description: Tongan Pa'anga
value: TOP
PGK:
description: Papua New Guinean Kina
value: PGK
OMR:
description: Omani Rial
value: OMR
AZN:
description: Azerbaijanian Manat
value: AZN
SEK:
description: Swedish Krona
value: SEK
KES:
description: Kenyan Shilling
value: KES
UAH:
description: Ukrainian Hryvnia
value: UAH
BTN:
description: Ngultrum
value: BTN
GNF:
description: Guinea Franc
value: GNF
MZN:
description: Mozambican Metical
value: MZN
ERN:
description: Nakfa
value: ERN
SVC:
description: Salvadoran Colón
value: SVC
ARS:
description: Argentine Peso
value: ARS
QAR:
description: Qatari Riyal
value: QAR
NLG:
description: Dutch Guilder
value: NLG
IRR:
description: Iranian Rial
value: IRR
MRO:
description: Mauritanian Ouguiya
value: MRO
XPF:
description: CFP Franc
value: XPF
UZS:
description: Uzbekistani Som
value: UZS
THB:
description: Thai Baht
value: THB
CNY:
description: Yuan Renminbi
value: CNY
BDT:
description: Bangladeshi Taka
value: BDT
LYD:
description: Libyan Dinar
value: LYD
BMD:
description: Bermudian Dollar
value: BMD
PHP:
description: Philippine Peso
value: PHP
KWD:
description: Kuwaiti Dinar
value: KWD
RUB:
description: Russian Ruble
value: RUB
PYG:
description: Paraguayan Guarani
value: PYG
JMD:
description: Jamaican Dollar
value: JMD
ISK:
description: Iceland Krona
value: ISK
GWP:
description: Guinea Peso
value: GWP
BEF:
description: Belgian Franc
value: BEF
ESP:
description: Spanish Peseta
value: ESP
COP:
description: Colombian Peso
value: COP
USD:
description: US Dollar
value: USD
MKD:
description: Denar
value: MKD
DZD:
description: Algerian Dinar
value: DZD
PAB:
description: Panamanian Balboa
value: PAB
SGD:
description: Singapore Dollar
value: SGD
ETB:
description: Ethiopian Birr
value: ETB
VUV:
description: Vanuatu Vatu
value: VUV
VEF:
description: Venezuelan Bolivar Fuerte
value: VEF
SOS:
description: Somali Shilling
value: SOS
KGS:
description: Som
value: KGS
LAK:
description: Lao Kip
value: LAK
ZMK:
description: Zambian Kwacha
value: ZMK
BND:
description: Brunei Dollar
value: BND
XAF:
description: CFA Franc BEAC
value: XAF
LRD:
description: Liberian Dollar
value: LRD
ITL:
description: Italian Lira
value: ITL
HRK:
description: Croatian Kuna
value: HRK
CHF:
description: Swiss Franc
value: CHF
ATS:
description: Austrian Schilling
value: ATS
DJF:
description: Djibouti Franc
value: DJF
ALL:
description: Albanian Lek
value: ALL
MTL:
description: Maltese Lira
value: MTL
TZS:
description: Tanzanian Shilling
value: TZS
VND:
description: Vietnamese Dong
value: VND
AUD:
description: Australian Dollar
value: AUD
ILS:
description: New Israeli Sheqel
value: ILS
KPW:
description: North Korean Won
value: KPW
GYD:
description: Guyanese Dollar
value: GYD
GHS:
description: Ghanaian Cedi
value: GHS
MDL:
description: Moldovan Leu
value: MDL
KHR:
description: Cambodian Riel
value: KHR
BOB:
description: Boliviano
value: BOB
IDR:
description: Indonesian Rupiah
value: IDR
KYD:
description: Cayman Islands Dollar
value: KYD
AMD:
description: Armenian Dram
value: AMD
TRY:
description: Turkish Lira
value: TRY
SHP:
description: Saint Helena Pound
value: SHP
BWP:
description: Botswana Pula
value: BWP
LBP:
description: Lebanese Pound
value: LBP
CYP:
description: Cyprus Pound
value: CYP
TJS:
description: Tajikistani Somoni
value: TJS
JOD:
description: Jordanian Dinar
value: JOD
RWF:
description: Rwanda Franc
value: RWF
HKD:
description: Hong Kong Dollar
value: HKD
AED:
description: United Arab Emirates Dirham
value: AED
EUR:
description: Euro
value: EUR
LSL:
description: Lesotho Loti
value: LSL
DKK:
description: Danish Krone
value: DKK
CAD:
description: Canadian Dollar
value: CAD
BGN:
description: Bulgarian Lev
value: BGN
MMK:
description: Kyat
value: MMK
EEK:
description: Estonian Kroon
value: EEK
SYP:
description: Syrian Pound
value: SYP
NOK:
description: Norwegian Krone
value: NOK
MUR:
description: Mauritian Rupee
value: MUR
ZWL:
description: Zimbabwean Dollar
value: ZWL
GIP:
description: Gibraltar Pound
value: GIP
RON:
description: Romanian New Leu
value: RON
LKR:
description: Sri Lankan Rupee
value: LKR
NGN:
description: Nigerian Naira
value: NGN
IEP:
description: Irish Pound
value: IEP
CZK:
description: Czech Koruna
value: CZK
CRC:
description: Costa Rican Colon
value: CRC
PKR:
description: Pakistani Rupee
value: PKR
XCD:
description: East Carribean Dollar
value: XCD
GRD:
description: Greek Drachma
value: GRD
HTG:
description: Haitian Gourde
value: HTG
ANG:
description: Netherlands Antillian Guilder
value: ANG
SIT:
description: Slovenian Tolar
value: SIT
BHD:
description: Bahraini Dinar
value: BHD
PTE:
description: Portuguese Escudo
value: PTE
BPP:
description: Bonus Point Price
value: BPP
SZL:
description: Swazi Lilangeni
value: SZL
SRD:
description: Surinam Dollar
value: SRD
KZT:
description: Kazakhstani Tenge
value: KZT
TTD:
description: Trinidad and Tobago Dollar
value: TTD
SAR:
description: Saudi Riyal
value: SAR
LTL:
description: Lithuanian Litas
value: LTL
YER:
description: Yemeni Rial
value: YER
MVR:
description: Maldivian Rufiyaa
value: MVR
BPV:
description: Bonus Point Value
value: BPV
AFN:
description: Afghani
value: AFN
INR:
description: Indian Rupee
value: INR
NPR:
description: Nepalese Rupee
value: NPR
KRW:
description: South Korean Won
value: KRW
AWG:
description: Aruban Florin
value: AWG
MNT:
description: Mongolian Tugrik
value: MNT
JPY:
description: Japanese Yen
value: JPY
PLN:
description: Polish Złoty
value: PLN
AOA:
description: Angolan Kwanza
value: AOA
SBD:
description: Solomon Islands Dollar
value: SBD
GBP:
description: Pound Sterling
value: GBP
HUF:
description: Hungarian Forint
value: HUF
BYR:
description: Belarussian Ruble
value: BYR
LUF:
description: Luxembourgian Franc
value: LUF
BIF:
description: Burundi Franc
value: BIF
MWK:
description: Malawian Kwacha
value: MWK
MGA:
description: Malagasy Ariary
value: MGA
FIM:
description: Finnish Mark
value: FIM
DEM:
description: Deutsche Mark
value: DEM
BZD:
description: Belize Dollar
value: BZD
BAM:
description: Convertible Marks
value: BAM
MOP:
description: Macanese Pataca
value: MOP
EGP:
description: Egyptian Pound
value: EGP
NAD:
description: Namibian Dollar
value: NAD
SKK:
description: Slovakian Krona
value: SKK
NIO:
description: Cordoba Oro
value: NIO
PEN:
description: Peruvian Nuevo Sol
value: PEN
WST:
description: Samoan Tala
value: WST
NZD:
description: New Zealand Dollar
value: NZD
TMT:
description: Turkmenistani Manat
value: TMT
FRF:
description: French Franc
value: FRF
BRL:
description: Brazilian Real
value: BRL
x-matrixParamPath: /
regionals:
name: regionals
in: path
required: false
style: matrix
schema:
type: object
properties:
loc:
type: string
description: The locale ID
example: en_US
cur:
type: string
description: The currency code
example: EUR
x-matrixParamPath: /
pgid:
name: pgid
in: path
description: The personal group identifier (submitted as matrix parameter ```;pgid=```).
required: false
style: matrix
schema:
type: string
description: The personal group identifier (submitted as matrix parameter ```;pgid=```).
example: FUOGrzQ_VjORpGaN8DRGmLLE0000
example: FUOGrzQ_VjORpGaN8DRGmLLE0000
spgid:
name: spgid
in: path
description: The secure personal group identifier (submitted as matrix parameter ```;spgid=```).
required: false
style: matrix
schema:
type: string
description: The secure personal group identifier (submitted as matrix parameter ```;spgid=```).
example: FUOGrzQ_VjORpGaN8DRGmLLE0000
example: FUOGrzQ_VjORpGaN8DRGmLLE0000
securitySchemes:
basicAuth:
type: http
description: 'Basic access authentication. In basic authentication, a request
contains a header field in the form of authorization: ```Basic ```, where
credentials is the Base64 encoding of ID and password joined by a single colon
:.'
scheme: basic
authToken:
type: apiKey
description: User authentication token to authenticate the request. The token is a string generated by the ICM server in the same header in every response of an REST endpoint.
name: authentication-token
in: header
bearerAuth:
type: http
description: 'Bearer token authentication. A request contains a header field
in the form of authorization: ```Bearer ```, where is a string
generated by an authentication service in response to a login request.'
scheme: bearer
bearerFormat: JWT
x-apiID: customer
x-origin-class: com.intershop.component.rest.capi.resource.RootResource,com.intershop.sellside.rest.common.capi.resource.customer.payment.CustomerPaymentItemResource,com.intershop.sellside.rest.common.capi.resource.customer.payment.CustomerPaymentItemResource,com.intershop.sellside.rest.common.capi.resource.customer.payment.CustomerPaymentItemResource,com.intershop.sellside.rest.common.capi.resource.customer.payment.CustomerPaymentItemResource,com.intershop.sellside.rest.common.capi.resource.customer.payment.CustomerPaymentItemResource,com.intershop.sellside.rest.common.capi.resource.customer.payment.CustomerPaymentItemResource,com.intershop.sellside.rest.common.capi.resource.customer.payment.CustomerPaymentItemResource,com.intershop.sellside.rest.common.capi.resource.customer.payment.CustomerPaymentItemResource,com.intershop.sellside.rest.common.capi.resource.customer.payment.CustomerPaymentItemResource,com.intershop.sellside.rest.common.capi.resource.customer.payment.CustomerPaymentItemResource,com.intershop.sellside.rest.common.capi.resource.customer.payment.CustomerPaymentItemResource,com.intershop.sellside.rest.common.capi.resource.customer.payment.CustomerPaymentItemResource,com.intershop.sellside.rest.common.capi.resource.customer.payment.CustomerPaymentItemResource,com.intershop.sellside.rest.common.capi.resource.customer.payment.CustomerPaymentItemResource,com.intershop.sellside.rest.common.capi.resource.customer.payment.CustomerPaymentItemResource,com.intershop.sellside.rest.common.capi.resource.customer.payment.CustomerPaymentItemResource,com.intershop.sellside.rest.common.capi.resource.customer.payment.CustomerPaymentItemResource,com.intershop.sellside.rest.common.capi.resource.customer.payment.CustomerPaymentItemResource