Haruno Knowledge base

Mappings

The mapping tells Haruno which of a company's accounts goes on which line of its statements. Haruno suggests one, and a person reviews it and approves it.

  • Mac appAvailable
  • Windows appAvailable

A company's accounts are named by its own bookkeeping. Its statements have standard lines. The mapping is the list that connects the two. It says which account goes on which line, and which accounts count as what, such as what customers owe or what is spent on marketing.

You do not write a mapping. Haruno suggests one from the company's data. You check it.

Where you meet it

  • The first time, in the setup steps of a new company: Analyze data, then Review suggestions. See Adding a company.
  • Later, on the company's Mappings tab.

The Mappings tab

The Mappings tab of a demo company.
The Mappings tab listing accounts and the statement line each one is mapped toThe Mappings tab listing accounts and the statement line each one is mapped to

The tab is called Account → statement line mappings. It lists each active mapping by account. Under it, a warning counts the accounts that have activity but no statement line. An unmapped account is silently missing from every statement until it is mapped. Those accounts are marked unmapped, and each also shows up as a finding.

Review mapping… reopens the review. Books ▸ Review Mapping… does the same.

Reviewing the suggestions

The review page is called Review Haruno's suggestions.

  • Needs your attention lists what Haruno could not decide. Something stays out of the books until each of these is dealt with.
  • Check and confirm lists what Haruno read from the data. Each one is used as shown unless you change it. These are optional.
  • If Haruno has nothing to ask, the page says so: everything was read straight from the data.

New companies start from the defaults in Settings ▸ Books. They are suggestions only. See Settings for the books.

A bar at the foot of the page has two buttons.

ButtonWhat it does
Preview changesShows what your answers would change, and saves nothing. A refusal appears under the row that caused it
Approve mappingSaves your answers. The next close uses them

The bar also says what is still open. For a new company, approval waits for the company's reporting settings, that is, its currency and fiscal year-end. Show next takes you to the next row to review.

After approving

For a new company, the next step is to close a month to get the first report. Later changes to the mapping apply from the next close. A change that moves a figure in a locked month makes the close refuse, and you reopen the month on purpose. See Closing a month.

Starting again

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

A file the mapping does not read is marked on the Files tab. The next close leaves it out. Analyze data again from the Mappings tab to include it.

Asking Haruno to change one

In a chat outside a project, Haruno can read the books and can edit a company's mapping when you ask. The page re-reads the mapping when the chat's turn ends. Nothing else in the books can be edited from chat. See Ask Haruno about the books.

What to tell a customer

The mapping is the only setup a company needs. Haruno does the first draft, and the customer approves it. The mapping is always editable, and every change goes back through the same review.

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,65 @@
    +---
    +title: Mappings
    +summary: The mapping tells Haruno which of a company's accounts goes on which line of its statements. Haruno suggests one, and a person reviews it and approves it.
    +feature: mappings
    +covers:
    +  - apple/Sources/CFOFeature/Workflow/CFOReviewForm.swift
    +  - apple/Sources/CFOFeature/Workflow/CFOReviewBar.swift
    +  - apple/Sources/CFOFeature/Workflow/CFOSpecDiffView.swift
    +  - apple/Sources/CFOFeature/Workflow/CFOClientSetup.swift
    +  - apple/Sources/CFOFeature/Workflow/CFODraftMappingAgainButton.swift
    +---
    +
    +A company's accounts are named by its own bookkeeping. Its statements have standard lines. The mapping is the list that connects the two. It says which account goes on which line, and which accounts count as what, such as what customers owe or what is spent on marketing.
    +
    +You do not write a mapping. Haruno suggests one from the company's data. You check it.
    +
    +## Where you meet it
    +
    +- The first time, in the setup steps of a new company: <Ui>Analyze data</Ui>, then <Ui>Review suggestions</Ui>. See [Adding a company](/macos/books/add-company/).
    +- Later, on the company's <Ui>Mappings</Ui> tab.
    +
    +## The Mappings tab
    +
    +<Shot src="/m/fd0c136a4f6b-mac-company-mappings-light.png" dark="/m/27b60257b99c-mac-company-mappings-dark.png" alt="The Mappings tab listing accounts and the statement line each one is mapped to" caption="The Mappings tab of a demo company." />
    +
    +The tab is called <Ui>Account → statement line mappings</Ui>. It lists each active mapping by account. Under it, a warning counts the accounts that have activity but no statement line. An unmapped account is silently missing from every statement until it is mapped. Those accounts are marked <Ui>unmapped</Ui>, and each also shows up as a finding.
    +
    +<Ui>Review mapping…</Ui> reopens the review. <Ui>Books ▸ Review Mapping…</Ui> does the same.
    +
    +## Reviewing the suggestions
    +
    +The review page is called <Ui>Review Haruno's suggestions</Ui>.
    +
    +- <Ui>Needs your attention</Ui> lists what Haruno could not decide. Something stays out of the books until each of these is dealt with.
    +- <Ui>Check and confirm</Ui> lists what Haruno read from the data. Each one is used as shown unless you change it. These are optional.
    +- If Haruno has nothing to ask, the page says so: everything was read straight from the data.
    +
    +New companies start from the defaults in <Ui>Settings ▸ Books</Ui>. They are suggestions only. See [Settings for the books](/macos/books/books-settings/).
    +
    +A bar at the foot of the page has two buttons.
    +
    +| Button | What it does |
    +|---|---|
    +| <Ui>Preview changes</Ui> | Shows what your answers would change, and saves nothing. A refusal appears under the row that caused it |
    +| <Ui>Approve mapping</Ui> | Saves your answers. The next close uses them |
    +
    +The bar also says what is still open. For a new company, approval waits for the company's reporting settings, that is, its currency and fiscal year-end. <Ui>Show next</Ui> takes you to the next row to review.
    +
    +<Callout variant="info" title="After approving">
    +For a new company, the next step is to close a month to get the first report. Later changes to the mapping apply from the next close. A change that moves a figure in a locked month makes the close refuse, and you reopen the month on purpose. See [Closing a month](/macos/books/month-close/).
    +</Callout>
    +
    +## Starting again
    +
    +<Ui>Analyze data again</Ui> makes new suggestions from the company's files. It replaces the answers you gave, and Haruno asks first. <Ui>Delete suggestions</Ui> removes the suggestions and your answers. The files stay.
    +
    +A file the mapping does not read is marked on the <Ui>Files</Ui> tab. The next close leaves it out. <Ui>Analyze data</Ui> again from the Mappings tab to include it.
    +
    +## Asking Haruno to change one
    +
    +In a chat outside a project, Haruno can read the books and can edit a company's mapping when you ask. The page re-reads the mapping when the chat's turn ends. Nothing else in the books can be edited from chat. See [Ask Haruno about the books](/macos/books/ask-haruno-about-books/).
    +
    +## What to tell a customer
    +
    +The mapping is the only setup a company needs. Haruno does the first draft, and the customer approves it. The mapping is always editable, and every change goes back through the same review.