Installation
Requirements
| Connector | Shopware | PHP |
|---|---|---|
| 3.7.x (currently 3.7.500) | 6.7 | ≥ 8.2 |
| 3.6.x (currently 3.6.300) | 6.6 | ≥ 8.2 |
A valid license key is also required (available at agiqon-connector.de).
Both the Shopware Store and Composer automatically install the plugin variant matching your shop version — the installation command is identical for Shopware 6.6 and 6.7.
Install the Plugin
Via the Shopware Store
- Log in to the Shopware Administration backend.
- Navigate to Extensions → Store.
- Search for "AgiqonConnector" and click Install.
Manually via Composer
composer require store.shopware.com/agiqonconnector
bin/console plugin:install --activate AgiqonConnector
bin/console cache:clear
After Installation
After installation, the following menu items are available in the Shopware Admin:
Connector
└─ Dashboard
└─ OCI Systems
└─ cXML Systems
└─ Transmissions
Scheduled Tasks
The connector registers a scheduled task that removes the temporary guest customers of expired punchout sessions once a day. Since 3.7.400 / 3.6.200 this cleanup runs as a scheduled task — previously it ran along with every login.
For the task to be executed, the Shopware scheduler must be running:
bin/console scheduled-task:run
In production setups this is usually handled by the permanently running worker. The status can be checked in the admin under Settings → System → Tasks.
If the scheduler is not running, temporary guest customers are no longer removed and accumulate permanently in the customer administration.
Enter Client Authentication
The plugin requires authentication via client credentials, which must be entered after installation.
The client credentials can be found at agiqon-connector.de → My Account → Licenses
- Log in to the Shopware Administration backend.
- Navigate to Extensions → My Extensions.
- Click the three dots next to the AgiqonConnector plugin and select Configure.
- Enter the client credentials (Client ID and Client Secret) and save.
- Test the API connection to ensure that authentication is successful.
Update the Plugin
bin/console plugin:update AgiqonConnector
bin/console cache:clear
bin/console database:migrate --all AgiqonConnector
This release contains changes that can affect existing integrations:
- Shipping method extension renamed (
ociShippingMethod→connectorShippingMethod). Custom integrations have to be adjusted — see Shipping Methods. - cXML field filters take effect again and therefore change the generated XML — see cXML – Configure Fields.
- OCI logins require a matching customer assignment, otherwise they are rejected — see OCI – Customers & Units.
- Deactivated customer accounts can no longer log in via token.
The full list is in the changelog.
The corrected field filter (substring and number format) does not take effect automatically on existing installations. Open the pre-installed OCI system once in the admin and re-save the fields vendormat, matgroup and quantity so that the configured filters are applied again. New installations are not affected.