search
CommunitySupport PortalYouTubeFree trialSign Up!

graduation-capVendor Tutorial

Vendor Service allows you to configure how vendor's employees access products and orders. As an end-to-end feature, it integrates with the IAM, Product, and Order services to deliver a tailored solution. This service is also build to manage locations and associated data.

Related Services:

hashtag
How to create a vendor?

To create a vendor, send a request to the Creating a vendorarrow-up-right endpoint.

circle-check

To test the endpoint, open the API reference or check the example of a curl request.

rectangle-terminalAPI Referencechevron-right
curl -L 
  --request POST 
  --url 'https://api.emporix.io/vendor/vendor/{tenant}/vendors' 
  --header 'Authorization: Bearer YOUR_OAUTH2_TOKEN' 
  --header 'Content-Type: application/json' 
  --data '{
  "name": "ABC Company",
  "type": "COMPANY",
  "legalInfo": {
    "legalName": "ABC Company Inc.",
    "registrationDate": "2022-03-31T13:18:02.379Z",
    "countryOfRegistration": "US",
    "taxRegistrationNumber": "1234567890"
  },
  "contactDetails": [
    {
      "firstName": "Jane",
      "lastName": "Doe",
      "email": "[email protected]",
      "phone": "+1-555-0123"
    }
  ]
}

Your vendor is created and you get its ID in the request response, for example 6880c8e860a76003fbece674.

When a vendor is created, it automatically creates four new user groups for your tenant - vendor.order.manager, vendor.order.viewer., vendor.product.manager, vendor.product.viewer. In the example based on ABC Company the groups are:

  • ABC Company Vendor Product Manager

  • ABC Company Vendor Product Viewer

  • ABC Company Vendor Order Manager

  • ABC Company Vendor Order Viewer

The specific vendor group access rights are:

Group
Order Access
Product Access
Notes

Vendor order manager

Manage orders

✗

–

Vendor order viewer

Read orders

✗

–

Vendor product manager

✗

Manage products, including prices, availability, and media

Can also be granted permissions to publish/unpublish products.

Vendor product viewer

✗

Read products, including prices, availability, and media

Cannot be granted publishing rights.

If you want to check what vendors are created for your tenant, send the request to Retrieving all vendorsarrow-up-right endpoint.

As a response, you get information about all your tenant vendors with company and location details, for example:

hashtag
How to set up a location for an existing vendor?

To set up a location for the vendor, send the request to the Creating a locationarrow-up-right endpoint.

As a response you get the location ID, for example 687a4055b036735470a91bb8 that you can assign to your vendor.

hashtag
How to link users group with a vendor?

Start with checking the groups that are created for your tenant. Send the request to Retrieving all groupsarrow-up-right endpoint.

rectangle-terminalAPI Referencechevron-right

If you have created a vendor earlier for the tenant, you should see all the relevant vendor groups in the response. For example:

Each vendor group has it's own ID. To assign a user to the vendor group, send the request to Adding a user to a grouparrow-up-right endpoint. Provide the vendor group's ID and user's ID in the request.

circle-info

A single user can belong to only one vendor group.

rectangle-terminalAPI Referencechevron-right

You can then check the user's assignment to a vendor group by sending a request to the Retrieving a list of vendor usersarrow-up-right endpoint.

hashtag
How does product relate to a vendor?

When a logged-in user who belongs to a vendor creates a product, that product is automatically assigned to the vendor. This means every such product has a vendorId field populated.

When a customer adds a product to the cart that belongs to a vendor, the system automatically adds that vendor information to the cart entry. This ensures that when the checkout happens, every product “knows” which vendor it belongs to.

hashtag
How does vendor work with order splitting?

When the customer completes the checkout, a single order is created containing all the selected products. Each order entry retains the vendor information and is a standard order but with vendor details.

If you need to separate this combined order into vendor-specific suborders, send the request to the Splitting Orderarrow-up-right endpoint.

You can also use a Digital Process for the splitting mechanism, see the Order Splitting Digital Process template for reference:

file-download
14KB
Order Splitting Digital Process.json
arrow-up-right-from-squareOpen
circle-info

  • Only orders in the CREATED status can be split.

  • Orders that are already suborders or have been split before cannot be split again.

  • Orders with discounts cannot be split.

When you send this request, the API analyses all the order entries and groups them by vendor:

  • The original order becomes a master order with orderType: MASTER_ORDER.

  • Suborders are created:

    • One for each unique vendor.

    • One extra for items without a vendor.

    • splitInfo field is added with:

      • splitBy field, currently the VENDOR_ID is supported.

      • uniqueValue field reflects the VendorID, or is null when no vendor is assigned

hashtag
Order split example

Check how the order splitting flow works on the example:

  1. A vendor creates a product → it’s automatically assigned to their vendor ID.

  2. A customer adds products to the cart → vendor info stays with each product.

  3. Checkout creates a single combined order.

  4. Calling /split transforms it into:

    • One master order (ORD5001)

    • Multiple suborders (ORD5002, ORD5003) — one per vendor and one for non-vendor items.

Vendors can only view and manage their own suborders.

Master order example after split:

Vendor-specific suborder example:

Suborder for products without vendor example:

spinner
PreviousVendor ServiceNextAPI Reference

Last updated

Was this helpful?