nShift Shipping Adapter
Overview
The nShift Adapter integrates nShift Delivery Checkout with Norce Checkout, enabling merchants to offer a flexible and carrier-agnostic delivery experience directly within the Norce Commerce platform. nShift provides an embedded checkout widget that allows customers to select from multiple delivery options such as home delivery, pickup points, and time-slot–based delivery across different carriers.
This adapter is part of Norce Checkout (NCO) and manages the complete shipping lifecycle – from session initialization to order completion. Changes made in Norce Checkout are automatically synchronized with nShift and vice versa, ensuring both systems remain consistent throughout the checkout flow.
When an order is accepted, the adapter creates a partial shipment in nShift, enabling tracking and fulfilment through nShift’s logistics platform.
Capabilities and Supported Flows
Shipping Operations
| Feature | Full | Partial | Description |
|---|---|---|---|
| Create Session | Yes | — | Initialize nShift checkout session |
| Update Session | Yes | — | Sync cart and customer changes |
| Complete Session | Yes | — | Create partial shipment on order acceptance |
| Remove Session | Yes | — | Remove shipping from order |
Supported Delivery Methods
| Method | Supported | Description |
|---|---|---|
| Home Delivery | Yes | Standard carrier home delivery |
| Pickup Points | Yes | Service points, lockers, stores |
| Scheduled Delivery | Yes | Time-slot based delivery windows (carrier dependent) |
| Multiple Carriers | Yes | Based on merchant configuration in nShift |
Advanced Features
| Feature | Supported | Description |
|---|---|---|
| B2B Support | Yes | Business customer checkout |
| B2C Support | Yes | Consumer checkout |
| Bidirectional Sync | Yes | Norce ↔ nShift synchronization |
| Carrier Addons | Yes | Carrier-specific extra services |
| Logistics Data Mapping | Yes | Weight, dimensions, package contents |
| Pickup Point Details | Yes | Full pickup point address and metadata |
| Delivery Time Estimates | Yes | Earliest/latest delivery dates |
| Custom Fields | Yes | Carrier-specific customer input fields |
| OAuth2 Authentication | Yes | Automatic token handling and refresh |
| Connection-based Routing | Yes | Merchant routing using nShift Connection ID |
Integration Model
The adapter uses a widget-based checkout model:
- Norce Checkout provides order, cart, customer, currency, and locale data to the adapter.
- The adapter creates and maintains a session in nShift.
- The nShift Checkout widget is embedded in the merchant’s frontend and displays delivery options.
- Customer selections (delivery option, pickup point, time slot, addons, and custom fields) are sent back to Norce Checkout through adapter callback endpoints.
- When the order is accepted, the adapter finalizes the session by creating a partial shipment in nShift.
All synchronization hooks are registered automatically when the session is created.
Limitations
- Orders must contain country, culture, and currency before a session can be created.
- The cart must contain at least one item.
- Checkout sessions have a limited lifetime and may expire.
- Available delivery methods and carriers depend on the merchant’s configuration in the nShift platform.
- Carrier pricing and delivery options are controlled by nShift configuration.
Shipping States
The adapter uses the following shipping states in Norce Checkout:
| State | Description |
|---|---|
intent | Shipping session created, awaiting customer selection |
processing | Order is being processed, session validated |
confirmed | Session completed successfully, partial shipment created |
removed | Shipping removed from order |
Architecture Notes
- Authentication towards nShift is handled using OAuth2 client credentials flow.
- Access tokens are cached and refreshed automatically by the adapter.
- Merchant configuration is resolved using a Connection ID provided by nShift, which determines available carriers, delivery options, and pricing rules.
- The adapter automatically registers callbacks for:
- Cart changes
- Customer updates
- Order state transitions
Links and References
Norce Checkout API References
nShift Adapter API
Norce Checkout Overview
- Norce Checkout Introduction
- Working with Norce Checkout
- Shipping Adapters Overview
- nShift Adapter Developer Guide