OCI (Open Catalog Interface) is the SAP-derived punchout protocol used by Basware and similar systems. New buyers point their system at the generic endpoint; Glede resolves your identity from the credential.
Setup endpoint
POST https://api.glede.app/oci/punchout/setup (production)
POST https://sandbox.api.glede.app/oci/punchout/setup (sandbox)
Content-Type: application/x-www-form-urlencoded
Setup request fields
Field names are matched case-insensitively.
| Field | Required | Description |
|---|---|---|
USERNAME | yes | Buyer identifier — provided by Glede |
PASSWORD | yes | Shared secret — provided by Glede |
HOOK_URL | yes | Where Glede POSTs the finished cart. Host must be on your allowlist |
RETURN_URL | no | Optional return target |
BUYER_COOKIE | no | Opaque buyer-side token, echoed back on cart-return |
~OPERATION | no | OCI operation hint |
Response: Glede creates a session and redirects (HTTP 302) the browser to https://www.send.glede.app/punchout/<token> where the buyer shops.
Cart return
When the buyer checks out, Glede renders an auto-submitting HTML form that POSTs to your HOOK_URL with one set of fields per line (1-indexed):
| Field | Example | Notes |
|---|---|---|
NEW_ITEM-DESCRIPTION[n] | Glede gavekort til Maria Olsen | |
NEW_ITEM-QUANTITY[n] | 1 | Always 1 per recipient line |
NEW_ITEM-UNIT[n] | EA | |
NEW_ITEM-PRICE[n] | 500.00 | Face value + service fee, net of VAT |
NEW_ITEM-CURRENCY[n] | NOK | |
NEW_ITEM-MATNR[n] | GLEDE-GIFTCARD | Material number |
NEW_ITEM-VENDOR[n] | 930059884 | Glede AS org. number |
NEW_ITEM-VENDORMAT[n] | <sessionId>:<lineId> | Reconciliation key for the returning PO |
NEW_ITEM-LONGTEXT_n:132[] | recipient name, email, phone, send time, message | Human-readable details |
Limits: up to 500 line items per cart; session valid for 4 hours.
PO transmission: confirm with Glede whether the approved order returns via cXML or OCI — this is configured per buyer during onboarding.