💡 Introduction
The Seven Senders Orders API enables you to manage your e-commerce orders throughout their entire lifecycle, from creation to fulfillment and returns. This API serves as the foundation for order tracking and provides the necessary data for shipment creation and management.
What is an Order?
An order represents a customer purchase in your shop system and includes one or more products (order items) that need to be fulfilled. In Seven Senders, the order serves as the master record linking your shop data with shipment operations, enabling end-to-end visibility and tracking throughout the delivery process.
Key Capabilities
The Orders API provides comprehensive functionality to:
- Create and manage orders - Submit order data from your shop system to Seven Senders
- Track order items - Manage individual products within orders, including product details, pricing, and fulfillment status
- Monitor order states - Track order lifecycle events such as payment confirmation, production status, and returns
- Link orders to shipments - Connect orders with their corresponding shipments for unified tracking
- Handle order metadata - Store custom tags and additional information using flexible key-value pairs
Order Lifecycle
Orders in Seven Senders follow a defined lifecycle with specific states:
| Order State | Description |
|---|---|
| new | Order has been created but not yet paid |
| paid | Payment has been confirmed |
| in_production | Order is being manufactured or prepared |
| warehouse_handover | Order has been handed over to the warehouse |
| in_preparation | Order is being packed and prepared for shipment |
| returned | Order has been returned by the customer |
| refunded | Order has been refunded to the customer |
| cancelled | Order has been cancelled |
Relationship with Shipments
Orders and Shipments work together within the Seven Senders platform:
- An Order contains the product and customer purchase information
- A Shipment represents the physical delivery of those products
- One order can have multiple shipments (e.g., partial fulfillment, returns)
- The boarding_complete flag indicates when all shipments for an order have been created
Common Use Cases
- E-commerce Integration - Automatically sync orders from your shop system to Seven Senders
- Warehouse Management - Provide order data to warehouses for picking and packing
- Return Processing - Track returned items and update order states accordingly
- Customer Service - Access complete order history and status for customer inquiries
- Analytics and Reporting - Aggregate order data for business intelligence and reporting
Getting Started
To begin using the Orders API:
- Authenticate using your Seven Senders API credentials
- Create orders with the POST /orders endpoint, including order items
- Update order states as your fulfillment process progresses
- Link orders to shipments using the order_id reference
- Retrieve order data anytime using GET endpoints with flexible filtering options
API Resources
The Orders API provides three main resources:
- Orders - Create, retrieve, update, and delete orders
- Order Items - Manage individual products within orders
- Order States - Track and update order lifecycle states with timestamps
Each resource supports standard RESTful operations with comprehensive filtering and pagination capabilities.
This introduction provides context, explains the business value, and helps developers understand how to effectively use the Orders API within the Seven Senders platform.
Updated 1 day ago