Overview
To integrate freee HR, please refer to freee HR.
Integration Specifications
| Target Plans | All |
|---|---|
| Required Admin Role |
Admin *To integrate using custom permissions, please refer to "Integration Using Custom Permissions" below. |
| Integration Method | OAuth |
| Integration Key | |
| Capabilities | Account Visualization |
| Account Visualization Status | Active Deleted |
| Statuses Excluded from Unmanaged IDs | Deleted |
| Provisioning Settings | |
| Deprovisioning Settings | |
| Contract Information | How to check contract information |
| Other Retrieved Items | Business Office |
| Retrieved Attributes |
・Status ・Business Office |
| Retrieved License Items | |
| Common Attributes | Status User |
| Role Editing |
Integrating freee Accounting
- In the left sidebar of Josys, click Integrations > App Catalog.
- Search for and click freee Accounting.
- The integration settings page will appear on the right side.
- Enter the Business Office Name you want to integrate, then click Next.
- How to find your Business Office Name: It is displayed in the upper right corner of the freee Accounting admin console.
- In the example below, the Business Office Name is "Development Test Office".
- The OAuth authentication pop-up window will appear.
- Enter the admin account credentials to complete the integration.
- Only the data of the specified Business Office will be integrated into Josys.
- Verify that the specified Business Office Name is listed under "Business Offices accessible by this application."
Authorized Scopes
<App Permissions Scopes Settings>
- [freee Accounting] Read business office data
- [freee Accounting] User-related information (excluding the logged-in user)
Integration Using Custom Permissions
For the integration with freee Accounting, you can use custom permissions with limited access instead of full administrative privileges.
When configuring custom permissions, please follow the steps and precautions below.
Steps to Create Custom Permissions
Make sure to copy from the "Admin" role when creating custom permissions.
If you copy from roles with fewer privileges (such as "Read-only"), necessary background permissions that do not appear on the screen will be missing, causing the integration to fail.Checkbox Settings for Custom Permissions
Uncheck all items except for "Invite Members" in the custom permissions you created.Impact of Future Specification Changes
The scopes required for integration may change due to future updates in freee Accounting.
Please note that you may need to adjust your settings or re-integrate your account in such cases.
References
If an error occurs during integration, please refer to the freee Accounting error response guide.
https://developer.freee.co.jp/reference/40x-checkpoint
You can check your permissions on the freee Accounting "Member Invitation / Permission Management" screen. https://accounts.secure.freee.co.jp/products/accounting/members