SIGNALS Docs
Exit Reader View
100%
Theme

Reader View

Company Details

Configure company identity, locale, and fiscal year in Admin › Setup.

Overview

Company Details is the primary identity and locale screen for your Signals instance. Changes save to the settings table and reload the page so the global header reflects the company name.

Where it lives

Route: /admin/settings/company (admin.settings.company)

Open Admin → Setup → Company Details. Requires admin access (EnsureAdmin middleware).

Key fields

Field Setting key Notes
Company Name company.name Required
Country company.country_code ISO alpha-2; changing country auto-fills related defaults
Timezone company.timezone PHP timezone identifier
Currency company.base_currency ISO 4217 from enabled currencies. This is the reporting base — see the warning below before changing it
Date / Time Format company.date_format, company.time_format Display defaults
Fiscal Year Start company.fiscal_year_start Month 1–12

Tax rates live on the tax engine (Admin → Money & Pricing → Tax Rates and Tax Rules), not on this screen. First-run setup still prompts for a standard rate and writes it to the seeded Standard TaxRate row.

Changing the base currency

Every rental, invoice, credit note, purchase order, and rental cost records its company-base amount at the moment it is written. Those stored amounts are what dashboards, the report builder, project rollups, and exports add up — nothing looks up a live rate at read time.

Changing company.base_currency therefore leaves every existing document holding a figure computed against the original base. The save succeeds, but it turns into a warning naming the repair, and the audit event records rebuild_required. Run:

php artisan signals:rebuild-base-amounts

Until you do, base-labelled totals across the platform are wrong. It also affects warehouses that inherit the base currency rather than naming their own. See Multi-Currency & Tax.

Workflows

  1. Edit fields and click Save Changes.
  2. Changing Country pulls timezone, currency, and date/time defaults from the country record when available.
  3. On mount, countries and currencies are seed-checked if missing.