{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "$id": "https://docs.demiton.io/registers/legal_entities/v2.json",
  "title": "legal_entities contract v2",
  "type": "object",
  "required": [
    "base_currency",
    "external_id",
    "legal_name"
  ],
  "properties": {
    "locality": {
      "type": "string",
      "description": "suburb/city",
      "x-demiton-requiredness": "optional"
    },
    "legal_name": {
      "type": "string",
      "description": "registered/legal name of the entity",
      "x-demiton-requiredness": "required"
    },
    "external_id": {
      "type": "string",
      "description": "the source system's own company id",
      "x-demiton-requiredness": "required"
    },
    "postal_code": {
      "type": "string",
      "description": "postal code",
      "x-demiton-requiredness": "optional"
    },
    "country_code": {
      "type": "jurisdiction",
      "description": "country of registration/operation",
      "x-demiton-requiredness": "optional"
    },
    "trading_name": {
      "type": "string",
      "description": "name the entity trades under, if different",
      "x-demiton-requiredness": "optional"
    },
    "address_line1": {
      "type": "string",
      "description": "street address line 1",
      "x-demiton-requiredness": "optional"
    },
    "address_line2": {
      "type": "string",
      "description": "street address line 2",
      "x-demiton-requiredness": "optional"
    },
    "base_currency": {
      "type": "currency",
      "description": "the entity's functional currency",
      "x-demiton-requiredness": "required",
      "x-demiton-unit": "currency"
    },
    "primary_email": {
      "type": "string",
      "description": "the entity's general contact email",
      "x-demiton-requiredness": "optional"
    },
    "primary_phone": {
      "type": "string",
      "description": "the entity's general contact phone",
      "x-demiton-requiredness": "optional"
    },
    "identifier_value": {
      "type": "string",
      "description": "the identifier in that scheme",
      "x-demiton-requiredness": "tenant-specific"
    },
    "fiscal_year_start": {
      "type": "number",
      "description": "financial-year start",
      "x-demiton-requiredness": "optional"
    },
    "identifier_scheme": {
      "type": "string",
      "description": "the scheme the primary identifier belongs to",
      "x-demiton-requiredness": "tenant-specific"
    },
    "administrative_area": {
      "type": "string",
      "description": "state/region",
      "x-demiton-requiredness": "optional"
    },
    "registration_status": {
      "type": "string",
      "description": "registration state at a point in time",
      "x-demiton-requiredness": "optional"
    },
    "identifier_authority": {
      "type": "string",
      "description": "the register/authority that issues or validates the identifier",
      "x-demiton-requiredness": "tenant-specific"
    },
    "primary_contact_name": {
      "type": "string",
      "description": "the entity's general contact person",
      "x-demiton-requiredness": "optional"
    },
    "registration_status_as_at": {
      "type": "string",
      "description": "when that status was verified",
      "x-demiton-requiredness": "optional",
      "x-demiton-unit": "instant",
      "format": "date",
      "x-demiton-type": "date"
    }
  },
  "x-demiton-register-type": "legal_entities",
  "x-demiton-contract-version": "2.0.3",
  "x-demiton-store": "tenant",
  "x-demiton-axes": [],
  "x-demiton-measures": [],
  "x-demiton-provenance": {
    "standards": [
      {
        "code": "A New Tax System (Australian Business Number) Act 1999",
        "title": "ABN and the Australian Business Register (ABN Lookup)",
        "access": "public_summary",
        "region": "Australia",
        "edition": "current compilation",
        "checked_on": "2026-09-14"
      },
      {
        "code": "A New Tax System (Goods and Services Tax) Act 1999 - tax invoice requirements",
        "title": "GST tax invoice particulars (ATO tax invoice guidance)",
        "access": "public_summary",
        "region": "Australia",
        "edition": "ATO guidance last updated 2025-08-25",
        "checked_on": "2026-09-14"
      },
      {
        "code": "Privacy Act 1988 (Cth)",
        "title": "Privacy Act 1988 - Australian Privacy Principles",
        "access": "public_summary",
        "clause": "APPs 1-13",
        "region": "Australia",
        "edition": "compilation current at 2026-09",
        "checked_on": "2026-09-14"
      },
      {
        "code": "Single Touch Payroll Phase 2 (ATO)",
        "title": "ATO Single Touch Payroll reporting (employer ABN/branch)",
        "access": "public_summary",
        "region": "Australia",
        "edition": "Phase 2",
        "checked_on": "2026-09-14"
      },
      {
        "code": "Commission Implementing Regulation (EU) 2019/1780 (eForms), as amended by (EU) 2023/2884",
        "title": "eForms standard forms for public procurement notices",
        "access": "full_text_verified",
        "clause": "Annex Table 2, column 29 (organisation identifier: conditional mandatory)",
        "region": "European Union",
        "edition": "2019/1780 as amended 2023/2884",
        "checked_on": "2026-09-14"
      },
      {
        "code": "Regulation (EU) 2016/679 (GDPR)",
        "title": "General Data Protection Regulation",
        "access": "public_summary",
        "region": "European Union",
        "edition": "2016/679",
        "checked_on": "2026-09-14"
      },
      {
        "code": "Goods and Services Tax Act 1985 (NZ) - taxable supply information",
        "title": "GST taxable supply information (Inland Revenue guidance, in force 2023-04-01)",
        "access": "public_summary",
        "region": "New Zealand",
        "edition": "in force since 2023-04-01",
        "checked_on": "2026-09-14"
      },
      {
        "code": "New Zealand Business Number Act 2016",
        "title": "NZBN Act 2016 and the NZBN Register",
        "access": "public_summary",
        "region": "New Zealand",
        "edition": "2016 No 16",
        "checked_on": "2026-09-14"
      },
      {
        "code": "Privacy Act 2020 (NZ)",
        "title": "Privacy Act 2020 - Information Privacy Principles",
        "access": "public_summary",
        "clause": "IPPs 1-13",
        "region": "New Zealand",
        "edition": "2020 No 31",
        "checked_on": "2026-09-14"
      },
      {
        "code": "HMRC Real Time Information (RTI)",
        "title": "PAYE Real Time Information employer references (employer PAYE reference, Accounts Office reference)",
        "access": "public_summary",
        "region": "United Kingdom",
        "edition": "guidance updated 2026-04-06",
        "checked_on": "2026-09-14"
      },
      {
        "code": "Procurement Regulations 2024 (SI 2024/692)",
        "title": "Procurement Regulations 2024, contract award notice content (under Procurement Act 2023)",
        "access": "full_text_verified",
        "clause": "reg. 27(2)(e)(iii)",
        "region": "United Kingdom",
        "edition": "SI 2024/692",
        "checked_on": "2026-09-14"
      },
      {
        "code": "UK GDPR and Data Protection Act 2018",
        "title": "UK General Data Protection Regulation with Data Protection Act 2018",
        "access": "public_summary",
        "region": "United Kingdom",
        "edition": "UK GDPR (retained) + DPA 2018",
        "checked_on": "2026-09-14"
      },
      {
        "code": "FAR 52.204-7",
        "title": "Federal Acquisition Regulation clause 52.204-7 System for Award Management (SAM unique entity identifier) (Unique Entity ID, UEI)",
        "access": "full_text_verified",
        "clause": "52.204-7; maintenance via 52.204-13",
        "region": "United States",
        "edition": "Nov 2024 (FAR through FAC 2026-01)",
        "checked_on": "2026-09-14"
      }
    ]
  },
  "description": "The operating companies in your group: the root every worker, project and cost code belongs to.",
  "x-demiton-contract-url": "https://docs.demiton.io/registers/legal_entities/",
  "x-demiton-register-catalog": "https://docs.demiton.io/concepts/register-catalog"
}