PIM Developer Overview

In this article we will look at PIM from a developers perspective and provide you with the overview and references you need to get started.

Before getting started

In this concept article you can find an overview of PIM, delving into its fundamental concepts and detailing its key features. If you haven't already, we highly recommend reading it.

You should also review our versioning strategy to understand how we manage releases. Additionally, you may find it helpful to read about our approach to software development at Bizzkit.

API

PIM is composed of a REST API that includes endpoints related to attributes, brands, lists, hierarchies, segmentation system, products, and so forth.

Swagger API reference

Notable endpoints

Below is a table highlighting some of the most notable endpoints:

This is just a brief highlight — please refer to the full Swagger API reference for the complete specification.

Resolved views

The resolved views endpoint provides a simplified representation of a PIM entity, designed for easy integration with external systems like online stores. For more details, please refer to the documentation here.

Using the API

Given a valid authentication token here is an example of calling the Test-endpoint:

1
2

curl -X GET https://myenv-pimapi.bizzkit.biz/api/test `
-H "Authorization: Bearer ..." 

1
2
3
4
5

# authtoken defined and initialized previously
@api = https://myenv-pimapi.bizzkit.biz

GET {{api}}/api/test HTTP/1.1
Authorization: Bearer {{authtoken}} 

Using the Bizzkit .NET SDK

For easy integration with Microsoft .NET, Bizzkit offers SDK packages. These packages include auto-generated Swagger clients and a factory class to simplify authentication. They automate token renewal and provide type-safe methods for the API endpoints.

All SDK package names start with the prefix Bizzkit.Sdk., and the SDK packages incorporate the following elements:

• A client factory
• A dedicated client
• Options to configure the client factory

To access the Bizzkit NuGet packages in your preferred development environment, you need to reference the Bizzkit Partner feed. You can, for example, do this by adding a nuget.config file to your project with the following configuration:

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14
15
16

<?xml version="1.0" encoding="utf-8"?>
<configuration>
  <packageSources>
    <clear />
    <add key="nuget" value="https://api.nuget.org/v3/index.json" />
    <add key="bizzkit-partner" value="https://pkgs.dev.azure.com/bizzkit-platform/7dad82b4-f2ae-4a3a-ab87-3fc791e4ea62/_packaging/bizzkit-partner-feed/nuget/v3/index.json" />
  </packageSources>
  <packageSourceMapping>
    <packageSource key="nuget">
      <package pattern="*" />
    </packageSource>
    <packageSource key="bizzkit-partner">
      <package pattern="Bizzkit*" />
    </packageSource>
  </packageSourceMapping>
</configuration>

This configuration clears existing package sources and adds the Bizzkit Partner feed alongside the official NuGet source.

Once the feed is configured, you can install the required NuGet package using the following command:

1

dotnet add package Bizzkit.Sdk.Pim

To simplify the authentication process, all NuGet packages associated with Bizzkit applications come with a factory class. This class streamlines the creation of an authenticated Swagger-generated client.

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12

using Bizzkit.Sdk.Pim;

var factory = new PimClientFactory(new PimConnectionOptions
{
    BaseUrl = "https://myenv-pimapi.bizzkit.biz",
    Authority = "https://myenv-auth.bizzkit.biz",
    ClientId = "BizzkitClient",
    ClientSecret = "BizzkitSecret",
    Scope = "pimapi/"
});

var client = await factory.CreateAuthenticatedClientAsync();

As noted earlier, the SDK client is mainly an auto-generated client based on the OpenAPI interface, meaning all methods map directly to the API.

Below is an example of calling the Test endpoint using the SDK client (with the factory and client already created):

1
2

var test = await client.Test_GetAsync();
Console.WriteLine(test);

Modelling

Creating a PIM data model to represent the data structure of products for a specific company is essential for ensuring accurate and efficient data management. A well-designed model helps in organizing and categorizing product information, making it easier to manage, retrieve, and update.

For more information, please refer to Data types, Attributes, Segmentations, and Modelling attributes.

Ingesting data

Our PIM system boasts a comprehensive data ingestion mechanism, harnessing the simplicity of the CSV format. This tool empowers you to efficiently import a variety of elements, including attributes, brands, products, hierarchies, and so forth. For a deeper understanding of the CSV specification utilized, please explore the dedicated article on the CSV specification.

For a more simple but fast import we also support the JSON format.

Product enrichment

When managing data in PIM, it’s important to understand the concepts of enrichers and validators. Product enrichers allow you to add, replace, set, and update product catalog item attributes, while validators ensure the quality of product data.

For more information, see Product enrichers and Product validators.

Events

PIM has the capability to communicate with other systems about events such as item creation, updates, or deletions using webhooks. You can set these up either through the User Interface (UI), by navigating to Settings -> Administration -> Webhooks, or via the API. For more detailed information, please refer to this article.

Extensibility

PIM can be extended in numerous ways. External bulk operations are an extension point in PIM, enabling you to perform custom operations or jobs on the product catalog, which are run on the customer solution side. UI Extension Frame Sets provide a way to call an external URL with parameters, and display the result either internally or externally.

Please refer to:

• Extensibility
• External bulk operations

Job runners

PIM utilizes two job execution mechanisms, namely the notification hub and the task runner. The role of the notification hub is to inform the User Interface (UI) about modifications, while the task runner takes care of event processing, cache management, and related tasks.