Overview
What is the ConnectorSession?
The ConnectorSession is an immutable value object that holds all relevant data for an active punchout session. It is created as soon as a buyer enters the shop via a procurement system, and persists until the cart is transferred or the session is ended.
Internally the session is serialized and stored in the PHP/Symfony session under the key agiqon_connector.connector_session. This makes it available across multiple requests without requiring a database query.
Session fields
| Field | Type | Description |
|---|---|---|
system | string|null | Technical name of the connector system |
systemId | string|null | UUID of the connector system |
systemType | ConnectorSystemType|null | Protocol type: OCI or cXML |
hookUrl | string|null | Return URL of the procurement system (where the cart will be sent) |
transmissionId | string|null | UUID of the underlying transmission |
transmissionMode | ConnectorTransmissionMode | Transfer mode (default: manual) |
additionalFields | array<string, mixed> | Arbitrary extra data from the transmission (e.g. operation, isPunchoutLevel2) |
TransmissionMode
The transmissionMode controls how the cart is transferred:
| Value | Description |
|---|---|
manual | The buyer transfers the cart manually via a button in the shop |
auto | The cart is transferred automatically (e.g. directly when adding an item) |