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.2.1
servers:
- url: "/INTERSHOP/rest/{serverGroup}/{siteName}/{appUrl}"
description: Intershop ICM Server
variables:
serverGroup:
description: The server group
enum:
- BOS
- JOB
- WFS
default: WFS
siteName:
description: The site name
default: inSPIRED-inTRONICS-Site
appUrl:
description: The application URL identifier
enum:
- rest
- "-"
default: rest
paths:
/customers:
post:
tags:
- General
summary: Registers a new SMB customer
description: This operation 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 is assigned to an
existing user.
"403":
description: The authorized user must be the same as the one 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: Returns the logged-in user's customer profile
description: This operation returns the customer profile of the 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: Updates the logged-in user's customer profile
description: This operation updates the customer profile of the 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: Creates new customer address
description: This operation creates a new customer address 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
The creation of a unique address finished successfully.
"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: Returns customer address details
description: This operation returns details about the 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: Updates customer address
description: This operation updates a customer address with the address data
provided by 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: Deletes customer address
description: This operation deletes a specified 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}/payments:
get:
tags:
- Payment
summary: Returns list of customer's payment instruments
description: This operation returns a list of links of all payment instruments
that are stored in the 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: Adds payment instrument to customer
description: This operation adds a payment instrument to the 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: Returns payment methods for customer
description: This operation returns all available payment methods and their
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: Returns customer's payment instrument details
description: This operation returns detailed information about a payment instrument
of 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: Updates customer's payment instrument
description: "This operation updates a payment instrument in the customer profile\
\ for the logged-in user, including its attributes. The request must contain\
\ all attributes, even if they are unchanged. Payment instruments without\
\ additional attributes cannot 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: Removes payment instrument from customer's profile
description: This operation removes a payment instrument from the 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: Returns users of SMB customer
description: This operation lists all registered users of the selected SMB customer
with links to the user item resources.
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 whose firstName, lastName, or login matches the specified\
\ text will be returned."
schema:
type: string
- name: sort
in: query
description: The sorting to be applied to returned users. A minus sign indicates
sorting in descending order.
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
description: This operation registers new users for an SMB customer and returns
links to the created users.
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: A collection with links to the created users.
content:
application/json:
schema:
$ref: "#/components/schemas/UserLinkROCollection"
text/xml:
schema:
$ref: "#/components/schemas/UserLinkROCollection"
"207":
description: A collection with links to the created users and header 'not-created-users'
listing users whose creation failed.
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: A user with the provided login or business partner number already
exists.
content:
application/json:
schema:
type: string
text/xml:
schema:
type: string
"400":
description: The provided login is not acceptable.
content:
application/json:
schema:
type: string
text/xml:
schema:
type: string
"500":
description: The provided user data contains 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: Returns a user's profile data
description: This operation returns the profile data of a 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: "Displays available user data. If a preferred address is assigned,\
\ all address data will be included 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: A user with the provided business partner number already exists.
content:
application/json:
schema:
type: string
text/xml:
schema:
type: string
"500":
description: The provided user data contains 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: Deletes an SMB customer's user
description: This operation 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 a user having the 'Manage Users' (APP_B2B_MANAGE_USERS) permission.
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}/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: Creates an individual customer
description: This operation creates an individual customer. It is 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 is assigned to an
existing user.
"403":
description: The authorized user must be the same as the one 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: Creates a customer
description: This operation provides a simplified creation process for a new
customer with 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: Returns current customer's profile details
description: This operation returns the profile details of the currently logged-in
customer.
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
description: This operation updates the details of an existing 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: Creates new customer address
description: This operation creates a new customer address 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
The creation of a unique address finished successfully.
"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: Returns customer address details
description: This operation returns details about the 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: Updates customer address
description: This operation updates a customer address with the address data
provided by 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: Deletes customer address
description: This operation deletes a specified 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: Returns list of customer's payment instruments
description: This operation returns a list of links of all payment instruments
that are stored in the 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: Adds payment instrument to customer
description: This operation adds a payment instrument to the 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: Returns payment methods for customer
description: This operation returns all available payment methods and their
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: Returns customer's payment instrument details
description: This operation returns detailed information about a payment instrument
of 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: Updates customer's payment instrument
description: "This operation updates a payment instrument in the customer profile\
\ for the logged-in user, including its attributes. The request must contain\
\ all attributes, even if they are unchanged. Payment instruments without\
\ additional attributes cannot 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: Removes payment instrument from customer's profile
description: This operation removes a payment instrument from the 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 element. This is normally a **constant** that
can be used to differentiate elements 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
externalId:
type: string
description: The ID uniquely identifying the address in an external system;
required only for data objects that have already been synchronized with
the external system
readOnly: true
example: "000123456"
externalUrn:
type: string
description: The URN uniquely identifying the address in an external system;
required only for data objects that have already been synchronized with
the external system
readOnly: true
example: urn:address:MSDynamics365:MyCorp:000123456
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 element. This is normally a **constant** that
can be used to differentiate elements 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
description: the credentials of the new customer as CredentialsRO
nullable: true
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 element. This is normally a **constant** that
can be used to differentiate elements 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:
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 element. This is normally a **constant** that
can be used to differentiate elements 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:
title: Payment
type: object
properties:
name:
type: string
description: The name of an element
xml:
attribute: true
type:
type: string
description: 'The type of the element. This is normally a **constant** that
can be used to differentiate elements 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
description: The payment ID
example: dhKsEmZRPyEAAAF2hyV6dB2n
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
description: The parameters for this payment
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 element. This is normally a **constant** that
can be used to differentiate elements 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
password:
type: string
description: Password of the user. Used only in requests.
nullable: true
writeOnly: true
example: P@ssw0rd123
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: Indicates whether the user is active
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
example: ""
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
example: ""
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 element. This is normally a **constant** that
can be used to differentiate elements 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 element. This is normally a **constant** that
can be used to differentiate elements 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 element. This is normally a **constant** that
can be used to differentiate elements 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:
title: PaymentOption
type: object
properties:
name:
type: string
description: The name of an element
xml:
attribute: true
type:
type: string
description: 'The type of the element. This is normally a **constant** that
can be used to differentiate elements 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
example: Applicable
restrictions:
type: array
description: The restrictions for this payment option
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: This resource holds information on a payment option.
xml:
name: PaymentOption
PaymentOptionsForMethodRO:
title: PaymentOptionsForMethod
type: object
properties:
name:
type: string
description: The name of an element
xml:
attribute: true
type:
type: string
description: 'The type of the element. This is normally a **constant** that
can be used to differentiate elements 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: This resource holds information about payment methods that can
be added and the HTTP method to be used.
xml:
name: PaymentOptionsForMethodRO
PaymentOptionsRO:
title: PaymentOptions
type: object
properties:
name:
type: string
description: The name of an element
xml:
attribute: true
type:
type: string
description: 'The type of the element. This is normally a **constant** that
can be used to differentiate elements by their type. '
example: PaymentOptions
xml:
attribute: true
methods:
type: array
description: The payment methods that can be added via HTTP
items:
$ref: "#/components/schemas/PaymentOptionsForMethodRO"
description: This resource holds one or more PaymentOptionsForMethodRO.
xml:
name: PaymentOptions
UserLinkRO:
type: object
properties:
type:
type: string
description: 'The type of the element. This is normally a **constant** that
can be used to differentiate elements 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 element. This is normally a **constant** that
can be used to differentiate elements 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 element. This is normally a **constant** that
can be used to differentiate elements 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 element. This is normally a **constant** that
can be used to differentiate elements 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 element. This is normally a **constant** that
can be used to differentiate elements 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
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 element. This is normally a **constant** that
can be used to differentiate elements 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
"428":
description: Precondition Required
"429":
description: Too Many Requests
"431":
description: Request Header Fields Too Large
"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
"511":
description: Network Authentication Required
parameters:
loc:
name: loc
in: path
description: "The locale ID (submitted as optional matrix parameter ```;loc=```).\
\ If omitted, the priority is as follows (from high to low): Locale ID parameter,\
\ user's default locale, site's default locale. The available locales depend\
\ on your individual Intershop Commerce Management installation. Use IANA\
\ language definitions for languages and regions and combine them using a\
\ underscore, e. g. ```en_US```."
required: false
style: matrix
schema:
type: string
description: "The locale ID (submitted as optional matrix parameter ```;loc=```).\
\ If omitted, the priority is as follows (from high to low): Locale ID parameter,\
\ user's default locale, site's default locale. The available locales depend\
\ on your individual Intershop Commerce Management installation. Use IANA\
\ language definitions for languages and regions and combine them using\
\ a underscore, e. g. ```en_US```."
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 personalization group identifier, submitted as matrix parameter\
\ ```;pgid=```. Required if you want to work with customer-specific\
\ content."
required: false
style: matrix
schema:
type: string
description: "The personalization group identifier, submitted as matrix parameter\
\ ```;pgid=```. Required if you want to work with customer-specific\
\ content."
example: FUOGrzQ_VjORpGaN8DRGmLLE0000
example: FUOGrzQ_VjORpGaN8DRGmLLE0000
spgid:
name: spgid
in: path
description: "The secure personalization group identifier, submitted as matrix\
\ parameter ```;spgid=```. Required if you want to work with customer-specific\
\ content."
required: false
style: matrix
schema:
type: string
description: "The secure personalization group identifier, submitted as matrix\
\ parameter ```;spgid=```. Required if you want to work with customer-specific\
\ content."
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.address.CustomerAddressItemResource,com.intershop.sellside.rest.common.capi.resource.customer.payment.CustomerPaymentItemResource,com.intershop.sellside.rest.common.capi.resource.customer.address.CustomerAddressItemResource,com.intershop.sellside.rest.common.capi.resource.customer.address.CustomerAddressItemResource,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.address.CustomerAddressItemResource,com.intershop.sellside.rest.common.capi.resource.customer.payment.CustomerPaymentItemResource,com.intershop.sellside.rest.common.capi.resource.customer.address.CustomerAddressItemResource,com.intershop.sellside.rest.common.capi.resource.customer.address.CustomerAddressItemResource,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"