{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "$id": "https://artifacts.apis.io/signdocs-com-br/json-schema/signdocs-com-br-enrollment-request-schema.json",
  "title": "EnrollmentRequest",
  "description": "Requisição de enrollment biométrico.\nTodas as imagens são validadas via DetectFaces para garantir presença de exatamente um rosto.\nQuando `source` é `DOCUMENT_PHOTO`, o rosto é extraído automaticamente do documento\ne armazenado como imagem de enrollment. Requer `documentExtractionEnabled` no tenant.\n",
  "x-generated": "2026-11-10",
  "x-method": "derived",
  "x-generator": "derive-json-schema.py",
  "x-source": "openapi/signdocs-com-br-users-api-openapi.yml#/components/schemas/EnrollmentRequest",
  "type": "object",
  "required": [
    "image",
    "cpf"
  ],
  "properties": {
    "dryRun": {
      "type": "boolean",
      "default": false,
      "description": "Inspeciona sem gravar. Devolve o mesmo veredito que o endpoint de\nlote — `usable` / `marginal` / `rejected` com as métricas — e **não\npersiste nada**: nenhuma imagem no S3, nenhum registro, e o prazo de\n90 dias não começa a correr.\n\nMesma função dos dois lados, de propósito: uma foto não pode ser\njulgada de um jeito no lote e de outro aqui.\n"
    },
    "image": {
      "type": "string",
      "format": "byte",
      "description": "Imagem facial de referência codificada em base64 (JPEG)."
    },
    "cpf": {
      "type": "string",
      "pattern": "^\\d{11}$",
      "description": "CPF do titular (11 dígitos, sem pontuação)."
    },
    "source": {
      "type": "string",
      "description": "Origem da imagem de enrollment — quem responde por aquele rosto e se\no titular estava presente na captura. É o que separa, numa auditoria\nanos depois, a foto que a organização entregou da captura ao vivo e\nda que veio de um documento oficial.\n\n- `ORGANIZATION_PROVIDED` (padrão): foto vinda dos registros da\n  própria organização — crachá, ficha de RH, folha. O titular não\n  estava presente; quem responde pela imagem é a organização.\n- `FIRST_LIVENESS`: imagem capturada na primeira sessão de liveness\n  do titular. Captura ao vivo, com o titular presente.\n- `DOCUMENT_PHOTO`: foto de documento (CNH/RG/passaporte). O rosto é\n  extraído automaticamente. Requer `documentExtractionEnabled`.\n\n`BANK_PROVIDED` continua **aceito** como sinônimo de\n`ORGANIZATION_PROVIDED` e é normalizado na gravação — o valor\ndevolvido e o que vai para a evidência são sempre o canônico. O nome\nantigo é de quando o único cliente era um banco; quem cadastra\noperadores de fábrica não deveria precisar enviá-lo.\n",
      "enum": [
        "ORGANIZATION_PROVIDED",
        "FIRST_LIVENESS",
        "DOCUMENT_PHOTO",
        "BANK_PROVIDED"
      ],
      "default": "ORGANIZATION_PROVIDED"
    }
  }
}