{
  "$id": "https://fddschema.org/schema/v1.0/items/item20-outlets-and-franchisee-information.json",
  "title": "Item 20: Outlets and Franchisee Information",
  "description": "Statistical information on the number of franchised and company-owned outlets for the preceding three-year period, as well as other certain information concerning the franchise system. Some disclosures under Item 20 must be provided in a prescribed tabular format, and others may be provided simply with text.",
  "type": "object",
  "properties": {
    "table1_systemwideOutletSummary": {
      "type": "object",
      "description": "Table 1 – Systemwide Outlet Summary for last 3 fiscal years.",
      "properties": {
        "franchisedOutlets": {
          "type": "array",
          "description": "Franchised Outlets data for the last 3 fiscal years",
          "items": {
            "$ref": "../definitions/item20-table1Row.json"
          },
          "minItems": 3,
          "maxItems": 3
        },
        "companyOwnedOutlets": {
          "type": "array",
          "description": "Company Owned Outlets data for the last 3 fiscal years",
          "items": {
            "$ref": "../definitions/item20-table1Row.json"
          },
          "minItems": 3,
          "maxItems": 3
        },
        "total": {
          "type": "array",
          "description": "Total Outlets data for the last 3 fiscal years",
          "items": {
            "$ref": "../definitions/item20-table1Row.json"
          }
        }
      },
      "required": ["franchisedOutlets", "companyOwnedOutlets", "total"]
    },
    "table2_transfersOfOutlets": {
      "type": "object",
      "description": "Table 2 – Transfers of Outlets From Franchisees to New Owners (Other than Franchisor) for last 3 fiscal years.",
      "properties": {
        "statesData": {
          "type": "array",
          "description": "List of states where transfers occurred",
          "items": {
            "type": "object",
            "properties": {
              "state": {
                "type": "string",
                "description": "The state where the transfers occurred",
                "examples": ["Florida", "New York"]
              },
              "data": {
                "type": "array",
                "description": "Data for each of the last 3 fiscal years",
                "items": { "$ref": "../definitions/item20-table2Row.json" },
                "minItems": 3,
                "maxItems": 3
              }
            },
            "required": ["state", "data"]
          }
        },
        "total": {
          "type": "array",
          "description": "Total transfers for each of the last 3 fiscal years",
          "items": { "$ref": "../definitions/item20-table2Row.json" },
          "minItems": 3,
          "maxItems": 3
        }
      },
      "required": ["statesData", "total"]
    },
    "table3_franchisedOutletsStatus": {
      "type": "object",
      "description": "Table 3 – Status of Franchised Outlets for last 3 fiscal years.",
      "properties": {
        "statesData": {
          "type": "array",
          "description": "List of states and their franchised outlets status for last 3 fiscal years",
          "items": {
            "type": "object",
            "properties": {
              "state": {
                "type": "string",
                "description": "The state for which the data is reported",
                "examples": ["California", "Texas"]
              },
              "data": {
                "type": "array",
                "description": "Data for each of the last 3 fiscal years",
                "items": { "$ref": "../definitions/item20-table3Row.json" },
                "minItems": 3,
                "maxItems": 3
              }
            },
            "required": ["state", "data"]
          }
        },
        "total": {
          "type": "array",
          "description": "Total franchised outlets status for each of the last 3 fiscal years",
          "items": { "$ref": "../definitions/item20-table3Row.json" },
          "minItems": 3,
          "maxItems": 3
        }
      }
    },
    "table4_companyOwnedOutletsStatus": {
      "type": "object",
      "description": "Table 4 – Status of Company-Owned Outlets for last 3 fiscal years.",
      "properties": {
        "statesData": {
          "type": "array",
          "description": "List of states and their company owned outlets status for last 3 fiscal years",
          "items": {
            "type": "object",
            "properties": {
              "state": {
                "type": "string",
                "description": "The state for which the data is reported",
                "examples": ["Ohio", "Michigan"]
              },
              "data": {
                "type": "array",
                "description": "Data for each of the last 3 fiscal years",
                "items": { "$ref": "../definitions/item20-table4Row.json" },
                "minItems": 3,
                "maxItems": 3
              }
            },
            "required": ["state", "data"]
          }
        },
        "total": {
          "type": "array",
          "description": "Total company owned outlets status for each of the last 3 fiscal years",
          "items": { "$ref": "../definitions/item20-table4Row.json" },
          "minItems": 3,
          "maxItems": 3
        }
      }
    },
    "table5_projectedOpenings": {
      "type": "object",
      "description": "Projected Openings as of last fiscal year-end.",
      "properties": {
        "statesData": {
          "type": "array",
          "description": "List of states with projected data",
          "items": {
            "type": "object",
            "properties": {
              "state": {
                "type": "string",
                "description": "The state for which the data are reported",
                "examples": ["Washington", "Oregon"]
              },
              "data": { "$ref": "../definitions/item20-table5Row.json" }
            },
            "required": ["state", "data"]
          }
        },
        "total": { "$ref": "../definitions/item20-table5Row.json" }
      },
      "required": ["statesData", "total"]
    },
    "currentFranchisees": {
      "type": "array",
      "description": "A list of current franchisees and their contact information.",
      "items": {
        "type": "object",
        "properties": {
          "name": {
            "type": "string",
            "description": "The name of the franchisee or franchisee business entity",
            "examples": ["ABC Franchising LLC", "John Doe"]
          },
          "address": {
            "$ref": "../definitions/postal-address.json"
          },
          "phone": {
            "type": "string",
            "description": "The business phone number. If there is not a separate telephone number for the franchisee’s business, a franchisor may disclose a valid email address as a substitute."
          },
          "email": {
            "type": "string",
            "format": "email",
            "description": "The email address required only if there is not a separate business telephone number."
          }
        },
        "required": ["name", "address"],
        "anyOf": [{ "required": ["phone"] }, { "required": ["email"] }]
      }
    }
  },
  "required": [
    "table1_systemwideOutletSummary",
    "table2_transfersOfOutlets",
    "table3_franchisedOutletsStatus",
    "table4_companyOwnedOutletsStatus",
    "table5_projectedOpenings",
    "currentFranchisees"
  ]
}