Tmf632 Party Management Tax Exemption Certificate Structure

{
  "$schema": "https://json-structure.org/meta/core/v0/#",
  "$id": "https://raw.githubusercontent.com/api-evangelist/tm-forum/refs/heads/main/json-structure/tmf632-party-management-tax-exemption-certificate-structure.json",
  "name": "TaxExemptionCertificate",
  "description": "TaxExemptionCertificate schema from TM Forum API",
  "allOf": [
    {
      "$ref": "#/components/schemas/Extensible"
    },
    {
      "type": "object",
      "description": "A tax exemption certificate represents a tax exemption granted to a party (individual or organization) by a tax jurisdiction which may be a city, state, country,... An exemption has a certificate identifier (received from the jurisdiction that levied the tax) and a validity period. An exemption is per tax types and determines for each type of tax what portion of the tax is exempted (partial by percentage or complete) via the tax definition.",
      "properties": {
        "id": {
          "type": "string",
          "description": "Identifier of the tax exemption within list of the exemptions"
        },
        "taxDefinition": {
          "type": "array",
          "items": {
            "$ref": "#/components/schemas/TaxDefinition"
          },
          "description": "A list of taxes that are covered by the exemption, e.g. City Tax, State Tax. The definition would include the exemption (e.g. for a rate exemption 0% would be a full exemption, 5% could be a partial exemption if the actual rate was 10%)."
        },
        "validFor": {
          "$ref": "#/components/schemas/TimePeriod"
        },
        "certificateNumber": {
          "type": "string",
          "description": "Identifier of a document that shows proof of exemption from taxes for the taxing jurisdiction"
        },
        "issuingJurisdiction": {
          "type": "string",
          "description": "Name of the jurisdiction that issued the exemption",
          "example": "USA"
        },
        "reason": {
          "type": "string",
          "description": "Reason for the tax exemption"
        },
        "attachment": {
          "$ref": "#/components/schemas/AttachmentRefOrValue"
        }
      }
    }
  ],
  "discriminator": {
    "propertyName": "@type",
    "mapping": {
      "TaxExemptionCertificate": "#/components/schemas/TaxExemptionCertificate"
    }
  }
}