Haruno Knowledge base

Mappings

A company's mapping tells Haruno which account goes on which line of the statements. Haruno drafts it from the files, you review and approve it, and every close follows it.

  • Mac appAvailable
  • Windows appAvailable

Accounting files list accounts, such as "1010 Checking" or "6100 Travel". The statements group those accounts into lines, such as "Cash and cash equivalents" or "Travel & Entertainment". The mapping is the table that says which account goes on which line. It also records which accounts count as what, such as what customers owe or what is spent on marketing.

Haruno drafts the mapping from the company's files. You review it and approve it. Statements, checks and the Overview all follow the approved mapping.

Reviewing the draft

The first time, you reach the review from the setup path (Review the draft). Later, press Review Mapping… at the top of the company's page.

Reviewing Haruno's suggestions.
The Review Haruno's suggestions page. A Needs your attention section lists an account with no statement line and a choice list. A Check and confirm section follows.The Review Haruno's suggestions page. A Needs your attention section lists an account with no statement line and a choice list. A Check and confirm section follows.

The page is called Review Haruno's suggestions and has three parts.

  • Needs your attention. Something is missing from the books until you deal with it. An example is an account that has a balance but sits on no statement line. Pick the line it belongs on, or leave Haruno's suggestion.
  • Check and confirm. Haruno read these from the company's data, for example that a row carries a sign the other way round. Each one is used as shown unless you change it. A box says Read and confirmed.
  • Suggestions kept as they are. You do not have to answer all of them. You can close a month without answering.

A bar stays at the bottom of the page while you scroll. It always says what is left, and it holds the buttons.

  • Preview changes shows what your changes would do without saving them.
  • Approve mapping saves them, and the next close uses them.
  • Show next scrolls to the next item that still needs you and outlines it for a moment. Press it again to go on to the one after. It is the button to use when the bar says something is left, such as "1 item still needs your attention".
  • Done reviewing goes back to the company. Changes you have not approved are not saved.

The bar's sentence changes with the page. It says "Ready to approve" when nothing is open, and how many suggestions stay as they are. It says how many items still need your attention, and tells you that you can approve without them when that is true. It says how many answers need fixing, or that Haruno could not use an answer, before you can approve. When the reporting currency or fiscal year-end is missing, it says so and offers Company details…. A review with only comments to read has no bar.

If you press Approve mapping while an answer is still being saved, Haruno saves it first and then approves. The first button you press wins: a second press while one is waiting is refused, and Delete suggestions and Analyze data again wait too. A tick Haruno cannot save is explained in the bar.

Currency and fiscal year first

Haruno will not let you approve the mapping until the company has a reporting currency and a fiscal year-end month. A button on the page opens Company details.

The Mappings tab

After approval, the Mappings tab lists each account with the statement line it goes on. A small label says where the mapping came from: imported, proposed or approved ✓.

The Mappings tab.
The Mappings tab. A warning says one account has activity but no statement line, and a list shows each account with its statement line.The Mappings tab. A warning says one account has activity but no statement line, and a list shows each account with its statement line.

If an account has activity but no line, the tab says so at the top: Unmapped accounts are silently absent from every statement until mapped. Fix it from Review mapping….

The mapping stays editable. Every change goes back through the same review.

Starting over

Analyze data again makes Haruno read the files again and write new suggestions. It replaces every answer you gave, and those answers cannot be brought back. Haruno asks you to confirm first. Delete suggestions removes the suggestions and your answers but keeps the files, so you can analyze them again.

A new file can need a fresh look

If a file you add later is not read by the mapping, the Files tab says the next close will leave it out. Analyze the data again to include it.

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
    @@ -26,7 +26,16 @@ The page is called <Ui>Review Haruno's suggestions</Ui> and has three parts.
     - **Check and confirm.** Haruno read these from the company's data, for example that a row carries a sign the other way round. Each one is used as shown unless you change it. A box says <Ui>Read and confirmed</Ui>.
     - **Suggestions kept as they are.** You do not have to answer all of them. You can close a month without answering.
     
    -At the bottom, <Ui>Preview changes</Ui> shows what your changes would do without saving them. <Ui>Approve mapping</Ui> saves them, and the next close uses them. <Ui>Done reviewing</Ui> goes back to the company. Changes you have not approved are not saved.
    +A bar stays at the bottom of the page while you scroll. It always says what is left, and it holds the buttons.
    +
    +- <Ui>Preview changes</Ui> shows what your changes would do without saving them.
    +- <Ui>Approve mapping</Ui> saves them, and the next close uses them.
    +- <Ui>Show next</Ui> scrolls to the next item that still needs you and outlines it for a moment. Press it again to go on to the one after. It is the button to use when the bar says something is left, such as "1 item still needs your attention".
    +- <Ui>Done reviewing</Ui> goes back to the company. Changes you have not approved are not saved.
    +
    +The bar's sentence changes with the page. It says "Ready to approve" when nothing is open, and how many suggestions stay as they are. It says how many items still need your attention, and tells you that you can approve without them when that is true. It says how many answers need fixing, or that Haruno could not use an answer, before you can approve. When the reporting currency or fiscal year-end is missing, it says so and offers <Ui>Company details…</Ui>. A review with only comments to read has no bar.
    +
    +If you press <Ui>Approve mapping</Ui> while an answer is still being saved, Haruno saves it first and then approves. The first button you press wins: a second press while one is waiting is refused, and <Ui>Delete suggestions</Ui> and <Ui>Analyze data again</Ui> wait too. A tick Haruno cannot save is explained in the bar.
     
     <Callout variant="info" title="Currency and fiscal year first">
     Haruno will not let you approve the mapping until the company has a reporting currency and a fiscal year-end month. A button on the page opens <Ui>Company details</Ui>.
    
  2. Internal knowledge base for staff: site, reader keys, assistant, 197 pages and the PR rule (#2944)
    What changed
    @@ -0,0 +1,51 @@
    +---
    +title: Mappings
    +summary: A company's mapping tells Haruno which account goes on which line of the statements. Haruno drafts it from the files, you review and approve it, and every close follows it.
    +feature: mappings
    +covers:
    +  - Integrations/cfo/ui/src/Mappings.tsx
    +  - Integrations/cfo/ui/src/ReviewForm.tsx
    +  - Integrations/cfo/ui/src/reviewModel.ts
    +  - Integrations/cfo/ui/src/DraftMappingAgain.tsx
    +  - Integrations/cfo/ui/src/specChanges.ts
    +---
    +
    +Accounting files list accounts, such as "1010 Checking" or "6100 Travel". The statements group those accounts into lines, such as "Cash and cash equivalents" or "Travel & Entertainment". The **mapping** is the table that says which account goes on which line. It also records which accounts count as what, such as what customers owe or what is spent on marketing.
    +
    +Haruno drafts the mapping from the company's files. You review it and approve it. Statements, checks and the Overview all follow the approved mapping.
    +
    +## Reviewing the draft
    +
    +The first time, you reach the review from the setup path (**Review the draft**). Later, press <Ui>Review Mapping…</Ui> at the top of the company's page.
    +
    +<Shot src="/m/b53c6ad752a7-windows-books-review-mapping-light.png" dark="/m/c286c28e60bf-windows-books-review-mapping-dark.png" alt="The Review Haruno's suggestions page. A Needs your attention section lists an account with no statement line and a choice list. A Check and confirm section follows." caption="Reviewing Haruno's suggestions." />
    +
    +The page is called <Ui>Review Haruno's suggestions</Ui> and has three parts.
    +
    +- **Needs your attention.** Something is missing from the books until you deal with it. An example is an account that has a balance but sits on no statement line. Pick the line it belongs on, or leave Haruno's suggestion.
    +- **Check and confirm.** Haruno read these from the company's data, for example that a row carries a sign the other way round. Each one is used as shown unless you change it. A box says <Ui>Read and confirmed</Ui>.
    +- **Suggestions kept as they are.** You do not have to answer all of them. You can close a month without answering.
    +
    +At the bottom, <Ui>Preview changes</Ui> shows what your changes would do without saving them. <Ui>Approve mapping</Ui> saves them, and the next close uses them. <Ui>Done reviewing</Ui> goes back to the company. Changes you have not approved are not saved.
    +
    +<Callout variant="info" title="Currency and fiscal year first">
    +Haruno will not let you approve the mapping until the company has a reporting currency and a fiscal year-end month. A button on the page opens <Ui>Company details</Ui>.
    +</Callout>
    +
    +## The Mappings tab
    +
    +After approval, the **Mappings** tab lists each account with the statement line it goes on. A small label says where the mapping came from: <Ui>imported</Ui>, <Ui>proposed</Ui> or <Ui>approved ✓</Ui>.
    +
    +<Shot src="/m/3c0eb1281144-windows-books-mappings-light.png" dark="/m/30b202ce297a-windows-books-mappings-dark.png" alt="The Mappings tab. A warning says one account has activity but no statement line, and a list shows each account with its statement line." caption="The Mappings tab." />
    +
    +If an account has activity but no line, the tab says so at the top: <Ui>Unmapped accounts are silently absent from every statement until mapped.</Ui> Fix it from <Ui>Review mapping…</Ui>.
    +
    +The mapping stays editable. Every change goes back through the same review.
    +
    +## Starting over
    +
    +<Ui>Analyze data again</Ui> makes Haruno read the files again and write new suggestions. It replaces every answer you gave, and those answers cannot be brought back. Haruno asks you to confirm first. <Ui>Delete suggestions</Ui> removes the suggestions and your answers but keeps the files, so you can analyze them again.
    +
    +<Callout variant="tip" title="A new file can need a fresh look">
    +If a file you add later is not read by the mapping, the Files tab says the next close will leave it out. Analyze the data again to include it.
    +</Callout>