Ticket

Event Digitization

The Ticket event is triggered when a ticket has been created or modified.

JSON schema & example

Example payload

{
  "metadata": {
    "traceId": "7d0168f2-1c75-4996-b83d-c55a53488726",
    "occurredAt": "2024-12-24T12:04:06Z",
    "version": "1.0",
    "tenant": "14450",
    "type": "TICKET"
  },
  "ticketId": "235800065",
  "orderId": "111111",
  "ticketStatus": "ACTIVE",
  "ticketType": "SINGLE",
  "parentTicketId": "235800066",
  "ticketCode": "41873742187161",
  "seatCode": "s4x2",
  "eventIds": [
    "2174938"
  ],
  "ticketBuyer": {
    "salutation": "MR",
    "firstName": "Test-Name",
    "lastName": "Test-Nachname",
    "customerId": "rxrn:cx:14450:customer:1043de625379f8955513e597",
    "company": "Test Company"
  },
  "ticketHolder": {
    "salutation": "MR",
    "firstName": "Max",
    "lastName": "Müller",
    "company": "Reservix GmbH",
    "customFields": {
      "FirmenName": "Reservix GmbH",
      "Abteilung": "IT"
    }

  },
  "pricing": {
    "level": "Normalpreis",
    "levelNumber": "0",
    "category": "3. Kategorie",
    "categoryNumber": "3"
  },
  "seatInfo": {
    "block": "Block F",
    "row": "11",
    "seat": "1"
  },
  "createdAt": "2025-05-28T10:19:05Z",
  "updatedAt": "2025-05-28T10:19:05Z"
}

JSON Schema

{
  "type": "object",
  "$schema": "http://json-schema.org/draft-07/schema#",
  "properties": {
    "metadata": {
      "type": "object",
      "properties": {
        "traceId": {
          "type": "string",
          "format": "uuid",
          "description": "Unique identifier to trace the event."
        },
        "occurredAt": {
          "type": "string",
          "format": "date-time",
          "description": "The timestamp when the event occurred."
        },
        "version": {
          "type": "string",
          "pattern": "^[0-9]+\\.[0-9]+$",
          "description": "The version of the event schema, following semantic versioning."
        },
        "tenant": {
          "type": "string",
          "description": "Identifier of the tenant or organization associated with the event."
        },
        "type": {
          "type": "string",
          "enum": [
            "CUSTOMER",
            "CUSTOMER_DELETED",
            "EVENT",
            "EVENT_CAPACITY",
            "ORDER",
            "CANCELLATION",
            "CREDIT_NOTE",
            "RESERVATION",
            "RESERVATION_CANCELLATION",
            "PRICE_PROFILE",
            "PRICE_PROFILE_DELETED",
            "TICKET"
          ],
          "description": "Identifier of the tenant or organization associated with the event."
        }
      },
      "required": [
        "traceId",
        "occurredAt",
        "version",
        "tenant",
        "type"
      ],
      "additionalProperties": false
    }
  },
  "ticketId": {
    "type": "string",
    "description": "The unique ID of the ticket."
  },
  "orderId": {
    "type": "string",
    "description": "The ID of the order to which the ticket belongs."
  },
  "ticketStatus": {
    "type": "string",
    "description": "The current status of the ticket.",
    "enum": [
      "ACTIVE",
      "INACTIVE"
    ]
  },
  "ticketType": {
    "type": "string",
    "description": "The type of ticket",
    "enum": [
      "SINGLE",
      "CARD",
      "BOOKLET"
    ]
  },
  "ticketCode": {
    "type": "string",
    "description": "The code number of the ticket."
  },
  "seatCode": {
    "type": "string",
    "description": "A code identifying the seat."
  },
  "eventIds": {
    "type": "array",
    "description": "A list of the IDs of the associated events.",
    "items": {
      "type": "string"
    }
  },
  "ticketBuyer": {
    "type": "object",
    "description": "Information about the purchaser of the ticket.",
    "properties": {
      "salutation": {
        "type": "string",
        "enum": [
          "MR",
          "MRS"
        ]
      },
      "firstName": {
        "type": "string",
        "description": "The first name."
      },
      "lastName": {
        "type": "string",
        "description": "The last name."
      },
      "customerId": {
        "type": "string",
        "description": "The customer ID."
      },
      "company": {
        "type": "string",
        "description": "The company name"
      },
      "customFields": {
        "description": "User defined fields as key-value pairs",
        "type": "object",
        "additionalProperties": {
          "type": "string"
        }
      }
    },
    "required": []
  },
  "ticketHolder": {
    "type": "object",
    "description": "Information about the actual ticket holder",
    "properties": {
      "salutation": {
        "type": "string",
        "enum": [
          "MR",
          "MRS"
        ]
      },
      "firstName": {
        "type": "string"
      },
      "lastName": {
        "type": "string"
      },
      "company": {
        "type": "string"
      },
      "customFields": {
        "description": "User defined fields as key-value pairs",
        "type": "object",
        "additionalProperties": {
          "type": "string"
        }
      }
    },
    "required": []
  },
  "pricing": {
    "type": "object",
    "description": "Details about ticket pricing.",
    "properties": {
      "level": {
        "type": "string",
        "description": "The price level."
      },
      "levelNumber": {
        "type": "string",
        "description": "The number of the price level."
      },
      "category": {
        "type": "string",
        "description": "The price category"
      },
      "categoryNumber": {
        "type": "string",
        "description": "The number of the price category."
      }
    },
    "required": []
  },
  "seatInfo": {
    "type": "object",
    "description": "Details about the seat.",
    "properties": {
      "block": {
        "type": "string",
        "description": "The block or section of the venue."
      },
      "row": {
        "type": "string",
        "description": "The row."
      },
      "seat": {
        "type": "string",
        "description": "The seat"
      }
    },
    "required": []
  },
  "createdAt": {
    "type": "string",
    "format": "date-time",
    "description": "The timestamp of the ticket creation"
  },
  "updatedAt": {
    "type": "string",
    "format": "date-time",
    "description": "The timestamp of the last update of the ticket"
  },
  "required": [
    "ticketId",
    "ticketStatus",
    "ticketType",
    "ticketCode",
    "createdAt",
    "updatedAt"
  ]
}