Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

feat(integrations): add support for sage-intacct-oauth-support #3547

Merged
merged 3 commits into from
Feb 21, 2025
Merged
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
97 changes: 97 additions & 0 deletions docs-v2/integrations/all/sage-intacct-oauth.mdx
Original file line number Diff line number Diff line change
@@ -0,0 +1,97 @@
---
title: Sage Intacct (OAuth)
sidebarTitle: Sage Intacct (OAuth)
---

import Overview from "/snippets/overview.mdx"
import PreBuiltTooling from "/snippets/generated/sage-intacct-oauth/PreBuiltTooling.mdx"
import PreBuiltUseCases from "/snippets/generated/sage-intacct-oauth/PreBuiltUseCases.mdx"

<Overview />
<PreBuiltTooling />
<PreBuiltUseCases />

## Access requirements
| Pre-Requisites | Status | Comment|
| - | - | - |
| Paid dev account | ✅ Not required | Free, self-signup [here](https://developer.sage.com/intacct/). |
| Paid test account | ✅ Not required | Create a 30 day free trial account [here](https://online.sageintacct.com/WebsiteAssets_request_trial.html). |
| Partnership | ❓ | |
| App review | ❓ | |
| Security audit | ❓ | |


## Setup guide
- You must have an active Sage Intacct Web Services developer license, which includes a Web Services sender ID and password or access to a free trial period account.
<Tip>If you need a developer license, contact your account manager.</Tip>

<Steps>
<Step title="Create a new developer workspace">
Go to [developer console](https://developer.sage.com/intacct/) and login if you have an account or signup for a free developer's account.

Click **View workspaces**, then enter your Sage account email address and password to log in.

Click **Add workspace** to create a workspace for your company.

Enter a name for your workspace and a contact email address, then click **Create**.
</Step>

<Step title="Add a client application">
Click **Apps** in the left column navigation.

Click **Add application**.

Enter a name to identify the application in your workspace, a home page URL, and a contact email address for the application, then click **Create**.
</Step>
<Step title="Obtaining Client Credentials">
From the list of applications in your workspace, click your new application to open it.

Click **Create API keys**.

From the **Sage Product API** drop-down list, select Sage Intacct.

Enter a Redirect URI as a full URL. During the authorization process, users will be redirected to this URL after authorizing your application to access their data in Sage Intacct. You can configure the following Redirect URL: `https://api.nango.dev/oauth/callback`.

If you have custom applications that send Sage Intacct API requests from your domains, enter those domains in **Allowed Origin Domains** as full https URLs.

Enter your Sage Intacct Web Services sender ID and password.

From the **Client Scope** drop-down list, select the type of company to associate with these API keys:

- **Non-Production**: Choose this option if you're working with a sandbox implementation or other non-production company.

- **Production**: Choose this option if you're working with a live production company. Production companies are limited to no more than five associated API keys.

<Note>You cannot change the client scope after it has been set</Note>

Click **Create**.

When your registration is complete, the Application Details page will include an API Keys section. Click **Sage Intacct** in that list to view your application's **client ID** and **secret key**.
</Step>
<Step title="Next">
Follow the [_Quickstart_](/getting-started/quickstart).
</Step>
</Steps>

<Tip>Need help getting started? Get help in the [community](https://nango.dev/slack).</Tip>

<Note>Contribute improvements to the setup guide by [editing this page](https://github.com/nangohq/nango/tree/master/docs-v2/integrations/all/sage-intacct-oauth.mdx)</Note>


## Useful links

| Topic | Links |
| - | - |
| General | [Website](https://www.sage.com/en-gb/sage-business-cloud/intacct/) |
| | [Create a test account](https://online.sageintacct.com/WebsiteAssets_request_trial.html) |
| Developer | [API documentation](https://developer.sage.com/intacct/docs/) |
| | [Create or Login to a developer account](https://app-registry.sage.com/) |
| | [Developer console](https://developer.sage.com/intacct/) |
| | [Authorization documentation](https://developer.sage.com/intacct/docs/developer-portal/guides/oauth2/#authorization-code-grant-type) |


<Note>Contribute useful links by [editing this page](https://github.com/nangohq/nango/tree/master/docs-v2/integrations/all/sage-intacct-oauth.mdx)</Note>

## API gotchas

<Note>Contribute API gotchas by [editing this page](https://github.com/nangohq/nango/tree/master/docs-v2/integrations/all/sage-intacct-oauth.mdx)</Note>
1 change: 1 addition & 0 deletions docs-v2/mint.json
Original file line number Diff line number Diff line change
Expand Up @@ -544,6 +544,7 @@
"integrations/all/rippling",
"integrations/all/sage",
"integrations/all/sage-intacct",
"integrations/all/sage-intacct-oauth",
"integrations/all/salesforce",
"integrations/all/salesforce-experience-cloud",
"integrations/all/salesforce-cdp",
Expand Down
41 changes: 41 additions & 0 deletions docs-v2/snippets/generated/sage-intacct-oauth/PreBuiltTooling.mdx
Original file line number Diff line number Diff line change
@@ -0,0 +1,41 @@
## Pre-built tooling
<AccordionGroup>
<Accordion title="✅ Authorization">
| Tools | Status |
| - | - |
| Pre-built authorization (OAuth) | ✅ |
| Credentials auto-refresh | ✅ |
| Auth parameters validation | ✅ |
| Pre-built authorization UI | ✅ |
| Custom authorization UI | ✅ |
| Expired credentials detection | ✅ |
</Accordion>
<Accordion title="✅ Read & write data">
| Tools | Status |
| - | - |
| Pre-built integrations | 🚫 (time to contribute: &lt;48h) |
| API unification | ✅ |
| 2-way sync | ✅ |
| Webhooks from Nango on data modifications | ✅ |
| Real-time webhooks from 3rd-party API | 🚫 (time to contribute: &lt;48h) |
| Proxy requests | ✅ |
</Accordion>
<Accordion title="✅ Observability & data quality">
| Tools | Status |
| - | - |
| HTTP request logging | ✅ |
| End-to-type type safety | ✅ |
| Data runtime validation | ✅ |
| OpenTelemetry export | ✅ |
| Slack alerts on errors | ✅ |
| Integration status API | ✅ |
</Accordion>
<Accordion title="✅ Customization">
| Tools | Status |
| - | - |
| Create or customize use-cases | ✅ |
| Pre-configured pagination | 🚫 (time to contribute: &lt;48h) |
| Pre-configured rate-limit handling | 🚫 (time to contribute: &lt;48h) |
| Per-customer configurations | ✅ |
</Accordion>
</AccordionGroup>
Original file line number Diff line number Diff line change
@@ -0,0 +1,5 @@
## Pre-built integrations

_No pre-built integration yet (time to contribute: &lt;48h)_

<Tip>Not seeing the integration you need? [Build your own](https://docs.nango.dev/guides/custom-integrations/overview) independently.</Tip>
18 changes: 18 additions & 0 deletions packages/providers/providers.yaml
Original file line number Diff line number Diff line change
Expand Up @@ -6632,6 +6632,24 @@ sage:
base_url: https://api.accounting.sage.com
docs: https://docs.nango.dev/integrations/all/sage

sage-intacct-oauth:
display_name: Sage Intacct (OAuth)
categories:
- accounting
- erp
auth_mode: OAUTH2
authorization_url: https://api.intacct.com/ia/api/v1/oauth2/authorize
token_url: https://api.intacct.com/ia/api/v1/oauth2/token
authorization_params:
response_type: code
token_params:
grant_type: authorization_code
refresh_params:
grant_type: refresh_token
proxy:
base_url: https://api.intacct.com/ia/api
docs: https://docs.nango.dev/integrations/all/sage-intacct-oauth

sage-intacct:
display_name: Sage Intacct
categories:
Expand Down
Loading