1. Overview

These services provide the ability for agents to assist customers with their order, and look up the order by name, email, cart, or order number.

1.1. Version information

Version : 1.0.0

1.2. License information

License : Use of this file is subject to the terms of your agreement with SAP SE or its affiliates respecting the use of the SAP product for which this file relates.
Terms of service : null

1.3. URI scheme

Host : localhost:9001
BasePath : /assistedservicewebservices

1.4. Tags

  • customer-lists-controller : Customer Lists Controller

  • customers-controller : Customers Controller

2. Paths

2.1. Binds customer with provided id to cart if it’s an anonymous cart

POST /bind-cart

2.1.1. Parameters

Type Name Description Schema

Query

baseSite
required

Id of the BaseSite

string

Query

cartId
required

Id of the anonymous Cart

string

Query

customerId
required

Id of the Customer

string

2.1.2. Responses

HTTP Code Description Schema

200

OK

string

201

Created

No Content

401

Unauthorized

No Content

403

Forbidden

No Content

404

Not Found

No Content

2.1.3. Consumes

  • application/json

2.1.4. Produces

  • */*

2.1.5. Tags

  • customers-controller

2.1.6. Security

Type Name Scopes

oauth2

basic

2.2. Returns customer lists

GET /customerlists

2.2.1. Description

This endpoint returns list of all customer lists. This can only be done when logged in

2.2.2. Parameters

Type Name Description Schema

Query

baseSite
required

Id of the BaseSite

string

2.2.3. Responses

HTTP Code Description Schema

200

OK

401

Unauthorized

No Content

403

Forbidden

No Content

404

Not Found

No Content

2.2.4. Produces

  • */*

2.2.5. Tags

  • customer-lists-controller

2.2.6. Security

Type Name Scopes

oauth2

basic

2.3. Returns single customer list details

GET /customerlists/{customerlist}

2.3.1. Description

This endpoint returns details of customer list with valid Id

2.3.2. Parameters

Type Name Description Schema

Path

customerlist
required

Id of the customer list

string

Query

baseSite
required

Id of the BaseSite

string

2.3.3. Responses

HTTP Code Description Schema

200

OK

401

Unauthorized

No Content

403

Forbidden

No Content

404

Not Found

No Content

2.3.4. Produces

  • */*

2.3.5. Tags

  • customer-lists-controller

2.3.6. Security

Type Name Scopes

oauth2

basic

2.4. Returns customers to auto complete based on customerQuery parameter

GET /customers/autocomplete

2.4.1. Parameters

Type Name Description Schema

Query

baseSite
required

Id of the BaseSite

string

Query

customerQuery
required

Customer query: first characters of customer email or part of name. A BadRequestException is thrown when the query is too short. Minimum query length can be updated via assistedserviceswebservices.customer.suggestions.minimum.query.length property.

string

2.4.2. Responses

HTTP Code Description Schema

200

OK

401

Unauthorized

No Content

403

Forbidden

No Content

404

Not Found

No Content

2.4.3. Produces

  • application/json

2.4.4. Tags

  • customers-controller

2.4.5. Security

Type Name Scopes

oauth2

basic

2.5. Returns customers based on query parameters

GET /customers/search

2.5.1. Description

This endpoint returns paginated list of customers based on provided query parameters. If query term is present it will return customers based on provided value. If customerListId is present it will ignore query term and return only customers who belong to the given customer list. If orderId parameter is present it will ignore previous parameters and it will return customer associated to the given order. This can only be done by the logged in user.

2.5.2. Parameters

Type Name Description Schema Default

Query

baseSite
required

Id of the BaseSite

string

Query

currentPage
optional

Current page

integer (int32)

0

Query

customerListId
optional

Id of the customer list

string

Query

orderId
optional

Id of the order

string

Query

pageSize
optional

Page size

integer (int32)

20

Query

query
optional

Customer uid search term

string

Query

sort
optional

Sort parameter. Possible values: byUidAsc, byUidDesc, byNameAsc, byNameDesc

string

2.5.3. Responses

HTTP Code Description Schema

200

OK

401

Unauthorized

No Content

403

Forbidden

No Content

404

Not Found

No Content

2.5.4. Produces

  • */*

2.5.5. Tags

  • customers-controller

2.5.6. Security

Type Name Scopes

oauth2

basic

3. Definitions

3.1. Address

Request body fields required and optional to operate on address data. The DTO is in XML or .json format

Name Description Schema

cellphone
optional

Cellphone number

string

city
optional

city

cityDistrict
optional

city district

companyName
optional

Company Name

string

country
optional

Country where address is located

defaultAddress
optional

Boolean flag if address is default

boolean

district
optional

District name

string

email
optional

Email address

string

firstName
required

First name of the address person

string

formattedAddress
optional

Boolean flag if address is formatted

string

id
optional

Unique id value of the address which is optional while creating new address. While performing other address operations this value is the key

string

lastName
required

Last name of the address person

string

line1
required

First line of the address

string

line2
optional

Second line of the address

string

phone
optional

Phone number

string

postalCode
required

Postal code of the address

string

region
optional

Region where address belongs to

shippingAddress
optional

Boolean flag if address is for shipping

boolean

title
optional

Title of the address person

string

titleCode
required

Code of the title

string

town
required

Town, field required

string

visibleInAddressBook
optional

Boolean flag if address is visible in the Address Book

boolean

3.2. B2BApprovalProcess

Representation of an organizational approval process

Name Description Schema

code
required

Code of the Organizational Approval Process
Example : "accApproval"

string

name
optional

Name of the Organizational Approval Process
Example : "Escalation Approval with Merchant Check"

string

3.3. B2BCostCenterShallow

Representation of a cost center. This bean is shallow, which means its potential relationship fields to other Org Unit fields are simple ids. No Org Unit WsDTO fields should be declared in this bean to avoid circular references.

Name Description Schema

active
optional

Indication of whether the cost center is active. Deprecated since 2005. Read-only, used for display purposes.
Example : "true"

string

activeFlag
optional

Boolean flag of whether the cost center is active.
Example : true

boolean

code
optional

The code of the cost center
Example : "Custom_Retail"

string

currency
optional

The currency of the cost center

name
optional

The name of the cost center
Example : "Custom Retail"

string

originalCode
optional

The original code of the cost center. Deprecated since 2005.
Example : "Custom_Retail"

string

3.4. B2BUnit

Representation of an organizational unit

Name Description Schema

active
optional

Boolean flag of whether Organizational Unit is active
Example : true

boolean

addresses
optional

Addresses of the organizational unit node

< Address > array

administrators
optional

Administrators of the organizational unit node

< User > array

approvalProcess
optional

Approval Process of the organizational unit node

approvers
optional

Approvers of the organizational unit node

< User > array

costCenters
optional

The cost centers of the organizational unit node

customers
optional

Customers of the organizational unit node

< User > array

managers
optional

Managers of the organizational unit node

< User > array

name
optional

Name of the organizational unit
Example : "Pronto"

string

parentOrgUnit
optional

Parent unit of the organizational unit

uid
required

Identifier of the organizational unit
Example : "Pronto"

string

3.5. City

data object of city

Name Description Schema

isocode
optional

ISO 3166-1 alpha-2 standard, e.g.[countryIso]-[regionNumber]-[cityNumber]
Example : "CN-11-1, CN-11-2, CN-11-3"

string

name
optional

name of city
Example : "Beijing, Tianjin, Baoding"

string

3.6. Country

Response body fields which will be returned while fetching the list of countries. The DTO is in XML or .json format

Name Description Schema

isocode
optional

Country code in iso format

string

name
optional

Name of the country

string

3.7. Currency

Representation of a Currency

Name Description Schema

active
optional

Boolean flag whether currency is active

boolean

isocode
optional

Code of the currency in iso format

string

name
optional

Name of the currency

string

symbol
optional

Symbol of the currency

string

3.8. CustomerListWsDTO

Name Schema

additionalColumnsKeys
optional

< string > array

name
optional

string

searchBoxEnabled
optional

boolean

uid
optional

string

3.9. CustomerSearchPageWsDTO

Name Schema

entries
optional

< User > array

pagination
optional

sorts
optional

< Sort > array

3.10. CustomerSuggestionWsDto

Name Schema

card
optional

string

carts
optional

< string > array

date
optional

string

email
optional

string

fullName
optional

string

3.11. District

data object of district

Name Description Schema

isocode
optional

ISO 3166-1 alpha-2 standard, e.g.[countryIso]-[regionNumber]-[cityNumber]-[districtNumber]

string

name
optional

name of district
Example : "Dongcheng District, Fengtai District, Daxing District"

string

3.12. Language

Representation of a Language

Name Description Schema

active
optional

true/false indicator when the language is active

boolean

isocode
optional

iso code of the language

string

name
optional

name of the language

string

nativeName
optional

name the language in native form

string

3.13. Principal

Representation of a Principal webservice DTO used for defining User data types

Name Description Schema

name
optional

Name of the user

string

uid
optional

Unique user identifier

string

3.14. Region

Response body fields which will be returned while fetching the list of country’s regions.

Name Description Schema

countryIso
optional

Country code in iso format

string

isocode
optional

Country and Region code in iso format

string

isocodeShort
optional

Region code in short iso form

string

name
optional

Name of the region

string

3.15. Sort

Representation a Sort option

Name Description Schema

code
optional

Code of Sort

string

name
optional

Name of Sort

string

selected
optional

Flag stating when Sort is selected

boolean

3.16. User

Representation of an User

Name Description Schema

active
optional

Boolean flag of whether the user is active/enabled or not
Example : true

boolean

approvers
optional

List of organizational approvers

< User > array

currency
optional

User preferred currency

customerId
optional

Customer identifier

string

deactivationDate
optional

Deactivation date

string (date-time)

defaultAddress
optional

User address

displayUid
optional

User identifier

string

email
optional

Email of the user
Example : "mark.rivers@rustic-hw.com"

string

emailLanguage
optional

Email Language

string

firstName
optional

User first name

string

language
optional

User preferred language

lastName
optional

User last name

string

mobileNumber
optional

Mobile Number

string

name
optional

Name of the user

string

orgUnit
optional

The unit of the User

roles
optional

< string > array

selected
optional

Boolean flag of whether the user is selected
Example : true

boolean

title
optional

User title

string

titleCode
optional

User title code

string

uid
optional

Unique user identifier

string

3.17. UserGroup

Representation of an User Group

Name Description Schema

members
optional

List of members

< Principal > array

membersCount
optional

Number of members

integer (int32)

name
optional

Name of the user

string

subGroups
optional

List of subgroups

< UserGroup > array

uid
optional

Unique user identifier

string

3.18. UserGroupList

Representation of an User Group List

Name Description Schema

currentPage
optional

Current page

integer (int32)

numberOfPages
optional

Number of pages

integer (int32)

pageSize
optional

Page size

integer (int32)

totalNumber
optional

Total number

integer (int32)

userGroups
optional

List of user groups

< UserGroup > array

3.19. deprecatedPagination

Representation of a search results pagination

Name Description Schema

currentPage
optional

The current page number. The first page is number zero (0), the second page is number one (1), and so on

integer (int32)

pageSize
optional

The number of results per page. A page may have less results if there are less than a full page of results, only on the last page in the results

integer (int32)

sort
optional

The selected sort code

string

totalPages
optional

The total number of pages. This is the number of pages, each of pageSize, required to display the totalResults.

integer (int32)

totalResults
optional

The total number of matched results across all pages

integer (int64)

4. Security

4.1. oauth2

Type : oauth2
Flow : password
Token URL : /authorizationserver/oauth/token

Name

basic