Orders

Authentication

Any Partner application responsible for accessing order data and monitoring fulfillment status must be authorized to interact with the Orders endpoint, which requires a valid bearer token in the request headers. This token is obtained by authenticating through the Authentication service.

Concepts

• Order entity represents the collection of items ordered by the end customer (cart). ​ The end customer makes a single pre-authorization, from which each completed shipment will capture the due amount.​

• Fulfillment is a logical entity that represents the process of satisfying part or all of a customer order. A single order can generate multiple fulfillments if items are sourced from different locations or shipped at different times.

Payment

Each fulfillment corresponds to a payment capture, so that the customer is only charged for the items actually shipped.

• Package entity represents the logistical concept of a parcel. Multiple packages can be associated with a single shipment, as certain products are so exclusive that they cannot be placed in the same package. ​ A successful capture generates a security token for each package, which must be presented to the concierge to formally register the receipt of goods at the facility. The boutique is responsible for the release of goods from its location, which must not occur before capture and the generation of Manna documents.​

Order Identifier

Every order is assigned a composite identifier made up of four segments, separated by hyphens.

Segment	Description
tenant	Logical area that owns the order.
YYMM	Two-digit year and two-digit month of order creation.
ext_partner_id	The issuer partner that originated the order (e.g. concierge, lounge consultant, personal shopper).
sequence	Progressive counter, global across all partners, ranging from 000001 to 999999.

Example: 1-2603-1-000001 — tenant 1 (Milano), March 2026, partner 1 (e.g. The Plein Hotel), first order in sequence.

Rate limiting

Environment	Requests / min	Entities / min
Dev/Quality	∞	∞