Reporting reference

Choose the grain and fields that match the business question

A grain describes what one row represents. Select it before choosing the chart or measure so totals are not multiplied or interpreted as the wrong business event.

How to use this page

Write the question, choose the grain where one row matches the object being measured, select a field and aggregation, then verify the result against a detailed table or source summary.

Xero reporting reference

Finance, invoice and payment grains

Financial Summary

Grain: One Trial Balance-derived account and reporting-date summary row.

Use for P&L, balance sheet, revenue, expenses and account movement. Do not use for invoice or payment drill-down.

FinancialSummary.ReportingAmountFinancialSummary.YTDNetAmountFinancialSummary.DebitAmountFinancialSummary.CreditAmountFinancialSummary.PeriodMonthFinancialSummary.ReportSectionFinancialSummary.AccountNameFinancialSummary.AccountCode

Financial Activity

Grain: One reconstructed accounting activity line.

Use for source type, line role and tracking analysis where official journal access is unavailable. It is not official-ledger parity.

FinancialActivity.ReportingAmountFinancialActivity.DateFinancialActivity.SourceTypeFinancialActivity.PLSectionFinancialActivity.BalanceSheetSectionFinancialActivity.TrackingOption1FinancialActivity.TrackingOption2

Invoice Summary

Grain: One row per live invoice or bill.

Use for invoice totals, due dates, paid and outstanding amounts, and customer or supplier value.

Invoice.GrossAmountInvoice.NetAmountInvoice.TaxAmountInvoice.OutstandingGrossInvoice.AmountPaidInvoice.InvoiceTypeInvoice.DateInvoice.DueDateContact.Name

Invoice Lines

Grain: One row per live invoice or bill line.

Use for item, product, tracking, net, tax and gross analysis. Do not use for invoice ageing.

InvoiceLine.NetAmountInvoiceLine.TaxAmountInvoiceLine.GrossAmountInvoiceLine.ItemCodeInvoiceLine.TrackingOption1InvoiceLine.TrackingOption2InvoiceLine.DateItem.Name

Payments

Grain: One row per authorised payment.

Use for receipts, supplier payments and settlement timing. Do not use for revenue recognition.

Payment.AmountPayment.DateAccount.NameAccount.TypeContact.Name

Official Ledger Lines

Grain: One row per available Xero journal line.

Use only where journal access is available in the purchased source tier.

HubSpot reporting reference

Company, contact, deal and activity grains

Companies

Grain: One row per HubSpot company.

Use for company counts, lifecycle, owner, industry, country and account activity summaries.

Company.CountCompany.ActiveCountCompany.ActivityCountCompany.ContactedActivityCountCompany.CreatedDateCompany.LastSalesActivityDate

Contacts

Grain: One row per HubSpot contact.

Use for contact counts, lifecycle, owner, company association and contact activity summaries.

Contact.CountContact.ActiveCountContact.ActivityCountContact.ContactedActivityCountContact.CreatedDateContact.LastSalesActivityDate

Deals

Grain: One row per HubSpot deal.

Use for pipeline, stage, value, owner, won/lost and sales-cycle reporting.

Deal.AmountInCompanyCurrencyDeal.WeightedAmountInCompanyCurrencyDeal.CountDeal.DaysOpenDeal.CreatedDateDeal.CloseDateDeal.IsClosedDeal.IsWonDeal.OwnerDeal.Stage

Activities

Grain: One row per call, email, meeting, task or note.

Use for activity volume, owner work, outcome, status and engagement timing.

Activity.CountActivity.EmailCountActivity.CallCountActivity.MeetingCountActivity.TaskCountActivity.CallDurationMinutesActivity.TypeActivity.DateActivity.OutcomeActivity.Status

Companies House reference

New Company Snapshot

New Company Snapshot

Grain: One row per active company incorporated in the configured discovery window.

Use for new-company counts and research by sector, SIC section, town, postcode area and incorporation month. It does not contain verified contact, officer or credit-risk data.

Company.ActiveCountCompany.AgeDaysCompany.AgeYearsCompany.NameCompany.NumberCompany.PrimarySectorGroupCompany.PrimarySICSectionLocation.TownLocation.PostcodeAreaLink.CompaniesHouseLink.GoogleSearch

Datplan Demo reference

Practice grains included with the free app

Invoice Summary

Grain: One row per demo invoice header.

Use for invoice value by month, status, currency or customer.

Invoice.DateInvoice.DueDateInvoice.StatusInvoice.CurrencyInvoice.SubtotalInvoice.TaxInvoice.Total

Invoice Lines

Grain: One row per demo invoice line.

Use for quantity, unit price, product and line-value analysis.

InvoiceLine.DateInvoiceLine.QuantityInvoiceLine.UnitPriceInvoiceLine.NetAmountProduct.NameProduct.Category

Payments

Grain: One row per demo payment.

Use for payment amount by date or method.

Payment.DatePayment.MethodPayment.Amount

Bank Transactions

Grain: One row per demo bank transaction.

Use for transaction amount by account, type or date.

BankTransaction.DateBankTransaction.TypeBankTransaction.DescriptionBankTransaction.AmountAccount.Name

Journal Lines

Grain: One row per demo journal line.

Use for debit, credit and movement by account and date.

Journal.DateJournal.DescriptionJournal.DebitJournal.CreditJournal.MovementAccount.Name

Dashboard recipes

Reliable starting points

QuestionGrainCategoryMeasureAggregation and filters
Xero revenue by monthFinancial SummaryPeriod monthReporting amountSUM; Report section = Revenue; Month-end snapshot
Xero outstanding invoices by due monthInvoice SummaryDue monthOutstanding grossSUM; select receivable or payable invoice type
Xero sales by itemInvoice LinesItem name or codeLine net amountSUM; sales invoice type
HubSpot open pipeline by stageDealsDeal stageAmount in company currencySUM; Is closed = false
HubSpot activities by ownerActivitiesActivity ownerActivity countSUM; choose the required activity-date period
Companies by sectorNew Company SnapshotPrimary sector groupActive company countSUM
Demo invoice value by statusInvoice SummaryInvoice statusInvoice totalSUM
Demo journal movement by accountJournal LinesAccount nameJournal movementSUM; choose the required date period
Field availability can vary. Source permissions, selected tier, endpoint support and source records determine what is present. Review the app’s current table and run output before building a production report.

See Datplan with real reporting data—without connecting a live account

The Windows app is free to download and includes Datplan Demo data, so you can test sync, dashboards, reporting grains and exports first.