{
  "$id": "https://schema.nfh.global/Quote/v2.0",
  "x-iri": "https://schema.nfh.global/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": {
    "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": [],
  "additionalProperties": false
}