{
  "info": {
    "_postman_id": "d8d3cca3-d307-55ff-8f91-49cf3e2855a7",
    "name": "Assin API",
    "description": "# API Assin\n\nCollection oficial para integrar com a plataforma de assinatura digital Assin.\n\n## Como usar\n1. Importe esta collection e o ambiente (`Assin-API-PRD` ou `Assin-API-HML`).\n2. Selecione o ambiente no canto superior direito e preencha `publicKey` e `secretKey` (painel Assin → Desenvolvimento → API Keys). `userId` só é necessário em chaves antigas ou para agir em nome de outro membro da empresa.\n3. Rode **00 · Comece aqui**.\n4. Siga um fluxo. As requisições rodam **em ordem**; cada uma guarda os IDs que a próxima usa (veja em **Variables** da collection).\n\nO token de acesso é gerado automaticamente antes de cada requisição. Nos passos de upload (**Body → binary**), selecione o arquivo antes de enviar.\n\n## Fluxos\n- **01** Do PDF ao envelope enviado e ao PDF assinado\n- **02** Envelope a partir de modelo (.docx preenchido)\n- **03** Envelope com grupo de signatários\n- **04** Envio em massa (lote)\n- **05** Receber avisos (webhooks)\n- **06** Gerenciar envelope enviado\n\n## Autenticação\n\nToda requisição leva o header `Authorization: Bearer <token>`. O token é um **JWT HS256** assinado com a sua `secretKey`, com este conteúdo:\n\n```json\n{ \"publicKey\": \"<sua publicKey>\", \"iat\": 1760000000, \"exp\": 1760003600 }\n```\n\nAs duas chaves estão no painel Assin, em **Desenvolvimento → API Keys**: `publicKey` e `secretKey` (a `secretKey` aparece só na criação da chave, guarde-a).\n\n**Por padrão, a API Key age em nome de quem a criou**, então não é preciso informar o usuário no token. Para agir em nome de **outro membro ativo da empresa** (ex.: cada vendedor do seu sistema), envie `\"moreInfo\": { \"userId\": \"<User ID>\" }`: uma única chave atende vários usuários. Chaves criadas antes de outubro de 2026 não têm dono: nelas o `userId` é obrigatório.\n\nGere um token novo a cada requisição ou reutilize até o `exp`. Exemplos:\n\n**Node.js** (`npm i jsonwebtoken`)\n```js\nconst jwt = require('jsonwebtoken');\nconst token = jwt.sign({ publicKey }, secretKey, { algorithm: 'HS256', expiresIn: '1h' });\n```\n\n**Python** (`pip install pyjwt`)\n```python\nimport jwt, time\nnow = int(time.time())\ntoken = jwt.encode({\"publicKey\": public_key, \"iat\": now, \"exp\": now + 3600}, secret_key, algorithm=\"HS256\")\n```\n\n**PHP** (`composer require firebase/php-jwt`)\n```php\nuse Firebase\\JWT\\JWT;\n$token = JWT::encode(['publicKey' => $publicKey, 'iat' => time(), 'exp' => time() + 3600], $secretKey, 'HS256');\n```\n\n**C#** (`System.IdentityModel.Tokens.Jwt`)\n```csharp\nvar key = new SymmetricSecurityKey(Encoding.UTF8.GetBytes(secretKey));\nvar token = new JwtSecurityToken(\n    claims: new[] { new Claim(\"publicKey\", publicKey) },\n    expires: DateTime.UtcNow.AddHours(1),\n    signingCredentials: new SigningCredentials(key, SecurityAlgorithms.HmacSha256));\nvar jwt = new JwtSecurityTokenHandler().WriteToken(token);\n```\n\n| Erro | Causa |\n|---|---|\n| `401 Not authorized for perform action` | `publicKey` inexistente ou token assinado com a `secretKey` errada |\n| `401 moreInfo.userId is required in the JWT payload` | Chave antiga, sem dono: envie o `userId` |\n| `403 moreInfo.userId is not an active member of the API key company` | O usuário não é membro ativo da empresa |\n| `403 API key is disabled` | A chave foi desativada no painel |\n\n\n\n### Base URL\n\n| Ambiente | URL |\n|---|---|\n| Produção | `https://api.assin.com.br` |\n| Homologação (testes) | `https://api.hml.assin.com.br` |\n\nTodas as rotas começam com `/v1`. Envie `Content-Type: application/json` nas requisições com corpo. Chamadas servidor a servidor não precisam do header `Origin`.\n\n### White label\n\nA mesma base URL atende todas as marcas. A **API Key define a empresa e a marca**: envelopes, documentos e modelos ficam na sua conta, os links de assinatura saem no seu domínio (`sign.seudominio.com.br`) e e-mails e WhatsApp usam a sua identidade visual. Não envie `Origin` nem `x-origin-with-label`: o gateway define a marca pela chave. O que é criado pela API aparece no painel, e vice-versa.\n\n### Formato dos corpos\n\n- A maioria das rotas recebe uma **lista** em `data`, o que permite operar vários itens de uma vez: `{ \"data\": [ { ... } ] }`.\n- Signatários e campos de assinatura têm o `envelopeId` **fora** da lista: `{ \"envelopeId\": \"...\", \"data\": [ { ... } ] }`.\n- Grupos, pastas, contatos, webhooks e lotes recebem `data` como **objeto**: `{ \"data\": { ... } }`.\n\n### Erros\n\n| Status | Significado |\n|---|---|\n| `400` | Dados inválidos ou regra de negócio violada. A mensagem diz o motivo |\n| `401` | Token ausente ou inválido |\n| `403` | Chave desativada, ou recurso de outra empresa |\n| `404` | Recurso não encontrado |\n| `409` | Mesma `Idempotency-Key` ainda em processamento |\n| `422` | Mesma `Idempotency-Key` usada com outro corpo ou rota |\n| `502` | Serviço interno indisponível; tente de novo |\n\n```json\n{\n  \"statusCode\": 400,\n  \"error\": \"Some Envelope does not have a signer\",\n  \"errorCode\": \"UNAUTHORIZED\",\n  \"message\": \"Some Envelope does not have a signer\",\n  \"rejectedInputs\": [{ \"identifier\": \"3fa85f64-5717-4562-b3fc-2c963f66afa6\", \"reason\": \"Some Envelope does not have a signer\", \"errorCode\": 2 }]\n}\n```\n\nErros de validação de campo listam cada problema em `message` (ex.: `\"data[0].email\" is required`).\n\n### Idempotência\n\nRotas que criam algo, lacram ou reenviam aceitam o header `Idempotency-Key` (até 255 caracteres, recomendamos um UUID). Repetir a **mesma** operação com a **mesma** chave em até 24 horas devolve a primeira resposta, sem criar ou cobrar de novo (header `Idempotent-Replayed: true`). Use sempre ao lacrar envelopes e processar lotes.\n\n### Filtros, ordenação e paginação\n\nNas listagens que aceitam:\n\n| Parâmetro | Exemplo | Observação |\n|---|---|---|\n| `filters` | `status:WAITING_SIGNATURE` | `campo:valor`. Vários campos separados por `;`, vários valores por `,` |\n| | `status:DRAFT,WAITING_SIGNATURE` | status DRAFT **ou** WAITING_SIGNATURE |\n| | `title:contrato$%25iLike%25` | contém \"contrato\", sem diferenciar maiúsculas (`%25` = `%`) |\n| `sortBy` | `createdAt:DESC` | `ASC` ou `DESC` |\n| `includes` | `envelopeSigners,envelopeSigners.signer` | relacionamentos, separados por vírgula |\n| `page` | `1`, `2`, `3` | número da página, começando em **1** (padrão 1) |\n| `pageSize` | `20` | máximo 100 |\n\nOperadores depois de `$`: `equals` (padrão), `not`, `iLike`, `%iLike%`, `iLike%`, `%iLike`, `isEmpty`, `isNotEmpty`. Codifique `%` como `%25` na URL.\n\n### Arquivos (upload e download)\n\n- **Upload:** a criação do documento devolve uma URL temporária (5 minutos). Envie o PDF com `PUT` nessa URL, corpo binário, `Content-Type: application/pdf` e **sem** `Authorization`.\n- **Download:** as URLs de download valem 5 minutos. Peça de novo quando precisar.\n\n\nDocumentação completa: https://api.assin.com.br/api-reference",
    "schema": "https://schema.getpostman.com/json/collection/v2.1.0/collection.json"
  },
  "auth": {
    "type": "bearer",
    "bearer": [
      {
        "key": "token",
        "value": "{{apiToken}}",
        "type": "string"
      }
    ]
  },
  "event": [
    {
      "listen": "prerequest",
      "script": {
        "type": "text/javascript",
        "exec": [
          "const get = (k) => pm.environment.get(k) || pm.collectionVariables.get(k);",
          "if (pm.request.url.toString().includes('/v1/')) {",
          "const publicKey = get('publicKey');",
          "const secretKey = get('secretKey');",
          "const userId = get('userId');",
          "if (!publicKey || !secretKey) {",
          "  throw new Error('Preencha publicKey e secretKey no ambiente (Environments) antes de chamar a API.');",
          "}",
          "const b64url = (words) => CryptoJS.enc.Base64.stringify(words).replace(/=+$/, '').replace(/\\+/g, '-').replace(/\\//g, '_');",
          "const now = Math.floor(Date.now() / 1000);",
          "const header = b64url(CryptoJS.enc.Utf8.parse(JSON.stringify({ alg: 'HS256', typ: 'JWT' })));",
          "const payload = b64url(CryptoJS.enc.Utf8.parse(JSON.stringify({ publicKey, ...(userId ? { moreInfo: { userId } } : {}), iat: now, exp: now + 3600 })));",
          "const signature = b64url(CryptoJS.HmacSHA256(`${header}.${payload}`, secretKey));",
          "pm.collectionVariables.set('apiToken', `${header}.${payload}.${signature}`);",
          "}"
        ]
      }
    }
  ],
  "variable": [
    {
      "key": "baseUrl",
      "value": "https://api.assin.com.br",
      "type": "string"
    },
    {
      "key": "apiToken",
      "value": "",
      "type": "string"
    },
    {
      "key": "documentId",
      "value": "",
      "type": "string"
    },
    {
      "key": "uploadUrl",
      "value": "",
      "type": "string"
    },
    {
      "key": "envelopeId",
      "value": "",
      "type": "string"
    },
    {
      "key": "companyId",
      "value": "",
      "type": "string"
    },
    {
      "key": "expiredAt",
      "value": "",
      "type": "string"
    },
    {
      "key": "signerId",
      "value": "",
      "type": "string"
    },
    {
      "key": "signer2Id",
      "value": "",
      "type": "string"
    },
    {
      "key": "tagId",
      "value": "",
      "type": "string"
    },
    {
      "key": "templateId",
      "value": "",
      "type": "string"
    },
    {
      "key": "templateUploadUrl",
      "value": "",
      "type": "string"
    },
    {
      "key": "documentToken",
      "value": "",
      "type": "string"
    },
    {
      "key": "groupId",
      "value": "",
      "type": "string"
    },
    {
      "key": "folderId",
      "value": "",
      "type": "string"
    },
    {
      "key": "contactId",
      "value": "",
      "type": "string"
    },
    {
      "key": "webhookId",
      "value": "",
      "type": "string"
    },
    {
      "key": "batchId",
      "value": "",
      "type": "string"
    },
    {
      "key": "batchDocumentId",
      "value": "",
      "type": "string"
    },
    {
      "key": "batchSignerId",
      "value": "",
      "type": "string"
    }
  ],
  "item": [
    {
      "name": "00 · Comece aqui: testar credenciais",
      "description": "Preencha o ambiente (publicKey, secretKey e, se precisar, userId) e rode esta requisição. 200 = tudo certo.\n\n\nToda requisição leva o header `Authorization: Bearer <token>`. O token é um **JWT HS256** assinado com a sua `secretKey`, com este conteúdo:\n\n```json\n{ \"publicKey\": \"<sua publicKey>\", \"iat\": 1760000000, \"exp\": 1760003600 }\n```\n\nAs duas chaves estão no painel Assin, em **Desenvolvimento → API Keys**: `publicKey` e `secretKey` (a `secretKey` aparece só na criação da chave, guarde-a).\n\n**Por padrão, a API Key age em nome de quem a criou**, então não é preciso informar o usuário no token. Para agir em nome de **outro membro ativo da empresa** (ex.: cada vendedor do seu sistema), envie `\"moreInfo\": { \"userId\": \"<User ID>\" }`: uma única chave atende vários usuários. Chaves criadas antes de outubro de 2026 não têm dono: nelas o `userId` é obrigatório.\n\nGere um token novo a cada requisição ou reutilize até o `exp`. Exemplos:\n\n**Node.js** (`npm i jsonwebtoken`)\n```js\nconst jwt = require('jsonwebtoken');\nconst token = jwt.sign({ publicKey }, secretKey, { algorithm: 'HS256', expiresIn: '1h' });\n```\n\n**Python** (`pip install pyjwt`)\n```python\nimport jwt, time\nnow = int(time.time())\ntoken = jwt.encode({\"publicKey\": public_key, \"iat\": now, \"exp\": now + 3600}, secret_key, algorithm=\"HS256\")\n```\n\n**PHP** (`composer require firebase/php-jwt`)\n```php\nuse Firebase\\JWT\\JWT;\n$token = JWT::encode(['publicKey' => $publicKey, 'iat' => time(), 'exp' => time() + 3600], $secretKey, 'HS256');\n```\n\n**C#** (`System.IdentityModel.Tokens.Jwt`)\n```csharp\nvar key = new SymmetricSecurityKey(Encoding.UTF8.GetBytes(secretKey));\nvar token = new JwtSecurityToken(\n    claims: new[] { new Claim(\"publicKey\", publicKey) },\n    expires: DateTime.UtcNow.AddHours(1),\n    signingCredentials: new SigningCredentials(key, SecurityAlgorithms.HmacSha256));\nvar jwt = new JwtSecurityTokenHandler().WriteToken(token);\n```\n\n| Erro | Causa |\n|---|---|\n| `401 Not authorized for perform action` | `publicKey` inexistente ou token assinado com a `secretKey` errada |\n| `401 moreInfo.userId is required in the JWT payload` | Chave antiga, sem dono: envie o `userId` |\n| `403 moreInfo.userId is not an active member of the API key company` | O usuário não é membro ativo da empresa |\n| `403 API key is disabled` | A chave foi desativada no painel |\n",
      "item": [
        {
          "name": "Testar credenciais",
          "event": [
            {
              "listen": "test",
              "script": {
                "type": "text/javascript",
                "exec": [
                  "pm.test('Resposta 2xx', () => pm.expect(pm.response.code).to.be.within(200, 299));",
                  "if (pm.response.code >= 400) {",
                  "  try { console.warn('Erro da API:', JSON.stringify(pm.response.json())); } catch (e) {}",
                  "}"
                ]
              }
            }
          ],
          "request": {
            "method": "GET",
            "header": [],
            "url": {
              "raw": "{{baseUrl}}/v1/envelopes/stats-created",
              "host": [
                "{{baseUrl}}"
              ],
              "path": [
                "v1",
                "envelopes",
                "stats-created"
              ]
            },
            "description": "Se responder 200, as credenciais estão certas e o token está sendo gerado automaticamente.\n\n**Resposta 200**\n\n```json\n{\n  \"allEnvelopes\": 120,\n  \"processing\": 14,\n  \"rejected\": 3,\n  \"finished\": 103\n}\n```"
          },
          "response": [
            {
              "name": "Exemplo 200",
              "originalRequest": {
                "method": "GET",
                "header": [],
                "url": {
                  "raw": "{{baseUrl}}/v1/envelopes/stats-created",
                  "host": [
                    "{{baseUrl}}"
                  ],
                  "path": [
                    "v1",
                    "envelopes",
                    "stats-created"
                  ]
                }
              },
              "status": "OK",
              "code": 200,
              "_postman_previewlanguage": "json",
              "header": [
                {
                  "key": "Content-Type",
                  "value": "application/json"
                }
              ],
              "body": "{\n  \"allEnvelopes\": 120,\n  \"processing\": 14,\n  \"rejected\": 3,\n  \"finished\": 103\n}"
            }
          ]
        }
      ]
    },
    {
      "name": "01 · Fluxo completo: do PDF ao envelope enviado",
      "description": "O fluxo principal. Rode **em ordem**: cada requisição guarda os IDs que a próxima usa.\n\n```\n1 Criar documento → 2 Enviar PDF → 3 Criar envelope → 4 Vincular documento\n  → 5 Signatários → 6 Posicionar campos → 7 Lacrar → 8 Acompanhar → 9 Baixar assinado\n```\n\nAo lacrar, a Assin envia os convites. Quando todos assinam, o envelope vai para `COMPLETED` e o PDF assinado fica disponível no último passo.",
      "item": [
        {
          "name": "1. Criar documento",
          "event": [
            {
              "listen": "test",
              "script": {
                "type": "text/javascript",
                "exec": [
                  "pm.test('Resposta 2xx', () => pm.expect(pm.response.code).to.be.within(200, 299));",
                  "if (pm.response.code >= 400) {",
                  "  try { console.warn('Erro da API:', JSON.stringify(pm.response.json())); } catch (e) {}",
                  "}",
                  "const doc = (pm.response.json().documents || [])[0];",
                  "if (doc) { pm.collectionVariables.set('documentId', doc.id); pm.collectionVariables.set('uploadUrl', doc.url); }"
                ]
              }
            }
          ],
          "request": {
            "method": "POST",
            "header": [
              {
                "key": "Content-Type",
                "value": "application/json"
              },
              {
                "key": "Idempotency-Key",
                "value": "{{$guid}}",
                "description": "Em retry da MESMA operação, reenvie o mesmo valor."
              }
            ],
            "url": {
              "raw": "{{baseUrl}}/v1/documents",
              "host": [
                "{{baseUrl}}"
              ],
              "path": [
                "v1",
                "documents"
              ]
            },
            "description": "Cria o registro do documento e devolve, em `url`, uma **URL de upload válida por 5 minutos**. O PDF ainda não foi enviado: faça o `PUT` do arquivo nessa URL (próxima rota).\n\nEnvie vários documentos de uma vez colocando mais itens em `data`. `alias` precisa ser único dentro da requisição.\n\nAceita `Idempotency-Key` (a collection gera um automaticamente).\n\n| Campo | Onde | Tipo | Obrigatório | Descrição |\n|---|---|---|---|---|\n| `data[].alias` | body | string | sim | Nome do documento (ex.: `Contrato.pdf`) |\n\n**Resposta 201**\n\n```json\n{\n  \"totalElements\": 1,\n  \"documents\": [\n    {\n      \"id\": \"3fa85f64-5717-4562-b3fc-2c963f66afa6\",\n      \"alias\": \"Contrato de Prestação de Serviços.pdf\",\n      \"url\": \"https://<bucket>.s3.amazonaws.com/companies/.../originalDocument.pdf?X-Amz-Expires=300&...\",\n      \"createdFrom\": \"API\",\n      \"companyId\": \"3fa85f64-5717-4562-b3fc-2c963f66afa6\",\n      \"createdAt\": \"2026-10-13T12:00:00.000Z\"\n    }\n  ]\n}\n```",
            "body": {
              "mode": "raw",
              "raw": "{\n  \"data\": [\n    {\n      \"alias\": \"Contrato de Prestação de Serviços.pdf\"\n    }\n  ]\n}",
              "options": {
                "raw": {
                  "language": "json"
                }
              }
            }
          },
          "response": [
            {
              "name": "Exemplo 201",
              "originalRequest": {
                "method": "POST",
                "header": [],
                "url": {
                  "raw": "{{baseUrl}}/v1/documents",
                  "host": [
                    "{{baseUrl}}"
                  ],
                  "path": [
                    "v1",
                    "documents"
                  ]
                }
              },
              "status": "OK",
              "code": 201,
              "_postman_previewlanguage": "json",
              "header": [
                {
                  "key": "Content-Type",
                  "value": "application/json"
                }
              ],
              "body": "{\n  \"totalElements\": 1,\n  \"documents\": [\n    {\n      \"id\": \"3fa85f64-5717-4562-b3fc-2c963f66afa6\",\n      \"alias\": \"Contrato de Prestação de Serviços.pdf\",\n      \"url\": \"https://<bucket>.s3.amazonaws.com/companies/.../originalDocument.pdf?X-Amz-Expires=300&...\",\n      \"createdFrom\": \"API\",\n      \"companyId\": \"3fa85f64-5717-4562-b3fc-2c963f66afa6\",\n      \"createdAt\": \"2026-10-13T12:00:00.000Z\"\n    }\n  ]\n}"
            }
          ]
        },
        {
          "name": "2. Enviar o PDF (Body → binary)",
          "event": [
            {
              "listen": "test",
              "script": {
                "type": "text/javascript",
                "exec": [
                  "pm.test('Resposta 2xx', () => pm.expect(pm.response.code).to.be.within(200, 299));",
                  "if (pm.response.code >= 400) {",
                  "  try { console.warn('Erro da API:', JSON.stringify(pm.response.json())); } catch (e) {}",
                  "}"
                ]
              }
            }
          ],
          "request": {
            "method": "PUT",
            "header": [
              {
                "key": "Content-Type",
                "value": "application/pdf"
              }
            ],
            "url": {
              "raw": "{{uploadUrl}}"
            },
            "description": "Envia os **bytes do PDF** para a `url` recebida na criação do documento.\n\n- Corpo: o arquivo PDF puro (binário). **Não** é multipart nem JSON.\n- **Sem** header `Authorization`: esta requisição vai direto ao storage, não à API.\n- Header `Content-Type: application/pdf`.\n- Faça em até 5 minutos. Se expirar, crie o documento de novo.\n\nNo Postman: aba **Body → binary** e selecione o PDF.\n\n```bash\ncurl -X PUT \"$UPLOAD_URL\" -H \"Content-Type: application/pdf\" --data-binary @contrato.pdf\n```\n\n**Resposta:** 200 com corpo vazio.",
            "body": {
              "mode": "file",
              "file": {
                "src": ""
              }
            },
            "auth": {
              "type": "noauth"
            }
          },
          "response": []
        },
        {
          "name": "3. Criar envelope",
          "event": [
            {
              "listen": "prerequest",
              "script": {
                "type": "text/javascript",
                "exec": [
                  "const d = new Date(Date.now() + 15 * 24 * 3600 * 1000);",
                  "pm.collectionVariables.set('expiredAt', d.toISOString());"
                ]
              }
            },
            {
              "listen": "test",
              "script": {
                "type": "text/javascript",
                "exec": [
                  "pm.test('Resposta 2xx', () => pm.expect(pm.response.code).to.be.within(200, 299));",
                  "if (pm.response.code >= 400) {",
                  "  try { console.warn('Erro da API:', JSON.stringify(pm.response.json())); } catch (e) {}",
                  "}",
                  "const env = (pm.response.json().envelopes || [])[0];",
                  "if (env) { pm.collectionVariables.set('envelopeId', env.id); if (env.companyId) pm.collectionVariables.set('companyId', env.companyId); }"
                ]
              }
            }
          ],
          "request": {
            "method": "POST",
            "header": [
              {
                "key": "Content-Type",
                "value": "application/json"
              },
              {
                "key": "Idempotency-Key",
                "value": "{{$guid}}",
                "description": "Em retry da MESMA operação, reenvie o mesmo valor."
              }
            ],
            "url": {
              "raw": "{{baseUrl}}/v1/envelopes",
              "host": [
                "{{baseUrl}}"
              ],
              "path": [
                "v1",
                "envelopes"
              ]
            },
            "description": "Cria um ou mais envelopes em `DRAFT`. `title` precisa ser único dentro da requisição.\n\nAceita `Idempotency-Key` (a collection gera um automaticamente).\n\n| Campo | Onde | Tipo | Obrigatório | Descrição |\n|---|---|---|---|---|\n| `data[].title` | body | string | sim | Título |\n| `data[].description` | body | string | sim | Descrição |\n| `data[].expiredAt` | body | ISO 8601 | não | Prazo para assinar. No mínimo amanhã |\n| `data[].notificationChannel` | body | enum | não | `EMAIL` (padrão) ou `WHATSAPP`. Com WhatsApp, todo signatário precisa de `phone` e há consumo de créditos de notificação |\n| `data[].validationByIcp` | body | boolean | não | Assinatura com certificado ICP-Brasil. Só se a empresa tiver ICP liberado |\n| `data[].folderId` | body | uuid | não | Pasta onde o envelope fica |\n| `data[].allowAutoResend` | body | boolean | não | Reenviar o convite automaticamente a quem não assinou |\n| `data[].resendIntervalDays` | body | string | não | Intervalo do reenvio automático, em dias (ex.: `\"3\"`) |\n\n**Resposta 201**\n\n```json\n{\n  \"totalElements\": 1,\n  \"envelopes\": [\n    {\n      \"id\": \"3fa85f64-5717-4562-b3fc-2c963f66afa6\",\n      \"title\": \"Contrato de Prestação de Serviços\",\n      \"description\": \"Contrato anual com a empresa X\",\n      \"status\": \"DRAFT\",\n      \"companyId\": \"3fa85f64-5717-4562-b3fc-2c963f66afa6\",\n      \"expiredAt\": \"2026-10-28T12:00:00.000Z\",\n      \"notificationChannel\": \"EMAIL\",\n      \"validationByIcp\": false,\n      \"createdAt\": \"2026-10-13T12:00:00.000Z\"\n    }\n  ]\n}\n```\n\n**Erros comuns**\n\n- 400 `Company not authorized`: `validationByIcp` sem ICP liberado\n- 400 data de expiração anterior a amanhã",
            "body": {
              "mode": "raw",
              "raw": "{\n  \"data\": [\n    {\n      \"title\": \"Contrato de Prestação de Serviços\",\n      \"description\": \"Contrato anual com a empresa X\",\n      \"expiredAt\": \"{{expiredAt}}\",\n      \"notificationChannel\": \"EMAIL\"\n    }\n  ]\n}",
              "options": {
                "raw": {
                  "language": "json"
                }
              }
            }
          },
          "response": [
            {
              "name": "Exemplo 201",
              "originalRequest": {
                "method": "POST",
                "header": [],
                "url": {
                  "raw": "{{baseUrl}}/v1/envelopes",
                  "host": [
                    "{{baseUrl}}"
                  ],
                  "path": [
                    "v1",
                    "envelopes"
                  ]
                }
              },
              "status": "OK",
              "code": 201,
              "_postman_previewlanguage": "json",
              "header": [
                {
                  "key": "Content-Type",
                  "value": "application/json"
                }
              ],
              "body": "{\n  \"totalElements\": 1,\n  \"envelopes\": [\n    {\n      \"id\": \"3fa85f64-5717-4562-b3fc-2c963f66afa6\",\n      \"title\": \"Contrato de Prestação de Serviços\",\n      \"description\": \"Contrato anual com a empresa X\",\n      \"status\": \"DRAFT\",\n      \"companyId\": \"3fa85f64-5717-4562-b3fc-2c963f66afa6\",\n      \"expiredAt\": \"2026-10-28T12:00:00.000Z\",\n      \"notificationChannel\": \"EMAIL\",\n      \"validationByIcp\": false,\n      \"createdAt\": \"2026-10-13T12:00:00.000Z\"\n    }\n  ]\n}"
            }
          ]
        },
        {
          "name": "4. Vincular o documento ao envelope",
          "event": [
            {
              "listen": "test",
              "script": {
                "type": "text/javascript",
                "exec": [
                  "pm.test('Resposta 2xx', () => pm.expect(pm.response.code).to.be.within(200, 299));",
                  "if (pm.response.code >= 400) {",
                  "  try { console.warn('Erro da API:', JSON.stringify(pm.response.json())); } catch (e) {}",
                  "}"
                ]
              }
            }
          ],
          "request": {
            "method": "POST",
            "header": [
              {
                "key": "Content-Type",
                "value": "application/json"
              },
              {
                "key": "Idempotency-Key",
                "value": "{{$guid}}",
                "description": "Em retry da MESMA operação, reenvie o mesmo valor."
              }
            ],
            "url": {
              "raw": "{{baseUrl}}/v1/envelopes/set/documents",
              "host": [
                "{{baseUrl}}"
              ],
              "path": [
                "v1",
                "envelopes",
                "set",
                "documents"
              ]
            },
            "description": "Coloca documentos dentro do envelope. O envelope precisa estar em `DRAFT` (ou `BLOCK`). A ordem do array `documents` é a ordem no envelope.\n\nPara **desvincular**, use a mesma rota com `remove` no lugar de `set`: `POST /v1/envelopes/remove/documents`.\n\nAceita `Idempotency-Key` (a collection gera um automaticamente).\n\n| Campo | Onde | Tipo | Obrigatório | Descrição |\n|---|---|---|---|---|\n| `method` | path | enum | sim | `set` (vincular) ou `remove` (desvincular) |\n| `data[].envelopeId` | body | uuid | sim | Envelope |\n| `data[].documents[].id` | body | uuid | sim | Documento |\n\n**Resposta 201**\n\n```json\n{\n  \"totalElements\": 1,\n  \"entities\": [\n    {\n      \"envelopeId\": \"3fa85f64-5717-4562-b3fc-2c963f66afa6\",\n      \"originalDocumentId\": \"3fa85f64-5717-4562-b3fc-2c963f66afa6\",\n      \"order\": 1\n    }\n  ]\n}\n```\n\n**Erros comuns**\n\n- 400 `Document already in envelope`\n- 400 envelope fora de `DRAFT`/`BLOCK`",
            "body": {
              "mode": "raw",
              "raw": "{\n  \"data\": [\n    {\n      \"envelopeId\": \"{{envelopeId}}\",\n      \"documents\": [\n        {\n          \"id\": \"{{documentId}}\"\n        }\n      ]\n    }\n  ]\n}",
              "options": {
                "raw": {
                  "language": "json"
                }
              }
            }
          },
          "response": [
            {
              "name": "Exemplo 201",
              "originalRequest": {
                "method": "POST",
                "header": [],
                "url": {
                  "raw": "{{baseUrl}}/v1/envelopes/set/documents",
                  "host": [
                    "{{baseUrl}}"
                  ],
                  "path": [
                    "v1",
                    "envelopes",
                    "set",
                    "documents"
                  ]
                }
              },
              "status": "OK",
              "code": 201,
              "_postman_previewlanguage": "json",
              "header": [
                {
                  "key": "Content-Type",
                  "value": "application/json"
                }
              ],
              "body": "{\n  \"totalElements\": 1,\n  \"entities\": [\n    {\n      \"envelopeId\": \"3fa85f64-5717-4562-b3fc-2c963f66afa6\",\n      \"originalDocumentId\": \"3fa85f64-5717-4562-b3fc-2c963f66afa6\",\n      \"order\": 1\n    }\n  ]\n}"
            }
          ]
        },
        {
          "name": "5. Adicionar signatários",
          "event": [
            {
              "listen": "test",
              "script": {
                "type": "text/javascript",
                "exec": [
                  "pm.test('Resposta 2xx', () => pm.expect(pm.response.code).to.be.within(200, 299));",
                  "if (pm.response.code >= 400) {",
                  "  try { console.warn('Erro da API:', JSON.stringify(pm.response.json())); } catch (e) {}",
                  "}",
                  "const list = pm.response.json().envelopeSigners || [];",
                  "const byEmail = (e) => list.find((s) => (s.signer?.email || s.email) === e) || {};",
                  "pm.collectionVariables.set('signerId', byEmail('maria@exemplo.com.br').signerId || list[0]?.signerId);",
                  "pm.collectionVariables.set('signer2Id', byEmail('joao@exemplo.com.br').signerId || list[1]?.signerId);"
                ]
              }
            }
          ],
          "request": {
            "method": "POST",
            "header": [
              {
                "key": "Content-Type",
                "value": "application/json"
              },
              {
                "key": "Idempotency-Key",
                "value": "{{$guid}}",
                "description": "Em retry da MESMA operação, reenvie o mesmo valor."
              }
            ],
            "url": {
              "raw": "{{baseUrl}}/v1/envelope-signers",
              "host": [
                "{{baseUrl}}"
              ],
              "path": [
                "v1",
                "envelope-signers"
              ]
            },
            "description": "Adiciona signatários ao envelope. Envelope em `DRAFT` ou `BLOCK`. `email` precisa ser único no envelope.\n\nAceita `Idempotency-Key` (a collection gera um automaticamente).\n\n| Campo | Onde | Tipo | Obrigatório | Descrição |\n|---|---|---|---|---|\n| `envelopeId` | body | uuid | sim | Envelope |\n| `data[].fullName` | body | string | sim | Nome completo |\n| `data[].email` | body | string | sim | E-mail |\n| `data[].order` | body | integer | sim | `0` = paralelo; `1, 2, 3...` = sequencial |\n| `data[].signatureType` | body | enum | sim | `PARTY` (parte), `WITNESS` (testemunha), `APPROVER` (aprovador), `CLIENT`, `SELLER`, `MANAGER`, `ACKNOWLEDGE` (ciência), `ACKNOWLEDGE_RECEIPT` (ciência de recebimento), `CARBON_COPY` (só recebe cópia, não assina) |\n| `data[].requirePersonalDocument` | body | boolean | sim | Pede foto de documento + selfie (validação biométrica) |\n| `data[].requireEmailToken` | body | boolean | sim | Pede código enviado por e-mail antes de assinar |\n| `data[].phone` | body | string | não | Formato E.164: `+5511999999999`. Obrigatório com canal WhatsApp |\n\n**Resposta 201**\n\n```json\n{\n  \"totalElements\": 2,\n  \"envelopeSigners\": [\n    {\n      \"signerId\": \"3fa85f64-5717-4562-b3fc-2c963f66afa6\",\n      \"envelopeId\": \"3fa85f64-5717-4562-b3fc-2c963f66afa6\",\n      \"order\": 0,\n      \"signatureType\": \"PARTY\",\n      \"status\": \"PENDING\",\n      \"requirePersonalDocument\": false,\n      \"requireEmailToken\": false,\n      \"signer\": {\n        \"fullName\": \"Maria Souza\",\n        \"email\": \"maria@exemplo.com.br\"\n      }\n    }\n  ]\n}\n```\n\n**Erros comuns**\n\n- 400 `Signers can only be added while the envelope is in DRAFT or BLOCK`\n- 400 e-mail repetido no envelope\n- 400 `Order must be zero (0)` / `Order must be greater than zero (0)`: mistura de `order` 0 com maior que 0, inclusive com os signatários já existentes",
            "body": {
              "mode": "raw",
              "raw": "{\n  \"envelopeId\": \"{{envelopeId}}\",\n  \"data\": [\n    {\n      \"fullName\": \"Maria Souza\",\n      \"email\": \"maria@exemplo.com.br\",\n      \"phone\": \"+5511999999999\",\n      \"order\": 0,\n      \"signatureType\": \"PARTY\",\n      \"requirePersonalDocument\": false,\n      \"requireEmailToken\": false\n    },\n    {\n      \"fullName\": \"João Lima\",\n      \"email\": \"joao@exemplo.com.br\",\n      \"order\": 0,\n      \"signatureType\": \"WITNESS\",\n      \"requirePersonalDocument\": false,\n      \"requireEmailToken\": false\n    }\n  ]\n}",
              "options": {
                "raw": {
                  "language": "json"
                }
              }
            }
          },
          "response": [
            {
              "name": "Exemplo 201",
              "originalRequest": {
                "method": "POST",
                "header": [],
                "url": {
                  "raw": "{{baseUrl}}/v1/envelope-signers",
                  "host": [
                    "{{baseUrl}}"
                  ],
                  "path": [
                    "v1",
                    "envelope-signers"
                  ]
                }
              },
              "status": "OK",
              "code": 201,
              "_postman_previewlanguage": "json",
              "header": [
                {
                  "key": "Content-Type",
                  "value": "application/json"
                }
              ],
              "body": "{\n  \"totalElements\": 2,\n  \"envelopeSigners\": [\n    {\n      \"signerId\": \"3fa85f64-5717-4562-b3fc-2c963f66afa6\",\n      \"envelopeId\": \"3fa85f64-5717-4562-b3fc-2c963f66afa6\",\n      \"order\": 0,\n      \"signatureType\": \"PARTY\",\n      \"status\": \"PENDING\",\n      \"requirePersonalDocument\": false,\n      \"requireEmailToken\": false,\n      \"signer\": {\n        \"fullName\": \"Maria Souza\",\n        \"email\": \"maria@exemplo.com.br\"\n      }\n    }\n  ]\n}"
            }
          ]
        },
        {
          "name": "6. Posicionar campos de assinatura",
          "event": [
            {
              "listen": "test",
              "script": {
                "type": "text/javascript",
                "exec": [
                  "pm.test('Resposta 2xx', () => pm.expect(pm.response.code).to.be.within(200, 299));",
                  "if (pm.response.code >= 400) {",
                  "  try { console.warn('Erro da API:', JSON.stringify(pm.response.json())); } catch (e) {}",
                  "}",
                  "const tags = pm.response.json().tags || [];",
                  "if (tags[0]) pm.collectionVariables.set('tagId', tags[0].id);"
                ]
              }
            }
          ],
          "request": {
            "method": "POST",
            "header": [
              {
                "key": "Content-Type",
                "value": "application/json"
              },
              {
                "key": "Idempotency-Key",
                "value": "{{$guid}}",
                "description": "Em retry da MESMA operação, reenvie o mesmo valor."
              }
            ],
            "url": {
              "raw": "{{baseUrl}}/v1/tags",
              "host": [
                "{{baseUrl}}"
              ],
              "path": [
                "v1",
                "tags"
              ]
            },
            "description": "Cria campos no documento. Envelope em `DRAFT` ou `BLOCK`.\n\nAceita `Idempotency-Key` (a collection gera um automaticamente).\n\n| Campo | Onde | Tipo | Obrigatório | Descrição |\n|---|---|---|---|---|\n| `envelopeId` | body | uuid | sim | Envelope |\n| `data[].envelopeSignerId` | body | uuid | sim | O `signerId` do signatário. Não usado em `TEXT_BOX` |\n| `data[].envelopeDocumentId` | body | uuid | sim | O `id` do documento |\n| `data[].elementType` | body | enum | sim | `SIGNATURE` (assinatura), `RUBRIC` (rubrica), `FULL_NAME` (nome), `EMAIL`, `SIGNATURE_DATETIME` (data/hora da assinatura), `SELECTION_BOX` (caixa de seleção), `TEXT_BOX` (texto livre, sem signatário) |\n| `data[].page` | body | integer | sim | Página (a partir de 1) |\n| `data[].axisX` | body | number | sim | 0 a 1, da esquerda |\n| `data[].axisY` | body | number | sim | 0 a 1, do topo |\n| `data[].width` | body | number | não | 0.01 a 1 |\n| `data[].height` | body | number | não | 0.01 a 1 |\n| `data[].content` | body | string | não | Texto (para `TEXT_BOX`) |\n| `data[].fontFamily` | body | enum | não | `Helvetica`, `Helvetica-Bold`, `Times-Roman`, `Courier` e variações |\n| `data[].fontSize` | body | integer | não | 6 a 96 |\n| `data[].fontColor` | body | string | não | `#RRGGBB` |\n| `data[].angle` | body | number | não | Padrão 0 |\n\n**Resposta 201**\n\n```json\n{\n  \"totalElements\": 3,\n  \"tags\": [\n    {\n      \"id\": \"3fa85f64-5717-4562-b3fc-2c963f66afa6\",\n      \"envelopeSignerId\": \"3fa85f64-5717-4562-b3fc-2c963f66afa6\",\n      \"envelopeDocumentId\": \"3fa85f64-5717-4562-b3fc-2c963f66afa6\",\n      \"envelopeId\": \"3fa85f64-5717-4562-b3fc-2c963f66afa6\",\n      \"elementType\": \"SIGNATURE\",\n      \"page\": 1,\n      \"axisX\": 0.1,\n      \"axisY\": 0.8,\n      \"width\": 0.15,\n      \"height\": 0.07,\n      \"angle\": 0\n    }\n  ]\n}\n```",
            "body": {
              "mode": "raw",
              "raw": "{\n  \"envelopeId\": \"{{envelopeId}}\",\n  \"data\": [\n    {\n      \"envelopeSignerId\": \"{{signerId}}\",\n      \"envelopeDocumentId\": \"{{documentId}}\",\n      \"elementType\": \"SIGNATURE\",\n      \"page\": 1,\n      \"axisX\": 0.1,\n      \"axisY\": 0.8\n    },\n    {\n      \"envelopeSignerId\": \"{{signerId}}\",\n      \"envelopeDocumentId\": \"{{documentId}}\",\n      \"elementType\": \"FULL_NAME\",\n      \"page\": 1,\n      \"axisX\": 0.1,\n      \"axisY\": 0.88\n    },\n    {\n      \"envelopeSignerId\": \"{{signer2Id}}\",\n      \"envelopeDocumentId\": \"{{documentId}}\",\n      \"elementType\": \"SIGNATURE\",\n      \"page\": 1,\n      \"axisX\": 0.55,\n      \"axisY\": 0.8\n    }\n  ]\n}",
              "options": {
                "raw": {
                  "language": "json"
                }
              }
            }
          },
          "response": [
            {
              "name": "Exemplo 201",
              "originalRequest": {
                "method": "POST",
                "header": [],
                "url": {
                  "raw": "{{baseUrl}}/v1/tags",
                  "host": [
                    "{{baseUrl}}"
                  ],
                  "path": [
                    "v1",
                    "tags"
                  ]
                }
              },
              "status": "OK",
              "code": 201,
              "_postman_previewlanguage": "json",
              "header": [
                {
                  "key": "Content-Type",
                  "value": "application/json"
                }
              ],
              "body": "{\n  \"totalElements\": 3,\n  \"tags\": [\n    {\n      \"id\": \"3fa85f64-5717-4562-b3fc-2c963f66afa6\",\n      \"envelopeSignerId\": \"3fa85f64-5717-4562-b3fc-2c963f66afa6\",\n      \"envelopeDocumentId\": \"3fa85f64-5717-4562-b3fc-2c963f66afa6\",\n      \"envelopeId\": \"3fa85f64-5717-4562-b3fc-2c963f66afa6\",\n      \"elementType\": \"SIGNATURE\",\n      \"page\": 1,\n      \"axisX\": 0.1,\n      \"axisY\": 0.8,\n      \"width\": 0.15,\n      \"height\": 0.07,\n      \"angle\": 0\n    }\n  ]\n}"
            }
          ]
        },
        {
          "name": "7. Lacrar e enviar",
          "event": [
            {
              "listen": "test",
              "script": {
                "type": "text/javascript",
                "exec": [
                  "pm.test('Resposta 2xx', () => pm.expect(pm.response.code).to.be.within(200, 299));",
                  "if (pm.response.code >= 400) {",
                  "  try { console.warn('Erro da API:', JSON.stringify(pm.response.json())); } catch (e) {}",
                  "}",
                  "const env = (pm.response.json().envelopes || [])[0];",
                  "pm.test('Envelope lacrado', () => pm.expect(env).to.exist);"
                ]
              }
            }
          ],
          "request": {
            "method": "PUT",
            "header": [
              {
                "key": "Content-Type",
                "value": "application/json"
              },
              {
                "key": "Idempotency-Key",
                "value": "{{$guid}}",
                "description": "Em retry da MESMA operação, reenvie o mesmo valor."
              }
            ],
            "url": {
              "raw": "{{baseUrl}}/v1/envelopes/close",
              "host": [
                "{{baseUrl}}"
              ],
              "path": [
                "v1",
                "envelopes",
                "close"
              ]
            },
            "description": "Lacra o envelope, **debita os créditos** e dispara os convites aos signatários. Use sempre `Idempotency-Key`: se houver timeout e você repetir com a mesma chave, não há cobrança dupla.\n\nRequisitos: envelope em `DRAFT` (ou `BLOCK`), ao menos 1 documento e 1 signatário, créditos suficientes. Com canal WhatsApp, todo signatário precisa de telefone válido.\n\nA resposta traz o status `CREATED`; em segundos ele passa a `WAITING_SIGNATURE`.\n\nAceita `Idempotency-Key` (a collection gera um automaticamente).\n\n| Campo | Onde | Tipo | Obrigatório | Descrição |\n|---|---|---|---|---|\n| `data[].id` | body | uuid | sim | Envelope |\n\n**Resposta 200**\n\n```json\n{\n  \"totalElements\": 1,\n  \"envelopes\": [\n    {\n      \"id\": \"3fa85f64-5717-4562-b3fc-2c963f66afa6\",\n      \"status\": \"CREATED\"\n    }\n  ]\n}\n```\n\n**Erros comuns**\n\n- 400 `Some Envelope not found in database`: id inexistente ou de outra empresa\n- 400 `Some Envelopes does not have a draft status`\n- 400 `Some Envelope does not have a document`\n- 400 `Some Envelope does not have a signer`\n- 400 `Company does not have enough credit`\n- 400 `Invalid phone number`: canal WhatsApp com signatário sem telefone E.164",
            "body": {
              "mode": "raw",
              "raw": "{\n  \"data\": [\n    {\n      \"id\": \"{{envelopeId}}\"\n    }\n  ]\n}",
              "options": {
                "raw": {
                  "language": "json"
                }
              }
            }
          },
          "response": [
            {
              "name": "Exemplo 200",
              "originalRequest": {
                "method": "PUT",
                "header": [],
                "url": {
                  "raw": "{{baseUrl}}/v1/envelopes/close",
                  "host": [
                    "{{baseUrl}}"
                  ],
                  "path": [
                    "v1",
                    "envelopes",
                    "close"
                  ]
                }
              },
              "status": "OK",
              "code": 200,
              "_postman_previewlanguage": "json",
              "header": [
                {
                  "key": "Content-Type",
                  "value": "application/json"
                }
              ],
              "body": "{\n  \"totalElements\": 1,\n  \"envelopes\": [\n    {\n      \"id\": \"3fa85f64-5717-4562-b3fc-2c963f66afa6\",\n      \"status\": \"CREATED\"\n    }\n  ]\n}"
            }
          ]
        },
        {
          "name": "8. Acompanhar assinaturas",
          "event": [
            {
              "listen": "test",
              "script": {
                "type": "text/javascript",
                "exec": [
                  "pm.test('Resposta 2xx', () => pm.expect(pm.response.code).to.be.within(200, 299));",
                  "if (pm.response.code >= 400) {",
                  "  try { console.warn('Erro da API:', JSON.stringify(pm.response.json())); } catch (e) {}",
                  "}",
                  "(pm.response.json().envelopeSigners || []).forEach((s) => console.log(s.signer?.fullName, '→', s.status));"
                ]
              }
            }
          ],
          "request": {
            "method": "GET",
            "header": [],
            "url": {
              "raw": "{{baseUrl}}/v1/envelope-signers?envelopeId={{envelopeId}}",
              "host": [
                "{{baseUrl}}"
              ],
              "path": [
                "v1",
                "envelope-signers"
              ],
              "query": [
                {
                  "key": "envelopeId",
                  "value": "{{envelopeId}}"
                }
              ]
            },
            "description": "Lista os signatários de um envelope, na ordem de assinatura, com o status de cada um.\n\n| Campo | Onde | Tipo | Obrigatório | Descrição |\n|---|---|---|---|---|\n| `envelopeId` | query | uuid | sim | Envelope |\n\n**Resposta 200**\n\n```json\n{\n  \"totalElements\": 2,\n  \"envelopeSigners\": [\n    {\n      \"signerId\": \"3fa85f64-5717-4562-b3fc-2c963f66afa6\",\n      \"envelopeId\": \"3fa85f64-5717-4562-b3fc-2c963f66afa6\",\n      \"order\": 0,\n      \"signatureType\": \"PARTY\",\n      \"status\": \"COMPLETED\",\n      \"requirePersonalDocument\": false,\n      \"requireEmailToken\": false,\n      \"createdAt\": \"2026-10-13T12:00:00.000Z\",\n      \"updatedAt\": \"2026-10-13T15:42:00.000Z\",\n      \"signer\": {\n        \"id\": \"3fa85f64-5717-4562-b3fc-2c963f66afa6\",\n        \"fullName\": \"Maria Souza\",\n        \"email\": \"maria@exemplo.com.br\",\n        \"phone\": \"+5511999999999\"\n      }\n    }\n  ]\n}\n```\n\n**Erros comuns**\n\n- 400 `Envelope not found`"
          },
          "response": [
            {
              "name": "Exemplo 200",
              "originalRequest": {
                "method": "GET",
                "header": [],
                "url": {
                  "raw": "{{baseUrl}}/v1/envelope-signers?envelopeId={{envelopeId}}",
                  "host": [
                    "{{baseUrl}}"
                  ],
                  "path": [
                    "v1",
                    "envelope-signers"
                  ],
                  "query": [
                    {
                      "key": "envelopeId",
                      "value": "{{envelopeId}}"
                    }
                  ]
                }
              },
              "status": "OK",
              "code": 200,
              "_postman_previewlanguage": "json",
              "header": [
                {
                  "key": "Content-Type",
                  "value": "application/json"
                }
              ],
              "body": "{\n  \"totalElements\": 2,\n  \"envelopeSigners\": [\n    {\n      \"signerId\": \"3fa85f64-5717-4562-b3fc-2c963f66afa6\",\n      \"envelopeId\": \"3fa85f64-5717-4562-b3fc-2c963f66afa6\",\n      \"order\": 0,\n      \"signatureType\": \"PARTY\",\n      \"status\": \"COMPLETED\",\n      \"requirePersonalDocument\": false,\n      \"requireEmailToken\": false,\n      \"createdAt\": \"2026-10-13T12:00:00.000Z\",\n      \"updatedAt\": \"2026-10-13T15:42:00.000Z\",\n      \"signer\": {\n        \"id\": \"3fa85f64-5717-4562-b3fc-2c963f66afa6\",\n        \"fullName\": \"Maria Souza\",\n        \"email\": \"maria@exemplo.com.br\",\n        \"phone\": \"+5511999999999\"\n      }\n    }\n  ]\n}"
            }
          ]
        },
        {
          "name": "8b. Status do envelope",
          "event": [
            {
              "listen": "test",
              "script": {
                "type": "text/javascript",
                "exec": [
                  "pm.test('Resposta 2xx', () => pm.expect(pm.response.code).to.be.within(200, 299));",
                  "if (pm.response.code >= 400) {",
                  "  try { console.warn('Erro da API:', JSON.stringify(pm.response.json())); } catch (e) {}",
                  "}",
                  "const env = (pm.response.json().envelopes || [])[0];",
                  "if (env) console.log('Status do envelope:', env.status);"
                ]
              }
            }
          ],
          "request": {
            "method": "GET",
            "header": [],
            "url": {
              "raw": "{{baseUrl}}/v1/envelopes?filters=id:{{envelopeId}}&includes=envelopeSigners,envelopeSigners.signer,envelopeDocuments&page=1&pageSize=1",
              "host": [
                "{{baseUrl}}"
              ],
              "path": [
                "v1",
                "envelopes"
              ],
              "query": [
                {
                  "key": "filters",
                  "value": "id:{{envelopeId}}"
                },
                {
                  "key": "includes",
                  "value": "envelopeSigners,envelopeSigners.signer,envelopeDocuments"
                },
                {
                  "key": "page",
                  "value": "1"
                },
                {
                  "key": "pageSize",
                  "value": "1"
                }
              ]
            },
            "description": "Lista os envelopes da empresa com filtros, ordenação, paginação e relacionamentos (ver **Filtros e paginação**).\n\n- Campos filtráveis: `id`, `title`, `description`, `status`, `expiredAt`, `createdAt`, `updatedAt`.\n- `includes`: `envelopeSigners`, `envelopeSigners.signer`, `envelopeDocuments`, `envelopeDocuments.originalDocument`, `envelopeDocuments.tags`, `user`.\n\nConsultar **um** envelope com tudo: `filters=id:<envelopeId>&includes=envelopeSigners,envelopeSigners.signer,envelopeDocuments`.\n\n**Resposta 200**\n\n```json\n{\n  \"currentPage\": 1,\n  \"pageSize\": 20,\n  \"totalPages\": 1,\n  \"totalElements\": 1,\n  \"envelopes\": [\n    {\n      \"id\": \"3fa85f64-5717-4562-b3fc-2c963f66afa6\",\n      \"title\": \"Contrato\",\n      \"status\": \"WAITING_SIGNATURE\",\n      \"expiredAt\": \"2026-10-28T12:00:00.000Z\",\n      \"createdAt\": \"2026-10-13T12:00:00.000Z\",\n      \"envelopeSigners\": [\n        {\n          \"signerId\": \"3fa85f64-5717-4562-b3fc-2c963f66afa6\",\n          \"order\": 0,\n          \"signatureType\": \"PARTY\",\n          \"status\": \"PENDING\",\n          \"signer\": {\n            \"fullName\": \"Maria Souza\",\n            \"email\": \"maria@exemplo.com.br\"\n          }\n        }\n      ]\n    }\n  ]\n}\n```"
          },
          "response": [
            {
              "name": "Exemplo 200",
              "originalRequest": {
                "method": "GET",
                "header": [],
                "url": {
                  "raw": "{{baseUrl}}/v1/envelopes?filters=id:{{envelopeId}}&includes=envelopeSigners,envelopeSigners.signer,envelopeDocuments&page=1&pageSize=1",
                  "host": [
                    "{{baseUrl}}"
                  ],
                  "path": [
                    "v1",
                    "envelopes"
                  ],
                  "query": [
                    {
                      "key": "filters",
                      "value": "id:{{envelopeId}}"
                    },
                    {
                      "key": "includes",
                      "value": "envelopeSigners,envelopeSigners.signer,envelopeDocuments"
                    },
                    {
                      "key": "page",
                      "value": "1"
                    },
                    {
                      "key": "pageSize",
                      "value": "1"
                    }
                  ]
                }
              },
              "status": "OK",
              "code": 200,
              "_postman_previewlanguage": "json",
              "header": [
                {
                  "key": "Content-Type",
                  "value": "application/json"
                }
              ],
              "body": "{\n  \"currentPage\": 1,\n  \"pageSize\": 20,\n  \"totalPages\": 1,\n  \"totalElements\": 1,\n  \"envelopes\": [\n    {\n      \"id\": \"3fa85f64-5717-4562-b3fc-2c963f66afa6\",\n      \"title\": \"Contrato\",\n      \"status\": \"WAITING_SIGNATURE\",\n      \"expiredAt\": \"2026-10-28T12:00:00.000Z\",\n      \"createdAt\": \"2026-10-13T12:00:00.000Z\",\n      \"envelopeSigners\": [\n        {\n          \"signerId\": \"3fa85f64-5717-4562-b3fc-2c963f66afa6\",\n          \"order\": 0,\n          \"signatureType\": \"PARTY\",\n          \"status\": \"PENDING\",\n          \"signer\": {\n            \"fullName\": \"Maria Souza\",\n            \"email\": \"maria@exemplo.com.br\"\n          }\n        }\n      ]\n    }\n  ]\n}"
            }
          ]
        },
        {
          "name": "(Opcional) Link de assinatura para seu sistema",
          "event": [
            {
              "listen": "test",
              "script": {
                "type": "text/javascript",
                "exec": [
                  "pm.test('Resposta 2xx', () => pm.expect(pm.response.code).to.be.within(200, 299));",
                  "if (pm.response.code >= 400) {",
                  "  try { console.warn('Erro da API:', JSON.stringify(pm.response.json())); } catch (e) {}",
                  "}"
                ]
              }
            }
          ],
          "request": {
            "method": "POST",
            "header": [
              {
                "key": "Content-Type",
                "value": "application/json"
              }
            ],
            "url": {
              "raw": "{{baseUrl}}/v1/envelope-signers/signing-link",
              "host": [
                "{{baseUrl}}"
              ],
              "path": [
                "v1",
                "envelope-signers",
                "signing-link"
              ]
            },
            "description": "Gera o link para o signatário assinar, para você abrir no seu sistema ou enviar pelo seu canal. Envelope em `WAITING_SIGNATURE`, signatário `PENDING` e que não seja `CARBON_COPY`.\n\n| Campo | Onde | Tipo | Obrigatório | Descrição |\n|---|---|---|---|---|\n| `envelopeId` | body | uuid | sim | Envelope |\n| `data[].signerId` | body | uuid | sim | Signatário |\n\n**Resposta 201**\n\n```json\n{\n  \"totalElements\": 1,\n  \"signingLinks\": [\n    {\n      \"signerId\": \"3fa85f64-5717-4562-b3fc-2c963f66afa6\",\n      \"url\": \"https://sign.assin.com.br/?access=eyJhbGciOi...\"\n    }\n  ]\n}\n```",
            "body": {
              "mode": "raw",
              "raw": "{\n  \"envelopeId\": \"{{envelopeId}}\",\n  \"data\": [\n    {\n      \"signerId\": \"{{signerId}}\"\n    }\n  ]\n}",
              "options": {
                "raw": {
                  "language": "json"
                }
              }
            }
          },
          "response": [
            {
              "name": "Exemplo 201",
              "originalRequest": {
                "method": "POST",
                "header": [],
                "url": {
                  "raw": "{{baseUrl}}/v1/envelope-signers/signing-link",
                  "host": [
                    "{{baseUrl}}"
                  ],
                  "path": [
                    "v1",
                    "envelope-signers",
                    "signing-link"
                  ]
                }
              },
              "status": "OK",
              "code": 201,
              "_postman_previewlanguage": "json",
              "header": [
                {
                  "key": "Content-Type",
                  "value": "application/json"
                }
              ],
              "body": "{\n  \"totalElements\": 1,\n  \"signingLinks\": [\n    {\n      \"signerId\": \"3fa85f64-5717-4562-b3fc-2c963f66afa6\",\n      \"url\": \"https://sign.assin.com.br/?access=eyJhbGciOi...\"\n    }\n  ]\n}"
            }
          ]
        },
        {
          "name": "9. Baixar documento assinado",
          "event": [
            {
              "listen": "test",
              "script": {
                "type": "text/javascript",
                "exec": [
                  "pm.test('Resposta 2xx', () => pm.expect(pm.response.code).to.be.within(200, 299));",
                  "if (pm.response.code >= 400) {",
                  "  try { console.warn('Erro da API:', JSON.stringify(pm.response.json())); } catch (e) {}",
                  "}"
                ]
              }
            }
          ],
          "request": {
            "method": "GET",
            "header": [],
            "url": {
              "raw": "{{baseUrl}}/v1/envelopes/{{envelopeId}}/documents",
              "host": [
                "{{baseUrl}}"
              ],
              "path": [
                "v1",
                "envelopes",
                "{{envelopeId}}",
                "documents"
              ]
            },
            "description": "Devolve links de download (válidos por **5 minutos**) de cada documento do envelope:\n\n- `original`: o PDF enviado.\n- `signed`: o PDF final assinado, com a página de evidências. Só existe quando o envelope está `COMPLETED`. `type` é `ICP` quando houve assinatura ICP-Brasil, senão `SUMMARY`.\n\nChame de novo quando precisar de um link novo.\n\n| Campo | Onde | Tipo | Obrigatório | Descrição |\n|---|---|---|---|---|\n| `envelopeId` | path | uuid | sim | Envelope |\n\n**Resposta 200**\n\n```json\n{\n  \"envelopeId\": \"3fa85f64-5717-4562-b3fc-2c963f66afa6\",\n  \"status\": \"COMPLETED\",\n  \"expiresIn\": 300,\n  \"documents\": [\n    {\n      \"order\": 1,\n      \"original\": {\n        \"id\": \"3fa85f64-5717-4562-b3fc-2c963f66afa6\",\n        \"alias\": \"Contrato.pdf\",\n        \"url\": \"https://...presigned...\"\n      },\n      \"signed\": {\n        \"id\": \"3fa85f64-5717-4562-b3fc-2c963f66afa6\",\n        \"alias\": \"Contrato.pdf\",\n        \"url\": \"https://...presigned...\",\n        \"type\": \"SUMMARY\"\n      }\n    }\n  ]\n}\n```\n\n**Erros comuns**\n\n- 404 `Envelope not found`"
          },
          "response": [
            {
              "name": "Exemplo 200",
              "originalRequest": {
                "method": "GET",
                "header": [],
                "url": {
                  "raw": "{{baseUrl}}/v1/envelopes/{{envelopeId}}/documents",
                  "host": [
                    "{{baseUrl}}"
                  ],
                  "path": [
                    "v1",
                    "envelopes",
                    "{{envelopeId}}",
                    "documents"
                  ]
                }
              },
              "status": "OK",
              "code": 200,
              "_postman_previewlanguage": "json",
              "header": [
                {
                  "key": "Content-Type",
                  "value": "application/json"
                }
              ],
              "body": "{\n  \"envelopeId\": \"3fa85f64-5717-4562-b3fc-2c963f66afa6\",\n  \"status\": \"COMPLETED\",\n  \"expiresIn\": 300,\n  \"documents\": [\n    {\n      \"order\": 1,\n      \"original\": {\n        \"id\": \"3fa85f64-5717-4562-b3fc-2c963f66afa6\",\n        \"alias\": \"Contrato.pdf\",\n        \"url\": \"https://...presigned...\"\n      },\n      \"signed\": {\n        \"id\": \"3fa85f64-5717-4562-b3fc-2c963f66afa6\",\n        \"alias\": \"Contrato.pdf\",\n        \"url\": \"https://...presigned...\",\n        \"type\": \"SUMMARY\"\n      }\n    }\n  ]\n}"
            }
          ]
        }
      ]
    },
    {
      "name": "02 · Envelope a partir de modelo",
      "description": "Para contratos padronizados: a Assin gera o PDF preenchido e você segue o fluxo normal, sem upload. Precisa de um modelo cadastrado (no painel ou pela pasta Referência → Modelos).",
      "item": [
        {
          "name": "1. Escolher o modelo",
          "event": [
            {
              "listen": "test",
              "script": {
                "type": "text/javascript",
                "exec": [
                  "pm.test('Resposta 2xx', () => pm.expect(pm.response.code).to.be.within(200, 299));",
                  "if (pm.response.code >= 400) {",
                  "  try { console.warn('Erro da API:', JSON.stringify(pm.response.json())); } catch (e) {}",
                  "}",
                  "const t = (pm.response.json().templates || [])[0];",
                  "if (t) pm.collectionVariables.set('templateId', t.id);"
                ]
              }
            }
          ],
          "request": {
            "method": "GET",
            "header": [],
            "url": {
              "raw": "{{baseUrl}}/v1/templates?page=1&pageSize=20",
              "host": [
                "{{baseUrl}}"
              ],
              "path": [
                "v1",
                "templates"
              ],
              "query": [
                {
                  "key": "page",
                  "value": "1"
                },
                {
                  "key": "pageSize",
                  "value": "20"
                }
              ]
            },
            "description": "Lista os modelos ativos e inativos. `keys` são os campos que precisam ser preenchidos. Aceita `filters`, `sortBy`, `page`, `pageSize`.\n\n**Resposta 200**\n\n```json\n{\n  \"totalElements\": 1,\n  \"templates\": [\n    {\n      \"id\": \"3fa85f64-5717-4562-b3fc-2c963f66afa6\",\n      \"alias\": \"Contrato CLT\",\n      \"description\": \"Modelo padrão\",\n      \"isActive\": true,\n      \"file\": \"https://...presigned .docx...\",\n      \"keys\": [\n        {\n          \"alias\": \"nomeColaborador\",\n          \"description\": \"Nome\",\n          \"maxSize\": 100\n        }\n      ]\n    }\n  ]\n}\n```"
          },
          "response": [
            {
              "name": "Exemplo 200",
              "originalRequest": {
                "method": "GET",
                "header": [],
                "url": {
                  "raw": "{{baseUrl}}/v1/templates?page=1&pageSize=20",
                  "host": [
                    "{{baseUrl}}"
                  ],
                  "path": [
                    "v1",
                    "templates"
                  ],
                  "query": [
                    {
                      "key": "page",
                      "value": "1"
                    },
                    {
                      "key": "pageSize",
                      "value": "20"
                    }
                  ]
                }
              },
              "status": "OK",
              "code": 200,
              "_postman_previewlanguage": "json",
              "header": [
                {
                  "key": "Content-Type",
                  "value": "application/json"
                }
              ],
              "body": "{\n  \"totalElements\": 1,\n  \"templates\": [\n    {\n      \"id\": \"3fa85f64-5717-4562-b3fc-2c963f66afa6\",\n      \"alias\": \"Contrato CLT\",\n      \"description\": \"Modelo padrão\",\n      \"isActive\": true,\n      \"file\": \"https://...presigned .docx...\",\n      \"keys\": [\n        {\n          \"alias\": \"nomeColaborador\",\n          \"description\": \"Nome\",\n          \"maxSize\": 100\n        }\n      ]\n    }\n  ]\n}"
            }
          ]
        },
        {
          "name": "2. Gerar documento preenchido",
          "event": [
            {
              "listen": "test",
              "script": {
                "type": "text/javascript",
                "exec": [
                  "pm.test('Resposta 2xx', () => pm.expect(pm.response.code).to.be.within(200, 299));",
                  "if (pm.response.code >= 400) {",
                  "  try { console.warn('Erro da API:', JSON.stringify(pm.response.json())); } catch (e) {}",
                  "}",
                  "const d = (pm.response.json().entities || [])[0];",
                  "if (d) pm.collectionVariables.set('documentId', d.id);"
                ]
              }
            }
          ],
          "request": {
            "method": "POST",
            "header": [
              {
                "key": "Content-Type",
                "value": "application/json"
              },
              {
                "key": "Idempotency-Key",
                "value": "{{$guid}}",
                "description": "Em retry da MESMA operação, reenvie o mesmo valor."
              }
            ],
            "url": {
              "raw": "{{baseUrl}}/v1/templates/generate-document",
              "host": [
                "{{baseUrl}}"
              ],
              "path": [
                "v1",
                "templates",
                "generate-document"
              ]
            },
            "description": "Preenche o modelo e gera um PDF. O `id` devolvido é um **documento** comum: vincule-o a um envelope com `POST /v1/envelopes/set/documents`.\n\n`key` deve ser igual ao `alias` do campo no modelo. Valores maiores que `maxSize` ou campos inexistentes voltam em `rejectedInputs`.\n\nAceita `Idempotency-Key` (a collection gera um automaticamente).\n\n| Campo | Onde | Tipo | Obrigatório | Descrição |\n|---|---|---|---|---|\n| `data[].templateId` | body | uuid | sim | Modelo |\n| `data[].documents[].alias` | body | string | sim | Nome do documento gerado |\n| `data[].documents[].keys[].key` | body | string | sim | Campo |\n| `data[].documents[].keys[].description` | body | string | sim |  |\n| `data[].documents[].keys[].value` | body | string | sim | Valor |\n\n**Resposta 201**\n\n```json\n{\n  \"totalElements\": 1,\n  \"entities\": [\n    {\n      \"id\": \"3fa85f64-5717-4562-b3fc-2c963f66afa6\",\n      \"alias\": \"Contrato - João Silva\",\n      \"url\": \"https://...presigned...\",\n      \"createdFrom\": \"GENERATE_BY_ASSIN\"\n    }\n  ]\n}\n```",
            "body": {
              "mode": "raw",
              "raw": "{\n  \"data\": [\n    {\n      \"templateId\": \"{{templateId}}\",\n      \"documents\": [\n        {\n          \"alias\": \"Contrato - João Silva\",\n          \"keys\": [\n            {\n              \"key\": \"nomeColaborador\",\n              \"description\": \"Nome completo\",\n              \"value\": \"João Silva\"\n            },\n            {\n              \"key\": \"cpf\",\n              \"description\": \"CPF\",\n              \"value\": \"123.456.789-00\"\n            }\n          ]\n        }\n      ]\n    }\n  ]\n}",
              "options": {
                "raw": {
                  "language": "json"
                }
              }
            }
          },
          "response": [
            {
              "name": "Exemplo 201",
              "originalRequest": {
                "method": "POST",
                "header": [],
                "url": {
                  "raw": "{{baseUrl}}/v1/templates/generate-document",
                  "host": [
                    "{{baseUrl}}"
                  ],
                  "path": [
                    "v1",
                    "templates",
                    "generate-document"
                  ]
                }
              },
              "status": "OK",
              "code": 201,
              "_postman_previewlanguage": "json",
              "header": [
                {
                  "key": "Content-Type",
                  "value": "application/json"
                }
              ],
              "body": "{\n  \"totalElements\": 1,\n  \"entities\": [\n    {\n      \"id\": \"3fa85f64-5717-4562-b3fc-2c963f66afa6\",\n      \"alias\": \"Contrato - João Silva\",\n      \"url\": \"https://...presigned...\",\n      \"createdFrom\": \"GENERATE_BY_ASSIN\"\n    }\n  ]\n}"
            }
          ]
        },
        {
          "name": "3. Criar envelope",
          "event": [
            {
              "listen": "prerequest",
              "script": {
                "type": "text/javascript",
                "exec": [
                  "const d = new Date(Date.now() + 15 * 24 * 3600 * 1000);",
                  "pm.collectionVariables.set('expiredAt', d.toISOString());"
                ]
              }
            },
            {
              "listen": "test",
              "script": {
                "type": "text/javascript",
                "exec": [
                  "pm.test('Resposta 2xx', () => pm.expect(pm.response.code).to.be.within(200, 299));",
                  "if (pm.response.code >= 400) {",
                  "  try { console.warn('Erro da API:', JSON.stringify(pm.response.json())); } catch (e) {}",
                  "}",
                  "const env = (pm.response.json().envelopes || [])[0];",
                  "if (env) { pm.collectionVariables.set('envelopeId', env.id); if (env.companyId) pm.collectionVariables.set('companyId', env.companyId); }"
                ]
              }
            }
          ],
          "request": {
            "method": "POST",
            "header": [
              {
                "key": "Content-Type",
                "value": "application/json"
              },
              {
                "key": "Idempotency-Key",
                "value": "{{$guid}}",
                "description": "Em retry da MESMA operação, reenvie o mesmo valor."
              }
            ],
            "url": {
              "raw": "{{baseUrl}}/v1/envelopes",
              "host": [
                "{{baseUrl}}"
              ],
              "path": [
                "v1",
                "envelopes"
              ]
            },
            "description": "Cria um ou mais envelopes em `DRAFT`. `title` precisa ser único dentro da requisição.\n\nAceita `Idempotency-Key` (a collection gera um automaticamente).\n\n| Campo | Onde | Tipo | Obrigatório | Descrição |\n|---|---|---|---|---|\n| `data[].title` | body | string | sim | Título |\n| `data[].description` | body | string | sim | Descrição |\n| `data[].expiredAt` | body | ISO 8601 | não | Prazo para assinar. No mínimo amanhã |\n| `data[].notificationChannel` | body | enum | não | `EMAIL` (padrão) ou `WHATSAPP`. Com WhatsApp, todo signatário precisa de `phone` e há consumo de créditos de notificação |\n| `data[].validationByIcp` | body | boolean | não | Assinatura com certificado ICP-Brasil. Só se a empresa tiver ICP liberado |\n| `data[].folderId` | body | uuid | não | Pasta onde o envelope fica |\n| `data[].allowAutoResend` | body | boolean | não | Reenviar o convite automaticamente a quem não assinou |\n| `data[].resendIntervalDays` | body | string | não | Intervalo do reenvio automático, em dias (ex.: `\"3\"`) |\n\n**Resposta 201**\n\n```json\n{\n  \"totalElements\": 1,\n  \"envelopes\": [\n    {\n      \"id\": \"3fa85f64-5717-4562-b3fc-2c963f66afa6\",\n      \"title\": \"Contrato de Prestação de Serviços\",\n      \"description\": \"Contrato anual com a empresa X\",\n      \"status\": \"DRAFT\",\n      \"companyId\": \"3fa85f64-5717-4562-b3fc-2c963f66afa6\",\n      \"expiredAt\": \"2026-10-28T12:00:00.000Z\",\n      \"notificationChannel\": \"EMAIL\",\n      \"validationByIcp\": false,\n      \"createdAt\": \"2026-10-13T12:00:00.000Z\"\n    }\n  ]\n}\n```\n\n**Erros comuns**\n\n- 400 `Company not authorized`: `validationByIcp` sem ICP liberado\n- 400 data de expiração anterior a amanhã",
            "body": {
              "mode": "raw",
              "raw": "{\n  \"data\": [\n    {\n      \"title\": \"Contrato de Prestação de Serviços\",\n      \"description\": \"Contrato anual com a empresa X\",\n      \"expiredAt\": \"{{expiredAt}}\",\n      \"notificationChannel\": \"EMAIL\"\n    }\n  ]\n}",
              "options": {
                "raw": {
                  "language": "json"
                }
              }
            }
          },
          "response": [
            {
              "name": "Exemplo 201",
              "originalRequest": {
                "method": "POST",
                "header": [],
                "url": {
                  "raw": "{{baseUrl}}/v1/envelopes",
                  "host": [
                    "{{baseUrl}}"
                  ],
                  "path": [
                    "v1",
                    "envelopes"
                  ]
                }
              },
              "status": "OK",
              "code": 201,
              "_postman_previewlanguage": "json",
              "header": [
                {
                  "key": "Content-Type",
                  "value": "application/json"
                }
              ],
              "body": "{\n  \"totalElements\": 1,\n  \"envelopes\": [\n    {\n      \"id\": \"3fa85f64-5717-4562-b3fc-2c963f66afa6\",\n      \"title\": \"Contrato de Prestação de Serviços\",\n      \"description\": \"Contrato anual com a empresa X\",\n      \"status\": \"DRAFT\",\n      \"companyId\": \"3fa85f64-5717-4562-b3fc-2c963f66afa6\",\n      \"expiredAt\": \"2026-10-28T12:00:00.000Z\",\n      \"notificationChannel\": \"EMAIL\",\n      \"validationByIcp\": false,\n      \"createdAt\": \"2026-10-13T12:00:00.000Z\"\n    }\n  ]\n}"
            }
          ]
        },
        {
          "name": "4. Vincular o documento gerado",
          "event": [
            {
              "listen": "test",
              "script": {
                "type": "text/javascript",
                "exec": [
                  "pm.test('Resposta 2xx', () => pm.expect(pm.response.code).to.be.within(200, 299));",
                  "if (pm.response.code >= 400) {",
                  "  try { console.warn('Erro da API:', JSON.stringify(pm.response.json())); } catch (e) {}",
                  "}"
                ]
              }
            }
          ],
          "request": {
            "method": "POST",
            "header": [
              {
                "key": "Content-Type",
                "value": "application/json"
              },
              {
                "key": "Idempotency-Key",
                "value": "{{$guid}}",
                "description": "Em retry da MESMA operação, reenvie o mesmo valor."
              }
            ],
            "url": {
              "raw": "{{baseUrl}}/v1/envelopes/set/documents",
              "host": [
                "{{baseUrl}}"
              ],
              "path": [
                "v1",
                "envelopes",
                "set",
                "documents"
              ]
            },
            "description": "Coloca documentos dentro do envelope. O envelope precisa estar em `DRAFT` (ou `BLOCK`). A ordem do array `documents` é a ordem no envelope.\n\nPara **desvincular**, use a mesma rota com `remove` no lugar de `set`: `POST /v1/envelopes/remove/documents`.\n\nAceita `Idempotency-Key` (a collection gera um automaticamente).\n\n| Campo | Onde | Tipo | Obrigatório | Descrição |\n|---|---|---|---|---|\n| `method` | path | enum | sim | `set` (vincular) ou `remove` (desvincular) |\n| `data[].envelopeId` | body | uuid | sim | Envelope |\n| `data[].documents[].id` | body | uuid | sim | Documento |\n\n**Resposta 201**\n\n```json\n{\n  \"totalElements\": 1,\n  \"entities\": [\n    {\n      \"envelopeId\": \"3fa85f64-5717-4562-b3fc-2c963f66afa6\",\n      \"originalDocumentId\": \"3fa85f64-5717-4562-b3fc-2c963f66afa6\",\n      \"order\": 1\n    }\n  ]\n}\n```\n\n**Erros comuns**\n\n- 400 `Document already in envelope`\n- 400 envelope fora de `DRAFT`/`BLOCK`",
            "body": {
              "mode": "raw",
              "raw": "{\n  \"data\": [\n    {\n      \"envelopeId\": \"{{envelopeId}}\",\n      \"documents\": [\n        {\n          \"id\": \"{{documentId}}\"\n        }\n      ]\n    }\n  ]\n}",
              "options": {
                "raw": {
                  "language": "json"
                }
              }
            }
          },
          "response": [
            {
              "name": "Exemplo 201",
              "originalRequest": {
                "method": "POST",
                "header": [],
                "url": {
                  "raw": "{{baseUrl}}/v1/envelopes/set/documents",
                  "host": [
                    "{{baseUrl}}"
                  ],
                  "path": [
                    "v1",
                    "envelopes",
                    "set",
                    "documents"
                  ]
                }
              },
              "status": "OK",
              "code": 201,
              "_postman_previewlanguage": "json",
              "header": [
                {
                  "key": "Content-Type",
                  "value": "application/json"
                }
              ],
              "body": "{\n  \"totalElements\": 1,\n  \"entities\": [\n    {\n      \"envelopeId\": \"3fa85f64-5717-4562-b3fc-2c963f66afa6\",\n      \"originalDocumentId\": \"3fa85f64-5717-4562-b3fc-2c963f66afa6\",\n      \"order\": 1\n    }\n  ]\n}"
            }
          ]
        },
        {
          "name": "5. Adicionar signatários",
          "event": [
            {
              "listen": "test",
              "script": {
                "type": "text/javascript",
                "exec": [
                  "pm.test('Resposta 2xx', () => pm.expect(pm.response.code).to.be.within(200, 299));",
                  "if (pm.response.code >= 400) {",
                  "  try { console.warn('Erro da API:', JSON.stringify(pm.response.json())); } catch (e) {}",
                  "}",
                  "const list = pm.response.json().envelopeSigners || [];",
                  "const byEmail = (e) => list.find((s) => (s.signer?.email || s.email) === e) || {};",
                  "pm.collectionVariables.set('signerId', byEmail('maria@exemplo.com.br').signerId || list[0]?.signerId);",
                  "pm.collectionVariables.set('signer2Id', byEmail('joao@exemplo.com.br').signerId || list[1]?.signerId);"
                ]
              }
            }
          ],
          "request": {
            "method": "POST",
            "header": [
              {
                "key": "Content-Type",
                "value": "application/json"
              },
              {
                "key": "Idempotency-Key",
                "value": "{{$guid}}",
                "description": "Em retry da MESMA operação, reenvie o mesmo valor."
              }
            ],
            "url": {
              "raw": "{{baseUrl}}/v1/envelope-signers",
              "host": [
                "{{baseUrl}}"
              ],
              "path": [
                "v1",
                "envelope-signers"
              ]
            },
            "description": "Adiciona signatários ao envelope. Envelope em `DRAFT` ou `BLOCK`. `email` precisa ser único no envelope.\n\nAceita `Idempotency-Key` (a collection gera um automaticamente).\n\n| Campo | Onde | Tipo | Obrigatório | Descrição |\n|---|---|---|---|---|\n| `envelopeId` | body | uuid | sim | Envelope |\n| `data[].fullName` | body | string | sim | Nome completo |\n| `data[].email` | body | string | sim | E-mail |\n| `data[].order` | body | integer | sim | `0` = paralelo; `1, 2, 3...` = sequencial |\n| `data[].signatureType` | body | enum | sim | `PARTY` (parte), `WITNESS` (testemunha), `APPROVER` (aprovador), `CLIENT`, `SELLER`, `MANAGER`, `ACKNOWLEDGE` (ciência), `ACKNOWLEDGE_RECEIPT` (ciência de recebimento), `CARBON_COPY` (só recebe cópia, não assina) |\n| `data[].requirePersonalDocument` | body | boolean | sim | Pede foto de documento + selfie (validação biométrica) |\n| `data[].requireEmailToken` | body | boolean | sim | Pede código enviado por e-mail antes de assinar |\n| `data[].phone` | body | string | não | Formato E.164: `+5511999999999`. Obrigatório com canal WhatsApp |\n\n**Resposta 201**\n\n```json\n{\n  \"totalElements\": 2,\n  \"envelopeSigners\": [\n    {\n      \"signerId\": \"3fa85f64-5717-4562-b3fc-2c963f66afa6\",\n      \"envelopeId\": \"3fa85f64-5717-4562-b3fc-2c963f66afa6\",\n      \"order\": 0,\n      \"signatureType\": \"PARTY\",\n      \"status\": \"PENDING\",\n      \"requirePersonalDocument\": false,\n      \"requireEmailToken\": false,\n      \"signer\": {\n        \"fullName\": \"Maria Souza\",\n        \"email\": \"maria@exemplo.com.br\"\n      }\n    }\n  ]\n}\n```\n\n**Erros comuns**\n\n- 400 `Signers can only be added while the envelope is in DRAFT or BLOCK`\n- 400 e-mail repetido no envelope\n- 400 `Order must be zero (0)` / `Order must be greater than zero (0)`: mistura de `order` 0 com maior que 0, inclusive com os signatários já existentes",
            "body": {
              "mode": "raw",
              "raw": "{\n  \"envelopeId\": \"{{envelopeId}}\",\n  \"data\": [\n    {\n      \"fullName\": \"Maria Souza\",\n      \"email\": \"maria@exemplo.com.br\",\n      \"phone\": \"+5511999999999\",\n      \"order\": 0,\n      \"signatureType\": \"PARTY\",\n      \"requirePersonalDocument\": false,\n      \"requireEmailToken\": false\n    },\n    {\n      \"fullName\": \"João Lima\",\n      \"email\": \"joao@exemplo.com.br\",\n      \"order\": 0,\n      \"signatureType\": \"WITNESS\",\n      \"requirePersonalDocument\": false,\n      \"requireEmailToken\": false\n    }\n  ]\n}",
              "options": {
                "raw": {
                  "language": "json"
                }
              }
            }
          },
          "response": [
            {
              "name": "Exemplo 201",
              "originalRequest": {
                "method": "POST",
                "header": [],
                "url": {
                  "raw": "{{baseUrl}}/v1/envelope-signers",
                  "host": [
                    "{{baseUrl}}"
                  ],
                  "path": [
                    "v1",
                    "envelope-signers"
                  ]
                }
              },
              "status": "OK",
              "code": 201,
              "_postman_previewlanguage": "json",
              "header": [
                {
                  "key": "Content-Type",
                  "value": "application/json"
                }
              ],
              "body": "{\n  \"totalElements\": 2,\n  \"envelopeSigners\": [\n    {\n      \"signerId\": \"3fa85f64-5717-4562-b3fc-2c963f66afa6\",\n      \"envelopeId\": \"3fa85f64-5717-4562-b3fc-2c963f66afa6\",\n      \"order\": 0,\n      \"signatureType\": \"PARTY\",\n      \"status\": \"PENDING\",\n      \"requirePersonalDocument\": false,\n      \"requireEmailToken\": false,\n      \"signer\": {\n        \"fullName\": \"Maria Souza\",\n        \"email\": \"maria@exemplo.com.br\"\n      }\n    }\n  ]\n}"
            }
          ]
        },
        {
          "name": "6. Posicionar campos",
          "event": [
            {
              "listen": "test",
              "script": {
                "type": "text/javascript",
                "exec": [
                  "pm.test('Resposta 2xx', () => pm.expect(pm.response.code).to.be.within(200, 299));",
                  "if (pm.response.code >= 400) {",
                  "  try { console.warn('Erro da API:', JSON.stringify(pm.response.json())); } catch (e) {}",
                  "}",
                  "const tags = pm.response.json().tags || [];",
                  "if (tags[0]) pm.collectionVariables.set('tagId', tags[0].id);"
                ]
              }
            }
          ],
          "request": {
            "method": "POST",
            "header": [
              {
                "key": "Content-Type",
                "value": "application/json"
              },
              {
                "key": "Idempotency-Key",
                "value": "{{$guid}}",
                "description": "Em retry da MESMA operação, reenvie o mesmo valor."
              }
            ],
            "url": {
              "raw": "{{baseUrl}}/v1/tags",
              "host": [
                "{{baseUrl}}"
              ],
              "path": [
                "v1",
                "tags"
              ]
            },
            "description": "Cria campos no documento. Envelope em `DRAFT` ou `BLOCK`.\n\nAceita `Idempotency-Key` (a collection gera um automaticamente).\n\n| Campo | Onde | Tipo | Obrigatório | Descrição |\n|---|---|---|---|---|\n| `envelopeId` | body | uuid | sim | Envelope |\n| `data[].envelopeSignerId` | body | uuid | sim | O `signerId` do signatário. Não usado em `TEXT_BOX` |\n| `data[].envelopeDocumentId` | body | uuid | sim | O `id` do documento |\n| `data[].elementType` | body | enum | sim | `SIGNATURE` (assinatura), `RUBRIC` (rubrica), `FULL_NAME` (nome), `EMAIL`, `SIGNATURE_DATETIME` (data/hora da assinatura), `SELECTION_BOX` (caixa de seleção), `TEXT_BOX` (texto livre, sem signatário) |\n| `data[].page` | body | integer | sim | Página (a partir de 1) |\n| `data[].axisX` | body | number | sim | 0 a 1, da esquerda |\n| `data[].axisY` | body | number | sim | 0 a 1, do topo |\n| `data[].width` | body | number | não | 0.01 a 1 |\n| `data[].height` | body | number | não | 0.01 a 1 |\n| `data[].content` | body | string | não | Texto (para `TEXT_BOX`) |\n| `data[].fontFamily` | body | enum | não | `Helvetica`, `Helvetica-Bold`, `Times-Roman`, `Courier` e variações |\n| `data[].fontSize` | body | integer | não | 6 a 96 |\n| `data[].fontColor` | body | string | não | `#RRGGBB` |\n| `data[].angle` | body | number | não | Padrão 0 |\n\n**Resposta 201**\n\n```json\n{\n  \"totalElements\": 3,\n  \"tags\": [\n    {\n      \"id\": \"3fa85f64-5717-4562-b3fc-2c963f66afa6\",\n      \"envelopeSignerId\": \"3fa85f64-5717-4562-b3fc-2c963f66afa6\",\n      \"envelopeDocumentId\": \"3fa85f64-5717-4562-b3fc-2c963f66afa6\",\n      \"envelopeId\": \"3fa85f64-5717-4562-b3fc-2c963f66afa6\",\n      \"elementType\": \"SIGNATURE\",\n      \"page\": 1,\n      \"axisX\": 0.1,\n      \"axisY\": 0.8,\n      \"width\": 0.15,\n      \"height\": 0.07,\n      \"angle\": 0\n    }\n  ]\n}\n```",
            "body": {
              "mode": "raw",
              "raw": "{\n  \"envelopeId\": \"{{envelopeId}}\",\n  \"data\": [\n    {\n      \"envelopeSignerId\": \"{{signerId}}\",\n      \"envelopeDocumentId\": \"{{documentId}}\",\n      \"elementType\": \"SIGNATURE\",\n      \"page\": 1,\n      \"axisX\": 0.1,\n      \"axisY\": 0.8\n    },\n    {\n      \"envelopeSignerId\": \"{{signerId}}\",\n      \"envelopeDocumentId\": \"{{documentId}}\",\n      \"elementType\": \"FULL_NAME\",\n      \"page\": 1,\n      \"axisX\": 0.1,\n      \"axisY\": 0.88\n    },\n    {\n      \"envelopeSignerId\": \"{{signer2Id}}\",\n      \"envelopeDocumentId\": \"{{documentId}}\",\n      \"elementType\": \"SIGNATURE\",\n      \"page\": 1,\n      \"axisX\": 0.55,\n      \"axisY\": 0.8\n    }\n  ]\n}",
              "options": {
                "raw": {
                  "language": "json"
                }
              }
            }
          },
          "response": [
            {
              "name": "Exemplo 201",
              "originalRequest": {
                "method": "POST",
                "header": [],
                "url": {
                  "raw": "{{baseUrl}}/v1/tags",
                  "host": [
                    "{{baseUrl}}"
                  ],
                  "path": [
                    "v1",
                    "tags"
                  ]
                }
              },
              "status": "OK",
              "code": 201,
              "_postman_previewlanguage": "json",
              "header": [
                {
                  "key": "Content-Type",
                  "value": "application/json"
                }
              ],
              "body": "{\n  \"totalElements\": 3,\n  \"tags\": [\n    {\n      \"id\": \"3fa85f64-5717-4562-b3fc-2c963f66afa6\",\n      \"envelopeSignerId\": \"3fa85f64-5717-4562-b3fc-2c963f66afa6\",\n      \"envelopeDocumentId\": \"3fa85f64-5717-4562-b3fc-2c963f66afa6\",\n      \"envelopeId\": \"3fa85f64-5717-4562-b3fc-2c963f66afa6\",\n      \"elementType\": \"SIGNATURE\",\n      \"page\": 1,\n      \"axisX\": 0.1,\n      \"axisY\": 0.8,\n      \"width\": 0.15,\n      \"height\": 0.07,\n      \"angle\": 0\n    }\n  ]\n}"
            }
          ]
        },
        {
          "name": "7. Lacrar e enviar",
          "event": [
            {
              "listen": "test",
              "script": {
                "type": "text/javascript",
                "exec": [
                  "pm.test('Resposta 2xx', () => pm.expect(pm.response.code).to.be.within(200, 299));",
                  "if (pm.response.code >= 400) {",
                  "  try { console.warn('Erro da API:', JSON.stringify(pm.response.json())); } catch (e) {}",
                  "}"
                ]
              }
            }
          ],
          "request": {
            "method": "PUT",
            "header": [
              {
                "key": "Content-Type",
                "value": "application/json"
              },
              {
                "key": "Idempotency-Key",
                "value": "{{$guid}}",
                "description": "Em retry da MESMA operação, reenvie o mesmo valor."
              }
            ],
            "url": {
              "raw": "{{baseUrl}}/v1/envelopes/close",
              "host": [
                "{{baseUrl}}"
              ],
              "path": [
                "v1",
                "envelopes",
                "close"
              ]
            },
            "description": "Lacra o envelope, **debita os créditos** e dispara os convites aos signatários. Use sempre `Idempotency-Key`: se houver timeout e você repetir com a mesma chave, não há cobrança dupla.\n\nRequisitos: envelope em `DRAFT` (ou `BLOCK`), ao menos 1 documento e 1 signatário, créditos suficientes. Com canal WhatsApp, todo signatário precisa de telefone válido.\n\nA resposta traz o status `CREATED`; em segundos ele passa a `WAITING_SIGNATURE`.\n\nAceita `Idempotency-Key` (a collection gera um automaticamente).\n\n| Campo | Onde | Tipo | Obrigatório | Descrição |\n|---|---|---|---|---|\n| `data[].id` | body | uuid | sim | Envelope |\n\n**Resposta 200**\n\n```json\n{\n  \"totalElements\": 1,\n  \"envelopes\": [\n    {\n      \"id\": \"3fa85f64-5717-4562-b3fc-2c963f66afa6\",\n      \"status\": \"CREATED\"\n    }\n  ]\n}\n```\n\n**Erros comuns**\n\n- 400 `Some Envelope not found in database`: id inexistente ou de outra empresa\n- 400 `Some Envelopes does not have a draft status`\n- 400 `Some Envelope does not have a document`\n- 400 `Some Envelope does not have a signer`\n- 400 `Company does not have enough credit`\n- 400 `Invalid phone number`: canal WhatsApp com signatário sem telefone E.164",
            "body": {
              "mode": "raw",
              "raw": "{\n  \"data\": [\n    {\n      \"id\": \"{{envelopeId}}\"\n    }\n  ]\n}",
              "options": {
                "raw": {
                  "language": "json"
                }
              }
            }
          },
          "response": [
            {
              "name": "Exemplo 200",
              "originalRequest": {
                "method": "PUT",
                "header": [],
                "url": {
                  "raw": "{{baseUrl}}/v1/envelopes/close",
                  "host": [
                    "{{baseUrl}}"
                  ],
                  "path": [
                    "v1",
                    "envelopes",
                    "close"
                  ]
                }
              },
              "status": "OK",
              "code": 200,
              "_postman_previewlanguage": "json",
              "header": [
                {
                  "key": "Content-Type",
                  "value": "application/json"
                }
              ],
              "body": "{\n  \"totalElements\": 1,\n  \"envelopes\": [\n    {\n      \"id\": \"3fa85f64-5717-4562-b3fc-2c963f66afa6\",\n      \"status\": \"CREATED\"\n    }\n  ]\n}"
            }
          ]
        }
      ]
    },
    {
      "name": "03 · Envelope com grupo de signatários",
      "description": "Use um grupo salvo (ex.: diretoria) em vez de cadastrar signatários um a um. Requer um documento já criado (`documentId`, ver fluxo 01 passos 1 e 2).",
      "item": [
        {
          "name": "1. Criar grupo (uma vez)",
          "event": [
            {
              "listen": "test",
              "script": {
                "type": "text/javascript",
                "exec": [
                  "pm.test('Resposta 2xx', () => pm.expect(pm.response.code).to.be.within(200, 299));",
                  "if (pm.response.code >= 400) {",
                  "  try { console.warn('Erro da API:', JSON.stringify(pm.response.json())); } catch (e) {}",
                  "}",
                  "const g = (pm.response.json().entities || [])[0];",
                  "if (g) pm.collectionVariables.set('groupId', g.id);"
                ]
              }
            }
          ],
          "request": {
            "method": "POST",
            "header": [
              {
                "key": "Content-Type",
                "value": "application/json"
              },
              {
                "key": "Idempotency-Key",
                "value": "{{$guid}}",
                "description": "Em retry da MESMA operação, reenvie o mesmo valor."
              }
            ],
            "url": {
              "raw": "{{baseUrl}}/v1/signer-groups",
              "host": [
                "{{baseUrl}}"
              ],
              "path": [
                "v1",
                "signer-groups"
              ]
            },
            "description": "Aceita `Idempotency-Key` (a collection gera um automaticamente).\n\n| Campo | Onde | Tipo | Obrigatório | Descrição |\n|---|---|---|---|---|\n| `data.name` | body | string | sim | 1 a 100 caracteres |\n| `data.members[].fullName` | body | string | sim |  |\n| `data.members[].email` | body | string | sim |  |\n| `data.members[].signatureType` | body | enum | sim | Mesmos tipos de signatário |\n| `data.members[].order` | body | integer | sim | 0 = paralelo |\n\n**Resposta 201**\n\n```json\n{\n  \"totalElements\": 1,\n  \"entities\": [\n    {\n      \"id\": \"3fa85f64-5717-4562-b3fc-2c963f66afa6\",\n      \"name\": \"Diretoria\",\n      \"companyId\": \"3fa85f64-5717-4562-b3fc-2c963f66afa6\",\n      \"members\": [\n        {\n          \"id\": \"3fa85f64-5717-4562-b3fc-2c963f66afa6\",\n          \"fullName\": \"Carlos Mendes\",\n          \"email\": \"carlos@exemplo.com.br\",\n          \"signatureType\": \"PARTY\",\n          \"order\": 0\n        }\n      ]\n    }\n  ]\n}\n```",
            "body": {
              "mode": "raw",
              "raw": "{\n  \"data\": {\n    \"name\": \"Diretoria\",\n    \"members\": [\n      {\n        \"fullName\": \"Carlos Mendes\",\n        \"email\": \"carlos@exemplo.com.br\",\n        \"signatureType\": \"PARTY\",\n        \"order\": 0\n      },\n      {\n        \"fullName\": \"Ana Prado\",\n        \"email\": \"ana@exemplo.com.br\",\n        \"signatureType\": \"APPROVER\",\n        \"order\": 0\n      }\n    ]\n  }\n}",
              "options": {
                "raw": {
                  "language": "json"
                }
              }
            }
          },
          "response": [
            {
              "name": "Exemplo 201",
              "originalRequest": {
                "method": "POST",
                "header": [],
                "url": {
                  "raw": "{{baseUrl}}/v1/signer-groups",
                  "host": [
                    "{{baseUrl}}"
                  ],
                  "path": [
                    "v1",
                    "signer-groups"
                  ]
                }
              },
              "status": "OK",
              "code": 201,
              "_postman_previewlanguage": "json",
              "header": [
                {
                  "key": "Content-Type",
                  "value": "application/json"
                }
              ],
              "body": "{\n  \"totalElements\": 1,\n  \"entities\": [\n    {\n      \"id\": \"3fa85f64-5717-4562-b3fc-2c963f66afa6\",\n      \"name\": \"Diretoria\",\n      \"companyId\": \"3fa85f64-5717-4562-b3fc-2c963f66afa6\",\n      \"members\": [\n        {\n          \"id\": \"3fa85f64-5717-4562-b3fc-2c963f66afa6\",\n          \"fullName\": \"Carlos Mendes\",\n          \"email\": \"carlos@exemplo.com.br\",\n          \"signatureType\": \"PARTY\",\n          \"order\": 0\n        }\n      ]\n    }\n  ]\n}"
            }
          ]
        },
        {
          "name": "2. Criar envelope",
          "event": [
            {
              "listen": "prerequest",
              "script": {
                "type": "text/javascript",
                "exec": [
                  "const d = new Date(Date.now() + 15 * 24 * 3600 * 1000);",
                  "pm.collectionVariables.set('expiredAt', d.toISOString());"
                ]
              }
            },
            {
              "listen": "test",
              "script": {
                "type": "text/javascript",
                "exec": [
                  "pm.test('Resposta 2xx', () => pm.expect(pm.response.code).to.be.within(200, 299));",
                  "if (pm.response.code >= 400) {",
                  "  try { console.warn('Erro da API:', JSON.stringify(pm.response.json())); } catch (e) {}",
                  "}",
                  "const env = (pm.response.json().envelopes || [])[0];",
                  "if (env) { pm.collectionVariables.set('envelopeId', env.id); if (env.companyId) pm.collectionVariables.set('companyId', env.companyId); }"
                ]
              }
            }
          ],
          "request": {
            "method": "POST",
            "header": [
              {
                "key": "Content-Type",
                "value": "application/json"
              },
              {
                "key": "Idempotency-Key",
                "value": "{{$guid}}",
                "description": "Em retry da MESMA operação, reenvie o mesmo valor."
              }
            ],
            "url": {
              "raw": "{{baseUrl}}/v1/envelopes",
              "host": [
                "{{baseUrl}}"
              ],
              "path": [
                "v1",
                "envelopes"
              ]
            },
            "description": "Cria um ou mais envelopes em `DRAFT`. `title` precisa ser único dentro da requisição.\n\nAceita `Idempotency-Key` (a collection gera um automaticamente).\n\n| Campo | Onde | Tipo | Obrigatório | Descrição |\n|---|---|---|---|---|\n| `data[].title` | body | string | sim | Título |\n| `data[].description` | body | string | sim | Descrição |\n| `data[].expiredAt` | body | ISO 8601 | não | Prazo para assinar. No mínimo amanhã |\n| `data[].notificationChannel` | body | enum | não | `EMAIL` (padrão) ou `WHATSAPP`. Com WhatsApp, todo signatário precisa de `phone` e há consumo de créditos de notificação |\n| `data[].validationByIcp` | body | boolean | não | Assinatura com certificado ICP-Brasil. Só se a empresa tiver ICP liberado |\n| `data[].folderId` | body | uuid | não | Pasta onde o envelope fica |\n| `data[].allowAutoResend` | body | boolean | não | Reenviar o convite automaticamente a quem não assinou |\n| `data[].resendIntervalDays` | body | string | não | Intervalo do reenvio automático, em dias (ex.: `\"3\"`) |\n\n**Resposta 201**\n\n```json\n{\n  \"totalElements\": 1,\n  \"envelopes\": [\n    {\n      \"id\": \"3fa85f64-5717-4562-b3fc-2c963f66afa6\",\n      \"title\": \"Contrato de Prestação de Serviços\",\n      \"description\": \"Contrato anual com a empresa X\",\n      \"status\": \"DRAFT\",\n      \"companyId\": \"3fa85f64-5717-4562-b3fc-2c963f66afa6\",\n      \"expiredAt\": \"2026-10-28T12:00:00.000Z\",\n      \"notificationChannel\": \"EMAIL\",\n      \"validationByIcp\": false,\n      \"createdAt\": \"2026-10-13T12:00:00.000Z\"\n    }\n  ]\n}\n```\n\n**Erros comuns**\n\n- 400 `Company not authorized`: `validationByIcp` sem ICP liberado\n- 400 data de expiração anterior a amanhã",
            "body": {
              "mode": "raw",
              "raw": "{\n  \"data\": [\n    {\n      \"title\": \"Contrato de Prestação de Serviços\",\n      \"description\": \"Contrato anual com a empresa X\",\n      \"expiredAt\": \"{{expiredAt}}\",\n      \"notificationChannel\": \"EMAIL\"\n    }\n  ]\n}",
              "options": {
                "raw": {
                  "language": "json"
                }
              }
            }
          },
          "response": [
            {
              "name": "Exemplo 201",
              "originalRequest": {
                "method": "POST",
                "header": [],
                "url": {
                  "raw": "{{baseUrl}}/v1/envelopes",
                  "host": [
                    "{{baseUrl}}"
                  ],
                  "path": [
                    "v1",
                    "envelopes"
                  ]
                }
              },
              "status": "OK",
              "code": 201,
              "_postman_previewlanguage": "json",
              "header": [
                {
                  "key": "Content-Type",
                  "value": "application/json"
                }
              ],
              "body": "{\n  \"totalElements\": 1,\n  \"envelopes\": [\n    {\n      \"id\": \"3fa85f64-5717-4562-b3fc-2c963f66afa6\",\n      \"title\": \"Contrato de Prestação de Serviços\",\n      \"description\": \"Contrato anual com a empresa X\",\n      \"status\": \"DRAFT\",\n      \"companyId\": \"3fa85f64-5717-4562-b3fc-2c963f66afa6\",\n      \"expiredAt\": \"2026-10-28T12:00:00.000Z\",\n      \"notificationChannel\": \"EMAIL\",\n      \"validationByIcp\": false,\n      \"createdAt\": \"2026-10-13T12:00:00.000Z\"\n    }\n  ]\n}"
            }
          ]
        },
        {
          "name": "3. Vincular documento",
          "event": [
            {
              "listen": "test",
              "script": {
                "type": "text/javascript",
                "exec": [
                  "pm.test('Resposta 2xx', () => pm.expect(pm.response.code).to.be.within(200, 299));",
                  "if (pm.response.code >= 400) {",
                  "  try { console.warn('Erro da API:', JSON.stringify(pm.response.json())); } catch (e) {}",
                  "}"
                ]
              }
            }
          ],
          "request": {
            "method": "POST",
            "header": [
              {
                "key": "Content-Type",
                "value": "application/json"
              },
              {
                "key": "Idempotency-Key",
                "value": "{{$guid}}",
                "description": "Em retry da MESMA operação, reenvie o mesmo valor."
              }
            ],
            "url": {
              "raw": "{{baseUrl}}/v1/envelopes/set/documents",
              "host": [
                "{{baseUrl}}"
              ],
              "path": [
                "v1",
                "envelopes",
                "set",
                "documents"
              ]
            },
            "description": "Coloca documentos dentro do envelope. O envelope precisa estar em `DRAFT` (ou `BLOCK`). A ordem do array `documents` é a ordem no envelope.\n\nPara **desvincular**, use a mesma rota com `remove` no lugar de `set`: `POST /v1/envelopes/remove/documents`.\n\nAceita `Idempotency-Key` (a collection gera um automaticamente).\n\n| Campo | Onde | Tipo | Obrigatório | Descrição |\n|---|---|---|---|---|\n| `method` | path | enum | sim | `set` (vincular) ou `remove` (desvincular) |\n| `data[].envelopeId` | body | uuid | sim | Envelope |\n| `data[].documents[].id` | body | uuid | sim | Documento |\n\n**Resposta 201**\n\n```json\n{\n  \"totalElements\": 1,\n  \"entities\": [\n    {\n      \"envelopeId\": \"3fa85f64-5717-4562-b3fc-2c963f66afa6\",\n      \"originalDocumentId\": \"3fa85f64-5717-4562-b3fc-2c963f66afa6\",\n      \"order\": 1\n    }\n  ]\n}\n```\n\n**Erros comuns**\n\n- 400 `Document already in envelope`\n- 400 envelope fora de `DRAFT`/`BLOCK`",
            "body": {
              "mode": "raw",
              "raw": "{\n  \"data\": [\n    {\n      \"envelopeId\": \"{{envelopeId}}\",\n      \"documents\": [\n        {\n          \"id\": \"{{documentId}}\"\n        }\n      ]\n    }\n  ]\n}",
              "options": {
                "raw": {
                  "language": "json"
                }
              }
            }
          },
          "response": [
            {
              "name": "Exemplo 201",
              "originalRequest": {
                "method": "POST",
                "header": [],
                "url": {
                  "raw": "{{baseUrl}}/v1/envelopes/set/documents",
                  "host": [
                    "{{baseUrl}}"
                  ],
                  "path": [
                    "v1",
                    "envelopes",
                    "set",
                    "documents"
                  ]
                }
              },
              "status": "OK",
              "code": 201,
              "_postman_previewlanguage": "json",
              "header": [
                {
                  "key": "Content-Type",
                  "value": "application/json"
                }
              ],
              "body": "{\n  \"totalElements\": 1,\n  \"entities\": [\n    {\n      \"envelopeId\": \"3fa85f64-5717-4562-b3fc-2c963f66afa6\",\n      \"originalDocumentId\": \"3fa85f64-5717-4562-b3fc-2c963f66afa6\",\n      \"order\": 1\n    }\n  ]\n}"
            }
          ]
        },
        {
          "name": "4. Importar o grupo",
          "event": [
            {
              "listen": "test",
              "script": {
                "type": "text/javascript",
                "exec": [
                  "pm.test('Resposta 2xx', () => pm.expect(pm.response.code).to.be.within(200, 299));",
                  "if (pm.response.code >= 400) {",
                  "  try { console.warn('Erro da API:', JSON.stringify(pm.response.json())); } catch (e) {}",
                  "}"
                ]
              }
            }
          ],
          "request": {
            "method": "POST",
            "header": [
              {
                "key": "Content-Type",
                "value": "application/json"
              },
              {
                "key": "Idempotency-Key",
                "value": "{{$guid}}",
                "description": "Em retry da MESMA operação, reenvie o mesmo valor."
              }
            ],
            "url": {
              "raw": "{{baseUrl}}/v1/signer-groups/import",
              "host": [
                "{{baseUrl}}"
              ],
              "path": [
                "v1",
                "signer-groups",
                "import"
              ]
            },
            "description": "Adiciona os membros do grupo como signatários do envelope (`DRAFT`). Quem já está no envelope é ignorado.\n\nAceita `Idempotency-Key` (a collection gera um automaticamente).\n\n| Campo | Onde | Tipo | Obrigatório | Descrição |\n|---|---|---|---|---|\n| `data.groupId` | body | uuid | sim | Grupo |\n| `data.envelopeId` | body | uuid | sim | Envelope |\n\n**Resposta 201**\n\n```json\n{\n  \"totalElements\": 2,\n  \"entities\": [\n    {\n      \"envelopeId\": \"3fa85f64-5717-4562-b3fc-2c963f66afa6\",\n      \"signerId\": \"3fa85f64-5717-4562-b3fc-2c963f66afa6\",\n      \"signatureType\": \"PARTY\",\n      \"order\": 0,\n      \"status\": \"PENDING\"\n    }\n  ]\n}\n```\n\n**Erros comuns**\n\n- 400 `Envelope must be in DRAFT status`\n- 400 `No new signers to import`\n- 404 grupo ou envelope não encontrado",
            "body": {
              "mode": "raw",
              "raw": "{\n  \"data\": {\n    \"groupId\": \"{{groupId}}\",\n    \"envelopeId\": \"{{envelopeId}}\"\n  }\n}",
              "options": {
                "raw": {
                  "language": "json"
                }
              }
            }
          },
          "response": [
            {
              "name": "Exemplo 201",
              "originalRequest": {
                "method": "POST",
                "header": [],
                "url": {
                  "raw": "{{baseUrl}}/v1/signer-groups/import",
                  "host": [
                    "{{baseUrl}}"
                  ],
                  "path": [
                    "v1",
                    "signer-groups",
                    "import"
                  ]
                }
              },
              "status": "OK",
              "code": 201,
              "_postman_previewlanguage": "json",
              "header": [
                {
                  "key": "Content-Type",
                  "value": "application/json"
                }
              ],
              "body": "{\n  \"totalElements\": 2,\n  \"entities\": [\n    {\n      \"envelopeId\": \"3fa85f64-5717-4562-b3fc-2c963f66afa6\",\n      \"signerId\": \"3fa85f64-5717-4562-b3fc-2c963f66afa6\",\n      \"signatureType\": \"PARTY\",\n      \"order\": 0,\n      \"status\": \"PENDING\"\n    }\n  ]\n}"
            }
          ]
        },
        {
          "name": "5. Conferir signatários",
          "event": [
            {
              "listen": "test",
              "script": {
                "type": "text/javascript",
                "exec": [
                  "pm.test('Resposta 2xx', () => pm.expect(pm.response.code).to.be.within(200, 299));",
                  "if (pm.response.code >= 400) {",
                  "  try { console.warn('Erro da API:', JSON.stringify(pm.response.json())); } catch (e) {}",
                  "}",
                  "const list = pm.response.json().envelopeSigners || [];",
                  "if (list[0]) pm.collectionVariables.set('signerId', list[0].signerId);",
                  "if (list[1]) pm.collectionVariables.set('signer2Id', list[1].signerId);"
                ]
              }
            }
          ],
          "request": {
            "method": "GET",
            "header": [],
            "url": {
              "raw": "{{baseUrl}}/v1/envelope-signers?envelopeId={{envelopeId}}",
              "host": [
                "{{baseUrl}}"
              ],
              "path": [
                "v1",
                "envelope-signers"
              ],
              "query": [
                {
                  "key": "envelopeId",
                  "value": "{{envelopeId}}"
                }
              ]
            },
            "description": "Lista os signatários de um envelope, na ordem de assinatura, com o status de cada um.\n\n| Campo | Onde | Tipo | Obrigatório | Descrição |\n|---|---|---|---|---|\n| `envelopeId` | query | uuid | sim | Envelope |\n\n**Resposta 200**\n\n```json\n{\n  \"totalElements\": 2,\n  \"envelopeSigners\": [\n    {\n      \"signerId\": \"3fa85f64-5717-4562-b3fc-2c963f66afa6\",\n      \"envelopeId\": \"3fa85f64-5717-4562-b3fc-2c963f66afa6\",\n      \"order\": 0,\n      \"signatureType\": \"PARTY\",\n      \"status\": \"COMPLETED\",\n      \"requirePersonalDocument\": false,\n      \"requireEmailToken\": false,\n      \"createdAt\": \"2026-10-13T12:00:00.000Z\",\n      \"updatedAt\": \"2026-10-13T15:42:00.000Z\",\n      \"signer\": {\n        \"id\": \"3fa85f64-5717-4562-b3fc-2c963f66afa6\",\n        \"fullName\": \"Maria Souza\",\n        \"email\": \"maria@exemplo.com.br\",\n        \"phone\": \"+5511999999999\"\n      }\n    }\n  ]\n}\n```\n\n**Erros comuns**\n\n- 400 `Envelope not found`"
          },
          "response": [
            {
              "name": "Exemplo 200",
              "originalRequest": {
                "method": "GET",
                "header": [],
                "url": {
                  "raw": "{{baseUrl}}/v1/envelope-signers?envelopeId={{envelopeId}}",
                  "host": [
                    "{{baseUrl}}"
                  ],
                  "path": [
                    "v1",
                    "envelope-signers"
                  ],
                  "query": [
                    {
                      "key": "envelopeId",
                      "value": "{{envelopeId}}"
                    }
                  ]
                }
              },
              "status": "OK",
              "code": 200,
              "_postman_previewlanguage": "json",
              "header": [
                {
                  "key": "Content-Type",
                  "value": "application/json"
                }
              ],
              "body": "{\n  \"totalElements\": 2,\n  \"envelopeSigners\": [\n    {\n      \"signerId\": \"3fa85f64-5717-4562-b3fc-2c963f66afa6\",\n      \"envelopeId\": \"3fa85f64-5717-4562-b3fc-2c963f66afa6\",\n      \"order\": 0,\n      \"signatureType\": \"PARTY\",\n      \"status\": \"COMPLETED\",\n      \"requirePersonalDocument\": false,\n      \"requireEmailToken\": false,\n      \"createdAt\": \"2026-10-13T12:00:00.000Z\",\n      \"updatedAt\": \"2026-10-13T15:42:00.000Z\",\n      \"signer\": {\n        \"id\": \"3fa85f64-5717-4562-b3fc-2c963f66afa6\",\n        \"fullName\": \"Maria Souza\",\n        \"email\": \"maria@exemplo.com.br\",\n        \"phone\": \"+5511999999999\"\n      }\n    }\n  ]\n}"
            }
          ]
        },
        {
          "name": "6. Posicionar campos",
          "event": [
            {
              "listen": "test",
              "script": {
                "type": "text/javascript",
                "exec": [
                  "pm.test('Resposta 2xx', () => pm.expect(pm.response.code).to.be.within(200, 299));",
                  "if (pm.response.code >= 400) {",
                  "  try { console.warn('Erro da API:', JSON.stringify(pm.response.json())); } catch (e) {}",
                  "}",
                  "const tags = pm.response.json().tags || [];",
                  "if (tags[0]) pm.collectionVariables.set('tagId', tags[0].id);"
                ]
              }
            }
          ],
          "request": {
            "method": "POST",
            "header": [
              {
                "key": "Content-Type",
                "value": "application/json"
              },
              {
                "key": "Idempotency-Key",
                "value": "{{$guid}}",
                "description": "Em retry da MESMA operação, reenvie o mesmo valor."
              }
            ],
            "url": {
              "raw": "{{baseUrl}}/v1/tags",
              "host": [
                "{{baseUrl}}"
              ],
              "path": [
                "v1",
                "tags"
              ]
            },
            "description": "Cria campos no documento. Envelope em `DRAFT` ou `BLOCK`.\n\nAceita `Idempotency-Key` (a collection gera um automaticamente).\n\n| Campo | Onde | Tipo | Obrigatório | Descrição |\n|---|---|---|---|---|\n| `envelopeId` | body | uuid | sim | Envelope |\n| `data[].envelopeSignerId` | body | uuid | sim | O `signerId` do signatário. Não usado em `TEXT_BOX` |\n| `data[].envelopeDocumentId` | body | uuid | sim | O `id` do documento |\n| `data[].elementType` | body | enum | sim | `SIGNATURE` (assinatura), `RUBRIC` (rubrica), `FULL_NAME` (nome), `EMAIL`, `SIGNATURE_DATETIME` (data/hora da assinatura), `SELECTION_BOX` (caixa de seleção), `TEXT_BOX` (texto livre, sem signatário) |\n| `data[].page` | body | integer | sim | Página (a partir de 1) |\n| `data[].axisX` | body | number | sim | 0 a 1, da esquerda |\n| `data[].axisY` | body | number | sim | 0 a 1, do topo |\n| `data[].width` | body | number | não | 0.01 a 1 |\n| `data[].height` | body | number | não | 0.01 a 1 |\n| `data[].content` | body | string | não | Texto (para `TEXT_BOX`) |\n| `data[].fontFamily` | body | enum | não | `Helvetica`, `Helvetica-Bold`, `Times-Roman`, `Courier` e variações |\n| `data[].fontSize` | body | integer | não | 6 a 96 |\n| `data[].fontColor` | body | string | não | `#RRGGBB` |\n| `data[].angle` | body | number | não | Padrão 0 |\n\n**Resposta 201**\n\n```json\n{\n  \"totalElements\": 3,\n  \"tags\": [\n    {\n      \"id\": \"3fa85f64-5717-4562-b3fc-2c963f66afa6\",\n      \"envelopeSignerId\": \"3fa85f64-5717-4562-b3fc-2c963f66afa6\",\n      \"envelopeDocumentId\": \"3fa85f64-5717-4562-b3fc-2c963f66afa6\",\n      \"envelopeId\": \"3fa85f64-5717-4562-b3fc-2c963f66afa6\",\n      \"elementType\": \"SIGNATURE\",\n      \"page\": 1,\n      \"axisX\": 0.1,\n      \"axisY\": 0.8,\n      \"width\": 0.15,\n      \"height\": 0.07,\n      \"angle\": 0\n    }\n  ]\n}\n```",
            "body": {
              "mode": "raw",
              "raw": "{\n  \"envelopeId\": \"{{envelopeId}}\",\n  \"data\": [\n    {\n      \"envelopeSignerId\": \"{{signerId}}\",\n      \"envelopeDocumentId\": \"{{documentId}}\",\n      \"elementType\": \"SIGNATURE\",\n      \"page\": 1,\n      \"axisX\": 0.1,\n      \"axisY\": 0.8\n    },\n    {\n      \"envelopeSignerId\": \"{{signerId}}\",\n      \"envelopeDocumentId\": \"{{documentId}}\",\n      \"elementType\": \"FULL_NAME\",\n      \"page\": 1,\n      \"axisX\": 0.1,\n      \"axisY\": 0.88\n    },\n    {\n      \"envelopeSignerId\": \"{{signer2Id}}\",\n      \"envelopeDocumentId\": \"{{documentId}}\",\n      \"elementType\": \"SIGNATURE\",\n      \"page\": 1,\n      \"axisX\": 0.55,\n      \"axisY\": 0.8\n    }\n  ]\n}",
              "options": {
                "raw": {
                  "language": "json"
                }
              }
            }
          },
          "response": [
            {
              "name": "Exemplo 201",
              "originalRequest": {
                "method": "POST",
                "header": [],
                "url": {
                  "raw": "{{baseUrl}}/v1/tags",
                  "host": [
                    "{{baseUrl}}"
                  ],
                  "path": [
                    "v1",
                    "tags"
                  ]
                }
              },
              "status": "OK",
              "code": 201,
              "_postman_previewlanguage": "json",
              "header": [
                {
                  "key": "Content-Type",
                  "value": "application/json"
                }
              ],
              "body": "{\n  \"totalElements\": 3,\n  \"tags\": [\n    {\n      \"id\": \"3fa85f64-5717-4562-b3fc-2c963f66afa6\",\n      \"envelopeSignerId\": \"3fa85f64-5717-4562-b3fc-2c963f66afa6\",\n      \"envelopeDocumentId\": \"3fa85f64-5717-4562-b3fc-2c963f66afa6\",\n      \"envelopeId\": \"3fa85f64-5717-4562-b3fc-2c963f66afa6\",\n      \"elementType\": \"SIGNATURE\",\n      \"page\": 1,\n      \"axisX\": 0.1,\n      \"axisY\": 0.8,\n      \"width\": 0.15,\n      \"height\": 0.07,\n      \"angle\": 0\n    }\n  ]\n}"
            }
          ]
        },
        {
          "name": "7. Lacrar e enviar",
          "event": [
            {
              "listen": "test",
              "script": {
                "type": "text/javascript",
                "exec": [
                  "pm.test('Resposta 2xx', () => pm.expect(pm.response.code).to.be.within(200, 299));",
                  "if (pm.response.code >= 400) {",
                  "  try { console.warn('Erro da API:', JSON.stringify(pm.response.json())); } catch (e) {}",
                  "}"
                ]
              }
            }
          ],
          "request": {
            "method": "PUT",
            "header": [
              {
                "key": "Content-Type",
                "value": "application/json"
              },
              {
                "key": "Idempotency-Key",
                "value": "{{$guid}}",
                "description": "Em retry da MESMA operação, reenvie o mesmo valor."
              }
            ],
            "url": {
              "raw": "{{baseUrl}}/v1/envelopes/close",
              "host": [
                "{{baseUrl}}"
              ],
              "path": [
                "v1",
                "envelopes",
                "close"
              ]
            },
            "description": "Lacra o envelope, **debita os créditos** e dispara os convites aos signatários. Use sempre `Idempotency-Key`: se houver timeout e você repetir com a mesma chave, não há cobrança dupla.\n\nRequisitos: envelope em `DRAFT` (ou `BLOCK`), ao menos 1 documento e 1 signatário, créditos suficientes. Com canal WhatsApp, todo signatário precisa de telefone válido.\n\nA resposta traz o status `CREATED`; em segundos ele passa a `WAITING_SIGNATURE`.\n\nAceita `Idempotency-Key` (a collection gera um automaticamente).\n\n| Campo | Onde | Tipo | Obrigatório | Descrição |\n|---|---|---|---|---|\n| `data[].id` | body | uuid | sim | Envelope |\n\n**Resposta 200**\n\n```json\n{\n  \"totalElements\": 1,\n  \"envelopes\": [\n    {\n      \"id\": \"3fa85f64-5717-4562-b3fc-2c963f66afa6\",\n      \"status\": \"CREATED\"\n    }\n  ]\n}\n```\n\n**Erros comuns**\n\n- 400 `Some Envelope not found in database`: id inexistente ou de outra empresa\n- 400 `Some Envelopes does not have a draft status`\n- 400 `Some Envelope does not have a document`\n- 400 `Some Envelope does not have a signer`\n- 400 `Company does not have enough credit`\n- 400 `Invalid phone number`: canal WhatsApp com signatário sem telefone E.164",
            "body": {
              "mode": "raw",
              "raw": "{\n  \"data\": [\n    {\n      \"id\": \"{{envelopeId}}\"\n    }\n  ]\n}",
              "options": {
                "raw": {
                  "language": "json"
                }
              }
            }
          },
          "response": [
            {
              "name": "Exemplo 200",
              "originalRequest": {
                "method": "PUT",
                "header": [],
                "url": {
                  "raw": "{{baseUrl}}/v1/envelopes/close",
                  "host": [
                    "{{baseUrl}}"
                  ],
                  "path": [
                    "v1",
                    "envelopes",
                    "close"
                  ]
                }
              },
              "status": "OK",
              "code": 200,
              "_postman_previewlanguage": "json",
              "header": [
                {
                  "key": "Content-Type",
                  "value": "application/json"
                }
              ],
              "body": "{\n  \"totalElements\": 1,\n  \"envelopes\": [\n    {\n      \"id\": \"3fa85f64-5717-4562-b3fc-2c963f66afa6\",\n      \"status\": \"CREATED\"\n    }\n  ]\n}"
            }
          ]
        }
      ]
    },
    {
      "name": "04 · Envio em massa (lote)",
      "description": "Um envelope por signatário variável, com os mesmos documentos e signatários fixos. Para adicionar mais signatários, repita o passo 4 trocando e-mail e nome (`fixed: true` para quem assina todos).",
      "item": [
        {
          "name": "1. Criar lote",
          "event": [
            {
              "listen": "test",
              "script": {
                "type": "text/javascript",
                "exec": [
                  "pm.test('Resposta 2xx', () => pm.expect(pm.response.code).to.be.within(200, 299));",
                  "if (pm.response.code >= 400) {",
                  "  try { console.warn('Erro da API:', JSON.stringify(pm.response.json())); } catch (e) {}",
                  "}",
                  "const b = (pm.response.json().entities || [])[0];",
                  "if (b) { pm.collectionVariables.set('batchId', b.id); if (b.companyId) pm.collectionVariables.set('companyId', b.companyId); }"
                ]
              }
            }
          ],
          "request": {
            "method": "POST",
            "header": [
              {
                "key": "Content-Type",
                "value": "application/json"
              },
              {
                "key": "Idempotency-Key",
                "value": "{{$guid}}",
                "description": "Em retry da MESMA operação, reenvie o mesmo valor."
              }
            ],
            "url": {
              "raw": "{{baseUrl}}/v1/batches",
              "host": [
                "{{baseUrl}}"
              ],
              "path": [
                "v1",
                "batches"
              ]
            },
            "description": "Aceita `Idempotency-Key` (a collection gera um automaticamente).\n\n| Campo | Onde | Tipo | Obrigatório | Descrição |\n|---|---|---|---|---|\n| `data.name` | body | string | sim |  |\n| `data.description` | body | string | sim |  |\n\n**Resposta 201**\n\n```json\n{\n  \"totalElements\": 1,\n  \"entities\": [\n    {\n      \"id\": \"3fa85f64-5717-4562-b3fc-2c963f66afa6\",\n      \"name\": \"Termo de confidencialidade - Out/2026\",\n      \"description\": \"Envio para todos os colaboradores\",\n      \"companyId\": \"3fa85f64-5717-4562-b3fc-2c963f66afa6\",\n      \"status\": \"DRAFT\"\n    }\n  ]\n}\n```",
            "body": {
              "mode": "raw",
              "raw": "{\n  \"data\": {\n    \"name\": \"Termo de confidencialidade - Out/2026\",\n    \"description\": \"Envio para todos os colaboradores\"\n  }\n}",
              "options": {
                "raw": {
                  "language": "json"
                }
              }
            }
          },
          "response": [
            {
              "name": "Exemplo 201",
              "originalRequest": {
                "method": "POST",
                "header": [],
                "url": {
                  "raw": "{{baseUrl}}/v1/batches",
                  "host": [
                    "{{baseUrl}}"
                  ],
                  "path": [
                    "v1",
                    "batches"
                  ]
                }
              },
              "status": "OK",
              "code": 201,
              "_postman_previewlanguage": "json",
              "header": [
                {
                  "key": "Content-Type",
                  "value": "application/json"
                }
              ],
              "body": "{\n  \"totalElements\": 1,\n  \"entities\": [\n    {\n      \"id\": \"3fa85f64-5717-4562-b3fc-2c963f66afa6\",\n      \"name\": \"Termo de confidencialidade - Out/2026\",\n      \"description\": \"Envio para todos os colaboradores\",\n      \"companyId\": \"3fa85f64-5717-4562-b3fc-2c963f66afa6\",\n      \"status\": \"DRAFT\"\n    }\n  ]\n}"
            }
          ]
        },
        {
          "name": "2. Adicionar documento",
          "event": [
            {
              "listen": "test",
              "script": {
                "type": "text/javascript",
                "exec": [
                  "pm.test('Resposta 2xx', () => pm.expect(pm.response.code).to.be.within(200, 299));",
                  "if (pm.response.code >= 400) {",
                  "  try { console.warn('Erro da API:', JSON.stringify(pm.response.json())); } catch (e) {}",
                  "}",
                  "const b = pm.response.json();",
                  "const doc = (b.documents || b.data?.documents || [])[0];",
                  "if (doc) { pm.collectionVariables.set('batchDocumentId', doc.id); pm.collectionVariables.set('uploadUrl', doc.url); }"
                ]
              }
            }
          ],
          "request": {
            "method": "POST",
            "header": [
              {
                "key": "Content-Type",
                "value": "application/json"
              },
              {
                "key": "Idempotency-Key",
                "value": "{{$guid}}",
                "description": "Em retry da MESMA operação, reenvie o mesmo valor."
              }
            ],
            "url": {
              "raw": "{{baseUrl}}/v1/batches-document",
              "host": [
                "{{baseUrl}}"
              ],
              "path": [
                "v1",
                "batches-document"
              ]
            },
            "description": "Cria o documento do lote e devolve a URL de upload (5 minutos). Envie o PDF com `PUT` nessa URL, igual a Documentos.\n\nAceita `Idempotency-Key` (a collection gera um automaticamente).\n\n| Campo | Onde | Tipo | Obrigatório | Descrição |\n|---|---|---|---|---|\n| `data.batchId` | body | uuid | sim | Lote |\n| `data.alias` | body | string | sim | Nome do documento |\n\n**Resposta 201**\n\n```json\n{\n  \"statusCode\": 201,\n  \"message\": \"Successfully create document\",\n  \"data\": {\n    \"documents\": [\n      {\n        \"id\": \"3fa85f64-5717-4562-b3fc-2c963f66afa6\",\n        \"alias\": \"Termo de confidencialidade.pdf\",\n        \"url\": \"https://<bucket>.s3.amazonaws.com/...?X-Amz-Expires=300&...\"\n      }\n    ]\n  }\n}\n```",
            "body": {
              "mode": "raw",
              "raw": "{\n  \"data\": {\n    \"batchId\": \"{{batchId}}\",\n    \"alias\": \"Termo de confidencialidade.pdf\"\n  }\n}",
              "options": {
                "raw": {
                  "language": "json"
                }
              }
            }
          },
          "response": [
            {
              "name": "Exemplo 201",
              "originalRequest": {
                "method": "POST",
                "header": [],
                "url": {
                  "raw": "{{baseUrl}}/v1/batches-document",
                  "host": [
                    "{{baseUrl}}"
                  ],
                  "path": [
                    "v1",
                    "batches-document"
                  ]
                }
              },
              "status": "OK",
              "code": 201,
              "_postman_previewlanguage": "json",
              "header": [
                {
                  "key": "Content-Type",
                  "value": "application/json"
                }
              ],
              "body": "{\n  \"statusCode\": 201,\n  \"message\": \"Successfully create document\",\n  \"data\": {\n    \"documents\": [\n      {\n        \"id\": \"3fa85f64-5717-4562-b3fc-2c963f66afa6\",\n        \"alias\": \"Termo de confidencialidade.pdf\",\n        \"url\": \"https://<bucket>.s3.amazonaws.com/...?X-Amz-Expires=300&...\"\n      }\n    ]\n  }\n}"
            }
          ]
        },
        {
          "name": "3. Enviar o PDF (Body → binary)",
          "event": [
            {
              "listen": "test",
              "script": {
                "type": "text/javascript",
                "exec": [
                  "pm.test('Resposta 2xx', () => pm.expect(pm.response.code).to.be.within(200, 299));",
                  "if (pm.response.code >= 400) {",
                  "  try { console.warn('Erro da API:', JSON.stringify(pm.response.json())); } catch (e) {}",
                  "}"
                ]
              }
            }
          ],
          "request": {
            "method": "PUT",
            "header": [
              {
                "key": "Content-Type",
                "value": "application/pdf"
              }
            ],
            "url": {
              "raw": "{{uploadUrl}}"
            },
            "description": "Corpo binário com o PDF, sem `Authorization`. Mesmas regras do upload de documentos.\n\n**Resposta:** 200 com corpo vazio.",
            "body": {
              "mode": "file",
              "file": {
                "src": ""
              }
            },
            "auth": {
              "type": "noauth"
            }
          },
          "response": []
        },
        {
          "name": "4. Adicionar signatário variável",
          "event": [
            {
              "listen": "test",
              "script": {
                "type": "text/javascript",
                "exec": [
                  "pm.test('Resposta 2xx', () => pm.expect(pm.response.code).to.be.within(200, 299));",
                  "if (pm.response.code >= 400) {",
                  "  try { console.warn('Erro da API:', JSON.stringify(pm.response.json())); } catch (e) {}",
                  "}",
                  "const s = (pm.response.json().entities || [])[0];",
                  "if (s) pm.collectionVariables.set('batchSignerId', s.signerId);"
                ]
              }
            }
          ],
          "request": {
            "method": "POST",
            "header": [
              {
                "key": "Content-Type",
                "value": "application/json"
              },
              {
                "key": "Idempotency-Key",
                "value": "{{$guid}}",
                "description": "Em retry da MESMA operação, reenvie o mesmo valor."
              }
            ],
            "url": {
              "raw": "{{baseUrl}}/v1/batches-signer",
              "host": [
                "{{baseUrl}}"
              ],
              "path": [
                "v1",
                "batches-signer"
              ]
            },
            "description": "Adicione um por chamada. `fixed: true` = entra em todos os envelopes (ex.: o RH). `fixed: false` = cada um gera um envelope.\n\nAceita `Idempotency-Key` (a collection gera um automaticamente).\n\n| Campo | Onde | Tipo | Obrigatório | Descrição |\n|---|---|---|---|---|\n| `data.batchId` | body | uuid | sim | Lote |\n| `data.email` | body | string | sim |  |\n| `data.fullName` | body | string | não |  |\n| `data.signatureType` | body | enum | sim | Tipos de signatário, exceto `CARBON_COPY` |\n| `data.fixed` | body | boolean | não | Padrão `false` |\n| `data.order` | body | integer | não |  |\n| `data.requirePersonalDocument` | body | boolean | não | Padrão `false` |\n| `data.requireEmailToken` | body | boolean | não | Padrão `false` |\n\n**Resposta 201**\n\n```json\n{\n  \"totalElements\": 1,\n  \"entities\": [\n    {\n      \"id\": \"3fa85f64-5717-4562-b3fc-2c963f66afa6\",\n      \"batchId\": \"3fa85f64-5717-4562-b3fc-2c963f66afa6\",\n      \"signerId\": \"3fa85f64-5717-4562-b3fc-2c963f66afa6\",\n      \"fixed\": false\n    }\n  ]\n}\n```",
            "body": {
              "mode": "raw",
              "raw": "{\n  \"data\": {\n    \"batchId\": \"{{batchId}}\",\n    \"fixed\": false,\n    \"signatureType\": \"PARTY\",\n    \"email\": \"colaborador1@exemplo.com.br\",\n    \"fullName\": \"Colaborador Um\"\n  }\n}",
              "options": {
                "raw": {
                  "language": "json"
                }
              }
            }
          },
          "response": [
            {
              "name": "Exemplo 201",
              "originalRequest": {
                "method": "POST",
                "header": [],
                "url": {
                  "raw": "{{baseUrl}}/v1/batches-signer",
                  "host": [
                    "{{baseUrl}}"
                  ],
                  "path": [
                    "v1",
                    "batches-signer"
                  ]
                }
              },
              "status": "OK",
              "code": 201,
              "_postman_previewlanguage": "json",
              "header": [
                {
                  "key": "Content-Type",
                  "value": "application/json"
                }
              ],
              "body": "{\n  \"totalElements\": 1,\n  \"entities\": [\n    {\n      \"id\": \"3fa85f64-5717-4562-b3fc-2c963f66afa6\",\n      \"batchId\": \"3fa85f64-5717-4562-b3fc-2c963f66afa6\",\n      \"signerId\": \"3fa85f64-5717-4562-b3fc-2c963f66afa6\",\n      \"fixed\": false\n    }\n  ]\n}"
            }
          ]
        },
        {
          "name": "4b. Adicionar signatário fixo (assina todos)",
          "event": [
            {
              "listen": "test",
              "script": {
                "type": "text/javascript",
                "exec": [
                  "pm.test('Resposta 2xx', () => pm.expect(pm.response.code).to.be.within(200, 299));",
                  "if (pm.response.code >= 400) {",
                  "  try { console.warn('Erro da API:', JSON.stringify(pm.response.json())); } catch (e) {}",
                  "}"
                ]
              }
            }
          ],
          "request": {
            "method": "POST",
            "header": [
              {
                "key": "Content-Type",
                "value": "application/json"
              },
              {
                "key": "Idempotency-Key",
                "value": "{{$guid}}",
                "description": "Em retry da MESMA operação, reenvie o mesmo valor."
              }
            ],
            "url": {
              "raw": "{{baseUrl}}/v1/batches-signer",
              "host": [
                "{{baseUrl}}"
              ],
              "path": [
                "v1",
                "batches-signer"
              ]
            },
            "description": "Adicione um por chamada. `fixed: true` = entra em todos os envelopes (ex.: o RH). `fixed: false` = cada um gera um envelope.\n\nAceita `Idempotency-Key` (a collection gera um automaticamente).\n\n| Campo | Onde | Tipo | Obrigatório | Descrição |\n|---|---|---|---|---|\n| `data.batchId` | body | uuid | sim | Lote |\n| `data.email` | body | string | sim |  |\n| `data.fullName` | body | string | não |  |\n| `data.signatureType` | body | enum | sim | Tipos de signatário, exceto `CARBON_COPY` |\n| `data.fixed` | body | boolean | não | Padrão `false` |\n| `data.order` | body | integer | não |  |\n| `data.requirePersonalDocument` | body | boolean | não | Padrão `false` |\n| `data.requireEmailToken` | body | boolean | não | Padrão `false` |\n\n**Resposta 201**\n\n```json\n{\n  \"totalElements\": 1,\n  \"entities\": [\n    {\n      \"id\": \"3fa85f64-5717-4562-b3fc-2c963f66afa6\",\n      \"batchId\": \"3fa85f64-5717-4562-b3fc-2c963f66afa6\",\n      \"signerId\": \"3fa85f64-5717-4562-b3fc-2c963f66afa6\",\n      \"fixed\": false\n    }\n  ]\n}\n```",
            "body": {
              "mode": "raw",
              "raw": "{\n  \"data\": {\n    \"batchId\": \"{{batchId}}\",\n    \"fixed\": true,\n    \"signatureType\": \"APPROVER\",\n    \"email\": \"rh@exemplo.com.br\",\n    \"fullName\": \"RH da Empresa\"\n  }\n}",
              "options": {
                "raw": {
                  "language": "json"
                }
              }
            }
          },
          "response": [
            {
              "name": "Exemplo 201",
              "originalRequest": {
                "method": "POST",
                "header": [],
                "url": {
                  "raw": "{{baseUrl}}/v1/batches-signer",
                  "host": [
                    "{{baseUrl}}"
                  ],
                  "path": [
                    "v1",
                    "batches-signer"
                  ]
                }
              },
              "status": "OK",
              "code": 201,
              "_postman_previewlanguage": "json",
              "header": [
                {
                  "key": "Content-Type",
                  "value": "application/json"
                }
              ],
              "body": "{\n  \"totalElements\": 1,\n  \"entities\": [\n    {\n      \"id\": \"3fa85f64-5717-4562-b3fc-2c963f66afa6\",\n      \"batchId\": \"3fa85f64-5717-4562-b3fc-2c963f66afa6\",\n      \"signerId\": \"3fa85f64-5717-4562-b3fc-2c963f66afa6\",\n      \"fixed\": false\n    }\n  ]\n}"
            }
          ]
        },
        {
          "name": "5. Definir posições dos campos",
          "event": [
            {
              "listen": "test",
              "script": {
                "type": "text/javascript",
                "exec": [
                  "pm.test('Resposta 2xx', () => pm.expect(pm.response.code).to.be.within(200, 299));",
                  "if (pm.response.code >= 400) {",
                  "  try { console.warn('Erro da API:', JSON.stringify(pm.response.json())); } catch (e) {}",
                  "}"
                ]
              }
            }
          ],
          "request": {
            "method": "PUT",
            "header": [
              {
                "key": "Content-Type",
                "value": "application/json"
              }
            ],
            "url": {
              "raw": "{{baseUrl}}/v1/batches-document",
              "host": [
                "{{baseUrl}}"
              ],
              "path": [
                "v1",
                "batches-document"
              ]
            },
            "description": "Define os campos do documento. Coordenadas iguais às de Campos de assinatura (frações 0 a 1, a partir do canto superior esquerdo). `envelopeDocumentId` é o id do documento do lote; `envelopeSignerId` é o `signerId` de um signatário do lote.\n\n| Campo | Onde | Tipo | Obrigatório | Descrição |\n|---|---|---|---|---|\n| `data.batchId` | body | uuid | sim | Lote |\n| `data.documentId` | body | uuid | sim | Documento do lote |\n| `data.tags[]` | body | array | sim | `fixed`, `envelopeSignerId`, `envelopeDocumentId`, `elementType`, `page`, `axisX`, `axisY`, `angle` |\n\n**Resposta 200**\n\n```json\n{\n  \"totalElements\": 1,\n  \"entities\": [\n    {\n      \"batchId\": \"3fa85f64-5717-4562-b3fc-2c963f66afa6\",\n      \"documentId\": \"3fa85f64-5717-4562-b3fc-2c963f66afa6\"\n    }\n  ]\n}\n```",
            "body": {
              "mode": "raw",
              "raw": "{\n  \"data\": {\n    \"batchId\": \"{{batchId}}\",\n    \"documentId\": \"{{batchDocumentId}}\",\n    \"tags\": [\n      {\n        \"fixed\": false,\n        \"envelopeSignerId\": \"{{batchSignerId}}\",\n        \"envelopeDocumentId\": \"{{batchDocumentId}}\",\n        \"elementType\": \"SIGNATURE\",\n        \"page\": 1,\n        \"axisX\": 0.1,\n        \"axisY\": 0.8,\n        \"angle\": 0\n      },\n      {\n        \"fixed\": false,\n        \"envelopeSignerId\": \"{{batchSignerId}}\",\n        \"envelopeDocumentId\": \"{{batchDocumentId}}\",\n        \"elementType\": \"FULL_NAME\",\n        \"page\": 1,\n        \"axisX\": 0.1,\n        \"axisY\": 0.88,\n        \"angle\": 0\n      }\n    ]\n  }\n}",
              "options": {
                "raw": {
                  "language": "json"
                }
              }
            }
          },
          "response": [
            {
              "name": "Exemplo 200",
              "originalRequest": {
                "method": "PUT",
                "header": [],
                "url": {
                  "raw": "{{baseUrl}}/v1/batches-document",
                  "host": [
                    "{{baseUrl}}"
                  ],
                  "path": [
                    "v1",
                    "batches-document"
                  ]
                }
              },
              "status": "OK",
              "code": 200,
              "_postman_previewlanguage": "json",
              "header": [
                {
                  "key": "Content-Type",
                  "value": "application/json"
                }
              ],
              "body": "{\n  \"totalElements\": 1,\n  \"entities\": [\n    {\n      \"batchId\": \"3fa85f64-5717-4562-b3fc-2c963f66afa6\",\n      \"documentId\": \"3fa85f64-5717-4562-b3fc-2c963f66afa6\"\n    }\n  ]\n}"
            }
          ]
        },
        {
          "name": "6. Processar lote",
          "event": [
            {
              "listen": "test",
              "script": {
                "type": "text/javascript",
                "exec": [
                  "pm.test('Resposta 2xx', () => pm.expect(pm.response.code).to.be.within(200, 299));",
                  "if (pm.response.code >= 400) {",
                  "  try { console.warn('Erro da API:', JSON.stringify(pm.response.json())); } catch (e) {}",
                  "}"
                ]
              }
            }
          ],
          "request": {
            "method": "POST",
            "header": [
              {
                "key": "Idempotency-Key",
                "value": "{{$guid}}",
                "description": "Em retry da MESMA operação, reenvie o mesmo valor."
              }
            ],
            "url": {
              "raw": "{{baseUrl}}/v1/batches-envelopes/{{companyId}}/{{batchId}}",
              "host": [
                "{{baseUrl}}"
              ],
              "path": [
                "v1",
                "batches-envelopes",
                "{{companyId}}",
                "{{batchId}}"
              ]
            },
            "description": "Cria um envelope por signatário variável, adiciona documentos, signatários fixos e campos, lacra e envia. O lote precisa estar em `DRAFT`. Créditos são debitados por envelope.\n\nAceita `Idempotency-Key` (a collection gera um automaticamente).\n\n| Campo | Onde | Tipo | Obrigatório | Descrição |\n|---|---|---|---|---|\n| `companyId` | path | uuid | sim | Sua empresa |\n| `batchId` | path | uuid | sim | Lote |\n\n**Resposta:** 201 com corpo vazio. Acompanhe os envelopes em `GET /v1/envelopes`.\n\n**Erros comuns**\n\n- 400 `Batch not found`\n- 400 `Signers not found`"
          },
          "response": []
        },
        {
          "name": "7. Ver envelopes gerados",
          "event": [
            {
              "listen": "test",
              "script": {
                "type": "text/javascript",
                "exec": [
                  "pm.test('Resposta 2xx', () => pm.expect(pm.response.code).to.be.within(200, 299));",
                  "if (pm.response.code >= 400) {",
                  "  try { console.warn('Erro da API:', JSON.stringify(pm.response.json())); } catch (e) {}",
                  "}"
                ]
              }
            }
          ],
          "request": {
            "method": "GET",
            "header": [],
            "url": {
              "raw": "{{baseUrl}}/v1/envelopes?filters=status:WAITING_SIGNATURE&sortBy=createdAt:DESC&page=1&pageSize=50",
              "host": [
                "{{baseUrl}}"
              ],
              "path": [
                "v1",
                "envelopes"
              ],
              "query": [
                {
                  "key": "filters",
                  "value": "status:WAITING_SIGNATURE"
                },
                {
                  "key": "sortBy",
                  "value": "createdAt:DESC"
                },
                {
                  "key": "page",
                  "value": "1"
                },
                {
                  "key": "pageSize",
                  "value": "50"
                }
              ]
            },
            "description": "Lista os envelopes da empresa com filtros, ordenação, paginação e relacionamentos (ver **Filtros e paginação**).\n\n- Campos filtráveis: `id`, `title`, `description`, `status`, `expiredAt`, `createdAt`, `updatedAt`.\n- `includes`: `envelopeSigners`, `envelopeSigners.signer`, `envelopeDocuments`, `envelopeDocuments.originalDocument`, `envelopeDocuments.tags`, `user`.\n\nConsultar **um** envelope com tudo: `filters=id:<envelopeId>&includes=envelopeSigners,envelopeSigners.signer,envelopeDocuments`.\n\n**Resposta 200**\n\n```json\n{\n  \"currentPage\": 1,\n  \"pageSize\": 20,\n  \"totalPages\": 1,\n  \"totalElements\": 1,\n  \"envelopes\": [\n    {\n      \"id\": \"3fa85f64-5717-4562-b3fc-2c963f66afa6\",\n      \"title\": \"Contrato\",\n      \"status\": \"WAITING_SIGNATURE\",\n      \"expiredAt\": \"2026-10-28T12:00:00.000Z\",\n      \"createdAt\": \"2026-10-13T12:00:00.000Z\",\n      \"envelopeSigners\": [\n        {\n          \"signerId\": \"3fa85f64-5717-4562-b3fc-2c963f66afa6\",\n          \"order\": 0,\n          \"signatureType\": \"PARTY\",\n          \"status\": \"PENDING\",\n          \"signer\": {\n            \"fullName\": \"Maria Souza\",\n            \"email\": \"maria@exemplo.com.br\"\n          }\n        }\n      ]\n    }\n  ]\n}\n```"
          },
          "response": [
            {
              "name": "Exemplo 200",
              "originalRequest": {
                "method": "GET",
                "header": [],
                "url": {
                  "raw": "{{baseUrl}}/v1/envelopes?filters=status:WAITING_SIGNATURE&sortBy=createdAt:DESC&page=1&pageSize=50",
                  "host": [
                    "{{baseUrl}}"
                  ],
                  "path": [
                    "v1",
                    "envelopes"
                  ],
                  "query": [
                    {
                      "key": "filters",
                      "value": "status:WAITING_SIGNATURE"
                    },
                    {
                      "key": "sortBy",
                      "value": "createdAt:DESC"
                    },
                    {
                      "key": "page",
                      "value": "1"
                    },
                    {
                      "key": "pageSize",
                      "value": "50"
                    }
                  ]
                }
              },
              "status": "OK",
              "code": 200,
              "_postman_previewlanguage": "json",
              "header": [
                {
                  "key": "Content-Type",
                  "value": "application/json"
                }
              ],
              "body": "{\n  \"currentPage\": 1,\n  \"pageSize\": 20,\n  \"totalPages\": 1,\n  \"totalElements\": 1,\n  \"envelopes\": [\n    {\n      \"id\": \"3fa85f64-5717-4562-b3fc-2c963f66afa6\",\n      \"title\": \"Contrato\",\n      \"status\": \"WAITING_SIGNATURE\",\n      \"expiredAt\": \"2026-10-28T12:00:00.000Z\",\n      \"createdAt\": \"2026-10-13T12:00:00.000Z\",\n      \"envelopeSigners\": [\n        {\n          \"signerId\": \"3fa85f64-5717-4562-b3fc-2c963f66afa6\",\n          \"order\": 0,\n          \"signatureType\": \"PARTY\",\n          \"status\": \"PENDING\",\n          \"signer\": {\n            \"fullName\": \"Maria Souza\",\n            \"email\": \"maria@exemplo.com.br\"\n          }\n        }\n      ]\n    }\n  ]\n}"
            }
          ]
        }
      ]
    },
    {
      "name": "05 · Receber avisos (webhooks)",
      "description": "Configure uma vez e receba avisos de assinatura, conclusão, cancelamento e expiração. Veja o formato do aviso na descrição da pasta Referência → Webhooks.",
      "item": [
        {
          "name": "1. Cadastrar webhook",
          "event": [
            {
              "listen": "test",
              "script": {
                "type": "text/javascript",
                "exec": [
                  "pm.test('Resposta 2xx', () => pm.expect(pm.response.code).to.be.within(200, 299));",
                  "if (pm.response.code >= 400) {",
                  "  try { console.warn('Erro da API:', JSON.stringify(pm.response.json())); } catch (e) {}",
                  "}",
                  "const b = pm.response.json();",
                  "const id = b.id || b.data?.id || (b.entities || [])[0]?.id;",
                  "if (id) pm.collectionVariables.set('webhookId', id);"
                ]
              }
            }
          ],
          "request": {
            "method": "POST",
            "header": [
              {
                "key": "Content-Type",
                "value": "application/json"
              },
              {
                "key": "Idempotency-Key",
                "value": "{{$guid}}",
                "description": "Em retry da MESMA operação, reenvie o mesmo valor."
              }
            ],
            "url": {
              "raw": "{{baseUrl}}/v1/webhook-domains",
              "host": [
                "{{baseUrl}}"
              ],
              "path": [
                "v1",
                "webhook-domains"
              ]
            },
            "description": "Aceita `Idempotency-Key` (a collection gera um automaticamente).\n\n| Campo | Onde | Tipo | Obrigatório | Descrição |\n|---|---|---|---|---|\n| `data.domain` | body | URL | sim | Endereço que recebe os avisos (http ou https) |\n| `data.events` | body | enum[] | sim | Um ou mais eventos |\n| `data.description` | body | string | não | Até 255 caracteres |\n\n**Resposta 201**\n\n```json\n{\n  \"id\": \"3fa85f64-5717-4562-b3fc-2c963f66afa6\",\n  \"domain\": \"https://seusistema.com.br/webhooks/assin\",\n  \"description\": \"Produção\",\n  \"isActive\": true,\n  \"headers\": {},\n  \"eventSubscriptions\": [\n    {\n      \"eventType\": \"SIGNER_COMPLETED\"\n    },\n    {\n      \"eventType\": \"ENVELOPE_FINISHED\"\n    }\n  ]\n}\n```",
            "body": {
              "mode": "raw",
              "raw": "{\n  \"data\": {\n    \"domain\": \"https://seusistema.com.br/webhooks/assin\",\n    \"description\": \"Produção\",\n    \"events\": [\n      \"SIGNER_COMPLETED\",\n      \"ENVELOPE_FINISHED\",\n      \"ENVELOPE_CANCELLED\",\n      \"ENVELOPE_EXPIRED\"\n    ]\n  }\n}",
              "options": {
                "raw": {
                  "language": "json"
                }
              }
            }
          },
          "response": [
            {
              "name": "Exemplo 201",
              "originalRequest": {
                "method": "POST",
                "header": [],
                "url": {
                  "raw": "{{baseUrl}}/v1/webhook-domains",
                  "host": [
                    "{{baseUrl}}"
                  ],
                  "path": [
                    "v1",
                    "webhook-domains"
                  ]
                }
              },
              "status": "OK",
              "code": 201,
              "_postman_previewlanguage": "json",
              "header": [
                {
                  "key": "Content-Type",
                  "value": "application/json"
                }
              ],
              "body": "{\n  \"id\": \"3fa85f64-5717-4562-b3fc-2c963f66afa6\",\n  \"domain\": \"https://seusistema.com.br/webhooks/assin\",\n  \"description\": \"Produção\",\n  \"isActive\": true,\n  \"headers\": {},\n  \"eventSubscriptions\": [\n    {\n      \"eventType\": \"SIGNER_COMPLETED\"\n    },\n    {\n      \"eventType\": \"ENVELOPE_FINISHED\"\n    }\n  ]\n}"
            }
          ]
        },
        {
          "name": "2. Proteger com um header seu",
          "event": [
            {
              "listen": "test",
              "script": {
                "type": "text/javascript",
                "exec": [
                  "pm.test('Resposta 2xx', () => pm.expect(pm.response.code).to.be.within(200, 299));",
                  "if (pm.response.code >= 400) {",
                  "  try { console.warn('Erro da API:', JSON.stringify(pm.response.json())); } catch (e) {}",
                  "}"
                ]
              }
            }
          ],
          "request": {
            "method": "PUT",
            "header": [
              {
                "key": "Content-Type",
                "value": "application/json"
              }
            ],
            "url": {
              "raw": "{{baseUrl}}/v1/webhook-domains/{{webhookId}}/headers",
              "host": [
                "{{baseUrl}}"
              ],
              "path": [
                "v1",
                "webhook-domains",
                "{{webhookId}}",
                "headers"
              ]
            },
            "description": "Adiciona ou substitui headers enviados em todos os avisos (ex.: um segredo para você validar). Até 20 headers; nomes são gravados em minúsculas; valores aparecem mascarados nas respostas. Não é permitido `Content-Type`, `Content-Length`, `Host`, `Transfer-Encoding` e `Connection`.\n\n| Campo | Onde | Tipo | Obrigatório | Descrição |\n|---|---|---|---|---|\n| `id` | path | uuid | sim | Webhook |\n| `data.headers` | body | objeto | sim | `{ \"Nome\": \"valor\" }` |\n\n**Resposta 200**\n\n```json\n{\n  \"id\": \"3fa85f64-5717-4562-b3fc-2c963f66afa6\",\n  \"headers\": {\n    \"authorization\": \"Bear…\"\n  }\n}\n```",
            "body": {
              "mode": "raw",
              "raw": "{\n  \"data\": {\n    \"headers\": {\n      \"Authorization\": \"Bearer seu-segredo-aqui\"\n    }\n  }\n}",
              "options": {
                "raw": {
                  "language": "json"
                }
              }
            }
          },
          "response": [
            {
              "name": "Exemplo 200",
              "originalRequest": {
                "method": "PUT",
                "header": [],
                "url": {
                  "raw": "{{baseUrl}}/v1/webhook-domains/{{webhookId}}/headers",
                  "host": [
                    "{{baseUrl}}"
                  ],
                  "path": [
                    "v1",
                    "webhook-domains",
                    "{{webhookId}}",
                    "headers"
                  ]
                }
              },
              "status": "OK",
              "code": 200,
              "_postman_previewlanguage": "json",
              "header": [
                {
                  "key": "Content-Type",
                  "value": "application/json"
                }
              ],
              "body": "{\n  \"id\": \"3fa85f64-5717-4562-b3fc-2c963f66afa6\",\n  \"headers\": {\n    \"authorization\": \"Bear…\"\n  }\n}"
            }
          ]
        },
        {
          "name": "3. Conferir",
          "event": [
            {
              "listen": "test",
              "script": {
                "type": "text/javascript",
                "exec": [
                  "pm.test('Resposta 2xx', () => pm.expect(pm.response.code).to.be.within(200, 299));",
                  "if (pm.response.code >= 400) {",
                  "  try { console.warn('Erro da API:', JSON.stringify(pm.response.json())); } catch (e) {}",
                  "}"
                ]
              }
            }
          ],
          "request": {
            "method": "GET",
            "header": [],
            "url": {
              "raw": "{{baseUrl}}/v1/webhook-domains",
              "host": [
                "{{baseUrl}}"
              ],
              "path": [
                "v1",
                "webhook-domains"
              ]
            },
            "description": "**Resposta 200**\n\n```json\n{\n  \"totalElements\": 1,\n  \"data\": [\n    {\n      \"id\": \"3fa85f64-5717-4562-b3fc-2c963f66afa6\",\n      \"domain\": \"https://seusistema.com.br/webhooks/assin\",\n      \"isActive\": true,\n      \"headers\": {\n        \"authorization\": \"Bear…\"\n      },\n      \"eventSubscriptions\": [\n        {\n          \"eventType\": \"ENVELOPE_FINISHED\"\n        }\n      ]\n    }\n  ]\n}\n```"
          },
          "response": [
            {
              "name": "Exemplo 200",
              "originalRequest": {
                "method": "GET",
                "header": [],
                "url": {
                  "raw": "{{baseUrl}}/v1/webhook-domains",
                  "host": [
                    "{{baseUrl}}"
                  ],
                  "path": [
                    "v1",
                    "webhook-domains"
                  ]
                }
              },
              "status": "OK",
              "code": 200,
              "_postman_previewlanguage": "json",
              "header": [
                {
                  "key": "Content-Type",
                  "value": "application/json"
                }
              ],
              "body": "{\n  \"totalElements\": 1,\n  \"data\": [\n    {\n      \"id\": \"3fa85f64-5717-4562-b3fc-2c963f66afa6\",\n      \"domain\": \"https://seusistema.com.br/webhooks/assin\",\n      \"isActive\": true,\n      \"headers\": {\n        \"authorization\": \"Bear…\"\n      },\n      \"eventSubscriptions\": [\n        {\n          \"eventType\": \"ENVELOPE_FINISHED\"\n        }\n      ]\n    }\n  ]\n}"
            }
          ]
        },
        {
          "name": "Se seu sistema ficou fora do ar: reenviar falhas",
          "event": [
            {
              "listen": "test",
              "script": {
                "type": "text/javascript",
                "exec": [
                  "pm.test('Resposta 2xx', () => pm.expect(pm.response.code).to.be.within(200, 299));",
                  "if (pm.response.code >= 400) {",
                  "  try { console.warn('Erro da API:', JSON.stringify(pm.response.json())); } catch (e) {}",
                  "}"
                ]
              }
            }
          ],
          "request": {
            "method": "POST",
            "header": [
              {
                "key": "Content-Type",
                "value": "application/json"
              },
              {
                "key": "Idempotency-Key",
                "value": "{{$guid}}",
                "description": "Em retry da MESMA operação, reenvie o mesmo valor."
              }
            ],
            "url": {
              "raw": "{{baseUrl}}/v1/webhook-domains/reprocess",
              "host": [
                "{{baseUrl}}"
              ],
              "path": [
                "v1",
                "webhook-domains",
                "reprocess"
              ]
            },
            "description": "Reenvia os avisos (a última tentativa de cada envelope e evento) para os webhooks ativos. Até 500 por chamada.\n\nAceita `Idempotency-Key` (a collection gera um automaticamente).\n\n| Campo | Onde | Tipo | Obrigatório | Descrição |\n|---|---|---|---|---|\n| `data.onlyFailed` | body | boolean | não | Só os que não receberam 2xx (padrão `true`) |\n| `data.envelopeIds` | body | uuid[] | não | Limitar a envelopes (até 500) |\n| `data.from` | body | ISO 8601 | não | Início do período |\n| `data.to` | body | ISO 8601 | não | Fim do período |\n\n**Resposta 200**\n\n```json\n{\n  \"matched\": 3,\n  \"resent\": 3,\n  \"succeeded\": 3,\n  \"failed\": 0,\n  \"skipped\": 0,\n  \"notReprocessable\": 0,\n  \"truncated\": false\n}\n```",
            "body": {
              "mode": "raw",
              "raw": "{\n  \"data\": {\n    \"onlyFailed\": true\n  }\n}",
              "options": {
                "raw": {
                  "language": "json"
                }
              }
            }
          },
          "response": [
            {
              "name": "Exemplo 200",
              "originalRequest": {
                "method": "POST",
                "header": [],
                "url": {
                  "raw": "{{baseUrl}}/v1/webhook-domains/reprocess",
                  "host": [
                    "{{baseUrl}}"
                  ],
                  "path": [
                    "v1",
                    "webhook-domains",
                    "reprocess"
                  ]
                }
              },
              "status": "OK",
              "code": 200,
              "_postman_previewlanguage": "json",
              "header": [
                {
                  "key": "Content-Type",
                  "value": "application/json"
                }
              ],
              "body": "{\n  \"matched\": 3,\n  \"resent\": 3,\n  \"succeeded\": 3,\n  \"failed\": 0,\n  \"skipped\": 0,\n  \"notReprocessable\": 0,\n  \"truncated\": false\n}"
            }
          ]
        }
      ]
    },
    {
      "name": "06 · Gerenciar envelope enviado",
      "description": "Operações sobre um envelope já enviado (usa `envelopeId` e `signerId` guardados).",
      "item": [
        {
          "name": "Reenviar convite por e-mail",
          "event": [
            {
              "listen": "test",
              "script": {
                "type": "text/javascript",
                "exec": [
                  "pm.test('Resposta 2xx', () => pm.expect(pm.response.code).to.be.within(200, 299));",
                  "if (pm.response.code >= 400) {",
                  "  try { console.warn('Erro da API:', JSON.stringify(pm.response.json())); } catch (e) {}",
                  "}"
                ]
              }
            }
          ],
          "request": {
            "method": "POST",
            "header": [
              {
                "key": "Content-Type",
                "value": "application/json"
              },
              {
                "key": "Idempotency-Key",
                "value": "{{$guid}}",
                "description": "Em retry da MESMA operação, reenvie o mesmo valor."
              }
            ],
            "url": {
              "raw": "{{baseUrl}}/v1/envelope-signers/resend-notification/EMAIL",
              "host": [
                "{{baseUrl}}"
              ],
              "path": [
                "v1",
                "envelope-signers",
                "resend-notification",
                "EMAIL"
              ]
            },
            "description": "Reenvia o convite de assinatura. Canal no fim da URL: `EMAIL`, `WHATSAPP` ou `SMS`.\n\nSó para signatários `PENDING`, com envelope em `WAITING_SIGNATURE`. Intervalo mínimo de 1 minuto entre envios para o mesmo signatário, contando também o convite enviado ao lacrar. Para SMS/WhatsApp, o signatário precisa ter telefone (ou informe `number`).\n\nAceita `Idempotency-Key` (a collection gera um automaticamente).\n\n| Campo | Onde | Tipo | Obrigatório | Descrição |\n|---|---|---|---|---|\n| `type` | path | enum | sim | `EMAIL`, `WHATSAPP` ou `SMS` |\n| `envelopeId` | body | uuid | sim | Envelope |\n| `data[].signerId` | body | uuid | sim | Signatário |\n| `data[].number` | body | string | não | Telefone E.164 para SMS/WhatsApp |\n\n**Resposta:** 201 com corpo vazio.",
            "body": {
              "mode": "raw",
              "raw": "{\n  \"envelopeId\": \"{{envelopeId}}\",\n  \"data\": [\n    {\n      \"signerId\": \"{{signerId}}\"\n    }\n  ]\n}",
              "options": {
                "raw": {
                  "language": "json"
                }
              }
            }
          },
          "response": []
        },
        {
          "name": "Reenviar convite por WhatsApp",
          "event": [
            {
              "listen": "test",
              "script": {
                "type": "text/javascript",
                "exec": [
                  "pm.test('Resposta 2xx', () => pm.expect(pm.response.code).to.be.within(200, 299));",
                  "if (pm.response.code >= 400) {",
                  "  try { console.warn('Erro da API:', JSON.stringify(pm.response.json())); } catch (e) {}",
                  "}"
                ]
              }
            }
          ],
          "request": {
            "method": "POST",
            "header": [
              {
                "key": "Content-Type",
                "value": "application/json"
              },
              {
                "key": "Idempotency-Key",
                "value": "{{$guid}}",
                "description": "Em retry da MESMA operação, reenvie o mesmo valor."
              }
            ],
            "url": {
              "raw": "{{baseUrl}}/v1/envelope-signers/resend-notification/WHATSAPP",
              "host": [
                "{{baseUrl}}"
              ],
              "path": [
                "v1",
                "envelope-signers",
                "resend-notification",
                "WHATSAPP"
              ]
            },
            "description": "Reenvia o convite de assinatura. Canal no fim da URL: `EMAIL`, `WHATSAPP` ou `SMS`.\n\nSó para signatários `PENDING`, com envelope em `WAITING_SIGNATURE`. Intervalo mínimo de 1 minuto entre envios para o mesmo signatário, contando também o convite enviado ao lacrar. Para SMS/WhatsApp, o signatário precisa ter telefone (ou informe `number`).\n\nAceita `Idempotency-Key` (a collection gera um automaticamente).\n\n| Campo | Onde | Tipo | Obrigatório | Descrição |\n|---|---|---|---|---|\n| `type` | path | enum | sim | `EMAIL`, `WHATSAPP` ou `SMS` |\n| `envelopeId` | body | uuid | sim | Envelope |\n| `data[].signerId` | body | uuid | sim | Signatário |\n| `data[].number` | body | string | não | Telefone E.164 para SMS/WhatsApp |\n\n**Resposta:** 201 com corpo vazio.",
            "body": {
              "mode": "raw",
              "raw": "{\n  \"envelopeId\": \"{{envelopeId}}\",\n  \"data\": [\n    {\n      \"signerId\": \"{{signerId}}\"\n    }\n  ]\n}",
              "options": {
                "raw": {
                  "language": "json"
                }
              }
            }
          },
          "response": []
        },
        {
          "name": "Corrigir e-mail do signatário",
          "event": [
            {
              "listen": "test",
              "script": {
                "type": "text/javascript",
                "exec": [
                  "pm.test('Resposta 2xx', () => pm.expect(pm.response.code).to.be.within(200, 299));",
                  "if (pm.response.code >= 400) {",
                  "  try { console.warn('Erro da API:', JSON.stringify(pm.response.json())); } catch (e) {}",
                  "}"
                ]
              }
            }
          ],
          "request": {
            "method": "PUT",
            "header": [
              {
                "key": "Content-Type",
                "value": "application/json"
              }
            ],
            "url": {
              "raw": "{{baseUrl}}/v1/envelope-signers",
              "host": [
                "{{baseUrl}}"
              ],
              "path": [
                "v1",
                "envelope-signers"
              ]
            },
            "description": "Corrige nome, e-mail ou telefone de quem ainda não assinou (envelope em `DRAFT` ou `WAITING_SIGNATURE`). Se o e-mail mudar com o envelope já enviado, a Assin reenvia o convite para o novo endereço e passa a exigir código por e-mail. Se a pessoa já assinou **outros** envelopes, nome e e-mail ficam travados (a identidade dela é a mesma em todos): remova o signatário e adicione outro.\n\n| Campo | Onde | Tipo | Obrigatório | Descrição |\n|---|---|---|---|---|\n| `envelopeId` | body | uuid | sim | Envelope |\n| `data[].signerId` | body | uuid | sim | Signatário |\n| `data[].fullName` | body | string | não |  |\n| `data[].email` | body | string | não |  |\n| `data[].phone` | body | string | não | E.164 |\n\n**Resposta 200**\n\n```json\n{\n  \"totalElements\": 1,\n  \"envelopeSigners\": [\n    {\n      \"signerId\": \"3fa85f64-5717-4562-b3fc-2c963f66afa6\",\n      \"status\": \"PENDING\"\n    }\n  ]\n}\n```",
            "body": {
              "mode": "raw",
              "raw": "{\n  \"envelopeId\": \"{{envelopeId}}\",\n  \"data\": [\n    {\n      \"signerId\": \"{{signerId}}\",\n      \"email\": \"maria.souza@exemplo.com.br\"\n    }\n  ]\n}",
              "options": {
                "raw": {
                  "language": "json"
                }
              }
            }
          },
          "response": [
            {
              "name": "Exemplo 200",
              "originalRequest": {
                "method": "PUT",
                "header": [],
                "url": {
                  "raw": "{{baseUrl}}/v1/envelope-signers",
                  "host": [
                    "{{baseUrl}}"
                  ],
                  "path": [
                    "v1",
                    "envelope-signers"
                  ]
                }
              },
              "status": "OK",
              "code": 200,
              "_postman_previewlanguage": "json",
              "header": [
                {
                  "key": "Content-Type",
                  "value": "application/json"
                }
              ],
              "body": "{\n  \"totalElements\": 1,\n  \"envelopeSigners\": [\n    {\n      \"signerId\": \"3fa85f64-5717-4562-b3fc-2c963f66afa6\",\n      \"status\": \"PENDING\"\n    }\n  ]\n}"
            }
          ]
        },
        {
          "name": "Gerar link de assinatura",
          "event": [
            {
              "listen": "test",
              "script": {
                "type": "text/javascript",
                "exec": [
                  "pm.test('Resposta 2xx', () => pm.expect(pm.response.code).to.be.within(200, 299));",
                  "if (pm.response.code >= 400) {",
                  "  try { console.warn('Erro da API:', JSON.stringify(pm.response.json())); } catch (e) {}",
                  "}"
                ]
              }
            }
          ],
          "request": {
            "method": "POST",
            "header": [
              {
                "key": "Content-Type",
                "value": "application/json"
              }
            ],
            "url": {
              "raw": "{{baseUrl}}/v1/envelope-signers/signing-link",
              "host": [
                "{{baseUrl}}"
              ],
              "path": [
                "v1",
                "envelope-signers",
                "signing-link"
              ]
            },
            "description": "Gera o link para o signatário assinar, para você abrir no seu sistema ou enviar pelo seu canal. Envelope em `WAITING_SIGNATURE`, signatário `PENDING` e que não seja `CARBON_COPY`.\n\n| Campo | Onde | Tipo | Obrigatório | Descrição |\n|---|---|---|---|---|\n| `envelopeId` | body | uuid | sim | Envelope |\n| `data[].signerId` | body | uuid | sim | Signatário |\n\n**Resposta 201**\n\n```json\n{\n  \"totalElements\": 1,\n  \"signingLinks\": [\n    {\n      \"signerId\": \"3fa85f64-5717-4562-b3fc-2c963f66afa6\",\n      \"url\": \"https://sign.assin.com.br/?access=eyJhbGciOi...\"\n    }\n  ]\n}\n```",
            "body": {
              "mode": "raw",
              "raw": "{\n  \"envelopeId\": \"{{envelopeId}}\",\n  \"data\": [\n    {\n      \"signerId\": \"{{signerId}}\"\n    }\n  ]\n}",
              "options": {
                "raw": {
                  "language": "json"
                }
              }
            }
          },
          "response": [
            {
              "name": "Exemplo 201",
              "originalRequest": {
                "method": "POST",
                "header": [],
                "url": {
                  "raw": "{{baseUrl}}/v1/envelope-signers/signing-link",
                  "host": [
                    "{{baseUrl}}"
                  ],
                  "path": [
                    "v1",
                    "envelope-signers",
                    "signing-link"
                  ]
                }
              },
              "status": "OK",
              "code": 201,
              "_postman_previewlanguage": "json",
              "header": [
                {
                  "key": "Content-Type",
                  "value": "application/json"
                }
              ],
              "body": "{\n  \"totalElements\": 1,\n  \"signingLinks\": [\n    {\n      \"signerId\": \"3fa85f64-5717-4562-b3fc-2c963f66afa6\",\n      \"url\": \"https://sign.assin.com.br/?access=eyJhbGciOi...\"\n    }\n  ]\n}"
            }
          ]
        },
        {
          "name": "Bloquear / desbloquear",
          "event": [
            {
              "listen": "test",
              "script": {
                "type": "text/javascript",
                "exec": [
                  "pm.test('Resposta 2xx', () => pm.expect(pm.response.code).to.be.within(200, 299));",
                  "if (pm.response.code >= 400) {",
                  "  try { console.warn('Erro da API:', JSON.stringify(pm.response.json())); } catch (e) {}",
                  "}"
                ]
              }
            }
          ],
          "request": {
            "method": "PUT",
            "header": [
              {
                "key": "Content-Type",
                "value": "application/json"
              }
            ],
            "url": {
              "raw": "{{baseUrl}}/v1/envelopes/block-envelope",
              "host": [
                "{{baseUrl}}"
              ],
              "path": [
                "v1",
                "envelopes",
                "block-envelope"
              ]
            },
            "description": "Alterna o estado: `WAITING_SIGNATURE` → `BLOCK` (pausa as assinaturas) e `BLOCK` → `WAITING_SIGNATURE`. Não funciona se algum signatário já concluiu (inclusive `CARBON_COPY`, que conclui ao lacrar).\n\n| Campo | Onde | Tipo | Obrigatório | Descrição |\n|---|---|---|---|---|\n| `data[].id` | body | uuid | sim | Envelope |\n\n**Resposta 200**\n\n```json\n{\n  \"totalElements\": 1,\n  \"envelopes\": [\n    {\n      \"id\": \"3fa85f64-5717-4562-b3fc-2c963f66afa6\",\n      \"status\": \"BLOCK\"\n    }\n  ]\n}\n```",
            "body": {
              "mode": "raw",
              "raw": "{\n  \"data\": [\n    {\n      \"id\": \"{{envelopeId}}\"\n    }\n  ]\n}",
              "options": {
                "raw": {
                  "language": "json"
                }
              }
            }
          },
          "response": [
            {
              "name": "Exemplo 200",
              "originalRequest": {
                "method": "PUT",
                "header": [],
                "url": {
                  "raw": "{{baseUrl}}/v1/envelopes/block-envelope",
                  "host": [
                    "{{baseUrl}}"
                  ],
                  "path": [
                    "v1",
                    "envelopes",
                    "block-envelope"
                  ]
                }
              },
              "status": "OK",
              "code": 200,
              "_postman_previewlanguage": "json",
              "header": [
                {
                  "key": "Content-Type",
                  "value": "application/json"
                }
              ],
              "body": "{\n  \"totalElements\": 1,\n  \"envelopes\": [\n    {\n      \"id\": \"3fa85f64-5717-4562-b3fc-2c963f66afa6\",\n      \"status\": \"BLOCK\"\n    }\n  ]\n}"
            }
          ]
        },
        {
          "name": "Cancelar",
          "event": [
            {
              "listen": "test",
              "script": {
                "type": "text/javascript",
                "exec": [
                  "pm.test('Resposta 2xx', () => pm.expect(pm.response.code).to.be.within(200, 299));",
                  "if (pm.response.code >= 400) {",
                  "  try { console.warn('Erro da API:', JSON.stringify(pm.response.json())); } catch (e) {}",
                  "}"
                ]
              }
            }
          ],
          "request": {
            "method": "PUT",
            "header": [
              {
                "key": "Content-Type",
                "value": "application/json"
              }
            ],
            "url": {
              "raw": "{{baseUrl}}/v1/envelopes/cancel",
              "host": [
                "{{baseUrl}}"
              ],
              "path": [
                "v1",
                "envelopes",
                "cancel"
              ]
            },
            "description": "Cancela o envelope (`CANCELED`). Os links de assinatura deixam de funcionar e o webhook `ENVELOPE_CANCELLED` é disparado. Não pode ser desfeito.\n\n| Campo | Onde | Tipo | Obrigatório | Descrição |\n|---|---|---|---|---|\n| `data[].id` | body | uuid | sim | Envelope |\n\n**Resposta 200**\n\n```json\n{\n  \"totalElements\": 1,\n  \"envelopes\": [\n    {\n      \"id\": \"3fa85f64-5717-4562-b3fc-2c963f66afa6\",\n      \"status\": \"CANCELED\"\n    }\n  ]\n}\n```",
            "body": {
              "mode": "raw",
              "raw": "{\n  \"data\": [\n    {\n      \"id\": \"{{envelopeId}}\"\n    }\n  ]\n}",
              "options": {
                "raw": {
                  "language": "json"
                }
              }
            }
          },
          "response": [
            {
              "name": "Exemplo 200",
              "originalRequest": {
                "method": "PUT",
                "header": [],
                "url": {
                  "raw": "{{baseUrl}}/v1/envelopes/cancel",
                  "host": [
                    "{{baseUrl}}"
                  ],
                  "path": [
                    "v1",
                    "envelopes",
                    "cancel"
                  ]
                }
              },
              "status": "OK",
              "code": 200,
              "_postman_previewlanguage": "json",
              "header": [
                {
                  "key": "Content-Type",
                  "value": "application/json"
                }
              ],
              "body": "{\n  \"totalElements\": 1,\n  \"envelopes\": [\n    {\n      \"id\": \"3fa85f64-5717-4562-b3fc-2c963f66afa6\",\n      \"status\": \"CANCELED\"\n    }\n  ]\n}"
            }
          ]
        }
      ]
    },
    {
      "name": "Referência · todas as rotas",
      "description": "Todas as rotas da API, por recurso. Usam as mesmas variáveis dos fluxos.",
      "item": [
        {
          "name": "🗂 Documentos",
          "description": "Um documento é um PDF da sua empresa. O envio do arquivo é feito em duas etapas: primeiro você cria o registro (recebe uma URL de upload), depois envia os bytes do PDF direto para essa URL. Em seguida o documento pode ser vinculado a um ou mais envelopes.",
          "item": [
            {
              "name": "Criar documento (gera URL de upload)",
              "event": [
                {
                  "listen": "test",
                  "script": {
                    "type": "text/javascript",
                    "exec": [
                      "pm.test('Resposta 2xx', () => pm.expect(pm.response.code).to.be.within(200, 299));",
                      "if (pm.response.code >= 400) {",
                      "  try { console.warn('Erro da API:', JSON.stringify(pm.response.json())); } catch (e) {}",
                      "}",
                      "const doc = (pm.response.json().documents || [])[0];",
                      "if (doc) { pm.collectionVariables.set('documentId', doc.id); pm.collectionVariables.set('uploadUrl', doc.url); }"
                    ]
                  }
                }
              ],
              "request": {
                "method": "POST",
                "header": [
                  {
                    "key": "Content-Type",
                    "value": "application/json"
                  },
                  {
                    "key": "Idempotency-Key",
                    "value": "{{$guid}}",
                    "description": "Em retry da MESMA operação, reenvie o mesmo valor."
                  }
                ],
                "url": {
                  "raw": "{{baseUrl}}/v1/documents",
                  "host": [
                    "{{baseUrl}}"
                  ],
                  "path": [
                    "v1",
                    "documents"
                  ]
                },
                "description": "Cria o registro do documento e devolve, em `url`, uma **URL de upload válida por 5 minutos**. O PDF ainda não foi enviado: faça o `PUT` do arquivo nessa URL (próxima rota).\n\nEnvie vários documentos de uma vez colocando mais itens em `data`. `alias` precisa ser único dentro da requisição.\n\nAceita `Idempotency-Key` (a collection gera um automaticamente).\n\n| Campo | Onde | Tipo | Obrigatório | Descrição |\n|---|---|---|---|---|\n| `data[].alias` | body | string | sim | Nome do documento (ex.: `Contrato.pdf`) |\n\n**Resposta 201**\n\n```json\n{\n  \"totalElements\": 1,\n  \"documents\": [\n    {\n      \"id\": \"3fa85f64-5717-4562-b3fc-2c963f66afa6\",\n      \"alias\": \"Contrato de Prestação de Serviços.pdf\",\n      \"url\": \"https://<bucket>.s3.amazonaws.com/companies/.../originalDocument.pdf?X-Amz-Expires=300&...\",\n      \"createdFrom\": \"API\",\n      \"companyId\": \"3fa85f64-5717-4562-b3fc-2c963f66afa6\",\n      \"createdAt\": \"2026-10-13T12:00:00.000Z\"\n    }\n  ]\n}\n```",
                "body": {
                  "mode": "raw",
                  "raw": "{\n  \"data\": [\n    {\n      \"alias\": \"Contrato de Prestação de Serviços.pdf\"\n    }\n  ]\n}",
                  "options": {
                    "raw": {
                      "language": "json"
                    }
                  }
                }
              },
              "response": [
                {
                  "name": "Exemplo 201",
                  "originalRequest": {
                    "method": "POST",
                    "header": [],
                    "url": {
                      "raw": "{{baseUrl}}/v1/documents",
                      "host": [
                        "{{baseUrl}}"
                      ],
                      "path": [
                        "v1",
                        "documents"
                      ]
                    }
                  },
                  "status": "OK",
                  "code": 201,
                  "_postman_previewlanguage": "json",
                  "header": [
                    {
                      "key": "Content-Type",
                      "value": "application/json"
                    }
                  ],
                  "body": "{\n  \"totalElements\": 1,\n  \"documents\": [\n    {\n      \"id\": \"3fa85f64-5717-4562-b3fc-2c963f66afa6\",\n      \"alias\": \"Contrato de Prestação de Serviços.pdf\",\n      \"url\": \"https://<bucket>.s3.amazonaws.com/companies/.../originalDocument.pdf?X-Amz-Expires=300&...\",\n      \"createdFrom\": \"API\",\n      \"companyId\": \"3fa85f64-5717-4562-b3fc-2c963f66afa6\",\n      \"createdAt\": \"2026-10-13T12:00:00.000Z\"\n    }\n  ]\n}"
                }
              ]
            },
            {
              "name": "Enviar o PDF para a URL de upload",
              "event": [
                {
                  "listen": "test",
                  "script": {
                    "type": "text/javascript",
                    "exec": [
                      "pm.test('Resposta 2xx', () => pm.expect(pm.response.code).to.be.within(200, 299));",
                      "if (pm.response.code >= 400) {",
                      "  try { console.warn('Erro da API:', JSON.stringify(pm.response.json())); } catch (e) {}",
                      "}"
                    ]
                  }
                }
              ],
              "request": {
                "method": "PUT",
                "header": [
                  {
                    "key": "Content-Type",
                    "value": "application/pdf"
                  }
                ],
                "url": {
                  "raw": "{{uploadUrl}}"
                },
                "description": "Envia os **bytes do PDF** para a `url` recebida na criação do documento.\n\n- Corpo: o arquivo PDF puro (binário). **Não** é multipart nem JSON.\n- **Sem** header `Authorization`: esta requisição vai direto ao storage, não à API.\n- Header `Content-Type: application/pdf`.\n- Faça em até 5 minutos. Se expirar, crie o documento de novo.\n\nNo Postman: aba **Body → binary** e selecione o PDF.\n\n```bash\ncurl -X PUT \"$UPLOAD_URL\" -H \"Content-Type: application/pdf\" --data-binary @contrato.pdf\n```\n\n**Resposta:** 200 com corpo vazio.",
                "body": {
                  "mode": "file",
                  "file": {
                    "src": ""
                  }
                },
                "auth": {
                  "type": "noauth"
                }
              },
              "response": []
            },
            {
              "name": "Listar documentos",
              "event": [
                {
                  "listen": "test",
                  "script": {
                    "type": "text/javascript",
                    "exec": [
                      "pm.test('Resposta 2xx', () => pm.expect(pm.response.code).to.be.within(200, 299));",
                      "if (pm.response.code >= 400) {",
                      "  try { console.warn('Erro da API:', JSON.stringify(pm.response.json())); } catch (e) {}",
                      "}"
                    ]
                  }
                }
              ],
              "request": {
                "method": "GET",
                "header": [],
                "url": {
                  "raw": "{{baseUrl}}/v1/documents?page=1&pageSize=20&sortBy=createdAt:DESC",
                  "host": [
                    "{{baseUrl}}"
                  ],
                  "path": [
                    "v1",
                    "documents"
                  ],
                  "query": [
                    {
                      "key": "page",
                      "value": "1"
                    },
                    {
                      "key": "pageSize",
                      "value": "20"
                    },
                    {
                      "key": "sortBy",
                      "value": "createdAt:DESC"
                    }
                  ]
                },
                "description": "Lista os documentos da empresa. Aceita `filters`, `sortBy`, `page` e `pageSize` (ver **Filtros e paginação**). Campos filtráveis: `id`, `alias`, `createdFrom`, `createdAt`. O `url` de cada item é um link de download válido por 5 minutos.\n\n**Resposta 200**\n\n```json\n{\n  \"currentPage\": 1,\n  \"pageSize\": 20,\n  \"totalPages\": 1,\n  \"totalElements\": 1,\n  \"documents\": [\n    {\n      \"id\": \"3fa85f64-5717-4562-b3fc-2c963f66afa6\",\n      \"alias\": \"Contrato.pdf\",\n      \"url\": \"https://...presigned...\",\n      \"createdFrom\": \"API\",\n      \"createdAt\": \"2026-10-13T12:00:00.000Z\"\n    }\n  ]\n}\n```"
              },
              "response": [
                {
                  "name": "Exemplo 200",
                  "originalRequest": {
                    "method": "GET",
                    "header": [],
                    "url": {
                      "raw": "{{baseUrl}}/v1/documents?page=1&pageSize=20&sortBy=createdAt:DESC",
                      "host": [
                        "{{baseUrl}}"
                      ],
                      "path": [
                        "v1",
                        "documents"
                      ],
                      "query": [
                        {
                          "key": "page",
                          "value": "1"
                        },
                        {
                          "key": "pageSize",
                          "value": "20"
                        },
                        {
                          "key": "sortBy",
                          "value": "createdAt:DESC"
                        }
                      ]
                    }
                  },
                  "status": "OK",
                  "code": 200,
                  "_postman_previewlanguage": "json",
                  "header": [
                    {
                      "key": "Content-Type",
                      "value": "application/json"
                    }
                  ],
                  "body": "{\n  \"currentPage\": 1,\n  \"pageSize\": 20,\n  \"totalPages\": 1,\n  \"totalElements\": 1,\n  \"documents\": [\n    {\n      \"id\": \"3fa85f64-5717-4562-b3fc-2c963f66afa6\",\n      \"alias\": \"Contrato.pdf\",\n      \"url\": \"https://...presigned...\",\n      \"createdFrom\": \"API\",\n      \"createdAt\": \"2026-10-13T12:00:00.000Z\"\n    }\n  ]\n}"
                }
              ]
            },
            {
              "name": "Excluir documento",
              "event": [
                {
                  "listen": "test",
                  "script": {
                    "type": "text/javascript",
                    "exec": [
                      "pm.test('Resposta 2xx', () => pm.expect(pm.response.code).to.be.within(200, 299));",
                      "if (pm.response.code >= 400) {",
                      "  try { console.warn('Erro da API:', JSON.stringify(pm.response.json())); } catch (e) {}",
                      "}"
                    ]
                  }
                }
              ],
              "request": {
                "method": "DELETE",
                "header": [],
                "url": {
                  "raw": "{{baseUrl}}/v1/documents/{{documentId}}/delete",
                  "host": [
                    "{{baseUrl}}"
                  ],
                  "path": [
                    "v1",
                    "documents",
                    "{{documentId}}",
                    "delete"
                  ]
                },
                "description": "Exclui o documento e o arquivo. Só é permitido se o documento não estiver em nenhum envelope ou se os envelopes em que ele está ainda forem `DRAFT`. Documentos finais (assinados) não podem ser excluídos.\n\n| Campo | Onde | Tipo | Obrigatório | Descrição |\n|---|---|---|---|---|\n| `documentId` | path | uuid | sim | ID do documento |\n\n**Resposta:** 204 sem corpo."
              },
              "response": []
            },
            {
              "name": "Verificar autenticidade de um documento",
              "event": [
                {
                  "listen": "test",
                  "script": {
                    "type": "text/javascript",
                    "exec": [
                      "pm.test('Resposta 2xx', () => pm.expect(pm.response.code).to.be.within(200, 299));",
                      "if (pm.response.code >= 400) {",
                      "  try { console.warn('Erro da API:', JSON.stringify(pm.response.json())); } catch (e) {}",
                      "}"
                    ]
                  }
                }
              ],
              "request": {
                "method": "GET",
                "header": [],
                "url": {
                  "raw": "{{baseUrl}}/v1/documents/verify-document?documentId={{documentId}}",
                  "host": [
                    "{{baseUrl}}"
                  ],
                  "path": [
                    "v1",
                    "documents",
                    "verify-document"
                  ],
                  "query": [
                    {
                      "key": "documentId",
                      "value": "{{documentId}}"
                    }
                  ]
                },
                "description": "Consulta a situação de um documento. Informe **um** dos parâmetros:\n\n- `fingerprint`: o hash impresso no documento final. Resposta `Document is valid` se for autêntico.\n- `documentId`: o ID do documento original. A resposta diz em que fase ele está.\n\nMensagens possíveis: `Document is valid`, `Document waiting signatures`, `Document was signed on DD/MM/YYYY at HH:mm.`, `Document has been canceled`, `Document in generating process`, `Document in process to be signed`, `There was an error`, `No info about the document`.\n\n| Campo | Onde | Tipo | Obrigatório | Descrição |\n|---|---|---|---|---|\n| `fingerprint` | query | string | não | Hash do documento final |\n| `documentId` | query | uuid | não | ID do documento original |\n\n**Resposta 200**\n\n```json\n{\n  \"message\": \"Document was signed on 13/10/2026 at 15:42.\"\n}\n```\n\n**Erros comuns**\n\n- 400 se nenhum parâmetro for enviado ou o documento não for encontrado"
              },
              "response": [
                {
                  "name": "Exemplo 200",
                  "originalRequest": {
                    "method": "GET",
                    "header": [],
                    "url": {
                      "raw": "{{baseUrl}}/v1/documents/verify-document?documentId={{documentId}}",
                      "host": [
                        "{{baseUrl}}"
                      ],
                      "path": [
                        "v1",
                        "documents",
                        "verify-document"
                      ],
                      "query": [
                        {
                          "key": "documentId",
                          "value": "{{documentId}}"
                        }
                      ]
                    }
                  },
                  "status": "OK",
                  "code": 200,
                  "_postman_previewlanguage": "json",
                  "header": [
                    {
                      "key": "Content-Type",
                      "value": "application/json"
                    }
                  ],
                  "body": "{\n  \"message\": \"Document was signed on 13/10/2026 at 15:42.\"\n}"
                }
              ]
            },
            {
              "name": "Gerar token de visualização de documentos",
              "event": [
                {
                  "listen": "test",
                  "script": {
                    "type": "text/javascript",
                    "exec": [
                      "pm.test('Resposta 2xx', () => pm.expect(pm.response.code).to.be.within(200, 299));",
                      "if (pm.response.code >= 400) {",
                      "  try { console.warn('Erro da API:', JSON.stringify(pm.response.json())); } catch (e) {}",
                      "}",
                      "const t = pm.response.json().token;",
                      "if (t) pm.collectionVariables.set('documentToken', t);"
                    ]
                  }
                }
              ],
              "request": {
                "method": "POST",
                "header": [
                  {
                    "key": "Content-Type",
                    "value": "application/json"
                  }
                ],
                "url": {
                  "raw": "{{baseUrl}}/v1/envelopes/documents-url",
                  "host": [
                    "{{baseUrl}}"
                  ],
                  "path": [
                    "v1",
                    "envelopes",
                    "documents-url"
                  ]
                },
                "description": "Gera um token (válido por 5 minutos) que libera o download dos documentos informados em `GET /v1/documents/get-link-document`. Para baixar documentos de um envelope, prefira `GET /v1/envelopes/{envelopeId}/documents`, que é mais simples e inclui o PDF assinado.\n\n| Campo | Onde | Tipo | Obrigatório | Descrição |\n|---|---|---|---|---|\n| `data[].id` | body | uuid | sim | ID do documento |\n\n**Resposta 201**\n\n```json\n{\n  \"token\": \"eyJhbGciOiJIUzI1NiIs...\"\n}\n```",
                "body": {
                  "mode": "raw",
                  "raw": "{\n  \"data\": [\n    {\n      \"id\": \"{{documentId}}\"\n    }\n  ]\n}",
                  "options": {
                    "raw": {
                      "language": "json"
                    }
                  }
                }
              },
              "response": [
                {
                  "name": "Exemplo 201",
                  "originalRequest": {
                    "method": "POST",
                    "header": [],
                    "url": {
                      "raw": "{{baseUrl}}/v1/envelopes/documents-url",
                      "host": [
                        "{{baseUrl}}"
                      ],
                      "path": [
                        "v1",
                        "envelopes",
                        "documents-url"
                      ]
                    }
                  },
                  "status": "OK",
                  "code": 201,
                  "_postman_previewlanguage": "json",
                  "header": [
                    {
                      "key": "Content-Type",
                      "value": "application/json"
                    }
                  ],
                  "body": "{\n  \"token\": \"eyJhbGciOiJIUzI1NiIs...\"\n}"
                }
              ]
            },
            {
              "name": "Baixar documentos com token",
              "event": [
                {
                  "listen": "test",
                  "script": {
                    "type": "text/javascript",
                    "exec": [
                      "pm.test('Resposta 2xx', () => pm.expect(pm.response.code).to.be.within(200, 299));",
                      "if (pm.response.code >= 400) {",
                      "  try { console.warn('Erro da API:', JSON.stringify(pm.response.json())); } catch (e) {}",
                      "}"
                    ]
                  }
                }
              ],
              "request": {
                "method": "GET",
                "header": [
                  {
                    "key": "x-dynamic-authorization",
                    "value": "{{documentToken}}"
                  }
                ],
                "url": {
                  "raw": "{{baseUrl}}/v1/documents/get-link-document",
                  "host": [
                    "{{baseUrl}}"
                  ],
                  "path": [
                    "v1",
                    "documents",
                    "get-link-document"
                  ]
                },
                "description": "Usa o token de `POST /v1/envelopes/documents-url` no header `x-dynamic-authorization` e devolve links de download (válidos por 5 minutos) dos documentos originais. **Não** retorna o PDF assinado: use `GET /v1/envelopes/{envelopeId}/documents`.\n\n| Campo | Onde | Tipo | Obrigatório | Descrição |\n|---|---|---|---|---|\n| `x-dynamic-authorization` | header | string | sim | Token gerado em documents-url |\n\n**Resposta 200**\n\n```json\n{\n  \"totalElements\": 1,\n  \"documents\": [\n    {\n      \"id\": \"3fa85f64-5717-4562-b3fc-2c963f66afa6\",\n      \"alias\": \"Contrato.pdf\",\n      \"url\": \"https://...presigned...\"\n    }\n  ]\n}\n```"
              },
              "response": [
                {
                  "name": "Exemplo 200",
                  "originalRequest": {
                    "method": "GET",
                    "header": [],
                    "url": {
                      "raw": "{{baseUrl}}/v1/documents/get-link-document",
                      "host": [
                        "{{baseUrl}}"
                      ],
                      "path": [
                        "v1",
                        "documents",
                        "get-link-document"
                      ]
                    }
                  },
                  "status": "OK",
                  "code": 200,
                  "_postman_previewlanguage": "json",
                  "header": [
                    {
                      "key": "Content-Type",
                      "value": "application/json"
                    }
                  ],
                  "body": "{\n  \"totalElements\": 1,\n  \"documents\": [\n    {\n      \"id\": \"3fa85f64-5717-4562-b3fc-2c963f66afa6\",\n      \"alias\": \"Contrato.pdf\",\n      \"url\": \"https://...presigned...\"\n    }\n  ]\n}"
                }
              ]
            }
          ]
        },
        {
          "name": "📄 Envelopes",
          "description": "O envelope agrupa documentos e signatários em um fluxo de assinatura. Ele nasce em `DRAFT`, recebe documentos, signatários e campos, e é **lacrado** para ser enviado. Depois de lacrado, só dá para gerenciar (reenviar, bloquear, cancelar).\n\n### Status do envelope\n\n| Status | Significado |\n|---|---|\n| `DRAFT` | Rascunho: ainda pode receber documentos, signatários e campos |\n| `CREATED` | Lacrado, preparando o envio (dura segundos) |\n| `WAITING_SIGNATURE` | Enviado, aguardando assinaturas |\n| `BLOCK` | Bloqueado: assinaturas pausadas |\n| `GET_LOCATIONS`, `GENERATE_FINGERPRINTS`, `GENERATE_BLOCKCHAIN`, `GENERATE_FINAL_DOC`, `GENERATE_ICP_BRASIL`, `FINISHING_DOC` | Todos assinaram, gerando o documento final |\n| `COMPLETED` | Concluído: documento final disponível |\n| `CANCELED` | Cancelado |\n| `ERROR` | Falha no processamento (contate o suporte) |",
          "item": [
            {
              "name": "Criar envelope",
              "event": [
                {
                  "listen": "prerequest",
                  "script": {
                    "type": "text/javascript",
                    "exec": [
                      "const d = new Date(Date.now() + 15 * 24 * 3600 * 1000);",
                      "pm.collectionVariables.set('expiredAt', d.toISOString());"
                    ]
                  }
                },
                {
                  "listen": "test",
                  "script": {
                    "type": "text/javascript",
                    "exec": [
                      "pm.test('Resposta 2xx', () => pm.expect(pm.response.code).to.be.within(200, 299));",
                      "if (pm.response.code >= 400) {",
                      "  try { console.warn('Erro da API:', JSON.stringify(pm.response.json())); } catch (e) {}",
                      "}",
                      "const env = (pm.response.json().envelopes || [])[0];",
                      "if (env) { pm.collectionVariables.set('envelopeId', env.id); if (env.companyId) pm.collectionVariables.set('companyId', env.companyId); }"
                    ]
                  }
                }
              ],
              "request": {
                "method": "POST",
                "header": [
                  {
                    "key": "Content-Type",
                    "value": "application/json"
                  },
                  {
                    "key": "Idempotency-Key",
                    "value": "{{$guid}}",
                    "description": "Em retry da MESMA operação, reenvie o mesmo valor."
                  }
                ],
                "url": {
                  "raw": "{{baseUrl}}/v1/envelopes",
                  "host": [
                    "{{baseUrl}}"
                  ],
                  "path": [
                    "v1",
                    "envelopes"
                  ]
                },
                "description": "Cria um ou mais envelopes em `DRAFT`. `title` precisa ser único dentro da requisição.\n\nAceita `Idempotency-Key` (a collection gera um automaticamente).\n\n| Campo | Onde | Tipo | Obrigatório | Descrição |\n|---|---|---|---|---|\n| `data[].title` | body | string | sim | Título |\n| `data[].description` | body | string | sim | Descrição |\n| `data[].expiredAt` | body | ISO 8601 | não | Prazo para assinar. No mínimo amanhã |\n| `data[].notificationChannel` | body | enum | não | `EMAIL` (padrão) ou `WHATSAPP`. Com WhatsApp, todo signatário precisa de `phone` e há consumo de créditos de notificação |\n| `data[].validationByIcp` | body | boolean | não | Assinatura com certificado ICP-Brasil. Só se a empresa tiver ICP liberado |\n| `data[].folderId` | body | uuid | não | Pasta onde o envelope fica |\n| `data[].allowAutoResend` | body | boolean | não | Reenviar o convite automaticamente a quem não assinou |\n| `data[].resendIntervalDays` | body | string | não | Intervalo do reenvio automático, em dias (ex.: `\"3\"`) |\n\n**Resposta 201**\n\n```json\n{\n  \"totalElements\": 1,\n  \"envelopes\": [\n    {\n      \"id\": \"3fa85f64-5717-4562-b3fc-2c963f66afa6\",\n      \"title\": \"Contrato de Prestação de Serviços\",\n      \"description\": \"Contrato anual com a empresa X\",\n      \"status\": \"DRAFT\",\n      \"companyId\": \"3fa85f64-5717-4562-b3fc-2c963f66afa6\",\n      \"expiredAt\": \"2026-10-28T12:00:00.000Z\",\n      \"notificationChannel\": \"EMAIL\",\n      \"validationByIcp\": false,\n      \"createdAt\": \"2026-10-13T12:00:00.000Z\"\n    }\n  ]\n}\n```\n\n**Erros comuns**\n\n- 400 `Company not authorized`: `validationByIcp` sem ICP liberado\n- 400 data de expiração anterior a amanhã",
                "body": {
                  "mode": "raw",
                  "raw": "{\n  \"data\": [\n    {\n      \"title\": \"Contrato de Prestação de Serviços\",\n      \"description\": \"Contrato anual com a empresa X\",\n      \"expiredAt\": \"{{expiredAt}}\",\n      \"notificationChannel\": \"EMAIL\"\n    }\n  ]\n}",
                  "options": {
                    "raw": {
                      "language": "json"
                    }
                  }
                }
              },
              "response": [
                {
                  "name": "Exemplo 201",
                  "originalRequest": {
                    "method": "POST",
                    "header": [],
                    "url": {
                      "raw": "{{baseUrl}}/v1/envelopes",
                      "host": [
                        "{{baseUrl}}"
                      ],
                      "path": [
                        "v1",
                        "envelopes"
                      ]
                    }
                  },
                  "status": "OK",
                  "code": 201,
                  "_postman_previewlanguage": "json",
                  "header": [
                    {
                      "key": "Content-Type",
                      "value": "application/json"
                    }
                  ],
                  "body": "{\n  \"totalElements\": 1,\n  \"envelopes\": [\n    {\n      \"id\": \"3fa85f64-5717-4562-b3fc-2c963f66afa6\",\n      \"title\": \"Contrato de Prestação de Serviços\",\n      \"description\": \"Contrato anual com a empresa X\",\n      \"status\": \"DRAFT\",\n      \"companyId\": \"3fa85f64-5717-4562-b3fc-2c963f66afa6\",\n      \"expiredAt\": \"2026-10-28T12:00:00.000Z\",\n      \"notificationChannel\": \"EMAIL\",\n      \"validationByIcp\": false,\n      \"createdAt\": \"2026-10-13T12:00:00.000Z\"\n    }\n  ]\n}"
                }
              ]
            },
            {
              "name": "Vincular documentos ao envelope",
              "event": [
                {
                  "listen": "test",
                  "script": {
                    "type": "text/javascript",
                    "exec": [
                      "pm.test('Resposta 2xx', () => pm.expect(pm.response.code).to.be.within(200, 299));",
                      "if (pm.response.code >= 400) {",
                      "  try { console.warn('Erro da API:', JSON.stringify(pm.response.json())); } catch (e) {}",
                      "}"
                    ]
                  }
                }
              ],
              "request": {
                "method": "POST",
                "header": [
                  {
                    "key": "Content-Type",
                    "value": "application/json"
                  },
                  {
                    "key": "Idempotency-Key",
                    "value": "{{$guid}}",
                    "description": "Em retry da MESMA operação, reenvie o mesmo valor."
                  }
                ],
                "url": {
                  "raw": "{{baseUrl}}/v1/envelopes/set/documents",
                  "host": [
                    "{{baseUrl}}"
                  ],
                  "path": [
                    "v1",
                    "envelopes",
                    "set",
                    "documents"
                  ]
                },
                "description": "Coloca documentos dentro do envelope. O envelope precisa estar em `DRAFT` (ou `BLOCK`). A ordem do array `documents` é a ordem no envelope.\n\nPara **desvincular**, use a mesma rota com `remove` no lugar de `set`: `POST /v1/envelopes/remove/documents`.\n\nAceita `Idempotency-Key` (a collection gera um automaticamente).\n\n| Campo | Onde | Tipo | Obrigatório | Descrição |\n|---|---|---|---|---|\n| `method` | path | enum | sim | `set` (vincular) ou `remove` (desvincular) |\n| `data[].envelopeId` | body | uuid | sim | Envelope |\n| `data[].documents[].id` | body | uuid | sim | Documento |\n\n**Resposta 201**\n\n```json\n{\n  \"totalElements\": 1,\n  \"entities\": [\n    {\n      \"envelopeId\": \"3fa85f64-5717-4562-b3fc-2c963f66afa6\",\n      \"originalDocumentId\": \"3fa85f64-5717-4562-b3fc-2c963f66afa6\",\n      \"order\": 1\n    }\n  ]\n}\n```\n\n**Erros comuns**\n\n- 400 `Document already in envelope`\n- 400 envelope fora de `DRAFT`/`BLOCK`",
                "body": {
                  "mode": "raw",
                  "raw": "{\n  \"data\": [\n    {\n      \"envelopeId\": \"{{envelopeId}}\",\n      \"documents\": [\n        {\n          \"id\": \"{{documentId}}\"\n        }\n      ]\n    }\n  ]\n}",
                  "options": {
                    "raw": {
                      "language": "json"
                    }
                  }
                }
              },
              "response": [
                {
                  "name": "Exemplo 201",
                  "originalRequest": {
                    "method": "POST",
                    "header": [],
                    "url": {
                      "raw": "{{baseUrl}}/v1/envelopes/set/documents",
                      "host": [
                        "{{baseUrl}}"
                      ],
                      "path": [
                        "v1",
                        "envelopes",
                        "set",
                        "documents"
                      ]
                    }
                  },
                  "status": "OK",
                  "code": 201,
                  "_postman_previewlanguage": "json",
                  "header": [
                    {
                      "key": "Content-Type",
                      "value": "application/json"
                    }
                  ],
                  "body": "{\n  \"totalElements\": 1,\n  \"entities\": [\n    {\n      \"envelopeId\": \"3fa85f64-5717-4562-b3fc-2c963f66afa6\",\n      \"originalDocumentId\": \"3fa85f64-5717-4562-b3fc-2c963f66afa6\",\n      \"order\": 1\n    }\n  ]\n}"
                }
              ]
            },
            {
              "name": "Reordenar documentos",
              "event": [
                {
                  "listen": "test",
                  "script": {
                    "type": "text/javascript",
                    "exec": [
                      "pm.test('Resposta 2xx', () => pm.expect(pm.response.code).to.be.within(200, 299));",
                      "if (pm.response.code >= 400) {",
                      "  try { console.warn('Erro da API:', JSON.stringify(pm.response.json())); } catch (e) {}",
                      "}"
                    ]
                  }
                }
              ],
              "request": {
                "method": "PUT",
                "header": [
                  {
                    "key": "Content-Type",
                    "value": "application/json"
                  }
                ],
                "url": {
                  "raw": "{{baseUrl}}/v1/envelopes/documents-order",
                  "host": [
                    "{{baseUrl}}"
                  ],
                  "path": [
                    "v1",
                    "envelopes",
                    "documents-order"
                  ]
                },
                "description": "Define a nova ordem dos documentos. `documentIds` deve conter **todos** os documentos do envelope, sem repetir. Envelope em `DRAFT`.\n\n| Campo | Onde | Tipo | Obrigatório | Descrição |\n|---|---|---|---|---|\n| `data[].envelopeId` | body | uuid | sim | Envelope |\n| `data[].documentIds` | body | uuid[] | sim | IDs na nova ordem |\n\n**Resposta 200**\n\n```json\n{\n  \"totalElements\": 1,\n  \"entities\": [\n    {\n      \"envelopeId\": \"3fa85f64-5717-4562-b3fc-2c963f66afa6\",\n      \"originalDocumentId\": \"3fa85f64-5717-4562-b3fc-2c963f66afa6\",\n      \"order\": 1\n    }\n  ]\n}\n```",
                "body": {
                  "mode": "raw",
                  "raw": "{\n  \"data\": [\n    {\n      \"envelopeId\": \"{{envelopeId}}\",\n      \"documentIds\": [\n        \"{{documentId}}\"\n      ]\n    }\n  ]\n}",
                  "options": {
                    "raw": {
                      "language": "json"
                    }
                  }
                }
              },
              "response": [
                {
                  "name": "Exemplo 200",
                  "originalRequest": {
                    "method": "PUT",
                    "header": [],
                    "url": {
                      "raw": "{{baseUrl}}/v1/envelopes/documents-order",
                      "host": [
                        "{{baseUrl}}"
                      ],
                      "path": [
                        "v1",
                        "envelopes",
                        "documents-order"
                      ]
                    }
                  },
                  "status": "OK",
                  "code": 200,
                  "_postman_previewlanguage": "json",
                  "header": [
                    {
                      "key": "Content-Type",
                      "value": "application/json"
                    }
                  ],
                  "body": "{\n  \"totalElements\": 1,\n  \"entities\": [\n    {\n      \"envelopeId\": \"3fa85f64-5717-4562-b3fc-2c963f66afa6\",\n      \"originalDocumentId\": \"3fa85f64-5717-4562-b3fc-2c963f66afa6\",\n      \"order\": 1\n    }\n  ]\n}"
                }
              ]
            },
            {
              "name": "Lacrar e enviar para assinatura",
              "event": [
                {
                  "listen": "test",
                  "script": {
                    "type": "text/javascript",
                    "exec": [
                      "pm.test('Resposta 2xx', () => pm.expect(pm.response.code).to.be.within(200, 299));",
                      "if (pm.response.code >= 400) {",
                      "  try { console.warn('Erro da API:', JSON.stringify(pm.response.json())); } catch (e) {}",
                      "}"
                    ]
                  }
                }
              ],
              "request": {
                "method": "PUT",
                "header": [
                  {
                    "key": "Content-Type",
                    "value": "application/json"
                  },
                  {
                    "key": "Idempotency-Key",
                    "value": "{{$guid}}",
                    "description": "Em retry da MESMA operação, reenvie o mesmo valor."
                  }
                ],
                "url": {
                  "raw": "{{baseUrl}}/v1/envelopes/close",
                  "host": [
                    "{{baseUrl}}"
                  ],
                  "path": [
                    "v1",
                    "envelopes",
                    "close"
                  ]
                },
                "description": "Lacra o envelope, **debita os créditos** e dispara os convites aos signatários. Use sempre `Idempotency-Key`: se houver timeout e você repetir com a mesma chave, não há cobrança dupla.\n\nRequisitos: envelope em `DRAFT` (ou `BLOCK`), ao menos 1 documento e 1 signatário, créditos suficientes. Com canal WhatsApp, todo signatário precisa de telefone válido.\n\nA resposta traz o status `CREATED`; em segundos ele passa a `WAITING_SIGNATURE`.\n\nAceita `Idempotency-Key` (a collection gera um automaticamente).\n\n| Campo | Onde | Tipo | Obrigatório | Descrição |\n|---|---|---|---|---|\n| `data[].id` | body | uuid | sim | Envelope |\n\n**Resposta 200**\n\n```json\n{\n  \"totalElements\": 1,\n  \"envelopes\": [\n    {\n      \"id\": \"3fa85f64-5717-4562-b3fc-2c963f66afa6\",\n      \"status\": \"CREATED\"\n    }\n  ]\n}\n```\n\n**Erros comuns**\n\n- 400 `Some Envelope not found in database`: id inexistente ou de outra empresa\n- 400 `Some Envelopes does not have a draft status`\n- 400 `Some Envelope does not have a document`\n- 400 `Some Envelope does not have a signer`\n- 400 `Company does not have enough credit`\n- 400 `Invalid phone number`: canal WhatsApp com signatário sem telefone E.164",
                "body": {
                  "mode": "raw",
                  "raw": "{\n  \"data\": [\n    {\n      \"id\": \"{{envelopeId}}\"\n    }\n  ]\n}",
                  "options": {
                    "raw": {
                      "language": "json"
                    }
                  }
                }
              },
              "response": [
                {
                  "name": "Exemplo 200",
                  "originalRequest": {
                    "method": "PUT",
                    "header": [],
                    "url": {
                      "raw": "{{baseUrl}}/v1/envelopes/close",
                      "host": [
                        "{{baseUrl}}"
                      ],
                      "path": [
                        "v1",
                        "envelopes",
                        "close"
                      ]
                    }
                  },
                  "status": "OK",
                  "code": 200,
                  "_postman_previewlanguage": "json",
                  "header": [
                    {
                      "key": "Content-Type",
                      "value": "application/json"
                    }
                  ],
                  "body": "{\n  \"totalElements\": 1,\n  \"envelopes\": [\n    {\n      \"id\": \"3fa85f64-5717-4562-b3fc-2c963f66afa6\",\n      \"status\": \"CREATED\"\n    }\n  ]\n}"
                }
              ]
            },
            {
              "name": "Listar e consultar envelopes",
              "event": [
                {
                  "listen": "test",
                  "script": {
                    "type": "text/javascript",
                    "exec": [
                      "pm.test('Resposta 2xx', () => pm.expect(pm.response.code).to.be.within(200, 299));",
                      "if (pm.response.code >= 400) {",
                      "  try { console.warn('Erro da API:', JSON.stringify(pm.response.json())); } catch (e) {}",
                      "}"
                    ]
                  }
                }
              ],
              "request": {
                "method": "GET",
                "header": [],
                "url": {
                  "raw": "{{baseUrl}}/v1/envelopes?filters=status:WAITING_SIGNATURE&sortBy=createdAt:DESC&page=1&pageSize=20",
                  "host": [
                    "{{baseUrl}}"
                  ],
                  "path": [
                    "v1",
                    "envelopes"
                  ],
                  "query": [
                    {
                      "key": "filters",
                      "value": "status:WAITING_SIGNATURE"
                    },
                    {
                      "key": "sortBy",
                      "value": "createdAt:DESC"
                    },
                    {
                      "key": "page",
                      "value": "1"
                    },
                    {
                      "key": "pageSize",
                      "value": "20"
                    }
                  ]
                },
                "description": "Lista os envelopes da empresa com filtros, ordenação, paginação e relacionamentos (ver **Filtros e paginação**).\n\n- Campos filtráveis: `id`, `title`, `description`, `status`, `expiredAt`, `createdAt`, `updatedAt`.\n- `includes`: `envelopeSigners`, `envelopeSigners.signer`, `envelopeDocuments`, `envelopeDocuments.originalDocument`, `envelopeDocuments.tags`, `user`.\n\nConsultar **um** envelope com tudo: `filters=id:<envelopeId>&includes=envelopeSigners,envelopeSigners.signer,envelopeDocuments`.\n\n**Resposta 200**\n\n```json\n{\n  \"currentPage\": 1,\n  \"pageSize\": 20,\n  \"totalPages\": 1,\n  \"totalElements\": 1,\n  \"envelopes\": [\n    {\n      \"id\": \"3fa85f64-5717-4562-b3fc-2c963f66afa6\",\n      \"title\": \"Contrato\",\n      \"status\": \"WAITING_SIGNATURE\",\n      \"expiredAt\": \"2026-10-28T12:00:00.000Z\",\n      \"createdAt\": \"2026-10-13T12:00:00.000Z\",\n      \"envelopeSigners\": [\n        {\n          \"signerId\": \"3fa85f64-5717-4562-b3fc-2c963f66afa6\",\n          \"order\": 0,\n          \"signatureType\": \"PARTY\",\n          \"status\": \"PENDING\",\n          \"signer\": {\n            \"fullName\": \"Maria Souza\",\n            \"email\": \"maria@exemplo.com.br\"\n          }\n        }\n      ]\n    }\n  ]\n}\n```"
              },
              "response": [
                {
                  "name": "Exemplo 200",
                  "originalRequest": {
                    "method": "GET",
                    "header": [],
                    "url": {
                      "raw": "{{baseUrl}}/v1/envelopes?filters=status:WAITING_SIGNATURE&sortBy=createdAt:DESC&page=1&pageSize=20",
                      "host": [
                        "{{baseUrl}}"
                      ],
                      "path": [
                        "v1",
                        "envelopes"
                      ],
                      "query": [
                        {
                          "key": "filters",
                          "value": "status:WAITING_SIGNATURE"
                        },
                        {
                          "key": "sortBy",
                          "value": "createdAt:DESC"
                        },
                        {
                          "key": "page",
                          "value": "1"
                        },
                        {
                          "key": "pageSize",
                          "value": "20"
                        }
                      ]
                    }
                  },
                  "status": "OK",
                  "code": 200,
                  "_postman_previewlanguage": "json",
                  "header": [
                    {
                      "key": "Content-Type",
                      "value": "application/json"
                    }
                  ],
                  "body": "{\n  \"currentPage\": 1,\n  \"pageSize\": 20,\n  \"totalPages\": 1,\n  \"totalElements\": 1,\n  \"envelopes\": [\n    {\n      \"id\": \"3fa85f64-5717-4562-b3fc-2c963f66afa6\",\n      \"title\": \"Contrato\",\n      \"status\": \"WAITING_SIGNATURE\",\n      \"expiredAt\": \"2026-10-28T12:00:00.000Z\",\n      \"createdAt\": \"2026-10-13T12:00:00.000Z\",\n      \"envelopeSigners\": [\n        {\n          \"signerId\": \"3fa85f64-5717-4562-b3fc-2c963f66afa6\",\n          \"order\": 0,\n          \"signatureType\": \"PARTY\",\n          \"status\": \"PENDING\",\n          \"signer\": {\n            \"fullName\": \"Maria Souza\",\n            \"email\": \"maria@exemplo.com.br\"\n          }\n        }\n      ]\n    }\n  ]\n}"
                }
              ]
            },
            {
              "name": "Baixar documentos do envelope (inclui o PDF assinado)",
              "event": [
                {
                  "listen": "test",
                  "script": {
                    "type": "text/javascript",
                    "exec": [
                      "pm.test('Resposta 2xx', () => pm.expect(pm.response.code).to.be.within(200, 299));",
                      "if (pm.response.code >= 400) {",
                      "  try { console.warn('Erro da API:', JSON.stringify(pm.response.json())); } catch (e) {}",
                      "}"
                    ]
                  }
                }
              ],
              "request": {
                "method": "GET",
                "header": [],
                "url": {
                  "raw": "{{baseUrl}}/v1/envelopes/{{envelopeId}}/documents",
                  "host": [
                    "{{baseUrl}}"
                  ],
                  "path": [
                    "v1",
                    "envelopes",
                    "{{envelopeId}}",
                    "documents"
                  ]
                },
                "description": "Devolve links de download (válidos por **5 minutos**) de cada documento do envelope:\n\n- `original`: o PDF enviado.\n- `signed`: o PDF final assinado, com a página de evidências. Só existe quando o envelope está `COMPLETED`. `type` é `ICP` quando houve assinatura ICP-Brasil, senão `SUMMARY`.\n\nChame de novo quando precisar de um link novo.\n\n| Campo | Onde | Tipo | Obrigatório | Descrição |\n|---|---|---|---|---|\n| `envelopeId` | path | uuid | sim | Envelope |\n\n**Resposta 200**\n\n```json\n{\n  \"envelopeId\": \"3fa85f64-5717-4562-b3fc-2c963f66afa6\",\n  \"status\": \"COMPLETED\",\n  \"expiresIn\": 300,\n  \"documents\": [\n    {\n      \"order\": 1,\n      \"original\": {\n        \"id\": \"3fa85f64-5717-4562-b3fc-2c963f66afa6\",\n        \"alias\": \"Contrato.pdf\",\n        \"url\": \"https://...presigned...\"\n      },\n      \"signed\": {\n        \"id\": \"3fa85f64-5717-4562-b3fc-2c963f66afa6\",\n        \"alias\": \"Contrato.pdf\",\n        \"url\": \"https://...presigned...\",\n        \"type\": \"SUMMARY\"\n      }\n    }\n  ]\n}\n```\n\n**Erros comuns**\n\n- 404 `Envelope not found`"
              },
              "response": [
                {
                  "name": "Exemplo 200",
                  "originalRequest": {
                    "method": "GET",
                    "header": [],
                    "url": {
                      "raw": "{{baseUrl}}/v1/envelopes/{{envelopeId}}/documents",
                      "host": [
                        "{{baseUrl}}"
                      ],
                      "path": [
                        "v1",
                        "envelopes",
                        "{{envelopeId}}",
                        "documents"
                      ]
                    }
                  },
                  "status": "OK",
                  "code": 200,
                  "_postman_previewlanguage": "json",
                  "header": [
                    {
                      "key": "Content-Type",
                      "value": "application/json"
                    }
                  ],
                  "body": "{\n  \"envelopeId\": \"3fa85f64-5717-4562-b3fc-2c963f66afa6\",\n  \"status\": \"COMPLETED\",\n  \"expiresIn\": 300,\n  \"documents\": [\n    {\n      \"order\": 1,\n      \"original\": {\n        \"id\": \"3fa85f64-5717-4562-b3fc-2c963f66afa6\",\n        \"alias\": \"Contrato.pdf\",\n        \"url\": \"https://...presigned...\"\n      },\n      \"signed\": {\n        \"id\": \"3fa85f64-5717-4562-b3fc-2c963f66afa6\",\n        \"alias\": \"Contrato.pdf\",\n        \"url\": \"https://...presigned...\",\n        \"type\": \"SUMMARY\"\n      }\n    }\n  ]\n}"
                }
              ]
            },
            {
              "name": "Editar envelope",
              "event": [
                {
                  "listen": "test",
                  "script": {
                    "type": "text/javascript",
                    "exec": [
                      "pm.test('Resposta 2xx', () => pm.expect(pm.response.code).to.be.within(200, 299));",
                      "if (pm.response.code >= 400) {",
                      "  try { console.warn('Erro da API:', JSON.stringify(pm.response.json())); } catch (e) {}",
                      "}"
                    ]
                  }
                }
              ],
              "request": {
                "method": "PUT",
                "header": [
                  {
                    "key": "Content-Type",
                    "value": "application/json"
                  }
                ],
                "url": {
                  "raw": "{{baseUrl}}/v1/envelopes/edit",
                  "host": [
                    "{{baseUrl}}"
                  ],
                  "path": [
                    "v1",
                    "envelopes",
                    "edit"
                  ]
                },
                "description": "Altera título, descrição, prazo ou ICP. Permitido antes de qualquer assinatura. `validationByIcp` só pode mudar em `DRAFT`/`BLOCK` e exige ICP liberado na empresa. O status **não** pode ser alterado por aqui.\n\n| Campo | Onde | Tipo | Obrigatório | Descrição |\n|---|---|---|---|---|\n| `data[].id` | body | uuid | sim | Envelope |\n| `data[].title` | body | string | não |  |\n| `data[].description` | body | string | não |  |\n| `data[].expiredAt` | body | ISO 8601 | não |  |\n| `data[].validationByIcp` | body | boolean | não |  |\n\n**Resposta 200**\n\n```json\n{\n  \"totalElements\": 1,\n  \"envelopes\": [\n    {\n      \"id\": \"3fa85f64-5717-4562-b3fc-2c963f66afa6\",\n      \"title\": \"Contrato de Prestação de Serviços (rev. 2)\"\n    }\n  ]\n}\n```\n\n**Erros comuns**\n\n- 400 `Envelope status cannot be changed through edit`\n- 400 `This company does not have permission to use the ICP`",
                "body": {
                  "mode": "raw",
                  "raw": "{\n  \"data\": [\n    {\n      \"id\": \"{{envelopeId}}\",\n      \"title\": \"Contrato de Prestação de Serviços (rev. 2)\"\n    }\n  ]\n}",
                  "options": {
                    "raw": {
                      "language": "json"
                    }
                  }
                }
              },
              "response": [
                {
                  "name": "Exemplo 200",
                  "originalRequest": {
                    "method": "PUT",
                    "header": [],
                    "url": {
                      "raw": "{{baseUrl}}/v1/envelopes/edit",
                      "host": [
                        "{{baseUrl}}"
                      ],
                      "path": [
                        "v1",
                        "envelopes",
                        "edit"
                      ]
                    }
                  },
                  "status": "OK",
                  "code": 200,
                  "_postman_previewlanguage": "json",
                  "header": [
                    {
                      "key": "Content-Type",
                      "value": "application/json"
                    }
                  ],
                  "body": "{\n  \"totalElements\": 1,\n  \"envelopes\": [\n    {\n      \"id\": \"3fa85f64-5717-4562-b3fc-2c963f66afa6\",\n      \"title\": \"Contrato de Prestação de Serviços (rev. 2)\"\n    }\n  ]\n}"
                }
              ]
            },
            {
              "name": "Bloquear / desbloquear",
              "event": [
                {
                  "listen": "test",
                  "script": {
                    "type": "text/javascript",
                    "exec": [
                      "pm.test('Resposta 2xx', () => pm.expect(pm.response.code).to.be.within(200, 299));",
                      "if (pm.response.code >= 400) {",
                      "  try { console.warn('Erro da API:', JSON.stringify(pm.response.json())); } catch (e) {}",
                      "}"
                    ]
                  }
                }
              ],
              "request": {
                "method": "PUT",
                "header": [
                  {
                    "key": "Content-Type",
                    "value": "application/json"
                  }
                ],
                "url": {
                  "raw": "{{baseUrl}}/v1/envelopes/block-envelope",
                  "host": [
                    "{{baseUrl}}"
                  ],
                  "path": [
                    "v1",
                    "envelopes",
                    "block-envelope"
                  ]
                },
                "description": "Alterna o estado: `WAITING_SIGNATURE` → `BLOCK` (pausa as assinaturas) e `BLOCK` → `WAITING_SIGNATURE`. Não funciona se algum signatário já concluiu (inclusive `CARBON_COPY`, que conclui ao lacrar).\n\n| Campo | Onde | Tipo | Obrigatório | Descrição |\n|---|---|---|---|---|\n| `data[].id` | body | uuid | sim | Envelope |\n\n**Resposta 200**\n\n```json\n{\n  \"totalElements\": 1,\n  \"envelopes\": [\n    {\n      \"id\": \"3fa85f64-5717-4562-b3fc-2c963f66afa6\",\n      \"status\": \"BLOCK\"\n    }\n  ]\n}\n```",
                "body": {
                  "mode": "raw",
                  "raw": "{\n  \"data\": [\n    {\n      \"id\": \"{{envelopeId}}\"\n    }\n  ]\n}",
                  "options": {
                    "raw": {
                      "language": "json"
                    }
                  }
                }
              },
              "response": [
                {
                  "name": "Exemplo 200",
                  "originalRequest": {
                    "method": "PUT",
                    "header": [],
                    "url": {
                      "raw": "{{baseUrl}}/v1/envelopes/block-envelope",
                      "host": [
                        "{{baseUrl}}"
                      ],
                      "path": [
                        "v1",
                        "envelopes",
                        "block-envelope"
                      ]
                    }
                  },
                  "status": "OK",
                  "code": 200,
                  "_postman_previewlanguage": "json",
                  "header": [
                    {
                      "key": "Content-Type",
                      "value": "application/json"
                    }
                  ],
                  "body": "{\n  \"totalElements\": 1,\n  \"envelopes\": [\n    {\n      \"id\": \"3fa85f64-5717-4562-b3fc-2c963f66afa6\",\n      \"status\": \"BLOCK\"\n    }\n  ]\n}"
                }
              ]
            },
            {
              "name": "Cancelar envelope",
              "event": [
                {
                  "listen": "test",
                  "script": {
                    "type": "text/javascript",
                    "exec": [
                      "pm.test('Resposta 2xx', () => pm.expect(pm.response.code).to.be.within(200, 299));",
                      "if (pm.response.code >= 400) {",
                      "  try { console.warn('Erro da API:', JSON.stringify(pm.response.json())); } catch (e) {}",
                      "}"
                    ]
                  }
                }
              ],
              "request": {
                "method": "PUT",
                "header": [
                  {
                    "key": "Content-Type",
                    "value": "application/json"
                  }
                ],
                "url": {
                  "raw": "{{baseUrl}}/v1/envelopes/cancel",
                  "host": [
                    "{{baseUrl}}"
                  ],
                  "path": [
                    "v1",
                    "envelopes",
                    "cancel"
                  ]
                },
                "description": "Cancela o envelope (`CANCELED`). Os links de assinatura deixam de funcionar e o webhook `ENVELOPE_CANCELLED` é disparado. Não pode ser desfeito.\n\n| Campo | Onde | Tipo | Obrigatório | Descrição |\n|---|---|---|---|---|\n| `data[].id` | body | uuid | sim | Envelope |\n\n**Resposta 200**\n\n```json\n{\n  \"totalElements\": 1,\n  \"envelopes\": [\n    {\n      \"id\": \"3fa85f64-5717-4562-b3fc-2c963f66afa6\",\n      \"status\": \"CANCELED\"\n    }\n  ]\n}\n```",
                "body": {
                  "mode": "raw",
                  "raw": "{\n  \"data\": [\n    {\n      \"id\": \"{{envelopeId}}\"\n    }\n  ]\n}",
                  "options": {
                    "raw": {
                      "language": "json"
                    }
                  }
                }
              },
              "response": [
                {
                  "name": "Exemplo 200",
                  "originalRequest": {
                    "method": "PUT",
                    "header": [],
                    "url": {
                      "raw": "{{baseUrl}}/v1/envelopes/cancel",
                      "host": [
                        "{{baseUrl}}"
                      ],
                      "path": [
                        "v1",
                        "envelopes",
                        "cancel"
                      ]
                    }
                  },
                  "status": "OK",
                  "code": 200,
                  "_postman_previewlanguage": "json",
                  "header": [
                    {
                      "key": "Content-Type",
                      "value": "application/json"
                    }
                  ],
                  "body": "{\n  \"totalElements\": 1,\n  \"envelopes\": [\n    {\n      \"id\": \"3fa85f64-5717-4562-b3fc-2c963f66afa6\",\n      \"status\": \"CANCELED\"\n    }\n  ]\n}"
                }
              ]
            },
            {
              "name": "Excluir rascunho",
              "event": [
                {
                  "listen": "test",
                  "script": {
                    "type": "text/javascript",
                    "exec": [
                      "pm.test('Resposta 2xx', () => pm.expect(pm.response.code).to.be.within(200, 299));",
                      "if (pm.response.code >= 400) {",
                      "  try { console.warn('Erro da API:', JSON.stringify(pm.response.json())); } catch (e) {}",
                      "}"
                    ]
                  }
                }
              ],
              "request": {
                "method": "DELETE",
                "header": [],
                "url": {
                  "raw": "{{baseUrl}}/v1/envelopes/{{envelopeId}}",
                  "host": [
                    "{{baseUrl}}"
                  ],
                  "path": [
                    "v1",
                    "envelopes",
                    "{{envelopeId}}"
                  ]
                },
                "description": "Exclui um envelope em `DRAFT`. Para envelopes já enviados, use cancelar.\n\n| Campo | Onde | Tipo | Obrigatório | Descrição |\n|---|---|---|---|---|\n| `envelopeId` | path | uuid | sim | Envelope |\n\n**Resposta 200**\n\n```json\n{\n  \"totalElements\": 1,\n  \"envelopes\": [\n    {\n      \"id\": \"3fa85f64-5717-4562-b3fc-2c963f66afa6\"\n    }\n  ]\n}\n```\n\n**Erros comuns**\n\n- 400 `Status of envelope is not DRAFT`"
              },
              "response": [
                {
                  "name": "Exemplo 200",
                  "originalRequest": {
                    "method": "DELETE",
                    "header": [],
                    "url": {
                      "raw": "{{baseUrl}}/v1/envelopes/{{envelopeId}}",
                      "host": [
                        "{{baseUrl}}"
                      ],
                      "path": [
                        "v1",
                        "envelopes",
                        "{{envelopeId}}"
                      ]
                    }
                  },
                  "status": "OK",
                  "code": 200,
                  "_postman_previewlanguage": "json",
                  "header": [
                    {
                      "key": "Content-Type",
                      "value": "application/json"
                    }
                  ],
                  "body": "{\n  \"totalElements\": 1,\n  \"envelopes\": [\n    {\n      \"id\": \"3fa85f64-5717-4562-b3fc-2c963f66afa6\"\n    }\n  ]\n}"
                }
              ]
            },
            {
              "name": "Resumo de envelopes",
              "event": [
                {
                  "listen": "test",
                  "script": {
                    "type": "text/javascript",
                    "exec": [
                      "pm.test('Resposta 2xx', () => pm.expect(pm.response.code).to.be.within(200, 299));",
                      "if (pm.response.code >= 400) {",
                      "  try { console.warn('Erro da API:', JSON.stringify(pm.response.json())); } catch (e) {}",
                      "}"
                    ]
                  }
                }
              ],
              "request": {
                "method": "GET",
                "header": [],
                "url": {
                  "raw": "{{baseUrl}}/v1/envelopes/stats-created",
                  "host": [
                    "{{baseUrl}}"
                  ],
                  "path": [
                    "v1",
                    "envelopes",
                    "stats-created"
                  ]
                },
                "description": "Totais de envelopes da empresa.\n\n**Resposta 200**\n\n```json\n{\n  \"allEnvelopes\": 120,\n  \"processing\": 14,\n  \"rejected\": 3,\n  \"finished\": 103\n}\n```"
              },
              "response": [
                {
                  "name": "Exemplo 200",
                  "originalRequest": {
                    "method": "GET",
                    "header": [],
                    "url": {
                      "raw": "{{baseUrl}}/v1/envelopes/stats-created",
                      "host": [
                        "{{baseUrl}}"
                      ],
                      "path": [
                        "v1",
                        "envelopes",
                        "stats-created"
                      ]
                    }
                  },
                  "status": "OK",
                  "code": 200,
                  "_postman_previewlanguage": "json",
                  "header": [
                    {
                      "key": "Content-Type",
                      "value": "application/json"
                    }
                  ],
                  "body": "{\n  \"allEnvelopes\": 120,\n  \"processing\": 14,\n  \"rejected\": 3,\n  \"finished\": 103\n}"
                }
              ]
            }
          ]
        },
        {
          "name": "✍️ Signatários",
          "description": "Quem assina (ou aprova, testemunha, recebe cópia). Nas rotas de signatários o `envelopeId` fica **fora** do `data`. O identificador de cada signatário no envelope é o `signerId`: ele é usado nos campos de assinatura, no reenvio e no link de assinatura.\n\n**Ordem:** `order: 0` em todos = todos assinam ao mesmo tempo. `order: 1, 2, 3...` = cada um recebe o convite depois que o anterior assina. Não misture 0 com valores maiores.\n\n### Status do signatário\n`PENDING` aguardando · `SIGNED` / `COMPLETED` assinou · `REJECTED` recusou.",
          "item": [
            {
              "name": "Adicionar signatários",
              "event": [
                {
                  "listen": "test",
                  "script": {
                    "type": "text/javascript",
                    "exec": [
                      "pm.test('Resposta 2xx', () => pm.expect(pm.response.code).to.be.within(200, 299));",
                      "if (pm.response.code >= 400) {",
                      "  try { console.warn('Erro da API:', JSON.stringify(pm.response.json())); } catch (e) {}",
                      "}",
                      "const list = pm.response.json().envelopeSigners || [];",
                      "const byEmail = (e) => list.find((s) => (s.signer?.email || s.email) === e) || {};",
                      "pm.collectionVariables.set('signerId', byEmail('maria@exemplo.com.br').signerId || list[0]?.signerId);",
                      "pm.collectionVariables.set('signer2Id', byEmail('joao@exemplo.com.br').signerId || list[1]?.signerId);"
                    ]
                  }
                }
              ],
              "request": {
                "method": "POST",
                "header": [
                  {
                    "key": "Content-Type",
                    "value": "application/json"
                  },
                  {
                    "key": "Idempotency-Key",
                    "value": "{{$guid}}",
                    "description": "Em retry da MESMA operação, reenvie o mesmo valor."
                  }
                ],
                "url": {
                  "raw": "{{baseUrl}}/v1/envelope-signers",
                  "host": [
                    "{{baseUrl}}"
                  ],
                  "path": [
                    "v1",
                    "envelope-signers"
                  ]
                },
                "description": "Adiciona signatários ao envelope. Envelope em `DRAFT` ou `BLOCK`. `email` precisa ser único no envelope.\n\nAceita `Idempotency-Key` (a collection gera um automaticamente).\n\n| Campo | Onde | Tipo | Obrigatório | Descrição |\n|---|---|---|---|---|\n| `envelopeId` | body | uuid | sim | Envelope |\n| `data[].fullName` | body | string | sim | Nome completo |\n| `data[].email` | body | string | sim | E-mail |\n| `data[].order` | body | integer | sim | `0` = paralelo; `1, 2, 3...` = sequencial |\n| `data[].signatureType` | body | enum | sim | `PARTY` (parte), `WITNESS` (testemunha), `APPROVER` (aprovador), `CLIENT`, `SELLER`, `MANAGER`, `ACKNOWLEDGE` (ciência), `ACKNOWLEDGE_RECEIPT` (ciência de recebimento), `CARBON_COPY` (só recebe cópia, não assina) |\n| `data[].requirePersonalDocument` | body | boolean | sim | Pede foto de documento + selfie (validação biométrica) |\n| `data[].requireEmailToken` | body | boolean | sim | Pede código enviado por e-mail antes de assinar |\n| `data[].phone` | body | string | não | Formato E.164: `+5511999999999`. Obrigatório com canal WhatsApp |\n\n**Resposta 201**\n\n```json\n{\n  \"totalElements\": 2,\n  \"envelopeSigners\": [\n    {\n      \"signerId\": \"3fa85f64-5717-4562-b3fc-2c963f66afa6\",\n      \"envelopeId\": \"3fa85f64-5717-4562-b3fc-2c963f66afa6\",\n      \"order\": 0,\n      \"signatureType\": \"PARTY\",\n      \"status\": \"PENDING\",\n      \"requirePersonalDocument\": false,\n      \"requireEmailToken\": false,\n      \"signer\": {\n        \"fullName\": \"Maria Souza\",\n        \"email\": \"maria@exemplo.com.br\"\n      }\n    }\n  ]\n}\n```\n\n**Erros comuns**\n\n- 400 `Signers can only be added while the envelope is in DRAFT or BLOCK`\n- 400 e-mail repetido no envelope\n- 400 `Order must be zero (0)` / `Order must be greater than zero (0)`: mistura de `order` 0 com maior que 0, inclusive com os signatários já existentes",
                "body": {
                  "mode": "raw",
                  "raw": "{\n  \"envelopeId\": \"{{envelopeId}}\",\n  \"data\": [\n    {\n      \"fullName\": \"Maria Souza\",\n      \"email\": \"maria@exemplo.com.br\",\n      \"phone\": \"+5511999999999\",\n      \"order\": 0,\n      \"signatureType\": \"PARTY\",\n      \"requirePersonalDocument\": false,\n      \"requireEmailToken\": false\n    },\n    {\n      \"fullName\": \"João Lima\",\n      \"email\": \"joao@exemplo.com.br\",\n      \"order\": 0,\n      \"signatureType\": \"WITNESS\",\n      \"requirePersonalDocument\": false,\n      \"requireEmailToken\": false\n    }\n  ]\n}",
                  "options": {
                    "raw": {
                      "language": "json"
                    }
                  }
                }
              },
              "response": [
                {
                  "name": "Exemplo 201",
                  "originalRequest": {
                    "method": "POST",
                    "header": [],
                    "url": {
                      "raw": "{{baseUrl}}/v1/envelope-signers",
                      "host": [
                        "{{baseUrl}}"
                      ],
                      "path": [
                        "v1",
                        "envelope-signers"
                      ]
                    }
                  },
                  "status": "OK",
                  "code": 201,
                  "_postman_previewlanguage": "json",
                  "header": [
                    {
                      "key": "Content-Type",
                      "value": "application/json"
                    }
                  ],
                  "body": "{\n  \"totalElements\": 2,\n  \"envelopeSigners\": [\n    {\n      \"signerId\": \"3fa85f64-5717-4562-b3fc-2c963f66afa6\",\n      \"envelopeId\": \"3fa85f64-5717-4562-b3fc-2c963f66afa6\",\n      \"order\": 0,\n      \"signatureType\": \"PARTY\",\n      \"status\": \"PENDING\",\n      \"requirePersonalDocument\": false,\n      \"requireEmailToken\": false,\n      \"signer\": {\n        \"fullName\": \"Maria Souza\",\n        \"email\": \"maria@exemplo.com.br\"\n      }\n    }\n  ]\n}"
                }
              ]
            },
            {
              "name": "Listar signatários do envelope",
              "event": [
                {
                  "listen": "test",
                  "script": {
                    "type": "text/javascript",
                    "exec": [
                      "pm.test('Resposta 2xx', () => pm.expect(pm.response.code).to.be.within(200, 299));",
                      "if (pm.response.code >= 400) {",
                      "  try { console.warn('Erro da API:', JSON.stringify(pm.response.json())); } catch (e) {}",
                      "}"
                    ]
                  }
                }
              ],
              "request": {
                "method": "GET",
                "header": [],
                "url": {
                  "raw": "{{baseUrl}}/v1/envelope-signers?envelopeId={{envelopeId}}",
                  "host": [
                    "{{baseUrl}}"
                  ],
                  "path": [
                    "v1",
                    "envelope-signers"
                  ],
                  "query": [
                    {
                      "key": "envelopeId",
                      "value": "{{envelopeId}}"
                    }
                  ]
                },
                "description": "Lista os signatários de um envelope, na ordem de assinatura, com o status de cada um.\n\n| Campo | Onde | Tipo | Obrigatório | Descrição |\n|---|---|---|---|---|\n| `envelopeId` | query | uuid | sim | Envelope |\n\n**Resposta 200**\n\n```json\n{\n  \"totalElements\": 2,\n  \"envelopeSigners\": [\n    {\n      \"signerId\": \"3fa85f64-5717-4562-b3fc-2c963f66afa6\",\n      \"envelopeId\": \"3fa85f64-5717-4562-b3fc-2c963f66afa6\",\n      \"order\": 0,\n      \"signatureType\": \"PARTY\",\n      \"status\": \"COMPLETED\",\n      \"requirePersonalDocument\": false,\n      \"requireEmailToken\": false,\n      \"createdAt\": \"2026-10-13T12:00:00.000Z\",\n      \"updatedAt\": \"2026-10-13T15:42:00.000Z\",\n      \"signer\": {\n        \"id\": \"3fa85f64-5717-4562-b3fc-2c963f66afa6\",\n        \"fullName\": \"Maria Souza\",\n        \"email\": \"maria@exemplo.com.br\",\n        \"phone\": \"+5511999999999\"\n      }\n    }\n  ]\n}\n```\n\n**Erros comuns**\n\n- 400 `Envelope not found`"
              },
              "response": [
                {
                  "name": "Exemplo 200",
                  "originalRequest": {
                    "method": "GET",
                    "header": [],
                    "url": {
                      "raw": "{{baseUrl}}/v1/envelope-signers?envelopeId={{envelopeId}}",
                      "host": [
                        "{{baseUrl}}"
                      ],
                      "path": [
                        "v1",
                        "envelope-signers"
                      ],
                      "query": [
                        {
                          "key": "envelopeId",
                          "value": "{{envelopeId}}"
                        }
                      ]
                    }
                  },
                  "status": "OK",
                  "code": 200,
                  "_postman_previewlanguage": "json",
                  "header": [
                    {
                      "key": "Content-Type",
                      "value": "application/json"
                    }
                  ],
                  "body": "{\n  \"totalElements\": 2,\n  \"envelopeSigners\": [\n    {\n      \"signerId\": \"3fa85f64-5717-4562-b3fc-2c963f66afa6\",\n      \"envelopeId\": \"3fa85f64-5717-4562-b3fc-2c963f66afa6\",\n      \"order\": 0,\n      \"signatureType\": \"PARTY\",\n      \"status\": \"COMPLETED\",\n      \"requirePersonalDocument\": false,\n      \"requireEmailToken\": false,\n      \"createdAt\": \"2026-10-13T12:00:00.000Z\",\n      \"updatedAt\": \"2026-10-13T15:42:00.000Z\",\n      \"signer\": {\n        \"id\": \"3fa85f64-5717-4562-b3fc-2c963f66afa6\",\n        \"fullName\": \"Maria Souza\",\n        \"email\": \"maria@exemplo.com.br\",\n        \"phone\": \"+5511999999999\"\n      }\n    }\n  ]\n}"
                }
              ]
            },
            {
              "name": "Corrigir dados do signatário",
              "event": [
                {
                  "listen": "test",
                  "script": {
                    "type": "text/javascript",
                    "exec": [
                      "pm.test('Resposta 2xx', () => pm.expect(pm.response.code).to.be.within(200, 299));",
                      "if (pm.response.code >= 400) {",
                      "  try { console.warn('Erro da API:', JSON.stringify(pm.response.json())); } catch (e) {}",
                      "}"
                    ]
                  }
                }
              ],
              "request": {
                "method": "PUT",
                "header": [
                  {
                    "key": "Content-Type",
                    "value": "application/json"
                  }
                ],
                "url": {
                  "raw": "{{baseUrl}}/v1/envelope-signers",
                  "host": [
                    "{{baseUrl}}"
                  ],
                  "path": [
                    "v1",
                    "envelope-signers"
                  ]
                },
                "description": "Corrige nome, e-mail ou telefone de quem ainda não assinou (envelope em `DRAFT` ou `WAITING_SIGNATURE`). Se o e-mail mudar com o envelope já enviado, a Assin reenvia o convite para o novo endereço e passa a exigir código por e-mail. Se a pessoa já assinou **outros** envelopes, nome e e-mail ficam travados (a identidade dela é a mesma em todos): remova o signatário e adicione outro.\n\n| Campo | Onde | Tipo | Obrigatório | Descrição |\n|---|---|---|---|---|\n| `envelopeId` | body | uuid | sim | Envelope |\n| `data[].signerId` | body | uuid | sim | Signatário |\n| `data[].fullName` | body | string | não |  |\n| `data[].email` | body | string | não |  |\n| `data[].phone` | body | string | não | E.164 |\n\n**Resposta 200**\n\n```json\n{\n  \"totalElements\": 1,\n  \"envelopeSigners\": [\n    {\n      \"signerId\": \"3fa85f64-5717-4562-b3fc-2c963f66afa6\",\n      \"status\": \"PENDING\"\n    }\n  ]\n}\n```",
                "body": {
                  "mode": "raw",
                  "raw": "{\n  \"envelopeId\": \"{{envelopeId}}\",\n  \"data\": [\n    {\n      \"signerId\": \"{{signerId}}\",\n      \"email\": \"maria.souza@exemplo.com.br\"\n    }\n  ]\n}",
                  "options": {
                    "raw": {
                      "language": "json"
                    }
                  }
                }
              },
              "response": [
                {
                  "name": "Exemplo 200",
                  "originalRequest": {
                    "method": "PUT",
                    "header": [],
                    "url": {
                      "raw": "{{baseUrl}}/v1/envelope-signers",
                      "host": [
                        "{{baseUrl}}"
                      ],
                      "path": [
                        "v1",
                        "envelope-signers"
                      ]
                    }
                  },
                  "status": "OK",
                  "code": 200,
                  "_postman_previewlanguage": "json",
                  "header": [
                    {
                      "key": "Content-Type",
                      "value": "application/json"
                    }
                  ],
                  "body": "{\n  \"totalElements\": 1,\n  \"envelopeSigners\": [\n    {\n      \"signerId\": \"3fa85f64-5717-4562-b3fc-2c963f66afa6\",\n      \"status\": \"PENDING\"\n    }\n  ]\n}"
                }
              ]
            },
            {
              "name": "Remover signatário",
              "event": [
                {
                  "listen": "test",
                  "script": {
                    "type": "text/javascript",
                    "exec": [
                      "pm.test('Resposta 2xx', () => pm.expect(pm.response.code).to.be.within(200, 299));",
                      "if (pm.response.code >= 400) {",
                      "  try { console.warn('Erro da API:', JSON.stringify(pm.response.json())); } catch (e) {}",
                      "}"
                    ]
                  }
                }
              ],
              "request": {
                "method": "DELETE",
                "header": [
                  {
                    "key": "Content-Type",
                    "value": "application/json"
                  }
                ],
                "url": {
                  "raw": "{{baseUrl}}/v1/envelope-signers",
                  "host": [
                    "{{baseUrl}}"
                  ],
                  "path": [
                    "v1",
                    "envelope-signers"
                  ]
                },
                "description": "Remove signatários que ainda não assinaram. Envelope em `DRAFT`, `BLOCK`, `CREATED` ou `WAITING_SIGNATURE`.\n\n| Campo | Onde | Tipo | Obrigatório | Descrição |\n|---|---|---|---|---|\n| `envelopeId` | body | uuid | sim | Envelope |\n| `data[].signerId` | body | uuid | sim | Signatário |\n\n**Resposta 200**\n\n```json\n{\n  \"totalElements\": 1,\n  \"envelopeSigners\": [\n    {\n      \"signerId\": \"3fa85f64-5717-4562-b3fc-2c963f66afa6\"\n    }\n  ]\n}\n```\n\n**Erros comuns**\n\n- 400 `Envelope signer has already signed and cannot be removed`\n- 400 `Signers cannot be removed from an envelope with this status`",
                "body": {
                  "mode": "raw",
                  "raw": "{\n  \"envelopeId\": \"{{envelopeId}}\",\n  \"data\": [\n    {\n      \"signerId\": \"{{signer2Id}}\"\n    }\n  ]\n}",
                  "options": {
                    "raw": {
                      "language": "json"
                    }
                  }
                }
              },
              "response": [
                {
                  "name": "Exemplo 200",
                  "originalRequest": {
                    "method": "DELETE",
                    "header": [],
                    "url": {
                      "raw": "{{baseUrl}}/v1/envelope-signers",
                      "host": [
                        "{{baseUrl}}"
                      ],
                      "path": [
                        "v1",
                        "envelope-signers"
                      ]
                    }
                  },
                  "status": "OK",
                  "code": 200,
                  "_postman_previewlanguage": "json",
                  "header": [
                    {
                      "key": "Content-Type",
                      "value": "application/json"
                    }
                  ],
                  "body": "{\n  \"totalElements\": 1,\n  \"envelopeSigners\": [\n    {\n      \"signerId\": \"3fa85f64-5717-4562-b3fc-2c963f66afa6\"\n    }\n  ]\n}"
                }
              ]
            },
            {
              "name": "Reenviar convite",
              "event": [
                {
                  "listen": "test",
                  "script": {
                    "type": "text/javascript",
                    "exec": [
                      "pm.test('Resposta 2xx', () => pm.expect(pm.response.code).to.be.within(200, 299));",
                      "if (pm.response.code >= 400) {",
                      "  try { console.warn('Erro da API:', JSON.stringify(pm.response.json())); } catch (e) {}",
                      "}"
                    ]
                  }
                }
              ],
              "request": {
                "method": "POST",
                "header": [
                  {
                    "key": "Content-Type",
                    "value": "application/json"
                  },
                  {
                    "key": "Idempotency-Key",
                    "value": "{{$guid}}",
                    "description": "Em retry da MESMA operação, reenvie o mesmo valor."
                  }
                ],
                "url": {
                  "raw": "{{baseUrl}}/v1/envelope-signers/resend-notification/EMAIL",
                  "host": [
                    "{{baseUrl}}"
                  ],
                  "path": [
                    "v1",
                    "envelope-signers",
                    "resend-notification",
                    "EMAIL"
                  ]
                },
                "description": "Reenvia o convite de assinatura. Canal no fim da URL: `EMAIL`, `WHATSAPP` ou `SMS`.\n\nSó para signatários `PENDING`, com envelope em `WAITING_SIGNATURE`. Intervalo mínimo de 1 minuto entre envios para o mesmo signatário, contando também o convite enviado ao lacrar. Para SMS/WhatsApp, o signatário precisa ter telefone (ou informe `number`).\n\nAceita `Idempotency-Key` (a collection gera um automaticamente).\n\n| Campo | Onde | Tipo | Obrigatório | Descrição |\n|---|---|---|---|---|\n| `type` | path | enum | sim | `EMAIL`, `WHATSAPP` ou `SMS` |\n| `envelopeId` | body | uuid | sim | Envelope |\n| `data[].signerId` | body | uuid | sim | Signatário |\n| `data[].number` | body | string | não | Telefone E.164 para SMS/WhatsApp |\n\n**Resposta:** 201 com corpo vazio.",
                "body": {
                  "mode": "raw",
                  "raw": "{\n  \"envelopeId\": \"{{envelopeId}}\",\n  \"data\": [\n    {\n      \"signerId\": \"{{signerId}}\"\n    }\n  ]\n}",
                  "options": {
                    "raw": {
                      "language": "json"
                    }
                  }
                }
              },
              "response": []
            },
            {
              "name": "Gerar link de assinatura",
              "event": [
                {
                  "listen": "test",
                  "script": {
                    "type": "text/javascript",
                    "exec": [
                      "pm.test('Resposta 2xx', () => pm.expect(pm.response.code).to.be.within(200, 299));",
                      "if (pm.response.code >= 400) {",
                      "  try { console.warn('Erro da API:', JSON.stringify(pm.response.json())); } catch (e) {}",
                      "}"
                    ]
                  }
                }
              ],
              "request": {
                "method": "POST",
                "header": [
                  {
                    "key": "Content-Type",
                    "value": "application/json"
                  }
                ],
                "url": {
                  "raw": "{{baseUrl}}/v1/envelope-signers/signing-link",
                  "host": [
                    "{{baseUrl}}"
                  ],
                  "path": [
                    "v1",
                    "envelope-signers",
                    "signing-link"
                  ]
                },
                "description": "Gera o link para o signatário assinar, para você abrir no seu sistema ou enviar pelo seu canal. Envelope em `WAITING_SIGNATURE`, signatário `PENDING` e que não seja `CARBON_COPY`.\n\n| Campo | Onde | Tipo | Obrigatório | Descrição |\n|---|---|---|---|---|\n| `envelopeId` | body | uuid | sim | Envelope |\n| `data[].signerId` | body | uuid | sim | Signatário |\n\n**Resposta 201**\n\n```json\n{\n  \"totalElements\": 1,\n  \"signingLinks\": [\n    {\n      \"signerId\": \"3fa85f64-5717-4562-b3fc-2c963f66afa6\",\n      \"url\": \"https://sign.assin.com.br/?access=eyJhbGciOi...\"\n    }\n  ]\n}\n```",
                "body": {
                  "mode": "raw",
                  "raw": "{\n  \"envelopeId\": \"{{envelopeId}}\",\n  \"data\": [\n    {\n      \"signerId\": \"{{signerId}}\"\n    }\n  ]\n}",
                  "options": {
                    "raw": {
                      "language": "json"
                    }
                  }
                }
              },
              "response": [
                {
                  "name": "Exemplo 201",
                  "originalRequest": {
                    "method": "POST",
                    "header": [],
                    "url": {
                      "raw": "{{baseUrl}}/v1/envelope-signers/signing-link",
                      "host": [
                        "{{baseUrl}}"
                      ],
                      "path": [
                        "v1",
                        "envelope-signers",
                        "signing-link"
                      ]
                    }
                  },
                  "status": "OK",
                  "code": 201,
                  "_postman_previewlanguage": "json",
                  "header": [
                    {
                      "key": "Content-Type",
                      "value": "application/json"
                    }
                  ],
                  "body": "{\n  \"totalElements\": 1,\n  \"signingLinks\": [\n    {\n      \"signerId\": \"3fa85f64-5717-4562-b3fc-2c963f66afa6\",\n      \"url\": \"https://sign.assin.com.br/?access=eyJhbGciOi...\"\n    }\n  ]\n}"
                }
              ]
            },
            {
              "name": "Resumo dos envelopes em que o usuário da chave assina",
              "event": [
                {
                  "listen": "test",
                  "script": {
                    "type": "text/javascript",
                    "exec": [
                      "pm.test('Resposta 2xx', () => pm.expect(pm.response.code).to.be.within(200, 299));",
                      "if (pm.response.code >= 400) {",
                      "  try { console.warn('Erro da API:', JSON.stringify(pm.response.json())); } catch (e) {}",
                      "}"
                    ]
                  }
                }
              ],
              "request": {
                "method": "GET",
                "header": [],
                "url": {
                  "raw": "{{baseUrl}}/v1/envelope-signers/stats-signer",
                  "host": [
                    "{{baseUrl}}"
                  ],
                  "path": [
                    "v1",
                    "envelope-signers",
                    "stats-signer"
                  ]
                },
                "description": "Totais de envelopes em que o **usuário dono da API Key** é signatário.\n\n**Resposta 200**\n\n```json\n{\n  \"allEnvelopes\": 8,\n  \"processing\": 2,\n  \"rejected\": 0,\n  \"finished\": 6\n}\n```"
              },
              "response": [
                {
                  "name": "Exemplo 200",
                  "originalRequest": {
                    "method": "GET",
                    "header": [],
                    "url": {
                      "raw": "{{baseUrl}}/v1/envelope-signers/stats-signer",
                      "host": [
                        "{{baseUrl}}"
                      ],
                      "path": [
                        "v1",
                        "envelope-signers",
                        "stats-signer"
                      ]
                    }
                  },
                  "status": "OK",
                  "code": 200,
                  "_postman_previewlanguage": "json",
                  "header": [
                    {
                      "key": "Content-Type",
                      "value": "application/json"
                    }
                  ],
                  "body": "{\n  \"allEnvelopes\": 8,\n  \"processing\": 2,\n  \"rejected\": 0,\n  \"finished\": 6\n}"
                }
              ]
            }
          ]
        },
        {
          "name": "🏷 Campos de assinatura (tags)",
          "description": "Definem **onde** cada signatário assina, rubrica ou tem o nome impresso no PDF. São opcionais: sem campos, o signatário assina e a assinatura vai para a página de evidências.\n\n### Coordenadas\n- `axisX` e `axisY` são **frações da página, de 0 a 1**, medidas a partir do **canto superior esquerdo**. O ponto marca o canto superior esquerdo do campo.\n- `axisX: 0.10` = 10% da largura a partir da esquerda; `axisY: 0.80` = 80% da altura a partir do topo.\n- `width` e `height` também são frações (0.01 a 1). Padrão: 0.15 × 0.07.\n- `page` começa em **1**.\n\nExemplo: para um PDF A4 (595 × 842 pt), um campo em x=60pt, y=670pt (do topo) é `axisX = 60/595 ≈ 0.10`, `axisY = 670/842 ≈ 0.80`.",
          "item": [
            {
              "name": "Posicionar campos",
              "event": [
                {
                  "listen": "test",
                  "script": {
                    "type": "text/javascript",
                    "exec": [
                      "pm.test('Resposta 2xx', () => pm.expect(pm.response.code).to.be.within(200, 299));",
                      "if (pm.response.code >= 400) {",
                      "  try { console.warn('Erro da API:', JSON.stringify(pm.response.json())); } catch (e) {}",
                      "}",
                      "const tags = pm.response.json().tags || [];",
                      "if (tags[0]) pm.collectionVariables.set('tagId', tags[0].id);"
                    ]
                  }
                }
              ],
              "request": {
                "method": "POST",
                "header": [
                  {
                    "key": "Content-Type",
                    "value": "application/json"
                  },
                  {
                    "key": "Idempotency-Key",
                    "value": "{{$guid}}",
                    "description": "Em retry da MESMA operação, reenvie o mesmo valor."
                  }
                ],
                "url": {
                  "raw": "{{baseUrl}}/v1/tags",
                  "host": [
                    "{{baseUrl}}"
                  ],
                  "path": [
                    "v1",
                    "tags"
                  ]
                },
                "description": "Cria campos no documento. Envelope em `DRAFT` ou `BLOCK`.\n\nAceita `Idempotency-Key` (a collection gera um automaticamente).\n\n| Campo | Onde | Tipo | Obrigatório | Descrição |\n|---|---|---|---|---|\n| `envelopeId` | body | uuid | sim | Envelope |\n| `data[].envelopeSignerId` | body | uuid | sim | O `signerId` do signatário. Não usado em `TEXT_BOX` |\n| `data[].envelopeDocumentId` | body | uuid | sim | O `id` do documento |\n| `data[].elementType` | body | enum | sim | `SIGNATURE` (assinatura), `RUBRIC` (rubrica), `FULL_NAME` (nome), `EMAIL`, `SIGNATURE_DATETIME` (data/hora da assinatura), `SELECTION_BOX` (caixa de seleção), `TEXT_BOX` (texto livre, sem signatário) |\n| `data[].page` | body | integer | sim | Página (a partir de 1) |\n| `data[].axisX` | body | number | sim | 0 a 1, da esquerda |\n| `data[].axisY` | body | number | sim | 0 a 1, do topo |\n| `data[].width` | body | number | não | 0.01 a 1 |\n| `data[].height` | body | number | não | 0.01 a 1 |\n| `data[].content` | body | string | não | Texto (para `TEXT_BOX`) |\n| `data[].fontFamily` | body | enum | não | `Helvetica`, `Helvetica-Bold`, `Times-Roman`, `Courier` e variações |\n| `data[].fontSize` | body | integer | não | 6 a 96 |\n| `data[].fontColor` | body | string | não | `#RRGGBB` |\n| `data[].angle` | body | number | não | Padrão 0 |\n\n**Resposta 201**\n\n```json\n{\n  \"totalElements\": 3,\n  \"tags\": [\n    {\n      \"id\": \"3fa85f64-5717-4562-b3fc-2c963f66afa6\",\n      \"envelopeSignerId\": \"3fa85f64-5717-4562-b3fc-2c963f66afa6\",\n      \"envelopeDocumentId\": \"3fa85f64-5717-4562-b3fc-2c963f66afa6\",\n      \"envelopeId\": \"3fa85f64-5717-4562-b3fc-2c963f66afa6\",\n      \"elementType\": \"SIGNATURE\",\n      \"page\": 1,\n      \"axisX\": 0.1,\n      \"axisY\": 0.8,\n      \"width\": 0.15,\n      \"height\": 0.07,\n      \"angle\": 0\n    }\n  ]\n}\n```",
                "body": {
                  "mode": "raw",
                  "raw": "{\n  \"envelopeId\": \"{{envelopeId}}\",\n  \"data\": [\n    {\n      \"envelopeSignerId\": \"{{signerId}}\",\n      \"envelopeDocumentId\": \"{{documentId}}\",\n      \"elementType\": \"SIGNATURE\",\n      \"page\": 1,\n      \"axisX\": 0.1,\n      \"axisY\": 0.8\n    },\n    {\n      \"envelopeSignerId\": \"{{signerId}}\",\n      \"envelopeDocumentId\": \"{{documentId}}\",\n      \"elementType\": \"FULL_NAME\",\n      \"page\": 1,\n      \"axisX\": 0.1,\n      \"axisY\": 0.88\n    },\n    {\n      \"envelopeSignerId\": \"{{signer2Id}}\",\n      \"envelopeDocumentId\": \"{{documentId}}\",\n      \"elementType\": \"SIGNATURE\",\n      \"page\": 1,\n      \"axisX\": 0.55,\n      \"axisY\": 0.8\n    }\n  ]\n}",
                  "options": {
                    "raw": {
                      "language": "json"
                    }
                  }
                }
              },
              "response": [
                {
                  "name": "Exemplo 201",
                  "originalRequest": {
                    "method": "POST",
                    "header": [],
                    "url": {
                      "raw": "{{baseUrl}}/v1/tags",
                      "host": [
                        "{{baseUrl}}"
                      ],
                      "path": [
                        "v1",
                        "tags"
                      ]
                    }
                  },
                  "status": "OK",
                  "code": 201,
                  "_postman_previewlanguage": "json",
                  "header": [
                    {
                      "key": "Content-Type",
                      "value": "application/json"
                    }
                  ],
                  "body": "{\n  \"totalElements\": 3,\n  \"tags\": [\n    {\n      \"id\": \"3fa85f64-5717-4562-b3fc-2c963f66afa6\",\n      \"envelopeSignerId\": \"3fa85f64-5717-4562-b3fc-2c963f66afa6\",\n      \"envelopeDocumentId\": \"3fa85f64-5717-4562-b3fc-2c963f66afa6\",\n      \"envelopeId\": \"3fa85f64-5717-4562-b3fc-2c963f66afa6\",\n      \"elementType\": \"SIGNATURE\",\n      \"page\": 1,\n      \"axisX\": 0.1,\n      \"axisY\": 0.8,\n      \"width\": 0.15,\n      \"height\": 0.07,\n      \"angle\": 0\n    }\n  ]\n}"
                }
              ]
            },
            {
              "name": "Listar campos",
              "event": [
                {
                  "listen": "test",
                  "script": {
                    "type": "text/javascript",
                    "exec": [
                      "pm.test('Resposta 2xx', () => pm.expect(pm.response.code).to.be.within(200, 299));",
                      "if (pm.response.code >= 400) {",
                      "  try { console.warn('Erro da API:', JSON.stringify(pm.response.json())); } catch (e) {}",
                      "}"
                    ]
                  }
                }
              ],
              "request": {
                "method": "GET",
                "header": [],
                "url": {
                  "raw": "{{baseUrl}}/v1/tags?filters=envelopeId:{{envelopeId}};envelopeDocumentId:{{documentId}}",
                  "host": [
                    "{{baseUrl}}"
                  ],
                  "path": [
                    "v1",
                    "tags"
                  ],
                  "query": [
                    {
                      "key": "filters",
                      "value": "envelopeId:{{envelopeId}};envelopeDocumentId:{{documentId}}"
                    }
                  ]
                },
                "description": "Lista os campos de um envelope. `envelopeId` é obrigatório no filtro; `envelopeDocumentId` é opcional.\n\n| Campo | Onde | Tipo | Obrigatório | Descrição |\n|---|---|---|---|---|\n| `filters` | query | string | sim | `envelopeId:<uuid>` e opcionalmente `;envelopeDocumentId:<uuid>` |\n\n**Resposta 200**\n\n```json\n{\n  \"totalElements\": 1,\n  \"tags\": [\n    {\n      \"id\": \"3fa85f64-5717-4562-b3fc-2c963f66afa6\",\n      \"envelopeSignerId\": \"3fa85f64-5717-4562-b3fc-2c963f66afa6\",\n      \"envelopeDocumentId\": \"3fa85f64-5717-4562-b3fc-2c963f66afa6\",\n      \"elementType\": \"SIGNATURE\",\n      \"page\": 1,\n      \"axisX\": 0.1,\n      \"axisY\": 0.8,\n      \"width\": 0.15,\n      \"height\": 0.07\n    }\n  ]\n}\n```"
              },
              "response": [
                {
                  "name": "Exemplo 200",
                  "originalRequest": {
                    "method": "GET",
                    "header": [],
                    "url": {
                      "raw": "{{baseUrl}}/v1/tags?filters=envelopeId:{{envelopeId}};envelopeDocumentId:{{documentId}}",
                      "host": [
                        "{{baseUrl}}"
                      ],
                      "path": [
                        "v1",
                        "tags"
                      ],
                      "query": [
                        {
                          "key": "filters",
                          "value": "envelopeId:{{envelopeId}};envelopeDocumentId:{{documentId}}"
                        }
                      ]
                    }
                  },
                  "status": "OK",
                  "code": 200,
                  "_postman_previewlanguage": "json",
                  "header": [
                    {
                      "key": "Content-Type",
                      "value": "application/json"
                    }
                  ],
                  "body": "{\n  \"totalElements\": 1,\n  \"tags\": [\n    {\n      \"id\": \"3fa85f64-5717-4562-b3fc-2c963f66afa6\",\n      \"envelopeSignerId\": \"3fa85f64-5717-4562-b3fc-2c963f66afa6\",\n      \"envelopeDocumentId\": \"3fa85f64-5717-4562-b3fc-2c963f66afa6\",\n      \"elementType\": \"SIGNATURE\",\n      \"page\": 1,\n      \"axisX\": 0.1,\n      \"axisY\": 0.8,\n      \"width\": 0.15,\n      \"height\": 0.07\n    }\n  ]\n}"
                }
              ]
            },
            {
              "name": "Mover / ajustar campo",
              "event": [
                {
                  "listen": "test",
                  "script": {
                    "type": "text/javascript",
                    "exec": [
                      "pm.test('Resposta 2xx', () => pm.expect(pm.response.code).to.be.within(200, 299));",
                      "if (pm.response.code >= 400) {",
                      "  try { console.warn('Erro da API:', JSON.stringify(pm.response.json())); } catch (e) {}",
                      "}"
                    ]
                  }
                }
              ],
              "request": {
                "method": "PUT",
                "header": [
                  {
                    "key": "Content-Type",
                    "value": "application/json"
                  }
                ],
                "url": {
                  "raw": "{{baseUrl}}/v1/tags",
                  "host": [
                    "{{baseUrl}}"
                  ],
                  "path": [
                    "v1",
                    "tags"
                  ]
                },
                "description": "Altera posição, página, tamanho, texto ou fonte. Não muda o tipo nem o signatário (para isso, remova e crie de novo). Envelope em `DRAFT` ou `BLOCK`.\n\n| Campo | Onde | Tipo | Obrigatório | Descrição |\n|---|---|---|---|---|\n| `envelopeId` | body | uuid | sim | Envelope |\n| `data[].id` | body | uuid | sim | Campo |\n| `data[].page / axisX / axisY / width / height / content / fontFamily / fontSize / fontColor / angle` | body |  | não | Mesmas regras da criação |\n\n**Resposta 200**\n\n```json\n{\n  \"totalElements\": 1,\n  \"tags\": [\n    {\n      \"id\": \"3fa85f64-5717-4562-b3fc-2c963f66afa6\",\n      \"axisX\": 0.12,\n      \"axisY\": 0.75\n    }\n  ]\n}\n```",
                "body": {
                  "mode": "raw",
                  "raw": "{\n  \"envelopeId\": \"{{envelopeId}}\",\n  \"data\": [\n    {\n      \"id\": \"{{tagId}}\",\n      \"page\": 1,\n      \"axisX\": 0.12,\n      \"axisY\": 0.75\n    }\n  ]\n}",
                  "options": {
                    "raw": {
                      "language": "json"
                    }
                  }
                }
              },
              "response": [
                {
                  "name": "Exemplo 200",
                  "originalRequest": {
                    "method": "PUT",
                    "header": [],
                    "url": {
                      "raw": "{{baseUrl}}/v1/tags",
                      "host": [
                        "{{baseUrl}}"
                      ],
                      "path": [
                        "v1",
                        "tags"
                      ]
                    }
                  },
                  "status": "OK",
                  "code": 200,
                  "_postman_previewlanguage": "json",
                  "header": [
                    {
                      "key": "Content-Type",
                      "value": "application/json"
                    }
                  ],
                  "body": "{\n  \"totalElements\": 1,\n  \"tags\": [\n    {\n      \"id\": \"3fa85f64-5717-4562-b3fc-2c963f66afa6\",\n      \"axisX\": 0.12,\n      \"axisY\": 0.75\n    }\n  ]\n}"
                }
              ]
            },
            {
              "name": "Remover campo",
              "event": [
                {
                  "listen": "test",
                  "script": {
                    "type": "text/javascript",
                    "exec": [
                      "pm.test('Resposta 2xx', () => pm.expect(pm.response.code).to.be.within(200, 299));",
                      "if (pm.response.code >= 400) {",
                      "  try { console.warn('Erro da API:', JSON.stringify(pm.response.json())); } catch (e) {}",
                      "}"
                    ]
                  }
                }
              ],
              "request": {
                "method": "DELETE",
                "header": [
                  {
                    "key": "Content-Type",
                    "value": "application/json"
                  }
                ],
                "url": {
                  "raw": "{{baseUrl}}/v1/tags",
                  "host": [
                    "{{baseUrl}}"
                  ],
                  "path": [
                    "v1",
                    "tags"
                  ]
                },
                "description": "Envelope em `DRAFT` ou `BLOCK`.\n\n| Campo | Onde | Tipo | Obrigatório | Descrição |\n|---|---|---|---|---|\n| `envelopeId` | body | uuid | sim | Envelope |\n| `data[].id` | body | uuid | sim | Campo |\n\n**Resposta 200**\n\n```json\n{\n  \"totalElements\": 1,\n  \"tags\": [\n    {\n      \"id\": \"3fa85f64-5717-4562-b3fc-2c963f66afa6\"\n    }\n  ]\n}\n```",
                "body": {
                  "mode": "raw",
                  "raw": "{\n  \"envelopeId\": \"{{envelopeId}}\",\n  \"data\": [\n    {\n      \"id\": \"{{tagId}}\"\n    }\n  ]\n}",
                  "options": {
                    "raw": {
                      "language": "json"
                    }
                  }
                }
              },
              "response": [
                {
                  "name": "Exemplo 200",
                  "originalRequest": {
                    "method": "DELETE",
                    "header": [],
                    "url": {
                      "raw": "{{baseUrl}}/v1/tags",
                      "host": [
                        "{{baseUrl}}"
                      ],
                      "path": [
                        "v1",
                        "tags"
                      ]
                    }
                  },
                  "status": "OK",
                  "code": 200,
                  "_postman_previewlanguage": "json",
                  "header": [
                    {
                      "key": "Content-Type",
                      "value": "application/json"
                    }
                  ],
                  "body": "{\n  \"totalElements\": 1,\n  \"tags\": [\n    {\n      \"id\": \"3fa85f64-5717-4562-b3fc-2c963f66afa6\"\n    }\n  ]\n}"
                }
              ]
            }
          ]
        },
        {
          "name": "📝 Modelos",
          "description": "Modelos são arquivos **.docx** com campos no formato `{{nomeDoCampo}}`. A Assin preenche os campos e gera um PDF, que vira um documento normal para usar em envelopes.",
          "item": [
            {
              "name": "Listar modelos",
              "event": [
                {
                  "listen": "test",
                  "script": {
                    "type": "text/javascript",
                    "exec": [
                      "pm.test('Resposta 2xx', () => pm.expect(pm.response.code).to.be.within(200, 299));",
                      "if (pm.response.code >= 400) {",
                      "  try { console.warn('Erro da API:', JSON.stringify(pm.response.json())); } catch (e) {}",
                      "}",
                      "const t = (pm.response.json().templates || [])[0];",
                      "if (t) pm.collectionVariables.set('templateId', t.id);"
                    ]
                  }
                }
              ],
              "request": {
                "method": "GET",
                "header": [],
                "url": {
                  "raw": "{{baseUrl}}/v1/templates?page=1&pageSize=20",
                  "host": [
                    "{{baseUrl}}"
                  ],
                  "path": [
                    "v1",
                    "templates"
                  ],
                  "query": [
                    {
                      "key": "page",
                      "value": "1"
                    },
                    {
                      "key": "pageSize",
                      "value": "20"
                    }
                  ]
                },
                "description": "Lista os modelos ativos e inativos. `keys` são os campos que precisam ser preenchidos. Aceita `filters`, `sortBy`, `page`, `pageSize`.\n\n**Resposta 200**\n\n```json\n{\n  \"totalElements\": 1,\n  \"templates\": [\n    {\n      \"id\": \"3fa85f64-5717-4562-b3fc-2c963f66afa6\",\n      \"alias\": \"Contrato CLT\",\n      \"description\": \"Modelo padrão\",\n      \"isActive\": true,\n      \"file\": \"https://...presigned .docx...\",\n      \"keys\": [\n        {\n          \"alias\": \"nomeColaborador\",\n          \"description\": \"Nome\",\n          \"maxSize\": 100\n        }\n      ]\n    }\n  ]\n}\n```"
              },
              "response": [
                {
                  "name": "Exemplo 200",
                  "originalRequest": {
                    "method": "GET",
                    "header": [],
                    "url": {
                      "raw": "{{baseUrl}}/v1/templates?page=1&pageSize=20",
                      "host": [
                        "{{baseUrl}}"
                      ],
                      "path": [
                        "v1",
                        "templates"
                      ],
                      "query": [
                        {
                          "key": "page",
                          "value": "1"
                        },
                        {
                          "key": "pageSize",
                          "value": "20"
                        }
                      ]
                    }
                  },
                  "status": "OK",
                  "code": 200,
                  "_postman_previewlanguage": "json",
                  "header": [
                    {
                      "key": "Content-Type",
                      "value": "application/json"
                    }
                  ],
                  "body": "{\n  \"totalElements\": 1,\n  \"templates\": [\n    {\n      \"id\": \"3fa85f64-5717-4562-b3fc-2c963f66afa6\",\n      \"alias\": \"Contrato CLT\",\n      \"description\": \"Modelo padrão\",\n      \"isActive\": true,\n      \"file\": \"https://...presigned .docx...\",\n      \"keys\": [\n        {\n          \"alias\": \"nomeColaborador\",\n          \"description\": \"Nome\",\n          \"maxSize\": 100\n        }\n      ]\n    }\n  ]\n}"
                }
              ]
            },
            {
              "name": "Criar modelo (gera URL de upload do .docx)",
              "event": [
                {
                  "listen": "test",
                  "script": {
                    "type": "text/javascript",
                    "exec": [
                      "pm.test('Resposta 2xx', () => pm.expect(pm.response.code).to.be.within(200, 299));",
                      "if (pm.response.code >= 400) {",
                      "  try { console.warn('Erro da API:', JSON.stringify(pm.response.json())); } catch (e) {}",
                      "}",
                      "const t = (pm.response.json().templates || [])[0];",
                      "if (t) { pm.collectionVariables.set('templateId', t.id); pm.collectionVariables.set('templateUploadUrl', t.file); }"
                    ]
                  }
                }
              ],
              "request": {
                "method": "POST",
                "header": [
                  {
                    "key": "Content-Type",
                    "value": "application/json"
                  },
                  {
                    "key": "Idempotency-Key",
                    "value": "{{$guid}}",
                    "description": "Em retry da MESMA operação, reenvie o mesmo valor."
                  }
                ],
                "url": {
                  "raw": "{{baseUrl}}/v1/templates",
                  "host": [
                    "{{baseUrl}}"
                  ],
                  "path": [
                    "v1",
                    "templates"
                  ]
                },
                "description": "Cria o modelo e devolve em `file` uma **URL de upload válida por 5 minutos** para o .docx. Envie o arquivo com `PUT` nessa URL, corpo binário e header `Content-Type: application/vnd.openxmlformats-officedocument.wordprocessingml.document`.\n\nCada item de `keys` descreve um campo `{{alias}}` existente no .docx.\n\nAceita `Idempotency-Key` (a collection gera um automaticamente).\n\n| Campo | Onde | Tipo | Obrigatório | Descrição |\n|---|---|---|---|---|\n| `data[].alias` | body | string | sim | Nome do modelo |\n| `data[].description` | body | string | sim |  |\n| `data[].keys[].alias` | body | string | sim | Nome do campo no .docx, sem as chaves |\n| `data[].keys[].description` | body | string | sim | Descrição do campo |\n| `data[].keys[].maxSize` | body | integer | sim | Tamanho máximo do valor |\n\n**Resposta 201**\n\n```json\n{\n  \"totalElements\": 1,\n  \"templates\": [\n    {\n      \"id\": \"3fa85f64-5717-4562-b3fc-2c963f66afa6\",\n      \"alias\": \"Contrato CLT\",\n      \"isActive\": true,\n      \"file\": \"https://<bucket>.s3.amazonaws.com/...docx?X-Amz-Expires=300&...\"\n    }\n  ]\n}\n```",
                "body": {
                  "mode": "raw",
                  "raw": "{\n  \"data\": [\n    {\n      \"alias\": \"Contrato CLT\",\n      \"description\": \"Modelo padrão de contratação\",\n      \"keys\": [\n        {\n          \"alias\": \"nomeColaborador\",\n          \"description\": \"Nome completo\",\n          \"maxSize\": 120\n        },\n        {\n          \"alias\": \"cpf\",\n          \"description\": \"CPF\",\n          \"maxSize\": 14\n        }\n      ]\n    }\n  ]\n}",
                  "options": {
                    "raw": {
                      "language": "json"
                    }
                  }
                }
              },
              "response": [
                {
                  "name": "Exemplo 201",
                  "originalRequest": {
                    "method": "POST",
                    "header": [],
                    "url": {
                      "raw": "{{baseUrl}}/v1/templates",
                      "host": [
                        "{{baseUrl}}"
                      ],
                      "path": [
                        "v1",
                        "templates"
                      ]
                    }
                  },
                  "status": "OK",
                  "code": 201,
                  "_postman_previewlanguage": "json",
                  "header": [
                    {
                      "key": "Content-Type",
                      "value": "application/json"
                    }
                  ],
                  "body": "{\n  \"totalElements\": 1,\n  \"templates\": [\n    {\n      \"id\": \"3fa85f64-5717-4562-b3fc-2c963f66afa6\",\n      \"alias\": \"Contrato CLT\",\n      \"isActive\": true,\n      \"file\": \"https://<bucket>.s3.amazonaws.com/...docx?X-Amz-Expires=300&...\"\n    }\n  ]\n}"
                }
              ]
            },
            {
              "name": "Enviar o .docx do modelo",
              "event": [
                {
                  "listen": "test",
                  "script": {
                    "type": "text/javascript",
                    "exec": [
                      "pm.test('Resposta 2xx', () => pm.expect(pm.response.code).to.be.within(200, 299));",
                      "if (pm.response.code >= 400) {",
                      "  try { console.warn('Erro da API:', JSON.stringify(pm.response.json())); } catch (e) {}",
                      "}"
                    ]
                  }
                }
              ],
              "request": {
                "method": "PUT",
                "header": [
                  {
                    "key": "Content-Type",
                    "value": "application/vnd.openxmlformats-officedocument.wordprocessingml.document"
                  }
                ],
                "url": {
                  "raw": "{{templateUploadUrl}}"
                },
                "description": "Envia o arquivo .docx para a URL recebida na criação do modelo. Corpo binário, sem `Authorization`.\n\n**Resposta:** 200 com corpo vazio.",
                "body": {
                  "mode": "file",
                  "file": {
                    "src": ""
                  }
                },
                "auth": {
                  "type": "noauth"
                }
              },
              "response": []
            },
            {
              "name": "Gerar documento a partir do modelo",
              "event": [
                {
                  "listen": "test",
                  "script": {
                    "type": "text/javascript",
                    "exec": [
                      "pm.test('Resposta 2xx', () => pm.expect(pm.response.code).to.be.within(200, 299));",
                      "if (pm.response.code >= 400) {",
                      "  try { console.warn('Erro da API:', JSON.stringify(pm.response.json())); } catch (e) {}",
                      "}",
                      "const d = (pm.response.json().entities || [])[0];",
                      "if (d) pm.collectionVariables.set('documentId', d.id);"
                    ]
                  }
                }
              ],
              "request": {
                "method": "POST",
                "header": [
                  {
                    "key": "Content-Type",
                    "value": "application/json"
                  },
                  {
                    "key": "Idempotency-Key",
                    "value": "{{$guid}}",
                    "description": "Em retry da MESMA operação, reenvie o mesmo valor."
                  }
                ],
                "url": {
                  "raw": "{{baseUrl}}/v1/templates/generate-document",
                  "host": [
                    "{{baseUrl}}"
                  ],
                  "path": [
                    "v1",
                    "templates",
                    "generate-document"
                  ]
                },
                "description": "Preenche o modelo e gera um PDF. O `id` devolvido é um **documento** comum: vincule-o a um envelope com `POST /v1/envelopes/set/documents`.\n\n`key` deve ser igual ao `alias` do campo no modelo. Valores maiores que `maxSize` ou campos inexistentes voltam em `rejectedInputs`.\n\nAceita `Idempotency-Key` (a collection gera um automaticamente).\n\n| Campo | Onde | Tipo | Obrigatório | Descrição |\n|---|---|---|---|---|\n| `data[].templateId` | body | uuid | sim | Modelo |\n| `data[].documents[].alias` | body | string | sim | Nome do documento gerado |\n| `data[].documents[].keys[].key` | body | string | sim | Campo |\n| `data[].documents[].keys[].description` | body | string | sim |  |\n| `data[].documents[].keys[].value` | body | string | sim | Valor |\n\n**Resposta 201**\n\n```json\n{\n  \"totalElements\": 1,\n  \"entities\": [\n    {\n      \"id\": \"3fa85f64-5717-4562-b3fc-2c963f66afa6\",\n      \"alias\": \"Contrato - João Silva\",\n      \"url\": \"https://...presigned...\",\n      \"createdFrom\": \"GENERATE_BY_ASSIN\"\n    }\n  ]\n}\n```",
                "body": {
                  "mode": "raw",
                  "raw": "{\n  \"data\": [\n    {\n      \"templateId\": \"{{templateId}}\",\n      \"documents\": [\n        {\n          \"alias\": \"Contrato - João Silva\",\n          \"keys\": [\n            {\n              \"key\": \"nomeColaborador\",\n              \"description\": \"Nome completo\",\n              \"value\": \"João Silva\"\n            },\n            {\n              \"key\": \"cpf\",\n              \"description\": \"CPF\",\n              \"value\": \"123.456.789-00\"\n            }\n          ]\n        }\n      ]\n    }\n  ]\n}",
                  "options": {
                    "raw": {
                      "language": "json"
                    }
                  }
                }
              },
              "response": [
                {
                  "name": "Exemplo 201",
                  "originalRequest": {
                    "method": "POST",
                    "header": [],
                    "url": {
                      "raw": "{{baseUrl}}/v1/templates/generate-document",
                      "host": [
                        "{{baseUrl}}"
                      ],
                      "path": [
                        "v1",
                        "templates",
                        "generate-document"
                      ]
                    }
                  },
                  "status": "OK",
                  "code": 201,
                  "_postman_previewlanguage": "json",
                  "header": [
                    {
                      "key": "Content-Type",
                      "value": "application/json"
                    }
                  ],
                  "body": "{\n  \"totalElements\": 1,\n  \"entities\": [\n    {\n      \"id\": \"3fa85f64-5717-4562-b3fc-2c963f66afa6\",\n      \"alias\": \"Contrato - João Silva\",\n      \"url\": \"https://...presigned...\",\n      \"createdFrom\": \"GENERATE_BY_ASSIN\"\n    }\n  ]\n}"
                }
              ]
            },
            {
              "name": "Ativar / desativar modelo",
              "event": [
                {
                  "listen": "test",
                  "script": {
                    "type": "text/javascript",
                    "exec": [
                      "pm.test('Resposta 2xx', () => pm.expect(pm.response.code).to.be.within(200, 299));",
                      "if (pm.response.code >= 400) {",
                      "  try { console.warn('Erro da API:', JSON.stringify(pm.response.json())); } catch (e) {}",
                      "}"
                    ]
                  }
                }
              ],
              "request": {
                "method": "PUT",
                "header": [
                  {
                    "key": "Content-Type",
                    "value": "application/json"
                  }
                ],
                "url": {
                  "raw": "{{baseUrl}}/v1/templates/activate/true",
                  "host": [
                    "{{baseUrl}}"
                  ],
                  "path": [
                    "v1",
                    "templates",
                    "activate",
                    "true"
                  ]
                },
                "description": "`true` no fim da URL ativa, `false` desativa.\n\n| Campo | Onde | Tipo | Obrigatório | Descrição |\n|---|---|---|---|---|\n| `status` | path | boolean | sim | `true` ou `false` |\n| `data[].id` | body | uuid | sim | Modelo |\n\n**Resposta 200**\n\n```json\n{\n  \"totalElements\": 1,\n  \"templates\": [\n    {\n      \"id\": \"3fa85f64-5717-4562-b3fc-2c963f66afa6\",\n      \"isActive\": true\n    }\n  ]\n}\n```",
                "body": {
                  "mode": "raw",
                  "raw": "{\n  \"data\": [\n    {\n      \"id\": \"{{templateId}}\"\n    }\n  ]\n}",
                  "options": {
                    "raw": {
                      "language": "json"
                    }
                  }
                }
              },
              "response": [
                {
                  "name": "Exemplo 200",
                  "originalRequest": {
                    "method": "PUT",
                    "header": [],
                    "url": {
                      "raw": "{{baseUrl}}/v1/templates/activate/true",
                      "host": [
                        "{{baseUrl}}"
                      ],
                      "path": [
                        "v1",
                        "templates",
                        "activate",
                        "true"
                      ]
                    }
                  },
                  "status": "OK",
                  "code": 200,
                  "_postman_previewlanguage": "json",
                  "header": [
                    {
                      "key": "Content-Type",
                      "value": "application/json"
                    }
                  ],
                  "body": "{\n  \"totalElements\": 1,\n  \"templates\": [\n    {\n      \"id\": \"3fa85f64-5717-4562-b3fc-2c963f66afa6\",\n      \"isActive\": true\n    }\n  ]\n}"
                }
              ]
            },
            {
              "name": "Excluir modelo",
              "event": [
                {
                  "listen": "test",
                  "script": {
                    "type": "text/javascript",
                    "exec": [
                      "pm.test('Resposta 2xx', () => pm.expect(pm.response.code).to.be.within(200, 299));",
                      "if (pm.response.code >= 400) {",
                      "  try { console.warn('Erro da API:', JSON.stringify(pm.response.json())); } catch (e) {}",
                      "}"
                    ]
                  }
                }
              ],
              "request": {
                "method": "DELETE",
                "header": [
                  {
                    "key": "Content-Type",
                    "value": "application/json"
                  }
                ],
                "url": {
                  "raw": "{{baseUrl}}/v1/templates/delete",
                  "host": [
                    "{{baseUrl}}"
                  ],
                  "path": [
                    "v1",
                    "templates",
                    "delete"
                  ]
                },
                "description": "Exclui um modelo criado pelo usuário da API Key.\n\n| Campo | Onde | Tipo | Obrigatório | Descrição |\n|---|---|---|---|---|\n| `data[].id` | body | uuid | sim | Modelo |\n\n**Resposta 200**\n\n```json\n{\n  \"totalElements\": 1,\n  \"templates\": [\n    {\n      \"id\": \"3fa85f64-5717-4562-b3fc-2c963f66afa6\"\n    }\n  ]\n}\n```",
                "body": {
                  "mode": "raw",
                  "raw": "{\n  \"data\": [\n    {\n      \"id\": \"{{templateId}}\"\n    }\n  ]\n}",
                  "options": {
                    "raw": {
                      "language": "json"
                    }
                  }
                }
              },
              "response": [
                {
                  "name": "Exemplo 200",
                  "originalRequest": {
                    "method": "DELETE",
                    "header": [],
                    "url": {
                      "raw": "{{baseUrl}}/v1/templates/delete",
                      "host": [
                        "{{baseUrl}}"
                      ],
                      "path": [
                        "v1",
                        "templates",
                        "delete"
                      ]
                    }
                  },
                  "status": "OK",
                  "code": 200,
                  "_postman_previewlanguage": "json",
                  "header": [
                    {
                      "key": "Content-Type",
                      "value": "application/json"
                    }
                  ],
                  "body": "{\n  \"totalElements\": 1,\n  \"templates\": [\n    {\n      \"id\": \"3fa85f64-5717-4562-b3fc-2c963f66afa6\"\n    }\n  ]\n}"
                }
              ]
            }
          ]
        },
        {
          "name": "👥 Grupos de signatários",
          "description": "Listas de signatários que se repetem (ex.: diretoria, testemunhas fixas). Em vez de adicionar um a um, importe o grupo inteiro para o envelope. Nestas rotas `data` é um **objeto**.",
          "item": [
            {
              "name": "Criar grupo",
              "event": [
                {
                  "listen": "test",
                  "script": {
                    "type": "text/javascript",
                    "exec": [
                      "pm.test('Resposta 2xx', () => pm.expect(pm.response.code).to.be.within(200, 299));",
                      "if (pm.response.code >= 400) {",
                      "  try { console.warn('Erro da API:', JSON.stringify(pm.response.json())); } catch (e) {}",
                      "}",
                      "const g = (pm.response.json().entities || [])[0];",
                      "if (g) pm.collectionVariables.set('groupId', g.id);"
                    ]
                  }
                }
              ],
              "request": {
                "method": "POST",
                "header": [
                  {
                    "key": "Content-Type",
                    "value": "application/json"
                  },
                  {
                    "key": "Idempotency-Key",
                    "value": "{{$guid}}",
                    "description": "Em retry da MESMA operação, reenvie o mesmo valor."
                  }
                ],
                "url": {
                  "raw": "{{baseUrl}}/v1/signer-groups",
                  "host": [
                    "{{baseUrl}}"
                  ],
                  "path": [
                    "v1",
                    "signer-groups"
                  ]
                },
                "description": "Aceita `Idempotency-Key` (a collection gera um automaticamente).\n\n| Campo | Onde | Tipo | Obrigatório | Descrição |\n|---|---|---|---|---|\n| `data.name` | body | string | sim | 1 a 100 caracteres |\n| `data.members[].fullName` | body | string | sim |  |\n| `data.members[].email` | body | string | sim |  |\n| `data.members[].signatureType` | body | enum | sim | Mesmos tipos de signatário |\n| `data.members[].order` | body | integer | sim | 0 = paralelo |\n\n**Resposta 201**\n\n```json\n{\n  \"totalElements\": 1,\n  \"entities\": [\n    {\n      \"id\": \"3fa85f64-5717-4562-b3fc-2c963f66afa6\",\n      \"name\": \"Diretoria\",\n      \"companyId\": \"3fa85f64-5717-4562-b3fc-2c963f66afa6\",\n      \"members\": [\n        {\n          \"id\": \"3fa85f64-5717-4562-b3fc-2c963f66afa6\",\n          \"fullName\": \"Carlos Mendes\",\n          \"email\": \"carlos@exemplo.com.br\",\n          \"signatureType\": \"PARTY\",\n          \"order\": 0\n        }\n      ]\n    }\n  ]\n}\n```",
                "body": {
                  "mode": "raw",
                  "raw": "{\n  \"data\": {\n    \"name\": \"Diretoria\",\n    \"members\": [\n      {\n        \"fullName\": \"Carlos Mendes\",\n        \"email\": \"carlos@exemplo.com.br\",\n        \"signatureType\": \"PARTY\",\n        \"order\": 0\n      },\n      {\n        \"fullName\": \"Ana Prado\",\n        \"email\": \"ana@exemplo.com.br\",\n        \"signatureType\": \"APPROVER\",\n        \"order\": 0\n      }\n    ]\n  }\n}",
                  "options": {
                    "raw": {
                      "language": "json"
                    }
                  }
                }
              },
              "response": [
                {
                  "name": "Exemplo 201",
                  "originalRequest": {
                    "method": "POST",
                    "header": [],
                    "url": {
                      "raw": "{{baseUrl}}/v1/signer-groups",
                      "host": [
                        "{{baseUrl}}"
                      ],
                      "path": [
                        "v1",
                        "signer-groups"
                      ]
                    }
                  },
                  "status": "OK",
                  "code": 201,
                  "_postman_previewlanguage": "json",
                  "header": [
                    {
                      "key": "Content-Type",
                      "value": "application/json"
                    }
                  ],
                  "body": "{\n  \"totalElements\": 1,\n  \"entities\": [\n    {\n      \"id\": \"3fa85f64-5717-4562-b3fc-2c963f66afa6\",\n      \"name\": \"Diretoria\",\n      \"companyId\": \"3fa85f64-5717-4562-b3fc-2c963f66afa6\",\n      \"members\": [\n        {\n          \"id\": \"3fa85f64-5717-4562-b3fc-2c963f66afa6\",\n          \"fullName\": \"Carlos Mendes\",\n          \"email\": \"carlos@exemplo.com.br\",\n          \"signatureType\": \"PARTY\",\n          \"order\": 0\n        }\n      ]\n    }\n  ]\n}"
                }
              ]
            },
            {
              "name": "Listar grupos",
              "event": [
                {
                  "listen": "test",
                  "script": {
                    "type": "text/javascript",
                    "exec": [
                      "pm.test('Resposta 2xx', () => pm.expect(pm.response.code).to.be.within(200, 299));",
                      "if (pm.response.code >= 400) {",
                      "  try { console.warn('Erro da API:', JSON.stringify(pm.response.json())); } catch (e) {}",
                      "}"
                    ]
                  }
                }
              ],
              "request": {
                "method": "GET",
                "header": [],
                "url": {
                  "raw": "{{baseUrl}}/v1/signer-groups",
                  "host": [
                    "{{baseUrl}}"
                  ],
                  "path": [
                    "v1",
                    "signer-groups"
                  ]
                },
                "description": "Lista os grupos da empresa com seus membros.\n\n**Resposta 200**\n\n```json\n{\n  \"totalElements\": 1,\n  \"entities\": [\n    {\n      \"id\": \"3fa85f64-5717-4562-b3fc-2c963f66afa6\",\n      \"name\": \"Diretoria\",\n      \"members\": [\n        {\n          \"fullName\": \"Carlos Mendes\",\n          \"email\": \"carlos@exemplo.com.br\",\n          \"signatureType\": \"PARTY\",\n          \"order\": 0\n        }\n      ]\n    }\n  ]\n}\n```"
              },
              "response": [
                {
                  "name": "Exemplo 200",
                  "originalRequest": {
                    "method": "GET",
                    "header": [],
                    "url": {
                      "raw": "{{baseUrl}}/v1/signer-groups",
                      "host": [
                        "{{baseUrl}}"
                      ],
                      "path": [
                        "v1",
                        "signer-groups"
                      ]
                    }
                  },
                  "status": "OK",
                  "code": 200,
                  "_postman_previewlanguage": "json",
                  "header": [
                    {
                      "key": "Content-Type",
                      "value": "application/json"
                    }
                  ],
                  "body": "{\n  \"totalElements\": 1,\n  \"entities\": [\n    {\n      \"id\": \"3fa85f64-5717-4562-b3fc-2c963f66afa6\",\n      \"name\": \"Diretoria\",\n      \"members\": [\n        {\n          \"fullName\": \"Carlos Mendes\",\n          \"email\": \"carlos@exemplo.com.br\",\n          \"signatureType\": \"PARTY\",\n          \"order\": 0\n        }\n      ]\n    }\n  ]\n}"
                }
              ]
            },
            {
              "name": "Importar grupo para um envelope",
              "event": [
                {
                  "listen": "test",
                  "script": {
                    "type": "text/javascript",
                    "exec": [
                      "pm.test('Resposta 2xx', () => pm.expect(pm.response.code).to.be.within(200, 299));",
                      "if (pm.response.code >= 400) {",
                      "  try { console.warn('Erro da API:', JSON.stringify(pm.response.json())); } catch (e) {}",
                      "}"
                    ]
                  }
                }
              ],
              "request": {
                "method": "POST",
                "header": [
                  {
                    "key": "Content-Type",
                    "value": "application/json"
                  },
                  {
                    "key": "Idempotency-Key",
                    "value": "{{$guid}}",
                    "description": "Em retry da MESMA operação, reenvie o mesmo valor."
                  }
                ],
                "url": {
                  "raw": "{{baseUrl}}/v1/signer-groups/import",
                  "host": [
                    "{{baseUrl}}"
                  ],
                  "path": [
                    "v1",
                    "signer-groups",
                    "import"
                  ]
                },
                "description": "Adiciona os membros do grupo como signatários do envelope (`DRAFT`). Quem já está no envelope é ignorado.\n\nAceita `Idempotency-Key` (a collection gera um automaticamente).\n\n| Campo | Onde | Tipo | Obrigatório | Descrição |\n|---|---|---|---|---|\n| `data.groupId` | body | uuid | sim | Grupo |\n| `data.envelopeId` | body | uuid | sim | Envelope |\n\n**Resposta 201**\n\n```json\n{\n  \"totalElements\": 2,\n  \"entities\": [\n    {\n      \"envelopeId\": \"3fa85f64-5717-4562-b3fc-2c963f66afa6\",\n      \"signerId\": \"3fa85f64-5717-4562-b3fc-2c963f66afa6\",\n      \"signatureType\": \"PARTY\",\n      \"order\": 0,\n      \"status\": \"PENDING\"\n    }\n  ]\n}\n```\n\n**Erros comuns**\n\n- 400 `Envelope must be in DRAFT status`\n- 400 `No new signers to import`\n- 404 grupo ou envelope não encontrado",
                "body": {
                  "mode": "raw",
                  "raw": "{\n  \"data\": {\n    \"groupId\": \"{{groupId}}\",\n    \"envelopeId\": \"{{envelopeId}}\"\n  }\n}",
                  "options": {
                    "raw": {
                      "language": "json"
                    }
                  }
                }
              },
              "response": [
                {
                  "name": "Exemplo 201",
                  "originalRequest": {
                    "method": "POST",
                    "header": [],
                    "url": {
                      "raw": "{{baseUrl}}/v1/signer-groups/import",
                      "host": [
                        "{{baseUrl}}"
                      ],
                      "path": [
                        "v1",
                        "signer-groups",
                        "import"
                      ]
                    }
                  },
                  "status": "OK",
                  "code": 201,
                  "_postman_previewlanguage": "json",
                  "header": [
                    {
                      "key": "Content-Type",
                      "value": "application/json"
                    }
                  ],
                  "body": "{\n  \"totalElements\": 2,\n  \"entities\": [\n    {\n      \"envelopeId\": \"3fa85f64-5717-4562-b3fc-2c963f66afa6\",\n      \"signerId\": \"3fa85f64-5717-4562-b3fc-2c963f66afa6\",\n      \"signatureType\": \"PARTY\",\n      \"order\": 0,\n      \"status\": \"PENDING\"\n    }\n  ]\n}"
                }
              ]
            },
            {
              "name": "Atualizar grupo",
              "event": [
                {
                  "listen": "test",
                  "script": {
                    "type": "text/javascript",
                    "exec": [
                      "pm.test('Resposta 2xx', () => pm.expect(pm.response.code).to.be.within(200, 299));",
                      "if (pm.response.code >= 400) {",
                      "  try { console.warn('Erro da API:', JSON.stringify(pm.response.json())); } catch (e) {}",
                      "}"
                    ]
                  }
                }
              ],
              "request": {
                "method": "PUT",
                "header": [
                  {
                    "key": "Content-Type",
                    "value": "application/json"
                  }
                ],
                "url": {
                  "raw": "{{baseUrl}}/v1/signer-groups/{{groupId}}",
                  "host": [
                    "{{baseUrl}}"
                  ],
                  "path": [
                    "v1",
                    "signer-groups",
                    "{{groupId}}"
                  ]
                },
                "description": "Substitui nome e membros (envie a lista completa). Só quem criou o grupo pode alterar.\n\n| Campo | Onde | Tipo | Obrigatório | Descrição |\n|---|---|---|---|---|\n| `id` | path | uuid | sim | Grupo |\n| `data.name` | body | string | sim |  |\n| `data.members` | body | array | sim | Lista completa |\n\n**Resposta 200**\n\n```json\n{\n  \"totalElements\": 1,\n  \"entities\": [\n    {\n      \"id\": \"3fa85f64-5717-4562-b3fc-2c963f66afa6\",\n      \"name\": \"Diretoria 2026\"\n    }\n  ]\n}\n```",
                "body": {
                  "mode": "raw",
                  "raw": "{\n  \"data\": {\n    \"name\": \"Diretoria 2026\",\n    \"members\": [\n      {\n        \"fullName\": \"Carlos Mendes\",\n        \"email\": \"carlos@exemplo.com.br\",\n        \"signatureType\": \"PARTY\",\n        \"order\": 0\n      }\n    ]\n  }\n}",
                  "options": {
                    "raw": {
                      "language": "json"
                    }
                  }
                }
              },
              "response": [
                {
                  "name": "Exemplo 200",
                  "originalRequest": {
                    "method": "PUT",
                    "header": [],
                    "url": {
                      "raw": "{{baseUrl}}/v1/signer-groups/{{groupId}}",
                      "host": [
                        "{{baseUrl}}"
                      ],
                      "path": [
                        "v1",
                        "signer-groups",
                        "{{groupId}}"
                      ]
                    }
                  },
                  "status": "OK",
                  "code": 200,
                  "_postman_previewlanguage": "json",
                  "header": [
                    {
                      "key": "Content-Type",
                      "value": "application/json"
                    }
                  ],
                  "body": "{\n  \"totalElements\": 1,\n  \"entities\": [\n    {\n      \"id\": \"3fa85f64-5717-4562-b3fc-2c963f66afa6\",\n      \"name\": \"Diretoria 2026\"\n    }\n  ]\n}"
                }
              ]
            },
            {
              "name": "Excluir grupo",
              "event": [
                {
                  "listen": "test",
                  "script": {
                    "type": "text/javascript",
                    "exec": [
                      "pm.test('Resposta 2xx', () => pm.expect(pm.response.code).to.be.within(200, 299));",
                      "if (pm.response.code >= 400) {",
                      "  try { console.warn('Erro da API:', JSON.stringify(pm.response.json())); } catch (e) {}",
                      "}"
                    ]
                  }
                }
              ],
              "request": {
                "method": "DELETE",
                "header": [],
                "url": {
                  "raw": "{{baseUrl}}/v1/signer-groups/{{groupId}}",
                  "host": [
                    "{{baseUrl}}"
                  ],
                  "path": [
                    "v1",
                    "signer-groups",
                    "{{groupId}}"
                  ]
                },
                "description": "Só quem criou o grupo pode excluir.\n\n| Campo | Onde | Tipo | Obrigatório | Descrição |\n|---|---|---|---|---|\n| `id` | path | uuid | sim | Grupo |\n\n**Resposta 200**\n\n```json\n{\n  \"totalElements\": 1,\n  \"entities\": [\n    {\n      \"id\": \"3fa85f64-5717-4562-b3fc-2c963f66afa6\"\n    }\n  ]\n}\n```"
              },
              "response": [
                {
                  "name": "Exemplo 200",
                  "originalRequest": {
                    "method": "DELETE",
                    "header": [],
                    "url": {
                      "raw": "{{baseUrl}}/v1/signer-groups/{{groupId}}",
                      "host": [
                        "{{baseUrl}}"
                      ],
                      "path": [
                        "v1",
                        "signer-groups",
                        "{{groupId}}"
                      ]
                    }
                  },
                  "status": "OK",
                  "code": 200,
                  "_postman_previewlanguage": "json",
                  "header": [
                    {
                      "key": "Content-Type",
                      "value": "application/json"
                    }
                  ],
                  "body": "{\n  \"totalElements\": 1,\n  \"entities\": [\n    {\n      \"id\": \"3fa85f64-5717-4562-b3fc-2c963f66afa6\"\n    }\n  ]\n}"
                }
              ]
            }
          ]
        },
        {
          "name": "📁 Pastas",
          "description": "Organizam os envelopes do usuário da API Key dentro da empresa. Pastas podem ter subpastas (`parentId`). Para criar um envelope já dentro de uma pasta, envie `folderId` na criação do envelope. Nestas rotas `data` é um **objeto**.",
          "item": [
            {
              "name": "Criar pasta",
              "event": [
                {
                  "listen": "test",
                  "script": {
                    "type": "text/javascript",
                    "exec": [
                      "pm.test('Resposta 2xx', () => pm.expect(pm.response.code).to.be.within(200, 299));",
                      "if (pm.response.code >= 400) {",
                      "  try { console.warn('Erro da API:', JSON.stringify(pm.response.json())); } catch (e) {}",
                      "}",
                      "const f = (pm.response.json().entities || [])[0];",
                      "if (f) pm.collectionVariables.set('folderId', f.id);"
                    ]
                  }
                }
              ],
              "request": {
                "method": "POST",
                "header": [
                  {
                    "key": "Content-Type",
                    "value": "application/json"
                  },
                  {
                    "key": "Idempotency-Key",
                    "value": "{{$guid}}",
                    "description": "Em retry da MESMA operação, reenvie o mesmo valor."
                  }
                ],
                "url": {
                  "raw": "{{baseUrl}}/v1/folders",
                  "host": [
                    "{{baseUrl}}"
                  ],
                  "path": [
                    "v1",
                    "folders"
                  ]
                },
                "description": "Aceita `Idempotency-Key` (a collection gera um automaticamente).\n\n| Campo | Onde | Tipo | Obrigatório | Descrição |\n|---|---|---|---|---|\n| `data.name` | body | string | sim | 1 a 100 caracteres |\n| `data.parentId` | body | uuid | null | não | Pasta-mãe |\n\n**Resposta 201**\n\n```json\n{\n  \"totalElements\": 1,\n  \"entities\": [\n    {\n      \"id\": \"3fa85f64-5717-4562-b3fc-2c963f66afa6\",\n      \"name\": \"Contratos 2026\",\n      \"parentId\": null,\n      \"companyId\": \"3fa85f64-5717-4562-b3fc-2c963f66afa6\"\n    }\n  ]\n}\n```",
                "body": {
                  "mode": "raw",
                  "raw": "{\n  \"data\": {\n    \"name\": \"Contratos 2026\"\n  }\n}",
                  "options": {
                    "raw": {
                      "language": "json"
                    }
                  }
                }
              },
              "response": [
                {
                  "name": "Exemplo 201",
                  "originalRequest": {
                    "method": "POST",
                    "header": [],
                    "url": {
                      "raw": "{{baseUrl}}/v1/folders",
                      "host": [
                        "{{baseUrl}}"
                      ],
                      "path": [
                        "v1",
                        "folders"
                      ]
                    }
                  },
                  "status": "OK",
                  "code": 201,
                  "_postman_previewlanguage": "json",
                  "header": [
                    {
                      "key": "Content-Type",
                      "value": "application/json"
                    }
                  ],
                  "body": "{\n  \"totalElements\": 1,\n  \"entities\": [\n    {\n      \"id\": \"3fa85f64-5717-4562-b3fc-2c963f66afa6\",\n      \"name\": \"Contratos 2026\",\n      \"parentId\": null,\n      \"companyId\": \"3fa85f64-5717-4562-b3fc-2c963f66afa6\"\n    }\n  ]\n}"
                }
              ]
            },
            {
              "name": "Listar pastas (árvore)",
              "event": [
                {
                  "listen": "test",
                  "script": {
                    "type": "text/javascript",
                    "exec": [
                      "pm.test('Resposta 2xx', () => pm.expect(pm.response.code).to.be.within(200, 299));",
                      "if (pm.response.code >= 400) {",
                      "  try { console.warn('Erro da API:', JSON.stringify(pm.response.json())); } catch (e) {}",
                      "}"
                    ]
                  }
                }
              ],
              "request": {
                "method": "GET",
                "header": [],
                "url": {
                  "raw": "{{baseUrl}}/v1/folders",
                  "host": [
                    "{{baseUrl}}"
                  ],
                  "path": [
                    "v1",
                    "folders"
                  ]
                },
                "description": "Retorna a árvore de pastas; subpastas vêm em `children`.\n\n**Resposta 200**\n\n```json\n{\n  \"totalElements\": 1,\n  \"entities\": [\n    {\n      \"id\": \"3fa85f64-5717-4562-b3fc-2c963f66afa6\",\n      \"name\": \"Contratos 2026\",\n      \"parentId\": null,\n      \"children\": [\n        {\n          \"id\": \"3fa85f64-5717-4562-b3fc-2c963f66afa6\",\n          \"name\": \"Fornecedores\",\n          \"parentId\": \"3fa85f64-5717-4562-b3fc-2c963f66afa6\",\n          \"children\": []\n        }\n      ]\n    }\n  ]\n}\n```"
              },
              "response": [
                {
                  "name": "Exemplo 200",
                  "originalRequest": {
                    "method": "GET",
                    "header": [],
                    "url": {
                      "raw": "{{baseUrl}}/v1/folders",
                      "host": [
                        "{{baseUrl}}"
                      ],
                      "path": [
                        "v1",
                        "folders"
                      ]
                    }
                  },
                  "status": "OK",
                  "code": 200,
                  "_postman_previewlanguage": "json",
                  "header": [
                    {
                      "key": "Content-Type",
                      "value": "application/json"
                    }
                  ],
                  "body": "{\n  \"totalElements\": 1,\n  \"entities\": [\n    {\n      \"id\": \"3fa85f64-5717-4562-b3fc-2c963f66afa6\",\n      \"name\": \"Contratos 2026\",\n      \"parentId\": null,\n      \"children\": [\n        {\n          \"id\": \"3fa85f64-5717-4562-b3fc-2c963f66afa6\",\n          \"name\": \"Fornecedores\",\n          \"parentId\": \"3fa85f64-5717-4562-b3fc-2c963f66afa6\",\n          \"children\": []\n        }\n      ]\n    }\n  ]\n}"
                }
              ]
            },
            {
              "name": "Renomear / mover pasta",
              "event": [
                {
                  "listen": "test",
                  "script": {
                    "type": "text/javascript",
                    "exec": [
                      "pm.test('Resposta 2xx', () => pm.expect(pm.response.code).to.be.within(200, 299));",
                      "if (pm.response.code >= 400) {",
                      "  try { console.warn('Erro da API:', JSON.stringify(pm.response.json())); } catch (e) {}",
                      "}"
                    ]
                  }
                }
              ],
              "request": {
                "method": "PUT",
                "header": [
                  {
                    "key": "Content-Type",
                    "value": "application/json"
                  }
                ],
                "url": {
                  "raw": "{{baseUrl}}/v1/folders/{{folderId}}",
                  "host": [
                    "{{baseUrl}}"
                  ],
                  "path": [
                    "v1",
                    "folders",
                    "{{folderId}}"
                  ]
                },
                "description": "Envie `name` e/ou `parentId`. Sem `parentId`, a pasta fica onde está; `parentId: null` move para a raiz.\n\n| Campo | Onde | Tipo | Obrigatório | Descrição |\n|---|---|---|---|---|\n| `id` | path | uuid | sim | Pasta |\n| `data.name` | body | string | não |  |\n| `data.parentId` | body | uuid | null | não |  |\n\n**Resposta 200**\n\n```json\n{\n  \"totalElements\": 1,\n  \"entities\": [\n    {\n      \"id\": \"3fa85f64-5717-4562-b3fc-2c963f66afa6\",\n      \"name\": \"Contratos 2026 - Assinados\"\n    }\n  ]\n}\n```\n\n**Erros comuns**\n\n- 404 `Folder not found`\n- 400 mover para ela mesma ou para uma subpasta",
                "body": {
                  "mode": "raw",
                  "raw": "{\n  \"data\": {\n    \"name\": \"Contratos 2026 - Assinados\"\n  }\n}",
                  "options": {
                    "raw": {
                      "language": "json"
                    }
                  }
                }
              },
              "response": [
                {
                  "name": "Exemplo 200",
                  "originalRequest": {
                    "method": "PUT",
                    "header": [],
                    "url": {
                      "raw": "{{baseUrl}}/v1/folders/{{folderId}}",
                      "host": [
                        "{{baseUrl}}"
                      ],
                      "path": [
                        "v1",
                        "folders",
                        "{{folderId}}"
                      ]
                    }
                  },
                  "status": "OK",
                  "code": 200,
                  "_postman_previewlanguage": "json",
                  "header": [
                    {
                      "key": "Content-Type",
                      "value": "application/json"
                    }
                  ],
                  "body": "{\n  \"totalElements\": 1,\n  \"entities\": [\n    {\n      \"id\": \"3fa85f64-5717-4562-b3fc-2c963f66afa6\",\n      \"name\": \"Contratos 2026 - Assinados\"\n    }\n  ]\n}"
                }
              ]
            },
            {
              "name": "Excluir pasta",
              "event": [
                {
                  "listen": "test",
                  "script": {
                    "type": "text/javascript",
                    "exec": [
                      "pm.test('Resposta 2xx', () => pm.expect(pm.response.code).to.be.within(200, 299));",
                      "if (pm.response.code >= 400) {",
                      "  try { console.warn('Erro da API:', JSON.stringify(pm.response.json())); } catch (e) {}",
                      "}"
                    ]
                  }
                }
              ],
              "request": {
                "method": "DELETE",
                "header": [],
                "url": {
                  "raw": "{{baseUrl}}/v1/folders/{{folderId}}",
                  "host": [
                    "{{baseUrl}}"
                  ],
                  "path": [
                    "v1",
                    "folders",
                    "{{folderId}}"
                  ]
                },
                "description": "As subpastas sobem para a pasta-mãe.\n\n| Campo | Onde | Tipo | Obrigatório | Descrição |\n|---|---|---|---|---|\n| `id` | path | uuid | sim | Pasta |\n\n**Resposta 200**\n\n```json\n{\n  \"totalElements\": 0,\n  \"entities\": []\n}\n```"
              },
              "response": [
                {
                  "name": "Exemplo 200",
                  "originalRequest": {
                    "method": "DELETE",
                    "header": [],
                    "url": {
                      "raw": "{{baseUrl}}/v1/folders/{{folderId}}",
                      "host": [
                        "{{baseUrl}}"
                      ],
                      "path": [
                        "v1",
                        "folders",
                        "{{folderId}}"
                      ]
                    }
                  },
                  "status": "OK",
                  "code": 200,
                  "_postman_previewlanguage": "json",
                  "header": [
                    {
                      "key": "Content-Type",
                      "value": "application/json"
                    }
                  ],
                  "body": "{\n  \"totalElements\": 0,\n  \"entities\": []\n}"
                }
              ]
            }
          ]
        },
        {
          "name": "📬 Contatos",
          "description": "Agenda de contatos da empresa, usada para preencher signatários. Criar e excluir exige que o usuário da API Key seja gestor da empresa.",
          "item": [
            {
              "name": "Criar contato",
              "event": [
                {
                  "listen": "test",
                  "script": {
                    "type": "text/javascript",
                    "exec": [
                      "pm.test('Resposta 2xx', () => pm.expect(pm.response.code).to.be.within(200, 299));",
                      "if (pm.response.code >= 400) {",
                      "  try { console.warn('Erro da API:', JSON.stringify(pm.response.json())); } catch (e) {}",
                      "}",
                      "const c = (pm.response.json().entities || [])[0];",
                      "if (c) pm.collectionVariables.set('contactId', c.id);"
                    ]
                  }
                }
              ],
              "request": {
                "method": "POST",
                "header": [
                  {
                    "key": "Content-Type",
                    "value": "application/json"
                  },
                  {
                    "key": "Idempotency-Key",
                    "value": "{{$guid}}",
                    "description": "Em retry da MESMA operação, reenvie o mesmo valor."
                  }
                ],
                "url": {
                  "raw": "{{baseUrl}}/v1/contacts",
                  "host": [
                    "{{baseUrl}}"
                  ],
                  "path": [
                    "v1",
                    "contacts"
                  ]
                },
                "description": "Aceita `Idempotency-Key` (a collection gera um automaticamente).\n\n| Campo | Onde | Tipo | Obrigatório | Descrição |\n|---|---|---|---|---|\n| `data.name` | body | string | sim | 1 a 150 |\n| `data.email` | body | string | sim |  |\n| `data.phone` | body | string | não |  |\n\n**Resposta 201**\n\n```json\n{\n  \"totalElements\": 1,\n  \"entities\": [\n    {\n      \"id\": \"3fa85f64-5717-4562-b3fc-2c963f66afa6\",\n      \"signerId\": \"3fa85f64-5717-4562-b3fc-2c963f66afa6\",\n      \"companyId\": \"3fa85f64-5717-4562-b3fc-2c963f66afa6\",\n      \"createdAt\": \"2026-10-13T12:00:00.000Z\"\n    }\n  ]\n}\n```\n\n**Erros comuns**\n\n- 400 `This contact exist`",
                "body": {
                  "mode": "raw",
                  "raw": "{\n  \"data\": {\n    \"name\": \"Maria Souza\",\n    \"email\": \"maria@exemplo.com.br\",\n    \"phone\": \"+5511999999999\"\n  }\n}",
                  "options": {
                    "raw": {
                      "language": "json"
                    }
                  }
                }
              },
              "response": [
                {
                  "name": "Exemplo 201",
                  "originalRequest": {
                    "method": "POST",
                    "header": [],
                    "url": {
                      "raw": "{{baseUrl}}/v1/contacts",
                      "host": [
                        "{{baseUrl}}"
                      ],
                      "path": [
                        "v1",
                        "contacts"
                      ]
                    }
                  },
                  "status": "OK",
                  "code": 201,
                  "_postman_previewlanguage": "json",
                  "header": [
                    {
                      "key": "Content-Type",
                      "value": "application/json"
                    }
                  ],
                  "body": "{\n  \"totalElements\": 1,\n  \"entities\": [\n    {\n      \"id\": \"3fa85f64-5717-4562-b3fc-2c963f66afa6\",\n      \"signerId\": \"3fa85f64-5717-4562-b3fc-2c963f66afa6\",\n      \"companyId\": \"3fa85f64-5717-4562-b3fc-2c963f66afa6\",\n      \"createdAt\": \"2026-10-13T12:00:00.000Z\"\n    }\n  ]\n}"
                }
              ]
            },
            {
              "name": "Listar / buscar contatos",
              "event": [
                {
                  "listen": "test",
                  "script": {
                    "type": "text/javascript",
                    "exec": [
                      "pm.test('Resposta 2xx', () => pm.expect(pm.response.code).to.be.within(200, 299));",
                      "if (pm.response.code >= 400) {",
                      "  try { console.warn('Erro da API:', JSON.stringify(pm.response.json())); } catch (e) {}",
                      "}"
                    ]
                  }
                }
              ],
              "request": {
                "method": "GET",
                "header": [],
                "url": {
                  "raw": "{{baseUrl}}/v1/contacts?page=1&pageSize=20",
                  "host": [
                    "{{baseUrl}}"
                  ],
                  "path": [
                    "v1",
                    "contacts"
                  ],
                  "query": [
                    {
                      "key": "page",
                      "value": "1"
                    },
                    {
                      "key": "pageSize",
                      "value": "20"
                    }
                  ]
                },
                "description": "`search` busca por nome, e-mail ou telefone (com `search`, a paginação é ignorada e voltam até `pageSize` resultados).\n\n| Campo | Onde | Tipo | Obrigatório | Descrição |\n|---|---|---|---|---|\n| `page` | query | integer | não | Número da página, a partir de 1 (padrão 1) |\n| `pageSize` | query | integer | não | 1 a 100 (padrão 20) |\n| `search` | query | string | não | Busca |\n\n**Resposta 200**\n\n```json\n{\n  \"totalElements\": 1,\n  \"entities\": [\n    {\n      \"id\": \"3fa85f64-5717-4562-b3fc-2c963f66afa6\",\n      \"name\": \"Maria Souza\",\n      \"email\": \"maria@exemplo.com.br\",\n      \"phone\": \"+5511999999999\",\n      \"envelopeSigners\": 4,\n      \"createdAt\": \"2026-10-13T12:00:00.000Z\"\n    }\n  ]\n}\n```"
              },
              "response": [
                {
                  "name": "Exemplo 200",
                  "originalRequest": {
                    "method": "GET",
                    "header": [],
                    "url": {
                      "raw": "{{baseUrl}}/v1/contacts?page=1&pageSize=20",
                      "host": [
                        "{{baseUrl}}"
                      ],
                      "path": [
                        "v1",
                        "contacts"
                      ],
                      "query": [
                        {
                          "key": "page",
                          "value": "1"
                        },
                        {
                          "key": "pageSize",
                          "value": "20"
                        }
                      ]
                    }
                  },
                  "status": "OK",
                  "code": 200,
                  "_postman_previewlanguage": "json",
                  "header": [
                    {
                      "key": "Content-Type",
                      "value": "application/json"
                    }
                  ],
                  "body": "{\n  \"totalElements\": 1,\n  \"entities\": [\n    {\n      \"id\": \"3fa85f64-5717-4562-b3fc-2c963f66afa6\",\n      \"name\": \"Maria Souza\",\n      \"email\": \"maria@exemplo.com.br\",\n      \"phone\": \"+5511999999999\",\n      \"envelopeSigners\": 4,\n      \"createdAt\": \"2026-10-13T12:00:00.000Z\"\n    }\n  ]\n}"
                }
              ]
            },
            {
              "name": "Excluir contato",
              "event": [
                {
                  "listen": "test",
                  "script": {
                    "type": "text/javascript",
                    "exec": [
                      "pm.test('Resposta 2xx', () => pm.expect(pm.response.code).to.be.within(200, 299));",
                      "if (pm.response.code >= 400) {",
                      "  try { console.warn('Erro da API:', JSON.stringify(pm.response.json())); } catch (e) {}",
                      "}"
                    ]
                  }
                }
              ],
              "request": {
                "method": "DELETE",
                "header": [],
                "url": {
                  "raw": "{{baseUrl}}/v1/contacts/{{contactId}}",
                  "host": [
                    "{{baseUrl}}"
                  ],
                  "path": [
                    "v1",
                    "contacts",
                    "{{contactId}}"
                  ]
                },
                "description": "| Campo | Onde | Tipo | Obrigatório | Descrição |\n|---|---|---|---|---|\n| `id` | path | uuid | sim | Contato |\n\n**Resposta:** 204 sem corpo.\n\n**Erros comuns**\n\n- 404 `Contact not found`"
              },
              "response": []
            }
          ]
        },
        {
          "name": "🔔 Webhooks",
          "description": "Cadastre uma URL e a Assin avisa seu sistema quando algo acontece, sem você precisar consultar. Nestas rotas `data` é um **objeto**.\n\n### Eventos\n| Evento | Quando |\n|---|---|\n| `SIGNER_COMPLETED` | Um signatário concluiu (não dispara para `CARBON_COPY`) |\n| `ENVELOPE_FINISHED` | Todos assinaram e o PDF final está pronto. Baixe com `GET /v1/envelopes/{id}/documents` |\n| `ENVELOPE_CANCELLED` | O envelope foi cancelado |\n| `ENVELOPE_EXPIRED` | O prazo venceu sem todas as assinaturas (verificação diária, por volta das 09:00 de Brasília) |\n\n### Como o aviso chega\n- `POST` na sua URL, `Content-Type: application/json`, timeout de 10 segundos. Responda **2xx** rapidamente e processe depois.\n- Header `x-assin-event-id`: identificador único do evento (o mesmo do campo `eventId`). Use para ignorar duplicados.\n- Os headers que você cadastrou (ex.: `Authorization`), para validar que o aviso veio da Assin.\n- **Não há nova tentativa automática.** Se seu endpoint falhar, use `POST /v1/webhook-domains/reprocess`.\n\n### Corpo (exemplo `SIGNER_COMPLETED`, resumido)\n```json\n{\n  \"event\": \"SIGNER_COMPLETED\",\n  \"eventId\": \"6f1c2a4e-8b0d-5c3a-9e7f-1a2b3c4d5e6f\",\n  \"envelope\": {\n    \"id\": \"3fa85f64-5717-4562-b3fc-2c963f66afa6\",\n    \"companyId\": \"3fa85f64-5717-4562-b3fc-2c963f66afa6\",\n    \"title\": \"Contrato de Prestação de Serviços\",\n    \"status\": \"WAITING_SIGNATURE\",\n    \"expiredAt\": \"2026-10-28T12:00:00.000Z\",\n    \"conclusionDate\": null,\n    \"validationByIcp\": false,\n    \"notificationChannel\": \"EMAIL\",\n    \"envelopeSigners\": [\n      {\n        \"signerId\": \"3fa85f64-5717-4562-b3fc-2c963f66afa6\",\n        \"envelopeId\": \"3fa85f64-5717-4562-b3fc-2c963f66afa6\",\n        \"order\": 0,\n        \"signatureType\": \"PARTY\",\n        \"status\": \"COMPLETED\",\n        \"signer\": {\n          \"id\": \"3fa85f64-5717-4562-b3fc-2c963f66afa6\",\n          \"fullName\": \"Maria Souza\",\n          \"email\": \"maria@exemplo.com.br\"\n        }\n      }\n    ]\n  },\n  \"signer\": {\n    \"signerId\": \"3fa85f64-5717-4562-b3fc-2c963f66afa6\",\n    \"envelopeId\": \"3fa85f64-5717-4562-b3fc-2c963f66afa6\",\n    \"status\": \"COMPLETED\",\n    \"signatureType\": \"PARTY\",\n    \"signer\": {\n      \"id\": \"3fa85f64-5717-4562-b3fc-2c963f66afa6\",\n      \"fullName\": \"Maria Souza\",\n      \"email\": \"maria@exemplo.com.br\"\n    }\n  }\n}\n```\n\nOs outros eventos têm o mesmo formato, sem o campo `signer`. `envelope` traz o envelope completo com todos os signatários.",
          "item": [
            {
              "name": "Cadastrar webhook",
              "event": [
                {
                  "listen": "test",
                  "script": {
                    "type": "text/javascript",
                    "exec": [
                      "pm.test('Resposta 2xx', () => pm.expect(pm.response.code).to.be.within(200, 299));",
                      "if (pm.response.code >= 400) {",
                      "  try { console.warn('Erro da API:', JSON.stringify(pm.response.json())); } catch (e) {}",
                      "}",
                      "const b = pm.response.json();",
                      "const id = b.id || b.data?.id || (b.entities || [])[0]?.id;",
                      "if (id) pm.collectionVariables.set('webhookId', id);"
                    ]
                  }
                }
              ],
              "request": {
                "method": "POST",
                "header": [
                  {
                    "key": "Content-Type",
                    "value": "application/json"
                  },
                  {
                    "key": "Idempotency-Key",
                    "value": "{{$guid}}",
                    "description": "Em retry da MESMA operação, reenvie o mesmo valor."
                  }
                ],
                "url": {
                  "raw": "{{baseUrl}}/v1/webhook-domains",
                  "host": [
                    "{{baseUrl}}"
                  ],
                  "path": [
                    "v1",
                    "webhook-domains"
                  ]
                },
                "description": "Aceita `Idempotency-Key` (a collection gera um automaticamente).\n\n| Campo | Onde | Tipo | Obrigatório | Descrição |\n|---|---|---|---|---|\n| `data.domain` | body | URL | sim | Endereço que recebe os avisos (http ou https) |\n| `data.events` | body | enum[] | sim | Um ou mais eventos |\n| `data.description` | body | string | não | Até 255 caracteres |\n\n**Resposta 201**\n\n```json\n{\n  \"id\": \"3fa85f64-5717-4562-b3fc-2c963f66afa6\",\n  \"domain\": \"https://seusistema.com.br/webhooks/assin\",\n  \"description\": \"Produção\",\n  \"isActive\": true,\n  \"headers\": {},\n  \"eventSubscriptions\": [\n    {\n      \"eventType\": \"SIGNER_COMPLETED\"\n    },\n    {\n      \"eventType\": \"ENVELOPE_FINISHED\"\n    }\n  ]\n}\n```",
                "body": {
                  "mode": "raw",
                  "raw": "{\n  \"data\": {\n    \"domain\": \"https://seusistema.com.br/webhooks/assin\",\n    \"description\": \"Produção\",\n    \"events\": [\n      \"SIGNER_COMPLETED\",\n      \"ENVELOPE_FINISHED\",\n      \"ENVELOPE_CANCELLED\",\n      \"ENVELOPE_EXPIRED\"\n    ]\n  }\n}",
                  "options": {
                    "raw": {
                      "language": "json"
                    }
                  }
                }
              },
              "response": [
                {
                  "name": "Exemplo 201",
                  "originalRequest": {
                    "method": "POST",
                    "header": [],
                    "url": {
                      "raw": "{{baseUrl}}/v1/webhook-domains",
                      "host": [
                        "{{baseUrl}}"
                      ],
                      "path": [
                        "v1",
                        "webhook-domains"
                      ]
                    }
                  },
                  "status": "OK",
                  "code": 201,
                  "_postman_previewlanguage": "json",
                  "header": [
                    {
                      "key": "Content-Type",
                      "value": "application/json"
                    }
                  ],
                  "body": "{\n  \"id\": \"3fa85f64-5717-4562-b3fc-2c963f66afa6\",\n  \"domain\": \"https://seusistema.com.br/webhooks/assin\",\n  \"description\": \"Produção\",\n  \"isActive\": true,\n  \"headers\": {},\n  \"eventSubscriptions\": [\n    {\n      \"eventType\": \"SIGNER_COMPLETED\"\n    },\n    {\n      \"eventType\": \"ENVELOPE_FINISHED\"\n    }\n  ]\n}"
                }
              ]
            },
            {
              "name": "Definir headers enviados nos avisos",
              "event": [
                {
                  "listen": "test",
                  "script": {
                    "type": "text/javascript",
                    "exec": [
                      "pm.test('Resposta 2xx', () => pm.expect(pm.response.code).to.be.within(200, 299));",
                      "if (pm.response.code >= 400) {",
                      "  try { console.warn('Erro da API:', JSON.stringify(pm.response.json())); } catch (e) {}",
                      "}"
                    ]
                  }
                }
              ],
              "request": {
                "method": "PUT",
                "header": [
                  {
                    "key": "Content-Type",
                    "value": "application/json"
                  }
                ],
                "url": {
                  "raw": "{{baseUrl}}/v1/webhook-domains/{{webhookId}}/headers",
                  "host": [
                    "{{baseUrl}}"
                  ],
                  "path": [
                    "v1",
                    "webhook-domains",
                    "{{webhookId}}",
                    "headers"
                  ]
                },
                "description": "Adiciona ou substitui headers enviados em todos os avisos (ex.: um segredo para você validar). Até 20 headers; nomes são gravados em minúsculas; valores aparecem mascarados nas respostas. Não é permitido `Content-Type`, `Content-Length`, `Host`, `Transfer-Encoding` e `Connection`.\n\n| Campo | Onde | Tipo | Obrigatório | Descrição |\n|---|---|---|---|---|\n| `id` | path | uuid | sim | Webhook |\n| `data.headers` | body | objeto | sim | `{ \"Nome\": \"valor\" }` |\n\n**Resposta 200**\n\n```json\n{\n  \"id\": \"3fa85f64-5717-4562-b3fc-2c963f66afa6\",\n  \"headers\": {\n    \"authorization\": \"Bear…\"\n  }\n}\n```",
                "body": {
                  "mode": "raw",
                  "raw": "{\n  \"data\": {\n    \"headers\": {\n      \"Authorization\": \"Bearer seu-segredo-aqui\"\n    }\n  }\n}",
                  "options": {
                    "raw": {
                      "language": "json"
                    }
                  }
                }
              },
              "response": [
                {
                  "name": "Exemplo 200",
                  "originalRequest": {
                    "method": "PUT",
                    "header": [],
                    "url": {
                      "raw": "{{baseUrl}}/v1/webhook-domains/{{webhookId}}/headers",
                      "host": [
                        "{{baseUrl}}"
                      ],
                      "path": [
                        "v1",
                        "webhook-domains",
                        "{{webhookId}}",
                        "headers"
                      ]
                    }
                  },
                  "status": "OK",
                  "code": 200,
                  "_postman_previewlanguage": "json",
                  "header": [
                    {
                      "key": "Content-Type",
                      "value": "application/json"
                    }
                  ],
                  "body": "{\n  \"id\": \"3fa85f64-5717-4562-b3fc-2c963f66afa6\",\n  \"headers\": {\n    \"authorization\": \"Bear…\"\n  }\n}"
                }
              ]
            },
            {
              "name": "Remover headers",
              "event": [
                {
                  "listen": "test",
                  "script": {
                    "type": "text/javascript",
                    "exec": [
                      "pm.test('Resposta 2xx', () => pm.expect(pm.response.code).to.be.within(200, 299));",
                      "if (pm.response.code >= 400) {",
                      "  try { console.warn('Erro da API:', JSON.stringify(pm.response.json())); } catch (e) {}",
                      "}"
                    ]
                  }
                }
              ],
              "request": {
                "method": "DELETE",
                "header": [
                  {
                    "key": "Content-Type",
                    "value": "application/json"
                  }
                ],
                "url": {
                  "raw": "{{baseUrl}}/v1/webhook-domains/{{webhookId}}/headers",
                  "host": [
                    "{{baseUrl}}"
                  ],
                  "path": [
                    "v1",
                    "webhook-domains",
                    "{{webhookId}}",
                    "headers"
                  ]
                },
                "description": "| Campo | Onde | Tipo | Obrigatório | Descrição |\n|---|---|---|---|---|\n| `id` | path | uuid | sim | Webhook |\n| `data.names` | body | string[] | sim | Nomes dos headers |\n\n**Resposta 200**\n\n```json\n{\n  \"id\": \"3fa85f64-5717-4562-b3fc-2c963f66afa6\",\n  \"headers\": {}\n}\n```",
                "body": {
                  "mode": "raw",
                  "raw": "{\n  \"data\": {\n    \"names\": [\n      \"authorization\"\n    ]\n  }\n}",
                  "options": {
                    "raw": {
                      "language": "json"
                    }
                  }
                }
              },
              "response": [
                {
                  "name": "Exemplo 200",
                  "originalRequest": {
                    "method": "DELETE",
                    "header": [],
                    "url": {
                      "raw": "{{baseUrl}}/v1/webhook-domains/{{webhookId}}/headers",
                      "host": [
                        "{{baseUrl}}"
                      ],
                      "path": [
                        "v1",
                        "webhook-domains",
                        "{{webhookId}}",
                        "headers"
                      ]
                    }
                  },
                  "status": "OK",
                  "code": 200,
                  "_postman_previewlanguage": "json",
                  "header": [
                    {
                      "key": "Content-Type",
                      "value": "application/json"
                    }
                  ],
                  "body": "{\n  \"id\": \"3fa85f64-5717-4562-b3fc-2c963f66afa6\",\n  \"headers\": {}\n}"
                }
              ]
            },
            {
              "name": "Listar webhooks",
              "event": [
                {
                  "listen": "test",
                  "script": {
                    "type": "text/javascript",
                    "exec": [
                      "pm.test('Resposta 2xx', () => pm.expect(pm.response.code).to.be.within(200, 299));",
                      "if (pm.response.code >= 400) {",
                      "  try { console.warn('Erro da API:', JSON.stringify(pm.response.json())); } catch (e) {}",
                      "}"
                    ]
                  }
                }
              ],
              "request": {
                "method": "GET",
                "header": [],
                "url": {
                  "raw": "{{baseUrl}}/v1/webhook-domains",
                  "host": [
                    "{{baseUrl}}"
                  ],
                  "path": [
                    "v1",
                    "webhook-domains"
                  ]
                },
                "description": "**Resposta 200**\n\n```json\n{\n  \"totalElements\": 1,\n  \"data\": [\n    {\n      \"id\": \"3fa85f64-5717-4562-b3fc-2c963f66afa6\",\n      \"domain\": \"https://seusistema.com.br/webhooks/assin\",\n      \"isActive\": true,\n      \"headers\": {\n        \"authorization\": \"Bear…\"\n      },\n      \"eventSubscriptions\": [\n        {\n          \"eventType\": \"ENVELOPE_FINISHED\"\n        }\n      ]\n    }\n  ]\n}\n```"
              },
              "response": [
                {
                  "name": "Exemplo 200",
                  "originalRequest": {
                    "method": "GET",
                    "header": [],
                    "url": {
                      "raw": "{{baseUrl}}/v1/webhook-domains",
                      "host": [
                        "{{baseUrl}}"
                      ],
                      "path": [
                        "v1",
                        "webhook-domains"
                      ]
                    }
                  },
                  "status": "OK",
                  "code": 200,
                  "_postman_previewlanguage": "json",
                  "header": [
                    {
                      "key": "Content-Type",
                      "value": "application/json"
                    }
                  ],
                  "body": "{\n  \"totalElements\": 1,\n  \"data\": [\n    {\n      \"id\": \"3fa85f64-5717-4562-b3fc-2c963f66afa6\",\n      \"domain\": \"https://seusistema.com.br/webhooks/assin\",\n      \"isActive\": true,\n      \"headers\": {\n        \"authorization\": \"Bear…\"\n      },\n      \"eventSubscriptions\": [\n        {\n          \"eventType\": \"ENVELOPE_FINISHED\"\n        }\n      ]\n    }\n  ]\n}"
                }
              ]
            },
            {
              "name": "Alterar / desativar webhook",
              "event": [
                {
                  "listen": "test",
                  "script": {
                    "type": "text/javascript",
                    "exec": [
                      "pm.test('Resposta 2xx', () => pm.expect(pm.response.code).to.be.within(200, 299));",
                      "if (pm.response.code >= 400) {",
                      "  try { console.warn('Erro da API:', JSON.stringify(pm.response.json())); } catch (e) {}",
                      "}"
                    ]
                  }
                }
              ],
              "request": {
                "method": "PUT",
                "header": [
                  {
                    "key": "Content-Type",
                    "value": "application/json"
                  }
                ],
                "url": {
                  "raw": "{{baseUrl}}/v1/webhook-domains/{{webhookId}}",
                  "host": [
                    "{{baseUrl}}"
                  ],
                  "path": [
                    "v1",
                    "webhook-domains",
                    "{{webhookId}}"
                  ]
                },
                "description": "| Campo | Onde | Tipo | Obrigatório | Descrição |\n|---|---|---|---|---|\n| `id` | path | uuid | sim | Webhook |\n| `data.domain` | body | URL | não |  |\n| `data.events` | body | enum[] | não |  |\n| `data.description` | body | string | não |  |\n| `data.isActive` | body | boolean | não | `false` para pausar os avisos |\n\n**Resposta 200**\n\n```json\n{\n  \"id\": \"3fa85f64-5717-4562-b3fc-2c963f66afa6\",\n  \"isActive\": false\n}\n```\n\n**Erros comuns**\n\n- 404 webhook não encontrado",
                "body": {
                  "mode": "raw",
                  "raw": "{\n  \"data\": {\n    \"isActive\": false\n  }\n}",
                  "options": {
                    "raw": {
                      "language": "json"
                    }
                  }
                }
              },
              "response": [
                {
                  "name": "Exemplo 200",
                  "originalRequest": {
                    "method": "PUT",
                    "header": [],
                    "url": {
                      "raw": "{{baseUrl}}/v1/webhook-domains/{{webhookId}}",
                      "host": [
                        "{{baseUrl}}"
                      ],
                      "path": [
                        "v1",
                        "webhook-domains",
                        "{{webhookId}}"
                      ]
                    }
                  },
                  "status": "OK",
                  "code": 200,
                  "_postman_previewlanguage": "json",
                  "header": [
                    {
                      "key": "Content-Type",
                      "value": "application/json"
                    }
                  ],
                  "body": "{\n  \"id\": \"3fa85f64-5717-4562-b3fc-2c963f66afa6\",\n  \"isActive\": false\n}"
                }
              ]
            },
            {
              "name": "Reenviar avisos que falharam",
              "event": [
                {
                  "listen": "test",
                  "script": {
                    "type": "text/javascript",
                    "exec": [
                      "pm.test('Resposta 2xx', () => pm.expect(pm.response.code).to.be.within(200, 299));",
                      "if (pm.response.code >= 400) {",
                      "  try { console.warn('Erro da API:', JSON.stringify(pm.response.json())); } catch (e) {}",
                      "}"
                    ]
                  }
                }
              ],
              "request": {
                "method": "POST",
                "header": [
                  {
                    "key": "Content-Type",
                    "value": "application/json"
                  },
                  {
                    "key": "Idempotency-Key",
                    "value": "{{$guid}}",
                    "description": "Em retry da MESMA operação, reenvie o mesmo valor."
                  }
                ],
                "url": {
                  "raw": "{{baseUrl}}/v1/webhook-domains/reprocess",
                  "host": [
                    "{{baseUrl}}"
                  ],
                  "path": [
                    "v1",
                    "webhook-domains",
                    "reprocess"
                  ]
                },
                "description": "Reenvia os avisos (a última tentativa de cada envelope e evento) para os webhooks ativos. Até 500 por chamada.\n\nAceita `Idempotency-Key` (a collection gera um automaticamente).\n\n| Campo | Onde | Tipo | Obrigatório | Descrição |\n|---|---|---|---|---|\n| `data.onlyFailed` | body | boolean | não | Só os que não receberam 2xx (padrão `true`) |\n| `data.envelopeIds` | body | uuid[] | não | Limitar a envelopes (até 500) |\n| `data.from` | body | ISO 8601 | não | Início do período |\n| `data.to` | body | ISO 8601 | não | Fim do período |\n\n**Resposta 200**\n\n```json\n{\n  \"matched\": 3,\n  \"resent\": 3,\n  \"succeeded\": 3,\n  \"failed\": 0,\n  \"skipped\": 0,\n  \"notReprocessable\": 0,\n  \"truncated\": false\n}\n```",
                "body": {
                  "mode": "raw",
                  "raw": "{\n  \"data\": {\n    \"onlyFailed\": true\n  }\n}",
                  "options": {
                    "raw": {
                      "language": "json"
                    }
                  }
                }
              },
              "response": [
                {
                  "name": "Exemplo 200",
                  "originalRequest": {
                    "method": "POST",
                    "header": [],
                    "url": {
                      "raw": "{{baseUrl}}/v1/webhook-domains/reprocess",
                      "host": [
                        "{{baseUrl}}"
                      ],
                      "path": [
                        "v1",
                        "webhook-domains",
                        "reprocess"
                      ]
                    }
                  },
                  "status": "OK",
                  "code": 200,
                  "_postman_previewlanguage": "json",
                  "header": [
                    {
                      "key": "Content-Type",
                      "value": "application/json"
                    }
                  ],
                  "body": "{\n  \"matched\": 3,\n  \"resent\": 3,\n  \"succeeded\": 3,\n  \"failed\": 0,\n  \"skipped\": 0,\n  \"notReprocessable\": 0,\n  \"truncated\": false\n}"
                }
              ]
            },
            {
              "name": "Remover webhook",
              "event": [
                {
                  "listen": "test",
                  "script": {
                    "type": "text/javascript",
                    "exec": [
                      "pm.test('Resposta 2xx', () => pm.expect(pm.response.code).to.be.within(200, 299));",
                      "if (pm.response.code >= 400) {",
                      "  try { console.warn('Erro da API:', JSON.stringify(pm.response.json())); } catch (e) {}",
                      "}"
                    ]
                  }
                }
              ],
              "request": {
                "method": "DELETE",
                "header": [],
                "url": {
                  "raw": "{{baseUrl}}/v1/webhook-domains/{{webhookId}}",
                  "host": [
                    "{{baseUrl}}"
                  ],
                  "path": [
                    "v1",
                    "webhook-domains",
                    "{{webhookId}}"
                  ]
                },
                "description": "| Campo | Onde | Tipo | Obrigatório | Descrição |\n|---|---|---|---|---|\n| `id` | path | uuid | sim | Webhook |\n\n**Resposta:** 204 sem corpo."
              },
              "response": []
            }
          ]
        },
        {
          "name": "⚡ Lotes (envio em massa)",
          "description": "Gera **um envelope por signatário variável**, todos com os mesmos documentos e os mesmos signatários fixos. Exemplo: o mesmo termo para 300 colaboradores, cada um no seu envelope, com o RH assinando todos.\n\n### Etapas\n1. Criar o lote.\n2. Adicionar os documentos do lote (cada um gera uma URL de upload, como em Documentos).\n3. Adicionar signatários: `fixed: true` entra em **todos** os envelopes; `fixed: false` gera **um envelope** para cada.\n4. (Opcional) Definir as posições dos campos em cada documento.\n5. Processar: os envelopes são criados, lacrados e enviados.\n\nNas rotas de lote `data` é um **objeto**. O `companyId` que aparece em algumas URLs é o da sua empresa; ele vem na resposta da criação do lote (a collection guarda sozinha).\n\n**Atenção às posições no lote:** cada campo definido no documento do lote é aplicado a **todos** os signatários de cada envelope, na mesma posição. Defina ao menos 2 campos por documento.",
          "item": [
            {
              "name": "Criar lote",
              "event": [
                {
                  "listen": "test",
                  "script": {
                    "type": "text/javascript",
                    "exec": [
                      "pm.test('Resposta 2xx', () => pm.expect(pm.response.code).to.be.within(200, 299));",
                      "if (pm.response.code >= 400) {",
                      "  try { console.warn('Erro da API:', JSON.stringify(pm.response.json())); } catch (e) {}",
                      "}",
                      "const b = (pm.response.json().entities || [])[0];",
                      "if (b) { pm.collectionVariables.set('batchId', b.id); if (b.companyId) pm.collectionVariables.set('companyId', b.companyId); }"
                    ]
                  }
                }
              ],
              "request": {
                "method": "POST",
                "header": [
                  {
                    "key": "Content-Type",
                    "value": "application/json"
                  },
                  {
                    "key": "Idempotency-Key",
                    "value": "{{$guid}}",
                    "description": "Em retry da MESMA operação, reenvie o mesmo valor."
                  }
                ],
                "url": {
                  "raw": "{{baseUrl}}/v1/batches",
                  "host": [
                    "{{baseUrl}}"
                  ],
                  "path": [
                    "v1",
                    "batches"
                  ]
                },
                "description": "Aceita `Idempotency-Key` (a collection gera um automaticamente).\n\n| Campo | Onde | Tipo | Obrigatório | Descrição |\n|---|---|---|---|---|\n| `data.name` | body | string | sim |  |\n| `data.description` | body | string | sim |  |\n\n**Resposta 201**\n\n```json\n{\n  \"totalElements\": 1,\n  \"entities\": [\n    {\n      \"id\": \"3fa85f64-5717-4562-b3fc-2c963f66afa6\",\n      \"name\": \"Termo de confidencialidade - Out/2026\",\n      \"description\": \"Envio para todos os colaboradores\",\n      \"companyId\": \"3fa85f64-5717-4562-b3fc-2c963f66afa6\",\n      \"status\": \"DRAFT\"\n    }\n  ]\n}\n```",
                "body": {
                  "mode": "raw",
                  "raw": "{\n  \"data\": {\n    \"name\": \"Termo de confidencialidade - Out/2026\",\n    \"description\": \"Envio para todos os colaboradores\"\n  }\n}",
                  "options": {
                    "raw": {
                      "language": "json"
                    }
                  }
                }
              },
              "response": [
                {
                  "name": "Exemplo 201",
                  "originalRequest": {
                    "method": "POST",
                    "header": [],
                    "url": {
                      "raw": "{{baseUrl}}/v1/batches",
                      "host": [
                        "{{baseUrl}}"
                      ],
                      "path": [
                        "v1",
                        "batches"
                      ]
                    }
                  },
                  "status": "OK",
                  "code": 201,
                  "_postman_previewlanguage": "json",
                  "header": [
                    {
                      "key": "Content-Type",
                      "value": "application/json"
                    }
                  ],
                  "body": "{\n  \"totalElements\": 1,\n  \"entities\": [\n    {\n      \"id\": \"3fa85f64-5717-4562-b3fc-2c963f66afa6\",\n      \"name\": \"Termo de confidencialidade - Out/2026\",\n      \"description\": \"Envio para todos os colaboradores\",\n      \"companyId\": \"3fa85f64-5717-4562-b3fc-2c963f66afa6\",\n      \"status\": \"DRAFT\"\n    }\n  ]\n}"
                }
              ]
            },
            {
              "name": "Adicionar documento ao lote (gera URL de upload)",
              "event": [
                {
                  "listen": "test",
                  "script": {
                    "type": "text/javascript",
                    "exec": [
                      "pm.test('Resposta 2xx', () => pm.expect(pm.response.code).to.be.within(200, 299));",
                      "if (pm.response.code >= 400) {",
                      "  try { console.warn('Erro da API:', JSON.stringify(pm.response.json())); } catch (e) {}",
                      "}",
                      "const b = pm.response.json();",
                      "const doc = (b.documents || b.data?.documents || [])[0];",
                      "if (doc) { pm.collectionVariables.set('batchDocumentId', doc.id); pm.collectionVariables.set('uploadUrl', doc.url); }"
                    ]
                  }
                }
              ],
              "request": {
                "method": "POST",
                "header": [
                  {
                    "key": "Content-Type",
                    "value": "application/json"
                  },
                  {
                    "key": "Idempotency-Key",
                    "value": "{{$guid}}",
                    "description": "Em retry da MESMA operação, reenvie o mesmo valor."
                  }
                ],
                "url": {
                  "raw": "{{baseUrl}}/v1/batches-document",
                  "host": [
                    "{{baseUrl}}"
                  ],
                  "path": [
                    "v1",
                    "batches-document"
                  ]
                },
                "description": "Cria o documento do lote e devolve a URL de upload (5 minutos). Envie o PDF com `PUT` nessa URL, igual a Documentos.\n\nAceita `Idempotency-Key` (a collection gera um automaticamente).\n\n| Campo | Onde | Tipo | Obrigatório | Descrição |\n|---|---|---|---|---|\n| `data.batchId` | body | uuid | sim | Lote |\n| `data.alias` | body | string | sim | Nome do documento |\n\n**Resposta 201**\n\n```json\n{\n  \"statusCode\": 201,\n  \"message\": \"Successfully create document\",\n  \"data\": {\n    \"documents\": [\n      {\n        \"id\": \"3fa85f64-5717-4562-b3fc-2c963f66afa6\",\n        \"alias\": \"Termo de confidencialidade.pdf\",\n        \"url\": \"https://<bucket>.s3.amazonaws.com/...?X-Amz-Expires=300&...\"\n      }\n    ]\n  }\n}\n```",
                "body": {
                  "mode": "raw",
                  "raw": "{\n  \"data\": {\n    \"batchId\": \"{{batchId}}\",\n    \"alias\": \"Termo de confidencialidade.pdf\"\n  }\n}",
                  "options": {
                    "raw": {
                      "language": "json"
                    }
                  }
                }
              },
              "response": [
                {
                  "name": "Exemplo 201",
                  "originalRequest": {
                    "method": "POST",
                    "header": [],
                    "url": {
                      "raw": "{{baseUrl}}/v1/batches-document",
                      "host": [
                        "{{baseUrl}}"
                      ],
                      "path": [
                        "v1",
                        "batches-document"
                      ]
                    }
                  },
                  "status": "OK",
                  "code": 201,
                  "_postman_previewlanguage": "json",
                  "header": [
                    {
                      "key": "Content-Type",
                      "value": "application/json"
                    }
                  ],
                  "body": "{\n  \"statusCode\": 201,\n  \"message\": \"Successfully create document\",\n  \"data\": {\n    \"documents\": [\n      {\n        \"id\": \"3fa85f64-5717-4562-b3fc-2c963f66afa6\",\n        \"alias\": \"Termo de confidencialidade.pdf\",\n        \"url\": \"https://<bucket>.s3.amazonaws.com/...?X-Amz-Expires=300&...\"\n      }\n    ]\n  }\n}"
                }
              ]
            },
            {
              "name": "Enviar o PDF do lote",
              "event": [
                {
                  "listen": "test",
                  "script": {
                    "type": "text/javascript",
                    "exec": [
                      "pm.test('Resposta 2xx', () => pm.expect(pm.response.code).to.be.within(200, 299));",
                      "if (pm.response.code >= 400) {",
                      "  try { console.warn('Erro da API:', JSON.stringify(pm.response.json())); } catch (e) {}",
                      "}"
                    ]
                  }
                }
              ],
              "request": {
                "method": "PUT",
                "header": [
                  {
                    "key": "Content-Type",
                    "value": "application/pdf"
                  }
                ],
                "url": {
                  "raw": "{{uploadUrl}}"
                },
                "description": "Corpo binário com o PDF, sem `Authorization`. Mesmas regras do upload de documentos.\n\n**Resposta:** 200 com corpo vazio.",
                "body": {
                  "mode": "file",
                  "file": {
                    "src": ""
                  }
                },
                "auth": {
                  "type": "noauth"
                }
              },
              "response": []
            },
            {
              "name": "Adicionar signatário ao lote",
              "event": [
                {
                  "listen": "test",
                  "script": {
                    "type": "text/javascript",
                    "exec": [
                      "pm.test('Resposta 2xx', () => pm.expect(pm.response.code).to.be.within(200, 299));",
                      "if (pm.response.code >= 400) {",
                      "  try { console.warn('Erro da API:', JSON.stringify(pm.response.json())); } catch (e) {}",
                      "}",
                      "const s = (pm.response.json().entities || [])[0];",
                      "if (s) pm.collectionVariables.set('batchSignerId', s.signerId);"
                    ]
                  }
                }
              ],
              "request": {
                "method": "POST",
                "header": [
                  {
                    "key": "Content-Type",
                    "value": "application/json"
                  },
                  {
                    "key": "Idempotency-Key",
                    "value": "{{$guid}}",
                    "description": "Em retry da MESMA operação, reenvie o mesmo valor."
                  }
                ],
                "url": {
                  "raw": "{{baseUrl}}/v1/batches-signer",
                  "host": [
                    "{{baseUrl}}"
                  ],
                  "path": [
                    "v1",
                    "batches-signer"
                  ]
                },
                "description": "Adicione um por chamada. `fixed: true` = entra em todos os envelopes (ex.: o RH). `fixed: false` = cada um gera um envelope.\n\nAceita `Idempotency-Key` (a collection gera um automaticamente).\n\n| Campo | Onde | Tipo | Obrigatório | Descrição |\n|---|---|---|---|---|\n| `data.batchId` | body | uuid | sim | Lote |\n| `data.email` | body | string | sim |  |\n| `data.fullName` | body | string | não |  |\n| `data.signatureType` | body | enum | sim | Tipos de signatário, exceto `CARBON_COPY` |\n| `data.fixed` | body | boolean | não | Padrão `false` |\n| `data.order` | body | integer | não |  |\n| `data.requirePersonalDocument` | body | boolean | não | Padrão `false` |\n| `data.requireEmailToken` | body | boolean | não | Padrão `false` |\n\n**Resposta 201**\n\n```json\n{\n  \"totalElements\": 1,\n  \"entities\": [\n    {\n      \"id\": \"3fa85f64-5717-4562-b3fc-2c963f66afa6\",\n      \"batchId\": \"3fa85f64-5717-4562-b3fc-2c963f66afa6\",\n      \"signerId\": \"3fa85f64-5717-4562-b3fc-2c963f66afa6\",\n      \"fixed\": false\n    }\n  ]\n}\n```",
                "body": {
                  "mode": "raw",
                  "raw": "{\n  \"data\": {\n    \"batchId\": \"{{batchId}}\",\n    \"fixed\": false,\n    \"signatureType\": \"PARTY\",\n    \"email\": \"colaborador1@exemplo.com.br\",\n    \"fullName\": \"Colaborador Um\"\n  }\n}",
                  "options": {
                    "raw": {
                      "language": "json"
                    }
                  }
                }
              },
              "response": [
                {
                  "name": "Exemplo 201",
                  "originalRequest": {
                    "method": "POST",
                    "header": [],
                    "url": {
                      "raw": "{{baseUrl}}/v1/batches-signer",
                      "host": [
                        "{{baseUrl}}"
                      ],
                      "path": [
                        "v1",
                        "batches-signer"
                      ]
                    }
                  },
                  "status": "OK",
                  "code": 201,
                  "_postman_previewlanguage": "json",
                  "header": [
                    {
                      "key": "Content-Type",
                      "value": "application/json"
                    }
                  ],
                  "body": "{\n  \"totalElements\": 1,\n  \"entities\": [\n    {\n      \"id\": \"3fa85f64-5717-4562-b3fc-2c963f66afa6\",\n      \"batchId\": \"3fa85f64-5717-4562-b3fc-2c963f66afa6\",\n      \"signerId\": \"3fa85f64-5717-4562-b3fc-2c963f66afa6\",\n      \"fixed\": false\n    }\n  ]\n}"
                }
              ]
            },
            {
              "name": "Listar signatários do lote",
              "event": [
                {
                  "listen": "test",
                  "script": {
                    "type": "text/javascript",
                    "exec": [
                      "pm.test('Resposta 2xx', () => pm.expect(pm.response.code).to.be.within(200, 299));",
                      "if (pm.response.code >= 400) {",
                      "  try { console.warn('Erro da API:', JSON.stringify(pm.response.json())); } catch (e) {}",
                      "}"
                    ]
                  }
                }
              ],
              "request": {
                "method": "GET",
                "header": [],
                "url": {
                  "raw": "{{baseUrl}}/v1/batches-signer/{{batchId}}",
                  "host": [
                    "{{baseUrl}}"
                  ],
                  "path": [
                    "v1",
                    "batches-signer",
                    "{{batchId}}"
                  ]
                },
                "description": "| Campo | Onde | Tipo | Obrigatório | Descrição |\n|---|---|---|---|---|\n| `batchId` | path | uuid | sim | Lote |\n\n**Resposta 200**\n\n```json\n{\n  \"totalElements\": 1,\n  \"entities\": [\n    {\n      \"id\": \"3fa85f64-5717-4562-b3fc-2c963f66afa6\",\n      \"batchId\": \"3fa85f64-5717-4562-b3fc-2c963f66afa6\",\n      \"signerId\": \"3fa85f64-5717-4562-b3fc-2c963f66afa6\",\n      \"fixed\": false,\n      \"envelopeSigner\": {\n        \"order\": 0,\n        \"signatureType\": \"PARTY\"\n      }\n    }\n  ]\n}\n```"
              },
              "response": [
                {
                  "name": "Exemplo 200",
                  "originalRequest": {
                    "method": "GET",
                    "header": [],
                    "url": {
                      "raw": "{{baseUrl}}/v1/batches-signer/{{batchId}}",
                      "host": [
                        "{{baseUrl}}"
                      ],
                      "path": [
                        "v1",
                        "batches-signer",
                        "{{batchId}}"
                      ]
                    }
                  },
                  "status": "OK",
                  "code": 200,
                  "_postman_previewlanguage": "json",
                  "header": [
                    {
                      "key": "Content-Type",
                      "value": "application/json"
                    }
                  ],
                  "body": "{\n  \"totalElements\": 1,\n  \"entities\": [\n    {\n      \"id\": \"3fa85f64-5717-4562-b3fc-2c963f66afa6\",\n      \"batchId\": \"3fa85f64-5717-4562-b3fc-2c963f66afa6\",\n      \"signerId\": \"3fa85f64-5717-4562-b3fc-2c963f66afa6\",\n      \"fixed\": false,\n      \"envelopeSigner\": {\n        \"order\": 0,\n        \"signatureType\": \"PARTY\"\n      }\n    }\n  ]\n}"
                }
              ]
            },
            {
              "name": "Definir posições dos campos no documento do lote",
              "event": [
                {
                  "listen": "test",
                  "script": {
                    "type": "text/javascript",
                    "exec": [
                      "pm.test('Resposta 2xx', () => pm.expect(pm.response.code).to.be.within(200, 299));",
                      "if (pm.response.code >= 400) {",
                      "  try { console.warn('Erro da API:', JSON.stringify(pm.response.json())); } catch (e) {}",
                      "}"
                    ]
                  }
                }
              ],
              "request": {
                "method": "PUT",
                "header": [
                  {
                    "key": "Content-Type",
                    "value": "application/json"
                  }
                ],
                "url": {
                  "raw": "{{baseUrl}}/v1/batches-document",
                  "host": [
                    "{{baseUrl}}"
                  ],
                  "path": [
                    "v1",
                    "batches-document"
                  ]
                },
                "description": "Define os campos do documento. Coordenadas iguais às de Campos de assinatura (frações 0 a 1, a partir do canto superior esquerdo). `envelopeDocumentId` é o id do documento do lote; `envelopeSignerId` é o `signerId` de um signatário do lote.\n\n| Campo | Onde | Tipo | Obrigatório | Descrição |\n|---|---|---|---|---|\n| `data.batchId` | body | uuid | sim | Lote |\n| `data.documentId` | body | uuid | sim | Documento do lote |\n| `data.tags[]` | body | array | sim | `fixed`, `envelopeSignerId`, `envelopeDocumentId`, `elementType`, `page`, `axisX`, `axisY`, `angle` |\n\n**Resposta 200**\n\n```json\n{\n  \"totalElements\": 1,\n  \"entities\": [\n    {\n      \"batchId\": \"3fa85f64-5717-4562-b3fc-2c963f66afa6\",\n      \"documentId\": \"3fa85f64-5717-4562-b3fc-2c963f66afa6\"\n    }\n  ]\n}\n```",
                "body": {
                  "mode": "raw",
                  "raw": "{\n  \"data\": {\n    \"batchId\": \"{{batchId}}\",\n    \"documentId\": \"{{batchDocumentId}}\",\n    \"tags\": [\n      {\n        \"fixed\": false,\n        \"envelopeSignerId\": \"{{batchSignerId}}\",\n        \"envelopeDocumentId\": \"{{batchDocumentId}}\",\n        \"elementType\": \"SIGNATURE\",\n        \"page\": 1,\n        \"axisX\": 0.1,\n        \"axisY\": 0.8,\n        \"angle\": 0\n      },\n      {\n        \"fixed\": false,\n        \"envelopeSignerId\": \"{{batchSignerId}}\",\n        \"envelopeDocumentId\": \"{{batchDocumentId}}\",\n        \"elementType\": \"FULL_NAME\",\n        \"page\": 1,\n        \"axisX\": 0.1,\n        \"axisY\": 0.88,\n        \"angle\": 0\n      }\n    ]\n  }\n}",
                  "options": {
                    "raw": {
                      "language": "json"
                    }
                  }
                }
              },
              "response": [
                {
                  "name": "Exemplo 200",
                  "originalRequest": {
                    "method": "PUT",
                    "header": [],
                    "url": {
                      "raw": "{{baseUrl}}/v1/batches-document",
                      "host": [
                        "{{baseUrl}}"
                      ],
                      "path": [
                        "v1",
                        "batches-document"
                      ]
                    }
                  },
                  "status": "OK",
                  "code": 200,
                  "_postman_previewlanguage": "json",
                  "header": [
                    {
                      "key": "Content-Type",
                      "value": "application/json"
                    }
                  ],
                  "body": "{\n  \"totalElements\": 1,\n  \"entities\": [\n    {\n      \"batchId\": \"3fa85f64-5717-4562-b3fc-2c963f66afa6\",\n      \"documentId\": \"3fa85f64-5717-4562-b3fc-2c963f66afa6\"\n    }\n  ]\n}"
                }
              ]
            },
            {
              "name": "Listar documentos do lote",
              "event": [
                {
                  "listen": "test",
                  "script": {
                    "type": "text/javascript",
                    "exec": [
                      "pm.test('Resposta 2xx', () => pm.expect(pm.response.code).to.be.within(200, 299));",
                      "if (pm.response.code >= 400) {",
                      "  try { console.warn('Erro da API:', JSON.stringify(pm.response.json())); } catch (e) {}",
                      "}"
                    ]
                  }
                }
              ],
              "request": {
                "method": "GET",
                "header": [],
                "url": {
                  "raw": "{{baseUrl}}/v1/batches-document?filters=batchId:{{batchId}}",
                  "host": [
                    "{{baseUrl}}"
                  ],
                  "path": [
                    "v1",
                    "batches-document"
                  ],
                  "query": [
                    {
                      "key": "filters",
                      "value": "batchId:{{batchId}}"
                    }
                  ]
                },
                "description": "| Campo | Onde | Tipo | Obrigatório | Descrição |\n|---|---|---|---|---|\n| `filters` | query | string | sim | `batchId:<uuid>` |\n\n**Resposta 200**\n\n```json\n{\n  \"totalElements\": 1,\n  \"batchesDocuments\": [\n    {\n      \"id\": \"3fa85f64-5717-4562-b3fc-2c963f66afa6\",\n      \"batchId\": \"3fa85f64-5717-4562-b3fc-2c963f66afa6\",\n      \"documentId\": \"3fa85f64-5717-4562-b3fc-2c963f66afa6\",\n      \"tags\": \"[...]\"\n    }\n  ]\n}\n```"
              },
              "response": [
                {
                  "name": "Exemplo 200",
                  "originalRequest": {
                    "method": "GET",
                    "header": [],
                    "url": {
                      "raw": "{{baseUrl}}/v1/batches-document?filters=batchId:{{batchId}}",
                      "host": [
                        "{{baseUrl}}"
                      ],
                      "path": [
                        "v1",
                        "batches-document"
                      ],
                      "query": [
                        {
                          "key": "filters",
                          "value": "batchId:{{batchId}}"
                        }
                      ]
                    }
                  },
                  "status": "OK",
                  "code": 200,
                  "_postman_previewlanguage": "json",
                  "header": [
                    {
                      "key": "Content-Type",
                      "value": "application/json"
                    }
                  ],
                  "body": "{\n  \"totalElements\": 1,\n  \"batchesDocuments\": [\n    {\n      \"id\": \"3fa85f64-5717-4562-b3fc-2c963f66afa6\",\n      \"batchId\": \"3fa85f64-5717-4562-b3fc-2c963f66afa6\",\n      \"documentId\": \"3fa85f64-5717-4562-b3fc-2c963f66afa6\",\n      \"tags\": \"[...]\"\n    }\n  ]\n}"
                }
              ]
            },
            {
              "name": "Processar lote",
              "event": [
                {
                  "listen": "test",
                  "script": {
                    "type": "text/javascript",
                    "exec": [
                      "pm.test('Resposta 2xx', () => pm.expect(pm.response.code).to.be.within(200, 299));",
                      "if (pm.response.code >= 400) {",
                      "  try { console.warn('Erro da API:', JSON.stringify(pm.response.json())); } catch (e) {}",
                      "}"
                    ]
                  }
                }
              ],
              "request": {
                "method": "POST",
                "header": [
                  {
                    "key": "Idempotency-Key",
                    "value": "{{$guid}}",
                    "description": "Em retry da MESMA operação, reenvie o mesmo valor."
                  }
                ],
                "url": {
                  "raw": "{{baseUrl}}/v1/batches-envelopes/{{companyId}}/{{batchId}}",
                  "host": [
                    "{{baseUrl}}"
                  ],
                  "path": [
                    "v1",
                    "batches-envelopes",
                    "{{companyId}}",
                    "{{batchId}}"
                  ]
                },
                "description": "Cria um envelope por signatário variável, adiciona documentos, signatários fixos e campos, lacra e envia. O lote precisa estar em `DRAFT`. Créditos são debitados por envelope.\n\nAceita `Idempotency-Key` (a collection gera um automaticamente).\n\n| Campo | Onde | Tipo | Obrigatório | Descrição |\n|---|---|---|---|---|\n| `companyId` | path | uuid | sim | Sua empresa |\n| `batchId` | path | uuid | sim | Lote |\n\n**Resposta:** 201 com corpo vazio. Acompanhe os envelopes em `GET /v1/envelopes`.\n\n**Erros comuns**\n\n- 400 `Batch not found`\n- 400 `Signers not found`"
              },
              "response": []
            },
            {
              "name": "Listar lotes",
              "event": [
                {
                  "listen": "test",
                  "script": {
                    "type": "text/javascript",
                    "exec": [
                      "pm.test('Resposta 2xx', () => pm.expect(pm.response.code).to.be.within(200, 299));",
                      "if (pm.response.code >= 400) {",
                      "  try { console.warn('Erro da API:', JSON.stringify(pm.response.json())); } catch (e) {}",
                      "}"
                    ]
                  }
                }
              ],
              "request": {
                "method": "GET",
                "header": [],
                "url": {
                  "raw": "{{baseUrl}}/v1/batches/{{companyId}}",
                  "host": [
                    "{{baseUrl}}"
                  ],
                  "path": [
                    "v1",
                    "batches",
                    "{{companyId}}"
                  ]
                },
                "description": "| Campo | Onde | Tipo | Obrigatório | Descrição |\n|---|---|---|---|---|\n| `companyId` | path | uuid | sim | Sua empresa |\n\n**Resposta 200**\n\n```json\n{\n  \"totalElements\": 1,\n  \"batches\": [\n    {\n      \"id\": \"3fa85f64-5717-4562-b3fc-2c963f66afa6\",\n      \"name\": \"Termo de confidencialidade - Out/2026\",\n      \"status\": \"PROCESS\",\n      \"createdAt\": \"2026-10-13T12:00:00.000Z\"\n    }\n  ]\n}\n```"
              },
              "response": [
                {
                  "name": "Exemplo 200",
                  "originalRequest": {
                    "method": "GET",
                    "header": [],
                    "url": {
                      "raw": "{{baseUrl}}/v1/batches/{{companyId}}",
                      "host": [
                        "{{baseUrl}}"
                      ],
                      "path": [
                        "v1",
                        "batches",
                        "{{companyId}}"
                      ]
                    }
                  },
                  "status": "OK",
                  "code": 200,
                  "_postman_previewlanguage": "json",
                  "header": [
                    {
                      "key": "Content-Type",
                      "value": "application/json"
                    }
                  ],
                  "body": "{\n  \"totalElements\": 1,\n  \"batches\": [\n    {\n      \"id\": \"3fa85f64-5717-4562-b3fc-2c963f66afa6\",\n      \"name\": \"Termo de confidencialidade - Out/2026\",\n      \"status\": \"PROCESS\",\n      \"createdAt\": \"2026-10-13T12:00:00.000Z\"\n    }\n  ]\n}"
                }
              ]
            },
            {
              "name": "Reenviar convite de um signatário do lote",
              "event": [
                {
                  "listen": "test",
                  "script": {
                    "type": "text/javascript",
                    "exec": [
                      "pm.test('Resposta 2xx', () => pm.expect(pm.response.code).to.be.within(200, 299));",
                      "if (pm.response.code >= 400) {",
                      "  try { console.warn('Erro da API:', JSON.stringify(pm.response.json())); } catch (e) {}",
                      "}"
                    ]
                  }
                }
              ],
              "request": {
                "method": "POST",
                "header": [
                  {
                    "key": "Idempotency-Key",
                    "value": "{{$guid}}",
                    "description": "Em retry da MESMA operação, reenvie o mesmo valor."
                  }
                ],
                "url": {
                  "raw": "{{baseUrl}}/v1/batches-envelopes/resend-request/{{batchId}}/{{batchSignerId}}",
                  "host": [
                    "{{baseUrl}}"
                  ],
                  "path": [
                    "v1",
                    "batches-envelopes",
                    "resend-request",
                    "{{batchId}}",
                    "{{batchSignerId}}"
                  ]
                },
                "description": "Aceita `Idempotency-Key` (a collection gera um automaticamente).\n\n| Campo | Onde | Tipo | Obrigatório | Descrição |\n|---|---|---|---|---|\n| `batchId` | path | uuid | sim | Lote |\n| `signerId` | path | uuid | sim | Signatário |\n\n**Resposta:** 201 com corpo vazio."
              },
              "response": []
            },
            {
              "name": "Remover signatário do lote",
              "event": [
                {
                  "listen": "test",
                  "script": {
                    "type": "text/javascript",
                    "exec": [
                      "pm.test('Resposta 2xx', () => pm.expect(pm.response.code).to.be.within(200, 299));",
                      "if (pm.response.code >= 400) {",
                      "  try { console.warn('Erro da API:', JSON.stringify(pm.response.json())); } catch (e) {}",
                      "}"
                    ]
                  }
                }
              ],
              "request": {
                "method": "DELETE",
                "header": [],
                "url": {
                  "raw": "{{baseUrl}}/v1/batches-signer/{{companyId}}/{{batchId}}/{{batchSignerId}}",
                  "host": [
                    "{{baseUrl}}"
                  ],
                  "path": [
                    "v1",
                    "batches-signer",
                    "{{companyId}}",
                    "{{batchId}}",
                    "{{batchSignerId}}"
                  ]
                },
                "description": "| Campo | Onde | Tipo | Obrigatório | Descrição |\n|---|---|---|---|---|\n| `companyId` | path | uuid | sim |  |\n| `batchId` | path | uuid | sim |  |\n| `signerId` | path | uuid | sim | O `signerId` do signatário |"
              },
              "response": []
            },
            {
              "name": "Remover documento do lote",
              "event": [
                {
                  "listen": "test",
                  "script": {
                    "type": "text/javascript",
                    "exec": [
                      "pm.test('Resposta 2xx', () => pm.expect(pm.response.code).to.be.within(200, 299));",
                      "if (pm.response.code >= 400) {",
                      "  try { console.warn('Erro da API:', JSON.stringify(pm.response.json())); } catch (e) {}",
                      "}"
                    ]
                  }
                }
              ],
              "request": {
                "method": "DELETE",
                "header": [
                  {
                    "key": "Content-Type",
                    "value": "application/json"
                  }
                ],
                "url": {
                  "raw": "{{baseUrl}}/v1/batches-document",
                  "host": [
                    "{{baseUrl}}"
                  ],
                  "path": [
                    "v1",
                    "batches-document"
                  ]
                },
                "description": "| Campo | Onde | Tipo | Obrigatório | Descrição |\n|---|---|---|---|---|\n| `data.batchId` | body | uuid | sim |  |\n| `data.documentId` | body | uuid | sim |  |",
                "body": {
                  "mode": "raw",
                  "raw": "{\n  \"data\": {\n    \"batchId\": \"{{batchId}}\",\n    \"documentId\": \"{{batchDocumentId}}\"\n  }\n}",
                  "options": {
                    "raw": {
                      "language": "json"
                    }
                  }
                }
              },
              "response": []
            },
            {
              "name": "Excluir lote",
              "event": [
                {
                  "listen": "test",
                  "script": {
                    "type": "text/javascript",
                    "exec": [
                      "pm.test('Resposta 2xx', () => pm.expect(pm.response.code).to.be.within(200, 299));",
                      "if (pm.response.code >= 400) {",
                      "  try { console.warn('Erro da API:', JSON.stringify(pm.response.json())); } catch (e) {}",
                      "}"
                    ]
                  }
                }
              ],
              "request": {
                "method": "DELETE",
                "header": [],
                "url": {
                  "raw": "{{baseUrl}}/v1/batches/{{companyId}}/{{batchId}}",
                  "host": [
                    "{{baseUrl}}"
                  ],
                  "path": [
                    "v1",
                    "batches",
                    "{{companyId}}",
                    "{{batchId}}"
                  ]
                },
                "description": "Exclui o lote com seus documentos, signatários e modelos. Envelopes já gerados não são afetados.\n\n| Campo | Onde | Tipo | Obrigatório | Descrição |\n|---|---|---|---|---|\n| `companyId` | path | uuid | sim |  |\n| `batchId` | path | uuid | sim |  |"
              },
              "response": []
            },
            {
              "name": "Lote com modelo: vincular modelo",
              "event": [
                {
                  "listen": "test",
                  "script": {
                    "type": "text/javascript",
                    "exec": [
                      "pm.test('Resposta 2xx', () => pm.expect(pm.response.code).to.be.within(200, 299));",
                      "if (pm.response.code >= 400) {",
                      "  try { console.warn('Erro da API:', JSON.stringify(pm.response.json())); } catch (e) {}",
                      "}"
                    ]
                  }
                }
              ],
              "request": {
                "method": "POST",
                "header": [
                  {
                    "key": "Content-Type",
                    "value": "application/json"
                  },
                  {
                    "key": "Idempotency-Key",
                    "value": "{{$guid}}",
                    "description": "Em retry da MESMA operação, reenvie o mesmo valor."
                  }
                ],
                "url": {
                  "raw": "{{baseUrl}}/v1/batches-template/{{batchId}}/{{companyId}}",
                  "host": [
                    "{{baseUrl}}"
                  ],
                  "path": [
                    "v1",
                    "batches-template",
                    "{{batchId}}",
                    "{{companyId}}"
                  ]
                },
                "description": "Em vez de PDF fixo, o lote usa um modelo .docx preenchido por signatário a partir de uma planilha (próxima rota).\n\nAceita `Idempotency-Key` (a collection gera um automaticamente).\n\n| Campo | Onde | Tipo | Obrigatório | Descrição |\n|---|---|---|---|---|\n| `batchId` | path | uuid | sim |  |\n| `companyId` | path | uuid | sim |  |\n| `data.templateId` | body | uuid | sim | Modelo |\n\n**Resposta 201**\n\n```json\n{\n  \"entities\": [\n    {\n      \"id\": \"3fa85f64-5717-4562-b3fc-2c963f66afa6\",\n      \"batchId\": \"3fa85f64-5717-4562-b3fc-2c963f66afa6\",\n      \"templateId\": \"3fa85f64-5717-4562-b3fc-2c963f66afa6\"\n    }\n  ]\n}\n```\n\n**Erros comuns**\n\n- 400 `Document already exists for this batch`",
                "body": {
                  "mode": "raw",
                  "raw": "{\n  \"data\": {\n    \"templateId\": \"{{templateId}}\"\n  }\n}",
                  "options": {
                    "raw": {
                      "language": "json"
                    }
                  }
                }
              },
              "response": [
                {
                  "name": "Exemplo 201",
                  "originalRequest": {
                    "method": "POST",
                    "header": [],
                    "url": {
                      "raw": "{{baseUrl}}/v1/batches-template/{{batchId}}/{{companyId}}",
                      "host": [
                        "{{baseUrl}}"
                      ],
                      "path": [
                        "v1",
                        "batches-template",
                        "{{batchId}}",
                        "{{companyId}}"
                      ]
                    }
                  },
                  "status": "OK",
                  "code": 201,
                  "_postman_previewlanguage": "json",
                  "header": [
                    {
                      "key": "Content-Type",
                      "value": "application/json"
                    }
                  ],
                  "body": "{\n  \"entities\": [\n    {\n      \"id\": \"3fa85f64-5717-4562-b3fc-2c963f66afa6\",\n      \"batchId\": \"3fa85f64-5717-4562-b3fc-2c963f66afa6\",\n      \"templateId\": \"3fa85f64-5717-4562-b3fc-2c963f66afa6\"\n    }\n  ]\n}"
                }
              ]
            },
            {
              "name": "Lote com modelo: enviar planilha",
              "event": [
                {
                  "listen": "test",
                  "script": {
                    "type": "text/javascript",
                    "exec": [
                      "pm.test('Resposta 2xx', () => pm.expect(pm.response.code).to.be.within(200, 299));",
                      "if (pm.response.code >= 400) {",
                      "  try { console.warn('Erro da API:', JSON.stringify(pm.response.json())); } catch (e) {}",
                      "}"
                    ]
                  }
                }
              ],
              "request": {
                "method": "POST",
                "header": [],
                "url": {
                  "raw": "{{baseUrl}}/v1/batches-template/upload-excel/{{batchId}}/{{companyId}}/{{templateId}}",
                  "host": [
                    "{{baseUrl}}"
                  ],
                  "path": [
                    "v1",
                    "batches-template",
                    "upload-excel",
                    "{{batchId}}",
                    "{{companyId}}",
                    "{{templateId}}"
                  ]
                },
                "description": "Envio `multipart/form-data` com o campo `file`. A planilha precisa de uma coluna `email` e uma coluna para cada campo do modelo. Cada linha preenche o modelo do signatário (variável, já adicionado ao lote) com aquele e-mail; linhas sem signatário correspondente são ignoradas.\n\n| Campo | Onde | Tipo | Obrigatório | Descrição |\n|---|---|---|---|---|\n| `file` | form | arquivo | sim | .xlsx |\n\n**Resposta 201**\n\n```json\n{\n  \"entities\": [\n    {\n      \"message\": \"Excel file processed successfully\"\n    }\n  ]\n}\n```\n\n**Erros comuns**\n\n- 400 `Key e-mail not found`\n- 400 `No data found in the Excel file`",
                "body": {
                  "mode": "formdata",
                  "formdata": [
                    {
                      "key": "file",
                      "type": "file",
                      "src": "",
                      "description": "Planilha .xlsx"
                    }
                  ]
                }
              },
              "response": [
                {
                  "name": "Exemplo 201",
                  "originalRequest": {
                    "method": "POST",
                    "header": [],
                    "url": {
                      "raw": "{{baseUrl}}/v1/batches-template/upload-excel/{{batchId}}/{{companyId}}/{{templateId}}",
                      "host": [
                        "{{baseUrl}}"
                      ],
                      "path": [
                        "v1",
                        "batches-template",
                        "upload-excel",
                        "{{batchId}}",
                        "{{companyId}}",
                        "{{templateId}}"
                      ]
                    }
                  },
                  "status": "OK",
                  "code": 201,
                  "_postman_previewlanguage": "json",
                  "header": [
                    {
                      "key": "Content-Type",
                      "value": "application/json"
                    }
                  ],
                  "body": "{\n  \"entities\": [\n    {\n      \"message\": \"Excel file processed successfully\"\n    }\n  ]\n}"
                }
              ]
            },
            {
              "name": "Lote com modelo: listar modelos do lote",
              "event": [
                {
                  "listen": "test",
                  "script": {
                    "type": "text/javascript",
                    "exec": [
                      "pm.test('Resposta 2xx', () => pm.expect(pm.response.code).to.be.within(200, 299));",
                      "if (pm.response.code >= 400) {",
                      "  try { console.warn('Erro da API:', JSON.stringify(pm.response.json())); } catch (e) {}",
                      "}"
                    ]
                  }
                }
              ],
              "request": {
                "method": "GET",
                "header": [],
                "url": {
                  "raw": "{{baseUrl}}/v1/batches-template/{{batchId}}/{{companyId}}",
                  "host": [
                    "{{baseUrl}}"
                  ],
                  "path": [
                    "v1",
                    "batches-template",
                    "{{batchId}}",
                    "{{companyId}}"
                  ]
                },
                "description": "**Resposta 200**\n\n```json\n{\n  \"entities\": [\n    {\n      \"id\": \"3fa85f64-5717-4562-b3fc-2c963f66afa6\",\n      \"batchId\": \"3fa85f64-5717-4562-b3fc-2c963f66afa6\",\n      \"name\": \"Contrato CLT\",\n      \"keys\": []\n    }\n  ]\n}\n```"
              },
              "response": [
                {
                  "name": "Exemplo 200",
                  "originalRequest": {
                    "method": "GET",
                    "header": [],
                    "url": {
                      "raw": "{{baseUrl}}/v1/batches-template/{{batchId}}/{{companyId}}",
                      "host": [
                        "{{baseUrl}}"
                      ],
                      "path": [
                        "v1",
                        "batches-template",
                        "{{batchId}}",
                        "{{companyId}}"
                      ]
                    }
                  },
                  "status": "OK",
                  "code": 200,
                  "_postman_previewlanguage": "json",
                  "header": [
                    {
                      "key": "Content-Type",
                      "value": "application/json"
                    }
                  ],
                  "body": "{\n  \"entities\": [\n    {\n      \"id\": \"3fa85f64-5717-4562-b3fc-2c963f66afa6\",\n      \"batchId\": \"3fa85f64-5717-4562-b3fc-2c963f66afa6\",\n      \"name\": \"Contrato CLT\",\n      \"keys\": []\n    }\n  ]\n}"
                }
              ]
            },
            {
              "name": "Lote com modelo: remover modelo",
              "event": [
                {
                  "listen": "test",
                  "script": {
                    "type": "text/javascript",
                    "exec": [
                      "pm.test('Resposta 2xx', () => pm.expect(pm.response.code).to.be.within(200, 299));",
                      "if (pm.response.code >= 400) {",
                      "  try { console.warn('Erro da API:', JSON.stringify(pm.response.json())); } catch (e) {}",
                      "}"
                    ]
                  }
                }
              ],
              "request": {
                "method": "DELETE",
                "header": [],
                "url": {
                  "raw": "{{baseUrl}}/v1/batches-template/{{batchId}}/{{companyId}}/{{templateId}}",
                  "host": [
                    "{{baseUrl}}"
                  ],
                  "path": [
                    "v1",
                    "batches-template",
                    "{{batchId}}",
                    "{{companyId}}",
                    "{{templateId}}"
                  ]
                },
                "description": ""
              },
              "response": []
            },
            {
              "name": "Lote com modelo: reenviar pedido de conferência de dados",
              "event": [
                {
                  "listen": "test",
                  "script": {
                    "type": "text/javascript",
                    "exec": [
                      "pm.test('Resposta 2xx', () => pm.expect(pm.response.code).to.be.within(200, 299));",
                      "if (pm.response.code >= 400) {",
                      "  try { console.warn('Erro da API:', JSON.stringify(pm.response.json())); } catch (e) {}",
                      "}"
                    ]
                  }
                }
              ],
              "request": {
                "method": "POST",
                "header": [
                  {
                    "key": "Idempotency-Key",
                    "value": "{{$guid}}",
                    "description": "Em retry da MESMA operação, reenvie o mesmo valor."
                  }
                ],
                "url": {
                  "raw": "{{baseUrl}}/v1/batches-envelopes/resend-validation/{{batchId}}/{{batchSignerId}}",
                  "host": [
                    "{{baseUrl}}"
                  ],
                  "path": [
                    "v1",
                    "batches-envelopes",
                    "resend-validation",
                    "{{batchId}}",
                    "{{batchSignerId}}"
                  ]
                },
                "description": "No lote com modelo, cada signatário confere os próprios dados antes de assinar. Esta rota reenvia esse pedido.\n\nAceita `Idempotency-Key` (a collection gera um automaticamente).\n\n**Resposta:** 201 com corpo vazio."
              },
              "response": []
            }
          ]
        }
      ]
    }
  ]
}
