Haruno Knowledge base

Annual reports in a project

Add a company's annual report PDFs to a project and Haruno reads its balance sheet, income statement and cash flows into a company page, with questions where it is unsure.

  • Mac appAvailable
  • Windows appAvailable

A company that publishes its accounts, for example in an annual report, can be read without any of its accounting files. You add the report PDFs to a project. Haruno reads the balance sheet, the income statement and the cash flow statement from each one, and keeps the company inside that project.

Such a company is not in the Portfolio. The Portfolio is for companies whose monthly books Haruno keeps. If you drop annual reports on a Portfolio company, Haruno refuses them and says they are read in a project.

Read a report

  1. Add the reports to a project

    Link a local folder of reports, or one PDF, as a source of the project. See Project sources.

  2. Choose Read as company accounts…

    It is in the ⋯ menu of the source. A PDF also has it as a button on its row. It is offered for a local folder or a local PDF that Haruno can open.

  3. Fill in the sheet

    Give the company's name. It starts from the folder's or file's name, with a year at the end removed. Haruno also looks at the PDFs and fills in the currency and the fiscal year end. A currency says From the statements where none is printed. A warning shows where your choice contradicts the statements. Reading waits for that look.

  4. Press Read Statements

    Haruno reads each PDF and keeps a copy in the project. Your originals are not changed.

Haruno reads the figures by fixed rules, not by guessing. A scanned report with no text in it is read on your Mac first. The scan does not leave the Mac.

What the source row says

The row saysWhat it means
ReadingHaruno is reading
Read as a company · FY2023Done. The year is the latest one filed
Needs a look · 2 questionsHaruno is not sure of something
A reasonThe reading failed, and the reason is shown

When a row says Needs a look, it has an Answer… button. It opens the company's page on its Findings & questions tab, where the questions are answered. See below.

The ⋯ menu has Read again, which refreshes the copies and reads again only what changed, and Unlink source…, which removes the company from the project, with its copies. The original files stay.

Questions

Haruno asks when it cannot be sure which line is net income, which unit the figures are in, which currency, which statement a page is, or which year a column covers. The Questions on the files card on the Findings & questions tab lists them. Most have a picker and a Use button. When nothing is left, the card says Nothing left to answer.

  • The answers about a line, a unit and a currency are kept for the company's later reports. The others hold for that file.
  • Leave Out drops one statement of several.
  • Open PDF opens the report in another app. A scanned report is different, see below.

Answering the questions settles the reading as you give them.

A scanned report

A scan is a picture of a page, so Haruno can misread a figure. It asks you to check the reading against the PDF before it files it. The question says These figures were read from a scan. Check them against the PDF, then confirm them. Under it, Haruno shows what it read: each statement, its lines, and a column for each year.

Marks show where to look.

MarkWhat it means
A warning sign on a figureThe scan looked misread here. Haruno changed the figure so the totals add up. A line above the table counts them
A pencil on a figure or a nameYou typed it. Hover a name to see what the scan read
A numbered mark where a figure should beThe page may print a figure here, but none was read. The number is the one of a finding under the table
A warning sign and dots under a line's nameThe scan may have misread the name. This is only for scans in Traditional Chinese. See Account names

Open PDF shows the report's pages beside the company's page, not in another app. Every figure that was read is boxed where it was read. Each column shows its year. Each finding is numbered on its place: a dashed box where a figure is missing, or a total that does not add up along its line. A key on the page says what each kind of box means. Previous page and Next page turn the pages. Click a finding, or its note beside the page, to go to that place.

Confirm stays off until you have opened the PDF.

Correct a figure or a name

Click any figure in the reading. The page shows it boxed, and a field opens. Type the figure as it is printed there, such as 12,345 or (12,345), and press Apply. Haruno reads the report again with your figure. A dash can be typed over too. The page then shows a dashed box where the column would print the figure. Typing the figure Haruno already has changes nothing.

For a scan in Traditional Chinese, a line's name works the same way. Click it and the page opens on that line. For a name Haruno doubts, a menu offers Keep as read and the nearest names Haruno knows, and ends with Type another name…. For any other name, a field opens for you to type it. Press Apply to use the name. Save to My Organization's List keeps it for the next scan. See Account names.

After you confirm

A company's Statements tab works the same way. A figure that was read from a scan is a link, and so is a line's name for a scan in Traditional Chinese. Click it to see it on the page of the report it came from. For an earlier year, that is often a later report.

A small box opens with the file and page, what the figure is in the reading, and a field in that file's own unit. Press Apply. Haruno reads the scan again, and the report stays filed.

If your change makes a statement read differently, the tab says so. The report's figures wait for you to confirm them again, and until then its years are left out of the statements. Open Findings & questions takes you to the question.

A figure that a later report restated is underlined with dots. Hover it, or click it, to see what it was first reported as.

Copy

Right-click a name or a figure and choose Copy. Where a click would correct it, Correct… is under it. Right-click a statement's title and choose Copy Statement to copy the whole statement: its title and unit over the years, then each line's name and figures. The figures come without thousands separators. It pastes into Numbers or Excel as rows and columns.

The Companies tab

Once one report has been read, the project has a Companies tab.

  • With one company, the tab is that company's page.
  • With more, the tab lists them: a card each, a table and a growth chart. Each company keeps its own currency. Nothing is added across companies.

A company's page has the tabs Overview, Statements, Analysis, Findings & questions and Files. It shows the statements over the years, and findings such as a total that does not add up. A scan that waits to be confirmed shows its own findings with its question, so the findings card leaves them out and says so.

Analysis is a written analysis of what stands out in the company's reports. Every figure it quotes is checked against the reports. It says when the figures changed since it was written, and can be written again.

Company details

Company details, in the toolbar over a company's page, changes the currency and the fiscal year end. A currency that a filed statement prints is locked. A saved change reads the company's files again before the sheet closes.

Exporting

The Companies tab has an Export… too. It saves a PDF and a web page, as any report does. See Reports and exports.

Chat

A chat in the project can read these companies. See Project chats.

What to tell a customer

This is for reading the published accounts of a company without its books: a company you are looking at, but do not manage. Haruno reads them for you. Where it is unsure it asks, and it shows you the page. A scan is checked by a person before it counts, and a figure or name can be corrected from its page at any time.

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,134 @@
    +---
    +title: Annual reports in a project
    +summary: Add a company's annual report PDFs to a project and Haruno reads its balance sheet, income statement and cash flows into a company page, with questions where it is unsure.
    +feature: published-statements
    +covers:
    +  - apple/Sources/ProjectsFeature/ProjectCompanyReadings.swift
    +  - apple/Sources/ProjectsFeature/ProjectSourceRow.swift
    +  - apple/Sources/CFOFeature/Workflow/CFOPublishedModel.swift
    +  - apple/Sources/CFOFeature/Workflow/CFOPublishedQuestionsView.swift
    +  - apple/Sources/CFOFeature/Workflow/CFOPublishedCompanyDetailsSheet.swift
    +  - apple/Sources/CFOFeature/Workflow/CFOPublishedScope.swift
    +  - apple/Sources/CFOFeature/Workflow/CFOPublishedAnalyses.swift
    +  - apple/Sources/CFOFeature/Workflow/CFOReadingOverview.swift
    +  - apple/Sources/CFOFeature/Workflow/CFOSourcePage.swift
    +  - apple/Sources/CFOFeature/Workflow/CFOSourcePagePane.swift
    +  - apple/Sources/CFOFeature/Dashboard/CFOPublishedCompanyView.swift
    +  - apple/Sources/CFOFeature/Dashboard/CFOPublishedAnalysisTab.swift
    +  - apple/Sources/CFOFeature/Dashboard/CFOPresentedStatementsPanel.swift
    +  - apple/Sources/CFOFeature/Dashboard/CFOStatementFigure.swift
    +  - apple/Sources/CFOFeature/Dashboard/CFOStatementLineName.swift
    +  - apple/Sources/CFOFeature/Dashboard/CFOCopy.swift
    +  - apple/Sources/CFOFeature/Panels/CFOPublishedPortfolioSection.swift
    +  - apple/Sources/CFOReading/**
    +---
    +
    +A company that publishes its accounts, for example in an annual report, can be read without any of its accounting files. You add the report PDFs to a project. Haruno reads the balance sheet, the income statement and the cash flow statement from each one, and keeps the company inside that project.
    +
    +Such a company is not in the Portfolio. The Portfolio is for companies whose monthly books Haruno keeps. If you drop annual reports on a Portfolio company, Haruno refuses them and says they are read in a project.
    +
    +## Read a report
    +
    +<Steps>
    +<Step title="Add the reports to a project">
    +Link a local folder of reports, or one PDF, as a source of the project. See [Project sources](/macos/chat/project-sources/).
    +</Step>
    +<Step title="Choose Read as company accounts…">
    +It is in the <Ui>⋯</Ui> menu of the source. A PDF also has it as a button on its row. It is offered for a local folder or a local PDF that Haruno can open.
    +</Step>
    +<Step title="Fill in the sheet">
    +Give the company's name. It starts from the folder's or file's name, with a year at the end removed. Haruno also looks at the PDFs and fills in the currency and the fiscal year end. A currency says <Ui>From the statements</Ui> where none is printed. A warning shows where your choice contradicts the statements. Reading waits for that look.
    +</Step>
    +<Step title="Press Read Statements">
    +Haruno reads each PDF and keeps a copy in the project. Your originals are not changed.
    +</Step>
    +</Steps>
    +
    +Haruno reads the figures by fixed rules, not by guessing. A scanned report with no text in it is read on your Mac first. The scan does not leave the Mac.
    +
    +## What the source row says
    +
    +| The row says | What it means |
    +|---|---|
    +| <Ui>Reading</Ui> | Haruno is reading |
    +| <Ui>Read as a company · FY2023</Ui> | Done. The year is the latest one filed |
    +| <Ui>Needs a look · 2 questions</Ui> | Haruno is not sure of something |
    +| A reason | The reading failed, and the reason is shown |
    +
    +When a row says <Ui>Needs a look</Ui>, it has an <Ui>Answer…</Ui> button. It opens the company's page on its <Ui>Findings & questions</Ui> tab, where the questions are answered. See below.
    +
    +The <Ui>⋯</Ui> menu has <Ui>Read again</Ui>, which refreshes the copies and reads again only what changed, and <Ui>Unlink source…</Ui>, which removes the company from the project, with its copies. The original files stay.
    +
    +## Questions
    +
    +Haruno asks when it cannot be sure which line is net income, which unit the figures are in, which currency, which statement a page is, or which year a column covers. The <Ui>Questions on the files</Ui> card on the <Ui>Findings & questions</Ui> tab lists them. Most have a picker and a <Ui>Use</Ui> button. When nothing is left, the card says <Ui>Nothing left to answer.</Ui>
    +
    +- The answers about a line, a unit and a currency are kept for the company's later reports. The others hold for that file.
    +- <Ui>Leave Out</Ui> drops one statement of several.
    +- <Ui>Open PDF</Ui> opens the report in another app. A scanned report is different, see below.
    +
    +Answering the questions settles the reading as you give them.
    +
    +## A scanned report
    +
    +A scan is a picture of a page, so Haruno can misread a figure. It asks you to check the reading against the PDF before it files it. The question says <Ui>These figures were read from a scan. Check them against the PDF, then confirm them.</Ui> Under it, Haruno shows what it read: each statement, its lines, and a column for each year.
    +
    +Marks show where to look.
    +
    +| Mark | What it means |
    +|---|---|
    +| A warning sign on a figure | The scan looked misread here. Haruno changed the figure so the totals add up. A line above the table counts them |
    +| A pencil on a figure or a name | You typed it. Hover a name to see what the scan read |
    +| A numbered mark where a figure should be | The page may print a figure here, but none was read. The number is the one of a finding under the table |
    +| A warning sign and dots under a line's name | The scan may have misread the name. This is only for scans in Traditional Chinese. See [Account names](/macos/books/account-names/) |
    +
    +<Ui>Open PDF</Ui> shows the report's pages beside the company's page, not in another app. Every figure that was read is boxed where it was read. Each column shows its year. Each finding is numbered on its place: a dashed box where a figure is missing, or a total that does not add up along its line. A key on the page says what each kind of box means. <Ui>Previous page</Ui> and <Ui>Next page</Ui> turn the pages. Click a finding, or its note beside the page, to go to that place.
    +
    +<Ui>Confirm</Ui> stays off until you have opened the PDF.
    +
    +### Correct a figure or a name
    +
    +Click any figure in the reading. The page shows it boxed, and a field opens. Type the figure as it is printed there, such as 12,345 or (12,345), and press <Ui>Apply</Ui>. Haruno reads the report again with your figure. A dash can be typed over too. The page then shows a dashed box where the column would print the figure. Typing the figure Haruno already has changes nothing.
    +
    +For a scan in Traditional Chinese, a line's name works the same way. Click it and the page opens on that line. For a name Haruno doubts, a menu offers <Ui>Keep as read</Ui> and the nearest names Haruno knows, and ends with <Ui>Type another name…</Ui>. For any other name, a field opens for you to type it. Press <Ui>Apply</Ui> to use the name. <Ui>Save to My Organization's List</Ui> keeps it for the next scan. See [Account names](/macos/books/account-names/).
    +
    +## After you confirm
    +
    +A company's <Ui>Statements</Ui> tab works the same way. A figure that was read from a scan is a link, and so is a line's name for a scan in Traditional Chinese. Click it to see it on the page of the report it came from. For an earlier year, that is often a later report.
    +
    +A small box opens with the file and page, what the figure is in the reading, and a field in that file's own unit. Press <Ui>Apply</Ui>. Haruno reads the scan again, and the report stays filed.
    +
    +If your change makes a statement read differently, the tab says so. The report's figures wait for you to confirm them again, and until then its years are left out of the statements. <Ui>Open Findings & questions</Ui> takes you to the question.
    +
    +A figure that a later report restated is underlined with dots. Hover it, or click it, to see what it was first reported as.
    +
    +### Copy
    +
    +Right-click a name or a figure and choose <Ui>Copy</Ui>. Where a click would correct it, <Ui>Correct…</Ui> is under it. Right-click a statement's title and choose <Ui>Copy Statement</Ui> to copy the whole statement: its title and unit over the years, then each line's name and figures. The figures come without thousands separators. It pastes into Numbers or Excel as rows and columns.
    +
    +## The Companies tab
    +
    +Once one report has been read, the project has a <Ui>Companies</Ui> tab.
    +
    +- With one company, the tab is that company's page.
    +- With more, the tab lists them: a card each, a table and a growth chart. Each company keeps its own currency. Nothing is added across companies.
    +
    +A company's page has the tabs <Ui>Overview</Ui>, <Ui>Statements</Ui>, <Ui>Analysis</Ui>, <Ui>Findings & questions</Ui> and <Ui>Files</Ui>. It shows the statements over the years, and findings such as a total that does not add up. A scan that waits to be confirmed shows its own findings with its question, so the findings card leaves them out and says so.
    +
    +<Ui>Analysis</Ui> is a written analysis of what stands out in the company's reports. Every figure it quotes is checked against the reports. It says when the figures changed since it was written, and can be written again.
    +
    +## Company details
    +
    +<Ui>Company details</Ui>, in the toolbar over a company's page, changes the currency and the fiscal year end. A currency that a filed statement prints is locked. A saved change reads the company's files again before the sheet closes.
    +
    +## Exporting
    +
    +The Companies tab has an <Ui>Export…</Ui> too. It saves a PDF and a web page, as any report does. See [Reports and exports](/macos/books/reports-and-exports/).
    +
    +## Chat
    +
    +A chat in the project can read these companies. See [Project chats](/macos/chat/project-chats/).
    +
    +## What to tell a customer
    +
    +This is for reading the published accounts of a company without its books: a company you are looking at, but do not manage. Haruno reads them for you. Where it is unsure it asks, and it shows you the page. A scan is checked by a person before it counts, and a figure or name can be corrected from its page at any time.