Haruno Knowledge base

Organization Yayoi app

Yayoi cannot be connected until an organization admin saves the organization's own Yayoi application. This page covers the closed section on the Organization page, its three steps, and replacing or removing it.

  • DashboardAvailable

Misoca is the invoicing service of Yayoi, and Haruno has a Yayoi connector that reaches it. Unlike most connectors, Yayoi has no Haruno-owned application behind it, so each organization registers its own and gives the details to Haruno here.

Only organization admins see this. It sits in a closed section called Your own sign-in apps (optional) near the bottom of the Organization page. The line under the title says "Haruno uses its own apps unless your organization must register its own. Yayoi always needs one." Press the title to open it.

The section opened, with no Yayoi app saved yet.
The Your own sign-in apps section, opened. It holds the Organization Yayoi app card, marked Not configured. On the left three steps: Register an application, Set the callback URL and Copy the client ID and secret. On the right a box with empty Yayoi client ID and Yayoi client secret fields and a Save Yayoi app button.
Until it is saved, nobody can connect Yayoi

The card says "until it is saved, nobody can connect." This is the first thing to check when a customer in Japan cannot connect Yayoi.

Setting it up

The card is a guide on the left and a form on the right.

  1. Register an application in Misoca

    Sign in to Misoca with any Misoca account you manage and add an application on its applications page. The link Misoca OAuth applications opens that page in a new tab. Each member then connects Yayoi with their own Misoca account, and each sees only their own Misoca data.

  2. Give it the callback address

    The card shows the Callback URL in a box. Give the application exactly this address. Even one extra slash at the end breaks every sign-in. If the box says there is no callback address yet, Yayoi sign-in is not set up on this server yet.

  3. Copy the client ID and the secret

    Misoca shows them once the application is saved. Paste both into Yayoi client ID and Yayoi client secret, then press Save Yayoi app.

After saving, the card is marked Application saved. It shows the current client ID and when it was last updated. The secret is stored encrypted and is never shown again.

A saved Yayoi app.
The Organization Yayoi app card marked Application saved. A Replace Yayoi app form with the Current client ID, the date it was last updated and a Remove Yayoi app link. The client ID box is filled in and the secret box is empty.

Replacing and removing

  • To change the application, enter the client ID and the secret together. The secret is never kept in view, so it must be typed again, even if only the ID changes. The card says "Enter the client secret."
  • Remove Yayoi app asks first. Then nobody can connect or renew until an application is saved again.
  • Existing connections keep working until their next daily renewal. A new secret for the same Misoca application needs nothing from members. After switching to a different Misoca application, members have to connect Yayoi again.
  • If two admins save at the same time, the second sees "Someone changed this setting. The latest version has been loaded; review it and try again."

Limits on what can be typed

The client ID can be up to 255 characters and the secret up to 512. Neither may contain spaces or hidden characters. Otherwise the card shows "Enter a client ID of up to 255 characters and a secret of up to 512, neither containing spaces or invisible characters."

Other apps

An organization's own QuickBooks app has no screen on the dashboard. The Google app card is hidden. See Organization Google app.

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,55 @@
    +---
    +title: Organization Yayoi app
    +summary: "Yayoi cannot be connected until an organization admin saves the organization's own Yayoi application. This page covers the closed section on the Organization page, its three steps, and replacing or removing it."
    +feature: dashboard-org-yayoi-app
    +covers:
    +  - web/dashboard/app/[lang]/organization/page.tsx
    +  - web/dashboard/components/OrganizationYayoiAppCard.tsx
    +  - web/dashboard/components/OrganizationYayoiApp.module.css
    +  - web/dashboard/e2e/organization-yayoi-app.spec.ts
    +---
    +
    +Misoca is the invoicing service of Yayoi, and Haruno has a Yayoi connector that reaches it. Unlike most connectors, Yayoi has no Haruno-owned application behind it, so **each organization registers its own** and gives the details to Haruno here.
    +
    +Only organization **admins** see this. It sits in a closed section called **Your own sign-in apps (optional)** near the bottom of the Organization page. The line under the title says "Haruno uses its own apps unless your organization must register its own. Yayoi always needs one." Press the title to open it.
    +
    +<Shot src="/m/88099d0f94dc-dashboard-org-sign-in-apps-light.webp" alt="The Your own sign-in apps section, opened. It holds the Organization Yayoi app card, marked Not configured. On the left three steps: Register an application, Set the callback URL and Copy the client ID and secret. On the right a box with empty Yayoi client ID and Yayoi client secret fields and a Save Yayoi app button." caption="The section opened, with no Yayoi app saved yet." />
    +
    +<Callout variant="warning" title="Until it is saved, nobody can connect Yayoi">
    +The card says "until it is saved, nobody can connect." This is the first thing to check when a customer in Japan cannot connect Yayoi.
    +</Callout>
    +
    +## Setting it up
    +
    +The card is a guide on the left and a form on the right.
    +
    +<Steps>
    +<Step title="Register an application in Misoca">
    +Sign in to Misoca with any Misoca account you manage and add an application on its applications page. The link **Misoca OAuth applications** opens that page in a new tab. Each member then connects Yayoi with their own Misoca account, and each sees only their own Misoca data.
    +</Step>
    +<Step title="Give it the callback address">
    +The card shows the **Callback URL** in a box. Give the application exactly this address. Even one extra slash at the end breaks every sign-in. If the box says there is no callback address yet, Yayoi sign-in is not set up on this server yet.
    +</Step>
    +<Step title="Copy the client ID and the secret">
    +Misoca shows them once the application is saved. Paste both into **Yayoi client ID** and **Yayoi client secret**, then press **Save Yayoi app**.
    +</Step>
    +</Steps>
    +
    +After saving, the card is marked **Application saved**. It shows the current client ID and when it was last updated. The secret is stored encrypted and is never shown again.
    +
    +<Shot src="/m/622ff6c440e2-dashboard-org-yayoi-saved-light.webp" alt="The Organization Yayoi app card marked Application saved. A Replace Yayoi app form with the Current client ID, the date it was last updated and a Remove Yayoi app link. The client ID box is filled in and the secret box is empty." caption="A saved Yayoi app." />
    +
    +## Replacing and removing
    +
    +- To change the application, enter the client ID and the secret **together**. The secret is never kept in view, so it must be typed again, even if only the ID changes. The card says "Enter the client secret."
    +- **Remove Yayoi app** asks first. Then nobody can connect or renew until an application is saved again.
    +- Existing connections keep working until their next daily renewal. A new secret for the **same** Misoca application needs nothing from members. After switching to a **different** Misoca application, members have to connect Yayoi again.
    +- If two admins save at the same time, the second sees "Someone changed this setting. The latest version has been loaded; review it and try again."
    +
    +## Limits on what can be typed
    +
    +The client ID can be up to 255 characters and the secret up to 512. Neither may contain spaces or hidden characters. Otherwise the card shows "Enter a client ID of up to 255 characters and a secret of up to 512, neither containing spaces or invisible characters."
    +
    +## Other apps
    +
    +An organization's own QuickBooks app has no screen on the dashboard. The Google app card is hidden. See [Organization Google app](/dashboard/my-organization/google-app/).