HomeKnowledge baseFresha academy
Data connector Tables
Back
  1. Knowledge base•
  2. Reports and Insights•
  3. Data connector Tables

Data connector Tables

In this guide, you'll learn how to calculate key metrics from Data connector tables for bookings, clients, payments, sales, and more to uncover trends and evaluate your business's performance.

In this article

  • Bookings
  • Clients
  • Payments
  • Sales
  • Sale items
  • Tips
  • Commissions
  • Service charges
  • Occupancy
  • Products
  • Locations
  • Services
  • Team members
  • Stock movements
  • Stock orders
  • Reviews

Bookings

The bookings table contains a list of booked services associated with each appointment. Each record in this table represents a booked service and can be linked to its corresponding appointment through the appointment_id, reflecting a one-to-many relationship.

This dataset includes all booking statuses, such as cancelled, no-show, future scheduled, and past bookings.

Key metrics

Bookings can be used to derive useful metrics around:

  • Appointment sources
    Using channel, which describes where the booking was made and the booking behaviors of your clients
  • Cancellation and no show rates
    Using is_cancelled, is_no_show and cancelled_date to determine how cancellations are impacting your business
  • Client retention
    Using client_id, it’s possible to determine how many bookings are coming from new vs existing clients and observe rebooking rates for acquired customers
  • Popular booking times
    Using scheduled_date, you can look for peaks in demand and plan accordingly
  • Average time between appointments
    Using scheduled_date and client_id, you can calculate the average time between appointments for each of your clients
  • Upcoming bookings
    Using scheduled_date, you can identify upcoming bookings, which can be used to forecast sales and plan your team's schedule

Available columns

ColumnDescription
Booking IDPrimary key of the table. Unique identifier for each booking
Appointment IDIdentifier for each appointment
Location IDIdentifier for the booking's location
Team Member IDIdentifier for the team member chosen to provide the service
Client IDIdentifier for the client who received the service
Service IDIdentifier for the service provided during the booking
Created by team member IDIdentifier of the team member who created the booking
Cancelled by team member IDIdentifier of the team member who Cancelled the booking, if applicable
Scheduled dateDate the booking is scheduled for
Created dateTimestamp of when the booking was created, in local time
Scheduled timeTimestamp of when the booking is scheduled for, in local time
Start timeBooking start time, in local time
End timeBooking end time, in local time
Appointment slotTime slot for the appointment, in local time
DurationDuration of the service provided in minutes
Cancelled dateTimestamp of the booking cancellation in local time, if applicable
LocationName of the location for the booking
Team memberName of the team member chosen to provide the service
ClientName of the client who received the service
Client genderGender of the client, if available
CategoryName of the service's category
ServiceName of the service provided during the booking
SKUStock Keeping Unit for the service or product, if applicable
Created byName of the team member who created the booking
Cancelled byName of the team member who Cancelled the booking, if applicable
Is requestedIndicates if the team member was requested to provide the service
Appointment referenceReference number for the appointment
Appointment channelChannel through which the appointment was made
StatusCurrent status of the booking (e.g. completed, cancelled)
Is cancelledIndicates if the booking was cancelled
Is no showIndicates if the client did not show up for the booking
Is onlineIndicates if the booking was made online
Cancellation reasonReason for the booking cancellation, if applicable
Appointment typeType of appointment (e.g. first-time or returning)
Gross saleGross sale amount for the service provided
DiscountsDiscounts applied to the service provided
Net saleNet sale amount after discounts
Fees chargedFees charged for Cancelled / no-show bookings
Upfront paymentsTotal value of upfront payments on the booking, if applicable
Appointments reviewedNumber of reviews for the appointment, if applicable
Average appointment review ratingAverage rating from appointment reviews, if applicable
Appointment notesNotes or comments provided for the appointment, if applicable

Clients

The clients table contains client information and their appointment history. Each record represents a unique client, identified by the client_id.

This table serves as the primary source for analyzing client demographics, engagement, and booking patterns. It can be linked to other tables, such as bookings or payments, via client_id.

This table is a key resource for planning CRM campaigns, as it provides essential client information such as gender, age, phone number, and email, enabling tailored communications.

Key metrics

Clients can be used to derive useful metrics around:

  • New and returning clients
    A new client is identified as someone who has exactly one appointment. At Fresha, a returning client is defined as someone who had an appointment with you before. Using total_appointments, it's possible to identify those clients that have come more than once (returning) or only once (new clients), this can help you understand your retention rate
  • Rebooked
    Using is_rebooked, it’s possible to determine how many clients have appointments scheduled for the future
  • Days since last appointment
    Using last_appointment_date, it's possible to calculate the number of days since the most recent scheduled appointment
  • Reviews
    Using reviews, you can identify top reviewers and, by combining it with total_appointments, calculate the review rate

Available columns

ColumnDescription
Client IDPrimary key of the table. Unique identifier for the client
Sign up dateDate when the client signed up
First appointment dateDate of the client's first appointment, if applicable
Last appointment dateDate of the client's most recent appointment, if applicable
ClientFull name of the client
GenderGender of the client, if available
AgeAge of the client, if available
Mobile numberMobile phone number of the client, if available
EmailEmail of the client
Is rebookedIndicates if the client has an appointment scheduled for the future
Referral sourceSource through which the client was referred, if applicable
Last appointment locationLocation of the client's most recent booking, if applicable
Last appointment withName of the team member who handled the client's most recent appointment, if applicable
Total appointmentsTotal number of appointments booked by the client
Total appointment valueTotal value of all appointments booked by the client
ReviewsTotal number of reviews provided by the client

Payments

The payments table contains detailed records of all payments associated with various transactions, such as product sales, refunds, appointment fees, and cancellation and no-show fees.

Each record represents a payment event, uniquely identified by the sale_number, which serves as the primary key.

The table also captures gift card and deposit (i.e. upfront payments) transactions, maintaining separate records for both the sale and redemption of gift cards, as well as for the collection and application of deposits.

The table reflects a many-to-one relationship, where multiple payments can be linked to a single sale, appointment, client, or location through sale_id, appointment_id, client_id, or location_id, respectively.

The payments table includes all transactions linked to a sale and hence involving a client, whereas the cash flow data connector table captures a broader range of financial movements across the business, including all wallet transactions (both inflows and outflows) such as fees, blast messages, and other financial activities.

Key metrics

Payments can be used to derive useful metrics around:

  • Gift card sales and collection
    Using sale_id, you can join this table with the gift_cards table to calculate the number of gift cards sold and the payments collected for them
  • Gift card redemption & usage
    Using is_gift_card_redemption, you can track gift card usage and identify seasonal trends or periods when gift cards are redeemed most frequently
  • Deposit redemption
    Using is_deposit_redemption, it’s possible to determine the amount of payments made through a deposit
  • Amount of refunds and total refunded value
    Using transaction_type and refund_amount, it's possible to identify those payments that were refunds and calculate the total value refunded

Available columns

ColumnDescription
Sale numberPrimary key of the table. Unique identifier for the sale (invoice number)
Payment numberPayment reference number
Appointment referenceReference number for the associated appointment
Sale IDIdentifier for the sale
Appointment IDIdentifier for the associated appointment
Location IDIdentifier for the location of the transaction
Team member IDIdentifier for the team member associated with the transaction
Client IDIdentifier for the client associated with the transaction
Payment dateTimestamp of when the payment was made, in local time
Sale dateTimestamp of when the sale was recorded, in local time
LocationName of the location where the transaction occurred
Team memberName of the team member handling the transaction
ClientName of the client involved in the transaction
Gift card codeCode for the gift card used in the transaction, if applicable
Transaction typeType of transaction (e.g. sale, refund)
Is deposit redemptionIndicates if the payment was a deposit redemption
Is gift card redemptionIndicates if the payment was a gift card redemption
Payment methodMethod of payment used in the transaction
Currency codeCurrency used for the transaction
AmountTotal amount for the transaction
Refund amountAmount refunded in the transaction, if applicable
Payment amountAmount paid in the transaction
Change amountChange amount returned in the transaction

Sales

The sales table contains a comprehensive listing of all sales transactions, with each record representing a unique sale event, identified by the sale_id.

The table includes key transaction details such as the sale number, payment status, transaction type, and various financial metrics (e.g., total sales, gross sales, net sales, refunds, discounts).

It also tracks sales-related attributes, including the location, team member, client, appointment, and the items involved in the transaction. The table establishes many-to-one relationships with locations, team_members, clients, or appointments.

Key metrics

Sales can be used to derive useful metrics around:

  • Discounted value
    using discounts and gross_sales, you can calculate the percentage of sales value attributed to discounts
  • Taxed value
    Using total_taxes and gross_sales, you can determine the percentage of sales value subject to taxes and calculate the average tax rate
  • Service charge 
    Using service_charges and gross_sales, you can calculate the percentage of sales value attributed to service charges
  • Tips
    Using total_tips and client, you can determine the percentage of sales that received a tip, calculate the average tip value, and identify the clients providing the tips
  • Open invoices
    Using payment_status, it's possible to identify unpaid sales and track open invoices. Additionally, you can calculate payment rates to assess how much of the sales have been paid

Available columns

ColumnDescription
Sale IDPrimary key of the table. Unique identifier for the sale
Sale numberInvoice number for the sale
Location IDIdentifier for the location of the sale
Team member IDIdentifier for the team member associated with the sale
Client IDIdentifier for the client linked to the sale
Appointment IDIdentifier for the associated appointment
Sale dateTimestamp of when the sale occurred, in local time
LocationName of the location where the sale took place
ClientName of the client involved in the sale
Client genderGender of the client, if available
Team memberName of the team member handling the sale
StatusCurrent status of the sale
Appointment channelChannel through which the appointment was booked
Payment methodPayment method used for the sale
Transaction typeType of transaction (e.g. sale, refund)
Payment statusCurrent status of the payment
Service chargeName of the service charge applied, if applicable
Client sourceOrigin of client acquisition
Client retention sourceIndicates if the sale was the client's first sale or a returning sale
Items soldQuantity of items sold in the transaction
Total salesTotal amount of sales before adjustments
Gross salesGross sales amount
Net salesNet sales amount after adjustments
Total refundsTotal refund amount for the sale
Total discountsTotal discount amount applied to the sale
Total tipsTotal amount of tips collected
Total paymentsTotal amount of payments made for the sale, excluding redemptions
Total taxesTotal tax amount for the sale
Total service chargesTotal amount of service charges applied
Total gift cardsNet sales amount paid via gift cards
Total change amountTotal change amount returned to the client
Amount dueTotal amount due for the sale
Total payments and redemptionsSum of total payments, gift card redemptions, and deposit redemptions
Total gift card redemptionsTotal amount redeemed via gift cards
Total service charge taxesTotal taxes associated with service charges
Gift card taxesTaxes paid via gift cards
Currency codeCurrency used for the sale

Sale items

The sale items table contains detailed records of individual items within sales transactions. Each record represents a unique sale item identified by the sale_item_id.

The table has a one to many relationship with sales and bookings, which can be examined using sale_id and booking_id, respectively.

It tracks item-specific financial data like discounts, refunds, and taxes, as well as other attributes such as item category, supplier, brand, and SKU.

Key metrics

Sale items can be used to derive useful metrics around:

  • Average net sales per item
    Using net_sales and quantity, you can calculate the average net sales per item sold
  • Margin
    Using net_sales and cost_price, it's possible to determine the profit margin and margin percentage for each sale, providing insights into profitability
  • Client returning sales
    Using client_id and client_retention_source, you can analyze client behavior and calculate the proportion of first-time sales versus returning sales
  • Popular sale times
    Using sale_date, you can identify sales peaks and plan resources or promotions accordingly
  • Main value contributors
    Using category, item, team_member, or client alongside gross_sales, you can gain insights into which categories, items, team members or clients are creating the most value for your business
  • Discounts
    Using discount_type, sale_date, and discounts, it's possible to analyze which discounts are being applied, when they are used, and the average discount value

Available columns

ColumnDescription
Sale item IDPrimary key of the table. Unique identifier for the sale item
Sale IDIdentifier for the sale associated with the item
Booking IDIdentifier for the booking linked to the sale item
Location IDIdentifier for the location of the sale item
Merchant IDIdentifier for the merchant handling the sale item
Team member IDIdentifier for the team member associated with the sale item
Client IDIdentifier for the client linked to the sale item
Sale dateTimestamp of the sale, in local time
Sale numberInvoice number for the sale
Sale statusCurrent status of the sale
LocationName of the location where the sale item was purchased
Team memberName of the team member handling the sale item
MerchantName of the merchant handling the sale item
ClientName of the client linked to the sale item
Client genderGender of the client linked to the sale item, if available
Client sourceOrigin of client acquisition
Client retention sourceIndicates if the sale was the client's first sale or a returning sale
Client mobileMobile number of the client, if available
Discount categoryCategory of the discount applied to the sale item
Discount typeType of discount applied to the sale item
Discount nameName of the discount applied to the sale item
Appointment channelChannel through which the appointment was booked
Appointment referenceReference number for the associated appointment
Transaction typeType of transaction (e.g. sale, refund)
Payment methodMethod of payment used for the sale item
Sale typeType of the sale item (e.g., product, gift card)
CategoryCategory of the sale item
ItemName of the sale item
SupplierName of the supplier for the sale item, if available
BrandBrand of the sale item, if available
SKUStock Keeping Unit for the sale item, if available
BarcodeBarcode for the sale item, if available
Is upsellIndicates whether the sale item was sold on the appointment date as an upsell
Currency codeCurrency used for the sale
QuantityQuantity of the sale item sold
Gross salesGross sales amount for the item
DiscountsTotal discounts applied to the sale item
Cart discountsDiscounts applied to the whole cart value
Item discountsDiscounts applied to single items
RefundsTotal refunds applied to the sale item
Net salesNet sales amount for the item after discounts and refunds
Taxes on net salesTaxes applied to the net sales amount
Total salesTotal sales amount for the item
CostCost price of the sale item, if applicable

Tips

The tips table contains detailed records of tips collected and refunded during sales transactions. Each record represents a unique tip transaction, identified by the tip_id.

The table has a many-to-one relationship with sales, clients, locations, and team members, among others.

Available columns

ColumnDescription
Tip IDPrimary key of the table. Unique identifier for the tip transaction
Sale IDIdentifier for the sale associated with the tip
Sale numberInvoice number for the sale associated with the tip
Location IDIdentifier for the location where the tip was collected
Team member IDIdentifier for the team member who received the tip
Client IDIdentifier for the client who provided the tip
Tip dateDate when the tip was collected
Team memberName of the team member who received the tip
ClientName of the client who provided the tip
Client genderGender of the client who provided the tip, if available
LocationName of the location where the tip was collected
Transaction typeType of transaction associated with the tip
Tip channelChannel through which the tip was provided
Payment methodPayment method used for the tip transaction
Tips collectedTotal amount of tips collected
Tips refundedTotal amount of tips refunded
Client retention sourceIndicates if the sale was the client's first sale or a returning sale
Currency codeCurrency used for the tip transaction

Commissions

The commissions table contains detailed records of commissions earned by team members on sales transactions. Each record represents a unique commission transaction, identified by the commission_id. The table captures details about sales, clients, locations, and team members, along with financial metrics such as gross sales, taxes, and commissions.

The table reflects a many-to-one relationship, where multiple commissions can be linked to a single sale, location, or client through sale_id, location_id, or client_id.

Available columns

ColumnDescription
Commission IDPrimary key of the table. Unique identifier for the commission transaction
Sale IDIdentifier for the sale associated with the commission
Sale item IDIdentifier for the specific item sold that generated the commission
Sale numberInvoice number for the sale associated with the commission
Location IDIdentifier for the location where the sale occurred
Team member IDIdentifier for the team member who earned the commission
Client IDIdentifier for the client who made the purchase
Sale dateTimestamp of when the sale occurred
ClientName of the client who made the purchase
Team memberName of the team member who earned the commission
LocationName of the location where the sale occurred
Sale itemName of the item sold that generated the commission
Sale typeType of sold item (e.g. gift card, product, membership, etc)
Service categoryCategory of the service or product sold
SKUStock Keeping Unit for the sold item, if applicable
Gross salesTotal gross sales amount for the transaction
TaxTotal tax amount applied to the sale
DiscountsDiscounts applied to the sale
CostBase amount on which the commission is calculated
Commission baseTotal commission earned for the sale
Percentage commissionCommission as a percentage of the commission base
Currency codeCurrency used for the transaction

Service charges

The service charges table contains service charges applied during sales transactions. Each record represents a unique service charge, identified by the service_charge_id. The table captures details about sales, locations, team members, clients, and financial metrics such as flat rates, percentage rates, and total amounts.

The table reflects a many-to-one relationship, where multiple service charges can be linked to a single sale, location, client or team member through sale_id, location_id, client_id, or team_member_id.

Available columns

ColumnDescription
Service charge IDPrimary key of the table. Unique identifier for the service charge
Sale IDIdentifier for the sale associated with the service charge
Location IDIdentifier for the location where the service charge was applied
Team member IDIdentifier for the team member associated with the service charge
Client IDIdentifier for the client associated with the service charge
Service charge dateDate when the service charge was applied
Service chargeName of the service charge applied
LocationName of the location where the service charge was applied
Team memberName of the team member associated with the service charge
ClientName of the client associated with the service charge
Service charge flat rateFlat rate of the service charge applied
Service charge percentage ratePercentage rate of the service charge, expressed as a decimal
Net amountNet amount of the service charge, excluding taxes
TaxTotal tax amount applied to the service charge
Total amountTotal amount of the service charge, including taxes
Currency codeCurrency used for the service charge transaction

Occupancy

The occupancy table contains detailed records of employee occupancy and shift data. Each record represents a unique combination of team member, location, and date, identified by the occupancy_employee_pk. The table provides a summary of scheduled shifts, time off, and occupancy rates.

Available columns

ColumnDescription
Occupancy employee PKPrimary key of the table. Unique identifier for the occupancy record
Location IDIdentifier for the location where the employee shift occurred
Team member IDIdentifier for the team member associated with the shift
DateDate of the shift
LocationName of the location where the shift occurred
Team memberName of the team member associated with the shift
Shift minutesTotal minutes the team member worked during the shift
Time off minutesTotal minutes the team member took off during the shift
Blocked minutesTotal minutes during which the team member's time was blocked and unavailable
Available minutesTotal minutes the team member was available for shifts
Booked minutesTotal minutes the team member was booked for shifts
Unbooked minutesTotal minutes the team member was available but not booked for shifts, calculated as available_minutes - booked_minutes
Occupancy rateRatio of booked minutes to available minutes, calculated as booked_minutes / available_minutes. If available minutes is 0, the value is set to null

Products

The products table contains all products offered for sale, including information about suppliers, brands, and product specifications. Each record represents a unique product, identified by the product_id.

Available columns

ColumnDescription
Product IDPrimary key of the table. Unique identifier for the product
Supplier nameName of the supplier providing the product, if available
Brand nameName of the brand of the product, if available
Product nameName of the product
Category nameCategory to which the product belongs, if available
SKUStock Keeping Unit for the product, if applicable
BarcodeBarcode associated with the product, if applicable
Has descriptionIndicates whether the product has a description available
Has imageIndicates whether the product has an image available
Has unlimited stockIndicates whether the product has unlimited stock availability
UnitsQuantity of the product available, represented in the unit of measure, if applicable
Unit of measureUnit of measure used for the product quantity (e.g. millilitres, kilograms), if applicable
Cost priceCost price of the product
Retail priceRetail price of the product

Locations

The locations table provides a list of all your business' locations, including those that have been deleted. Each record uniquely represents a location, identified by the location_id.

Available columns

ColumnDescription
Location IDPrimary key of the table. Unique identifier for the location
NameName of the business location
PhonePhone number associated with the location
EmailEmail address associated with the location
Deleted atTimestamp indicating when the location was deleted, if applicable

Services

The services table provides a list of all services offered by your business. Each record represents a unique service, identified by the service_id. The table includes information about the service's name, description, and whether it has been deleted.

Available columns

ColumnDescription
Service IDPrimary key of the table. Unique identifier for the service
NameName of the service
DescriptionDescription of the service
Deleted atTimestamp indicating when the service was deleted, if applicable

Team members

The team members table provides a list of all team members in your business, including their personal and employment information. Each record represents a unique team member, identified by the team_member_id. The table includes information such as name, contact details, role, and employment dates, along with the status of the team member (whether deleted or active).

Available columns

ColumnDescription
Team member IDPrimary key of the table. Unique identifier for the team member
First nameFirst name of the team member
Last nameLast name of the team member
Full nameFull name of the team member
Mobile numberMobile phone number of the team member
EmailEmail address of the team member
RoleJob role of the team member
Staff titleTitle given to the team member in Fresha UI
External IDTeam member ID input in Fresha UI
Employment start dateDate when the team member started their employment
Employment end dateDate when the team member ended their employment, if applicable
Deleted atTimestamp indicating when the team member record was deleted, if applicable

Stock movements

This table contains all product stock quantity adjustments, including sales, stock received from purchase orders, and manual adjustments. Each record represents a single stock movement event. Only movements for active (non-deleted) products are included.

Available columns

ColumnDescription
stock_movement_idPrimary key. Unique identifier for the stock movement
location_idIdentifier for the location where the movement occurred
sale_idIdentifier for the associated sale, if applicable
sale_dateTimestamp of when the stock movement was created, in local time
locationName of the location
supplierName of the product supplier, if available
brandName of the product brand, if available
categoryCategory of the product, if available
productName of the product
primary_skuStock Keeping Unit for the product, if applicable
barcodeBarcode associated with the product, if applicable
is_unlimitedWhether the product had unlimited stock at the time of this movement
adjustment_reasonReason for the stock adjustment (e.g. Sold, Internal, New Stock, Damaged, Lost, Order Purchase, Return, etc.)
adjustment_refReference for the adjustment, either a sale invoice number or purchase order reference number
quantityNumber of units adjusted (positive for stock added, negative for stock removed)
unit_costCost price per unit at the time of adjustment
costTotal cost of the adjustment (quantity × unit cost)
retail_priceCurrent retail price of the product

Stock orders

This table contains all purchase order line items, tracking stock ordered from suppliers. Each record represents a single product line on a purchase order. Relates to the products table via product id and to stock movements when stock is received.

Available columns

ColumnDescription
order_item_idPrimary key. Unique identifier for the order line item
order_idIdentifier for the parent purchase order
location_idIdentifier for the location the stock was ordered for
ordered_by_team_member_idIdentifier for the team member who placed the order
product_idIdentifier for the product ordered
ordered_atTimestamp of when the order was placed, in local time
expected_atExpected delivery date for the order
received_atTimestamp of when the stock was received, if applicable
locationName of the location
team_memberName of the team member who placed the order
supplier_nameName of the supplier
brand_nameName of the product brand, if available
product_nameName of the product
category_nameCategory of the product, if available
reference_numberPurchase order reference number
order_statusCurrent status of the order (e.g. Pending, Received, Cancelled)
ordered_quantityNumber of units ordered
received_quantityNumber of units received
cancelled_quantityNumber of units cancelled
pending_quantityNumber of units still pending delivery
average_unit_costAverage cost per unit
total_costTotal cost of the order line item

Reviews 

This table contains appointment reviews submitted by clients. Each record represents a single review linked to an appointment.

Available columns

ColumnDescription
review_idPrimary key. Unique identifier for the review
appointment_idIdentifier for the appointment that was reviewed
location_idIdentifier for the location where the appointment took place
client_idIdentifier for the client who submitted the review
ratingNumerical rating given by the client for the appointment
review_statusStatus of the text review (e.g. Published, Declined, Waiting for Verification)
review_textText content of the review submitted by the client, if any
published_atTimestamp of when the review was published, in provider local time

Data connector

Was this guide helpful?

Data connector

Data connector overview

Sync your data with external tools, eliminating the need for manual exports and uploads.

Create new Data connections

Connect your business data to a variety of business intelligence and analytics tools.

Manage your Data connections

Seamlessly integrate with over 40 platforms by setting up data connectors.

Data connector Tables

Analyze your business performance effectively by exploring data connector tables.

Fresha
Get the app

About Fresha

Careers

Help and support

Blog

Sitemap

For business

For partners

Pricing

Features

Scheduling

Point of sale

Payments

Capital

Marketplace

Support

Status

Legal

Privacy Policy

Terms of service

Terms of use

Find us on social

Facebook
Linkedin
Instagram

© 2026 Fresha.com SV Ltd