Ticket Sales - TradeMaster Transactions (TMT)

Overview

The Ticket Sales feature allows you to create, manage, and sell tickets for your events. TradeMaster provides comprehensive tools for configuring ticket types, managing inventory, tracking sales, and validating tickets at event entry points.

Tickets in TMT are organized by zones and seat assignments, with real-time status tracking from creation through validation.

Ticket Lifecycle

Tickets move through several states during their lifetime:

Created

Ticket is generated and added to inventory but not yet available for sale

Available

Ticket is active and available for purchase

Reserved

Ticket is temporarily held during checkout process

Sold

Ticket has been purchased and is associated with a customer

Validated

Ticket has been scanned and validated at event entry

Cancelled/Refunded

Ticket sale has been cancelled and ticket returned to inventory

Accessing Ticket Management

Navigate to Event Details

From the Events list, click on the event you want to manage

Open Tickets Tab

In the event detail view, click on the Tickets or Entradas tab

View Ticket Inventory

The ticket table displays all tickets created for this event

Ticket Configuration

Setting Up Zones

Zones represent different sections or areas within your venue:

VIP Zone

Premium seating with higher pricing and special amenities

General Admission

Standard seating or standing areas

Balcony

Upper-level seating sections

Floor

Ground-level or floor seating areas

Zone Properties

// Zone configuration structure
{
  zone: "VIP",
  color: "#FFD700", // Gold color for visual identification
  capacity: 100,
  price: 150.00,
  currency: "USD"
}

Assign distinct colors to each zone for easy visual identification in the ticket table and seating charts.

Creating Ticket Inventory

After defining zones, generate the actual ticket inventory:

Define Ticket Quantity

Specify how many tickets to create for each zone, respecting venue capacity limits

Set Seat Assignments

Choose between:

Numbered seating: Specific seat assignments (e.g., Row A, Seat 12)
General admission: No specific seat assignment

Configure Pricing

Set the base price for each ticket in the zone

Generate Tickets

Click generate to create the ticket inventory

Once tickets are generated and sales have begun, you cannot reduce the total ticket count. Only add tickets if you need to increase capacity.

Ticket Table Interface

The ticket table provides a comprehensive view of all tickets for an event:

Table Columns

Column	Description
Ticket ID	Unique identifier with seat assignment (e.g., “A-12”)
Zone	Zone name (VIP, General, etc.)
Color	Visual color indicator for the zone
Date Created	When the ticket was generated
Last Action	Most recent activity from the ledger
Status	Current ticket status (Active/Inactive)
Actions	View details or manage the ticket

Ticket Status Indicators

Active

Ticket is available for sale or has been sold and is valid

Inactive

Ticket has been deactivated, cancelled, or is not available for sale

Searching and Filtering Tickets

// Global search fields
globalFilterFields: [
  'ticket_id',     // Search by ticket ID
  'zone',          // Filter by zone name
  'status',        // Filter by status
  'dateCreated'    // Search by creation date
]

Use the search bar to quickly find specific tickets:

Search by seat ID: “A-12”
Filter by zone: “VIP”
Filter by status: “Activo” or “Inactivo”

Ticket Details and Actions

Click on any ticket to view detailed information:

Ticket Information

{
  id: "event_id-ticket_id",
  seat_id: "A-12",
  zone: "VIP",
  color: "#FFD700",
  price: 150.00,
  status: true,
  date_created: "2024-03-01T10:00:00",
  ledger: [
    { action: "created", date: "2024-03-01T10:00:00" },
    { action: "sold", date: "2024-03-10T15:30:00" },
    { action: "validated", date: "2024-03-15T19:00:00" }
  ]
}

Ticket Ledger

The ledger tracks all actions performed on a ticket:

Available Ledger Actions

created: Ticket generated and added to inventory
sold: Ticket purchased by a customer
reserved: Temporarily held during checkout
validated: Scanned and validated at entry
cancelled: Sale cancelled, ticket returned to inventory
refunded: Payment refunded to customer
transferred: Ownership transferred to another customer

Processing Ticket Sales

Point of Sale Workflow

Search for Tickets

From a box office, search for available tickets by event, zone, or seat number

Select Tickets

Choose one or more tickets to add to the order

Review Order

Verify ticket details, quantities, and total price

Select Payment Method

Choose from available payment methods configured for the office

Process Payment

Complete the payment transaction

Generate Receipt

System generates order confirmation and tickets with QR codes

Order Structure

// Order data structure
{
  id: "order_id",
  event_name: "Rock Concert 2024",
  event_id: "event_123",
  office_name: "Main Box Office",
  office_id: "office_456",
  tickets: [
    { ticket_id: "A-12", zone: "VIP", price: 150.00 },
    { ticket_id: "A-13", zone: "VIP", price: 150.00 }
  ],
  amount: 300.00,
  currency: "USD",
  payment_method: "Credit Card",
  status: true,
  date: {
    created: "2024-03-10T15:30:00"
  }
}

Ticket Validation

QR Code Generation

Each sold ticket receives a unique QR code for validation:

// QR code includes encrypted data
{
  event_id: "event_123",
  ticket_id: "A-12",
  order_id: "order_789",
  validation_key: "encrypted_key",
  customer_info: "masked_for_privacy"
}

QR codes are validated against the event’s security key to prevent fraud and duplicate entry.

Validation Process

Scan QR Code

Use the mobile app or scanner device to scan the ticket QR code

Verify Ticket

System checks:

Ticket belongs to this event
Ticket has not been previously validated
QR code signature is valid
Event is active and date matches

Grant or Deny Entry

✅ Valid ticket: Grant entry and mark as validated
❌ Invalid ticket: Deny entry and show error reason

Update Ledger

Add validation action to ticket ledger with timestamp

Validation Responses

Valid Ticket

“Ticket validated successfully. Entry granted.”

Already Used

“This ticket has already been validated.”

Invalid Event

“This ticket is not valid for this event.”

Expired

“This ticket has expired.”

Searching and Querying Tickets

Query by Customer Information

Look up tickets purchased by a specific customer:

Access Ticket Search

Navigate to Tickets > Search or Buscar Boletos

Enter Customer Details

Search by:

Email address
Phone number
Order ID
Customer name

View Customer Tickets

System displays all tickets purchased by this customer across all events

Display Ticket Information

The search results show:

// Customer ticket information
{
  customer: {
    name: "John Doe",
    email: "[email protected]",
    phone: "+1 555-0123"
  },
  tickets: [
    {
      event_name: "Rock Concert 2024",
      ticket_id: "A-12",
      zone: "VIP",
      status: "valid",
      qr_code: "base64_encoded_image"
    }
  ],
  order_total: 150.00
}

Customers can receive their tickets via email or SMS with QR codes for easy access.

Ticket Reports and Analytics

Sales Summary

View comprehensive sales data for an event:

Total Capacity

Maximum number of tickets available

Tickets Sold

Number of tickets purchased

Available Tickets

Remaining inventory

Sales Percentage

Percentage of capacity sold

Total Revenue

Sum of all ticket sales

Average Price

Mean ticket price across all zones

Sales by Zone

// Zone performance breakdown
[
  { zone: "VIP", capacity: 100, sold: 87, revenue: 13050.00 },
  { zone: "General", capacity: 500, sold: 432, revenue: 21600.00 },
  { zone: "Balcony", capacity: 200, sold: 156, revenue: 4680.00 }
]

Export Options

Click Export

Click the download icon in the ticket table header

Select Format

Choose CSV format for the export

Download File

The system generates and downloads a CSV file with all ticket data

Ticket ID,Zone,Color,Status,Created Date,Last Action,Price
A-12,VIP,#FFD700,Active,2024-03-01,Sold,150.00
A-13,VIP,#FFD700,Active,2024-03-01,Sold,150.00
B-01,General,#3498db,Active,2024-03-01,Available,50.00

Best Practices

Capacity Management

Never exceed venue maximum capacity when creating tickets

Zone Pricing

Use clear pricing differences between zones to guide customer choices

Color Coding

Choose distinct, accessible colors for each zone

Inventory Monitoring

Regularly check ticket availability and adjust marketing accordingly

Validation Testing

Test QR code scanning before event day

Backup Systems

Have offline validation procedures ready in case of technical issues

Troubleshooting

Cannot create tickets

Verify the event is in “Instanciado” or “Activo” status
Check that zones are properly configured
Ensure total tickets don’t exceed venue capacity
Confirm you have permission to manage tickets

Ticket not appearing after purchase

Check the order status is “Active”
Verify payment was successfully processed
Look in the event’s ticket list for the ticket ID
Check if the ticket was assigned to a different event

QR code won't scan

Ensure good lighting conditions
Check that the QR code image is clear and not damaged
Verify the scanner device is working properly
Try manual ticket ID entry as backup
Check that the event security key is configured

Duplicate validation error

Check the ticket ledger for previous validation
Verify this is not a duplicate or counterfeit ticket
Contact customer to confirm they haven’t already entered
Check system time synchronization

Event Management

Configure events before creating ticket inventory

Office Operations

Set up box offices to process ticket sales

Payment Processing

Configure payment methods for ticket purchases

Getting Started

Core Features

User Guides

Administration

​Overview

​Ticket Lifecycle

​Accessing Ticket Management

​Ticket Configuration

​Setting Up Zones

VIP Zone

General Admission

Balcony

Floor

​Zone Properties

​Creating Ticket Inventory

​Ticket Table Interface

​Table Columns

​Ticket Status Indicators

Active

Inactive

​Searching and Filtering Tickets

​Ticket Details and Actions

​Ticket Information

​Ticket Ledger

​Processing Ticket Sales

​Point of Sale Workflow

​Order Structure

​Ticket Validation

​QR Code Generation

​Validation Process

​Validation Responses

Valid Ticket

Already Used

Invalid Event

Expired

​Searching and Querying Tickets

​Query by Customer Information

​Display Ticket Information

​Ticket Reports and Analytics

​Sales Summary

Total Capacity

Tickets Sold

Available Tickets

Sales Percentage

Total Revenue

Average Price

​Sales by Zone

​Export Options

​Best Practices

Capacity Management

Zone Pricing

Color Coding

Inventory Monitoring

Validation Testing

Backup Systems

​Troubleshooting

​Related Features

Event Management

Office Operations

Payment Processing

Build docs developers (and LLMs) love

Overview

Ticket Lifecycle

Accessing Ticket Management

Ticket Configuration

Setting Up Zones

Zone Properties

Creating Ticket Inventory

Ticket Table Interface

Table Columns

Ticket Status Indicators

Searching and Filtering Tickets

Ticket Details and Actions

Ticket Information

Ticket Ledger

Processing Ticket Sales

Point of Sale Workflow

Order Structure

Ticket Validation

QR Code Generation

Validation Process

Validation Responses

Searching and Querying Tickets

Query by Customer Information

Display Ticket Information

Ticket Reports and Analytics

Sales Summary

Sales by Zone

Export Options

Best Practices

Troubleshooting

Related Features