Order — User Stories¶
User stories related to the Order domain: PostNL shipment label creation and order notifications.
| ID | Story | Role |
|---|---|---|
| US-O01 | Create a PostNL track & trace code and shipment label | Employee |
| US-O02 | Receive an order confirmation email | Customer |
Shipment¶
US-O01 · Create a PostNL Track & Trace Code and Shipment Label¶
User Story
As an employee, I want to create a PostNL track & trace code with a shipment label for a specific order, so that I can hand it off to PostNL for delivery.
Acceptance Criteria
- I can create a PostNL shipment for an order from the order detail page in the back office.
- I can select the applicable PostNL shipment option before generating the label.
- After successful creation, I receive a track & trace code linked to the order.
- The generated shipment label (PDF) is available for download and printing.
- The track & trace code is stored on the order and visible to the customer in their order overview.
- If the PostNL API call fails, I receive a clear error message and no label is created.
The following PostNL shipment options are supported:
PostNL Standaard
| Property | Value |
|---|---|
| Product code | 3085 |
| Delivery | Home delivery, daytime |
| Signature | No |
| Max weight | 30 kg |
Suitable for standard parcels without additional service requirements.
PostNL Handtekening voor ontvangst
| Property | Value |
|---|---|
| Product code | 3089 |
| Delivery | Home delivery with signature |
| Signature | Yes |
| Max weight | 30 kg |
Suitable for valuable or sensitive parcels requiring proof of receipt.
PostNL Avondlevering
| Property | Value |
|---|---|
| Product code | 3096 |
| Delivery | Home delivery, evening (18:00–22:30) |
| Signature | No |
| Max weight | 30 kg |
Suitable when the customer prefers evening delivery.
Notes
- PostNL integration is handled via the PostNL API from the Zwerfkei Backend.
- Additional PostNL product codes and options can be added as the integration is extended.
- Label generation requires a valid delivery address on the order.
Notifications¶
US-O02 · Receive an Order Confirmation Email¶
User Story
As a customer, I want to receive an email when my order is confirmed, so that I have written confirmation of what I ordered and can track the status.
Acceptance Criteria
- Immediately after order placement and payment confirmation, I receive an order confirmation email at the address I provided.
- The email contains: order number, order date, list of ordered products (with quantities and prices), selected fulfillment method, delivery address, and total amount paid.
- The email is sent in the language of the customer's preference (NL/EN).
- The email is sent from the configured Zwerfkei sender address and uses the brand template.
- If the email fails to send, the failure is logged and retried automatically.
Notes
- Triggered by the
OrderConfirmedevent in the Order domain. - Email delivery is handled via the mail service configured in the Zwerfkei Backend (e.g. SMTP / transactional mail provider).