Help
Changelog
Changes to the API, the SDK and these docs. Additive changes (new fields, events, codes) can arrive at any time; breaking changes get a new version.
7 November 2026
- Receiver choices. Shipments and tracking gain
receiverChanges(destination or fallback point changes and hold extensions made by the verified receiver) andoverstay(hold end, day rate, cap, amount due and payment state). - New events:
shipment.receiver_changed(data.receiver_change),shipment.overstay_startedandshipment.overstay_paid(data.overstay). Overstay is worked out automatically at pickup; a contract that covers overstay pays from your wallet up to its limit.
6 November 2026
- Relay Home Delivery bookable.
RELAY_HOMEquotes take the receiver's address (destinationAddressText,destinationPlaceIdordestinationPin) and an optionalfallbackLocationCode; without one, Qoene picks the nearest suitable Qoene Point. The price is the Relay route plus the area's home-delivery fee. Addresses outside a home-delivery area come back excluded withOUTSIDE_HOME_DELIVERY_AREA. - New events:
shipment.home_attempt_failedandshipment.redirected_to_point, withdata.home_delivery. After the one failed attempt, tracking follows the Relay Point steps at the fallback point.
5 November 2026
- Analytics.
GET /analytics/summaryreturns your own delivery performance (volume trend, on-time rate, delivery time by product and region, returns and claims rates, cost per parcel, overstay you covered and top destination regions) from hourly-rebuilt daily aggregates, with the new scopeanalytics.read. SDK:analytics.summary(). - WooCommerce plugin. Qoene Delivery for WooCommerce: rates, the Qoene Point picker, the order inbox, shipments, labels, tracking and returns. See the WooCommerce guide.
- New:
POST /ordersacceptscheckoutSelection: the signed widget choice is attached to the order once, and the ship run books its quote at the shopper's price while it is valid. Orders gaincheckout_selection_id; API orders in a WooCommerce store have sourceWOOCOMMERCE. - New:
GET /locations/searchacceptsaddressin place oflat/lng, with the position used ingeocoded. - Changed:
POST /shipmentsrefuses a selection attached to a LIVE order (409 CHECKOUT_SELECTION_ATTACHED): ship the order instead. TEST bookings withBUSINESS_INVOICEorBUSINESS_WALLETno longer fail with a 500.
4 November 2026
- Returns launched.
POST /returns,GET /returns,GET /returns/{returnId},POST /returns/quote,GET /returns/policyand approve, reject and cancel, with scopesreturns.readandreturns.write. See the returns guide. - New events:
return.requested,return.approved,return.rejected,return.cancelled,return.expired,return.dropped_off,return.in_transit,return.arrived,return.received,return.inspected,return.refund_recorded.EVENT_RESERVEDand501 RETURNS_NOT_AVAILABLEare gone. - SDK:
returns.list,listAll,create,get,quote,policy,approve,reject,cancel.
3 November 2026
- New: parcel claims.
POST /claims,GET /claims,GET /claims/{claimId}andPOST /claims/{claimId}/evidencewith scopesclaims.readandclaims.write. - New events:
claim.submitted,claim.under_review,claim.approved,claim.partly_approved,claim.rejected,claim.paid,claim.withdrawn. - SDK:
claims.list,claims.listAll,claims.create,claims.get,claims.addEvidence.
28 October 2026
- Checkout widget from
js.qoenedelivery.com: delivery options, promised dates and a Qoene Point picker inside your checkout, inline or as a popup. See the widget guide. - New: publishable keys (
qd_pk_…, locked to your websites),POST /checkout/sessions,POST /checkout/selections/verify,GET /checkout/keysand thecheckout.writescope. - New:
POST /shipmentsacceptscheckoutSelection(a signed widget selection) in place ofquoteId. - SDK:
qoene.checkout.*andverifyCheckoutSelection()for offline token checks.
27 October 2026
- Developer docs at developers.qoenedelivery.com, generated from the OpenAPI document: guides, full reference, webhooks and code in Node.js, cURL, PHP and Python.
@qoene/delivery0.1.0 TypeScript SDK (publishing to npm is being prepared).- New:
GET /declarations/prohibited-items, so API-only shops can confirm the current declaration. - Docs:
POST /quotes/optionsnow documents its own request (serviceCodes; noserviceorserviceVariant).
API v1
- Served at
api.qoenedelivery.com/v1with a public OpenAPI 3.1 document (51 operations, 56 webhook events). - Services, ranked point search, location detail, shipment list, store orders and ship runs, webhook endpoints by API key.
- Events
shipment.out_for_delivery,shipment.pickup_expiring,order.created,order.shipped,order.failed.
Versioning
The API version is in the path (/v1). Within v1 we only add: new endpoints, optional request fields, response fields, webhook events, milestone and error codes. Write your client to ignore unknown fields and handle unknown codes. Current document version: 1.0.0.