API de Assinatura para Imobiliárias e Contratos de Locação

Fechar uma locação envolve coletar assinaturas de quatro partes distintas — locador, locatário, fiador e a própria imobiliária — muitas vezes em uma ordem específica, com prazos apertados e exigências de prova jurídica. Uma API de assinatura para imobiliárias transforma esse processo manual e cheio de idas e vindas em um fluxo automatizado, rastreável e integrado ao seu CRM, do envio do contrato à conclusão com pacote de evidências.

Neste guia, mostramos como modelar com a API SignDocs os documentos mais comuns do setor imobiliário — contrato de locação, fiança, distrato, compra e venda e proposta — com assinatura ordenada entre múltiplas partes, certificado ICP-Brasil para negócios de maior valor e trilha de auditoria com geolocalização. Tudo isso conectado ao sistema que sua imobiliária já usa para gerir imóveis e clientes.

Se você ainda está avaliando o que uma API de assinatura digital oferece em termos gerais, comece pelo nosso guia-pilar. Aqui o foco é prático: o caso de uso imobiliário, ponta a ponta.

Por que imobiliárias precisam de uma API, não apenas de um app de assinatura

Aplicativos de assinatura resolvem o caso pontual: enviar um PDF e coletar uma assinatura. Mas uma imobiliária com volume opera de forma diferente. Cada locação fechada gera um conjunto de documentos, envolve várias partes e precisa refletir mudanças em sistemas internos — disponibilidade do imóvel, cadastro do locatário, geração da primeira cobrança e arquivamento do contrato.

Quando esse trabalho é feito à mão, surgem os gargalos clássicos do setor: contratos parados esperando o fiador, versões erradas circulando por e-mail, e a equipe perdendo horas conferindo quem já assinou. Uma API resolve isso ao tornar a assinatura parte do seu software, e não uma etapa separada.

• Volume e repetição: dezenas ou centenas de locações por mês, todas com a mesma estrutura de partes e documentos.
• Múltiplos signatários ordenados: o fiador costuma assinar depois do locatário; a imobiliária assina por último, validando o que foi acordado.
• Integração com o sistema imobiliário: o status do imóvel e do contrato precisa atualizar sozinho quando todos assinam.
• Prova jurídica robusta: em caso de inadimplência ou despejo, a trilha de auditoria é o que sustenta o contrato.

Os documentos do ciclo imobiliário

A API trata cada documento como uma transação de assinatura com seu próprio conjunto de signatários e regras. Os principais no dia a dia de uma imobiliária:

Repare que o nível de prova escala com o valor do negócio. Para entender as diferenças formais entre assinatura simples, avançada e qualificada, e como elas se mapeiam na API, vale conferir a seção de métodos de autenticação em o que é uma API de assinatura digital.

O fluxo de uma locação com assinatura ordenada

O coração do caso imobiliário é a ordem de assinatura. Em uma locação, raramente faz sentido enviar o contrato para todos ao mesmo tempo: a imobiliária quer confirmar que o locatário aceitou antes de acionar o fiador, e ela mesma costuma assinar por último, fechando o ciclo.

Na API SignDocs, isso é configurado criando um envelope com signingMode: "SEQUENTIAL" e adicionando uma sessão de assinatura por parte, com a posição na fila dada pelo signerIndex. A ordem é imposta pela plataforma: cada parte só consegue concluir a assinatura depois que a anterior termina. Veja a sequência típica de uma locação residencial com fiador:

1. Locador (signerIndex 1): o proprietário assina primeiro, formalizando a oferta nas condições acordadas.
2. Locatário (signerIndex 2): assina em seguida, aceitando as cláusulas — antes disso, o fiador não consegue concluir.
3. Fiador (signerIndex 3): só consegue assinar após o locatário, vinculando-se à garantia.
4. Imobiliária (signerIndex 4): assina por último, na condição de administradora/intermediária, encerrando o envelope.

Quando o último assina, o envelope muda para COMPLETED, o evento ENVELOPE.ALL_SIGNED é emitido, o documento final é consolidado com o carimbo de cada assinatura sobre o mesmo hash SHA-256, e o pacote de evidências de cada assinatura fica disponível. O detalhamento dos dois modos — incluindo o paralelo e o encadeamento de envelopes para topologias mistas — está no nosso guia técnico sobre ordem de assinatura com múltiplos signatários.

Criando o envelope de locação

O exemplo abaixo cria o envelope do contrato com os quatro signatários em ordem. Note os metadata, que carregam referências do seu sistema (imóvel e contrato) para uso posterior nos webhooks:

A criação do envelope retorna o envelopeId e o documentHash; cada sessão devolve sua própria URL de assinatura — e, como o envelope tem um owner, a SignDocs envia o convite por e-mail a cada parte automaticamente. A partir daí, o acompanhamento acontece por eventos, não por consulta manual. Para a visão completa de estados e transições de uma transação, consulte o fluxo transacional da API.

Quando usar ICP-Brasil em negócios imobiliários

Nem toda assinatura precisa de certificado digital. Para locações residenciais, a assinatura eletrônica avançada — com autenticação por OTP via SMS, e-mail ou biometria facial — já entrega validade jurídica e prova consistente, com a vantagem de não exigir que o signatário possua certificado.

O certificado ICP-Brasil (padrão A1, em arquivo, ou A3, em token de hardware) entra em cena quando o valor ou o risco do negócio justifica o nível qualificado de assinatura — o mais alto reconhecido pela MP 2.200-2/2001. Cenários típicos:

• Compra e venda de imóvel: valores elevados e necessidade de máxima segurança jurídica.
• Locação comercial de grande porte: contratos longos com garantias reais ou cartas-fiança bancárias.
• Termos de fiança de alto valor: quando o fiador oferece imóvel como garantia.

Na API, isso é definido na política da sessão daquele signatário, usando o profile DIGITAL_CERTIFICATE. O comprador assina com seu certificado ICP-Brasil A1, enquanto os demais continuam com autenticação avançada — tudo no mesmo envelope:

Trilha de auditoria e prova jurídica para o contrato

Em uma disputa locatícia, o que sustenta o contrato não é apenas a imagem da assinatura, mas a trilha de auditoria que comprova quem assinou, quando, de onde e após qual autenticação. A SignDocs registra cada etapa do ciclo de vida e consolida tudo em um pacote de evidências.

Cada evento relevante — visualização do documento, conclusão da autenticação e aplicação da assinatura — é gravado com:

• Data e hora registradas com o carimbo de hora do servidor da SignDocs em cada etapa do ciclo, marcando o momento de cada ação na trilha de auditoria.
• Endereço IP de cada signatário em cada ação.
• Geolocalização, capturada por GPS quando disponível e por IP como fallback — obrigatória em todos os canais.
• Método de autenticação utilizado (OTP, biometria, certificado), evidenciando a identidade.
• Hash SHA-256 do documento, ligando a assinatura exatamente àquela versão do contrato.

Esse conjunto é empacotado em um arquivo .p7m (PKCS#7/CMS) append-only, que amarra o hash SHA-256 do documento, a identidade dos signatários e toda a trilha de eventos — pensado justamente para resistir como prova ao longo dos anos de uma locação. Quando há assinatura com certificado ICP-Brasil, a cadeia de certificados também é preservada no pacote. A anatomia desse pacote e por que ele se sustenta juridicamente estão detalhadas no nosso material sobre o pacote de evidências .p7m como prova jurídica.

Qualquer parte — locador, locatário, fiador ou um juízo — pode conferir a autenticidade do documento e da trilha no verificador público em verificador.signdocs.com.br, sem precisar de conta na SignDocs.

Integração com o CRM e o sistema de gestão imobiliária

O ganho real para a imobiliária aparece quando a API conversa com o sistema que a equipe já usa. A criação da transação dispara a partir do seu CRM — por exemplo, ao mover um negócio para a etapa "Fechamento" — e os webhooks mantêm tudo sincronizado sem ninguém precisar abrir o painel da SignDocs.

Cada evento da transação é entregue por HTTPS POST com assinatura HMAC-SHA256, idempotência e retentativas com backoff exponencial. Os eventos mais úteis no fluxo imobiliário:

Veja um receptor que reage à conclusão de uma locação, atualizando o sistema imobiliário usando o contrato_ref que viajou nos metadados das sessões:

Para implementar a verificação de assinatura, a deduplicação de eventos e a estratégia de retry corretamente, siga o nosso guia completo de webhooks e eventos da API de assinatura.

Embedded vs. e-mail: como o signatário assina

Você escolhe como a parte chega à assinatura. Dois modelos convivem bem no setor imobiliário:

• Convite por e-mail/SMS: ideal para fiadores e locadores que estão fora do balcão. Cada um recebe um link seguro no seu tempo, respeitando a ordem.
• Assinatura incorporada (embedded): quando o locatário está no balcão da imobiliária ou usando o app/portal do cliente, a assinatura abre dentro da própria tela, sem trocar de ambiente. A Assinatura Expressa resolve esse caso com uma única chamada que devolve o link hospedado e o clientSecret para o widget incorporado.

Autenticação dos signatários no contexto imobiliário

Cada parte de uma locação tem um perfil de risco diferente, e a API permite ajustar o método de autenticação por signatário, sem complicar a experiência de quem assina.

• CLICK_ONLY (aceite com evidências): registro de ciência com trilha completa, adequado para a própria imobiliária ou para propostas de baixo risco.
• CLICK_PLUS_OTP (aceite + código por SMS ou e-mail): o padrão recomendado para locador, locatário e fiador em locações residenciais — equilibra prova e simplicidade.
• BIOMETRIC / BIOMETRIC_PLUS_OTP (biometria facial com prova de vida): para reforçar a identidade em contratos sensíveis ou quando há histórico de contestação — com a variante BIOMETRIC_SERPRO comparando contra bases oficiais.
• DIGITAL_CERTIFICATE (certificado ICP-Brasil): nível qualificado para compra e venda e fianças de alto valor.

Como cada sessão do envelope carrega sua própria policy, combinar métodos diferentes por signatário é o que torna o fluxo imobiliário realista: o locatário usa OTP, o comprador usa certificado, e a imobiliária usa o aceite simples — cada um no nível de prova proporcional ao seu papel.

LGPD e dados pessoais no fluxo de locação

Contratos de locação concentram dados pessoais sensíveis: CPF, RG, renda, dados do fiador e, eventualmente, informações de cônjuges. Como plataforma LGPD-first, a SignDocs trata o ciclo de vida desses dados com base legal clara — a execução do contrato — e documenta publicamente como cada categoria é tratada e por quanto tempo é retida.

Na prática, isso significa que sua imobiliária consegue responder a solicitações de titulares com respaldo documental: a Tabela de Retenção define os prazos de guarda por categoria de dado, a Central de Confiança reúne DPA, política de privacidade e demais instrumentos, e o canal do DPO atende requisições de acesso, correção ou eliminação. A trilha de auditoria de cada assinatura, por sua vez, é a prova de consentimento e execução contratual que a LGPD espera.

Além da locação: o mesmo padrão em outros setores

O modelo que descrevemos aqui — múltiplas partes, ordem de assinatura, nível de prova proporcional ao risco e integração por webhooks — não é exclusivo do mercado imobiliário. Ele se repete, com pequenas variações, em diversos verticais que usam a mesma API:

• RH e admissão digital: pacotes de admissão com colaborador, gestor e diretor assinando em sequência. Veja a API de assinatura para RH.
• Fintechs e crédito: contratos de empréstimo, CCBs e termos de adesão com autenticação forte. Confira a API de assinatura para fintechs.
• Documentos jurídicos em geral: procurações e contratos de prestação de serviços seguem o mesmo padrão — veja assinatura digital de procuração e contratos de prestação de serviço.

Se você atende clientes de vários desses segmentos — como muitas imobiliárias que também administram condomínios ou prestam serviços a empresas — a mesma integração serve a todos, mudando apenas os signatários, a ordem e o nível de prova.

Testando em homologação antes de fechar locações reais

Antes de colocar contratos reais para rodar, monte todo o fluxo de locação no ambiente de homologação (sandbox), com host api-hml.signdocs.com.br. Lá você cria envelopes de teste com dados fictícios (o sandbox não aceita dados pessoais reais), simula as quatro assinaturas na ordem definida e valida o recebimento dos webhooks no seu CRM, sem custo e sem impacto em documentos de produção.

Vale lembrar que, em homologação, as entidades têm TTL de 7 dias — ou seja, transações de teste expiram automaticamente após uma semana, mantendo o ambiente limpo. Isso é ideal para validar a ordem entre locador, locatário, fiador e imobiliária, conferir os pacotes de evidências e ajustar a integração com calma antes de migrar para produção.