Suppliers

Introduction

Suppliers are third party entity (company, subsidiary...) authorized to sell on your store(s). They are allowed to manage products, prices, inventory or any administrative information.

Two entities are available:

• Supplier, the company entity
• Supplier user, the operator managing the supplier's offers and orders

⚠️

Suppliers can be configured for marketplace stores only.

Creating suppliers

⚠️

Make sure you configured custom fields you need prior to create suppliers.

1. Click Suppliers → Add supplier.

2. Fill in the information:

   • Supplier name
   • External ID
   • Description (optional)
   • Return policy (optional)
   • Payment due date (optional)
   • Payment due mode (optional)
   • Pictures (optional)

3. Click Create.

   The new supplier appears right away in the suppliers' list.

Listing suppliers via API (Operator)

Operators can retrieve all suppliers across their authorized stores in a single API call:

Endpoint: GET /v1/suppliers — operationId: ADM-SUPPLIER-550

• Access: dj-client: OPERATOR
• Returns only the suppliers from the stores the operator is authorized to access.
• Suppliers present in multiple stores are deduplicated.

Search and filters:

Sorting: sort=field:direction on createdAt, updatedAt, or name. Default: createdAt:desc.

Pagination follows the standard DJUST paginated response model.

✅

Tip: This endpoint replaces the need to call GET /public/v1/suppliers once per store. A single call returns all suppliers across all authorized stores.

Importing suppliers

💡

Refer to the Data Hub section for more information about supplier importation.

Suppliers can be imported in DJUST using an FTP client and a .csv file, or using our API connector.

Creating supplier users

Suppliers users have access to their own back-office that is different from the operator one.

Suppliers cannot access the platform's settings, but they can:

• create accounts
• products
• offers
• users

Suppliers can perform these actions manually only (no bulk import through a .csv file is possible yet). They can delegate such operations to the platform's operators.

The supplier user is attached to a group, which grants a role to the user:

1. Click Suppliers and select a supplier.

2. Click Add user under the ... button.

3. Fill in the information:

   • Civility
   • First name
   • Last name
   • Email
   • Groups
   • Back-office language

4. Click Add. The user is added to the list on the supplier's screen.

The user receives an email from DJUST to activate their account. Go to the back-office, click Forgot password? to access the reset password page and follow the instructions.

Suppliers can see customers in the back-office if the setting Association suppliers/customers allowed is active. This setting is located in Settings → Application settings. This can be useful for internal or closed marketplaces, where suppliers know all customers.