$id: https://schema.beckn.io/Quote/v2.0
$schema: https://json-schema.org/draft/2020-12/schema
description: >
  A price quote generated by a BPP for a specific selection of offers and
  fulfillment options. Returned in on_select, on_init, and on_confirm responses.
  Aggregates item prices, taxes, delivery charges, and discounts into a total.
title: Quote
x-tags: [common]
type: object
properties:
  '@context':
    type: string
    format: uri
    const: "https://schema.beckn.io/"
  '@type':
    type: string
    const: beckn:Quote
  id:
    description: Unique identifier for this quote.
    type: string
    x-jsonld:
      '@id': schema:identifier
  price:
    description: Total quoted price (inclusive of all charges and discounts).
    type: object
    additionalProperties: false
    required:
    - currency
    - value
    properties:
      currency:
        description: ISO 4217 currency code.
        type: string
      value:
        description: Total amount.
        type: number
  breakup:
    description: Itemised breakdown of the total quoted price.
    type: array
    items:
      type: object
      additionalProperties: false
      required:
      - title
      - price
      properties:
        title:
          description: Human-readable label for this breakup line (e.g., "Margherita × 1", "Delivery charge", "GST").
          type: string
        type:
          description: Category of this breakup line.
          type: string
          enum:
          - ITEM
          - DELIVERY
          - TAX
          - DISCOUNT
          - CONVENIENCE_FEE
          - PLATFORM_FEE
          - TIP
          - OTHER
        price:
          type: object
          additionalProperties: false
          required:
          - currency
          - value
          properties:
            currency:
              type: string
            value:
              type: number
        offerId:
          description: Offer ID this line corresponds to (if type=ITEM).
          type: string
        itemId:
          description: Item ID this line corresponds to (if type=ITEM).
          type: string
        quantity:
          description: Quantity of the item in this line.
          type: integer
          minimum: 1
  validity:
    description: Validity window within which the quote is honoured.
    type: object
    additionalProperties: false
    properties:
      start:
        description: ISO 8601 date-time from which the quote is valid.
        type: string
        format: date-time
      end:
        description: ISO 8601 date-time after which the quote expires.
        type: string
        format: date-time
required:
- '@context'
- '@type'
additionalProperties: false