Overview

Additional companyContactPropagation settings were added to define how company contact assignments are propagated within a company hierarchy.

• UPWARD – an existing setting that is set as default one, propagation from subsidiaries to parent

• DOWNWARD – new, propagation from parent to subsidiaries

• DISABLED – new, no propagation

Propagation occurs only at the moment of assignment: creating a contact in one company also creates corresponding contacts in related companies based on the configured direction.

Known problems

There are no known problems.

Overview

New property was added to orderEntryCalculatedPrice.price:

calculated:INTERNAL/EXTERNAL - indicates how the line item price was determined.

• INTERNAL — means the calculation was done by Emporix using unit price × quantity.

• EXTERNAL — means the calculation was done externally with lineTax

Known problems

There are no known problems.

Overview

A new customerId query parameter has been added to the customer segments retrieval endpoints. This parameter allows you to retrieve customer segments for a specific customer. The parameter can only be used with the customersegment.segment_read scope.

Modified endpoints

Known problems

There are no known problems.

You can expect some changes in the nearest future regarding the workings of the mentioned services.

Overview

Category tree endpoints now support filtering by category IDs. When the category IDs are provided, only category trees that include at least one of the specified categories are returned.

Modified endpoints

New endpoints

Known problems

There are no known problems.

Overview

The Media Service has been extended to support custom schema types as reference types. The type field in RefId can now accept any custom schema type in addition to the predefined types.

Updated endpoints

Known problems

There are no known problems.

Overview

A q param has been added to endpoints for retrieving prices and price-lists.

Updated endpoints

Known problems

There are no known problems.

Overview

Schema Service has been extended with new schema type - SITE.

Created services

Known problems

There are no known problems.

Overview

Order event schema was updated.

Added new fields

Known problems

There are no known problems.

Overview

The new events were added to the Webhook Service. The events are related to the finished agentic jobs.

Added events

Known problems

There are no known problems.

Overview

The new events were added to webhook-service. The events related to manipulation of custom instances are now emitted to Webhook Service.

Added events

Known problems

There are no known problems.

Overview

Category tree endpoints exclude trees in which the root category has published=false, when only published categories are requested (showUnpublished=false).

Modified endpoints

Known problems

There are no known problems.

Overview

A new search endpoint has been added to the Order Service, allowing you to search for tenant's orders using a request body instead of query parameters.

New endpoints

Known problems

There are no known problems.

Overview

Added a new API for retrieving agent logs, allowing you to monitor and debug agent requests and sessions.

Added endpoints

Find out what has been recently changed in the Emporix system.

- new feature

- improvement

- major change

- minor change

- deprecation

Overview

Product retrieval responses now expose two new fields:

Overview

Extended existing API for Agents by adding LLM provider of self_hosted_vllm type which supports self deployed vLLM.

Updated endpoints

Overview

The AI Service has been extended to support a new MCP server transport protocol: streamable_http. This option enables streamable HTTP-based communication between agents and custom MCP server implementations alongside the deprecated sse transport protocol.

Overview

Introduced new endpoints in ai-rag-indexer service which are necessary for configuring and performing RAG Search.

Added endpoints

Overview

Cart Service now supports applying external discounts directly at the cart level. This enables external systems (such as ERP systems) to apply cart-wide discounts that are calculated outside of Commerce Engine.

New attribute added to cart:

• externalDiscounts - an array of external discounts that can be applied to the entire cart, similar to how external discounts can be applied at the item level

Overview

A new search endpoint has been added to the Customer Service, allowing you to search for customer profiles using a request body instead of query parameters.

New endpoints

Overview

A new endpoint has been added to retrieve a legal entity along with all of its parent legal entities in the hierarchy.

New endpoints

Overview

We've added a new contact assignment type: Contact to the Client Management service.

New validation rules:

• Customer can be assigned to a legal entity only once, regardless of the assignment type.

Overview

Since the official deprecation of the SSE transport in the Model Context Protocol spec , MCP clients have been moving away from SSE. Based on the official deprecation, we are deprecating the sse transport protocol in the AI Service as well.

Overview

This update introduces support for initial passwords when creating customers. A new password field is now available during customer creation, allowing you to set an initial password for new customer accounts. Additionally, the login response now includes the initialPassword flag that indicates whether the customer logged in using their initial password, enabling you to prompt users to change their password on first login.

Overview

The Vendor Service allows you to manage vendors and their employees in your system. Vendor employees have access only to vendor's products and orders.

A vendor can have a subsidiary that represents a subdivision of the main vendor. Every vendor and subsidiary can have locations.

Overview

New field vendorId was added to the availability response. Vendor employees can modify and see only availabilities for products that belong to their vendor.

Overview

A new attribute vendor has been added to the cart item's product. The value is autopopulated based on product's vendor.

Modified endpoints

Overview

New field vendorId was added to the product model. Vendor employees can see only products that belong to their vendor.

New scopes

Overview

All previously deprecated endpoints and fields are now removed ().

Removed endpoints & fields

Overview

The Category Service has been enhanced with a new search endpoint that allows searching for categories using a request body. Additionally, the existing GET categories endpoint now supports the q query parameter for filtering results.

New endpoints

Updated endpoints

Known problems

There are no known problems.

Overview

Price lists can now be assigned to specific legal entities. When a price list is assigned to a legal entity, it automatically applies to all its subsidiaries as well.

New field legalEntityId has been added to:

• Price list – to assign price lists to specific legal entities

• Price match – to include price lists resctricted to legal entity during price matching

Modified endpoints

Known problems

There are no known problems.

Overview

All previously deprecated endpoints are now removed (2025-04-04: Sequential ID Service - deprecations).

Removed endpoints & fields

Known problems

There are no known problems.

Overview

New attribute added to cart:

• quoteId - this field contains the ID of the quote associated with the cart

When a quote is created from a cart using the Creating a quote endpoint, the cart is automatically closed and the quoteId is set on that cart. This ensures proper traceability between carts and their corresponding quotes.

Modified endpoints

Known problems

There are no known problems.

Overview

A new attribute vendor has been added to the order object. Vendor employees can see and modify only orders that belong to their vendor.

New scopes

• order.order_read_by_vendor

• order.order_manage_by_vendor

Modified endpoints

Known problems

There are no known problems.

Overview

A new reference type has been added to the Media service: MODULE. It's meant to be used for Management Dashboard assets.

Modified endpoints

Known problems

There are no known problems.

Overview

A new attribute vendorId has been added to the group entity. The attribute is used to identify the vendor that owns the group and can be set only when a group is created. New endpoints that return users that belong to vendor have been added.

Updated endpoints

Known problems

There are no known problems.

Overview

New field vendorId was added to the asset response payload. With the new scopes, vendor employees can now manage and view assets for products that belong to their vendor.

New scopes

• media.asset_manage_by_vendor

• media.asset_read_by_vendor

Modified endpoints

Known problems

There are no known problems.

Overview

Two new attributes have been added to cart item:

• linePrice - externally calculated total price for the item line (unit price × quantity)

• lineTax - externally calculated total tax for the item line, allowed only for external product type

New property was added to itemCalculatedPrice.price:

calculated:INTERNAL/EXTERNAL - indicates how the line item price was determined.

• INTERNAL — means the calculation was done by Emporix using unit price × quantity.

• EXTERNAL — means the calculation was done externally with lineTax

Updated endpoints

Known problems

There are no known problems.

Overview

The calculatedPrice of Order Service has been enriched with new fields:

• totalDiscounts has a new price field that contains all price details

• appliedDiscounts has a new price field that contains all price details

The calculatedPrice or cart level has new fields

• shipping price before discounts

• fees price before discounts

Updated endpoints

Known problems

There are no known problems.

Overview

All previously deprecated endpoints and fields are now removed (2025-03-04: Brand Service - deprecations).

Removed endpoints & fields

Known problems

There are no known problems.

Overview

Extended existing API for Native Tools by adding tools of RAG_CUSTOM and RAG_EMPORIX types which are necessary for performing RAG Search.

Updated endpoints

Known problems

There are no known problems.

Overview

The Schema Service has been enhanced with support for references. These updates include:

• New REFERENCE mixin schema attribute type for custom schema types, allowing references to products, orders, carts, customers, media, prices, price lists, customer segments, categories and other custom schema types.

Overview

The cart service now allows adding items to cart as separate lines. This means the same product can appear in the cart multiple times, enabling you to apply external discounts or fees to individual items. To add item as a separate line, specify keepAsSeparateLine property in the Adding a product to cart request.

Overview

The couponMixin mixin has been removed from the customer model. The mixin was used to store referralCouponCode of the customer. The information about referral coupon is now stored in the Coupon model.

Known problems

There are no known problems.

Overview

Added a new API for importing and exporting AI agents and improved the existing APIs.

New attributes

• Extended the jobs API with new fields: type, exportResult, and importResult.

• Introduced a force query parameter for the delete endpoints of agents, tools, tokens, and MCP servers.

• Added the enabled field to the responses of tools and MCP servers.

Added endpoints

Modified endpoints

Known problems

There are no known problems.

Overview

Cart Service now supports comprehensive address management directly on the cart object. This enhancement allows you to specify billing and shipping addresses that are used for tax determination and shipping cost calculation.

New attribute added to cart:

• addresses - an array of addresses associated with the cart

Each address can include the following properties:

• type - address type: BILLING or SHIPPING

• contactName - contact name for the address

• companyName - company name

Address auto-population

When addresses are not explicitly provided in the request, the Cart Service automatically populates them based on the following priority order:

1. Legal Entity Address - If the cart is associated with a legal entity, the first location with both country,zip-code and required address type is used (origin: LEGAL_ENTITY).

2. Customer Address - If the cart has a logged-in customer, the default address matching the required type is used (origin: CUSTOMER).

Addresses provided in the request are marked with origin REQUEST in the response.

For backward compatibility the legal entity address population has to be enabled in the tenant settings: enableLegalEntityAddressFallbackInCart. It is enabled by default for all new tenants.

Address usage

The addresses specified on the cart are used for:

• Tax determination - The appropriate tax country is determined based on the billing or shipping address, as configured in the site's taxDeterminationBasedOn setting.

• Shipping cost calculation - The shipping address is used to calculate accurate shipping costs based on the destination.

For more details, see:

Backward compatibility

The existing countryCode and zipCode parameters at the cart level are still supported for backward compatibility. However, the new addresses array provides a more comprehensive and flexible approach to address management.

Updated endpoints

Known problems

There are no known problems.

Overview

All previously deprecated endpoints are now removed (2025-03-28: Coupon Service - deprecations).

Removed endpoints & fields

Known problems

There are no known problems.

Overview

The Quote Service has been extended to support external prices and mixins on product and item levels. This enhancement allows for more flexible quote management with custom pricing and additional product metadata.

Key changes:

• A product can be added to quote more than once

• Added support for the quote creation from carts with external products and prices

• Added support for external prices with the type field (INTERNAL/EXTERNAL) on price objects

• Added mixins and metadata support on both product and item levels

• Added new scope requirement cart.cart_manage_external_prices for external prices

• Extended PATCH operations to support mixin updates on items and products

• Added the id field to media objects

Modified endpoints

New features

External prices

Prices can now be defined as INTERNAL - from Emporix Price Service, or EXTERNAL - as custom prices. The type field on price objects indicates the price type:

• INTERNAL: Price is fetched from the Emporix Price Service using priceId, which is a required value.

• EXTERNAL: Custom price is provided directly in the request, where priceId is not required.

External products

Products can now be defined as INTERNAL - from Emporix Price Service, or EXTERNAL - as custom products. For external products:

• The name field can be provided as a localized map

• The media object can be provided with the id, contentType, and url fields

Mixins support

Mixins and metadata can now be added to:

• Quote items

• Products within quote items

• Quote level (already supported)

PATCH operations support adding, replacing, and removing mixin values at all these levels.

Known problems

There are no known problems.

Overview

The Logging in a customer and Refreshing a customer token endpoints of Customer Service now return the additional field:

• session_id - Customer email used to login (generate the token).

Updated endpoints

Known problems

There are no known problems.

Overview

A new attribute cartId has been added to the order object. The new field will have cartId of the cart associated with the order.

Modified endpoints

Known problems

There are no known problems.

Overview

New endpoints have been introduced to retrieve orders for a legal entity. These endpoints allow fetching multiple orders or a specific order associated with a legal entity. The response structure remains identical to the existing order retrieval endpoints for tenants and customer-managed orders.

New endpoints

Known problems

There are no known problems.

Overview

All deprecations will be removed on 2025-10-01. From now, use the new referral coupons endpoints to referral coupons.

Deprecated endpoints

Known problems

There are no known problems.

Overview

The GET endpoints for the Quote Service have been extended with the businessModel field. It provides information whether quote has been created for B2B or B2C customer.

Updated endpoints

Known problems

There are no known problems.

Overview

A new referralCoupon field has been added to the endpoint. This field indicates if the coupon is of a referral coupon type.

Updated endpoints

Known problems

There are no known problems.

Overview

The Validate a token endpoint of Oauth service returns now two additional fields:

• email - Customer email used to login (generate the token).

• legalEntityId - Legal Entity Id.

Updated endpoints

Known problems

There are no known problems.

Overview

An optional legalEntityId query parameter has been introduced to the endpoint. This is the recommended way to store information about the selected legal entity in the system. Upon logging in, users should select a legal entity they want to act on behalf of. It invokes the refresh token endpoint with the chosen entity. If the value is provided in the request, the validation process ensures that the customer is assigned to the specified legal entity.

Updated endpoints

Known problems

There are no known problems.

Overview

The cart service was extended with search endpoint which allows to search for many carts.

Added endpoints

Known problems

There are no known problems.

Overview

Endpoint for searching by YRNs will be removed on 2025-10-17.

Deprecated endpoints

Known problems

There are no known problems.

Overview

A validation rule ensures fee data consistency by requiring a taxCode when creating or updating fees with taxable=true. This enforces the logical dependency between taxation status and tax code identification.

Updated endpoints

Known problems

There are no known problems.

Overview

Request body for creating or updating assets has been extended with new reference type - BRAND - which should be used to assign media to the brands.

Updated endpoints

Known problems

There are no known problems.

Overview

From now on, the response of the "Retrieving category trees for a customer segments" endpoint includes new fields: localizedDescription, localizedSlug, ecn, validity, position, and published, which allows fetching complete category tree information in a single request.

Updated endpoints

Known problems

There are no known problems.

Overview

When applying discount on a cart, the request allows to specify calculationType with following values: ApplyDiscountBeforeTax, ApplyDiscountAfterTax The field has been deprecated, cart's calculatedPrice relays on site's configuration includesTax which defines whether the discount should be applied on net or gross prices.

Updated endpoints

Known problems

There are no known problems.

Overview

A new validate a customer token endpoint has been created. The endpoint checks whether a token is valid. If the token is invalid, it returns a 401 status code. If the token is valid, it provides the token details.

New endpoints

Known problems

There are no known problems.

Overview

The cart service now allows to specify external discounts on an item level. The functionality requires the cart.cart_manage_external_prices scope to add an external discount to the item.

Overview

When adding entries to an order, the payload now includes a new attribute called entryId. The productId attribute should only be provided when adding a completely new product to the order. This enhancement allows for more precise control over order modifications.

Overview

A new attribute orderId has been added to the cart object. The new field will have orderId of the order associated with the cart.

Modified endpoints

Overview

The calculatedPrice of Cart Service has been enriched with new fields:

• totalDiscounts has a new price field that contains all price details

Overview

Query parameter q has been added to GET all groups endpoint. The new query parameter allows you to filter groups.

Overview

We have completed an update to the customer group and assignment structure in the IAM service for all tenants. This change brings greater clarity and flexibility to how users are organized and managed within each legal entity.

What’s new

Overview

We are committed to ensuring the highest level of security for our API services. As part of this commitment, we are discontinuing support for weak cryptographic ciphers (api.emporix.io).

This update is essential to maintain the security and integrity of the data exchanged between your systems and our API.

Effective 24th of March, we will no longer support the following cipher suites:

Overview

All deprecations will be removed on 2025-09-01. From now on, use the to manage media for labels.

Deprecated endpoints

Overview

A new optional legalEntityId field has been added to the endpoint. This field is intended exclusively for B2B cases and specifies the legal entity for which the order was created.

Overview

The metadata field at root level is now deprecated in GET responses, as each shopping list now maintains its own independent metadata field. This field will be fully removed on September 1st, 2025. Additionally we have added version validation for update operation where you can provide version in the update payload to validate it against the current entity version, preventing unintentional overriding when multiple updates occur simultaneously.

Overview

All deprecations will be removed on 2025-09-01. From now on, use the to manage media for brands.

Deprecated endpoints

Overview

The new events were added to webhook-service. The events related to manipulation of vendor instances are now emitted to Webhook Service.

Added events

Overview

Customer Segment Service allows you to group your customers in many convenient ways that suit different purposes. You can assign products or categories to create targeted marketing campaigns and display the relevant items on the storefront.

Deprecated endpoints

Overview

A new cart validation endpoint has been added to allow validating a cart without performing any modifications. Additionally, a new configuration setting has been introduced that allows skipping the validation of the existing cart items when a new item is added to the cart. The configuration improves performance for carts that include multiple items.

Added endpoints

New configuration settings

Known problems

There are no known problems.

Overview

All deprecations will be removed on 2025-10-01.

Deprecated endpoints

Known problems

There are no known problems.

Overview

The token responses was improved with new properties compliant with the OAuth 2.0 specification. Properties from the response accessToken, saasToken, expiresIn, refreshToken, refreshTokenExpiresIn are now deprecated in favor of the new properties (access_token, saas_token, expires_in, refresh_token, refresh_token_expires_in, token_type). All deprecations will be removed on 2025-11-13. From now, use the new token properties.

Updated endpoints

Known problems

There are no known problems.

Overview

The timezone field has been added to the site.homeBase request and response body. For now, this field is used by the Sequential ID Service to generate fallback values for placeholders such as:

• __year__

• __month__

• __day__

• __hour__

• __minute__

• __second__

Updated endpoints

Known problems

There are no known problems.

Overview

The Order Service has transitioned to using new calculated price attributes at both order and entry levels. The following changes have been implemented:

• New mandatory attributes: calculatedPrice (order level), calculatedPrice and calculatedUnitPrice (entry level).

• Previously used price attributes (totalPrice, unitPrice) are now marked as deprecated and optional.

• Backward compatibility is maintained - the API will continue to work if deprecated price attributes are provided without the new calculated price attributes.

These changes streamline price handling while ensuring existing integrations continue to function without disruption.

Updated endpoints

Known problems

There are no known problems.

Overview

Several fields in cart's response have been deprecated and are now replaced by calculatedPrice and unitPrice fields. The new fields provide a more comprehensive and consistent way to access price calculations.

Deprecated cart-level fields:

• totalPrice - use calculatedPrice.finalPrice instead

• subTotalPrice - use calculatedPrice.price or calculatedPrice.discountedPrice instead

• taxAggregate

Deprecated cart item-level fields:

• price - use unitPrice instead

• itemPrice - use unitPrice instead

• itemTaxInfo - use calculatedPrice.price

Updated endpoints

Known problems

There are no known problems.

Overview

Request body for creating or updating assets has been extended with new reference type - LABEL - which should be used to assign media to the labels.

Updated endpoints

Known problems

There are no known problems.

Overview

A new boolean attribute weightDependent has been added to the product model. It allows to mark the product as weight-dependent if the line item price can change after packaging. This is necessary to ensure that credit card payments can be authorized. Having the attribute available directly on the product level, the corresponding attribute weightDependent in Adding a product to cart API has been deprecated. The cart services checks the value specified on a product model and sets the weightDependent value on the cart item.

Updated endpoints

Known problems

There are no known problems.

Overview

A new lastLogin field has been added to the customer response, returning a date-time string. If the value is null, it indicates that the customer has not logged in since the field was introduced (14-02-2025).

Updated endpoints

Known problems

There are no known problems.

Overview

A new search endpoint has been added to the Price Service, allowing you to search for price lists using a request body instead of query parameters.

New endpoints

Known problems

There are no known problems.

Overview

New field vendorId was added to the price response payload. With the new scopes, vendor employees can now manage and view prices for products that belong to their vendor.

New scopes

• price.price_manage_by_vendor

• price.price_read_by_vendor

Modified endpoints

Known problems

There are no known problems.

Overview

Query param siteCode has been added to endpoints responsible for generating next ids. The siteCode is used to resolve certain placeholders. Placeholders such as __year__, __month__, __day__, __hour__, __minute__

Overview

All deprecations will be removed on 2025-10-01. From now, use the /coupon/ base path for all the to manage coupons and referral coupons.

Overview

A new tenant configuration option populateProductDetailsOnAddToCart has been added to the Cart Service. When enabled, the cart service will populate product details on the cart item:

• id

Overview

All previously deprecated endpoints are now removed ().

Removed endpoints & fields

Overview

The IAM Service was updated with validation for assigning customers to predefined groups. This ensures consistent role management within a company (Legal Entity) and provides clearer error handling for invalid assignments.

New validation rules:

• A customer can only be assigned to one predefined group (for example Admin, Buyer, Requester) within the same Legal Entity.

Overview

A new cartCalculationScale field has been added to the site setting. The field allows to control the number of decimal points in cart's calculatedPrice attributes.

Overview

We added a new API for managing and communicating with AI agents.

Added endpoints

Known problems

There are no known problems.

Overview

We added new API for managing custom schema types and custom instances. Custom schema types are custom entities on which you can build custom instances.

Added endpoints

Known problems

There are no known problems.

Overview

Several fields in order's response have been deprecated in favor of new calculatedPrice and unitPrice fields. The new fields provide a more comprehensive and consistent way to access price calculations.

Deprecated order-level fields:

• totalPrice - use calculatedPrice.finalPrice instead

• subTotalPrice - use calculatedPrice.price or calculatedPrice.discountedPrice instead

• taxAggregate

Deprecated order item-level fields:

• price - use unitPrice instead

• itemPrice - use unitPrice instead

• itemTaxInfo - use calculatedPrice.price

Updated endpoints

Known problems

There are no known problems.

Overview

Order was extended with new capabilities of splitting orders by vendor.

New attributes