Enviar matrícula para análise e vincular a um contrato

Envia o PDF de uma matrícula do cliente para análise e já a vincula ao contrato informado em contractId. fileUrl é o endereço do PDF já enviado ao armazenamento de arquivos e fileName, o nome do arquivo; o arquivo precisa ser um PDF. A análise é assíncrona: a resposta é 200 sem corpo, e a matrícula entra na fila (status FILA) já vinculada ao contrato, aparecendo nos detalhes dele. Cada chamada que passa debita da empresa o preço do produto de análise de matrícula 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.). Para vincular uma matrícula já analisada, use a rota que recebe o registryAnalysisId. Requer autenticação via Bearer JWT ou header x-api-key e a permissão de vincular matrículas 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

🟢200

application/json

Matrícula enviada para análise e vinculada; a resposta não tem corpo

Bodyapplication/json

🟠400BadRequest

🟠401Unauthorized

🟠404NotFound

🟠429TooManyRequests

🔴500InternalError

🟠400Requisição recusada

🟠403Acesso negado

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

🟠422Corpo inválido

🔴503Conflito de gravação

curl --location '/v2/clients/7c9e6679-7425-40de-944b-e07fc1f90ae7/contracts/3f6b1d2e-8c4a-4b7e-9d1a-5e2c7a9b0f13/property-registration' \ --header 'x-api-key: SUA_CHAVE_DE_API' \ --header 'Authorization: Bearer <token>' \ --header 'Content-Type: application/json' \ --data '{ "fileUrl": "bucket-exemplo/matriculas/12345.pdf", "fileName": "12345.pdf" }'