Cadastrar contrato de um cliente para análise

Envia o PDF de um contrato do cliente informado em clientId para análise. O PDF já precisa ter sido enviado ao armazenamento de arquivos, e fileUrl é o endereço dele; o arquivo precisa ser um PDF. A análise é assíncrona: a resposta é 201 com o _id do contrato, status FILA, fileUrl e createdAt, e, enquanto o contrato não tem dados extraídos, a listagem e os detalhes devolvem os campos dele vazios. Cada chamada que passa debita da empresa o preço do produto de análise de contrato e registra a cobrança; empresa sem créditos cadastrados, bloqueada ou sem saldo suficiente recebe 400, e, se a gravação conflitar com outra, a resposta é 503 e vale tentar de novo após 10 segundos. Falha ao validar o arquivo no armazenamento devolve 500 (Erro ao validar o documento no bucket.). Requer autenticação via Bearer JWT ou header x-api-key e a permissão de cadastrar contratos de clientes. O cliente precisa pertencer à empresa do usuário: cliente inexistente devolve 404 (Cliente não encontrado), cliente de outra empresa devolve 401 (Acesso negado) e usuário inativo devolve 404 (Usuário não encontrado). Usuário sem perfil de permissão recebe 403 (Acesso negado); perfil inexistente, 401 (Permissão inválida!); perfil sem a permissão, 400 (Permissão não encontrada).

Forneça seu token bearer no cabeçalho

Authorization

ao fazer requisições para recursos protegidos.

Exemplo:

Authorization: Bearer ********************

Respostas

🟢201

application/json

Contrato enviado para análise

Bodyapplication/json

🟠400BadRequest

🟠401Unauthorized

🟠404NotFound

🟠429TooManyRequests

🔴500InternalError

🟠400Requisição recusada

🟠403Acesso negado

🟠404Cliente, usuário, arquivo ou produto não encontrado

🟠422fileUrl ausente

🔴503Conflito de gravação

curl --location '/v2/clients/7c9e6679-7425-40de-944b-e07fc1f90ae7/contracts' \ --header 'x-api-key: SUA_CHAVE_DE_API' \ --header 'Authorization: Bearer <token>' \ --header 'Content-Type: application/json' \ --data '{ "fileUrl": "bucket-exemplo/contratos/ccb-2026-00123.pdf" }'