---
title: "POST Create lote"
method: POST
path: "/api/lotes"
---

# POST Create lote

`POST /api/lotes`

Com este método, é possível **criar um lote de documentos com até 50 arquivos**.

Com o uso de lotes, você pode **agrupar documentos** e criar uma **solicitação de lote (lote request)** para enviá-los todos 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
  - `name` string, required — Nome do lote a ser cadastrado
  - `file` string[], required — É necessário enviar <strong>no mínimo 2 e no máximo 50 arquivos</strong>.<br><br>Para arquivos em Base64, utilize o seguinte formato: data:application/pdf;base64,<código_base64> <br>Também é possível definir o nome do arquivo utilizando o parâmetro name. Exemplo: data:application/pdf;name=meuarquivo.pdf;base64,<código_base64>
  - `departments` integer[] — Departamento(s) o qual o documento deve pertencer
  - `accessibility` 'Everyone' | 'Departments' | 'OnlyMe' — Visibilidade padrão do lote.
  - `editablevalidate` integer — 1 - QR Code no topo do documento (Sem página final). <br><br> Ao solicitar a assinatura na última página, sem posicioná-la, a página final será sempre gerada automaticamente. <br><br> 2 - Sem QR Code no topo, apenas página no final. <br><br> 3 - Página final de validação e QR Code no cabeçalho (Criaremos páginas extras). <br><br> 4 - QR Code no rodapé do documento (Sem página final). <br><br> 5 - Página final de validação e QR Code no rodapé (Criaremos páginas extras). <br><br> 6 - QR Code (Texto) na lateral esquerda. <br><br> 7 - QR Code (Texto) na lateral direita. <br><br>
  - `optimizer` boolean — Marca o documento para otimização, caso enviado 1 o sistema irá otimizar e achatar campos de formulário no documento

## Response `200`

200

- object
  - `data` object — Objeto principal contendo os dados do lote criado.
    - `id` integer — Identificador único do lote.
    - `company_id` integer — Identificador da empresa à qual o lote pertence.
    - `name` string — Nome do lote.
    - `created_at` string — Data e hora de criação do lote.
    - `updated_at` string — Data e hora da última atualização do lote.
    - `lote_requests` object[] — Lista de solicitações associadas ao lote.
    - `files` object[] — Lista de arquivos incluídos no lote.
      - `id` integer — Identificador único do arquivo.
      - `name` string — Nome do arquivo dentro do lote.
      - `file_name` string — Nome do arquivo gerado no sistema.
      - `extension` string — Extensão do arquivo.
      - `size` integer — Tamanho do arquivo.
      - `status` string — Status atual do arquivo.
      - `document_key` string — Chave única de identificação do documento.
      - `editted` 'Yes' | 'No' — Indica se o arquivo foi editado.
      - `is_template` 'Yes' | 'No' — Indica se o arquivo é um template.
      - `template_fields` string — Campos do template, quando aplicável.
      - `accessibility` 'Everyone' | 'Departments' | 'OnlyMe' — Visibilidade do arquivo.
      - `departments` string — Departamentos associados ao arquivo.
      - `folder` string — Pasta onde o arquivo está armazenado.
      - `uploaded_by` object — Usuário que realizou o upload do arquivo.
        - `name` string — Primeiro nome do usuário que realizou o upload.
        - `last_name` string — Sobrenome do usuário que realizou o upload.
      - `uploaded_on` string — Data e hora em que o arquivo foi enviado.
      - `download` string — URL para download do arquivo.
      - `tags` object[] — Tags associadas ao arquivo.

---

[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/revisions/41e10c7c691b/schema)