Enviar para Assinatura

Envia um envelope para todos os signatarios configurados. Cada signatario recebera uma notificacao por email com o link para assinar. Se o signatario tiver um numero de telefone cadastrado, tambem recebera uma notificacao via WhatsApp.

Requisicao

POST /v1/envelopes/{id}/send

Headers

Header	Tipo	Obrigatorio	Descricao
Authorization	string	Sim	Bearer token de autenticacao

Parametros de URL

Parametro	Tipo	Obrigatorio	Descricao
id	string	Sim	Identificador unico do envelope

Body

Nenhum body necessario. Basta enviar a requisicao com o ID do envelope na URL.

Exemplo de requisicao

curl -X POST \
  https://api.tapsign.com.br/v1/envelopes/env_d4e5f6a7-8b9c-0d1e-2f3a-4b5c6d7e8f9a/send \
  -H "Authorization: Bearer {token}"

Resposta

200 - Sucesso

{
  "id": "env_d4e5f6a7-8b9c-0d1e-2f3a-4b5c6d7e8f9a",
  "name": "Contrato de Prestacao de Servicos - Carlos Mendes",
  "status": "SENT",
  "signers": [
    {
      "id": "sgn_aaa111bbb",
      "name": "Carlos Eduardo Mendes",
      "email": "carlos@email.com",
      "role": "SIGNER",
      "status": "PENDING",
      "notifiedAt": "2026-03-29T14:30:00Z",
      "notificationChannels": ["EMAIL", "WHATSAPP"]
    },
    {
      "id": "sgn_ccc333ddd",
      "name": "Ana Paula Costa",
      "email": "ana@empresa.com.br",
      "role": "SIGNER",
      "status": "PENDING",
      "notifiedAt": "2026-03-29T14:30:00Z",
      "notificationChannels": ["EMAIL"]
    }
  ],
  "sentAt": "2026-03-29T14:30:00Z",
  "expiresAt": "2026-04-28T14:30:00Z"
}

Campos da resposta

Campo	Tipo	Descricao
id	string	Identificador unico do envelope
name	string	Nome do envelope
status	string	Status atualizado para SENT
signers[].id	string	Identificador do signatario
signers[].name	string	Nome do signatario
signers[].email	string	Email do signatario
signers[].role	string	Papel do signatario
signers[].status	string	Status da assinatura (PENDING)
signers[].notifiedAt	string	Data/hora da notificacao (ISO 8601)
signers[].notificationChannels	array	Canais utilizados (EMAIL, WHATSAPP)
sentAt	string	Data/hora do envio (ISO 8601)
expiresAt	string	Data de expiracao do envelope (ISO 8601)

Dica

O prazo padrao de expiracao e de 30 dias apos o envio. Apos esse prazo, o envelope muda automaticamente para o status EXPIRED e os signatarios nao poderao mais assinar.

400 - Requisicao invalida

{
  "error": "BAD_REQUEST",
  "message": "O envelope deve ter pelo menos um signatario configurado antes do envio."
}

401 - Nao autorizado

{
  "error": "UNAUTHORIZED",
  "message": "Token de autenticacao invalido ou expirado."
}

404 - Nao encontrado

{
  "error": "NOT_FOUND",
  "message": "Envelope nao encontrado ou nao pertence a sua organizacao."
}

422 - Estado invalido

{
  "error": "UNPROCESSABLE_ENTITY",
  "message": "O envelope ja foi enviado e nao pode ser enviado novamente."
}

Acao irreversivel

Apos o envio, o envelope nao pode ser editado. Certifique-se de que todos os signatarios, campos de assinatura e o documento estao corretos antes de enviar.

Notificacao via WhatsApp

A notificacao via WhatsApp so e enviada para signatarios que possuem um numero de telefone cadastrado com codigo do pais (ex: +5511999998888). Caso contrario, apenas o email sera utilizado.