OCI – Overview
OCI (Open Catalog Interface) is an SAP standard for product catalog integration. The AgiqonConnector supports OCI 4 (form/input structure) and OCI 5 (JSON structure).
How OCI Punchout Works
Procurement System → Login URL → Shopware Shop
↑ ↓
└──────── Cart (POST/GET) ──────────┘
- The procurement system calls the shop's login URL with username, password, and
HOOK_URL. - The user is automatically logged in and can shop.
- At checkout, the plugin sends the cart items back to the
HOOK_URLvia POST form or JSON.
Login URL
https://yourshop.com/AgiqonOciEntry/login
Parameters
| Parameter | Default Variable Name | Description |
|---|---|---|
| Username | USERNAME | Customer e-mail address |
| Password | PASSWORD | Customer password |
| Hook URL | HOOK_URL | Return URL of the procurement system |
| Token | TOKEN | Optional token (alternative to password) |
info
Variable names can be customized per system.
Logout URL
https://yourshop.com/AgiqonOciEntry/logout
OCI Versions
| Version | Transfer Format | Usage |
|---|---|---|
| OCI 4 | HTML form (POST) | Classic, widely supported |
| OCI 5 | JSON | Modern, for newer systems |