Skip to main content

FAQs

Acumatica Authentication

This guide applies to both cloud and on-prem instances. To deploy a developer sandbox locally, follow Acumatica's guide here.

Step 1: Create a Connected Application in Acumatica​

note

Agave will inherit the permissions of the user that follows this process, so ensure they have enough access for your use case.

  1. Navigate to Integration > Connected Applications.

  2. Enter the Client Name and Select Authorization Code for the Authentication Flow. Click Save. After clicking the save button (top left), the Client ID box will autofill. Ensure the Active checkbox is selected.

  3. Versions 2023 R2 and later only: Set the "Refresh Tokens" settings:

    • Set Mode to Sliding Expiration

    • Set Absolute Lifetime to Infinite or as long as you plan to use the integration. You will need to reconnect after this time period

    • Set the Sliding Lifetime. Generally 15 - 30 days works well

    • For more information on sliding expiration, see Acumatica's help article

  4. Click Add Shared Secret to generate credentials:

  5. Enter a Description and optionally an Expiration Date. Save the Client ID and Secret somewhere safe before closing this box. You will not be able to view the secret again after clicking "OK."

    • The Expires On (UTC) field will determine how long the secret is valid. If it expires, you will have to create another account token.

  6. Save (top left) on the Connected Application screen again to activate the Client ID and Secret.

Step 2: Add a Redirect URI to the Connected Application​

Adding a Redirect URI enables the OAuth flow through Agave Link.

  1. Click the Redirect URIs tab from the Connected Application Record at the end of Step 1.

  2. Create an entry (click the Plus) and enter https://app.agaveapi.com/link/oauth-callback in the row.

  3. Save (top left). The connected application is now fully set up.

  1. Use the Agave Link Component to connect an Acumatica account.
  2. Enter the credentials generated in Step 1.

  • Full Acumatica URL: URL used to access your instance. For accounts hosted by Acumatica, it will look like this: https://acme.myacumatica.com. Note: Ensure the URL does not contain any characters after the top-level domain (eg ".com").
  • Instance Name: Name of your Acumatica instance. Typically the first element in the URL Path of your Acumatica instance (after the domain). Note The Instance Name may be omitted when installed at the root of the site (such as when hosted by Acumatica).
  • Client ID: The Client ID created for the Connected Application in Step 1.
  • Client Secret: The Client Secret created for the Connected Application in Step 1.
  1. Click Log in with Acumatica.
  1. Sign in with Acumatica and grant permissions to Agave.
IMPORTANT

Only click the "Yes, Allow" button once, otherwise Acumatica will overload with concurrent requests.

  1. Done! Agave Link will close if the connection is successful.

Publish the Agave Customization Package to Acumatica​

Step 1: Download the Agave.zip file​

Click here to download the zip file

Step 2: Open Customization Project Screen​

In Acumatica, navigate to: Construction > Projects Preferences > Customization > Manage Customizations This will open the Customizations Project window

Step 3: Import the Agave Customization​

  1. Click “IMPORT”
  2. Click “Choose File” and select the Agave.zip
  3. Click Upload

Step 4: Publish the Customization Project​

  1. Select the the checkbox next to the “Agave” Project
  2. Click “PUBLISH”

Step 5: Save​

After publishing, click the Save button to finalize the installation

Step 6: Publish Agave Reports to the UI​

After installing the customization, you need to update several generic inquiries to ensure that Agave can retrieve project-specific data correctly.

  1. Navigate to: Generic Inquiry (Screen ID SM20800)
  2. Click the Search Inquiry Title field to open a list view
  3. Select AG-job-costs
  1. Uncheck the “Expose via OData” box
  2. Click “PUBLISH TO THE UI”
  3. Under ACCESS RIGHTS select “Set to Granted for All Roles”
  4. Click Publish

Repeat the steps for the following inquiries:

  1. AG-AP-Payment-Details
  2. AG-AP-Payment-Detail
  3. AG-AP-Payment-Headers
  4. AG-AP-Payment Header
  5. AG-AP-Invoices-By-Subcontract