Haruno Knowledge base

Adding a company and importing files

Add a company by hand or from QuickBooks, drop its accounting exports onto it, and let Haruno read them into a draft that you approve before the first close.

  • Mac appAvailable
  • Windows appAvailable

A company gets into the Portfolio in one of two ways. You can fill it in by hand and add its files, or you can add it from QuickBooks and let Haruno bring its months. This page is about the first way. For the second, see QuickBooks.

Add the company

  1. Press Add company

    It is the plus at the right of the Portfolio toolbar. A sheet called Company details opens with two tabs, Fill in by hand and From QuickBooks.

    Add company, filled in by hand.
    The Add company sheet on the Fill in by hand tab, with a company name field and an optional details section.The Add company sheet on the Fill in by hand tab, with a company name field and an optional details section.
  2. Type the name

    The name is the only required field. Under Company details (optional) you can add the tax jurisdiction, the legal entity type and the EIN. The EIN is the nine-digit business tax number the US tax office issues. You can add any of these later with Company details on the company's page.

  3. Press Save

    The company opens on its own page, ready for files. A name that is already in use is refused, and so is a name an archived company holds. Restore that one instead.

Add the files

Haruno builds the books from the company's accounting exports. Bring a Balance Sheet and a Profit and Loss by month, ideally the last 24 months, as Excel exports. A balance sheet lists what the company owns and owes on a date. A profit and loss lists what it earned and spent over a month. A reconciliation workbook and a billing export are optional.

Drop files or a whole folder onto the page, or press Upload files or Open a folder. Haruno accepts:

  • Excel (.xlsx) and CSV files, and PDF files, including those in subfolders.
  • A ZIP (.zip) that you choose on its own. A 弥生会計 trial balance arrives as one.

Haruno copies the files into the company. Your originals stay where they are.

The Files tab. Drop files here or press Upload files.
The Files tab of a company, with a drop area, Upload files and Open a folder buttons, and a list of files that were read.The Files tab of a company, with a drop area, Upload files and Open a folder buttons, and a list of files that were read.
Only some PDFs are read

The one PDF Haruno reads is a QuickBooks reconciliation report. For any other PDF the page says to export the report to Excel and add that file. Annual reports belong in a project, not here. A ZIP found inside a folder is not added, and neither is a ZIP over 64 MB.

After you add files, an Import results list says what happened to each one. A file can be read, not recognized, skipped, or not in the mapping. A file with the same name as an earlier one is saved beside it, and the older file is never replaced. A file that is an export of a different company is flagged, so you can move it to the right one.

The Read as menu on a file lets you tell Haruno what the file is, such as Trial balance, Budget or Billing invoices. Leave it on Automatic unless Haruno guessed wrong.

From files to a first close

A new company moves along a short path, shown at the top of its page.

Setting up a company: add data, analyze it, review the draft.
A new company's page. A path reads Add data, Analyze data, Review the draft, Ready to close, with a file listed and an Analyze data button.A new company's page. A path reads Add data, Analyze data, Review the draft, Ready to close, with a file listed and an Analyze data button.
  1. Add data. Drop the files.
  2. Analyze data. Haruno reads the files once and writes a draft of the company's mapping. The mapping says which account goes on which line of the statements. Nothing is closed and nothing is changed by reading.
  3. Review the draft. You check Haruno's suggestions and approve them. A bar at the bottom of the review says what is left, and Show next takes you to the next item that needs you. Approve mapping in that bar finishes the step. See Mappings.
  4. Ready to close. The first close creates the company's first report. See Closing a month.

Before you can approve the mapping, the company needs a reporting currency and a fiscal year-end month. Set them in Company details. Haruno asks for them when they are missing.

Files after the first close

Add each new month's files the same way. The page then shows how many new files arrived since the last close. A file a close has read stays in the company, because its figures are already in the books.

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

History (2 versions)
  1. Windows mapping review: pinned bar with what is left, Show next (#2865)
    What changed
    @@ -58,7 +58,7 @@ A new company moves along a short path, shown at the top of its page.
     
     1. **Add data.** Drop the files.
     2. **Analyze data.** Haruno reads the files once and writes a draft of the company's mapping. The mapping says which account goes on which line of the statements. Nothing is closed and nothing is changed by reading.
    -3. **Review the draft.** You check Haruno's suggestions and approve them. See [Mappings](/windows/books/mappings/).
    +3. **Review the draft.** You check Haruno's suggestions and approve them. A bar at the bottom of the review says what is left, and <Ui>Show next</Ui> takes you to the next item that needs you. <Ui>Approve mapping</Ui> in that bar finishes the step. See [Mappings](/windows/books/mappings/).
     4. **Ready to close.** The first close creates the company's first report. See [Closing a month](/windows/books/closing-a-month/).
     
     Before you can approve the mapping, the company needs a reporting currency and a fiscal year-end month. Set them in <Ui>Company details</Ui>. Haruno asks for them when they are missing.
    
  2. Internal knowledge base for staff: site, reader keys, assistant, 197 pages and the PR rule (#2944)
    What changed
    @@ -0,0 +1,68 @@
    +---
    +title: Adding a company and importing files
    +summary: Add a company by hand or from QuickBooks, drop its accounting exports onto it, and let Haruno read them into a draft that you approve before the first close.
    +feature: add-company
    +covers:
    +  - Integrations/cfo/ui/src/AddCompanyDialog.tsx
    +  - Integrations/cfo/ui/src/ClientSetup.tsx
    +  - Integrations/cfo/ui/src/CompanyFiles.tsx
    +  - Integrations/cfo/ui/src/FilesFound.tsx
    +  - Integrations/cfo/ui/src/ProposeStep.tsx
    +  - Integrations/cfo/ui/src/CompanyDetailsSheet.tsx
    +  - Integrations/cfo/Source/CfoExportsFiling.cs
    +---
    +
    +A company gets into the Portfolio in one of two ways. You can fill it in by hand and add its files, or you can add it from QuickBooks and let Haruno bring its months. This page is about the first way. For the second, see [QuickBooks](/windows/books/quickbooks/).
    +
    +## Add the company
    +
    +<Steps>
    +<Step title="Press Add company">
    +It is the plus at the right of the Portfolio toolbar. A sheet called <Ui>Company details</Ui> opens with two tabs, <Ui>Fill in by hand</Ui> and <Ui>From QuickBooks</Ui>.
    +<Shot src="/m/a11fe3bed168-windows-books-add-company-light.png" dark="/m/e7e17d80628e-windows-books-add-company-dark.png" alt="The Add company sheet on the Fill in by hand tab, with a company name field and an optional details section." caption="Add company, filled in by hand." />
    +</Step>
    +<Step title="Type the name">
    +The name is the only required field. Under <Ui>Company details (optional)</Ui> you can add the tax jurisdiction, the legal entity type and the EIN. The EIN is the nine-digit business tax number the US tax office issues. You can add any of these later with <Ui>Company details</Ui> on the company's page.
    +</Step>
    +<Step title="Press Save">
    +The company opens on its own page, ready for files. A name that is already in use is refused, and so is a name an archived company holds. Restore that one instead.
    +</Step>
    +</Steps>
    +
    +## Add the files
    +
    +Haruno builds the books from the company's accounting exports. Bring a **Balance Sheet** and a **Profit and Loss** by month, ideally the last 24 months, as Excel exports. A balance sheet lists what the company owns and owes on a date. A profit and loss lists what it earned and spent over a month. A reconciliation workbook and a billing export are optional.
    +
    +Drop files or a whole folder onto the page, or press <Ui>Upload files</Ui> or <Ui>Open a folder</Ui>. Haruno accepts:
    +
    +- Excel (.xlsx) and CSV files, and PDF files, including those in subfolders.
    +- A ZIP (.zip) that you choose on its own. A 弥生会計 trial balance arrives as one.
    +
    +Haruno copies the files into the company. Your originals stay where they are.
    +
    +<Shot src="/m/bf2983b0e86a-windows-books-files-light.png" dark="/m/5ceca7b2c7cd-windows-books-files-dark.png" alt="The Files tab of a company, with a drop area, Upload files and Open a folder buttons, and a list of files that were read." caption="The Files tab. Drop files here or press Upload files." />
    +
    +<Callout variant="warning" title="Only some PDFs are read">
    +The one PDF Haruno reads is a QuickBooks reconciliation report. For any other PDF the page says to export the report to Excel and add that file. Annual reports belong in a project, not here. A ZIP found inside a folder is not added, and neither is a ZIP over 64 MB.
    +</Callout>
    +
    +After you add files, an <Ui>Import results</Ui> list says what happened to each one. A file can be read, not recognized, skipped, or not in the mapping. A file with the same name as an earlier one is saved beside it, and the older file is never replaced. A file that is an export of a different company is flagged, so you can move it to the right one.
    +
    +The <Ui>Read as</Ui> menu on a file lets you tell Haruno what the file is, such as <Ui>Trial balance</Ui>, <Ui>Budget</Ui> or <Ui>Billing invoices</Ui>. Leave it on <Ui>Automatic</Ui> unless Haruno guessed wrong.
    +
    +## From files to a first close
    +
    +A new company moves along a short path, shown at the top of its page.
    +
    +<Shot src="/m/0f00edbc00de-windows-books-setup-light.png" dark="/m/2fd2c7edce90-windows-books-setup-dark.png" alt="A new company's page. A path reads Add data, Analyze data, Review the draft, Ready to close, with a file listed and an Analyze data button." caption="Setting up a company: add data, analyze it, review the draft." />
    +
    +1. **Add data.** Drop the files.
    +2. **Analyze data.** Haruno reads the files once and writes a draft of the company's mapping. The mapping says which account goes on which line of the statements. Nothing is closed and nothing is changed by reading.
    +3. **Review the draft.** You check Haruno's suggestions and approve them. See [Mappings](/windows/books/mappings/).
    +4. **Ready to close.** The first close creates the company's first report. See [Closing a month](/windows/books/closing-a-month/).
    +
    +Before you can approve the mapping, the company needs a reporting currency and a fiscal year-end month. Set them in <Ui>Company details</Ui>. Haruno asks for them when they are missing.
    +
    +<Callout variant="tip" title="Files after the first close">
    +Add each new month's files the same way. The page then shows how many new files arrived since the last close. A file a close has read stays in the company, because its figures are already in the books.
    +</Callout>