ds001-eu-company-certificate.json

{
  "$schema": "http://json-schema.org/draft-07/schema#",
  "title": "EWC - EU Company Certificate",
  "description": "Schema for EU Company Certificate -  EWC WP3",
  "type": "object",
  "properties": {
    "issuing_authority": {
      "description": "Name of the public sector body or private entity that has issued this credential instance, or the ISO 3166 Alpha-2 country code of the respective Member State if there is no separate authority authorized to issue this credential.",
      "type": "string"
    },
    "issuing_authority_id": {
      "description": "EUID of the issuing authority. (Business register identifier for BRIS)",
      "type": "string"
    },
    "issuing_country": {
      "description": "Alpha-2 country code, as defined in ISO 3166-1, of the issuing country or territory.",
      "type": "string",
      "minLength": 2,
      "maxLength": 2
    },
    "issuing_jurisdiction": {
      "description": "Country subdivision code of the jurisdiction that issued the credential instance, as defined in ISO 3166-2:2020, Clause 8. The first part of the code SHALL be the same as the value for issuing_country.",
      "type": "string",
      "minLength": 2,
      "maxLength": 6
    },
    "issuance_date": {
      "description": "Date and possibly time of issuance",
      "type": "string",
      "format": "date-time"
    },
    "expiry_date": {
      "description": "Date and possibly time of credential expiration",
      "type": "string",
      "format": "date-time"
    },
    "authentic_source_id": {
      "description": "EUID for the public sector body or private entity responsible for an authentic source that is a repository or system, considered to be the primary source of information or recognized as authentic in national law.",
      "type": "string"
    },
    "authentic_source_name": {
      "description": "Name of the public sector body or private entity responsible for an authentic source that is a repository or system, considered to be the primary source of information or recognized as authentic in national law.",
      "type": "string"
    },
    "credentialSubject": {
      "description": "Attributes representing a Legal Entity",
      "type": "object",
      "properties": {
        "legal_person": {
          "type": "object",
          "properties": {
            "legal_person_name": {
              "description": "Official current legal person name as registered in the business register.",
              "type": "string"
            },
            "legal_person_id": {
              "description": "Unique id for organisations in EUID structure",
              "type": "string"
            },
            "legal_form_type": {
              "description": "Legal form of the company",
              "type": "string"
            },
            "registration_member_state": {
              "description": "Member State where the company is registered, Alpha-2 country code, as defined in ISO 3166-1",
              "type": "string",
              "minLength": 2,
              "maxLength": 2
            },
            "registered_address": {
              "description": "Registered office of the company (full address or part of it)",
              "type": "object",
              "properties": {
                "care_of": {
                  "description": "Used when an address is at the address of another person or legal entity.",
                  "type": "string"
                },
                "full_address": {
                  "description": "The complete address written as a string, separated with \";\".",
                  "type": "string"
                },
                "thorough_fare": {
                  "title": "Thoroughfare",
                  "description": "The name of a passage or way through from one location to another.",
                  "type": "string"
                },
                "locator_designator": {
                  "description": "A number or a sequence of characters that uniquely identifies the locator within the relevant scope.",
                  "type": "string"
                },
                "post_code": {
                  "description": "The code created and maintained for postal purposes to identify a subdivision of addresses and postal delivery points.",
                  "type": "string"
                },
                "post_name": {
                  "description": "A name created and maintained for postal purposes to identify a subdivision of addresses and postal delivery points.",
                  "type": "string"
                },
                "post_office_box": {
                  "description": "A location designator for a postal delivery point at a post office, usually a number.",
                  "type": "string"
                },
                "locator_name": {
                  "description": "Proper noun(s) applied to the real world entity identified by the locator. The locator name could be the name of the property or complex, of the building or part of the building, or it could be the name of a room inside a building.",
                  "type": "string"
                },
                "admin_unit_level_1": {
                  "description": "The uppermost administrative unit for the address, almost always a country.",
                  "type": "string"
                },
                "admin_unit_level_2": {
                  "description": "The name of a secondary level/region of the address, usually a county, state or other such area that typically encompasses several localities.",
                  "type": "string"
                }
              },
              "required": [
                "full_address"
              ]
            },
            "registration_date": {
              "description": "Date of registration of the company",
              "type": "string",
              "format": "date"
            },
            "share_capital": {
              "description": "Amount of the capital subscribed with currency",
              "type": "object",
              "properties": {
                "amount": {
                  "description": "Amount of the capital suscribed",
                  "type": "string"
                },
                "currency": {
                  "description": "Currency code used of the capital subscribed, as defined in ISO 4217:2015",
                  "type": "string",
                  "minLength": 3,
                  "maxLength": 3
                }
              }
            },
            "legal_entity_status": {
              "description": "Status of the company as defined in national law and where recorded in the national register",
              "type": "string",
              "enum": [
                "active",
                "inactive"
              ]
            },
            "legal_entity_activity": {
              "description": "Object of the company describing its main activity or activities, which must be expressed using the Statistical Classification of Economic Activities in the European Community (NACE)",
              "type": "object",
              "properties": {
                "code": {
                  "description": "Legal entity activity NACE code",
                  "type": "string"
                },
                "description": {
                  "description": "Short description of the legal entity activity",
                  "type": "string"
                }
              }
            },
            "legal_entity_duration": {
              "description": "Duration of the company, where its duration is limited",
              "type": "string",
              "format": "date"
            },
            "contact_point": {
              "description": "Correspondence address of the company, such as electronic mail or postal address (full or partial)",
              "type": "object",
              "properties": {
                "contact_page": {
                  "description": "Details of the company website",
                  "type": "string",
                  "format": "uri"
                },
                "contact_telephone": {
                  "description": "Details of the company phone",
                  "type": "string"
                },
                "contact_email": {
                  "description": "Details of the company email",
                  "type": "string",
                  "format": "email"
                }
              }
            }
          },
          "required": [
            "legal_person_name",
            "legal_person_id",
            "legal_form_type",
            "registration_member_state",
            "registered_address",
            "registration_date",
            "legal_entity_status",
            "legal_entity_activity"
          ]
        }
      },
        "legal_representative": {
          "description": "Information about any person authorized by the company to represent it alone or jointly",
          "type": "array",
          "items": {
            "oneOf": [
              {
                "$ref": "#/$defs/legal_representative.physical_person"
              },
              {
                "$ref": "#/$defs/legal_representative.legal_person"
              }
            ]
          }
        },
      "required": [
        "legal_entity",
        "legal_representative"
      ]
    },
    "credentialStatus": {
      "description": "Defines suspension and/or revocation details for the issued credential. Further redefined by the type extension",
      "type": "object",
      "properties": {
        "id": {
          "description": "Exact identity for the credential status",
          "type": "string",
          "format": "uri"
        },
        "type": {
          "description": "Defines the revocation type extension",
          "type": "string"
        }
      },
      "required": [
        "id",
        "type"
      ]
    },
    "credentialSchema": {
      "description": "One or more schemas that validate the Verifiable Credential.",
      "anyOf": [
        {
          "$ref": "#/$defs/credentialSchema"
        },
        {
          "type": "array",
          "items": {
            "$ref": "#/$defs/credentialSchema"
          }
        }
      ]
    }
  },
  "required": [
    "credentialSubject",
    "credentialStatus",
    "credentialSchema",
    "issuing_authority",
    "issuing_authority_id",
    "issuing_country",
    "issuance_date",
    "expiry_date",
    "authentic_source_id",
    "authentic_source_name"
  ],
  "$defs": {
    "credentialSchema": {
      "description": "Contains information about the credential schema on which the issued credential is based",
      "type": "object",
      "properties": {
        "id": {
          "description": "References the credential schema stored on the Trusted Schemas Registry (TSR) on which the Verifiable Authorisation is based on",
          "type": "string",
          "format": "uri"
        },
        "type": {
          "description": "Defines credential schema type",
          "type": "string",
          "enum": [
            "FullJsonSchemaValidator2021"
          ]
        }
      },
      "required": [
        "id",
        "type"
      ]
    },
    "legal_representative.physical_person": {
      "description": "Details about the representative of the company if incarnated by a physical person",
      "type": "object",
      "properties": {
        "full_name": {
          "description": "Full name of the physical person representing the company ",
          "type": "string"
        },
        "date_of_birth": {
          "description": "Date of birth of the physical person representing the company",
          "type": "string",
          "format": "date"
        },
        "nationality": {
          "description": "Nationality of the physical person representing the company",
          "type": "string"
        },
        "signatory_rule": {
          "description": "Information if the representative can engage the company alone or jointly",
          "type": "string",
          "enum": [
            "alone",
            "joint"
          ]
        }
      },
      "required": [
        "full_name",
        "date_of_birth",
        "signatory_rule"
      ]
    },
    "legal_representative.legal_person": {
      "description": "Details about the representative of the company if incarnated by a legal person",
      "type": "object",
      "properties": {
        "legal_person_name": {
              "description": "Official current legal person name as registered in the business register.",
              "type": "string"
            },
            "legal_person_id": {
              "description": "Unique id for organisations in EUID structure",
              "type": "string"
            },
            "legal_form_type": {
              "description": "Legal form of the company",
              "type": "string"
        }
      },
      "required": [
        "legal_person_name",
        "legal_person_id",
        "legal_form_type"
      ]
    }
  }
}