> ## Documentation Index
> Fetch the complete documentation index at: https://docs.vortexiq.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# Connect PrestaShop to Vortex IQ

> Connect PrestaShop to Vortex IQ for 46 KPI cards, plus cross-platform Vortex Mind diagnostics.

Connecting PrestaShop to Vortex IQ gives the AI OS a live read on your PrestaShop data, feeding the Nerve Centre dashboard, Vortex Mind diagnostics, and Ask Viq.

## What data Vortex IQ reads from PrestaShop

* **Order**
* **OrderDetail**
* **Product**
* **StockAvailable**
* **Customer**

## How to connect

<Note>
  PrestaShop uses credential-based authentication rather than OAuth. You provide these values directly rather than approving a redirect.
</Note>

<Steps>
  <Step title="Open Connected Sources">
    In your Vortex IQ workspace, go to **Settings → Connected Sources**. You need Admin role in the workspace to connect sources.
  </Step>

  <Step title="Find the PrestaShop card">
    Locate the PrestaShop connector card and click **+ Connect**. The connector drawer opens with a credential form.
  </Step>

  <Step title="Gather your credentials from PrestaShop">
    You will need:

    * **Store URL**: Storefront base URL, e.g. [https://shop.example.com](https://shop.example.com) - the Webservice lives at {store_url}/api.
    * **Webservice API Key**: Advanced Parameters → Webservice → Add new key. Grant GET on orders, order\_details, products, stock\_availables, customers, addresses, currencies, order\_states. Sent as HTTP Basic username, empty password.
    * **PrestaShop Version**: 1.6 supported on request; 1.7 and 8.x are the build focus.
    * **Hosting Mode**: self\_hosted = merchant infrastructure; hosted\_cloud = PrestaShop Cloud (Hosted).
    * **Read-only DB DSN (optional)**: Optional read-only MySQL DSN for fields the Webservice does not expose (stock movements, derived OSS/VAT views). PrestaShop stays system of record.
  </Step>

  <Step title="Enter credentials in Vortex IQ">
    Paste each value into its matching field in the connector drawer.
  </Step>

  <Step title="Verify and connect">
    Click **Verify and Connect**. Vortex IQ makes a test API call to validate the credentials before saving them.
  </Step>
</Steps>

<Note>
  Vortex IQ only ever requests read-only access. Where PrestaShop offers scoped or read-only API keys, use one.
</Note>

## Available KPI cards

Vortex IQ populates **46** Nerve Centre cards from your PrestaShop data. See the [PrestaShop KPI card reference](/nerve-centre/kpi-cards/prestashop) for the full list with definitions, calculations, and sentiment bands.

## Troubleshooting

<AccordionGroup>
  <Accordion title="Credential verification fails">
    Re-check each value against the PrestaShop developer console for typos or trailing whitespace. If a scope or permission is missing, PrestaShop will typically return a 401 or 403 on the verification call rather than a generic failure.
  </Accordion>

  <Accordion title="Cards show no data after connecting">
    Allow time for the first sync to complete; large accounts can take longer. If cards are still empty after an hour, disconnect and reconnect to confirm the credentials were saved correctly.
  </Accordion>
</AccordionGroup>