docs: fix OAS generator + generate OAS

www/apps/api-reference/specs/admin/code_samples/Shell/admin_draft-orders_{id}/post.sh

@@ -0,0 +1,2 @@
+curl -X POST '{backend_url}/admin/draft-orders/{id}' \
+-H 'Authorization: Bearer {access_token}'

www/apps/api-reference/specs/admin/code_samples/Shell/admin_products_batch/post.sh

@@ -1,2 +1,7 @@
 curl -X POST '{backend_url}/admin/products/batch' \
--H 'Authorization: Bearer {access_token}'
+-H 'Authorization: Bearer {access_token}' \
+--data-raw '{
+  "delete": [
+    "prod_123"
+  ]
+}'

www/apps/api-reference/specs/admin/components/schemas/AdminCreateProduct.yaml

@@ -3,7 +3,6 @@ description: The product's details.
 x-schemaName: AdminCreateProduct
 required:
   - title
-  - shipping_profile_id
   - options
 properties:
   title:

www/apps/api-reference/specs/admin/components/schemas/AdminDraftOrder.yaml

@@ -0,0 +1,249 @@
+type: object
+description: The draft order's details.
+x-schemaName: AdminDraftOrder
+required:
+  - payment_collections
+  - items
+  - shipping_methods
+  - status
+  - currency_code
+  - id
+  - version
+  - region_id
+  - customer_id
+  - sales_channel_id
+  - email
+  - payment_status
+  - fulfillment_status
+  - summary
+  - created_at
+  - updated_at
+  - original_item_total
+  - original_item_subtotal
+  - original_item_tax_total
+  - item_total
+  - item_subtotal
+  - item_tax_total
+  - original_total
+  - original_subtotal
+  - original_tax_total
+  - total
+  - subtotal
+  - tax_total
+  - discount_total
+  - discount_tax_total
+  - gift_card_total
+  - gift_card_tax_total
+  - shipping_total
+  - shipping_subtotal
+  - shipping_tax_total
+  - original_shipping_total
+  - original_shipping_subtotal
+  - original_shipping_tax_total
+properties:
+  payment_collections:
+    type: array
+    description: The draft order's payment collections.
+    items:
+      $ref: ./AdminPaymentCollection.yaml
+  fulfillments:
+    type: array
+    description: The draft order's fulfillments.
+    items:
+      $ref: ./AdminOrderFulfillment.yaml
+  sales_channel:
+    $ref: ./AdminSalesChannel.yaml
+  customer:
+    $ref: ./AdminCustomer.yaml
+  shipping_address:
+    $ref: ./AdminOrderAddress.yaml
+  billing_address:
+    $ref: ./AdminOrderAddress.yaml
+  items:
+    type: array
+    description: The draft order's items.
+    items:
+      $ref: ./AdminOrderLineItem.yaml
+  shipping_methods:
+    type: array
+    description: The draft order's shipping methods.
+    items:
+      $ref: ./AdminOrderShippingMethod.yaml
+  status:
+    type: string
+    title: status
+    description: The draft order's status.
+  currency_code:
+    type: string
+    title: currency_code
+    description: The draft order's currency code.
+    example: usd
+  id:
+    type: string
+    title: id
+    description: The draft order's ID.
+  version:
+    type: number
+    title: version
+    description: The draft order's version.
+  region_id:
+    type: string
+    title: region_id
+    description: The ID of the region associated with the draft order.
+  customer_id:
+    type: string
+    title: customer_id
+    description: The ID of the customer that the draft order belongs to.
+  sales_channel_id:
+    type: string
+    title: sales_channel_id
+    description: The ID of the sales channel that the draft order is placed in.
+  email:
+    type: string
+    title: email
+    description: The customer email associated with the draft order.
+    format: email
+  display_id:
+    type: number
+    title: display_id
+    description: The draft order's display ID.
+  payment_status:
+    type: string
+    description: The draft order's payment status.
+    enum:
+      - not_paid
+      - awaiting
+      - authorized
+      - partially_authorized
+      - canceled
+      - captured
+      - partially_captured
+      - partially_refunded
+      - refunded
+      - requires_action
+  fulfillment_status:
+    type: string
+    description: The draft order's fulfillment status.
+    enum:
+      - canceled
+      - not_fulfilled
+      - partially_fulfilled
+      - fulfilled
+      - partially_shipped
+      - shipped
+      - partially_delivered
+      - delivered
+  transactions:
+    type: array
+    description: The draft order's transactions.
+    items:
+      $ref: ./BaseOrderTransaction.yaml
+  summary:
+    $ref: ./BaseOrderSummary.yaml
+  metadata:
+    type: object
+    description: The draft order's metadata, can hold custom key-value pairs.
+  created_at:
+    type: string
+    format: date-time
+    title: created_at
+    description: The date the draft order was created.
+  updated_at:
+    type: string
+    format: date-time
+    title: updated_at
+    description: The date the draft order was updated.
+  original_item_total:
+    type: number
+    title: original_item_total
+    description: >-
+      The total of the draft order's items including taxes, excluding
+      promotions.
+  original_item_subtotal:
+    type: number
+    title: original_item_subtotal
+    description: >-
+      The total of the draft order's items excluding taxes, including
+      promotions.
+  original_item_tax_total:
+    type: number
+    title: original_item_tax_total
+    description: The tax total of the draft order's items excluding promotions.
+  item_total:
+    type: number
+    title: item_total
+    description: The total of the draft order's items including taxes and promotions.
+  item_subtotal:
+    type: number
+    title: item_subtotal
+    description: >-
+      The total of the draft order's items excluding taxes, including
+      promotions.
+  item_tax_total:
+    type: number
+    title: item_tax_total
+    description: The tax total of the draft order's items including promotions.
+  original_total:
+    type: number
+    title: original_total
+    description: The draft order's total excluding promotions, including taxes.
+  original_subtotal:
+    type: number
+    title: original_subtotal
+    description: The draft order's total excluding taxes, including promotions.
+  original_tax_total:
+    type: number
+    title: original_tax_total
+    description: The draft order's tax total, excluding promotions.
+  total:
+    type: number
+    title: total
+    description: The draft order's total including taxes and promotions.
+  subtotal:
+    type: number
+    title: subtotal
+    description: The draft order's total excluding taxes, including promotions.
+  tax_total:
+    type: number
+    title: tax_total
+    description: The draft order's tax total including promotions.
+  discount_total:
+    type: number
+    title: discount_total
+    description: The draft order's discount or promotions total.
+  discount_tax_total:
+    type: number
+    title: discount_tax_total
+    description: The tax total of draft order's discount or promotion.
+  gift_card_total:
+    type: number
+    title: gift_card_total
+    description: The draft order's gift card total.
+  gift_card_tax_total:
+    type: number
+    title: gift_card_tax_total
+    description: The tax total of the draft order's gift card.
+  shipping_total:
+    type: number
+    title: shipping_total
+    description: The draft order's shipping total including taxes and promotions.
+  shipping_subtotal:
+    type: number
+    title: shipping_subtotal
+    description: The draft order's shipping total excluding taxes, including promotions.
+  shipping_tax_total:
+    type: number
+    title: shipping_tax_total
+    description: The tax total of the draft order's shipping.
+  original_shipping_total:
+    type: number
+    title: original_shipping_total
+    description: The draft order's shipping total including taxes, excluding promotions.
+  original_shipping_subtotal:
+    type: number
+    title: original_shipping_subtotal
+    description: The draft order's shipping total excluding taxes, including promotions.
+  original_shipping_tax_total:
+    type: number
+    title: original_shipping_tax_total
+    description: The tax total of the draft order's shipping excluding promotions.

www/apps/api-reference/specs/admin/components/schemas/AdminDraftOrderListResponse.yaml

@@ -0,0 +1,26 @@
+type: object
+description: The list of draft orders with pagination fields.
+x-schemaName: AdminDraftOrderListResponse
+required:
+  - limit
+  - offset
+  - count
+  - draft_orders
+properties:
+  limit:
+    type: number
+    title: limit
+    description: The maximum number of items retrieved.
+  offset:
+    type: number
+    title: offset
+    description: The number of items skipped before retrieving the returned items.
+  count:
+    type: number
+    title: count
+    description: The total count of items available.
+  draft_orders:
+    type: array
+    description: The list of draft orders.
+    items:
+      $ref: ./AdminDraftOrder.yaml

www/apps/api-reference/specs/admin/components/schemas/AdminDraftOrderResponse.yaml

@@ -5,4 +5,4 @@ required:
   - draft_order
 properties:
   draft_order:
-    $ref: ./AdminOrder.yaml
+    $ref: ./AdminDraftOrder.yaml