Haruno Knowledge base

Annual reports in a project

A project can read a company from the financial statements in its published annual reports (PDFs) and keep it as a company inside the project, never in the Portfolio. Companies are compared on the Companies tab.

  • Mac appAvailable
  • Windows appAvailable

A listed or private company publishes its financial statements once a year, usually as a PDF. A project can read those PDFs and turn them into a company you can look at and compare: its balance sheet (what it owns and owes on one date), its income statement (what it earned and spent over the year) and its cash flow statement (the money that came in and went out).

This is how to keep a company that has no monthly books. Companies whose monthly books Haruno keeps belong in the Portfolio. Annual reports are read in a project, not on a Portfolio company.

Needs the Books feature

Reading annual reports needs the Books feature, the one that runs the Portfolio, to be ready. The option appears only then, and only while the project is not archived. Otherwise a reading says: "CFO isn't ready to read company accounts right now. Try again once it has started."

What it keeps apart

  • The company is kept in books that belong to the project. It never goes into the Portfolio, and nothing from it changes another company's books.
  • It has financial years, not months. It has no mapping and no month-end close.
  • Haruno keeps a copy of each PDF inside the project. Your originals are never changed.
  • Deleting the project removes its books with it.

Read a source as a company

Reading starts from a source on the Sources tab. It is offered for a folder on the PC and for a PDF file on the PC, when the source is available and its access is not Metadata only. Websites, cloud items, documents and Company sources are not offered.

Each source says how its reading stands.
The Sources tab of a project called Regional banks. Maple annual reports and Harbor annual reports say Read as a company FY2024. Scan Group FY2024.pdf says Needs a look with 2 questions and has an Answer button. Summit scans shows a failure about a missing Windows OCR pack. Lakeside annual reports has not been read.The Sources tab of a project called Regional banks. Maple annual reports and Harbor annual reports say Read as a company FY2024. Scan Group FY2024.pdf says Needs a look with 2 questions and has an Answer button. Summit scans shows a failure about a missing Windows OCR pack. Lakeside annual reports has not been read.
  1. Open the source's menu

    A PDF file has its own Read as company accounts… button. A folder has the same choice in the … menu on its row. After a first reading the menu says Read again.

  2. Fill in the dialog
    Three fields, then Read Statements.
    The Read as company accounts dialog. It says Haruno reads the annual reports in it as this company's accounts and keeps a copy here. It has Company name set to Lakeside, Reporting currency set to From the statements, Fiscal year-end month set to December, and the buttons Cancel and Read Statements.The Read as company accounts dialog. It says Haruno reads the annual reports in it as this company's accounts and keeps a copy here. It has Company name set to Lakeside, Reporting currency set to From the statements, Fiscal year-end month set to December, and the buttons Cancel and Read Statements.
    • Company name starts as the folder's or file's name, without its extension or a year at the end ("Maple FY2024" becomes "Maple"). It cannot be empty, and the project cannot already have a company with that name. The page says so if it does: "This project already has a company with that name."
    • Reporting currency starts as From the statements: Haruno uses the currency the report prints. Pick a currency only if the statements print none.
    • Fiscal year-end month is the month the company's financial year ends. It starts as December. Set it when the year does not end in December, so a heading such as "2024" is read as the right year.
  3. Select Read Statements

    The dialog closes and the reading runs in the background.

For a folder, Haruno reads the PDFs directly inside it. It does not go into sub-folders and it skips hidden files and links. If there are none, the row says "There are no PDFs here to read."

How a source's row stands

The row saysWhat it means
ReadingHaruno is reading the files.
Read as a company · FY2024The company is filed. The year is the latest one read.
Needs a look · 2 questionsHaruno could not settle something by itself and has questions. An Answer… button appears.
A sentence in a warning colourThe reading failed, and the sentence says why.

Some reasons you may see:

  • "Haruno found no financial statements in these files."
  • "Haruno couldn't read these files."
  • "Haruno cannot access this source right now. Relink it or restore permission, then refresh its status."
  • A scan in a language whose Windows OCR pack is not installed. OCR is how a computer reads the text in a picture of a page, and Windows needs a language pack for each language. The row names the languages and says to add them in Windows Settings (Time & language, then Language & region), then use Read again.

A reading that stops for a passing reason, such as the Books feature restarting, never wipes out what is already known.

Answer the questions

Select Answer… on a source that Needs a look. A window opens with the company's questions and, for every scanned page where the two readings disagreed, what each one read. Answer each one, use Use or Confirm, or Leave Out a statement you do not want. Done closes the window. Closing it, by Done, Back or Escape, saves where the reading stands.

The questions window. Reading scanned pages is explained on the Books pages.
The questions window for Scan Group over the Sources tab. It says Needs a look, 2 questions, and shows a question about which name a line is, a table of what the scan read, the findings for it and an Open PDF button.The questions window for Scan Group over the Sources tab. It says Needs a look, 2 questions, and shows a question about which name a line is, a table of what the scan read, the findings for it and an Open PDF button.

How scans are read, and why Haruno asks you to check some figures, is explained with the Books pages. A scan is only trusted when two separate readings of the page agree.

The Companies tab

Once any reading has filed, the project gets a Companies tab, between Sources and Automations.

The Companies tab with two companies.
The Companies tab of a project called Regional banks. It is titled Published annual reports. A table compares two companies, Maple Bank and Harbor Plastics, on total assets, revenue, net income, return on equity and other ratios, each in its own currency and unit. Below it a chart shows growth since each company's first year.The Companies tab of a project called Regional banks. It is titled Published annual reports. A table compares two companies, Maple Bank and Harbor Plastics, on total assets, revenue, net income, return on equity and other ratios, each in its own currency and unit. Below it a chart shows growth since each company's first year.
  • With two or more companies, the tab compares them: the latest year's figures and ratios side by side, and a growth chart indexed to 100 at each company's first year. Each company is in its own currency and unit. Nothing is added together.
  • With one company, the tab is that company's page, because there is nothing to compare.
  • Select a company's name to open its page. Back to companies returns to the comparison.
  • Export… saves the comparison.

A company's page has Overview, Statements, Investor report, Findings & questions and Files. Files lists the project's copies of the PDFs and has Read files again. It copies a PDF the source replaced, drops one the source no longer has, and reads what changed. Company details… changes the reporting currency and the fiscal year-end month. A currency that the statements print is locked, because the figures are in that currency. A new year-end month makes Haruno read the files again before the window closes.

If no company is left, the tab goes away and the project returns to Home.

Take a company out

  • Unlink or Forget from project on the source removes its company from the project's books and forgets the reading. If a reading is still running, Haruno stops it first. If the Books feature cannot remove the company right now, the source stays as it was and the page says why.
  • Delete project removes the project's books.

What a chat in the project knows

Each chat in the project is given the companies the project has read, as read-only files: a summary of each company (the years filed, currency and unit, the latest year's headline figures, ratios and open questions) and the full reading. The chat is told where they are. When the set of companies changes, a live chat in the project starts again on the same conversation at its next message, so the new files are available.

What to tell a customer

  • Annual reports are read in a project, not in the Portfolio.
  • Haruno never changes the original PDFs. It works on copies.
  • Needs a look is not an error. Haruno is asking you to check something it would rather not guess.
  • A comparison puts companies side by side. It never adds figures from different currencies together.

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,111 @@
    +---
    +title: Annual reports in a project
    +summary: A project can read a company from the financial statements in its published annual reports (PDFs) and keep it as a company inside the project, never in the Portfolio. Companies are compared on the Companies tab.
    +feature: published-statements
    +covers:
    +  - windows-client/docs/project-annual-reports.md
    +  - windows-client/haruno-webview/web/src/components/ProjectReadCompanyDialog.tsx
    +  - windows-client/haruno-webview/web/src/components/projectCompanyReadings.ts
    +  - windows-client/haruno-webview/web/e2e/project-company-readings.spec.ts
    +  - windows-client/Haruno.Desktop.Services/Projects/ProjectAnnualReportsReader.cs
    +  - windows-client/Haruno.Desktop.Services/Projects/ProjectCompanyReportsWriter.cs
    +  - Integrations/cfo/ui/src/PublishedCompanies.tsx
    +  - Integrations/cfo/ui/src/PublishedCompany.tsx
    +  - Integrations/cfo/ui/src/PublishedQuestions.tsx
    +---
    +
    +A listed or private company publishes its financial statements once a year, usually as a PDF. A project can read those PDFs and turn them into a company you can look at and compare: its balance sheet (what it owns and owes on one date), its income statement (what it earned and spent over the year) and its cash flow statement (the money that came in and went out).
    +
    +This is how to keep a company that has no monthly books. Companies whose monthly books Haruno keeps belong in the Portfolio. Annual reports are read in a project, not on a Portfolio company.
    +
    +<Callout variant="info" title="Needs the Books feature">
    +Reading annual reports needs the Books feature, the one that runs the Portfolio, to be ready. The option appears only then, and only while the project is not archived. Otherwise a reading says: "CFO isn't ready to read company accounts right now. Try again once it has started."
    +</Callout>
    +
    +## What it keeps apart
    +
    +- The company is kept in books that belong to the project. It never goes into the Portfolio, and nothing from it changes another company's books.
    +- It has financial years, not months. It has no mapping and no month-end close.
    +- Haruno keeps a copy of each PDF inside the project. Your originals are never changed.
    +- Deleting the project removes its books with it.
    +
    +## Read a source as a company
    +
    +Reading starts from a source on the **Sources** tab. It is offered for a **folder** on the PC and for a **PDF file** on the PC, when the source is available and its access is not **Metadata only**. Websites, cloud items, documents and Company sources are not offered.
    +
    +<Shot src="/m/3e1ac6dcb5b7-windows-projects-reports-sources-light.png" dark="/m/411025bdb926-windows-projects-reports-sources-dark.png" alt="The Sources tab of a project called Regional banks. Maple annual reports and Harbor annual reports say Read as a company FY2024. Scan Group FY2024.pdf says Needs a look with 2 questions and has an Answer button. Summit scans shows a failure about a missing Windows OCR pack. Lakeside annual reports has not been read." caption="Each source says how its reading stands." />
    +
    +<Steps>
    +<Step title="Open the source's menu">
    +A PDF file has its own **Read as company accounts…** button. A folder has the same choice in the **…** menu on its row. After a first reading the menu says **Read again**.
    +</Step>
    +<Step title="Fill in the dialog">
    +<Shot src="/m/91aadcf2d920-windows-projects-reports-read-light.png" dark="/m/e7108bfa6878-windows-projects-reports-read-dark.png" alt="The Read as company accounts dialog. It says Haruno reads the annual reports in it as this company's accounts and keeps a copy here. It has Company name set to Lakeside, Reporting currency set to From the statements, Fiscal year-end month set to December, and the buttons Cancel and Read Statements." caption="Three fields, then Read Statements." />
    +
    +- **Company name** starts as the folder's or file's name, without its extension or a year at the end ("Maple FY2024" becomes "Maple"). It cannot be empty, and the project cannot already have a company with that name. The page says so if it does: "This project already has a company with that name."
    +- **Reporting currency** starts as **From the statements**: Haruno uses the currency the report prints. Pick a currency only if the statements print none.
    +- **Fiscal year-end month** is the month the company's financial year ends. It starts as December. Set it when the year does not end in December, so a heading such as "2024" is read as the right year.
    +</Step>
    +<Step title="Select Read Statements">
    +The dialog closes and the reading runs in the background.
    +</Step>
    +</Steps>
    +
    +For a folder, Haruno reads the PDFs directly inside it. It does not go into sub-folders and it skips hidden files and links. If there are none, the row says "There are no PDFs here to read."
    +
    +## How a source's row stands
    +
    +| The row says | What it means |
    +|---|---|
    +| <Ui>Reading</Ui> | Haruno is reading the files. |
    +| <Ui>Read as a company · FY2024</Ui> | The company is filed. The year is the latest one read. |
    +| <Ui>Needs a look · 2 questions</Ui> | Haruno could not settle something by itself and has questions. An **Answer…** button appears. |
    +| A sentence in a warning colour | The reading failed, and the sentence says why. |
    +
    +Some reasons you may see:
    +
    +- "Haruno found no financial statements in these files."
    +- "Haruno couldn't read these files."
    +- "Haruno cannot access this source right now. Relink it or restore permission, then refresh its status."
    +- A scan in a language whose Windows OCR pack is not installed. OCR is how a computer reads the text in a picture of a page, and Windows needs a language pack for each language. The row names the languages and says to add them in Windows Settings (Time & language, then Language & region), then use **Read again**.
    +
    +A reading that stops for a passing reason, such as the Books feature restarting, never wipes out what is already known.
    +
    +## Answer the questions
    +
    +Select **Answer…** on a source that **Needs a look**. A window opens with the company's questions and, for every scanned page where the two readings disagreed, what each one read. Answer each one, use **Use** or **Confirm**, or **Leave Out** a statement you do not want. **Done** closes the window. Closing it, by **Done**, **Back** or Escape, saves where the reading stands.
    +
    +<Shot src="/m/474bf96e4b02-windows-projects-reports-questions-light.png" dark="/m/328891c82edd-windows-projects-reports-questions-dark.png" alt="The questions window for Scan Group over the Sources tab. It says Needs a look, 2 questions, and shows a question about which name a line is, a table of what the scan read, the findings for it and an Open PDF button." caption="The questions window. Reading scanned pages is explained on the Books pages." />
    +
    +How scans are read, and why Haruno asks you to check some figures, is explained with the Books pages. A scan is only trusted when two separate readings of the page agree.
    +
    +## The Companies tab
    +
    +Once any reading has filed, the project gets a **Companies** tab, between **Sources** and **Automations**.
    +
    +<Shot src="/m/d1b8b808b677-windows-projects-reports-companies-light.png" dark="/m/36d841e85b9f-windows-projects-reports-companies-dark.png" alt="The Companies tab of a project called Regional banks. It is titled Published annual reports. A table compares two companies, Maple Bank and Harbor Plastics, on total assets, revenue, net income, return on equity and other ratios, each in its own currency and unit. Below it a chart shows growth since each company's first year." caption="The Companies tab with two companies." />
    +
    +- With **two or more** companies, the tab compares them: the latest year's figures and ratios side by side, and a growth chart indexed to 100 at each company's first year. Each company is in its own currency and unit. Nothing is added together.
    +- With **one** company, the tab is that company's page, because there is nothing to compare.
    +- Select a company's name to open its page. **Back to companies** returns to the comparison.
    +- **Export…** saves the comparison.
    +
    +A company's page has <Ui>Overview</Ui>, <Ui>Statements</Ui>, <Ui>Investor report</Ui>, <Ui>Findings & questions</Ui> and <Ui>Files</Ui>. **Files** lists the project's copies of the PDFs and has **Read files again**. It copies a PDF the source replaced, drops one the source no longer has, and reads what changed. **Company details…** changes the reporting currency and the fiscal year-end month. A currency that the statements print is locked, because the figures are in that currency. A new year-end month makes Haruno read the files again before the window closes.
    +
    +If no company is left, the tab goes away and the project returns to **Home**.
    +
    +## Take a company out
    +
    +- **Unlink** or **Forget from project** on the source removes its company from the project's books and forgets the reading. If a reading is still running, Haruno stops it first. If the Books feature cannot remove the company right now, the source stays as it was and the page says why.
    +- **Delete project** removes the project's books.
    +
    +## What a chat in the project knows
    +
    +Each chat in the project is given the companies the project has read, as read-only files: a summary of each company (the years filed, currency and unit, the latest year's headline figures, ratios and open questions) and the full reading. The chat is told where they are. When the set of companies changes, a live chat in the project starts again on the same conversation at its next message, so the new files are available.
    +
    +## What to tell a customer
    +
    +- Annual reports are read in a project, not in the Portfolio.
    +- Haruno never changes the original PDFs. It works on copies.
    +- **Needs a look** is not an error. Haruno is asking you to check something it would rather not guess.
    +- A comparison puts companies side by side. It never adds figures from different currencies together.