Product and Vendor Profiles API

The Product and Vendor Profiles API allows you to manage vendor and product profiles within the SoftwareOne Marketplace platform.

It allows you to programmatically:

• Create and manage vendor profiles.

• Create and manage product profiles.

• Publish and unpublish catalog entries.

• Manage categories, industries, and segments used to organize the catalog.

Access to this API is role-based. Clients can view published items only, vendors can manage their own vendor and product profiles, and SoftwareOne Operations have full access to all entities and states.

Core Concepts

The Program API is built around the following core resources:

• Vendor profile - Represents a vendor in the public catalog.

• Product profile - Represents a product in the public catalog.

• Category - Represents a software category or sub-category, used to classify software in the public catalog.

• Industry - Represents specific business sectors or markets that products are designed to serve.

• Segment - Categorizes products based on the size and type of organizations for which they are most suitable.

Collections

The API is organized into collections, each containing a set of operations. Access to these operations varies by role, depending on whether you are a client, vendor, or operations user.

Refer to the following capability matrix to see which roles are authorized to perform specific operations within each collection:

Vendor Profile

Capability	Public	Client	Vendor	Operations
List vendor profiles	✅	✅	✅	✅
Get vendor profile details	✅	✅	✅	✅
Create vendor profile	❌	❌	❌	✅
Publish vendor profile	❌	❌	✅	✅
Modify vendor profile	❌	❌	✅	✅
Delete vendor profile	❌	❌	❌	✅

Product Profile

Capability	Public	Client	Vendor	Operations
List product profiles	✅	✅	✅	✅
Get product profile details	✅	✅	✅	✅
Create product profile	❌	❌	❌	✅
Publish product profile	❌	❌	✅	✅
Unpublish product profile	❌	❌	✅	✅
Modify product profile	❌	❌	✅	✅
Delete product profile	❌	❌	❌	✅

Categories

Capability	Public	Client	Vendor	Operations
List categories	✅	✅	✅	✅
Get a specific category	✅	✅	✅	✅
Create category	❌	❌	❌	✅
Publish category	❌	❌	❌	✅
Unpublish category	❌	❌	❌	✅
Modify category	❌	❌	❌	✅
Delete category	❌	❌	❌	✅

Industries

Capability	Public	Client	Vendor	Operations
List industries	✅	✅	✅	✅
Get a specific industry	✅	✅	✅	✅
Create industry	❌	❌	❌	✅
Publish industry	❌	❌	❌	✅
Unpublish industry	❌	❌	❌	✅
Modify industry	❌	❌	❌	✅
Delete industry	❌	❌	❌	✅

Segments

Capability	Public	Client	Vendor	Operations
List segments	✅	✅	✅	✅
Get a specific segment	✅	✅	✅	✅
Create segment	❌	❌	❌	✅
Publish segment	❌	❌	❌	✅
Unpublish segment	❌	❌	❌	✅
Modify segment	❌	❌	❌	✅
Delete segment	❌	❌	❌	✅