DocJuris
DocJuris is a contract negotiation workspace that empowers legal and business teams to close deals with speed and accuracy.
This connector is available in the following products and regions:
Service | Class | Regions |
---|---|---|
Logic Apps | Standard | All Logic Apps regions except the following: - Azure Government regions - Azure China regions - US Department of Defense (DoD) |
Power Automate | Premium | All Power Automate regions except the following: - US Government (GCC) - US Government (GCC High) - China Cloud operated by 21Vianet - US Department of Defense (DoD) |
Power Apps | Premium | All Power Apps regions except the following: - US Government (GCC) - US Government (GCC High) - China Cloud operated by 21Vianet - US Department of Defense (DoD) |
Contact | |
---|---|
Name | DocJuris Support |
URL | https://help.docjuris.com |
[email protected] |
Connector Metadata | |
---|---|
Publisher | DocJuris |
Website | https://www.docjuris.com |
Privacy policy | http://www.docjuris.com/privacy-policy |
Categories | Productivity |
DocJuris for Power Automate empowers users to connect apps together to create useful contract workflows that save time and risk. With the connector, users can leverage DocJuris' innovative contract collaboration and editing capabilities to automate an organization's contract lifecycle from intake to esign to storage. For example, route a contract request from Microsoft Forms to DocJuris and simultaneously notify users in Teams or in Dynamics. DocJuris and Power Automate are a perfect complement to enrich contract processes and enable low code automation for small and large teams.
Prerequisites
DocJuris for Power Automate requires a paid subscription to DocJuris. Please get in touch on www.docjuris.com.
How to get credentials
To authorize DocJuris for Power Automate, visit the Organization
tab in your DocJuris settings. Next, copy the Organization ID
and paste it into the organizationId
field in Power Automate. Third, click Generate new key
and give it a helpful name like "Jill's Power Automate". Click the copy icon to copy the new key and paste the value into the apiKey
field in Power Automate.
Getting started with your connector
In this step-by-step sample flow, we'll submit a contract request form in Microsoft Forms and route a contract to DocJuris. During this example flow, we'll also configure the connector.
Create a Microsoft Form
Create a simple Microsoft Form and include, at a minimum, a file attachment question.
Create a New Automated Cloud Flow
Open Power Automate and click Create. Next, select Automated Cloud Flow
.
Next, Skip
the wizard and arrive to the page to search for connectors and triggers.
Trigger Microsoft Forms
Click Microsoft Forms
or search for it.
Select the Trigger When a new response is submitted
.
Select the form you created earlier from the list next to the Form Id
field and click ``+ New step`.
Get Response Details from Microsoft Forms
To retrieve information from a Microsoft Forms submission, pick Microsoft Forms
as the Action and select Get Response Details
. Next, select the Form Id
and select the Response Id
associated with form submissions. It should be the only Dynamic content
available at this stage.
Setup the DocJuris Connector
Under Choose an operation
, click the Custom
tab and pick DocJuris
from the list. DocJuris will also show up under All
in the future.
Click Create an import file
as the Action
Configuring Connection Information in Power Automate
When you first create a new flow using the DocJuris connector, you will be prompted for connection information:
For Connection Name
pick something meaningful to you, such as "Jill's DocJuris Connection".
The other two values must be found within the DocJuris application.
Grab Keys from DocJuris
After logging in to DocJuris, click the circle icon with your initials in the upper right of the application:
In the resulting page, open the Organization
tab.
- The "Organization ID" at the bottom is the first part of your connection credential. Copy this and paste it into the
organizationId
field in Power Automate. - The second part requires an API Key. Click "Generate new key" and give it a helpful name like "Jill's Power Automate". Click the copy icon to copy the new key- this is the only time you will see it! Paste the value into the
apiKey
field in Power Automate.
Create an Import File in DocJuris
Now that you've configured DocJuris, we can now create an import file. Once the connector is authenticated, you'll see options For Extended data name/value/type
- you can ignore these for now.
- Skip down to
Import file
and pick the field from the Microsoft Form where the user uploaded a file. - Under
Import file name
, you can use a date stamp or other unique identifier or name from the Microsoft forms submission.
Click Save
and proceed to Test the Microsoft Form in trigger. Look for the Test button in Power Automate either Manually
or Automatically
depending on the availability of recent submissions.
If there are no recent submissions, head over to your Microsoft Form and submit the request and attached a contract. For example, you can load the following agreement to Microsoft Forms as an attachment.
After a successful test, confirm that the submission and attachment created an import file in DocJuris.
Power Automate test view:
DocJuris Dashboard:
DocJuris Triggers
- Turn Completed: triggers when a turn is marked complete.
- Turn Created: triggers when a turn is created
- Turn Tagged: triggers when a turn is tagged (e.g., execution copy)
DocJuris Actions
- Analyze New Contract: creates a contract in DocJuris and analyzes it
- Import Contract: stages the contract for creation and analysis and allows a user to complete the contract analysis process in the DocJuris app
- Get Turn: get information about a contract turn in DocJuris such as counterparty name or contract type
- Get Turn Document: get the document for use in other apps and services
Known issues and limitations
DocJuris for Power Automate is not a replacement for customized integrations with other platforms. In some cases, DocJuris' triggers and actions are not a complete implementation of every endpoint in the DocJuris API. Please get in touch at www.docjuris.com to start a conversation about a deeper integration that you might need.
Common errors and remedies
If you encounter any unexpected errors or issues, please contact us at [email protected]!
FAQ
How do you retrieve a document after a contract is analyzed?
Use an action to get turn details.
What's the difference between a staged import and analyze a contract?
Staged imports allow users to engage the analysis window in DocJuris to pick playbooks and complete any missing meta data. This is a good option if the triggering app or service does not have enough information to perform an analysis. Good attributes to trigger a full analysis vs. a staged import include: playbook, contract type, description, and counterparty. In all instances, an attachment is required.
What's a tagged turn?
Tags to a turn refer to attributes set in DocJuris such as "execution copy." These tags can be set in DocJuris when working with a turn in the analyzer.
What are the extended data fields when I load a DocJuris action?
Contracts and turns can be created with extended data. This data will be attached to the contract record, and can be retrieved with later queries. It can be used to store reference data relevant to the caller, or to pass reference urls to DocJuris.
Creating a connection
The connector supports the following authentication types:
Default | Parameters for creating connection. | All regions | Not shareable |
Default
Applicable: All regions
Parameters for creating connection.
This is not shareable connection. If the power app is shared with another user, another user will be prompted to create new connection explicitly.
Name | Type | Description | Required |
---|---|---|---|
organizationId | securestring | The organizationId for this api | True |
apiKey | securestring | The apiKey for this api | True |
Throttling Limits
Name | Calls | Renewal Period |
---|---|---|
API calls per connection | 100 | 60 seconds |
Actions
Create a contract |
Create a contract document |
Create an import file |
Import files can be used to create contracts or contract turns within the DocJuris app. |
Create turn |
Create contract turn. |
Delete a callback subscription |
Deletes a subscription |
Download latest turn document |
For "completedWithMarkup" and "completedClean" the return document corresponds to the latest turn. For "original" the return document belongs to the first turn. |
Download latest turn document description |
Get information about a turn document, such as file name and extension. |
Download turn document |
Get contract turn documents. |
Download turn document description |
Get information about a turn document, such as file name and extension. |
Get a contract |
Get details for a contract. |
Get contract types |
Get available contract types. |
Get playbooks |
Get available playbooks. |
Get test callback messages |
Get test messages. |
Get turn details |
Get contract turn details. |
Create a contract
Create a contract document
Parameters
Name | Key | Required | Type | Description |
---|---|---|---|---|
Name
|
name | string | ||
Contract Type
|
contractTypeId | integer |
One of contractType or contractTypeId must be supplied |
|
Playbook
|
playbookId | integer |
Playbook for contract |
|
Counterparty
|
counterPartyName | string |
One of counterPartyName or counterPartyId must be supplied |
|
name
|
name | string |
Name of an extra piece of data that will follow the contract |
|
value
|
value | string |
Value for that extra piece of data |
|
type
|
type | string |
Type for that extra piece of data |
|
Contract file
|
file | byte | ||
Contract file name
|
fileName | string | ||
Owning User's Email Address
|
owningUserEmail | string |
Returns
Create an import file
Import files can be used to create contracts or contract turns within the DocJuris app.
Parameters
Name | Key | Required | Type | Description |
---|---|---|---|---|
name
|
name | string |
Name of an extra piece of data that will follow the contract |
|
value
|
value | string |
Value for that extra piece of data |
|
type
|
type | string |
Type for that extra piece of data |
|
Import file
|
file | byte | ||
Import file name
|
fileName | string |
Returns
Create turn
Create contract turn.
Parameters
Name | Key | Required | Type | Description |
---|---|---|---|---|
Contract Id
|
contractId | True | uuid |
Available in trigger data. |
source
|
source | string |
A string that describes who this turn is from (i.e. internal dept., outside counsel, etc.). If this turn is from the counterparty leave this blank. |
|
description
|
description | string | ||
currentTurnId
|
currentTurnId | uuid |
A string ID of the latest known turn. The API will return an error if this does not match the latest turn's ID (i.e. if another turn was uploaded by another user). |
|
name
|
name | string |
Name of an extra piece of data that will follow the contract |
|
value
|
value | string |
Value for that extra piece of data |
|
type
|
type | string |
Type for that extra piece of data |
|
Contract file
|
file | byte | ||
Contract file name
|
fileName | string |
Returns
Delete a callback subscription
Deletes a subscription
Parameters
Name | Key | Required | Type | Description |
---|---|---|---|---|
Subscription Id
|
id | True | string |
Id of subscription to delete |
Returns
- Body
- ApiStandardResponse
Download latest turn document
For "completedWithMarkup" and "completedClean" the return document corresponds to the latest turn. For "original" the return document belongs to the first turn.
Parameters
Name | Key | Required | Type | Description |
---|---|---|---|---|
Contract Id
|
contractId | True | uuid |
Available in trigger data. |
Document State
|
docState | string |
State of document to download |
Returns
- response
- binary
Download latest turn document description
Get information about a turn document, such as file name and extension.
Parameters
Name | Key | Required | Type | Description |
---|---|---|---|---|
Contract Id
|
contractId | True | uuid |
Available in trigger data. |
Document State
|
docState | string |
State of document to describe |
Returns
Download turn document
Get contract turn documents.
Parameters
Name | Key | Required | Type | Description |
---|---|---|---|---|
Contract ID
|
contractId | True | uuid |
Available in trigger data. |
Turn ID
|
turnId | True | uuid |
Available in trigger data. |
Document type
|
docState | string |
Stage of document to download |
Returns
- Turn Document
- binary
Download turn document description
Get information about a turn document, such as file name and extension.
Parameters
Name | Key | Required | Type | Description |
---|---|---|---|---|
Contract ID
|
contractId | True | uuid |
Available in trigger data. |
Turn ID
|
turnId | True | uuid |
Available in trigger data. |
Document type
|
docState | string |
Stage of document to describe |
Returns
Get a contract
Get details for a contract.
Parameters
Name | Key | Required | Type | Description |
---|---|---|---|---|
Contract Id
|
contractId | True | uuid |
Available in trigger data. |
Returns
Get contract types
Get available contract types.
Parameters
Name | Key | Required | Type | Description |
---|---|---|---|---|
Skip
|
skip | integer |
Skip N types. Default 0. |
|
Take
|
take | integer |
Take N types. Default 200. |
|
Sort Field
|
sortBy | string |
Sort field. |
|
Filter
|
filter | string |
Filter to names including given string. |
Returns
Get playbooks
Get available playbooks.
Parameters
Name | Key | Required | Type | Description |
---|---|---|---|---|
Skip
|
skip | integer |
Skip N types. Default 0. |
|
Take
|
take | integer |
Take N types. Default 200. |
|
Sort Field
|
sortBy | string |
Sort field. |
|
Filter
|
filter | string |
Filter to names including given string. |
Returns
Get test callback messages
Get test messages.
Parameters
Name | Key | Required | Type | Description |
---|---|---|---|---|
Message Type
|
type | string |
Message Type |
Returns
Get turn details
Get contract turn details.
Parameters
Name | Key | Required | Type | Description |
---|---|---|---|---|
Contract ID
|
contractId | True | uuid |
Available in trigger data. |
Turn ID
|
turnId | True | uuid |
Available in trigger data. |
Returns
Triggers
Mention in Turn |
Mention in Turn |
Screening Report Updated |
Screening Report Updated |
Turn Completed |
Turn Completed |
Turn Created |
Turn Created |
Turn Tagged |
Turn Tagged |
Mention in Turn
Screening Report Updated
Turn Completed
Turn Created
Turn Tagged
Definitions
ApiStandardResponse
Name | Path | Type | Description |
---|---|---|---|
meta
|
meta | ApiStandardResponseMeta |
ApiStandardResponseMeta
Contract
Name | Path | Type | Description |
---|---|---|---|
Description
|
description | string | |
Id
|
id | uuid | |
Latest Turn Id
|
latestTurnId | uuid | |
Last Modified Date
|
lastModified | date-time | |
Name
|
name | string | |
ID
|
type.id | integer | |
Name
|
type.name | string | |
Description
|
type.description | string | |
Counterparty
|
counterParty | CounterParty | |
extendedData
|
extendedData | ExtendedData | |
Url
|
urls | Urls |
ContractApiStandardResponse
Name | Path | Type | Description |
---|---|---|---|
meta
|
meta | ApiStandardResponseMeta | |
Contract
|
response | Contract |
ContractType
Name | Path | Type | Description |
---|---|---|---|
ID
|
id | integer | |
Name
|
name | string | |
Description
|
description | string |
ContractTypeList
Name | Path | Type | Description |
---|---|---|---|
totalCount
|
totalCount | integer | |
skip
|
skip | integer | |
take
|
take | integer | |
filter
|
filter | string | |
sortBy
|
sortBy | string | |
contractTypes
|
contractTypes | array of ContractType |
ContractTypeListApiStandardResponse
Name | Path | Type | Description |
---|---|---|---|
meta
|
meta | ApiStandardResponseMeta | |
response
|
response | ContractTypeList |
CounterParty
Name | Path | Type | Description |
---|---|---|---|
ID
|
id | integer | |
Name
|
name | string |
DocumentMeta
Name | Path | Type | Description |
---|---|---|---|
Full Name (with extension)
|
name | string | |
Extension
|
extension | string | |
Original Name
|
originalFileName | string |
DocumentMetaApiStandardResponse
Name | Path | Type | Description |
---|---|---|---|
meta
|
meta | ApiStandardResponseMeta | |
Document File
|
response | DocumentMeta |
ExtendedData
Name | Path | Type | Description |
---|---|---|---|
Extended data
|
namedValues | array of ExtendedDataNamedData |
Optional user-specific data to attach to the the contract. |
ExtendedDataNamedData
Name | Path | Type | Description |
---|---|---|---|
name
|
name | string |
Name of an extra piece of data that will follow the contract |
value
|
value | string |
Value for that extra piece of data |
type
|
type | string |
Type for that extra piece of data |
ObjectIEnumerableApiStandardResponse
Name | Path | Type | Description |
---|---|---|---|
meta
|
meta | ApiStandardResponseMeta | |
response
|
response | array of |
Playbook
Name | Path | Type | Description |
---|---|---|---|
ID
|
id | integer | |
Title
|
name | string | |
Contract Type
|
contractType | ContractType |
PlaybookListApiStandardResponse
Name | Path | Type | Description |
---|---|---|---|
meta
|
meta | ApiStandardResponseMeta | |
response
|
response | PlaybookList |
PlaybookList
Name | Path | Type | Description |
---|---|---|---|
totalCount
|
totalCount | integer | |
skip
|
skip | integer | |
take
|
take | integer | |
filter
|
filter | string | |
sortBy
|
sortBy | string | |
playbooks
|
playbooks | array of Playbook |
StagedImport
Name | Path | Type | Description |
---|---|---|---|
id
|
id | uuid | |
extendedData
|
extendedData | ExtendedData | |
Url
|
urls | Urls |
StagedImportApiStandardResponse
Name | Path | Type | Description |
---|---|---|---|
meta
|
meta | ApiStandardResponseMeta | |
response
|
response | StagedImport |
TurnSubscriptionMessage
Name | Path | Type | Description |
---|---|---|---|
Message ID
|
messageId | string |
id |
Turn ID
|
turnId | string |
id |
Contract ID
|
contractId | string |
contractId |
Event type
|
type | string |
type |
URL to DocJuris
|
url | string |
url |
Tags
|
tags | array of object | |
ID
|
tags.id | string |
id |
Name
|
tags.name | string |
name |
Description
|
tags.description | string |
description |
TurnMentionSubscriptionMessage
Name | Path | Type | Description |
---|---|---|---|
Message ID
|
messageId | string |
id |
Turn ID
|
turnId | string |
id |
Contract ID
|
contractId | string |
contractId |
Event type
|
type | string |
type |
URL to DocJuris
|
url | string |
url |
Tags
|
tags | array of object | |
ID
|
tags.id | string |
id |
Name
|
tags.name | string |
name |
Description
|
tags.description | string |
description |
Text
|
mention.text | string |
text |
First Name
|
mention.mentioningUser.firstName | string |
firstName |
Last Name
|
mention.mentioningUser.lastName | string |
lastName |
Username
|
mention.mentioningUser.userName | string |
userName |
First Name
|
mention.mentionedUser.firstName | string |
firstName |
Last Name
|
mention.mentionedUser.lastName | string |
lastName |
Username
|
mention.mentionedUser.userName | string |
userName |
Commend ID
|
mention.commentId | string |
commentId |
Link to comment in DocJuris
|
mention.url | string |
url |
Turn
Name | Path | Type | Description |
---|---|---|---|
Turn ID
|
id | uuid | |
Is Turn Complete?
|
isComplete | boolean | |
Is Turn Latest?
|
isLatest | boolean | |
Last Modified Date/Time
|
lastModified | date-time | |
Source
|
source | string | |
Original File Name
|
importedFileName | string | |
Description
|
description | string | |
Contract Type
|
type | ContractType | |
Counterparty
|
counterParty | CounterParty | |
extendedData
|
extendedData | ExtendedData | |
Url
|
urls | Urls | |
tags
|
tags | array of TurnTag |
TurnApiStandardResponse
Name | Path | Type | Description |
---|---|---|---|
meta
|
meta | ApiStandardResponseMeta | |
response
|
response | Turn |
TurnTag
Name | Path | Type | Description |
---|---|---|---|
id
|
id | uuid | |
name
|
name | string | |
description
|
description | string |
Urls
Name | Path | Type | Description |
---|---|---|---|
to DocJuris
|
app | string |
binary
This is the basic data type 'binary'.