> ## Documentation Index
> Fetch the complete documentation index at: https://docs.nekt.com/llms.txt
> Use this file to discover all available pages before exploring further.

# D4Sign as a data source

> Bring electronic signature data from D4Sign to Nekt.

D4Sign is a Brazilian electronic signature platform that provides legal validity to documents, complying with Brazilian regulations. It allows users to send, sign, and manage documents securely online.

<img height="30" src="https://mintcdn.com/nekt/DTxAi5jDvlieNuXQ/assets/logo/logo-d4sign.png?fit=max&auto=format&n=DTxAi5jDvlieNuXQ&q=85&s=47d21bc4b25770333a1085b773730444" data-path="assets/logo/logo-d4sign.png" />

## Configuring D4Sign as a Source

In the [Sources](https://app.nekt.ai/sources) tab, click on the "Add source" button located on the top right of your screen. Then, select the D4Sign option from the list of connectors.

Click **Next** and you'll be prompted to add your access.

### 1. Add account access

You will need your D4Sign **Token API** and **Crypt Key** (if enabled on your account). To find your keys, log in to your D4Sign account and navigate to the 'Dev API' menu.

The following configurations are available:

* **Token API**: Your D4Sign API Key.
* **Crypt Key**: Your D4Sign Crypt Key. This is only required if it is enabled in your account settings.

<Warning>
  The D4Sign API has a default limit of **10 requests per hour**, which is not enough for most use cases. To increase this limit, you need to contact D4Sign support directly to request a higher limit.
</Warning>

Once you're done, click **Next**.

### 2. Select streams

Choose which data streams you want to sync - you can select all streams or pick specific ones that matter most to you.

> Tip: The stream can be found more easily by typing its name.

Select the streams and click **Next**.

### 3. Configure data streams

Customize how you want your data to appear in your catalog. Select a name for each table (which will contain the fetched data) and the type of sync.

* **Table name**: we suggest a name, but feel free to customize it. You have the option to add a **prefix** and make this process faster!
* **Sync Type**: you can choose between INCREMENTAL and FULL\_TABLE.
  * Incremental: every time the extraction happens, we'll get only the new data - which is good if, for example, you want to keep every record ever fetched.
  * Full table: every time the extraction happens, we'll get the current state of the data - which is good if, for example, you don't want to have deleted data in your catalog.

Once you are done configuring, click **Next**.

### 4. Configure data source

Describe your data source for easy identification within your organization, not exceeding 140 characters.

To define your [Trigger](https://docs.nekt.com/runs/scheduling-and-triggers), consider how often you want data to be extracted from this source. This decision usually depends on how frequently you need the new table data updated (every day, once a week, or only at specific times).

Optionally, you can determine when to execute a [full sync](https://docs.nekt.com/get-started/core-concepts/types-of-sync#additional-full-sync). This will complement the incremental data extractions, ensuring that your data is completely synchronized with your source every once in a while.

Once you are ready, click **Next** to finalize the setup.

### 5. Check your new source

You can view your new source on the [Sources](https://app.nekt.ai/sources) page. If needed, manually trigger the source extraction by clicking on the arrow button. Once executed, your data will appear in your Catalog.

<Warning>For you to be able to see it on your [Catalog](https://app.nekt.ai/catalog), you need at least one successful source run.</Warning>

# Streams and Fields

Below you'll find all available data streams from D4Sign and their corresponding fields:

<AccordionGroup>
  <Accordion title="Documents">
    Stream for managing documents.

    **Key Fields:**

    * `uuidDoc` - Unique identifier for the document.
    * `nameDoc` - Name of the document.
    * `type` - MIME type of the document.
    * `size` - Size of the document in bytes.
    * `pages` - Number of pages in the document.
    * `uuidSafe` - Unique identifier for the safe where the document is stored.
    * `safeName` - Name of the safe.
    * `statusId` - ID of the document's status.
    * `statusName` - Name of the status (e.g., "Aguardando assinaturas").
    * `statusComment` - Optional comment related to the status.
    * `whoCanceled` - Indicates who canceled the document, if applicable.
  </Accordion>

  <Accordion title="Document Signers">
    Stream for retrieving the list of signers for a document. This is a child stream of `Documents`.

    **Key Fields:**

    * `uuidDoc` - Unique identifier for the document.
    * `nameDoc` - Name of the document.
    * `type` - MIME type of the document.
    * `size` - Size of the document in bytes.
    * `pages` - Number of pages in the document.
    * `uuidSafe` - Unique identifier for the safe where the document is stored.
    * `safeName` - Name of the safe.
    * `statusId` - ID of the document's status.
    * `statusName` - Name of the status.
    * `statusComment` - Optional comment related to the status.
    * `whoCanceled` - Indicates who canceled the document, if applicable.
    * `list` - A JSON string containing a complete list of signers and their details.
  </Accordion>

  <Accordion title="Users">
    Stream for listing all users in the domain.

    **Key Fields:**

    * `nome` - Name of the user.
    * `email` - Email address of the user.
    * `status` - Status of the user (e.g., "1" for active).
    * `apenas_cofre_compartilhado` - Indicates if the user only has access to a shared safe ("0" for No, "1" for Yes).
  </Accordion>
</AccordionGroup>

## Skills for agents

<Snippet file="agent-skills-intro.mdx" />

<Card title="Download D4Sign skills file" icon="wand-magic-sparkles" href="/sources/d4sign.md">
  D4Sign connector documentation as plain markdown, for use in AI agent contexts.
</Card>
