Haruno Knowledge base

Yayoi invoicing (Misoca)

Haruno can look up invoices, quotes and customers in a Misoca account, and with your approval create an invoice or mark one paid. An organization administrator sets the connection up once.

  • Mac appNot availableThe Mac app has no Yayoi connector.
  • Windows appAvailableAn organization administrator registers the Yayoi app on the dashboard first.

Misoca is Yayoi's service for invoices and quotes. The connector named Yayoi lets Haruno work with a Misoca account in chat. For example, you can ask which invoices are unpaid, or have Haruno draft an invoice.

It is a different product from 弥生会計 Next, which holds the books. This connector says nothing about journals or ledgers.

One-time setup by an administrator

Every other connector signs in with an app that ships with Haruno. This one uses an app that your organization registers, so until an administrator does that, nobody in the organization can connect.

  1. Register an app in Misoca

    An administrator signs in to Misoca and adds an application on Misoca's OAuth applications page. Any Misoca account the administrator manages will do.

  2. Give it the callback address

    The Haruno dashboard prints a callback URL. Enter it in Misoca exactly as shown. One extra character, such as a trailing slash, breaks every sign-in.

  3. Save the credentials in the dashboard

    On the dashboard's Organization page, open the section Your own sign-in apps (optional). The card Organization Yayoi app takes the client ID and client secret from Misoca. Press Save Yayoi app. The secret is stored encrypted and is never shown again.

Only administrators see this card. Replacing or removing the app does not interrupt connections that already exist until their next daily renewal.

Each person connects

Open Settings ▸ Connectors, find Yayoi under Finance, and press Connect. Haruno opens Misoca in your browser. Sign in and approve. Each person connects with their own Misoca account and sees only that account's data.

If something is not ready, Connect says what to do. For example: "Yayoi is not set up for this organization yet. Ask an administrator to add the Yayoi app credentials." A person who is in no organization is told to join one, or to create one in the dashboard.

What Haruno can do

Haruno canNeeds your approval?
Show which Misoca account is connectedNo
List invoices, filtered by date, customer or whether they are paid or sentNo
Read one invoice, with its lines and totalsNo
List and read quotesNo
List customers, ship-to contacts and catalogue itemsNo
Create an invoiceYes
Record an invoice as paid, or take that record backYes

The two actions that change your Misoca account ask first. Creating an invoice adds a real document to your records. Recording a payment moves no money. It only changes what Misoca shows as received.

Nothing is sent to anyone

The invoice Haruno creates is not issued, and Haruno does not send it. It cannot email an invoice, post one on paper, or send a quote. It also cannot create or change customers, contacts, items or quotes. It reads those, and it creates invoices and records payments, and that is all.

Dates are written as calendar days, such as 2026/01/31. A date with a time is refused rather than guessed.

Keeping the connection

Misoca connections last a day at a time. Haruno renews them by itself, so a connection made yesterday just works today. If Misoca refuses the connection itself, Haruno says: "Yayoi no longer accepts this connection. Reconnect Yayoi in Settings." Press Connect again to restore it. A short network trouble shows as "Yayoi could not be reached to renew the connection. It will be tried again." Nothing is lost. Disconnect removes the stored connection from this computer.

If the administrator's app stops working, for example Misoca refuses its credentials, everyone in the organization sees a message that tells them to ask an administrator. Their connections are kept.

What to tell a customer

Misoca's own documentation says its programming interface is not supported by Misoca and may change. Haruno works with it as published, so a change on Misoca's side can briefly affect this connector.

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,66 @@
    +---
    +title: Yayoi invoicing (Misoca)
    +summary: Haruno can look up invoices, quotes and customers in a Misoca account, and with your approval create an invoice or mark one paid. An organization administrator sets the connection up once.
    +feature: yayoi-invoicing
    +covers:
    +  - windows-client/docs/yayoi-invoicing.md
    +  - Integrations/yayoi/**
    +---
    +
    +Misoca is Yayoi's service for invoices and quotes. The connector named <Ui>Yayoi</Ui> lets Haruno work with a Misoca account in chat. For example, you can ask which invoices are unpaid, or have Haruno draft an invoice.
    +
    +It is a different product from [弥生会計 Next](/windows/books/yayoi-accounting/), which holds the books. This connector says nothing about journals or ledgers.
    +
    +## One-time setup by an administrator
    +
    +Every other connector signs in with an app that ships with Haruno. This one uses an app that **your organization** registers, so until an administrator does that, nobody in the organization can connect.
    +
    +<Steps>
    +<Step title="Register an app in Misoca">
    +An administrator signs in to Misoca and adds an application on Misoca's OAuth applications page. Any Misoca account the administrator manages will do.
    +</Step>
    +<Step title="Give it the callback address">
    +The Haruno dashboard prints a callback URL. Enter it in Misoca exactly as shown. One extra character, such as a trailing slash, breaks every sign-in.
    +</Step>
    +<Step title="Save the credentials in the dashboard">
    +On the dashboard's **Organization** page, open the section <Ui>Your own sign-in apps (optional)</Ui>. The card <Ui>Organization Yayoi app</Ui> takes the client ID and client secret from Misoca. Press <Ui>Save Yayoi app</Ui>. The secret is stored encrypted and is never shown again.
    +</Step>
    +</Steps>
    +
    +Only administrators see this card. Replacing or removing the app does not interrupt connections that already exist until their next daily renewal.
    +
    +## Each person connects
    +
    +Open <Ui>Settings ▸ Connectors</Ui>, find <Ui>Yayoi</Ui> under **Finance**, and press <Ui>Connect</Ui>. Haruno opens Misoca in your browser. Sign in and approve. Each person connects with their own Misoca account and sees only that account's data.
    +
    +If something is not ready, Connect says what to do. For example: "Yayoi is not set up for this organization yet. Ask an administrator to add the Yayoi app credentials." A person who is in no organization is told to join one, or to create one in the dashboard.
    +
    +## What Haruno can do
    +
    +| Haruno can | Needs your approval? |
    +|---|---|
    +| Show which Misoca account is connected | No |
    +| List invoices, filtered by date, customer or whether they are paid or sent | No |
    +| Read one invoice, with its lines and totals | No |
    +| List and read quotes | No |
    +| List customers, ship-to contacts and catalogue items | No |
    +| **Create an invoice** | **Yes** |
    +| **Record an invoice as paid**, or take that record back | **Yes** |
    +
    +The two actions that change your Misoca account ask first. Creating an invoice adds a real document to your records. Recording a payment moves no money. It only changes what Misoca shows as received.
    +
    +<Callout variant="warning" title="Nothing is sent to anyone">
    +The invoice Haruno creates is **not issued**, and Haruno does not send it. It cannot email an invoice, post one on paper, or send a quote. It also cannot create or change customers, contacts, items or quotes. It reads those, and it creates invoices and records payments, and that is all.
    +</Callout>
    +
    +Dates are written as calendar days, such as 2026/01/31. A date with a time is refused rather than guessed.
    +
    +## Keeping the connection
    +
    +Misoca connections last a day at a time. Haruno renews them by itself, so a connection made yesterday just works today. If Misoca refuses the connection itself, Haruno says: "Yayoi no longer accepts this connection. Reconnect Yayoi in Settings." Press <Ui>Connect</Ui> again to restore it. A short network trouble shows as "Yayoi could not be reached to renew the connection. It will be tried again." Nothing is lost. <Ui>Disconnect</Ui> removes the stored connection from this computer.
    +
    +If the **administrator's** app stops working, for example Misoca refuses its credentials, everyone in the organization sees a message that tells them to ask an administrator. Their connections are kept.
    +
    +<Callout variant="info" title="What to tell a customer">
    +Misoca's own documentation says its programming interface is not supported by Misoca and may change. Haruno works with it as published, so a change on Misoca's side can briefly affect this connector.
    +</Callout>