---
title: "POST Send Lote Requests"
method: POST
path: "/api/lotes/requests"
---

# POST Send Lote Requests

`POST /api/lotes/requests`

Com esse método é possível **enviar um lote de documentos para assinatura**.

Com o uso de lotes, você pode agrupar e enviar **vários documentos de uma só vez**, otimizando o processo de coleta de assinaturas.

Ideal para fluxos em que múltiplos documentos precisam ser assinados simultaneamente por um ou mais participantes.

## Request body

- object
  - `lote_id` integer, required — Lote ID usado na solicitação.
  - `chain` boolean — Se a solicitação é em cadeia, ou seja, deve respeitar a ordem dos e-mails para envio ou se será enviada para todos ao mesmo tempoo
  - `sender` string — Identifica o colaborador que aparecerá como remetente deste documento. Pode ser o ID do usuário ou o e-mail dele. Se omitido, o documento será enviado pela conta do admin da empresa.
  - `observer` string[] — Os observadores irão receber comunicados referentes à situação da solicitação. Para isso, inclua uma lista de emails
  - `due_months` string — A validade do documento em meses, por exemplo, um contrato com 12 meses de validade. Nós iremos monitorar a data e avisaremos antes do vencimento, para que possam refazer a solicitação e reenviar para assinatura
  - `silent_mode` integer — Quando ativado (True), o request não gera um e-mail para o cliente. Apenas o URL de assinatura e o e-mail serão retornados.
  - `width_page` string, required — Largura da página em pixels, este número será utilizado na hora de calcular as posições e campos de solicitação e/ou assinatura
  - `recipients` object[], required — Destininatarios
    - `send_to` string, required — E-mail/Telefone para o qual será enviado o documento.
    - `message` string — Mensagem enviada para o destinatário.
    - `subject` string — Definir o assunto do e-mail enviado ao destinatário.
    - `fullname` string — Preenche automaticamente o campo de nome completo do signatário.
    - `birthdate` string — Preenche automaticamente a data de nascimento (formato esperado: DD/MM/AAAA).
    - `cpf` string — Preenche automaticamente o CPF. (Somente Numeros)
    - `doubleauth` boolean — Este campo especifica se será realizada uma autenticação adicional para confirmar a assinatura. Quando ativado, o sistema enviará um token de validação para o e-mail e/ou WhatsApp do usuário. O usuário deverá inserir o token recebido para concluir a assinatura. Este campo é válido apenas quando o valor de 'chain' for 0 (false) e se aplica a todos os assinantes da requisição.
    - `allow_selfie` boolean — Solicitar selfie.
    - `allow_document` boolean — Solicitar frente do documento.
    - `allow_document_back` boolean — Solicitar parte de trás do documento.
    - `allow_cpf` boolean — Controla se o CPF deve ser solicitado ao assinante durante o processo de assinatura. Quando true, o sistema exige que o usuário informe o CPF antes de concluir a assinatura.
    - `allow_birth_date` boolean — Define se a data de nascimento será solicitada no momento da assinatura. Com true, a data de nascimento se torna obrigatória para finalizar a assinatura.
    - `signature_type` string — Define o tipo de papel que o assinante terá no processo de assinatura. Ex: Cliente, Testemunha, Advogado, Responsável técnico.
    - `reminder` string — E-mail ou celular para envio de lembrete. Deve ser uma string contendo apenas um e-mail ou número de celular. Quando chain é true, apenas o reminder do primeiro recipient é enviado imediatamente. Os demais recipients em cadeia não possuem suporte a reminder. Para garantir o envio de reminder a todos os recipients, utilize chain como false.
    - `send_finished` boolean — Opção para indicar se o usuário deve receber o documento após todas as assinaturas serem concluídas.
    - `expire_date` string, date — Data de expiração para este destinatário. Deve ser uma data válida no formato Y-m-d e posterior à data atual.
    - `signature_mode` 'all' | 'draw' | 'text' | 'upload' — Tipo da assinatura.
    - `certificate` boolean — Exigir certificado.
    - `fields` object[] — Campos de assinaturas.
      - `type` string, required — Tipo do campo (text, signature, rubric).
      - `page` integer, required — Página na qual a assinatura será inserida.
      - `width` number, float, required — Largura do campo de assinatura.
      - `height` number, float, required — Altura do campo de assinatura.
      - `xPos` number, float, required — Posição no eixo X no documento onde a assinatura será inserida.
      - `yPos` number, float, required — Posição no eixo Y no documento onde a assinatura será inserida.
      - `align` string — Alinhamento da assinatura (right, center, left).
      - `bold` string — Texto em negrito (bold).
      - `italic` string — Texto em itálico (italic).
      - `underline` string — Texto sublinhado (underline).
      - `strikethrough` string — Linha no meio do texto (strikethrough).
      - `text` string — Texto do campo.
      - `default` string — Valor default do campo para fields do type text
      - `color` string — Cor do texto.
      - `fontsize` string — Tamanho da fonte.
      - `document_key` string — Somente para lotes
      - `validateData` boolean — Campo já aparece preenchido com o valor default no momento da assinatura

## Response `200`

200

- object
  - `data` object, required — Objeto principal contendo os dados da solicitação de assinatura criada.
    - `id` integer — Identificador único da solicitação de assinatura.
    - `signing_key` string — Chave única de assinatura utilizada para autenticar e identificar a requisição.
    - `email` string — E-mail do signatário que receberá a solicitação de assinatura.
    - `message` string — Mensagem personalizada enviada ao signatário junto com a solicitação.
    - `expire_date` string — Data de expiração da solicitação.
    - `send_time` string — Data e hora em que a solicitação foi enviada.
    - `update_time` string — Data e hora da última atualização da solicitação.
    - `created_at` string — Data e hora de criação da solicitação.
    - `status` string — Status atual da solicitação.
    - `lote_Id` string — ID do lote referente a solicitação.
    - `url` string — URL para assinar o lote.
  - `message` string — Mensagem de confirmação retornada pela API após o envio da solicitação.

---

[API](https://skmtc.net/plugsign/apis/endpoints-manuais.md) · [All operations](https://skmtc.net/plugsign/apis/endpoints-manuais/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/plugsign/endpoints-manuais/versions/41e10c7c691b/schema)