Haruno Knowledge base

Adding a company

Add a company from QuickBooks or by hand, give it its files, let Haruno suggest how to read them, approve that, and close the first month.

  • Mac appAvailable
  • Windows appAvailable

Every company starts with Add company. It is the plus button in the Portfolio toolbar, Books ▸ Add company…, or the button on the empty Portfolio.

The Add company sheet when adding by hand.
The Add company sheet with a company name field, reporting currency and fiscal year-end month pickers, and a collapsed optional details sectionThe Add company sheet with a company name field, reporting currency and fiscal year-end month pickers, and a collapsed optional details section

Two ways to add one

When the account has QuickBooks companies to offer, the sheet has a switch with From QuickBooks and Add manually. Without QuickBooks it shows the manual form only.

From QuickBooks

The sheet lists the QuickBooks companies of your organization that are not on this Mac yet. If you work on your own, it lists your own. Pick one and press Add to this computer.

  • A company that is already connected is added and Haruno starts fetching its months.
  • A company whose connection has lapsed is added. Its page then asks you to sign in to QuickBooks again, and you press Sync there to fetch its months.
  • A company you archived on this Mac is listed as archived. Pick it and press Restore to bring it back with its books as they were.
  • If books with the same name are already on this Mac, the button says Link. It links those books to the QuickBooks company. No new company is made.

For a company that is not listed, press Company not listed?, then Connect to QuickBooks. Haruno opens QuickBooks' own sign-in page in your browser. Finish signing in there, and Haruno brings the company in. If your account does not have the right to add companies, the sheet says that an administrator of your organization does it.

The sheet also shows a data notice, with a link to the Data Processing Disclosure. It says that a sync keeps a copy of the company's QuickBooks records on this Mac, including customer and vendor names. See QuickBooks sync.

Add manually

Type the Company name. A name that cannot be used, or that your portfolio already has, is refused under the field. Then choose two things:

  • Reporting currency. Without one, a statement that prints only a "$" cannot be filed.
  • Fiscal year-end month.

Company details (optional) holds the address, the country, the tax jurisdiction, the legal entity type and the EIN, which is the company's US tax number. You can fill these in later.

Press Save. The company's folder is created and its page opens.

Setting the company up

A new company has no figures yet. Its page shows four steps.

  1. Add data

    Drop the company's files on the page, or use Upload files or Open a folder. Haruno takes Excel (.xlsx), CSV and PDF files, including those in subfolders. It copies them and leaves your originals where they are. If a file with the same name is already there, Haruno keeps both and numbers the new one. You can also use Books ▸ Import Exports….

    Each file gets a row with the kind Haruno read it as, such as reporting package, budget or reconciliation. A file it cannot place says Not claimed. A file that is another company's export is flagged as Another company's export.

  2. Analyze data

    Press Analyze data. Haruno reads the files and suggests how to organize the figures for the reports: which account goes on which line of the statements. A progress bar shows the work, and Stop reading stops it. Nothing is saved until you approve.

    A close needs a balance sheet and a profit and loss. If the files hold neither, the page says so and asks you to add them first.

  3. Review suggestions

    Haruno lists what it is unsure about under Needs your attention, and what it read straight from the files under Check and confirm. Answer what you can. Preview changes shows what your answers would do without saving. Approve mapping saves them. If there is nothing to ask, the page says so.

  4. Ready to close

    Press Close month… to make the company's first report. You see what the close will do before anything is saved. See Closing a month.

After the first close the page shows its seven tabs. See A company's page.

Mapping

The mapping is the list that says which of the company's accounts goes on which statement line. Haruno's suggestions are that list. You can review it again later. See Mappings.

Redoing the analysis

Analyze data again reads the files again and makes new suggestions. It replaces the answers you gave, and Haruno asks you first. Delete suggestions removes the suggestions and your answers. The company's files stay.

Other ways in

  • Books ▸ Import Books from a Folder… brings in books kept by an older version of Haruno.
  • A company that is read from the published statements in an annual report is not added here. See Annual reports in a project.

What to tell a customer

Adding a company takes a few minutes. The customer gives Haruno the company's files, or connects QuickBooks. Haruno suggests how to read them. The customer checks the suggestions and approves them. Nothing is closed or sent until they say so.

Last updated · PR #2944 · View this version on GitHub

History (1 version)
  1. Internal knowledge base for staff: site, reader keys, assistant, 197 pages and the PR rule (#2944)
    What changed
    @@ -0,0 +1,88 @@
    +---
    +title: Adding a company
    +summary: Add a company from QuickBooks or by hand, give it its files, let Haruno suggest how to read them, approve that, and close the first month.
    +feature: add-company
    +covers:
    +  - apple/Sources/CFOFeature/Shell/CFOAddClientSheet.swift
    +  - apple/Sources/CFOFeature/Shell/CFOEmptyPortfolioView.swift
    +  - apple/Sources/CFOFeature/Shell/CFOOnboardingScreen.swift
    +  - apple/Sources/CFOFeature/Workflow/CFOClientSetupScreen.swift
    +  - apple/Sources/CFOFeature/Workflow/CFOProposeStep.swift
    +  - apple/Sources/CFOFeature/Workflow/CFOFilesFoundSection.swift
    +  - apple/Sources/CFOFeature/Workflow/CFOImportCoordinator.swift
    +  - apple/docs/file-ingestion.md
    +---
    +
    +Every company starts with <Ui>Add company</Ui>. It is the plus button in the Portfolio toolbar, <Ui>Books ▸ Add company…</Ui>, or the button on the empty Portfolio.
    +
    +<Shot src="/m/6a66806c48f1-mac-add-company-light.png" dark="/m/eaabbb3691c0-mac-add-company-dark.png" alt="The Add company sheet with a company name field, reporting currency and fiscal year-end month pickers, and a collapsed optional details section" caption="The Add company sheet when adding by hand." />
    +
    +## Two ways to add one
    +
    +When the account has QuickBooks companies to offer, the sheet has a switch with <Ui>From QuickBooks</Ui> and <Ui>Add manually</Ui>. Without QuickBooks it shows the manual form only.
    +
    +### From QuickBooks
    +
    +The sheet lists the QuickBooks companies of your organization that are not on this Mac yet. If you work on your own, it lists your own. Pick one and press <Ui>Add to this computer</Ui>.
    +
    +- A company that is already connected is added and Haruno starts fetching its months.
    +- A company whose connection has lapsed is added. Its page then asks you to sign in to QuickBooks again, and you press <Ui>Sync</Ui> there to fetch its months.
    +- A company you archived on this Mac is listed as archived. Pick it and press <Ui>Restore</Ui> to bring it back with its books as they were.
    +- If books with the same name are already on this Mac, the button says <Ui>Link</Ui>. It links those books to the QuickBooks company. No new company is made.
    +
    +For a company that is not listed, press <Ui>Company not listed?</Ui>, then <Ui>Connect to QuickBooks</Ui>. Haruno opens QuickBooks' own sign-in page in your browser. Finish signing in there, and Haruno brings the company in. If your account does not have the right to add companies, the sheet says that an administrator of your organization does it.
    +
    +The sheet also shows a data notice, with a link to the Data Processing Disclosure. It says that a sync keeps a copy of the company's QuickBooks records on this Mac, including customer and vendor names. See [QuickBooks sync](/macos/books/quickbooks-sync/).
    +
    +### Add manually
    +
    +Type the <Ui>Company name</Ui>. A name that cannot be used, or that your portfolio already has, is refused under the field. Then choose two things:
    +
    +- <Ui>Reporting currency</Ui>. Without one, a statement that prints only a "$" cannot be filed.
    +- <Ui>Fiscal year-end month</Ui>.
    +
    +<Ui>Company details (optional)</Ui> holds the address, the country, the tax jurisdiction, the legal entity type and the EIN, which is the company's US tax number. You can fill these in later.
    +
    +Press <Ui>Save</Ui>. The company's folder is created and its page opens.
    +
    +## Setting the company up
    +
    +A new company has no figures yet. Its page shows four steps.
    +
    +<Steps>
    +<Step title="Add data">
    +Drop the company's files on the page, or use <Ui>Upload files</Ui> or <Ui>Open a folder</Ui>. Haruno takes Excel (.xlsx), CSV and PDF files, including those in subfolders. It copies them and leaves your originals where they are. If a file with the same name is already there, Haruno keeps both and numbers the new one. You can also use <Ui>Books ▸ Import Exports…</Ui>.
    +
    +Each file gets a row with the kind Haruno read it as, such as reporting package, budget or reconciliation. A file it cannot place says <Ui>Not claimed</Ui>. A file that is another company's export is flagged as <Ui>Another company's export</Ui>.
    +</Step>
    +<Step title="Analyze data">
    +Press <Ui>Analyze data</Ui>. Haruno reads the files and suggests how to organize the figures for the reports: which account goes on which line of the statements. A progress bar shows the work, and <Ui>Stop reading</Ui> stops it. Nothing is saved until you approve.
    +
    +A close needs a balance sheet and a profit and loss. If the files hold neither, the page says so and asks you to add them first.
    +</Step>
    +<Step title="Review suggestions">
    +Haruno lists what it is unsure about under <Ui>Needs your attention</Ui>, and what it read straight from the files under <Ui>Check and confirm</Ui>. Answer what you can. <Ui>Preview changes</Ui> shows what your answers would do without saving. <Ui>Approve mapping</Ui> saves them. If there is nothing to ask, the page says so.
    +</Step>
    +<Step title="Ready to close">
    +Press <Ui>Close month…</Ui> to make the company's first report. You see what the close will do before anything is saved. See [Closing a month](/macos/books/month-close/).
    +</Step>
    +</Steps>
    +
    +After the first close the page shows its seven tabs. See [A company's page](/macos/books/company-page/).
    +
    +<Callout variant="info" title="Mapping">
    +The mapping is the list that says which of the company's accounts goes on which statement line. Haruno's suggestions are that list. You can review it again later. See [Mappings](/macos/books/mappings/).
    +</Callout>
    +
    +## Redoing the analysis
    +
    +<Ui>Analyze data again</Ui> reads the files again and makes new suggestions. It replaces the answers you gave, and Haruno asks you first. <Ui>Delete suggestions</Ui> removes the suggestions and your answers. The company's files stay.
    +
    +## Other ways in
    +
    +- <Ui>Books ▸ Import Books from a Folder…</Ui> brings in books kept by an older version of Haruno.
    +- A company that is read from the published statements in an annual report is not added here. See [Annual reports in a project](/macos/books/published-statements/).
    +
    +## What to tell a customer
    +
    +Adding a company takes a few minutes. The customer gives Haruno the company's files, or connects QuickBooks. Haruno suggests how to read them. The customer checks the suggestions and approves them. Nothing is closed or sent until they say so.