Skip to main content

Partner Management API (v1)

Download OpenAPI specification:Download

API for manage partners, dealers and stores (v1.155.0)

Dealers

GetAllDealers

Returns a list containing all available Dealers to the Partner

Responses

Response samples

Content type
No sample

GetDealer

Returns a specific Dealer to the Partner

path Parameters
dealerKey
required
string

Key that identifies the specific Dealer

Responses

Response samples

Content type
No sample

GetAllStores

Returns a list of Stores for a specific Dealer of the Partner

path Parameters
dealerKey
required
string

Key that identifies the specific Dealer

query Parameters
pageSize
integer <int32>
Default: 50

Size of the page

pageNumber
integer <int32>
Default: 0

Number of page (0-based)

Responses

Response samples

Content type
No sample

CreateStore

Adds a new Store for a specific Dealer of the Partner

path Parameters
dealerKey
required
string

Key that identifies the specific Dealer

Request Body schema:
required

Request containing the Store information

name
required
string non-empty

Name of the store

type
string or null <= 255 characters

store tipology

city
required
string non-empty

City where the store is located

address
required
string non-empty

Address of the store

ownerIban
string or null <= 255 characters

IBAN that belongs to the owner of the store (the one that will receive the store funds)

ownerName
string or null <= 255 characters

Name that belongs to the owner of the store (the one that will receive the store funds)

email
required
string non-empty ^(?!.*\.\.)(?!.*\+$)[a-zA-Z0-9!#$%&'*\/=?^_`{...

Email address

phoneNumber
required
string non-empty

Phone number

code
required
string non-empty

Code of the store. (Optional)

Must be unique for the composed key Partner-Dealer.

latitude
number or null <double>

Latitude of the store (optional)

longitude
number or null <double>

Longitude of the store (optional)

Responses

Request samples

Content type
{
  • "name": "string",
  • "type": "string",
  • "city": "string",
  • "address": "string",
  • "ownerIban": "string",
  • "ownerName": "string",
  • "email": "string",
  • "phoneNumber": "string",
  • "code": "string",
  • "latitude": 0.1,
  • "longitude": 0.1
}

Response samples

Content type
No sample

GetStore

Returns a specific Store for a specific Dealer of the Partner

path Parameters
dealerKey
required
string

Key that identifies the specific Dealer

storeId
required
string <uuid>

Store identifier

Responses

Response samples

Content type
No sample

UpdateStore

Updates a Store of a specific Dealer

path Parameters
dealerKey
required
string

Key that identifies the specific Dealer

storeId
required
string <uuid>

Identifier of the Store to update

Request Body schema:
required

Request containing the Store information to update

name
required
string non-empty

Name of the store

type
string or null <= 255 characters

Store typology

city
required
string non-empty

City where the store is located

address
required
string non-empty

Address of the store

ownerIban
string or null <= 255 characters

IBAN that belongs to the owner of the store (the one that will receive the store funds)

ownerName
string or null <= 255 characters

Name that belongs to the owner of the store (the one that will receive the store funds)

email
required
string non-empty ^(?!.*\.\.)(?!.*\+$)[a-zA-Z0-9!#$%&'*\/=?^_`{...

Email address

phoneNumber
required
string non-empty

Phone number

code
required
string non-empty

Code of the store. (Optional)

Must be unique for the composed key Partner-Dealer.

latitude
number or null <double>

Latitude of the store (optional)

longitude
number or null <double>

Longitude of the store (optional)

isActive
required
boolean

Is this an active store?

Responses

Request samples

Content type
{
  • "name": "string",
  • "type": "string",
  • "city": "string",
  • "address": "string",
  • "ownerIban": "string",
  • "ownerName": "string",
  • "email": "string",
  • "phoneNumber": "string",
  • "code": "string",
  • "latitude": 0.1,
  • "longitude": 0.1,
  • "isActive": true
}

Response samples

Content type
No sample

DeleteStore

Deletes a Store of a specific Dealer

path Parameters
dealerKey
required
string

Key that identifies the specific Dealer

storeId
required
string <uuid>

Identifier of the Store to delete

Responses

Response samples

Content type
No sample

GetStoreByCode

Returns a specific store using dealer and code for a partner

path Parameters
dealerKey
required
string

Key that identifies the specific Dealer

code
required
string

Store code

Responses

Response samples

Content type
No sample

GetStoresByIds

Returns a list of Stores using their id

Request Body schema:
required
Array
string <uuid>

Responses

Request samples

Content type
[
  • "497f6eca-6276-4993-bfeb-53cbbbba6f08"
]

Response samples

Content type
No sample

Partners

GetAllPartners

Returns a list containing all available partners

Responses

Response samples

Content type
No sample