@deliverart/sdk-js-order 2.11.0 → 2.12.0

package/README.md

@@ -14,510 +14,483 @@ pnpm add @deliverart/sdk-js-order @deliverart/sdk-js-core
 
 ### Core Types
 
-#### OrderType
 ```typescript
 type OrderType = 'delivery' | 'take_away' | 'kitchen'
-```
-
-#### OrderStatus
-```typescript
 type OrderStatus = 'pending' | 'confirmed' | 'rejected'
-```
-
-#### OrderPreparationStatus
-```typescript
 type OrderPreparationStatus = 'to_prepare' | 'in_preparation' | 'done'
-```
-
-#### OrderSource
-```typescript
 type OrderSource = 'application' | 'ecommerce' | 'partner'
+type OrderPlanningMode = 'PLANNED' | 'FORCED'
 ```
 
 ### Models
 
-See the source code for complete model definitions including:
-- `Order` - Basic order information
-- `OrderDetails` - Extended order with items and customer info
-- `OrderMenuItem` - Menu item in an order
-- `OrderMenuItemModifier` - Modifier for a menu item
-- `OrderCustomerInfo` - Customer contact information
-- `OrderBillingInfo` - Billing information
-- `FeeSimulation` - Fee calculation results
-
-## Available Requests
-
-### Order Management
-
-#### CreateOrder
-Create a new order.
+- `Order`
+- `OrderDetails`
+- `DeliveryOrder`
+- `TakeAwayOrder`
+- `KitchenOrder`
+- `DeliveryOrderDetails`
+- `TakeAwayOrderDetails`
+- `KitchenOrderDetails`
+- `WritableOrder`
+- `WritableUpdateOrder`
+- `OrderMenuItem`
+- `OrderMenuItemDetails`
+- `OrderMenuItemModifier`
+- `OrderMenuItemModifierDetails`
+- `Bundle`
+- `BundleDetails`
+- `WritableBundle`
+- `FeeSimulation`
+- `OrderRescheduleWindow`
+- `OrderRescheduleOption`
+- `OrderRescheduleReferenceBundle`
+
+## Typed Inputs and Outputs
+
+`Order` and `OrderDetails` are discriminated by `type`.
+
+- `delivery` orders expose delivery-specific fields like `address`, `requestedDeliveryTime`, `finalDeliveryTime`, `deliveryStartedAt`, `deliveredAt`
+- `take_away` orders expose collection-specific fields like `requestedCollectionTime`, `finalCollectionTime`, `collectedAt`
+- `kitchen` orders exclude both delivery and collection scheduling fields
+- all order read models also expose scheduling metadata such as `scheduledWindowStart`, `scheduledWindowEnd`, `schedulingVersion` and `planningMode`
+- delivery read models additionally expose `estimatedRouteDurationSeconds`, `estimatedRouteDistanceMeters` and `stopSequence`
+
+`CreateOrderInput` and `CalculateOrderFeesInput` are also discriminated by `type`.
+
+- `delivery` accepts fields such as `address`, `customerAddress`, `locationData`, `referenceBundle`, `deliveryTime`
+- `take_away` accepts `collectionTime`
+- `kitchen` does not accept delivery or collection scheduling fields
+- all writable order inputs also accept `forceScheduling?: boolean` for internal operator-only retries that bypass slot/capacity validation
+
+`UpdateOrderInput` keeps common editable fields and enforces mutually exclusive delivery / take-away scheduling fields.
+
+## Order Requests
+
+### CreateOrder
 
 ```typescript
-import { CreateOrder } from '@deliverart/sdk-js-order';
-
-const order = await sdk.call(new CreateOrder({
-  type: 'delivery',
-  source: 'application',
-  pointOfSale: '/point_of_sales/123',
-  salesMode: '/sales_modes/456',
-  customer: '/customers/789',
-  customerInfo: {
-    firstName: 'John',
-    lastName: 'Doe',
-    email: 'john@example.com',
-    phoneNumber: '+39123456789'
-  },
-  billingInfo: {
-    businessName: 'Acme Corp',
-    vat: 'IT12345678901',
-    taxCode: 'RSSMRA80A01H501U',
-    billingAddress: {
-      street: 'Via Fatturazione 10',
+import { CreateOrder } from '@deliverart/sdk-js-order'
+
+const order = await sdk.call(
+  new CreateOrder({
+    type: 'delivery',
+    source: 'application',
+    pointOfSale: '/point_of_sales/123e4567-e89b-12d3-a456-426614174000',
+    customer: '/customers/123e4567-e89b-12d3-a456-426614174001',
+    customerInfo: {
+      firstName: 'John',
+      lastName: 'Doe',
+      email: 'john@example.com',
+      phoneNumber: '+39123456789',
+    },
+    address: {
+      line1: 'Via Roma 1',
       city: 'Milano',
       postalCode: '20100',
-      country: 'IT'
+      country: 'IT',
     },
-    billingData: {
-      recipientCode: 'ABCDEFG',
-      pec: 'billing@acmecorp.it'
-    }
-  },
-  address: {
-    street: 'Via Roma 1',
-    city: 'Milano',
-    postalCode: '20100',
-    country: 'IT',
-    location: {
-      latitude: 45.464664,
-      longitude: 9.188540
-    }
-  },
-  items: [
-    {
-      menuItem: '/menu_items/1',
-      quantity: 2,
-      price: 1500, // In cents
-      modifiers: [
-        {
-          menuItemModifier: '/menu_item_modifiers/1',
-          quantity: 1,
-          price: 200
-        }
-      ]
-    }
-  ],
-  deliveryTime: '2024-12-25T19:30:00+00:00',
-  notes: 'Please ring the bell'
-}));
-```
-
-**Input Parameters:**
-- `type: OrderType` (required) - Order type
-- `source: OrderSource` (required) - Order source
-- `pointOfSale: string` (required) - Point of sale IRI
-- `salesMode: string` (optional) - Sales mode IRI
-- `customer: string` (optional) - Customer IRI
-- `customerBusinessProfile: string` (optional) - Business profile IRI
-- `customerInfo: OrderCustomerInfo` (optional) - Customer contact info
-- `billingInfo: OrderBillingInfo` (optional) - Billing information (includes businessName, vat, taxCode, billingAddress, billingData)
-- `address: Address` (optional) - Delivery/collection address
-- `items: OrderMenuItem[]` (required) - Order items
-- `deliveryTime: string` (optional) - Requested delivery time (ISO 8601)
-- `collectionTime: string` (optional) - Requested collection time (ISO 8601)
-- `preparationTime: string` (optional) - Preparation time (ISO 8601)
-- `discount: string` (optional) - Discount amount in cents
-- `notes: string` (optional) - General notes
-- `deliveryNotes: string` (optional) - Delivery notes
-- `kitchenNotes: string` (optional) - Kitchen notes
-- `autoAccept: boolean` (optional) - Auto-accept order
-- `partner: string` (optional) - Partner identifier
-- `partnerIdentifier: string` (optional) - External partner order ID
-- `displayId: string` (optional) - Custom display ID
-
-**Response:** `OrderDetails`
-
----
-
-#### GetOrders
-Get paginated list of orders with filters.
-
-```typescript
-import { GetOrders } from '@deliverart/sdk-js-order';
-
-const orders = await sdk.call(new GetOrders({
-  query: {
-    'status[]': ['pending', 'confirmed'],
-    'type[]': ['delivery'],
-    pointOfSale: '/point_of_sales/123',
-    'order[createdAt]': 'desc',
-    page: 1
-  }
-}));
+    deliveryTime: '2026-03-22T19:30:00+01:00',
+    items: [
+      {
+        menuItem: '/menu_items/123e4567-e89b-12d3-a456-426614174002',
+        salesMode: null,
+        variant: null,
+        quantity: 2,
+        notes: 'No onions',
+        removals: [],
+        modifiers: [],
+      },
+    ],
+  }),
+)
 ```
 
-**Query Parameters:**
-- `status[]?: OrderStatus[]` - Filter by statuses
-- `type[]?: OrderType[]` - Filter by types
-- `pointOfSale?: string` - Filter by point of sale IRI
-- `customer?: string` - Filter by customer IRI
-- `createdAt[before]?: string` - Created before date
-- `createdAt[after]?: string` - Created after date
-- `order[createdAt]?: 'asc' | 'desc'` - Sort by creation date
-- `order[deliveryTime]?: 'asc' | 'desc'` - Sort by delivery time
-- `page?: number` - Page number
+Response: `OrderDetails`
 
-**Response:** `Paginated<Order>`
+Useful response fields after create/update
+- `scheduledWindowStart`
+- `scheduledWindowEnd`
+- `planningMode`
+- `schedulingVersion`
+- for `delivery`: `estimatedRouteDurationSeconds`, `estimatedRouteDistanceMeters`, `stopSequence`
 
----
+`planningMode` can be:
+- `PLANNED`
+- `FORCED`
 
-#### GetOrderDetails
-Get detailed information about a specific order.
+### CalculateOrderFees
 
 ```typescript
-import { GetOrderDetails } from '@deliverart/sdk-js-order';
+import { CalculateOrderFees } from '@deliverart/sdk-js-order'
 
-const order = await sdk.call(new GetOrderDetails('order-123'));
+const fees = await sdk.call(
+  new CalculateOrderFees({
+    type: 'take_away',
+    source: 'application',
+    pointOfSale: '/point_of_sales/123e4567-e89b-12d3-a456-426614174000',
+    collectionTime: '2026-03-22T20:00:00+01:00',
+    items: [
+      {
+        menuItem: '/menu_items/123e4567-e89b-12d3-a456-426614174002',
+        salesMode: null,
+        variant: null,
+        quantity: 1,
+        notes: null,
+        removals: [],
+        modifiers: [],
+      },
+    ],
+  }),
+)
 ```
 
-**Parameters:**
-- `orderId: string` (required)
+Response: `FeeSimulation`
 
-**Response:** `OrderDetails`
-
----
-
-#### GetPointOfSaleOrders
-Get orders for a specific point of sale.
+### GetOrders
 
 ```typescript
-import { GetPointOfSaleOrders } from '@deliverart/sdk-js-order';
-
-const orders = await sdk.call(new GetPointOfSaleOrders('pos-123', {
-  query: {
-    'status[]': ['pending'],
-    page: 1
-  }
-}));
+import { GetOrders } from '@deliverart/sdk-js-order'
+
+const orders = await sdk.call(
+  new GetOrders({
+    query: {
+      type: ['delivery', 'take_away'],
+      status: ['pending', 'confirmed'],
+      preparationStatus: 'to_prepare',
+      'order[createdAt]': 'desc',
+      page: 1,
+    },
+  }),
+)
 ```
 
-**Parameters:**
-- `pointOfSaleId: string` (required)
-- `query?: object` (optional) - Same as GetOrders query params
+Main query params
+- `type?: OrderType | OrderType[]`
+- `source?: OrderSource | OrderSource[]`
+- `status?: OrderStatus | OrderStatus[]`
+- `preparationStatus?: OrderPreparationStatus | OrderPreparationStatus[]`
+- `paymentMethod?: PaymentMethod | PaymentMethod[]`
+- `paymentStatus?: PaymentStatus | PaymentStatus[]`
+- `partner?: OrderPartner | OrderPartner[]`
+- `partnerIdentifier?: string | string[]`
+- `isRead?: boolean`
+- `exists[acceptedAt]?: boolean`
+- `exists[preparationEndedAt]?: boolean`
+- `exists[collectedAt]?: boolean`
+- `exists[deliveredAt]?: boolean`
+- `page?: number`
+
+Response: `Paginated<Order>`
+
+### GetOrderDetails
 
-**Response:** `Paginated<Order>`
+```typescript
+import { GetOrderDetails } from '@deliverart/sdk-js-order'
 
----
+const order = await sdk.call(new GetOrderDetails('123e4567-e89b-12d3-a456-426614174003'))
+```
 
-#### UpdateOrder
-Update an existing order (partial update).
+Response: `OrderDetails`
+
+### GetPointOfSaleOrders
 
 ```typescript
-import { UpdateOrder } from '@deliverart/sdk-js-order';
+import { GetPointOfSaleOrders } from '@deliverart/sdk-js-order'
 
-const updated = await sdk.call(new UpdateOrder('order-123', {
-  notes: 'Updated notes',
-  deliveryTime: '2024-12-25T20:00:00+00:00'
-}));
+const orders = await sdk.call(
+  new GetPointOfSaleOrders('123e4567-e89b-12d3-a456-426614174000', {
+    query: {
+      status: 'pending',
+      page: 1,
+    },
+  }),
+)
 ```
 
-**Parameters:**
-- `orderId: string` (required)
-- `input: Partial<OrderInput>` (required) - Fields to update
+Response: `Paginated<Order>`
 
-**Response:** `OrderDetails`
-
----
-
-#### ConfirmOrder
-Confirm a pending order.
+### GetCustomerOrders
 
 ```typescript
-import { ConfirmOrder } from '@deliverart/sdk-js-order';
+import { GetCustomerOrders } from '@deliverart/sdk-js-order'
 
-const confirmed = await sdk.call(new ConfirmOrder('order-123'));
+const orders = await sdk.call(
+  new GetCustomerOrders('123e4567-e89b-12d3-a456-426614174001', {
+    query: {
+      status: 'confirmed',
+      page: 1,
+    },
+  }),
+)
 ```
 
-**Parameters:**
-- `orderId: string` (required)
+Response: `Paginated<Order>`
 
-**Response:** `OrderDetails`
+### UpdateOrder
+
+```typescript
+import { UpdateOrder } from '@deliverart/sdk-js-order'
+
+const updated = await sdk.call(
+  new UpdateOrder('123e4567-e89b-12d3-a456-426614174003', {
+    notes: 'Updated notes',
+    deliveryTime: '2026-03-22T20:15:00+01:00',
+  }),
+)
+```
 
----
+Response: `OrderDetails`
 
-#### RejectOrder
-Reject a pending order.
+### GetOrderRescheduleOptions
 
 ```typescript
-import { RejectOrder } from '@deliverart/sdk-js-order';
+import { GetOrderRescheduleOptions } from '@deliverart/sdk-js-order'
 
-const rejected = await sdk.call(new RejectOrder('order-123', {
-  reason: 'Restaurant is closed'
-}));
+const windows = await sdk.call(
+  new GetOrderRescheduleOptions('123e4567-e89b-12d3-a456-426614174003', {
+    query: {
+      date: '2026-03-22',
+      includeInvalid: true,
+    },
+  }),
+)
 ```
 
-**Parameters:**
-- `orderId: string` (required)
-- `input: { reason: string }` (required)
+Query params
+- `date?: string`
+- `searchFrom?: string`
+- `includeInvalid?: boolean`
 
-**Response:** `OrderDetails`
+Response: `OrderRescheduleWindow[]`
 
----
+Each option contains:
+- `scheduledAt`
+- `rangeStart`
+- `rangeEnd`
+- `status`
+- `available`
+- `invalidReason`
+- `referenceBundles`
 
-#### AdvanceOrderPreparationStatus
-Advance the preparation status of an order.
+`status` can be:
+- `keep_current_bundle`
+- `create_new_bundle`
+- `move_to_reference_bundle`
+- `unavailable`
 
-```typescript
-import { AdvanceOrderPreparationStatus } from '@deliverart/sdk-js-order';
+`invalidReason` can be:
+- `store_closed`
+- `no_capacity`
+- `outside_lead_time`
+- `journey_outside_window`
 
-const advanced = await sdk.call(new AdvanceOrderPreparationStatus('order-123'));
-```
+### Lifecycle and Payment Requests
 
-**Parameters:**
-- `orderId: string` (required)
+```typescript
+import {
+  AdvanceOrderPreparationStatus,
+  ConfirmOrder,
+  MarkOrderAsCollected,
+  MarkOrderAsRead,
+  PayOrder,
+  RejectOrder,
+} from '@deliverart/sdk-js-order'
+
+await sdk.call(new ConfirmOrder('123e4567-e89b-12d3-a456-426614174003'))
+await sdk.call(new AdvanceOrderPreparationStatus('123e4567-e89b-12d3-a456-426614174003'))
+await sdk.call(new MarkOrderAsRead('123e4567-e89b-12d3-a456-426614174003'))
+await sdk.call(new MarkOrderAsCollected('123e4567-e89b-12d3-a456-426614174003'))
+await sdk.call(new RejectOrder('123e4567-e89b-12d3-a456-426614174003'))
+await sdk.call(new PayOrder('123e4567-e89b-12d3-a456-426614174003', 'cash'))
+```
 
-**Response:** `OrderDetails`
+Available requests
+- `ConfirmOrder`
+- `RejectOrder`
+- `AdvanceOrderPreparationStatus`
+- `MarkOrderAsRead`
+- `MarkOrderAsCollected`
+- `PayOrder`
+- `DeleteOrder`
+- `GetOrderRescheduleOptions`
+- `GenerateOrderBundle`
 
----
+## Order Menu Items
 
-#### MarkOrderAsRead
-Mark an order as read.
+### GetOrderMenuItems
 
 ```typescript
-import { MarkOrderAsRead } from '@deliverart/sdk-js-order';
+import { GetOrderMenuItems } from '@deliverart/sdk-js-order'
 
-await sdk.call(new MarkOrderAsRead('order-123'));
+const items = await sdk.call(
+  new GetOrderMenuItems({
+    query: {
+      type: ['ITEM', 'BUNDLE'],
+      action: 'add',
+      'order[createdAt]': 'desc',
+      page: 1,
+    },
+  }),
+)
 ```
 
-**Parameters:**
-- `orderId: string` (required)
+Response: `Paginated<OrderMenuItem>`
 
-**Response:** `void`
-
----
-
-#### DeleteOrder
-Delete an order.
+### GetOrderMenuItemDetails
 
 ```typescript
-import { DeleteOrder } from '@deliverart/sdk-js-order';
+import { GetOrderMenuItemDetails } from '@deliverart/sdk-js-order'
 
-await sdk.call(new DeleteOrder('order-123'));
+const item = await sdk.call(
+  new GetOrderMenuItemDetails('123e4567-e89b-12d3-a456-426614174004'),
+)
 ```
 
-**Parameters:**
-- `orderId: string` (required)
+Response: `OrderMenuItemDetails`
 
-**Response:** `void`
+### GetOrderMenuItemModifiers
 
----
+```typescript
+import { GetOrderMenuItemModifiers } from '@deliverart/sdk-js-order'
 
-#### CalculateOrderFees
-Calculate fees for an order before creation.
+const modifiers = await sdk.call(
+  new GetOrderMenuItemModifiers({
+    query: {
+      'order[createdAt]': 'desc',
+      page: 1,
+    },
+  }),
+)
+```
+
+Response: `Paginated<OrderMenuItemModifier>`
+
+### GetOrderMenuItemModifierDetails
 
 ```typescript
-import { CalculateOrderFees } from '@deliverart/sdk-js-order';
-
-const fees = await sdk.call(new CalculateOrderFees({
-  pointOfSale: '/point_of_sales/123',
-  salesMode: '/sales_modes/456',
-  billingInfo: {
-    businessName: 'Acme Corp',
-    vat: 'IT12345678901',
-    taxCode: 'RSSMRA80A01H501U',
-    billingAddress: {
-      street: 'Via Fatturazione 10',
-      city: 'Milano',
-      postalCode: '20100',
-      country: 'IT'
-    },
-    billingData: {
-      recipientCode: 'ABCDEFG',
-      pec: 'billing@acmecorp.it'
-    }
-  },
-  address: {
-    street: 'Via Roma 1',
-    city: 'Milano',
-    postalCode: '20100',
-    country: 'IT'
-  },
-  items: [
-    {
-      menuItem: '/menu_items/1',
-      quantity: 2,
-      price: 1500
-    }
-  ]
-}));
-
-console.log('Total fees:', fees.feeAmount);
-fees.fees.forEach(fee => {
-  console.log(`${fee.key}: ${fee.amount}`);
-});
+import { GetOrderMenuItemModifierDetails } from '@deliverart/sdk-js-order'
+
+const modifier = await sdk.call(
+  new GetOrderMenuItemModifierDetails('123e4567-e89b-12d3-a456-426614174005'),
+)
 ```
 
-**Parameters:**
-- Same as CreateOrder but only requires minimal fields
-- `billingInfo: OrderBillingInfo` (optional) - Billing information (includes billingAddress)
+Response: `OrderMenuItemModifierDetails`
 
----
+## Bundles
 
-### Order Items Management
+`Bundle` and `BundleDetails` are discriminated by `type`.
 
-#### AddOrderMenuItem
-Add a menu item to an existing order.
+- `REGULAR`
+- `FORCED`
 
-```typescript
-import { AddOrderMenuItem } from '@deliverart/sdk-js-order';
+Bundle read models also expose:
+- `capacityUsed`
+- `plannedStops`
+- `routeDurationSeconds`
+- `routeDistanceMeters`
+- `slackSeconds`
+- `plannerVersion`
 
-const item = await sdk.call(new AddOrderMenuItem('order-123', {
-  menuItem: '/menu_items/1',
-  quantity: 1,
-  price: 1500
-}));
+### CreateBundle
+
+```typescript
+import { CreateBundle } from '@deliverart/sdk-js-order'
+
+const bundle = await sdk.call(
+  new CreateBundle({
+    pointOfSale: '/point_of_sales/123e4567-e89b-12d3-a456-426614174000',
+    deliverable: true,
+    ready: false,
+  }),
+)
 ```
 
-#### UpdateOrderMenuItem
-Update a menu item in an order.
+Response: `BundleDetails`
+
+### GenerateOrderBundle
 
 ```typescript
-import { UpdateOrderMenuItem } from '@deliverart/sdk-js-order';
+import { GenerateOrderBundle } from '@deliverart/sdk-js-order'
 
-const updated = await sdk.call(new UpdateOrderMenuItem('item-123', {
-  quantity: 3
-}));
+const order = await sdk.call(
+  new GenerateOrderBundle('123e4567-e89b-12d3-a456-426614174003'),
+)
 ```
 
-#### DeleteOrderMenuItem
-Remove a menu item from an order.
+Response: `OrderDetails`
 
-```typescript
-import { DeleteOrderMenuItem } from '@deliverart/sdk-js-order';
+Use this only for orders that currently have no `bundle`.
 
-await sdk.call(new DeleteOrderMenuItem('item-123'));
-```
+### GetBundles
 
----
+```typescript
+import { GetBundles } from '@deliverart/sdk-js-order'
 
-### Bundles Management
+const bundles = await sdk.call(
+  new GetBundles({
+    query: {
+      status: ['pending', 'busy'],
+      type: 'REGULAR',
+      'order[createdAt]': 'desc',
+      page: 1,
+    },
+  }),
+)
+```
 
-Bundles group multiple orders for delivery optimization.
+Response: `Paginated<Bundle>`
 
-#### GetBundles
-Get list of bundles.
+### GetBundleDetails
 
 ```typescript
-import { GetBundles } from '@deliverart/sdk-js-order';
-
-const bundles = await sdk.call(new GetBundles({
-  query: {
-    'status[]': ['pending', 'busy'],
-    page: 1
-  }
-}));
+import { GetBundleDetails } from '@deliverart/sdk-js-order'
+
+const bundle = await sdk.call(new GetBundleDetails('123e4567-e89b-12d3-a456-426614174006'))
 ```
 
-## Complete Usage Example
+Response: `BundleDetails`
+
+### GetBundlesFromPointOfSale
 
 ```typescript
-import { sdk } from './lib/sdk';
-import {
-  CreateOrder,
-  GetOrders,
-  ConfirmOrder,
-  AdvanceOrderPreparationStatus,
-  CalculateOrderFees
-} from '@deliverart/sdk-js-order';
-
-async function orderWorkflow() {
-  // Calculate fees first
-  const fees = await sdk.call(new CalculateOrderFees({
-    pointOfSale: '/point_of_sales/123',
-    billingInfo: {
-      businessName: 'Acme Corp',
-      vat: 'IT12345678901',
-      taxCode: 'RSSMRA80A01H501U',
-      billingAddress: {
-        street: 'Via Fatturazione 10',
-        city: 'Milano',
-        postalCode: '20100',
-        country: 'IT'
-      },
-      billingData: {
-        recipientCode: 'ABCDEFG',
-        pec: 'billing@acmecorp.it'
-      }
-    },
-    items: [
-      { menuItem: '/menu_items/1', quantity: 2, price: 1500 }
-    ]
-  }));
-  
-  console.log('Estimated fees:', fees.feeAmount);
-
-  // Create order
-  const order = await sdk.call(new CreateOrder({
-    type: 'delivery',
-    source: 'application',
-    pointOfSale: '/point_of_sales/123',
-    customerInfo: {
-      firstName: 'John',
-      lastName: 'Doe',
-      email: 'john@example.com',
-      phoneNumber: '+39123456789'
-    },
-    billingInfo: {
-      businessName: 'Acme Corp',
-      vat: 'IT12345678901',
-      taxCode: 'RSSMRA80A01H501U',
-      billingAddress: {
-        street: 'Via Fatturazione 10',
-        city: 'Milano',
-        postalCode: '20100',
-        country: 'IT'
-      },
-      billingData: {
-        recipientCode: 'ABCDEFG',
-        pec: 'billing@acmecorp.it'
-      }
-    },
-    address: {
-      street: 'Via Roma 1',
-      city: 'Milano',
-      postalCode: '20100',
-      country: 'IT'
-    },
-    items: [
-      {
-        menuItem: '/menu_items/1',
-        quantity: 2,
-        price: 1500
-      }
-    ]
-  }));
+import { GetBundlesFromPointOfSale } from '@deliverart/sdk-js-order'
 
-  console.log('Order created:', order.id);
+const bundles = await sdk.call(
+  new GetBundlesFromPointOfSale('123e4567-e89b-12d3-a456-426614174000', {
+    query: {
+      ready: false,
+      page: 1,
+    },
+  }),
+)
+```
 
-  // Confirm order
-  const confirmed = await sdk.call(new ConfirmOrder(order.id));
-  console.log('Order confirmed');
+Response: `Paginated<Bundle>`
 
-  // Advance preparation status
-  await sdk.call(new AdvanceOrderPreparationStatus(order.id));
-  console.log('Preparation started');
+### UpdateBundle
 
-  // Get all pending orders
-  const pendingOrders = await sdk.call(new GetOrders({
-    query: {
-      'status[]': ['pending'],
-      'order[createdAt]': 'desc'
-    }
-  }));
+```typescript
+import { UpdateBundle } from '@deliverart/sdk-js-order'
 
-  console.log(`Found ${pendingOrders.pagination.totalItems} pending orders`);
-}
+const updated = await sdk.call(
+  new UpdateBundle('123e4567-e89b-12d3-a456-426614174006', {
+    ready: true,
+  }),
+)
 ```
 
+Response: `BundleDetails`
+
+Available requests
+- `CreateBundle`
+- `GetBundles`
+- `GetBundlesFromPointOfSale`
+- `GetBundleDetails`
+- `UpdateBundle`
+- `DeleteBundle`
+
 ## License
 
 MIT