> ## Documentation Index
> Fetch the complete documentation index at: https://hc.saas-manager.biz.nuro.jp/llms.txt
> Use this file to discover all available pages before exploring further.

# Bakuraku Series

> Steps to integrate with the Bakuraku Series. This guide covers everything from logging into the Bakuraku Series as an administrator to completing the integration with MoneyForward Admina.

## Supported Features

<Badge color="blue">Account Deactivation</Badge> <Badge color="blue">Account Provisioning</Badge>

## Prerequisites

### How to Connect with Bakuraku Series

Go to the [Bakuraku login page](https://id.layerx.jp/auth/sign_in) and sign in with your **email address and password**.

<img src="https://mintcdn.com/admina-sbn/LOzFBGt8H5wPL0o1/images/integrations/r7u4ghb6yi/1708578936349-image.png?fit=max&auto=format&n=LOzFBGt8H5wPL0o1&q=85&s=53e0db657c5bd86788e17b04cbe51fe5" alt="Bakuraku login screen" width="621" height="656" data-path="images/integrations/r7u4ghb6yi/1708578936349-image.png" />

### Generating an API Key

<Info>
  Generating an API key requires prior registration with LayerX. If you wish to set up the integration, please fill out and submit the [Bakuraku SaaS Management Tool Integration Application Form](https://docs.google.com/forms/d/e/1FAIpQLSct-ZVSsOHbNw1nO9J0nwoCTrXgA6slPGM-XuMLwx5Zl5WL2A/viewform).
</Info>

1. Access Bakuraku Common Administration, then go to Settings > API Management, and click \[**New**] in the API Keys tab.
   For details, refer to [Bakuraku Common Administration (external site)](https://bakuraku-login.layerx.jp/hc/ja).

<img src="https://mintcdn.com/admina-sbn/LOzFBGt8H5wPL0o1/images/integrations/r7u4ghb6yi/1724731585359-image.png?fit=max&auto=format&n=LOzFBGt8H5wPL0o1&q=85&s=4fd0fb7a6dbd79251fe28b00ee28b4f7" alt="API key creation screen" width="2632" height="856" data-path="images/integrations/r7u4ghb6yi/1724731585359-image.png" />

2. Access Bakuraku Common Administration, go to Settings > API Management, and click \[New] in the API Keys tab.
   Enter any name for the API key and check the following scopes, then save.
   * Users: `Read`, `Write`
   * Organization Chart: `Read`, `Write`

<img src="https://mintcdn.com/admina-sbn/LOzFBGt8H5wPL0o1/images/integrations/r7u4ghb6yi/1724731684504-image.png?fit=max&auto=format&n=LOzFBGt8H5wPL0o1&q=85&s=3b4aa018f5fbc840dee6c094b024f5a3" alt="API key scope settings screen" width="1580" height="1622" data-path="images/integrations/r7u4ghb6yi/1724731684504-image.png" />

3. Your API key will be generated. Copy and save it. This completes obtaining the API key needed for Admina integration.

<img src="https://mintcdn.com/admina-sbn/LOzFBGt8H5wPL0o1/images/integrations/r7u4ghb6yi/1724731293104-image.png?fit=max&auto=format&n=LOzFBGt8H5wPL0o1&q=85&s=7f70115501bad8aed2bd8a0d8b3e66d6" alt="API key generation complete screen" width="1572" height="630" data-path="images/integrations/r7u4ghb6yi/1724731293104-image.png" />

## Integration Setup

1. In Admina's integration screen, search for **"Bakuraku Series"** under Integrations.

<img src="https://mintcdn.com/admina-sbn/LOzFBGt8H5wPL0o1/images/integrations/r7u4ghb6yi/1708580795167-image.png?fit=max&auto=format&n=LOzFBGt8H5wPL0o1&q=85&s=3bb8d7a443ea2c46bd1cbecc3648c4f7" alt="Admina integration search screen" width="947" height="606" data-path="images/integrations/r7u4ghb6yi/1708580795167-image.png" />

2. Enter the API key you obtained and click \[Connect].

<img src="https://mintcdn.com/admina-sbn/LOzFBGt8H5wPL0o1/images/integrations/r7u4ghb6yi/1724731825485-image.png?fit=max&auto=format&n=LOzFBGt8H5wPL0o1&q=85&s=aff86f66b86cde849e4ac1be1abb8e52" alt="API key input screen" width="492" height="531" data-path="images/integrations/r7u4ghb6yi/1724731825485-image.png" />

3. Once the integration with Bakuraku Series is successful, the registered user information will appear in the account list.
   If the process does not complete successfully, go to the **Status** tab on the integration screen, click **Edit**, and try connecting again.
   If the issue persists, please contact us via chat. For an overview of the Bakuraku Series integration, visit the [integration page](https://admina.moneyforward.com/en/integrations/bakuraku).

## Account Lifecycle

The following account lifecycle operations are supported.

* Provisioning (new registration / additional registration)
* Deactivate (deactivation)

<Info>
  If the Employee ID (employeeCode) is not entered in the Bakuraku admin console or in the Admina directory, an error will occur. When performing Provisioning/Deactivate in Admina, please make sure to enter the Employee ID.
  In Admina, go to Directory > Select the target person > User Information > Employee ID to set this value.
</Info>