Organization, Tax, and Loyalty

Organization pages combine information shared by every location with one store-specific tax view. Confirm the organization in the sidebar before making changes. On Store Tax Policy, also confirm the selected store.

Page and scope reference

Navigation label	Scope	Access needed	Feature needed
Overview	Organization	org.members.read	peakpos.organization
Organization	Organization	account.organization.read	peakpos.organization
PeakPOS Pricing	Organization	account.organization.read and organization-owner status	peakpos.organization
Locations	Organization list	org.members.read	peakpos.organization
Staff	Organization	both org.admin and org.members.read	peakpos.staff
Categories	Organization	org.categories.read	peakpos.catalog
Suppliers	Organization	org.suppliers.read	peakpos.catalog
Tax	Organization	tax.configuration.read or mgmt.tax.read	workspace.tax
Store Tax Policy	Selected store	store.tax.read	workspace.tax
Jurisdictions	Organization	tax.configuration.read or mgmt.tax.read	workspace.tax
Exemptions	Organization	tax.configuration.read or mgmt.tax.read	workspace.tax
Audit Log	Organization	reporting.reports.read	workspace.reporting
Loyalty Program	Organization	org.loyalty.write	workspace.loyalty
Loyalty Analytics	Organization	org.analytics.read	workspace.loyalty

A page appears only when its listed PeakPOS feature is enabled for the organization. A visible page can still show read-only or fewer controls when you do not have the additional task permission described below.

Review the organization Overview

Go to Organization > Overview to see a rollup across locations:

• Locations, Total Staff, Org Revenue, and Org Members
• The current Subscription Tier, when available
• Sales by Location and Location Summary
• Recent activity for the currently selected store

Use Refresh to request current data. The updated indicator confirms when the most recent refresh completed. Contact Peak Support to change organization settings or organization access; this page is a summary, not an editor.

Verify legal and contact information

Go to Organization > Organization to review the record used on invoices and receipts.

1. Under Profile, verify Legal name, Default currency, EIN, Tax ID, Email, Phone, and Website.
2. Under Legal/billing locations, verify the primary and other bill-from addresses.
3. To edit a POS store's operational name, address, or phone, use Locations instead.
4. To change the legal profile or legal/billing locations, contact Peak Support.

Legal/billing locations are different from POS store locations. Do not use a store-location edit to try to change the bill-from identity on an invoice or receipt.

Read PeakPOS Pricing

PeakPOS Pricing is informational only. You are not invoiced here.

Go to Organization > PeakPOS Pricing to review the Price Schedule set by your account manager. The table shows:

• Product
• Price, followed by the exact unit suffix /store/mo, /terminal/mo, or /mo

This page has no invoice list, payment controls, or editable pricing. If the page says No pricing to show, or if a displayed price needs review, contact your account manager or Peak Support.

Review and edit Locations

1. Go to Organization > Locations.
2. Review each location's Name, Address, Phone, Hours, Dual Pricing, and Active status.
3. Select a row to open Store Details.
4. If you have store.settings.write, select Edit to update the operational name, address, and phone, then select Save.
5. The same write permission shows Find wallet location. Select it, review or adjust the suggested latitude and longitude, and select Confirm wallet location. The control can also be used to re-confirm an existing wallet location.

These edits affect the store's operational identity on the POS, receipts, and contact details. Adding or removing a location, and changing invoice bill-from addresses, are Peak Support tasks.

Manage organization Staff

Go to Organization > Staff to review organization members and pending invitations.

• Staff lists the organization roster and effective roles.
• Pending Invites lists invitations that have not been accepted.
• Users with org.invites.write can select Invite Organization Staff, choose an email and Organization Role, and send the invitation.
• The same permission enables Import CSV for bulk invitations and Cancel invite for a pending invitation.

Assign only the role needed for the person's work. Store membership and store roles are managed separately from the organization roster.

Maintain Categories

Categories are one organization-wide product taxonomy shared by every store.

1. Go to Organization > Categories.
2. Review category names, hierarchy, active state, and sort order.
3. Users with both org.admin and org.categories.write can select Add Category.
4. Enter Name, optionally choose a Parent category, set Sort order, and save.
5. Use Edit to change a category or make it inactive without removing its history.
6. Use Merge when products should be reassigned into another category. Review the destination before confirming.
7. Use Import CSV for a validated bulk change; download and follow the provided template.

Delete is available only when the category has no blocking dependencies. Prefer deactivation or a deliberate merge when historical catalog and reporting continuity matters.

Maintain Suppliers

Suppliers are also organization-wide. Their product links provide the preferred supplier used by low-stock reorder drafts.

1. Go to Organization > Suppliers.
2. Select a supplier to review contact information, payment terms, and Product purchasing links.
3. Users with both org.admin and org.suppliers.write can select New Organization Supplier.
4. Enter Name and, as available, email, phone, address, and Payment terms.
5. Open a supplier to edit it or to add and remove product purchasing links. Before adding a link, select the store whose catalog contains the product; then choose the product, optionally enter Supplier SKU and Cost, choose whether it is the Default, and select Link.
6. Delete opens Deactivate Supplier. Confirming Deactivate clears that supplier's product defaults and purchasing links so low-stock reorder drafts stop using it.
7. Use Import CSV for bulk supplier records, following the downloadable template.

Use the Tax, Jurisdictions, and Exemptions pages

All three navigation labels open views of the organization Account Tax workspace:

• Tax opens Historical Rates. These rates are read-only; current checkout rates come from category tax policy.
• Jurisdictions opens Historical Jurisdictions, which summarizes scopes, active and retired rate counts, active exemptions, lowest and highest rates, and last update by jurisdiction.
• Exemptions manages customer exemption certificates.

Review historical rates and jurisdiction coverage

1. Go to Organization > Tax.
2. Select a historical rate to review its code, name, jurisdiction, scope, percentage, effective-from date, active or retired status, rate ID, and created and updated dates.
3. Go to Organization > Jurisdictions to compare scopes, active and retired rates, exemption coverage, and the lowest and highest historical rates for each jurisdiction.

Do not treat a historical account rate as the selected store's current checkout rule. Use Store Tax Policy for current store behavior.

Add or update an exemption

Viewing requires the route access shown above. Creating, editing, or deleting an exemption requires tax.configuration.write.

1. Go to Organization > Exemptions.
2. Select New Exemption.
3. Choose the Customer and exact Reason code: RESALE, GOV, NONPROFIT, EXPORT, or OTHER.
4. Enter Jurisdiction, optional Certificate #, Effective From, optional Expires On, and optional Notes.
5. Set Active, then select Save Exemption.
6. Use Edit to update an existing certificate. Clearing Active retains the record with Retired status; Delete removes it immediately without a confirmation dialog.

Verify the certificate, jurisdiction, and dates before saving. An exemption record does not change a store's base category tax policy.

Inspect Store Tax Policy

Store Tax Policy is support-owned. Merchants should use this page to inspect policy and preview checkout; contact Peak Support for policy changes.

Reading policy and running the preview require store.tax.read. The portal shows category-rule, activation, rollback, edit, and delete controls only with store.tax.write; those controls are reserved for Peak Support workflows.

1. Select the store in the sidebar.
2. Go to Organization > Store Tax Policy.
3. Review Category tax rules and their readiness mode, Effective policy, Inactive and scheduled provider rules, and Policy history and change requests.
4. Under Preview the currently effective policy, enter each line's Description, Category, Unit price, and Quantity. Use Add basket line for more items and optionally enter Customer ID to include applicable active exemption certificates.
5. Select Run same-engine preview.
6. Compare Preview total tax and each line's tax, jurisdiction/rate attribution, or exemption reason with the expected category and jurisdiction.

Products marked always tax exempt override category rules. If the page says Store tax policy unavailable, Peak Support must finish the selected store's Gateway tax connection. For any policy change, send Support the store name, category, jurisdiction, desired effective date, and an example product or transaction. Do not try to work around a missing connection or policy by altering historical account rates.

Review the Audit Log

1. Go to Organization > Audit Log.
2. Review the summary for outstanding and overdue invoices, payments recorded this month, low stock, open purchase orders, and draft invoices.
3. Filter events by All events, Accounts, Inventory, Tax, Platform, or Last 7 days.
4. Select an event to inspect its action and time, actor, area, resource, outcome, and recorded payload.
5. Use Previous and Next to move through results in groups of 50.

The outcome badge treats ok and success as successful, pending as pending, and denied, error, or failed as unsuccessful; any other recorded outcome uses the neutral style. The on-page search and Export CSV controls are marked Coming soon; use the available filters and pagination today.

Configure the Loyalty Program

The Loyalty Program page is organization-scoped and requires org.loyalty.write.

1. Go to Organization > Loyalty Program.
2. Select New Program.
3. Enter the customer-facing Program Name, Points per Dollar, Minimum Transaction ($), Points Needed for $1 Reward, and Minimum Points to Redeem.
4. Select Create, then select Manage on the program.
5. Under Tiers, use Add Tier or Edit to set Name, Min Points, and Multiplier.
6. Under Rewards, use Add Reward or Edit to set Name, Points Cost, and Description.
7. The program, tier, and reward tables also provide Delete. These controls act immediately without a confirmation dialog, so use them only when the record should be removed.

Creating a loyalty program does not enable POS loyalty prompts, contact capture, or customer-display points summaries. Settings > Settings currently exposes timezone, operating hours, and the tip prompt—not these loyalty behaviors. Contact Peak Support to change support-owned loyalty checkout behavior.

Read Loyalty Analytics

Go to Organization > Loyalty Analytics to review:

• Total Enrollments and Enrollment Trends
• Points Redeemed and Point Redemptions by reward
• Customer Segments
• Top Customers, including points, visits, and spend

If the banner says Loyalty is not enabled, the zero or empty metrics describe an inactive program, not a live program with no activity. Set up Loyalty Program and Open Loyalty Program appear only with org.loyalty.write. Top-customer names link to customer loyalty details only with org.loyalty.read; fallback Open Customers links appear only with store.customers.read.