Documentation Center

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

REST Webhooks

Guide v1.2

1. Integration Workflow

PackCPQ triggers secure HTTP callbacks (webhooks) to notify your local ERP database whenever quote profiles are finalized or margins parameters are adjusted on the dashboard.

2. Active Webhook Events

  • quote.created: Fired when a salesperson finalizes a folding box quote. Useful to import orders into your manufacturing pipelines.
  • margins.updated: Fired when board costs or shipping markups are updated. Used to sync parameters with billing ledgers.

3. Sample Payload Payload

Webhook callbacks transmit JSON data over POST. A sample structure for quote.created looks as follows:

{
  "event": "quote.created",
  "timestamp": "2026-07-15T11:00:00Z",
  "data": {
    "quote_id": "q_9F1A3B",
    "customer_id": "c_88C12",
    "plant_site": "Plant-Midwest",
    "pricing_summary": {
      "total_base_cost_usd": 850,
      "markup_rate": 1.35,
      "client_price_usd": 1147.5
    }
  }
}

4. Webhook Security Verification

Every payload request contains a custom header: X-PackCPQ-Signature. This signature is generated using a HMAC-SHA256 signature hash of the request body and your local webhook cryptographic secret. You must validate this signature inside your listening ERP script to verify authenticity.