README

Magento 2 module that integrates Unit4 Multivers ERP pricing into the conneqt/module-special-prices framework. It calls the Multivers CalcSpecPriceCommand REST API to retrieve customer-specific prices and plugs in via PriceCalculatorInterface.

Requirements

• PHP >= 8.1
• conneqt/module-special-prices ^1.6
• guzzlehttp/guzzle ^7.11

Installation

composer require conneqt/module-multivers-special-prices
bin/magento module:enable Conneqt_MultiversSpecialPrices
bin/magento setup:upgrade
bin/magento setup:di:compile

Configuration

Stores > Configuration > Conneqt > Multivers Special Prices

Use Test Connection in the API group to verify credentials without leaving the config screen.

Customer attribute

A data patch (AddMultiversCustomerIdAttribute) creates the multivers_customer_id varchar attribute on the customer entity and makes it available in the admin customer grid and edit form. Populate it per-customer with the matching Multivers customer ID.

How it works

1. PriceCalculator::calculate() resolves the Multivers customer ID from the configured attribute and the product ID from the configured attribute (fallback: SKU).
2. It calls CalcSpecPriceCommand via PriceApi.
3. Price resolution: if price > 0 use it directly; if discount > 0 derive from base price; otherwise return base price.
4. The parent module's ResultCache plugin handles Redis caching of results — no duplication here.
5. The OAuth bearer token is cached in Magento's config cache pool, respecting the expires_in TTL from the token response.
6. Tier prices are not supported (CalcSpecPriceCommand is single-qty only); calculateTierPrices returns null to let the base module fall through.

API endpoint

POST api/{database}/CalcSpecPriceCommand
  ?customerId={customerId}
  &productId={productId}
  &currencyId={currencyId}
  &quantity={quantity}
  &orderDate={orderDate}
  &vatIncluded={0|1}
  &projectId={projectId}

Response: { "discount": float, "price": float, "stockTransferPrice": float }