Documentation Center

Learn how to install, configure, and integrate the self-hosted PackCPQ engine.

Portal Integration

Customer Portal Setup

The Customer Portal allows packaging manufacturers to embed a self-service 3D carton and corrugated box configurator on their public websites. Customers can input dimensions, select materials, and view volume-break price estimates instantly.

1. HTML Embed Integration

Place the iframe embed script into your CMS template or HTML file. Custom theme adjustments can be made using query parameters:

<!-- Embed within your corporate website -->
<iframe
  src="https://cpq.yourcompany.com/portal/embed?theme=dark&primary=14b8a6"
  width="100%"
  height="650px"
  style="border: none; border-radius: 16px;"
  allow="accelerometer; autoplay; clipboard-write; encrypted-media; gyroscope;"
  id="packcpq-configurator"
></iframe>

<!-- Script to handle dynamic height and calculation events -->
<script>
  window.addEventListener('message', (event) => {
    if (event.origin === 'https://cpq.yourcompany.com') {
      console.log('Customer Quotation Cost Payload:', event.data);
    }
  });
</script>

2. Securing the Embed Route

Configure your security settings to avoid clickjacking by adding your domain to the ALLOWED_EMBED_ORIGINS variable inside the environment configuration file:

ALLOWED_EMBED_ORIGINS=https://yourcompany.com,https://portal.yourcompany.com
Margin Surcharges Notice

Pricing displayed in the embedded configurator is calculated using distinct public-tier margin configurations. Your internal factory floor costing rules and raw board price sheets remain secure and hidden.