# Integra com D4Sign

> Você conecta a D4Sign em Configurações, na área Integrações, com o Token API e a CryptKey da sua conta e o ambiente, Sandbox (teste) ou Produção. Depois, o gestor de contratos envia o contrato para assinatura, a D4Sign recebe o PDF e os signatários, e a IDX atualiza o contrato quando você clica em Sincronizar assinaturas e o documento já está finalizado ou cancelado.

Publicado em 30 de outubro de 2026. Endereço: https://idxbr.com/blog/integracao-d4sign

## Pontos principais

- A conexão pede Token API, CryptKey e o ambiente, Sandbox (teste) ou Produção, e a IDX confere as credenciais antes de salvar
- O cofre é onde a D4Sign guarda os documentos enviados pela IDX; ao conectar, a IDX grava o primeiro cofre da conta
- No envio, a IDX gera o PDF, sobe no cofre e cadastra como signatária toda parte e todo signatário com e-mail
- O contrato só muda para Assinado ou Cancelado quando você clica em Sincronizar assinaturas
- A D4Sign só serve aos Contratos, que fazem parte do plano Avançado

## O que a integração com a D4Sign faz na IDX

A integração com a D4Sign leva o contrato montado na IDX para assinatura eletrônica, sem baixar e subir arquivo à mão. Você monta o contrato, envia, e a D4Sign recebe o documento e a lista de quem assina.

A tela da integração lista três recursos, com estes nomes:

- **Envio para assinatura**: encaminhar contratos pelo fluxo de assinatura integrado à IDX
- **Acompanhamento dos documentos**: consultar o andamento das assinaturas na IDX
- **Cofre configurado**: escolher o cofre da D4Sign usado pelos documentos

A D4Sign só é usada pelos Contratos. O passo a passo completo da negociação, da proposta à revisão do contrato, está em [da proposta ao contrato assinado](/blog/da-proposta-ao-contrato). A lista de todas as integrações está no [guia das integrações da IDX](/blog/integracoes-da-idx).

## O que você precisa ter antes de conectar

Você precisa de uma conta na D4Sign e de uma permissão na IDX. A IDX não cria a conta D4Sign para você.

- Uma conta D4Sign da sua empresa
- O **Token API** e a **CryptKey** dessa conta, que a tela da IDX pede para copiar do painel da D4Sign
- Ao menos um cofre na conta. Sem cofre, o envio do contrato para com "Nenhum cofre encontrado na sua conta D4Sign."
- Na IDX, um cargo com permissão de editar configurações. Sem ela, a tela da D4Sign mostra "Você não tem permissão para gerenciar integrações. Peça a quem administra a conta para liberar a edição de configurações no seu cargo."
- O plano Avançado, que libera os Contratos

## Os campos da conexão, um por um

O diálogo **Conectar D4Sign** tem um bloco **Credenciais**, com três campos. A descrição do bloco diz: "No painel da D4Sign, copie o Token API e a CryptKey e cole aqui. A IDX confere as duas antes de salvar."

| Campo         | Obrigatório | Como funciona                                                        |
| ------------- | ----------- | -------------------------------------------------------------------- |
| **Token API** | Sim         | Copiado do painel da D4Sign. Fica mascarado enquanto você digita     |
| **CryptKey**  | Sim         | Copiada do painel da D4Sign. Também fica mascarada                   |
| **Ambiente**  | Sim         | **Sandbox (teste)** ou **Produção**. Vem marcado **Sandbox (teste)** |

Espaços antes e depois do token e da chave são removidos ao salvar. Se um dos dois estiver vazio, aparece "Informe o Token API e a CryptKey." e nada é enviado.

Para conferir as credenciais, a IDX pede à D4Sign, no ambiente escolhido, a lista de cofres da conta. Se o pedido falhar, aparece "Credenciais inválidas. Verifique o Token API e CryptKey." e nada é gravado.

## Como conectar a D4Sign à IDX

Você conecta a D4Sign na área de Integrações das Configurações. Quando a integração falta, o botão **Conectar D4Sign** dentro de um contrato leva para a mesma tela.

1. Abra **Configurações** e vá em **Integrações**.
2. Abra o cartão da **D4Sign**.
3. Clique em **Conectar**.
4. Cole o **Token API** e a **CryptKey**.
5. Em **Ambiente**, escolha **Sandbox (teste)** ou **Produção**.
6. Clique em **Conectar** e espere a mensagem **D4Sign conectada**.

O diálogo fecha sozinho e o cartão passa a **Conectado**. No lugar de **Conectar**, aparece **Gerenciar integração**.

Ao conectar, a IDX grava como cofre o primeiro cofre da lista da conta. Para escolher outro, abra **Gerenciar integração**, como mostra a próxima seção.

> [!IMPORTANTE] A conta é da organização
> A D4Sign fica gravada no dono da organização, mesmo quando um membro com permissão faz a conexão. Todo contrato da organização sai por essa conta, seja quem for que envie.

## O que é o cofre e como escolher outro

O cofre é onde a D4Sign guarda os documentos que a IDX envia. A tela descreve o bloco **Cofre** assim: "Onde a D4Sign guarda os documentos enviados pela IDX."

1. No cartão da D4Sign, clique em **Gerenciar integração**.
2. No bloco **Cofre**, abra a lista. Enquanto a IDX consulta a D4Sign, ela mostra "Carregando cofres".
3. Escolha o cofre e espere a mensagem **Cofre atualizado**.

As regras do cofre:

- A lista mostra os cofres que o Token API e a CryptKey salvos enxergam, lidos na hora da D4Sign
- Ao salvar, a IDX confere de novo se o cofre está na lista da conta. Se não estiver, aparece "Cofre não encontrado nesta conta D4Sign"
- Se a D4Sign não responder, aparece "Não foi possível confirmar o cofre na D4Sign", e o cofre anterior continua valendo
- Se a lista não carregar, o bloco mostra o erro no lugar da lista
- Sem cofre gravado, o envio usa o primeiro cofre da conta naquele momento
- Trocar o cofre vale para os próximos envios. O contrato já enviado guarda o cofre em que entrou

Abaixo da lista, o bloco mostra o ambiente atual: **Ambiente: Produção** ou **Ambiente: Sandbox (teste)**.

## Como trocar as credenciais ou o ambiente

Você troca as credenciais em **Gerenciar integração**, no bloco **Credenciais**. Depois de salvos, o token e a chave não aparecem mais: o bloco diz "Token API e CryptKey configurados. Não são exibidos."

1. Clique em **Gerenciar integração**.
2. Clique em **Substituir credenciais**.
3. Cole o novo **Token API** e a nova **CryptKey** e escolha o **Ambiente**.
4. Clique em **Salvar credenciais** e espere **Credenciais substituídas**.

Você sempre manda as duas credenciais juntas, e a IDX confere de novo antes de gravar. Para desistir, clique em **Cancelar** dentro do bloco. Trocar de Sandbox para Produção é este mesmo caminho.

Substituir as credenciais não muda o cofre gravado. Depois de trocar de conta ou de ambiente, abra o bloco **Cofre** e escolha o cofre de novo.

## Como o contrato vai para a D4Sign

O contrato vai para a D4Sign quando o gestor de contratos envia. Gestor é quem tem a permissão de gerir contratos no cargo, o nível **Acesso completo**.

O caminho depende de quem termina o contrato:

- **O gestor** termina o editor em **Finalizar e enviar para assinatura**. O contrato vai direto para a D4Sign
- **Quem não é gestor** termina em **Enviar para aprovação**. O contrato fica **Aguardando aprovação**
- **O gestor aprova** em **Aprovar**. O contrato passa a **Aguardando envio**, ainda sem nada na D4Sign. Depois, ele clica em **Enviar para assinatura** e confirma em **Enviar para assinatura?**
- **O gestor recusa** em **Recusar**, com o motivo. O contrato volta a rascunho e nada vai para a D4Sign

A aprovação interna não fala com a D4Sign: o gestor aprova mesmo sem a integração conectada. Nesse caso, o botão **Enviar para assinatura** aparece desligado e o cartão diz "O contrato foi aprovado. Conecte a D4Sign para enviar aos signatários." Quem pode configurar ganha o botão **Conectar D4Sign**. Quem não pode lê "Peça ao administrador da sua conta para conectar a D4Sign."

No editor, sem a D4Sign, o botão **Finalizar e enviar para assinatura** fica desligado, e a revisão mostra o aviso **Integração necessária**.

### O que a IDX faz no envio

Ao enviar, a IDX faz cinco coisas, nesta ordem:

1. Gera o PDF do contrato no seu navegador, com cabeçalho, texto, rodapé e margens do documento.
2. Sobe o PDF no cofre da D4Sign, com o título do contrato como nome do arquivo.
3. Cadastra na D4Sign toda pessoa do contrato que tem e-mail.
4. Pede à D4Sign o envio aos signatários, com a mensagem "Por favor, assine este contrato.".
5. Muda o contrato para **Aguardando assinaturas** e cada pessoa para **Pendente**.

A confirmação do envio diz que "cada signatário recebe o link para assinar por e-mail". Depois do envio, o contrato não pode mais ser editado, e a lista de quem assina trava: "Os signatários não mudam depois que o documento foi enviado para assinatura." Um contrato tem um documento só na D4Sign. Tentar enviar de novo dá "Este contrato já possui um documento no D4Sign".

### Mensagens de erro no envio

| Mensagem                                                     | O que fazer                                       |
| ------------------------------------------------------------ | ------------------------------------------------- |
| "D4Sign não configurado. Configure a integração primeiro."   | Conectar a D4Sign em Integrações                  |
| "Nenhum cofre encontrado na sua conta D4Sign."               | Criar um cofre na conta D4Sign                    |
| "Nenhuma parte do contrato possui email cadastrado."         | Informar o e-mail de ao menos uma pessoa          |
| "Aprove o contrato antes de enviar para assinatura."         | O contrato está em aprovação; o gestor decide     |
| "Só o gestor de contratos envia para assinatura."            | Pedir ao gestor ou usar **Enviar para aprovação** |
| "Não foi possível gerar o PDF do contrato. Tente novamente." | Tentar de novo; o PDF é gerado no seu navegador   |

Quando o envio falha no editor, a IDX completa a mensagem com "O contrato foi salvo e continua em rascunho."

## Quem assina: partes e signatários

Recebe o documento pela D4Sign toda pessoa do contrato que tem e-mail. A etapa **Assinatura** do editor separa essas pessoas em duas listas.

| Lista                  | Quem entra            | Como entra                                                                     |
| ---------------------- | --------------------- | ------------------------------------------------------------------------------ |
| **Partes que assinam** | Proponente e Cônjuge  | Pela etapa **Partes**. "Toda parte com e-mail recebe o contrato para assinar." |
| **Signatários**        | Testemunha e Vendedor | Por **Adicionar signatário**, com **Papel**, **Nome completo** e **E-mail**    |

As regras de quem assina:

- Parte sem e-mail fica fora do envio e aparece com **Sem e-mail**. O botão **Adicionar e-mail** completa o dado ali mesmo
- O signatário precisa de nome e e-mail. Sem e-mail, aparece "Informe o e-mail que vai receber o documento."
- O contrato só segue para envio com o e-mail de ao menos uma pessoa: a revisão avisa "Informe o e-mail de ao menos uma pessoa que vai assinar."
- Intermediadores não são cadastrados na D4Sign
- Você muda partes e signatários até o envio, inclusive com o contrato em aprovação ou aprovado. Nessas duas situações, da parte só muda o e-mail

Antes do envio, cada pessoa aparece como **Aguardando envio**.

### Como a IDX cadastra cada signatário

A tela não tem opção de ordem, de forma de autenticação nem de tipo de assinatura. A IDX cadastra todas as pessoas do mesmo jeito:

- Com a ação de assinar, inclusive testemunhas e vendedores
- Com autenticação por e-mail
- Sem certificado ICP-Brasil, sem assinatura presencial e sem pedir documento ou selfie

## Como acompanhar as assinaturas

O andamento das assinaturas só muda na IDX quando você clica em **Sincronizar assinaturas**, no cartão de situação do contrato. A dica do botão diz "Consulta a D4Sign e atualiza o status dos signatários."

Cada sincronização pergunta à D4Sign a situação do documento inteiro, e não de cada pessoa:

| Situação na D4Sign | O que muda na IDX                                                          |
| ------------------ | -------------------------------------------------------------------------- |
| Finalizado         | O contrato passa a **Assinado** e cada pessoa com e-mail, a **Assinou em** |
| Cancelado          | O contrato passa a **Cancelado**                                           |
| Qualquer outra     | Nada muda. A IDX confirma **Assinaturas sincronizadas**                    |

Por isso, enquanto falta alguém, a contagem fica parada, mesmo que outras pessoas já tenham assinado. O cartão mostra, por exemplo, "O contrato foi enviado para assinatura digital. Nenhum dos 3 signatários assinou ainda." até o documento ficar finalizado.

A data em **Assinou em** e a data de conclusão do contrato são as do momento em que a sincronização encontrou o documento finalizado. Sincronize logo depois que todos assinarem para as datas ficarem próximas da assinatura.

### Como pegar o documento assinado

Com o contrato **Assinado**, o cartão mostra **Contrato assinado** e o botão **Baixar contrato assinado**. Ele pede à D4Sign o link do arquivo assinado.

A aba **Documento** tem outro botão, **Baixar PDF sem assinaturas**: é o texto do contrato gerado pela IDX, sem as assinaturas. O documento assinado fica na D4Sign.

## Como reenviar o e-mail ou cancelar a assinatura

Enquanto o contrato aguarda assinaturas, você tem duas ações na aba **Signatários**.

- **Reenviar e-mail**: aparece ao lado de cada pessoa **Pendente** e pede à D4Sign o reenvio para aquele e-mail. A IDX confirma com "E-mail de assinatura reenviado para" e o nome
- **Cancelar assinatura**: abre **Cancelar a assinatura?**, com "O documento é cancelado na D4Sign e o contrato volta a rascunho, para ser ajustado e enviado de novo." Confirme em **Cancelar assinatura**

Ao cancelar pela IDX, o contrato volta a rascunho, e a IDX apaga do contrato e de cada pessoa os dados da D4Sign. Você ajusta e envia de novo, e a IDX sobe um documento novo.

Se o documento for cancelado direto na D4Sign, a próxima sincronização muda o contrato para **Cancelado**, com o título **Assinatura cancelada**. Esse contrato não volta a rascunho e não mostra botão de envio.

> [!ATENCAO]
> **Excluir contrato** apaga o contrato só na IDX. O diálogo avisa: "O documento enviado para a D4Sign não é cancelado por esta ação." Para parar a assinatura, use **Cancelar assinatura** antes de excluir.

## O que o status da integração quer dizer

O cartão da D4Sign em Integrações mostra se a IDX tem credenciais salvas. Ele não consulta a D4Sign para isso.

| Status                  | O que significa                        |
| ----------------------- | -------------------------------------- |
| **Conectado**           | O Token API e a CryptKey estão salvos  |
| **Desconectado**        | Não há D4Sign salva para a organização |
| **Status indisponível** | A IDX não conseguiu ler o estado agora |

Como o status vem só do que está salvo, uma credencial que deixou de valer só aparece como erro ao enviar, sincronizar ou trocar o cofre. Nesse caso, use **Substituir credenciais**.

Dentro do contrato, a etapa **Assinatura** mostra **D4Sign conectada**, com **Ambiente de produção** ou **Ambiente de testes (sandbox)**. Quem pode configurar vê ali **Gerenciar integração**.

## Como desconectar e o que acontece com os contratos em andamento

Você desconecta em **Gerenciar integração**.

1. Clique em **Gerenciar integração**.
2. Clique em **Desconectar**.
3. Em **Desconectar a D4Sign?**, clique em **Desconectar** de novo.
4. Espere a mensagem **D4Sign desconectada**.

O diálogo avisa: "As credenciais saem da IDX e novos contratos não podem mais ser enviados pela D4Sign. Os documentos já enviados continuam na sua conta D4Sign, e os contratos da IDX não são apagados."

O que acontece com os contratos que estavam aguardando assinaturas:

- Continuam em **Aguardando assinaturas** na IDX
- Desconectar não cancela o documento na D4Sign
- **Sincronizar assinaturas**, **Reenviar e-mail**, **Cancelar assinatura** e **Baixar contrato assinado** passam a responder "D4Sign não configurado"

## Qual plano libera a D4Sign

A D4Sign faz parte do plano Avançado, porque só serve aos Contratos. A mensagem da IDX é "Os Contratos fazem parte do plano Avançado."

- **Essencial e Profissional**: o cartão da D4Sign aparece em Integrações, mas **Conectar** vem com a coroa e abre os planos
- **Avançado**: conecta, escolhe o cofre e envia contratos
- **Quem perde o Avançado com a D4Sign conectada**: continua vendo **Gerenciar integração**. **Trocar cofre**, **Substituir credenciais** e **Reenviar e-mail** ficam travados. **Desconectar**, **Cancelar assinatura**, **Sincronizar assinaturas** e **Baixar contrato assinado** continuam livres

Veja os detalhes de cada [plano](/planos). Para ver a negociação por inteiro, conheça os [Contratos da IDX](/contratos).

## Como a D4Sign se conecta com o resto da IDX

A D4Sign entra no fim da negociação e deixa rastro em poucos módulos. Veja cada ligação:

- **Contratos**: é o único módulo que usa a D4Sign. Envio, sincronização, reenvio, cancelamento e via assinada ficam no detalhe do contrato
- **Propostas**: a proposta não passa pela D4Sign. Só o contrato vai para assinatura
- **CRM**: quando o contrato tem lead e a sincronização encontra o documento finalizado, o histórico do lead ganha **Contrato assinado**, com a D4Sign como autora e a lista de quem assinou
- **Início**: **Contratos assinados no período** conta os contratos assinados pela data de conclusão gravada na sincronização, e **Valor total contratado** soma o valor deles. **VGV vendido** e **Vendas realizadas** também contam contratos assinados
- **Membros e permissões**: conectar, trocar o cofre e desconectar pedem permissões de configurações. Enviar para assinatura pede o nível de gestor de contratos. Sincronizar, reenviar e cancelar pedem a permissão de editar contratos. Baixar a via assinada pede a de ver

O que não se conecta:

- **Imóveis**: a sincronização não muda a situação do imóvel nem da unidade
- **Notificações**: a assinatura concluída ou cancelada não gera aviso no sino
- **WhatsApp**: a IDX não envia o link de assinatura pelo WhatsApp conectado
- **Automações, roleta e agente de IA**: nenhum deles envia contrato nem reage à assinatura

Para o caminho inteiro da negociação, leia [da proposta ao contrato assinado](/blog/da-proposta-ao-contrato).

## Perguntas frequentes

### Preciso ter uma conta na D4Sign?

Sim. A IDX não fornece conta D4Sign. Ela usa a conta da sua empresa, conectada com o Token API e a CryptKey em Configurações, Integrações.

### Por que o contrato continua aguardando assinaturas se o cliente já assinou?

A IDX só muda o contrato quando você clica em Sincronizar assinaturas, e só quando a D4Sign informa o documento como finalizado, ou seja, depois que todos assinaram. Antes disso, cada pessoa aparece como Pendente.

### Posso testar antes de enviar contratos de verdade?

Pode. Ao conectar, escolha o ambiente Sandbox (teste). O contrato mostra Ambiente de testes (sandbox). Para trocar, use Substituir credenciais e escolha Produção.

### Se eu desconectar a D4Sign, os contratos enviados são cancelados?

Não. Desconectar não cancela nada na D4Sign e não apaga os contratos da IDX. Mas, sem a integração, a IDX não sincroniza, não reenvia, não cancela e não baixa a via assinada desses contratos.

### A testemunha precisa ser uma parte do contrato?

Não. Testemunhas e vendedores entram como signatários, na etapa Assinatura do contrato, com nome e e-mail. Eles recebem o documento pela D4Sign, mas não entram como partes da negociação.