{
  "$id": "https://fddschema.org/schema/v1.0/items/item01-franchisor.json",
  "title": "Item 1: The Franchisor, and any Parents, Predecessors, and Affiliates",
  "description": "Information about the franchisor, its parents, predecessors, and affiliates, as well as a description of the franchise offered, market overview, competition overview, and relevant laws and regulations.",
  "type": "object",
  "properties": {
    "franchisor": {
      "type": "object",
      "title": "Franchisor Information",
      "description": "Information about the franchisor offering the franchise.",
      "properties": {
        "legalName": {
          "type": "string",
          "description": "The legal name of the franchisor",
          "examples": ["ABC Franchising, Inc."]
        },
        "legalEntityType": {
          "type": "string",
          "description": "The legal structure of the franchisor",
          "examples": ["corporation", "LLC", "partnership"]
        },
        "dbaNames": {
          "type": "array",
          "items": {
            "type": "string"
          },
          "uniqueItems": true,
          "description": "Any names the franchisor intends to use to conduct business (Doing business as names)",
          "examples": ["ABC Fast Food"]
        },
        "principalAddress": {
          "$ref": "../definitions/postal-address.json"
        },
        "formationDate": {
          "type": "string",
          "format": "date",
          "description": "Date the franchisor was legally formed",
          "examples": ["2020-01-20"]
        },
        "formationState": {
          "type": "string",
          "description": "The U.S. state or foreign country where the franchisor was legally formed",
          "examples": ["Delaware", "California", "Canada"]
        },
        "businessOperationStartDate": {
          "type": "string",
          "format": "date",
          "description": "Date the business itself began operating",
          "examples": ["2020-02-15"]
        },
        "franchisingStartDate": {
          "type": "string",
          "format": "date",
          "description": "Date the franchisor began offering franchises",
          "examples": ["2020-03-01"]
        },
        "otherLinesOfBusiness": {
          "type": "object",
          "description": "Franchisor's prior business experience in lines of business in the industry of the franchise offered.",
          "properties": {
            "hasOtherLinesOfBusinessToDisclose": {
              "type": "boolean",
              "description": "Indicates whether the franchisor has other lines of business to disclose"
            },
            "linesOfBusiness": {
              "type": "array",
              "description": "List of other lines of business to be disclosed",
              "items": {
                "type": "object",
                "properties": {
                  "description": {
                    "type": "string",
                    "description": "Description of the line of business"
                  },
                  "businessOperationStartDate": {
                    "type": "string",
                    "format": "date",
                    "description": "The date the franchisor began operating this line of business",
                    "examples": ["2020-01-01"]
                  },
                  "businessOperationEndDate": {
                    "type": "string",
                    "format": "date",
                    "description": "The date the franchisor ended operating this line of business",
                    "examples": ["2022-01-01"]
                  },
                  "franchisingStartDate": {
                    "type": "string",
                    "format": "date",
                    "description": "The date the franchisor began offering franchises in this line of business",
                    "examples": ["2020-06-01"]
                  },
                  "franchisingEndDate": {
                    "type": "string",
                    "format": "date",
                    "description": "The date the franchisor ended offering franchises in this line of business",
                    "examples": ["2022-06-01"]
                  },
                  "numberOfFranchisesSold": {
                    "type": "integer",
                    "description": "The total number of franchises sold in this line of business"
                  }
                },
                "required": ["description"],
                "allOf": [
                  {
                    "if": {
                      "properties": {
                        "businessOperationEndDate": {}
                      },
                      "required": ["businessOperationEndDate"]
                    },
                    "then": {
                      "required": ["businessOperationStartDate"]
                    }
                  },
                  {
                    "if": {
                      "properties": {
                        "franchisingEndDate": {}
                      },
                      "required": ["franchisingEndDate"]
                    },
                    "then": {
                      "required": ["franchisingStartDate"]
                    }
                  },
                  {
                    "if": {
                      "properties": {
                        "franchisingStartDate": {}
                      },
                      "required": ["franchisingStartDate"]
                    },
                    "then": {
                      "required": ["numberOfFranchisesSold"]
                    }
                  }
                ]
              },
              "minItems": 1
            }
          },
          "required": ["hasOtherLinesOfBusinessToDisclose"],
          "if": {
            "properties": {
              "hasOtherLinesOfBusinessToDisclose": {
                "const": true
              }
            },
            "required": ["hasOtherLinesOfBusinessToDisclose"]
          },
          "then": {
            "required": ["linesOfBusiness"]
          }
        }
      },
      "required": [
        "legalName",
        "legalEntityType",
        "principalAddress",
        "formationDate",
        "formationState",
        "otherLinesOfBusiness"
      ]
    },
    "parents": {
      "type": "object",
      "title": "Parent Companies",
      "description": "Information about any parent companies of the franchisor.",
      "properties": {
        "hasParentsToDisclose": {
          "type": "boolean",
          "description": "Indicates whether the franchisor has parent companies to disclose"
        },
        "parents": {
          "type": "array",
          "description": "List of parent companies",
          "items": {
            "type": "object",
            "properties": {
              "@type": {
                "const": "fdd:Parent"
              },
              "legalName": {
                "type": "string",
                "description": "The legal name of the parent company",
                "examples": ["XYZ Holdings, LLC"]
              },
              "principalAddress": {
                "$ref": "../definitions/postal-address.json"
              }
            },
            "required": ["legalName", "principalAddress"]
          },
          "minItems": 1
        }
      },
      "required": ["hasParentsToDisclose"],
      "if": {
        "properties": {
          "hasParentsToDisclose": {
            "const": true
          }
        },
        "required": ["hasParentsToDisclose"]
      },
      "then": {
        "required": ["parents"]
      }
    },
    "predecessors": {
      "type": "object",
      "title": "Predecessors",
      "description": "Information about any predecessors of the franchisor.",
      "properties": {
        "hasPredecessorsToDisclose": {
          "type": "boolean",
          "description": "Indicates whether the franchisor has predecessors to disclose"
        },
        "predecessors": {
          "type": "array",
          "description": "List of predecessor companies",
          "items": {
            "type": "object",
            "properties": {
              "@type": {
                "const": "fdd:Predecessor"
              },
              "legalName": {
                "type": "string",
                "description": "The legal name of the predecessor company",
                "examples": ["AAA Franchising, Inc."]
              },
              "dbaNames": {
                "type": "array",
                "description": "Any names the predecessor conducted business under (Doing business as names)",
                "items": {
                  "type": "string"
                },
                "uniqueItems": true
              },
              "principalAddress": {
                "$ref": "../definitions/postal-address.json"
              },
              "otherLinesOfBusiness": {
                "type": "object",
                "description": "Predecessor's prior business experience in lines of business in the industry of the franchise offered, including the length of time the predecessor operated and offered those franchises.",
                "properties": {
                  "hasOtherLinesOfBusinessToDisclose": {
                    "type": "boolean",
                    "description": "Indicates whether the predecessor has other lines of business to disclose"
                  },
                  "linesOfBusiness": {
                    "type": "array",
                    "description": "List of other lines of business to be disclosed",
                    "items": {
                      "type": "object",
                      "properties": {
                        "description": {
                          "type": "string",
                          "description": "Description of the line of business"
                        },
                        "businessOperationStartDate": {
                          "type": "string",
                          "format": "date",
                          "description": "The date the predecessor began operating this line of business",
                          "examples": ["2018-01-01"]
                        },
                        "businessOperationEndDate": {
                          "type": "string",
                          "format": "date",
                          "description": "The date the predecessor ended operating this line of business",
                          "examples": ["2020-01-01"]
                        },
                        "franchisingStartDate": {
                          "type": "string",
                          "format": "date",
                          "description": "The date the predecessor began offering franchises in this line of business",
                          "examples": ["2018-06-01"]
                        },
                        "franchisingEndDate": {
                          "type": "string",
                          "format": "date",
                          "description": "The date the predecessor ended offering franchises in this line of business",
                          "examples": ["2020-06-01"]
                        },
                        "numberOfFranchisesSold": {
                          "type": "integer",
                          "description": "The total number of franchises sold in this line of business"
                        }
                      },
                      "required": ["description"],
                      "allOf": [
                        {
                          "if": {
                            "properties": {
                              "businessOperationEndDate": {}
                            },
                            "required": ["businessOperationEndDate"]
                          },
                          "then": {
                            "required": ["businessOperationStartDate"]
                          }
                        },
                        {
                          "if": {
                            "properties": {
                              "franchisingEndDate": {}
                            },
                            "required": ["franchisingEndDate"]
                          },
                          "then": {
                            "required": ["franchisingStartDate"]
                          }
                        },
                        {
                          "if": {
                            "properties": {
                              "franchisingStartDate": {}
                            },
                            "required": ["franchisingStartDate"]
                          },
                          "then": {
                            "required": ["numberOfFranchisesSold"]
                          }
                        }
                      ]
                    },
                    "minItems": 1
                  }
                },
                "required": ["hasOtherLinesOfBusinessToDisclose"],
                "if": {
                  "properties": {
                    "hasOtherLinesOfBusinessToDisclose": {
                      "const": true
                    }
                  },
                  "required": ["hasOtherLinesOfBusinessToDisclose"]
                },
                "then": {
                  "required": ["linesOfBusiness"]
                }
              }
            },
            "required": [
              "legalName",
              "principalAddress",
              "otherLinesOfBusiness"
            ]
          },
          "minItems": 1
        }
      },
      "required": ["hasPredecessorsToDisclose"],
      "if": {
        "properties": {
          "hasPredecessorsToDisclose": {
            "const": true
          }
        },
        "required": ["hasPredecessorsToDisclose"]
      },
      "then": {
        "required": ["predecessors"]
      }
    },
    "affiliates": {
      "type": "object",
      "title": "Affiliates",
      "description": "Information about any affiliates of the franchisor.",
      "properties": {
        "hasAffiliatesToDisclose": {
          "type": "boolean",
          "description": "Indicates whether the franchisor has affiliates to disclose"
        },
        "affiliates": {
          "type": "array",
          "description": "List of affiliate companies",
          "items": {
            "type": "object",
            "properties": {
              "@type": {
                "const": "fdd:Affiliate"
              },
              "legalName": {
                "type": "string",
                "description": "The legal name of the affiliate company",
                "examples": ["DEF Services, LLC"]
              },
              "dbaNames": {
                "type": "array",
                "description": "Any names the affiliate conducts business under (Doing business as names)",
                "items": {
                  "type": "string"
                },
                "uniqueItems": true
              },
              "principalAddress": {
                "$ref": "../definitions/postal-address.json"
              },
              "relationshipDescription": {
                "type": "string",
                "description": "Description of the relationship between the franchisor and the affiliate",
                "examples": [
                  "Sister company under common ownership providing support services to franchisees."
                ]
              },
              "otherLinesOfBusiness": {
                "type": "object",
                "description": "Affiliate's prior business experience in lines of business in the industry of the franchise offered, including the length of time the affiliate operated and offered those franchises.",
                "properties": {
                  "hasOtherLinesOfBusinessToDisclose": {
                    "type": "boolean",
                    "description": "Indicates whether the affiliate has other lines of business to disclose"
                  },
                  "linesOfBusiness": {
                    "type": "array",
                    "description": "List of other lines of business to be disclosed",
                    "items": {
                      "type": "object",
                      "properties": {
                        "description": {
                          "type": "string",
                          "description": "Description of the line of business"
                        },
                        "businessOperationStartDate": {
                          "type": "string",
                          "format": "date",
                          "description": "The date the affiliate began operating this line of business",
                          "examples": ["2019-01-01"]
                        },
                        "businessOperationEndDate": {
                          "type": "string",
                          "format": "date",
                          "description": "The date the affiliate ended operating this line of business",
                          "examples": ["2020-12-31"]
                        },
                        "franchisingStartDate": {
                          "type": "string",
                          "format": "date",
                          "description": "The date the affiliate began offering franchises in this line of business",
                          "examples": ["2021-01-01"]
                        },
                        "franchisingEndDate": {
                          "type": "string",
                          "format": "date",
                          "description": "The date the affiliate ended offering franchises in this line of business",
                          "examples": ["2022-12-31"]
                        },
                        "numberOfFranchisesSold": {
                          "type": "integer",
                          "description": "The total number of franchises sold in this line of business"
                        }
                      },
                      "required": ["description"],
                      "allOf": [
                        {
                          "if": {
                            "properties": {
                              "businessOperationEndDate": {}
                            },
                            "required": ["businessOperationEndDate"]
                          },
                          "then": {
                            "required": ["businessOperationStartDate"]
                          }
                        },
                        {
                          "if": {
                            "properties": {
                              "franchisingEndDate": {}
                            },
                            "required": ["franchisingEndDate"]
                          },
                          "then": {
                            "required": ["franchisingStartDate"]
                          }
                        },
                        {
                          "if": {
                            "properties": {
                              "franchisingStartDate": {}
                            },
                            "required": ["franchisingStartDate"]
                          },
                          "then": {
                            "required": ["numberOfFranchisesSold"]
                          }
                        }
                      ]
                    },
                    "minItems": 1
                  }
                },
                "required": ["hasOtherLinesOfBusinessToDisclose"],
                "if": {
                  "properties": {
                    "hasOtherLinesOfBusinessToDisclose": {
                      "const": true
                    }
                  },
                  "required": ["hasOtherLinesOfBusinessToDisclose"]
                },
                "then": {
                  "required": ["linesOfBusiness"]
                }
              }
            },
            "required": [
              "legalName",
              "principalAddress",
              "relationshipDescription",
              "otherLinesOfBusiness"
            ]
          },
          "minItems": 1
        }
      },
      "required": ["hasAffiliatesToDisclose"],
      "if": {
        "properties": {
          "hasAffiliatesToDisclose": {
            "const": true
          }
        },
        "required": ["hasAffiliatesToDisclose"]
      },
      "then": {
        "required": ["affiliates"]
      }
    },
    "descriptionOfFranchiseOffered": {
      "type": "string",
      "description": "Plain-language description of the business the franchisee will operate."
    },
    "marketOverview": {
      "type": "string",
      "description": "Overview of the market in which the franchisor and its franchisees will operate."
    },
    "competitionOverview": {
      "type": "string",
      "description": "Description of the franchisor's competition in the market."
    },
    "lawsAndRegulations": {
      "type": "string",
      "description": "Laws and regulations specific to the industry in which the franchise business operates. Excluding general business laws and regulations that apply to all businesses."
    }
  },
  "required": [
    "franchisor",
    "parents",
    "predecessors",
    "affiliates",
    "descriptionOfFranchiseOffered",
    "marketOverview",
    "competitionOverview",
    "lawsAndRegulations"
  ]
}