combipower/tess-ai

Base Magento 2 REST APIs for the Combipower TESS AI integration.

Maintainers

Package info

github.com/combipower/tess-ai

Type:magento2-module

pkg:composer/combipower/tess-ai

Statistics

Installs: 3

Dependents: 0

Suggesters: 0

Stars: 0

Open Issues: 0

Security

Advisories: 0

Aikido package health analysis

1.1.4 2026-06-22 08:32 UTC

proprietary 3247446aeb0388c10f989af00bce357d9056bb86

This package is auto-updated.

Last update: 2026-06-23 04:42:03 UTC

README

Base Magento 2 module for the Combipower TESS AI REST integration.

Exposed endpoints

  • GET /rest/<store_code>/V1/tessAi/categories
  • GET /rest/<store_code>/V1/tessAi/filters
  • GET /rest/<store_code>/V1/tessAi/products
  • GET /rest/<store_code>/V1/tessAi/products/{sku}
  • POST /rest/<store_code>/V1/tessAi/prices — bulk update prices by SKU (sets has_tess_price)

Authentication

The API routes are protected by custom ACL resources:

  • Combipower_TessAI::read — all GET endpoints
  • Combipower_TessAI::write — the POST /V1/tessAi/prices bulk price update

The admin configuration section uses:

  • Combipower_TessAI::config

Use an integration token or admin token with the required permission.

Attribute Mapping Configuration

Product attribute codes used by the API are configurable in Admin:

  • Stores > Configuration > Combipower > TESS AI > Attribute Mapping

The module reads attribute codes from this configuration per store scope instead of hardcoded codes.

Shipping Cost Configuration

The API field shipping_cost is calculated by creating a temporary quote with the product quantity and collecting Magento shipping rates for the configured destination.

Configure the destination in Admin:

  • Stores > Configuration > Combipower > TESS AI > Shipping Estimate

Defaults are set to Netherlands:

  • Country: NL
  • Postcode: 1011AC
  • City: Amsterdam
  • Street: Dam 1

If Shipping Method Code is empty, the API uses the cheapest available shipping rate. To force one method, enter its Magento rate code, for example flatrate_flatrate.

Shipping Quote Attributes

shipping_cost is estimated by building a temporary quote. Carrier table rates and shipping restriction rules often depend on product dimensions/weight (e.g. length, width, height, weight). If those attributes are not loaded onto the quote product, the estimate evaluates the rules against empty values and may return a cheaper method than the real checkout.

Pick the attributes to load in Admin:

  • Stores > Configuration > Combipower > TESS AI > Shipping Estimate > Shipping Quote Attributes

Default: weight, length, width, height. Add any extra attribute your shipping rules depend on. Non-existing codes are ignored.

Activation

Install module via Composer:

composer config repositories.combipower/tess-ai vcs git@github.com:combipower/tess-ai.git
composer require combipower/tess-ai:dev-main

Then enable the module and register it with Magento:

php bin/magento module:enable Combipower_TessAI
php bin/magento setup:upgrade
php bin/magento setup:di:compile
php bin/magento cache:flush